1:I["8f048adc2ca3",[],"StyleSheetProvider",1] 2:I["911c8e14a321",[],"RevpressProvider",1] 3:I["b0b3943575f9",[],"Link",1] d:I["98d563c3c055",[],"ToastProvider",1] e:I["9ab2c8c971c4",[],"LayoutTopNav",1] f:I["3c81c6443917",[],"LayoutMenu",1] 10:I["98d563c3c055",[],"Tag",1] 11:I["98d563c3c055",[],"Action",1] 13:I["e7f2352d5acc",[],"ApiAuthentication",1] 15:I["9083c63ad443",[],"CopyAnchor",1] 16:I["741b00e3790d",[],"AIToolbar",1] 70:I["d4c6751a9c52",[],"HashObserver",1] 71:I["98d563c3c055",[],"ToastContainer",1] :HL["/_assets/request-D65efmQn.css","stylesheet"] :HL["https://storage.googleapis.com/revolut-prod-apps_cdn/Brand/Retail/Logos/Wordmark/Revolut_Black.svg","image"] :HL["https://storage.googleapis.com/revolut-prod-apps_cdn/Brand/Retail/Logos/Wordmark/Revolut_White.svg","image"] 0:{"root":["$","html",null,{"suppressHydrationWarning":true,"lang":"en","data-feature-web-density":"true","data-banner-id":"$undefined","children":[["$","head",null,{"children":[[["$","meta",null,{"charSet":"utf-8"}],["$","meta",null,{"name":"viewport","content":"width=device-width, initial-scale=1"}],["$","meta",null,{"name":"color-scheme","content":"light dark"}],["$","meta",null,{"name":"generator","content":"Revpress v0.8.0"}],["$","meta",null,{"property":"og:site_name","content":"Developer"}],["$","meta",null,{"property":"og:type","content":"website"}]],[["$","link","css:/_assets/request-D65efmQn.css",{"rel":"stylesheet","precedence":"vite-rsc/importer-resources","href":"/_assets/request-D65efmQn.css","data-rsc-css-href":"/_assets/request-D65efmQn.css"}],"$undefined"],["$","script",null,{"src":"/_assets/theme-init-add2a6d7.js"}],[["$","link",null,{"rel":"apple-touch-icon","sizes":"180x180","href":"/_assets/favicons/apple-touch-icon.png"}],["$","link",null,{"rel":"icon","type":"image/png","sizes":"32x32","href":"/_assets/favicons/favicon-32x32.png"}],["$","link",null,{"rel":"icon","type":"image/png","sizes":"16x16","href":"/_assets/favicons/favicon-16x16.png"}],["$","link",null,{"rel":"icon","type":"image/png","sizes":"192x192","href":"/_assets/favicons/android-chrome-192x192.png"}],["$","link",null,{"rel":"icon","type":"image/png","sizes":"512x512","href":"/_assets/favicons/android-chrome-512x512.png"}],["$","link",null,{"rel":"shortcut icon","href":"/_assets/favicons/favicon.ico"}]]]}],["$","body",null,{"className":"pjjwra0","children":["$","$L1",null,{"children":["$","$L2",null,{"nav":[{"item":{"id":"Guides","title":"Guides","items":[{"id":"/docs/guides/merchant/introduction","title":"Merchant","use":"$3","to":"/docs/guides/merchant/introduction","scope":"/docs/guides/merchant","items":[{"id":"/docs/guides/merchant/accept-payments/online-payments/revolut-pay/introduction","title":"Accept Revolut Pay payments","use":"$3","to":"/docs/guides/merchant/accept-payments/online-payments/revolut-pay/introduction","scope":"/docs/guides/merchant"},{"id":"/docs/guides/merchant/accept-payments/online-payments/card-payments/introduction","title":"Accept card payments","use":"$3","to":"/docs/guides/merchant/accept-payments/online-payments/card-payments/introduction","scope":"/docs/guides/merchant"},{"id":"/docs/guides/merchant/accept-payments/online-payments/apple-pay-google-pay/introduction","title":"Accept Apple Pay and Google Pay payments","use":"$3","to":"/docs/guides/merchant/accept-payments/online-payments/apple-pay-google-pay/introduction","scope":"/docs/guides/merchant"},{"id":"/docs/guides/merchant/accept-payments/online-payments/pay-by-bank/introduction","title":"Accept direct bank payments","use":"$3","to":"/docs/guides/merchant/accept-payments/online-payments/pay-by-bank/introduction","scope":"/docs/guides/merchant"},{"id":"/docs/guides/merchant/accept-payments/online-payments/revolut-checkout/introduction","title":"Accept payments with Revolut Checkout","use":"$3","to":"/docs/guides/merchant/accept-payments/online-payments/revolut-checkout/introduction","scope":"/docs/guides/merchant"},{"id":"/docs/guides/merchant/accept-payments/online-payments/hosted-checkout-page/introduction","title":"Accept payments via Hosted Checkout Page","use":"$3","to":"/docs/guides/merchant/accept-payments/online-payments/hosted-checkout-page/introduction","scope":"/docs/guides/merchant"},{"id":"/docs/guides/merchant/accept-payments/online-payments/sepa-direct-debit/introduction","title":"Accept payments via SEPA Direct Debit","use":"$3","to":"/docs/guides/merchant/accept-payments/online-payments/sepa-direct-debit/introduction","scope":"/docs/guides/merchant"},{"id":"/docs/guides/merchant/accept-payments/no-code/plugins/introduction","title":"Plugins and integrations","use":"$3","to":"/docs/guides/merchant/accept-payments/no-code/plugins/introduction","scope":"/docs/guides/merchant"},{"id":"/docs/guides/merchant/accept-payments/in-person-payments/introduction","title":"In-person payments","use":"$3","to":"/docs/guides/merchant/accept-payments/in-person-payments/introduction","scope":"/docs/guides/merchant"}]},{"id":"/docs/guides/manage-accounts/introduction","title":"Business","use":"$3","to":"/docs/guides/manage-accounts/introduction","scope":"/docs/guides/manage-accounts","items":[{"id":"/docs/guides/manage-accounts/transfers/send-money","title":"Send money","use":"$3","to":"/docs/guides/manage-accounts/transfers/send-money","scope":"/docs/guides/manage-accounts"},{"id":"/docs/guides/manage-accounts/accounts-and-transactions/manage-your-accounts","title":"Manage your money","use":"$3","to":"/docs/guides/manage-accounts/accounts-and-transactions/manage-your-accounts","scope":"/docs/guides/manage-accounts"},{"id":"/docs/guides/manage-accounts/exchange-money","title":"Exchange currency","use":"$3","to":"/docs/guides/manage-accounts/exchange-money","scope":"/docs/guides/manage-accounts"},{"id":"/docs/guides/manage-accounts/cards/manage-cards","title":"Manage cards","use":"$3","to":"/docs/guides/manage-accounts/cards/manage-cards","scope":"/docs/guides/manage-accounts"},{"id":"/docs/guides/manage-accounts/teams/manage-team-members","title":"Manage your team","use":"$3","to":"/docs/guides/manage-accounts/teams/manage-team-members","scope":"/docs/guides/manage-accounts"}]},{"id":"/docs/guides/build-banking-apps/introduction-to-the-open-banking-api/introduction","title":"Open Banking","use":"$3","to":"/docs/guides/build-banking-apps/introduction-to-the-open-banking-api/introduction","scope":"/docs/guides/build-banking-apps","items":[{"id":"/docs/guides/build-banking-apps/tutorials/initiate-your-first-payment","title":"Make payments","use":"$3","to":"/docs/guides/build-banking-apps/tutorials/initiate-your-first-payment","scope":"/docs/guides/build-banking-apps"},{"id":"/docs/guides/build-banking-apps/tutorials/get-account-and-transaction-information","title":"Get account information","use":"$3","to":"/docs/guides/build-banking-apps/tutorials/get-account-and-transaction-information","scope":"/docs/guides/build-banking-apps"}]},{"id":"/docs/guides/crypto-ramp/introduction-to-revolut-ramp/introduction-to-revolut-ramp","title":"Crypto Ramp","use":"$3","to":"/docs/guides/crypto-ramp/introduction-to-revolut-ramp/introduction-to-revolut-ramp","scope":"/docs/guides/crypto-ramp","items":[{"id":"/docs/guides/crypto-ramp/get-started/integrate-with-revolut-ramp","title":"Integrate with Revolut Ramp","use":"$3","to":"/docs/guides/crypto-ramp/get-started/integrate-with-revolut-ramp","scope":"/docs/guides/crypto-ramp"}]},{"id":"/docs/guides/revolut-wallet/introduction","title":"Revolut Wallet","use":"$3","to":"/docs/guides/revolut-wallet/introduction","scope":"/docs/guides/revolut-wallet","items":[{"id":"/docs/guides/revolut-wallet/get-started","title":"Get started","use":"$3","to":"/docs/guides/revolut-wallet/get-started","scope":"/docs/guides/revolut-wallet"},{"id":"/docs/guides/revolut-wallet/operations/create-pass","title":"Create a pass","use":"$3","to":"/docs/guides/revolut-wallet/operations/create-pass","scope":"/docs/guides/revolut-wallet"},{"id":"/docs/guides/revolut-wallet/operations/update-pass","title":"Update a pass","use":"$3","to":"/docs/guides/revolut-wallet/operations/update-pass","scope":"/docs/guides/revolut-wallet"},{"id":"/docs/guides/revolut-wallet/operations/transaction-results","title":"Transaction results","use":"$3","to":"/docs/guides/revolut-wallet/operations/transaction-results","scope":"/docs/guides/revolut-wallet"}]}]}},{"item":{"id":"APIs","title":"APIs","items":[{"id":"/docs/api/merchant","title":"Merchant API","use":"$3","to":"/docs/api/merchant","items":[{"id":"/docs/api/merchant#tag-orders","title":"Orders","use":"$3","to":"/docs/api/merchant#tag-orders"},{"id":"/docs/api/merchant#tag-customers","title":"Customers","use":"$3","to":"/docs/api/merchant#tag-customers"},{"id":"/docs/api/merchant#tag-payments","title":"Payments","use":"$3","to":"/docs/api/merchant#tag-payments"},{"id":"/docs/api/merchant#tag-subscriptions","title":"Subscriptions","use":"$3","to":"/docs/api/merchant#tag-subscriptions"},{"id":"/docs/api/merchant#tag-payouts","title":"Payouts","use":"$3","to":"/docs/api/merchant#tag-payouts"},{"id":"/docs/api/merchant#tag-disputes","title":"Disputes","use":"$3","to":"/docs/api/merchant#tag-disputes"},{"id":"/docs/api/merchant#tag-report-runs","title":"Report runs","use":"$3","to":"/docs/api/merchant#tag-report-runs"},{"id":"/docs/api/merchant#tag-webhooks","title":"Webhooks","use":"$3","to":"/docs/api/merchant#tag-webhooks"},{"id":"/docs/api/merchant#tag-locations","title":"Locations","use":"$3","to":"/docs/api/merchant#tag-locations"}]},{"id":"/docs/api/business","title":"Business API","use":"$3","to":"/docs/api/business","items":[{"id":"/docs/api/business#tag-accounting","title":"Accounting settings","use":"$3","to":"/docs/api/business#tag-accounting"},{"id":"/docs/api/business#tag-accounts","title":"Accounts","use":"$3","to":"/docs/api/business#tag-accounts"},{"id":"/docs/api/business#tag-cards","title":"Cards","use":"$3","to":"/docs/api/business#tag-cards"},{"id":"/docs/api/business#tag-counterparties","title":"Counterparties","use":"$3","to":"/docs/api/business#tag-counterparties"},{"id":"/docs/api/business#tag-expenses","title":"Expenses","use":"$3","to":"/docs/api/business#tag-expenses"},{"id":"/docs/api/business#tag-foreign-exchange","title":"Foreign exchange","use":"$3","to":"/docs/api/business#tag-foreign-exchange"},{"id":"/docs/api/business#tag-payment-drafts","title":"Payment drafts","use":"$3","to":"/docs/api/business#tag-payment-drafts"},{"id":"/docs/api/business#tag-payout-links","title":"Payout links","use":"$3","to":"/docs/api/business#tag-payout-links"},{"id":"/docs/api/business#tag-team-members","title":"Team members","use":"$3","to":"/docs/api/business#tag-team-members"},{"id":"/docs/api/business#tag-transactions","title":"Transactions","use":"$3","to":"/docs/api/business#tag-transactions"},{"id":"/docs/api/business#tag-transfers","title":"Transfers","use":"$3","to":"/docs/api/business#tag-transfers"},{"id":"/docs/api/business#tag-webhooks-v2","title":"Webhooks","use":"$3","to":"/docs/api/business#tag-webhooks-v2"}]},{"id":"/docs/api/open-banking","title":"Open Banking API","use":"$3","to":"/docs/api/open-banking","items":[{"id":"/docs/api/open-banking#tag-accounts","title":"Accounts","use":"$3","to":"/docs/api/open-banking#tag-accounts"},{"id":"/docs/api/open-banking#tag-applications","title":"Applications","use":"$3","to":"/docs/api/open-banking#tag-applications"},{"id":"/docs/api/open-banking#tag-domestic-payment","title":"Payments","use":"$3","to":"/docs/api/open-banking#tag-domestic-payment"},{"id":"/docs/api/open-banking#tag-transactions","title":"Transactions","use":"$3","to":"/docs/api/open-banking#tag-transactions"}]},{"id":"/docs/api/crypto-ramp","title":"Crypto Ramp API","use":"$3","to":"/docs/api/crypto-ramp","items":[{"id":"/docs/api/crypto-ramp#tag-partners","title":"Partners","use":"$3","to":"/docs/api/crypto-ramp#tag-partners"},{"id":"/docs/api/crypto-ramp#tag-webhooks","title":"Webhooks","use":"$3","to":"/docs/api/crypto-ramp#tag-webhooks"}]},{"id":"/docs/guides/exchange-fix-api/introduction-to-the-exchange-fix-api/exchange-fix-api","title":"Crypto Exchange APIs","use":"$3","to":"/docs/guides/exchange-fix-api/introduction-to-the-exchange-fix-api/exchange-fix-api","scope":"/docs/guides/exchange-fix-api","items":[{"id":"/docs/guides/exchange-fix-api/introduction-to-the-exchange-fix-api/exchange-fix-api","title":"Crypto Exchange FIX API","use":"$3","to":"/docs/guides/exchange-fix-api/introduction-to-the-exchange-fix-api/exchange-fix-api","scope":"/docs/guides/exchange-fix-api"},{"id":"/docs/api/revolut-x-crypto-exchange","title":"Crypto Exchange REST API","use":"$3","to":"/docs/api/revolut-x-crypto-exchange"}]},{"id":"/docs/api/revolut-wallet-partner","title":"Revolut Wallet APIs","use":"$3","to":"/docs/api/revolut-wallet-partner","items":[{"id":"/docs/api/revolut-wallet-partner","title":"Partner API","use":"$3","to":"/docs/api/revolut-wallet-partner"},{"id":"/docs/api/revolut-wallet-callbacks","title":"Partner callbacks API","use":"$3","to":"/docs/api/revolut-wallet-callbacks"}]}]}},{"item":{"id":"SDKs","title":"SDKs","items":[{"id":"/docs/sdks/merchant-web-sdk/introduction","title":"Merchant Web SDKs","use":"$3","to":"/docs/sdks/merchant-web-sdk/introduction","scope":"/docs/sdks/merchant-web-sdk","items":[{"id":"/docs/sdks/merchant-web-sdk/payment-methods/embedded-checkout","title":"Revolut Checkout","use":"$3","to":"/docs/sdks/merchant-web-sdk/payment-methods/embedded-checkout","scope":"/docs/sdks/merchant-web-sdk"},{"id":"/docs/sdks/merchant-web-sdk/payment-methods/revolut-pay","title":"Revolut Pay","use":"$3","to":"/docs/sdks/merchant-web-sdk/payment-methods/revolut-pay","scope":"/docs/sdks/merchant-web-sdk"},{"id":"/docs/sdks/merchant-web-sdk/payment-methods/apple-pay-google-pay","title":"Apple Pay and Google Pay","use":"$3","to":"/docs/sdks/merchant-web-sdk/payment-methods/apple-pay-google-pay","scope":"/docs/sdks/merchant-web-sdk"},{"id":"/docs/sdks/merchant-web-sdk/payment-methods/pay-by-bank","title":"Pay by Bank","use":"$3","to":"/docs/sdks/merchant-web-sdk/payment-methods/pay-by-bank","scope":"/docs/sdks/merchant-web-sdk"},{"id":"/docs/sdks/merchant-web-sdk/payment-methods/sepa-direct-debit","title":"SEPA Direct Debit","use":"$3","to":"/docs/sdks/merchant-web-sdk/payment-methods/sepa-direct-debit","scope":"/docs/sdks/merchant-web-sdk"},{"id":"/docs/sdks/merchant-web-sdk/payment-methods/card-field","title":"Card field","use":"$3","to":"/docs/sdks/merchant-web-sdk/payment-methods/card-field","scope":"/docs/sdks/merchant-web-sdk"},{"id":"/docs/sdks/merchant-web-sdk/payment-methods/pop-up","title":"Card pop-up","use":"$3","to":"/docs/sdks/merchant-web-sdk/payment-methods/pop-up","scope":"/docs/sdks/merchant-web-sdk"},{"id":"/docs/sdks/merchant-web-sdk/promotional-widgets/introduction","title":"Promotional widgets","use":"$3","to":"/docs/sdks/merchant-web-sdk/promotional-widgets/introduction","scope":"/docs/sdks/merchant-web-sdk"}]},{"id":"/docs/sdks/merchant-ios-sdk/introduction","title":"Merchant iOS SDKs","use":"$3","to":"/docs/sdks/merchant-ios-sdk/introduction","scope":"/docs/sdks/merchant-ios-sdk","items":[{"id":"/docs/sdks/merchant-ios-sdk/revolut-pay-ios-sdk/introduction","title":"Revolut Pay","use":"$3","to":"/docs/sdks/merchant-ios-sdk/revolut-pay-ios-sdk/introduction","scope":"/docs/sdks/merchant-ios-sdk"},{"id":"/docs/sdks/merchant-ios-sdk/apple-pay-ios-sdk/introduction","title":"Apple Pay","use":"$3","to":"/docs/sdks/merchant-ios-sdk/apple-pay-ios-sdk/introduction","scope":"/docs/sdks/merchant-ios-sdk"},{"id":"/docs/sdks/merchant-ios-sdk/tap-to-pay-sdk/introduction","title":"Tap to Pay","use":"$3","to":"/docs/sdks/merchant-ios-sdk/tap-to-pay-sdk/introduction","scope":"/docs/sdks/merchant-ios-sdk"},{"id":"/docs/sdks/merchant-ios-sdk/revolut-card-form-ios-sdk/introduction","title":"Card Form","use":"$3","to":"/docs/sdks/merchant-ios-sdk/revolut-card-form-ios-sdk/introduction","scope":"/docs/sdks/merchant-ios-sdk"}]},{"id":"/docs/sdks/merchant-android-sdk/introduction","title":"Merchant Android SDKs","use":"$3","to":"/docs/sdks/merchant-android-sdk/introduction","scope":"/docs/sdks/merchant-android-sdk","items":[{"id":"/docs/sdks/merchant-android-sdk/revolut-pay-android-sdk/introduction","title":"Revolut Pay","use":"$3","to":"/docs/sdks/merchant-android-sdk/revolut-pay-android-sdk/introduction","scope":"/docs/sdks/merchant-android-sdk"},{"id":"/docs/sdks/merchant-android-sdk/revolut-card-form-android-sdk/introduction","title":"Card Form","use":"$3","to":"/docs/sdks/merchant-android-sdk/revolut-card-form-android-sdk/introduction","scope":"/docs/sdks/merchant-android-sdk"}]}]}},{"item":{"id":"Resources","title":"Resources","items":[{"id":"/docs/resources/marketing-guidelines","title":"Revolut Pay marketing assets and guidelines","use":"$3","to":"/docs/resources/marketing-guidelines","scope":"/docs/resources"},{"id":"/docs/resources/revolut-pay-button-guidelines","title":"Revolut Pay button guidelines","use":"$3","to":"/docs/resources/revolut-pay-button-guidelines","scope":"/docs/resources"},{"id":"/docs/resources/open-banking-logo-guidelines","title":"Revolut Open Banking logo assets and guidelines","use":"$3","to":"/docs/resources/open-banking-logo-guidelines","scope":"/docs/resources"}]}},{"item":{"id":"More","title":"More","items":[{"id":"/blog","title":"Blog","use":"$3","to":"/blog","scope":"/blog"},{"id":"https://developer.revolut.com/portal/signup","title":"Developer Portal","use":"a","href":"https://developer.revolut.com/portal/signup","target":"_blank","rel":"noreferrer"}]}}],"menu":{"docs":[{"id":"/docs","title":"Docs","use":"$3","items":[{"id":"/docs/guides","title":"Guides","use":"$3","items":[]},{"id":"/docs/sdks","title":"Sdks","use":"$3","items":[]}]},{"id":"/docs/guides/build-banking-apps","title":"Build Banking Apps","use":"$3","root":true,"items":[{"id":"/docs/guides/build-banking-apps/introduction-to-the-open-banking-api","title":"Introduction to the Open Banking API","use":"$3","items":[{"id":"/docs/guides/build-banking-apps/introduction-to-the-open-banking-api/introduction","title":"Introduction","to":"/docs/guides/build-banking-apps/introduction-to-the-open-banking-api/introduction","use":"$3"},{"id":"/docs/guides/build-banking-apps/introduction-to-the-open-banking-api/who-can-access-the-api","title":"Who can access the API","to":"/docs/guides/build-banking-apps/introduction-to-the-open-banking-api/who-can-access-the-api","use":"$3"},{"id":"/docs/guides/build-banking-apps/introduction-to-the-open-banking-api/global-customer-access-controls","title":"Global customer access controls","to":"/docs/guides/build-banking-apps/introduction-to-the-open-banking-api/global-customer-access-controls","use":"$3"}]},{"id":"/docs/guides/build-banking-apps/get-started","title":"Get started","use":"$3","items":[{"id":"/docs/guides/build-banking-apps/get-started/register-your-application-in-the-developer-portal","title":"1. Register your application in the Developer Portal","to":"/docs/guides/build-banking-apps/get-started/register-your-application-in-the-developer-portal","use":"$3"},{"id":"/docs/guides/build-banking-apps/get-started/prepare-sandbox-environment","title":"2. Prepare your Sandbox environment","to":"/docs/guides/build-banking-apps/get-started/prepare-sandbox-environment","use":"$3"},{"id":"/docs/guides/build-banking-apps/get-started/setup-prod-environment","title":"3. Set up production environment","to":"/docs/guides/build-banking-apps/get-started/setup-prod-environment","use":"$3"},{"id":"/docs/guides/build-banking-apps/get-started/get-access-token","title":"4. Get the access token","to":"/docs/guides/build-banking-apps/get-started/get-access-token","use":"$3"}]},{"id":"/docs/guides/build-banking-apps/register-your-application-using-dcr","title":"Register your application using DCR","use":"$3","to":"/docs/guides/build-banking-apps/register-your-application-using-dcr","items":[{"id":"/docs/guides/build-banking-apps/register-your-application-using-dcr/get-the-jwks-url","title":"1. Get the JWKs URL","to":"/docs/guides/build-banking-apps/register-your-application-using-dcr/get-the-jwks-url","use":"$3"},{"id":"/docs/guides/build-banking-apps/register-your-application-using-dcr/get-the-software-statement","title":"2. Get the software statement","to":"/docs/guides/build-banking-apps/register-your-application-using-dcr/get-the-software-statement","use":"$3"},{"id":"/docs/guides/build-banking-apps/register-your-application-using-dcr/get-your-certificates-distinguished-name","title":"3. Get your certificate's distinguished name","to":"/docs/guides/build-banking-apps/register-your-application-using-dcr/get-your-certificates-distinguished-name","use":"$3"},{"id":"/docs/guides/build-banking-apps/register-your-application-using-dcr/create-a-jwt","title":"4. Create a JWT","to":"/docs/guides/build-banking-apps/register-your-application-using-dcr/create-a-jwt","use":"$3"},{"id":"/docs/guides/build-banking-apps/register-your-application-using-dcr/validate-your-jwt","title":"5. Validate your JWT","to":"/docs/guides/build-banking-apps/register-your-application-using-dcr/validate-your-jwt","use":"$3"},{"id":"/docs/guides/build-banking-apps/register-your-application-using-dcr/get-a-client-id","title":"6. Get a client ID","to":"/docs/guides/build-banking-apps/register-your-application-using-dcr/get-a-client-id","use":"$3"},{"id":"/docs/guides/build-banking-apps/register-your-application-using-dcr/open-id-configuration-urls","title":"Open ID configuration URLs","to":"/docs/guides/build-banking-apps/register-your-application-using-dcr/open-id-configuration-urls","use":"$3"}]},{"id":"/docs/guides/build-banking-apps/manage-your-applications","title":"Manage your applications","use":"$3","items":[{"id":"/docs/guides/build-banking-apps/manage-your-applications/get-an-application","title":"Retrieve application data","to":"/docs/guides/build-banking-apps/manage-your-applications/get-an-application","use":"$3"},{"id":"/docs/guides/build-banking-apps/manage-your-applications/update-an-application","title":"Update application data","to":"/docs/guides/build-banking-apps/manage-your-applications/update-an-application","use":"$3"},{"id":"/docs/guides/build-banking-apps/manage-your-applications/update-certificates","title":"Update application certificates","to":"/docs/guides/build-banking-apps/manage-your-applications/update-certificates","use":"$3"},{"id":"/docs/guides/build-banking-apps/manage-your-applications/delete-an-application","title":"Delete an application","to":"/docs/guides/build-banking-apps/manage-your-applications/delete-an-application","use":"$3"}]},{"id":"/docs/guides/build-banking-apps/tutorials","title":"Tutorials","use":"$3","items":[{"id":"/docs/guides/build-banking-apps/tutorials/get-account-and-transaction-information","title":"Get account and transaction information","to":"/docs/guides/build-banking-apps/tutorials/get-account-and-transaction-information","use":"$3"},{"id":"/docs/guides/build-banking-apps/tutorials/initiate-your-first-payment","title":"Initiate your first payment","to":"/docs/guides/build-banking-apps/tutorials/initiate-your-first-payment","use":"$3"},{"id":"/docs/guides/build-banking-apps/tutorials/test-with-postman","title":"Test with Postman","use":"$3","items":[{"id":"/docs/guides/build-banking-apps/tutorials/test-with-postman/set-up-postman","title":"Set up Postman","to":"/docs/guides/build-banking-apps/tutorials/test-with-postman/set-up-postman","use":"$3"},{"id":"/docs/guides/build-banking-apps/tutorials/test-with-postman/get-an-account-access-consent","title":"Get an account access consent","to":"/docs/guides/build-banking-apps/tutorials/test-with-postman/get-an-account-access-consent","use":"$3"},{"id":"/docs/guides/build-banking-apps/tutorials/test-with-postman/get-a-payment-consent","title":"Get a payment consent","to":"/docs/guides/build-banking-apps/tutorials/test-with-postman/get-a-payment-consent","use":"$3"}]},{"id":"/docs/guides/build-banking-apps/tutorials/create-a-file-payment","title":"Create a file payment","to":"/docs/guides/build-banking-apps/tutorials/create-a-file-payment","use":"$3"},{"id":"/docs/guides/build-banking-apps/tutorials/create-your-first-draft-payment","title":"Create your first draft payment","to":"/docs/guides/build-banking-apps/tutorials/create-your-first-draft-payment","use":"$3"},{"id":"/docs/guides/build-banking-apps/tutorials/work-with-draft-payments","title":"Work with draft payments","to":"/docs/guides/build-banking-apps/tutorials/work-with-draft-payments","use":"$3"},{"id":"/docs/guides/build-banking-apps/tutorials/work-with-json-web-tokens","title":"Work with JSON Web Tokens","to":"/docs/guides/build-banking-apps/tutorials/work-with-json-web-tokens","use":"$3"},{"id":"/docs/guides/build-banking-apps/tutorials/work-with-json-web-signatures","title":"Work with JSON Web Signatures","to":"/docs/guides/build-banking-apps/tutorials/work-with-json-web-signatures","use":"$3"}]},{"id":"/docs/guides/build-banking-apps/api-metrics","title":"API metrics","to":"/docs/guides/build-banking-apps/api-metrics","use":"$3"},{"id":"/docs/guides/build-banking-apps/usage-and-limits","title":"Usage and limits","to":"/docs/guides/build-banking-apps/usage-and-limits","use":"$3"},{"id":"/docs/guides/build-banking-apps/glossary","title":"Glossary","to":"/docs/guides/build-banking-apps/glossary","use":"$3"},{"id":"/docs/guides/build-banking-apps/faqs","title":"FAQs","to":"/docs/guides/build-banking-apps/faqs","use":"$3"},{"id":"/docs/guides/build-banking-apps/errors","title":"Errors","to":"/docs/guides/build-banking-apps/errors","use":"$3"}]},{"id":"/docs/guides/crypto-ramp","title":"Crypto Ramp","use":"$3","root":true,"items":[{"id":"/docs/guides/crypto-ramp/introduction-to-revolut-ramp","title":"Introduction to Revolut Ramp","use":"$3","items":[{"id":"/docs/guides/crypto-ramp/introduction-to-revolut-ramp/introduction-to-revolut-ramp","title":"Introduction","to":"/docs/guides/crypto-ramp/introduction-to-revolut-ramp/introduction-to-revolut-ramp","use":"$3"},{"id":"/docs/guides/crypto-ramp/introduction-to-revolut-ramp/partner-journey","title":"Partner journey","to":"/docs/guides/crypto-ramp/introduction-to-revolut-ramp/partner-journey","use":"$3"},{"id":"/docs/guides/crypto-ramp/introduction-to-revolut-ramp/coverage-and-other-details","title":"Coverage and other details","use":"$3","items":[{"id":"/docs/guides/crypto-ramp/introduction-to-revolut-ramp/coverage-and-other-details/crypto-tokens","title":"Tokens","to":"/docs/guides/crypto-ramp/introduction-to-revolut-ramp/coverage-and-other-details/crypto-tokens","use":"$3"},{"id":"/docs/guides/crypto-ramp/introduction-to-revolut-ramp/coverage-and-other-details/currencies-and-regions","title":"Currencies and regions","to":"/docs/guides/crypto-ramp/introduction-to-revolut-ramp/coverage-and-other-details/currencies-and-regions","use":"$3"},{"id":"/docs/guides/crypto-ramp/introduction-to-revolut-ramp/coverage-and-other-details/payment-options","title":"Payment options","to":"/docs/guides/crypto-ramp/introduction-to-revolut-ramp/coverage-and-other-details/payment-options","use":"$3"},{"id":"/docs/guides/crypto-ramp/introduction-to-revolut-ramp/coverage-and-other-details/limits-and-fees","title":"Limits and fees","to":"/docs/guides/crypto-ramp/introduction-to-revolut-ramp/coverage-and-other-details/limits-and-fees","use":"$3"}]},{"id":"/docs/guides/crypto-ramp/introduction-to-revolut-ramp/integration-options","title":"Integration with Revolut Ramp","to":"/docs/guides/crypto-ramp/introduction-to-revolut-ramp/integration-options","use":"$3"},{"id":"/docs/guides/crypto-ramp/introduction-to-revolut-ramp/configuration-options","title":"Configuration options","to":"/docs/guides/crypto-ramp/introduction-to-revolut-ramp/configuration-options","use":"$3"}]},{"id":"/docs/guides/crypto-ramp/get-started","title":"Get started","use":"$3","items":[{"id":"/docs/guides/crypto-ramp/get-started/integrate-with-revolut-ramp","title":"Integrate with Revolut Ramp","to":"/docs/guides/crypto-ramp/get-started/integrate-with-revolut-ramp","use":"$3"},{"id":"/docs/guides/crypto-ramp/get-started/initiate-transaction","title":"Initiate a transaction","to":"/docs/guides/crypto-ramp/get-started/initiate-transaction","use":"$3"},{"id":"/docs/guides/crypto-ramp/get-started/customer-perspective","title":"Create an order - customer's perspective","to":"/docs/guides/crypto-ramp/get-started/customer-perspective","use":"$3"}]},{"id":"/docs/guides/crypto-ramp/tutorials","title":"API usage and testing","use":"$3","items":[{"id":"/docs/guides/crypto-ramp/tutorials/test-the-integration","title":"Test the integration","to":"/docs/guides/crypto-ramp/tutorials/test-the-integration","use":"$3"},{"id":"/docs/guides/crypto-ramp/tutorials/use-the-api","title":"Leverage the Crypto Ramp API","to":"/docs/guides/crypto-ramp/tutorials/use-the-api","use":"$3"},{"id":"/docs/guides/crypto-ramp/tutorials/work-with-webhooks","title":"Work with webhooks","use":"$3","items":[{"id":"/docs/guides/crypto-ramp/tutorials/work-with-webhooks/use-webhooks","title":"Track order and payment lifecycle","to":"/docs/guides/crypto-ramp/tutorials/work-with-webhooks/use-webhooks","use":"$3"},{"id":"/docs/guides/crypto-ramp/tutorials/work-with-webhooks/verify-the-payload-signature","title":"Verify the payload signature","to":"/docs/guides/crypto-ramp/tutorials/work-with-webhooks/verify-the-payload-signature","use":"$3"}]}]},{"id":"/docs/guides/crypto-ramp/glossary","title":"Glossary","to":"/docs/guides/crypto-ramp/glossary","use":"$3"}]},{"id":"/docs/guides/exchange-fix-api","title":"Exchange FIX API","use":"$3","root":true,"items":[{"id":"/docs/guides/exchange-fix-api/introduction-to-the-exchange-fix-api","title":"Introduction to the Revolut Exchange FIX API","use":"$3","items":[{"id":"/docs/guides/exchange-fix-api/introduction-to-the-exchange-fix-api/exchange-fix-api","title":"Introduction","to":"/docs/guides/exchange-fix-api/introduction-to-the-exchange-fix-api/exchange-fix-api","use":"$3"},{"id":"/docs/guides/exchange-fix-api/introduction-to-the-exchange-fix-api/system-overview","title":"System overview","to":"/docs/guides/exchange-fix-api/introduction-to-the-exchange-fix-api/system-overview","use":"$3"},{"id":"/docs/guides/exchange-fix-api/introduction-to-the-exchange-fix-api/reading-instructions","title":"Reading instructions","to":"/docs/guides/exchange-fix-api/introduction-to-the-exchange-fix-api/reading-instructions","use":"$3"}]},{"id":"/docs/guides/exchange-fix-api/trading-fix-api","title":"Trading FIX API","use":"$3","items":[{"id":"/docs/guides/exchange-fix-api/trading-fix-api/supported-fix-messages","title":"Supported FIX messages","use":"$3","items":[{"id":"/docs/guides/exchange-fix-api/trading-fix-api/supported-fix-messages/supported-fix-messages-trading-overview","title":"Overview","to":"/docs/guides/exchange-fix-api/trading-fix-api/supported-fix-messages/supported-fix-messages-trading-overview","use":"$3"},{"id":"/docs/guides/exchange-fix-api/trading-fix-api/supported-fix-messages/fix-session-level-messages","title":"Session level messages","use":"$3","items":[{"id":"/docs/guides/exchange-fix-api/trading-fix-api/supported-fix-messages/fix-session-level-messages/message-A-logon","title":"A (Logon)","to":"/docs/guides/exchange-fix-api/trading-fix-api/supported-fix-messages/fix-session-level-messages/message-A-logon","use":"$3"},{"id":"/docs/guides/exchange-fix-api/trading-fix-api/supported-fix-messages/fix-session-level-messages/message-0-heartbeat","title":"0 (Heartbeat)","to":"/docs/guides/exchange-fix-api/trading-fix-api/supported-fix-messages/fix-session-level-messages/message-0-heartbeat","use":"$3"},{"id":"/docs/guides/exchange-fix-api/trading-fix-api/supported-fix-messages/fix-session-level-messages/message-1-test-request","title":"1 (Test request)","to":"/docs/guides/exchange-fix-api/trading-fix-api/supported-fix-messages/fix-session-level-messages/message-1-test-request","use":"$3"},{"id":"/docs/guides/exchange-fix-api/trading-fix-api/supported-fix-messages/fix-session-level-messages/message-2-resend-request","title":"2 (Resend request)","to":"/docs/guides/exchange-fix-api/trading-fix-api/supported-fix-messages/fix-session-level-messages/message-2-resend-request","use":"$3"},{"id":"/docs/guides/exchange-fix-api/trading-fix-api/supported-fix-messages/fix-session-level-messages/message-3-session-level-reject","title":"3 (Session level reject)","to":"/docs/guides/exchange-fix-api/trading-fix-api/supported-fix-messages/fix-session-level-messages/message-3-session-level-reject","use":"$3"},{"id":"/docs/guides/exchange-fix-api/trading-fix-api/supported-fix-messages/fix-session-level-messages/message-4-reset-sequence","title":"4 (Sequence reset)","to":"/docs/guides/exchange-fix-api/trading-fix-api/supported-fix-messages/fix-session-level-messages/message-4-reset-sequence","use":"$3"},{"id":"/docs/guides/exchange-fix-api/trading-fix-api/supported-fix-messages/fix-session-level-messages/message-5-logout","title":"5 (Logout)","to":"/docs/guides/exchange-fix-api/trading-fix-api/supported-fix-messages/fix-session-level-messages/message-5-logout","use":"$3"}]},{"id":"/docs/guides/exchange-fix-api/trading-fix-api/supported-fix-messages/fix-application-level-messages","title":"Application level messages","use":"$3","items":[{"id":"/docs/guides/exchange-fix-api/trading-fix-api/supported-fix-messages/fix-application-level-messages/standard-message-header","title":"Standard message header","to":"/docs/guides/exchange-fix-api/trading-fix-api/supported-fix-messages/fix-application-level-messages/standard-message-header","use":"$3"},{"id":"/docs/guides/exchange-fix-api/trading-fix-api/supported-fix-messages/fix-application-level-messages/standard-message-trailer","title":"Standard message trailer","to":"/docs/guides/exchange-fix-api/trading-fix-api/supported-fix-messages/fix-application-level-messages/standard-message-trailer","use":"$3"},{"id":"/docs/guides/exchange-fix-api/trading-fix-api/supported-fix-messages/fix-application-level-messages/order-state-transitions","title":"Order state transitions","to":"/docs/guides/exchange-fix-api/trading-fix-api/supported-fix-messages/fix-application-level-messages/order-state-transitions","use":"$3"},{"id":"/docs/guides/exchange-fix-api/trading-fix-api/supported-fix-messages/fix-application-level-messages/currency-pairs","title":"Currency pairs","to":"/docs/guides/exchange-fix-api/trading-fix-api/supported-fix-messages/fix-application-level-messages/currency-pairs","use":"$3"},{"id":"/docs/guides/exchange-fix-api/trading-fix-api/supported-fix-messages/fix-application-level-messages/order-rejection-codes","title":"Order rejection codes","to":"/docs/guides/exchange-fix-api/trading-fix-api/supported-fix-messages/fix-application-level-messages/order-rejection-codes","use":"$3"},{"id":"/docs/guides/exchange-fix-api/trading-fix-api/supported-fix-messages/fix-application-level-messages/message-D-new-order-single","title":"D (New order - single)","to":"/docs/guides/exchange-fix-api/trading-fix-api/supported-fix-messages/fix-application-level-messages/message-D-new-order-single","use":"$3"},{"id":"/docs/guides/exchange-fix-api/trading-fix-api/supported-fix-messages/fix-application-level-messages/message-F-order-cancel-request","title":"F (Order cancel request)","to":"/docs/guides/exchange-fix-api/trading-fix-api/supported-fix-messages/fix-application-level-messages/message-F-order-cancel-request","use":"$3"},{"id":"/docs/guides/exchange-fix-api/trading-fix-api/supported-fix-messages/fix-application-level-messages/message-G-order-cancel-replace-request","title":"G (Order cancel/replace request)","to":"/docs/guides/exchange-fix-api/trading-fix-api/supported-fix-messages/fix-application-level-messages/message-G-order-cancel-replace-request","use":"$3"},{"id":"/docs/guides/exchange-fix-api/trading-fix-api/supported-fix-messages/fix-application-level-messages/message-H-order-status-request","title":"H (Order status request)","to":"/docs/guides/exchange-fix-api/trading-fix-api/supported-fix-messages/fix-application-level-messages/message-H-order-status-request","use":"$3"},{"id":"/docs/guides/exchange-fix-api/trading-fix-api/supported-fix-messages/fix-application-level-messages/message-q-order-mass-cancel-request","title":"q (Order mass cancel request)","to":"/docs/guides/exchange-fix-api/trading-fix-api/supported-fix-messages/fix-application-level-messages/message-q-order-mass-cancel-request","use":"$3"},{"id":"/docs/guides/exchange-fix-api/trading-fix-api/supported-fix-messages/fix-application-level-messages/message-8-execution-report","title":"8 (Execution report)","to":"/docs/guides/exchange-fix-api/trading-fix-api/supported-fix-messages/fix-application-level-messages/message-8-execution-report","use":"$3"},{"id":"/docs/guides/exchange-fix-api/trading-fix-api/supported-fix-messages/fix-application-level-messages/message-9-order-cancel-reject","title":"9 (Order cancel reject)","to":"/docs/guides/exchange-fix-api/trading-fix-api/supported-fix-messages/fix-application-level-messages/message-9-order-cancel-reject","use":"$3"},{"id":"/docs/guides/exchange-fix-api/trading-fix-api/supported-fix-messages/fix-application-level-messages/message-j-business-message-reject","title":"j (Business message reject)","to":"/docs/guides/exchange-fix-api/trading-fix-api/supported-fix-messages/fix-application-level-messages/message-j-business-message-reject","use":"$3"},{"id":"/docs/guides/exchange-fix-api/trading-fix-api/supported-fix-messages/fix-application-level-messages/message-r-order-mass-cancel-report","title":"r (Order mass cancel report)","to":"/docs/guides/exchange-fix-api/trading-fix-api/supported-fix-messages/fix-application-level-messages/message-r-order-mass-cancel-report","use":"$3"}]}]}]},{"id":"/docs/guides/exchange-fix-api/market-data-fix-api","title":"Market Data FIX API","use":"$3","items":[{"id":"/docs/guides/exchange-fix-api/market-data-fix-api/supported-fix-messages","title":"Supported FIX messages","use":"$3","items":[{"id":"/docs/guides/exchange-fix-api/market-data-fix-api/supported-fix-messages/supported-fix-messages-market-data-overview","title":"Overview","to":"/docs/guides/exchange-fix-api/market-data-fix-api/supported-fix-messages/supported-fix-messages-market-data-overview","use":"$3"},{"id":"/docs/guides/exchange-fix-api/market-data-fix-api/supported-fix-messages/fix-session-level-messages","title":"Session level messages","use":"$3","items":[{"id":"/docs/guides/exchange-fix-api/market-data-fix-api/supported-fix-messages/fix-session-level-messages/message-A-logon","title":"A (Logon)","to":"/docs/guides/exchange-fix-api/market-data-fix-api/supported-fix-messages/fix-session-level-messages/message-A-logon","use":"$3"},{"id":"/docs/guides/exchange-fix-api/market-data-fix-api/supported-fix-messages/fix-session-level-messages/message-0-heartbeat","title":"0 (Heartbeat)","to":"/docs/guides/exchange-fix-api/market-data-fix-api/supported-fix-messages/fix-session-level-messages/message-0-heartbeat","use":"$3"},{"id":"/docs/guides/exchange-fix-api/market-data-fix-api/supported-fix-messages/fix-session-level-messages/message-1-test-request","title":"1 (Test request)","to":"/docs/guides/exchange-fix-api/market-data-fix-api/supported-fix-messages/fix-session-level-messages/message-1-test-request","use":"$3"},{"id":"/docs/guides/exchange-fix-api/market-data-fix-api/supported-fix-messages/fix-session-level-messages/message-2-resend-request","title":"2 (Resend request)","to":"/docs/guides/exchange-fix-api/market-data-fix-api/supported-fix-messages/fix-session-level-messages/message-2-resend-request","use":"$3"},{"id":"/docs/guides/exchange-fix-api/market-data-fix-api/supported-fix-messages/fix-session-level-messages/message-3-session-level-reject","title":"3 (Session level reject)","to":"/docs/guides/exchange-fix-api/market-data-fix-api/supported-fix-messages/fix-session-level-messages/message-3-session-level-reject","use":"$3"},{"id":"/docs/guides/exchange-fix-api/market-data-fix-api/supported-fix-messages/fix-session-level-messages/message-4-reset-sequence","title":"4 (Sequence reset)","to":"/docs/guides/exchange-fix-api/market-data-fix-api/supported-fix-messages/fix-session-level-messages/message-4-reset-sequence","use":"$3"},{"id":"/docs/guides/exchange-fix-api/market-data-fix-api/supported-fix-messages/fix-session-level-messages/message-5-logout","title":"5 (Logout)","to":"/docs/guides/exchange-fix-api/market-data-fix-api/supported-fix-messages/fix-session-level-messages/message-5-logout","use":"$3"}]},{"id":"/docs/guides/exchange-fix-api/market-data-fix-api/supported-fix-messages/fix-application-level-messages","title":"Application level messages","use":"$3","items":[{"id":"/docs/guides/exchange-fix-api/market-data-fix-api/supported-fix-messages/fix-application-level-messages/standard-message-header","title":"Standard message header","to":"/docs/guides/exchange-fix-api/market-data-fix-api/supported-fix-messages/fix-application-level-messages/standard-message-header","use":"$3"},{"id":"/docs/guides/exchange-fix-api/market-data-fix-api/supported-fix-messages/fix-application-level-messages/standard-message-trailer","title":"Standard message trailer","to":"/docs/guides/exchange-fix-api/market-data-fix-api/supported-fix-messages/fix-application-level-messages/standard-message-trailer","use":"$3"},{"id":"/docs/guides/exchange-fix-api/market-data-fix-api/supported-fix-messages/fix-application-level-messages/currency-pairs","title":"Currency pairs","to":"/docs/guides/exchange-fix-api/market-data-fix-api/supported-fix-messages/fix-application-level-messages/currency-pairs","use":"$3"},{"id":"/docs/guides/exchange-fix-api/market-data-fix-api/supported-fix-messages/fix-application-level-messages/message-v-market-data-request","title":"V (Market data request)","to":"/docs/guides/exchange-fix-api/market-data-fix-api/supported-fix-messages/fix-application-level-messages/message-v-market-data-request","use":"$3"},{"id":"/docs/guides/exchange-fix-api/market-data-fix-api/supported-fix-messages/fix-application-level-messages/message-w-full-refresh","title":"W (Market Data - Snapshot/Full refresh)","to":"/docs/guides/exchange-fix-api/market-data-fix-api/supported-fix-messages/fix-application-level-messages/message-w-full-refresh","use":"$3"},{"id":"/docs/guides/exchange-fix-api/market-data-fix-api/supported-fix-messages/fix-application-level-messages/message-x-incremental-refresh","title":"X (Market Data - Incremental Refresh)","to":"/docs/guides/exchange-fix-api/market-data-fix-api/supported-fix-messages/fix-application-level-messages/message-x-incremental-refresh","use":"$3"},{"id":"/docs/guides/exchange-fix-api/market-data-fix-api/supported-fix-messages/fix-application-level-messages/message-y-market-data-request-reject","title":"Y (Market Data Request Reject)","to":"/docs/guides/exchange-fix-api/market-data-fix-api/supported-fix-messages/fix-application-level-messages/message-y-market-data-request-reject","use":"$3"}]}]}]},{"id":"/docs/guides/exchange-fix-api/fix-session-management","title":"FIX session management","use":"$3","items":[{"id":"/docs/guides/exchange-fix-api/fix-session-management/starting-session-and-authentication","title":"Starting session and authentication","to":"/docs/guides/exchange-fix-api/fix-session-management/starting-session-and-authentication","use":"$3"},{"id":"/docs/guides/exchange-fix-api/fix-session-management/session-termination","title":"Session termination","to":"/docs/guides/exchange-fix-api/fix-session-management/session-termination","use":"$3"},{"id":"/docs/guides/exchange-fix-api/fix-session-management/reject-handling","title":"Reject handling","to":"/docs/guides/exchange-fix-api/fix-session-management/reject-handling","use":"$3"}]}]},{"id":"/docs/guides/manage-accounts","title":"Manage Accounts","use":"$3","root":true,"items":[{"id":"/docs/guides/manage-accounts/introduction","title":"Introduction to the Business API","to":"/docs/guides/manage-accounts/introduction","use":"$3"},{"id":"/docs/guides/manage-accounts/use-cases","title":"Use cases","use":"$3","items":[{"id":"/docs/guides/manage-accounts/use-cases/accounts-and-transactions-syncing","title":"Accounts and transactions syncing","to":"/docs/guides/manage-accounts/use-cases/accounts-and-transactions-syncing","use":"$3"},{"id":"/docs/guides/manage-accounts/use-cases/expenses-and-receipts","title":"Expenses and receipts syncing","to":"/docs/guides/manage-accounts/use-cases/expenses-and-receipts","use":"$3"},{"id":"/docs/guides/manage-accounts/use-cases/payouts-automation","title":"Payouts automation","to":"/docs/guides/manage-accounts/use-cases/payouts-automation","use":"$3"}]},{"id":"/docs/guides/manage-accounts/get-started","title":"Get started","use":"$3","items":[{"id":"/docs/guides/manage-accounts/get-started/sign-up-for-revolut-business-account","title":"1. Sign up for Revolut Business account","to":"/docs/guides/manage-accounts/get-started/sign-up-for-revolut-business-account","use":"$3"},{"id":"/docs/guides/manage-accounts/get-started/prepare-sandbox-environment","title":"2. Set up a test environment with Revolut Sandbox","to":"/docs/guides/manage-accounts/get-started/prepare-sandbox-environment","use":"$3"},{"id":"/docs/guides/manage-accounts/get-started/make-your-first-api-request","title":"3. Make your first API request","to":"/docs/guides/manage-accounts/get-started/make-your-first-api-request","use":"$3"}]},{"id":"/docs/guides/manage-accounts/accounting","title":"Accounting settings","use":"$3","items":[{"id":"/docs/guides/manage-accounts/accounting/manage-accounting-settings","title":"Overview","to":"/docs/guides/manage-accounts/accounting/manage-accounting-settings","use":"$3"},{"id":"/docs/guides/manage-accounts/accounting/manage-accounting-categories","title":"Accounting categories","to":"/docs/guides/manage-accounts/accounting/manage-accounting-categories","use":"$3"},{"id":"/docs/guides/manage-accounts/accounting/manage-tax-rates","title":"Tax rates","to":"/docs/guides/manage-accounts/accounting/manage-tax-rates","use":"$3"},{"id":"/docs/guides/manage-accounts/accounting/manage-labels-and-label-groups","title":"Labels and label groups","to":"/docs/guides/manage-accounts/accounting/manage-labels-and-label-groups","use":"$3"}]},{"id":"/docs/guides/manage-accounts/accounts-and-transactions","title":"Accounts and transactions","use":"$3","items":[{"id":"/docs/guides/manage-accounts/accounts-and-transactions/manage-your-accounts","title":"Accounts","to":"/docs/guides/manage-accounts/accounts-and-transactions/manage-your-accounts","use":"$3"},{"id":"/docs/guides/manage-accounts/accounts-and-transactions/retrieve-expenses","title":"Expenses","to":"/docs/guides/manage-accounts/accounts-and-transactions/retrieve-expenses","use":"$3"},{"id":"/docs/guides/manage-accounts/accounts-and-transactions/retrieve-transactions","title":"Transactions","to":"/docs/guides/manage-accounts/accounts-and-transactions/retrieve-transactions","use":"$3"},{"id":"/docs/guides/manage-accounts/accounts-and-transactions/map-transaction-data","title":"Map transactions","to":"/docs/guides/manage-accounts/accounts-and-transactions/map-transaction-data","use":"$3"}]},{"id":"/docs/guides/manage-accounts/counterparties","title":"Counterparties","use":"$3","items":[{"id":"/docs/guides/manage-accounts/counterparties/create-a-counterparty","title":"Create a counterparty","to":"/docs/guides/manage-accounts/counterparties/create-a-counterparty","use":"$3"},{"id":"/docs/guides/manage-accounts/counterparties/retrieve-counterparties","title":"Retrieve counterparties","to":"/docs/guides/manage-accounts/counterparties/retrieve-counterparties","use":"$3"},{"id":"/docs/guides/manage-accounts/counterparties/update-counterparty-payment-method","title":"Update a counterparty's payment method","to":"/docs/guides/manage-accounts/counterparties/update-counterparty-payment-method","use":"$3"},{"id":"/docs/guides/manage-accounts/counterparties/confirmation-of-payee","title":"Confirmation of Payee (CoP)","to":"/docs/guides/manage-accounts/counterparties/confirmation-of-payee","use":"$3"}]},{"id":"/docs/guides/manage-accounts/transfers","title":"Transfers","use":"$3","items":[{"id":"/docs/guides/manage-accounts/transfers/send-money","title":"Send money","to":"/docs/guides/manage-accounts/transfers/send-money","use":"$3"},{"id":"/docs/guides/manage-accounts/transfers/bank-transfers","title":"Bank transfers","to":"/docs/guides/manage-accounts/transfers/bank-transfers","use":"$3"},{"id":"/docs/guides/manage-accounts/transfers/card-transfers","title":"Card transfers","to":"/docs/guides/manage-accounts/transfers/card-transfers","use":"$3"},{"id":"/docs/guides/manage-accounts/transfers/payout-links","title":"Payout links","to":"/docs/guides/manage-accounts/transfers/payout-links","use":"$3"},{"id":"/docs/guides/manage-accounts/transfers/payment-drafts","title":"Payment drafts","to":"/docs/guides/manage-accounts/transfers/payment-drafts","use":"$3"},{"id":"/docs/guides/manage-accounts/transfers/prepare-and-validate-transfers","title":"Prepare and validate transfers","to":"/docs/guides/manage-accounts/transfers/prepare-and-validate-transfers","use":"$3"}]},{"id":"/docs/guides/manage-accounts/exchange-money","title":"Foreign exchange","to":"/docs/guides/manage-accounts/exchange-money","use":"$3"},{"id":"/docs/guides/manage-accounts/cards","title":"Cards","use":"$3","items":[{"id":"/docs/guides/manage-accounts/cards/manage-cards","title":"Cards","to":"/docs/guides/manage-accounts/cards/manage-cards","use":"$3"},{"id":"/docs/guides/manage-accounts/cards/manage-card-invitations","title":"Card invitations","to":"/docs/guides/manage-accounts/cards/manage-card-invitations","use":"$3"}]},{"id":"/docs/guides/manage-accounts/teams","title":"Teams","use":"$3","items":[{"id":"/docs/guides/manage-accounts/teams/manage-team-members","title":"Members and roles","to":"/docs/guides/manage-accounts/teams/manage-team-members","use":"$3"}]},{"id":"/docs/guides/manage-accounts/webhooks","title":"Webhooks","use":"$3","items":[{"id":"/docs/guides/manage-accounts/webhooks/about-webhooks","title":"About webhooks","to":"/docs/guides/manage-accounts/webhooks/about-webhooks","use":"$3"},{"id":"/docs/guides/manage-accounts/webhooks/manage-webhooks","title":"Manage webhooks","to":"/docs/guides/manage-accounts/webhooks/manage-webhooks","use":"$3"},{"id":"/docs/guides/manage-accounts/webhooks/verify-the-payload-signature","title":"Verify the payload signature","to":"/docs/guides/manage-accounts/webhooks/verify-the-payload-signature","use":"$3"}]},{"id":"/docs/guides/manage-accounts/api-usage-and-testing","title":"API usage and testing","use":"$3","items":[{"id":"/docs/guides/manage-accounts/api-usage-and-testing/errors","title":"Errors","to":"/docs/guides/manage-accounts/api-usage-and-testing/errors","use":"$3"},{"id":"/docs/guides/manage-accounts/api-usage-and-testing/usage-and-limits","title":"Usage and limits","to":"/docs/guides/manage-accounts/api-usage-and-testing/usage-and-limits","use":"$3"},{"id":"/docs/guides/manage-accounts/api-usage-and-testing/test-flows-with-simulations","title":"Test your flows with simulations (Sandbox only)","to":"/docs/guides/manage-accounts/api-usage-and-testing/test-flows-with-simulations","use":"$3"}]}]},{"id":"/docs/guides/merchant","title":"Merchant","use":"$3","root":true,"items":[{"id":"/docs/guides/merchant/introduction","title":"Introduction","to":"/docs/guides/merchant/introduction","use":"$3"},{"id":"/docs/guides/merchant/get-started","title":"Get started","to":"/docs/guides/merchant/get-started","use":"$3"},{"id":"/docs/guides/merchant/test-and-go-live","title":"Test & go live","use":"$3","items":[{"id":"/docs/guides/merchant/test-and-go-live/set-up-sandbox","title":"Set up a test environment","to":"/docs/guides/merchant/test-and-go-live/set-up-sandbox","use":"$3"},{"id":"/docs/guides/merchant/test-and-go-live/testing","title":"Testing","use":"$3","items":[{"id":"/docs/guides/merchant/test-and-go-live/testing/implementation-checklists","title":"Implementation checklist","to":"/docs/guides/merchant/test-and-go-live/testing/implementation-checklists","use":"$3"},{"id":"/docs/guides/merchant/test-and-go-live/testing/test-flows","title":"Test payment flows","to":"/docs/guides/merchant/test-and-go-live/testing/test-flows","use":"$3"},{"id":"/docs/guides/merchant/test-and-go-live/testing/test-cards","title":"Test cards","to":"/docs/guides/merchant/test-and-go-live/testing/test-cards","use":"$3"}]}]},{"id":"/docs/guides/merchant/accept-payments","title":"Accept payments","use":"$3","items":[{"id":"/docs/guides/merchant/accept-payments/online-payments","title":"Online payments","use":"$3","items":[{"id":"/docs/guides/merchant/accept-payments/online-payments/revolut-checkout","title":"Revolut Checkout","use":"$3","items":[{"id":"/docs/guides/merchant/accept-payments/online-payments/revolut-checkout/introduction","title":"Introduction","to":"/docs/guides/merchant/accept-payments/online-payments/revolut-checkout/introduction","use":"$3"},{"id":"/docs/guides/merchant/accept-payments/online-payments/revolut-checkout/web","title":"Web","to":"/docs/guides/merchant/accept-payments/online-payments/revolut-checkout/web","use":"$3"}]},{"id":"/docs/guides/merchant/accept-payments/online-payments/revolut-pay","title":"Revolut Pay","use":"$3","items":[{"id":"/docs/guides/merchant/accept-payments/online-payments/revolut-pay/introduction","title":"Introduction","to":"/docs/guides/merchant/accept-payments/online-payments/revolut-pay/introduction","use":"$3"},{"id":"/docs/guides/merchant/accept-payments/online-payments/revolut-pay/web","title":"Web","to":"/docs/guides/merchant/accept-payments/online-payments/revolut-pay/web","use":"$3"},{"id":"/docs/guides/merchant/accept-payments/online-payments/revolut-pay/mobile","title":"Mobile","use":"$3","items":[{"id":"/docs/guides/merchant/accept-payments/online-payments/revolut-pay/mobile/ios","title":"iOS","to":"/docs/guides/merchant/accept-payments/online-payments/revolut-pay/mobile/ios","use":"$3"},{"id":"/docs/guides/merchant/accept-payments/online-payments/revolut-pay/mobile/android","title":"Android","to":"/docs/guides/merchant/accept-payments/online-payments/revolut-pay/mobile/android","use":"$3"},{"id":"/docs/guides/merchant/accept-payments/online-payments/revolut-pay/mobile/react-native","title":"React Native","to":"/docs/guides/merchant/accept-payments/online-payments/revolut-pay/mobile/react-native","use":"$3"}]},{"id":"/docs/guides/merchant/optimise-checkout/fast-checkout","title":"Fast checkout","use":"$3","to":"/docs/guides/merchant/optimise-checkout/fast-checkout"}]},{"id":"/docs/guides/merchant/accept-payments/online-payments/card-payments","title":"Card payments","use":"$3","items":[{"id":"/docs/guides/merchant/accept-payments/online-payments/card-payments/introduction","title":"Introduction","to":"/docs/guides/merchant/accept-payments/online-payments/card-payments/introduction","use":"$3"},{"id":"/docs/guides/merchant/accept-payments/online-payments/card-payments/web","title":"Web","use":"$3","items":[{"id":"/docs/guides/merchant/accept-payments/online-payments/card-payments/web/card-field","title":"Card field","to":"/docs/guides/merchant/accept-payments/online-payments/card-payments/web/card-field","use":"$3"},{"id":"/docs/guides/merchant/accept-payments/online-payments/card-payments/web/pop-up","title":"Card pop-up","to":"/docs/guides/merchant/accept-payments/online-payments/card-payments/web/pop-up","use":"$3"}]},{"id":"/docs/guides/merchant/accept-payments/online-payments/card-payments/mobile","title":"Mobile","use":"$3","items":[{"id":"/docs/guides/merchant/accept-payments/online-payments/card-payments/mobile/ios","title":"iOS","to":"/docs/guides/merchant/accept-payments/online-payments/card-payments/mobile/ios","use":"$3"},{"id":"/docs/guides/merchant/accept-payments/online-payments/card-payments/mobile/android","title":"Android","to":"/docs/guides/merchant/accept-payments/online-payments/card-payments/mobile/android","use":"$3"},{"id":"/docs/guides/merchant/accept-payments/online-payments/card-payments/mobile/react-native","title":"React Native","to":"/docs/guides/merchant/accept-payments/online-payments/card-payments/mobile/react-native","use":"$3"}]}]},{"id":"/docs/guides/merchant/accept-payments/online-payments/apple-pay-google-pay","title":"Apple Pay and Google Pay","use":"$3","items":[{"id":"/docs/guides/merchant/accept-payments/online-payments/apple-pay-google-pay/introduction","title":"Introduction","to":"/docs/guides/merchant/accept-payments/online-payments/apple-pay-google-pay/introduction","use":"$3"},{"id":"/docs/guides/merchant/accept-payments/online-payments/apple-pay-google-pay/web","title":"Web","to":"/docs/guides/merchant/accept-payments/online-payments/apple-pay-google-pay/web","use":"$3"},{"id":"/docs/guides/merchant/accept-payments/online-payments/apple-pay-google-pay/mobile","title":"Mobile","use":"$3","items":[{"id":"/docs/guides/merchant/accept-payments/online-payments/apple-pay-google-pay/mobile/ios","title":"iOS","to":"/docs/guides/merchant/accept-payments/online-payments/apple-pay-google-pay/mobile/ios","use":"$3"}]}]},{"id":"/docs/guides/merchant/accept-payments/online-payments/pay-by-bank","title":"Pay by Bank","use":"$3","items":[{"id":"/docs/guides/merchant/accept-payments/online-payments/pay-by-bank/introduction","title":"Introduction","to":"/docs/guides/merchant/accept-payments/online-payments/pay-by-bank/introduction","use":"$3"},{"id":"/docs/guides/merchant/accept-payments/online-payments/pay-by-bank/web","title":"Web","to":"/docs/guides/merchant/accept-payments/online-payments/pay-by-bank/web","use":"$3"}]},{"id":"/docs/guides/merchant/accept-payments/online-payments/sepa-direct-debit","title":"SEPA Direct Debit","use":"$3","items":[{"id":"/docs/guides/merchant/accept-payments/online-payments/sepa-direct-debit/introduction","title":"Introduction","to":"/docs/guides/merchant/accept-payments/online-payments/sepa-direct-debit/introduction","use":"$3"},{"id":"/docs/guides/merchant/accept-payments/online-payments/sepa-direct-debit/web","title":"Web","to":"/docs/guides/merchant/accept-payments/online-payments/sepa-direct-debit/web","use":"$3"}]},{"id":"/docs/guides/merchant/accept-payments/online-payments/hosted-checkout-page","title":"Hosted Checkout Page","use":"$3","items":[{"id":"/docs/guides/merchant/accept-payments/online-payments/hosted-checkout-page/introduction","title":"Introduction","to":"/docs/guides/merchant/accept-payments/online-payments/hosted-checkout-page/introduction","use":"$3"},{"id":"/docs/guides/merchant/accept-payments/online-payments/hosted-checkout-page/payment-link","title":"Payment link","to":"/docs/guides/merchant/accept-payments/online-payments/hosted-checkout-page/payment-link","use":"$3"},{"id":"/docs/guides/merchant/accept-payments/online-payments/hosted-checkout-page/api","title":"API","to":"/docs/guides/merchant/accept-payments/online-payments/hosted-checkout-page/api","use":"$3"}]}]},{"id":"/docs/guides/merchant/accept-payments/in-person-payments","title":"In-person payments","use":"$3","items":[{"id":"/docs/guides/merchant/accept-payments/in-person-payments/introduction","title":"Introduction","to":"/docs/guides/merchant/accept-payments/in-person-payments/introduction","use":"$3"},{"id":"/docs/guides/merchant/accept-payments/in-person-payments/pos","title":"Revolut POS","use":"$3","items":[{"id":"/docs/guides/merchant/accept-payments/in-person-payments/pos/introduction","title":"Introduction","to":"/docs/guides/merchant/accept-payments/in-person-payments/pos/introduction","use":"$3"},{"id":"/docs/guides/merchant/accept-payments/in-person-payments/pos/get-started","title":"Get started","to":"/docs/guides/merchant/accept-payments/in-person-payments/pos/get-started","use":"$3"},{"id":"/docs/guides/merchant/accept-payments/in-person-payments/pos/web-app","title":"Web app","use":"$3","items":[{"id":"/docs/guides/merchant/accept-payments/in-person-payments/pos/web-app/get-started","title":"Get started","to":"/docs/guides/merchant/accept-payments/in-person-payments/pos/web-app/get-started","use":"$3"},{"id":"/docs/guides/merchant/accept-payments/in-person-payments/pos/web-app/product-management","title":"Product and catalogue management","to":"/docs/guides/merchant/accept-payments/in-person-payments/pos/web-app/product-management","use":"$3"},{"id":"/docs/guides/merchant/accept-payments/in-person-payments/pos/web-app/settings","title":"Settings","to":"/docs/guides/merchant/accept-payments/in-person-payments/pos/web-app/settings","use":"$3"},{"id":"/docs/guides/merchant/accept-payments/in-person-payments/pos/web-app/staff-management","title":"Staff management","to":"/docs/guides/merchant/accept-payments/in-person-payments/pos/web-app/staff-management","use":"$3"},{"id":"/docs/guides/merchant/accept-payments/in-person-payments/pos/web-app/analytics-orders","title":"Analytics and orders","to":"/docs/guides/merchant/accept-payments/in-person-payments/pos/web-app/analytics-orders","use":"$3"}]},{"id":"/docs/guides/merchant/accept-payments/in-person-payments/pos/ios-app","title":"iOS app","use":"$3","items":[{"id":"/docs/guides/merchant/accept-payments/in-person-payments/pos/ios-app/get-started","title":"Get started","to":"/docs/guides/merchant/accept-payments/in-person-payments/pos/ios-app/get-started","use":"$3"},{"id":"/docs/guides/merchant/accept-payments/in-person-payments/pos/ios-app/order-management","title":"Order management","to":"/docs/guides/merchant/accept-payments/in-person-payments/pos/ios-app/order-management","use":"$3"},{"id":"/docs/guides/merchant/accept-payments/in-person-payments/pos/ios-app/table-service","title":"Table service","to":"/docs/guides/merchant/accept-payments/in-person-payments/pos/ios-app/table-service","use":"$3"},{"id":"/docs/guides/merchant/accept-payments/in-person-payments/pos/ios-app/catalogue","title":"Catalogue","to":"/docs/guides/merchant/accept-payments/in-person-payments/pos/ios-app/catalogue","use":"$3"},{"id":"/docs/guides/merchant/accept-payments/in-person-payments/pos/ios-app/operational-settings","title":"Operational settings","to":"/docs/guides/merchant/accept-payments/in-person-payments/pos/ios-app/operational-settings","use":"$3"},{"id":"/docs/guides/merchant/accept-payments/in-person-payments/pos/ios-app/hardware-settings","title":"Hardware settings","to":"/docs/guides/merchant/accept-payments/in-person-payments/pos/ios-app/hardware-settings","use":"$3"},{"id":"/docs/guides/merchant/accept-payments/in-person-payments/pos/ios-app/reports","title":"Reports","to":"/docs/guides/merchant/accept-payments/in-person-payments/pos/ios-app/reports","use":"$3"}]},{"id":"/docs/guides/merchant/accept-payments/in-person-payments/pos/order-pay","title":"Order and Pay","to":"/docs/guides/merchant/accept-payments/in-person-payments/pos/order-pay","use":"$3"},{"id":"/docs/guides/merchant/accept-payments/in-person-payments/pos/support","title":"Support","to":"/docs/guides/merchant/accept-payments/in-person-payments/pos/support","use":"$3"},{"id":"/docs/guides/merchant/accept-payments/in-person-payments/pos/faq","title":"FAQs","to":"/docs/guides/merchant/accept-payments/in-person-payments/pos/faq","use":"$3"}]},{"id":"/docs/guides/merchant/accept-payments/in-person-payments/terminal","title":"Revolut Terminal","use":"$3","items":[{"id":"/docs/guides/merchant/accept-payments/in-person-payments/terminal/introduction","title":"Introduction","to":"/docs/guides/merchant/accept-payments/in-person-payments/terminal/introduction","use":"$3"},{"id":"/docs/guides/merchant/accept-payments/in-person-payments/terminal/get-started","title":"Get started","to":"/docs/guides/merchant/accept-payments/in-person-payments/terminal/get-started","use":"$3"},{"id":"/docs/guides/merchant/accept-payments/in-person-payments/terminal/manage-payments","title":"Manage payments","to":"/docs/guides/merchant/accept-payments/in-person-payments/terminal/manage-payments","use":"$3"},{"id":"/docs/guides/merchant/accept-payments/in-person-payments/terminal/additional-features","title":"Additional features","to":"/docs/guides/merchant/accept-payments/in-person-payments/terminal/additional-features","use":"$3"},{"id":"/docs/guides/merchant/accept-payments/in-person-payments/terminal/push-payments","title":"Push payments to Revolut Terminal","to":"/docs/guides/merchant/accept-payments/in-person-payments/terminal/push-payments","use":"$3"},{"id":"/docs/guides/merchant/accept-payments/in-person-payments/terminal/pre-authorisation","title":"Pre-authorisation","to":"/docs/guides/merchant/accept-payments/in-person-payments/terminal/pre-authorisation","use":"$3"},{"id":"/docs/guides/merchant/accept-payments/in-person-payments/terminal/support-warranty","title":"Support and warranty","to":"/docs/guides/merchant/accept-payments/in-person-payments/terminal/support-warranty","use":"$3"}]},{"id":"/docs/guides/merchant/accept-payments/in-person-payments/reader","title":"Revolut Reader","use":"$3","items":[{"id":"/docs/guides/merchant/accept-payments/in-person-payments/reader/introduction","title":"Introduction","to":"/docs/guides/merchant/accept-payments/in-person-payments/reader/introduction","use":"$3"},{"id":"/docs/guides/merchant/accept-payments/in-person-payments/reader/get-started","title":"Get started","to":"/docs/guides/merchant/accept-payments/in-person-payments/reader/get-started","use":"$3"},{"id":"/docs/guides/merchant/accept-payments/in-person-payments/reader/manage-payments","title":"Manage payments","to":"/docs/guides/merchant/accept-payments/in-person-payments/reader/manage-payments","use":"$3"},{"id":"/docs/guides/merchant/accept-payments/in-person-payments/reader/additional-features","title":"Additional features","to":"/docs/guides/merchant/accept-payments/in-person-payments/reader/additional-features","use":"$3"},{"id":"/docs/guides/merchant/accept-payments/in-person-payments/reader/support-warranty","title":"Support and warranty","to":"/docs/guides/merchant/accept-payments/in-person-payments/reader/support-warranty","use":"$3"},{"id":"/docs/guides/merchant/accept-payments/in-person-payments/reader/faq","title":"FAQs","to":"/docs/guides/merchant/accept-payments/in-person-payments/reader/faq","use":"$3"}]},{"id":"/docs/guides/merchant/accept-payments/in-person-payments/tap-to-pay","title":"Tap to Pay","use":"$3","items":[{"id":"/docs/guides/merchant/accept-payments/in-person-payments/tap-to-pay/introduction","title":"Introduction","to":"/docs/guides/merchant/accept-payments/in-person-payments/tap-to-pay/introduction","use":"$3"},{"id":"/docs/guides/merchant/accept-payments/in-person-payments/tap-to-pay/get-started","title":"Get started","to":"/docs/guides/merchant/accept-payments/in-person-payments/tap-to-pay/get-started","use":"$3"},{"id":"/docs/guides/merchant/accept-payments/in-person-payments/tap-to-pay/integration-guide","title":"Integration guide","to":"/docs/guides/merchant/accept-payments/in-person-payments/tap-to-pay/integration-guide","use":"$3"}]}]},{"id":"/docs/guides/merchant/accept-payments/no-code","title":"No-code integrations","use":"$3","items":[{"id":"/docs/guides/merchant/accept-payments/no-code/plugins","title":"E-commerce plugins","use":"$3","items":[{"id":"/docs/guides/merchant/accept-payments/no-code/plugins/introduction","title":"Introduction","to":"/docs/guides/merchant/accept-payments/no-code/plugins/introduction","use":"$3"},{"id":"/docs/guides/merchant/accept-payments/no-code/plugins/woocommerce","title":"WooCommerce","use":"$3","items":[{"id":"/docs/guides/merchant/accept-payments/no-code/plugins/woocommerce/introduction","title":"Introduction","to":"/docs/guides/merchant/accept-payments/no-code/plugins/woocommerce/introduction","use":"$3"},{"id":"/docs/guides/merchant/accept-payments/no-code/plugins/woocommerce/installation","title":"Installation","to":"/docs/guides/merchant/accept-payments/no-code/plugins/woocommerce/installation","use":"$3"},{"id":"/docs/guides/merchant/accept-payments/no-code/plugins/woocommerce/configuration","title":"Configuration","to":"/docs/guides/merchant/accept-payments/no-code/plugins/woocommerce/configuration","use":"$3"},{"id":"/docs/guides/merchant/accept-payments/no-code/plugins/woocommerce/features","title":"Features and operations","to":"/docs/guides/merchant/accept-payments/no-code/plugins/woocommerce/features","use":"$3"}]},{"id":"/docs/guides/merchant/accept-payments/no-code/plugins/prestashop","title":"PrestaShop","use":"$3","items":[{"id":"/docs/guides/merchant/accept-payments/no-code/plugins/prestashop/introduction","title":"Introduction","to":"/docs/guides/merchant/accept-payments/no-code/plugins/prestashop/introduction","use":"$3"},{"id":"/docs/guides/merchant/accept-payments/no-code/plugins/prestashop/installation","title":"Installation","to":"/docs/guides/merchant/accept-payments/no-code/plugins/prestashop/installation","use":"$3"},{"id":"/docs/guides/merchant/accept-payments/no-code/plugins/prestashop/configuration","title":"Configuration","to":"/docs/guides/merchant/accept-payments/no-code/plugins/prestashop/configuration","use":"$3"},{"id":"/docs/guides/merchant/accept-payments/no-code/plugins/prestashop/features","title":"Features and operations","to":"/docs/guides/merchant/accept-payments/no-code/plugins/prestashop/features","use":"$3"}]},{"id":"/docs/guides/merchant/accept-payments/no-code/plugins/magento","title":"Adobe Commerce (Magento 2)","use":"$3","items":[{"id":"/docs/guides/merchant/accept-payments/no-code/plugins/magento/introduction","title":"Introduction","to":"/docs/guides/merchant/accept-payments/no-code/plugins/magento/introduction","use":"$3"},{"id":"/docs/guides/merchant/accept-payments/no-code/plugins/magento/installation","title":"Installation","to":"/docs/guides/merchant/accept-payments/no-code/plugins/magento/installation","use":"$3"},{"id":"/docs/guides/merchant/accept-payments/no-code/plugins/magento/configuration","title":"Configuration","to":"/docs/guides/merchant/accept-payments/no-code/plugins/magento/configuration","use":"$3"},{"id":"/docs/guides/merchant/accept-payments/no-code/plugins/magento/features","title":"Features and operations","to":"/docs/guides/merchant/accept-payments/no-code/plugins/magento/features","use":"$3"}]},{"id":"/docs/guides/merchant/accept-payments/no-code/plugins/bigcommerce","title":"BigCommerce","use":"$3","items":[{"id":"/docs/guides/merchant/accept-payments/no-code/plugins/bigcommerce/introduction","title":"Introduction","to":"/docs/guides/merchant/accept-payments/no-code/plugins/bigcommerce/introduction","use":"$3"},{"id":"/docs/guides/merchant/accept-payments/no-code/plugins/bigcommerce/installation","title":"Installation","to":"/docs/guides/merchant/accept-payments/no-code/plugins/bigcommerce/installation","use":"$3"},{"id":"/docs/guides/merchant/accept-payments/no-code/plugins/bigcommerce/configuration","title":"Configuration","to":"/docs/guides/merchant/accept-payments/no-code/plugins/bigcommerce/configuration","use":"$3"},{"id":"/docs/guides/merchant/accept-payments/no-code/plugins/bigcommerce/features","title":"Features and operations","to":"/docs/guides/merchant/accept-payments/no-code/plugins/bigcommerce/features","use":"$3"}]},{"id":"/docs/guides/merchant/accept-payments/no-code/plugins/shopify","title":"Shopify","use":"$3","items":[{"id":"/docs/guides/merchant/accept-payments/no-code/plugins/shopify/introduction","title":"Introduction","to":"/docs/guides/merchant/accept-payments/no-code/plugins/shopify/introduction","use":"$3"},{"id":"/docs/guides/merchant/accept-payments/no-code/plugins/shopify/installation","title":"Installation","to":"/docs/guides/merchant/accept-payments/no-code/plugins/shopify/installation","use":"$3"},{"id":"/docs/guides/merchant/accept-payments/no-code/plugins/shopify/configuration","title":"Configuration","to":"/docs/guides/merchant/accept-payments/no-code/plugins/shopify/configuration","use":"$3"},{"id":"/docs/guides/merchant/accept-payments/no-code/plugins/shopify/features","title":"Features and operations","to":"/docs/guides/merchant/accept-payments/no-code/plugins/shopify/features","use":"$3"}]},{"id":"/docs/guides/merchant/accept-payments/no-code/plugins/opencart","title":"OpenCart","use":"$3","items":[{"id":"/docs/guides/merchant/accept-payments/no-code/plugins/opencart/introduction","title":"Introduction","to":"/docs/guides/merchant/accept-payments/no-code/plugins/opencart/introduction","use":"$3"},{"id":"/docs/guides/merchant/accept-payments/no-code/plugins/opencart/installation","title":"Installation","to":"/docs/guides/merchant/accept-payments/no-code/plugins/opencart/installation","use":"$3"},{"id":"/docs/guides/merchant/accept-payments/no-code/plugins/opencart/configuration","title":"Configuration","to":"/docs/guides/merchant/accept-payments/no-code/plugins/opencart/configuration","use":"$3"},{"id":"/docs/guides/merchant/accept-payments/no-code/plugins/opencart/features","title":"Features and operations","to":"/docs/guides/merchant/accept-payments/no-code/plugins/opencart/features","use":"$3"}]}]},{"id":"/docs/guides/merchant/accept-payments/online-payments/hosted-checkout-page/payment-link","title":"Payment links","use":"$3","to":"/docs/guides/merchant/accept-payments/online-payments/hosted-checkout-page/payment-link"},{"id":"/docs/guides/merchant/accept-payments/no-code/invoices","title":"Invoices","use":"$3","items":[{"id":"/docs/guides/merchant/accept-payments/no-code/invoices/xero","title":"Xero invoices","use":"$3","items":[{"id":"/docs/guides/merchant/accept-payments/no-code/invoices/xero/configuration","title":"Configuration","to":"/docs/guides/merchant/accept-payments/no-code/invoices/xero/configuration","use":"$3"},{"id":"/docs/guides/merchant/accept-payments/no-code/invoices/xero/troubleshooting","title":"Troubleshooting","to":"/docs/guides/merchant/accept-payments/no-code/invoices/xero/troubleshooting","use":"$3"}]}]}]}]},{"id":"/docs/guides/merchant/operations","title":"Operations","use":"$3","items":[{"id":"/docs/guides/merchant/operations/capture-and-settlement","title":"Capture & settlement","use":"$3","items":[{"id":"/docs/guides/merchant/operations/capture-and-settlement/capture-later","title":"Authorise a payment to capture later","to":"/docs/guides/merchant/operations/capture-and-settlement/capture-later","use":"$3"},{"id":"/docs/guides/merchant/operations/capture-and-settlement/advanced-authorisation","title":"Advanced authorisation","use":"$3","items":[{"id":"/docs/guides/merchant/operations/capture-and-settlement/advanced-authorisation/introduction","title":"Introduction","to":"/docs/guides/merchant/operations/capture-and-settlement/advanced-authorisation/introduction","use":"$3"},{"id":"/docs/guides/merchant/operations/capture-and-settlement/advanced-authorisation/pre-authorisation","title":"Pre-authorisation","to":"/docs/guides/merchant/operations/capture-and-settlement/advanced-authorisation/pre-authorisation","use":"$3"},{"id":"/docs/guides/merchant/operations/capture-and-settlement/advanced-authorisation/incremental-authorisation","title":"Incremental authorisation","to":"/docs/guides/merchant/operations/capture-and-settlement/advanced-authorisation/incremental-authorisation","use":"$3"},{"id":"/docs/guides/merchant/operations/capture-and-settlement/advanced-authorisation/clearing-windows","title":"Clearing windows","to":"/docs/guides/merchant/operations/capture-and-settlement/advanced-authorisation/clearing-windows","use":"$3"}]}]},{"id":"/docs/guides/merchant/operations/refunds","title":"Refund payments","to":"/docs/guides/merchant/operations/refunds","use":"$3"}]},{"id":"/docs/guides/merchant/optimise-checkout","title":"Optimise checkout","use":"$3","items":[{"id":"/docs/guides/merchant/optimise-checkout/save-payment-methods","title":"Save and charge payment methods","use":"$3","items":[{"id":"/docs/guides/merchant/optimise-checkout/save-payment-methods/charge-saved-payment-method","title":"Charge a customer's saved payment method","to":"/docs/guides/merchant/optimise-checkout/save-payment-methods/charge-saved-payment-method","use":"$3"},{"id":"/docs/guides/merchant/optimise-checkout/save-payment-methods/checkout-with-saved-card","title":"Save cards and speed up checkout","to":"/docs/guides/merchant/optimise-checkout/save-payment-methods/checkout-with-saved-card","use":"$3"},{"id":"/docs/guides/merchant/optimise-checkout/save-payment-methods/subscription-management","title":"Manage subscriptions","to":"/docs/guides/merchant/optimise-checkout/save-payment-methods/subscription-management","use":"$3"}]},{"id":"/docs/guides/merchant/optimise-checkout/fast-checkout","title":"Fast checkout","to":"/docs/guides/merchant/optimise-checkout/fast-checkout","use":"$3"},{"id":"/docs/guides/merchant/optimise-checkout/promo-banners","title":"Add Promotional banner to your checkout page","to":"/docs/guides/merchant/optimise-checkout/promo-banners","use":"$3"}]},{"id":"/docs/guides/merchant/monitor-and-observe","title":"Monitor & observe","use":"$3","items":[{"id":"/docs/guides/merchant/monitor-and-observe/reports-reconciliation","title":"Create CSV reports of transactions","to":"/docs/guides/merchant/monitor-and-observe/reports-reconciliation","use":"$3"},{"id":"/docs/guides/merchant/monitor-and-observe/webhooks","title":"Work with webhooks","use":"$3","items":[{"id":"/docs/guides/merchant/monitor-and-observe/webhooks/using-webhooks","title":"Use webhooks to track order and payment lifecycle","to":"/docs/guides/merchant/monitor-and-observe/webhooks/using-webhooks","use":"$3"},{"id":"/docs/guides/merchant/monitor-and-observe/webhooks/verify-the-payload-signature","title":"Verify the payload signature","to":"/docs/guides/merchant/monitor-and-observe/webhooks/verify-the-payload-signature","use":"$3"}]}]},{"id":"/docs/guides/merchant/reference","title":"Reference","use":"$3","items":[{"id":"/docs/guides/merchant/reference/versioning","title":"Versioning","use":"$3","items":[{"id":"/docs/guides/merchant/reference/versioning/api-versions","title":"API versions","to":"/docs/guides/merchant/reference/versioning/api-versions","use":"$3"},{"id":"/docs/guides/merchant/reference/versioning/deprecation-policy","title":"Deprecation policy","to":"/docs/guides/merchant/reference/versioning/deprecation-policy","use":"$3"},{"id":"/docs/guides/merchant/reference/versioning/changelog","title":"Changelog","to":"/docs/guides/merchant/reference/versioning/changelog","use":"$3"}]},{"id":"/docs/api/merchant","title":"API","use":"$3","to":"/docs/api/merchant"},{"id":"/docs/guides/merchant/reference/sdks","title":"SDKs","use":"$3","items":[{"id":"/docs/sdks/merchant-web-sdk/introduction","title":"Web SDK","use":"$3","to":"/docs/sdks/merchant-web-sdk/introduction"},{"id":"/docs/sdks/merchant-ios-sdk/introduction","title":"iOS SDK","use":"$3","to":"/docs/sdks/merchant-ios-sdk/introduction"},{"id":"/docs/sdks/merchant-android-sdk/introduction","title":"Android SDK","use":"$3","to":"/docs/sdks/merchant-android-sdk/introduction"}]},{"id":"/docs/guides/merchant/reference/3d-secure","title":"3D Secure","to":"/docs/guides/merchant/reference/3d-secure","use":"$3"},{"id":"/docs/guides/merchant/reference/error-codes","title":"Errors","use":"$3","items":[{"id":"/docs/guides/merchant/reference/error-codes/http-response-errors","title":"HTTP response errors","to":"/docs/guides/merchant/reference/error-codes/http-response-errors","use":"$3"},{"id":"/docs/guides/merchant/reference/error-codes/decline-reasons","title":"Decline reasons","to":"/docs/guides/merchant/reference/error-codes/decline-reasons","use":"$3"}]},{"id":"/docs/guides/merchant/reference/order-lifecycle","title":"Order and payment lifecycle","to":"/docs/guides/merchant/reference/order-lifecycle","use":"$3"}]},{"id":"/blog","title":"Updates","use":"$3","to":"/blog"}]},{"id":"/docs/guides/revolut-wallet","title":"Revolut Wallet","use":"$3","root":true,"items":[{"id":"/docs/guides/revolut-wallet/introduction","title":"Introduction","to":"/docs/guides/revolut-wallet/introduction","use":"$3"},{"id":"/docs/guides/revolut-wallet/get-started","title":"Get started","to":"/docs/guides/revolut-wallet/get-started","use":"$3"},{"id":"/docs/guides/revolut-wallet/operations","title":"Operations","use":"$3","items":[{"id":"/docs/guides/revolut-wallet/operations/introduction","title":"Introduction","to":"/docs/guides/revolut-wallet/operations/introduction","use":"$3"},{"id":"/docs/guides/revolut-wallet/operations/create-pass","title":"Create a pass","to":"/docs/guides/revolut-wallet/operations/create-pass","use":"$3"},{"id":"/docs/guides/revolut-wallet/operations/update-pass","title":"Update a pass","to":"/docs/guides/revolut-wallet/operations/update-pass","use":"$3"},{"id":"/docs/guides/revolut-wallet/operations/transaction-results","title":"Transaction results","to":"/docs/guides/revolut-wallet/operations/transaction-results","use":"$3"}]}]},{"id":"/docs/resources","title":"Resources","use":"$3","root":true,"items":[{"id":"/docs/resources/marketing-guidelines","title":"Revolut Pay marketing assets and guidelines","to":"/docs/resources/marketing-guidelines","use":"$3"},{"id":"/docs/resources/revolut-pay-button-guidelines","title":"Revolut Pay button guidelines","to":"/docs/resources/revolut-pay-button-guidelines","use":"$3"},{"id":"/docs/resources/open-banking-logo-guidelines","title":"Revolut Open Banking logo assets and guidelines","to":"/docs/resources/open-banking-logo-guidelines","use":"$3"}]},{"id":"/docs/sdks/merchant-android-sdk","title":"Merchant Android SDK","use":"$3","root":true,"items":[{"id":"/docs/sdks/merchant-android-sdk/introduction","title":"Introduction","to":"/docs/sdks/merchant-android-sdk/introduction","use":"$3"},{"id":"/docs/sdks/merchant-android-sdk/revolut-pay-android-sdk","title":"Revolut Pay SDK","use":"$3","items":[{"id":"/docs/sdks/merchant-android-sdk/revolut-pay-android-sdk/introduction","title":"Introduction","to":"/docs/sdks/merchant-android-sdk/revolut-pay-android-sdk/introduction","use":"$3"},{"id":"/docs/sdks/merchant-android-sdk/revolut-pay-android-sdk/methods-parameters","title":"Methods and parameters","to":"/docs/sdks/merchant-android-sdk/revolut-pay-android-sdk/methods-parameters","use":"$3"}]},{"id":"/docs/sdks/merchant-android-sdk/revolut-card-form-android-sdk","title":"Revolut Card Form SDK","use":"$3","items":[{"id":"/docs/sdks/merchant-android-sdk/revolut-card-form-android-sdk/introduction","title":"Introduction","to":"/docs/sdks/merchant-android-sdk/revolut-card-form-android-sdk/introduction","use":"$3"},{"id":"/docs/sdks/merchant-android-sdk/revolut-card-form-android-sdk/methods-parameters","title":"Methods and parameters","to":"/docs/sdks/merchant-android-sdk/revolut-card-form-android-sdk/methods-parameters","use":"$3"}]}]},{"id":"/docs/sdks/merchant-ios-sdk","title":"Merchant iOS SDK","use":"$3","root":true,"items":[{"id":"/docs/sdks/merchant-ios-sdk/introduction","title":"Introduction","to":"/docs/sdks/merchant-ios-sdk/introduction","use":"$3"},{"id":"/docs/sdks/merchant-ios-sdk/revolut-pay-ios-sdk","title":"Revolut Pay SDK","use":"$3","items":[{"id":"/docs/sdks/merchant-ios-sdk/revolut-pay-ios-sdk/introduction","title":"Introduction","to":"/docs/sdks/merchant-ios-sdk/revolut-pay-ios-sdk/introduction","use":"$3"},{"id":"/docs/sdks/merchant-ios-sdk/revolut-pay-ios-sdk/methods-parameters","title":"Methods and parameters","to":"/docs/sdks/merchant-ios-sdk/revolut-pay-ios-sdk/methods-parameters","use":"$3"}]},{"id":"/docs/sdks/merchant-ios-sdk/apple-pay-ios-sdk","title":"Apple Pay SDK","use":"$3","items":[{"id":"/docs/sdks/merchant-ios-sdk/apple-pay-ios-sdk/introduction","title":"Introduction","to":"/docs/sdks/merchant-ios-sdk/apple-pay-ios-sdk/introduction","use":"$3"},{"id":"/docs/sdks/merchant-ios-sdk/apple-pay-ios-sdk/methods-parameters","title":"Methods and parameters","to":"/docs/sdks/merchant-ios-sdk/apple-pay-ios-sdk/methods-parameters","use":"$3"}]},{"id":"/docs/sdks/merchant-ios-sdk/tap-to-pay-sdk","title":"Tap to Pay SDK","use":"$3","items":[{"id":"/docs/sdks/merchant-ios-sdk/tap-to-pay-sdk/introduction","title":"Introduction","to":"/docs/sdks/merchant-ios-sdk/tap-to-pay-sdk/introduction","use":"$3"},{"id":"/docs/sdks/merchant-ios-sdk/tap-to-pay-sdk/methods-parameters","title":"Methods and parameters","to":"/docs/sdks/merchant-ios-sdk/tap-to-pay-sdk/methods-parameters","use":"$3"}]},{"id":"/docs/sdks/merchant-ios-sdk/revolut-card-form-ios-sdk","title":"Revolut Card Form SDK","use":"$3","items":[{"id":"/docs/sdks/merchant-ios-sdk/revolut-card-form-ios-sdk/introduction","title":"Introduction","to":"/docs/sdks/merchant-ios-sdk/revolut-card-form-ios-sdk/introduction","use":"$3"},{"id":"/docs/sdks/merchant-ios-sdk/revolut-card-form-ios-sdk/methods-parameters","title":"Methods and parameters","to":"/docs/sdks/merchant-ios-sdk/revolut-card-form-ios-sdk/methods-parameters","use":"$3"}]}]},{"id":"/docs/sdks/merchant-web-sdk","title":"Merchant Web SDK","use":"$3","root":true,"items":[{"id":"/docs/sdks/merchant-web-sdk/introduction","title":"Introduction","to":"/docs/sdks/merchant-web-sdk/introduction","use":"$3"},{"id":"/docs/sdks/merchant-web-sdk/get-started","title":"Get started","to":"/docs/sdks/merchant-web-sdk/get-started","use":"$3"},{"id":"/docs/sdks/merchant-web-sdk/initialisation","title":"Initialisation","use":"$3","items":[{"id":"/docs/sdks/merchant-web-sdk/initialisation/token-based","title":"Token-based initialisation","to":"/docs/sdks/merchant-web-sdk/initialisation/token-based","use":"$3"},{"id":"/docs/sdks/merchant-web-sdk/initialisation/direct","title":"Direct initialisation","to":"/docs/sdks/merchant-web-sdk/initialisation/direct","use":"$3"},{"id":"/docs/sdks/merchant-web-sdk/initialisation/payments-module","title":"Payments module initialisation","to":"/docs/sdks/merchant-web-sdk/initialisation/payments-module","use":"$3"},{"id":"/docs/sdks/merchant-web-sdk/initialisation/upsell-module","title":"Upsell module initialisation","to":"/docs/sdks/merchant-web-sdk/initialisation/upsell-module","use":"$3"}]},{"id":"/docs/sdks/merchant-web-sdk/payment-methods","title":"Payment methods","use":"$3","items":[{"id":"/docs/sdks/merchant-web-sdk/payment-methods/introduction","title":"Introduction","to":"/docs/sdks/merchant-web-sdk/payment-methods/introduction","use":"$3"},{"id":"/docs/sdks/merchant-web-sdk/payment-methods/embedded-checkout","title":"Embedded checkout","to":"/docs/sdks/merchant-web-sdk/payment-methods/embedded-checkout","use":"$3"},{"id":"/docs/sdks/merchant-web-sdk/payment-methods/revolut-pay","title":"Revolut Pay","to":"/docs/sdks/merchant-web-sdk/payment-methods/revolut-pay","use":"$3"},{"id":"/docs/sdks/merchant-web-sdk/payment-methods/apple-pay-google-pay","title":"Apple Pay / Google Pay","to":"/docs/sdks/merchant-web-sdk/payment-methods/apple-pay-google-pay","use":"$3"},{"id":"/docs/sdks/merchant-web-sdk/payment-methods/card-field","title":"Card field","to":"/docs/sdks/merchant-web-sdk/payment-methods/card-field","use":"$3"},{"id":"/docs/sdks/merchant-web-sdk/payment-methods/pop-up","title":"Card pop-up","to":"/docs/sdks/merchant-web-sdk/payment-methods/pop-up","use":"$3"},{"id":"/docs/sdks/merchant-web-sdk/payment-methods/pay-by-bank","title":"Pay by Bank","to":"/docs/sdks/merchant-web-sdk/payment-methods/pay-by-bank","use":"$3"},{"id":"/docs/sdks/merchant-web-sdk/payment-methods/sepa-direct-debit","title":"SEPA Direct Debit","to":"/docs/sdks/merchant-web-sdk/payment-methods/sepa-direct-debit","use":"$3"}]},{"id":"/docs/sdks/merchant-web-sdk/promotional-widgets","title":"Promotional widgets","use":"$3","items":[{"id":"/docs/sdks/merchant-web-sdk/promotional-widgets/introduction","title":"Introduction","to":"/docs/sdks/merchant-web-sdk/promotional-widgets/introduction","use":"$3"},{"id":"/docs/sdks/merchant-web-sdk/promotional-widgets/card-gateway-banner","title":"Card gateway banner","to":"/docs/sdks/merchant-web-sdk/promotional-widgets/card-gateway-banner","use":"$3"},{"id":"/docs/sdks/merchant-web-sdk/promotional-widgets/promotional-banner","title":"Promotional banner","to":"/docs/sdks/merchant-web-sdk/promotional-widgets/promotional-banner","use":"$3"},{"id":"/docs/sdks/merchant-web-sdk/promotional-widgets/enrollment-confirmation-banner","title":"Enrollment confirmation banner","to":"/docs/sdks/merchant-web-sdk/promotional-widgets/enrollment-confirmation-banner","use":"$3"}]},{"id":"/docs/sdks/merchant-web-sdk/types","title":"Types","use":"$3","items":[{"id":"/docs/sdks/merchant-web-sdk/types/introduction","title":"Introduction","to":"/docs/sdks/merchant-web-sdk/types/introduction","use":"$3"},{"id":"/docs/sdks/merchant-web-sdk/types/locale","title":"Locale","to":"/docs/sdks/merchant-web-sdk/types/locale","use":"$3"},{"id":"/docs/sdks/merchant-web-sdk/types/address","title":"Address","to":"/docs/sdks/merchant-web-sdk/types/address","use":"$3"},{"id":"/docs/sdks/merchant-web-sdk/types/customer-details","title":"CustomerDetails","to":"/docs/sdks/merchant-web-sdk/types/customer-details","use":"$3"},{"id":"/docs/sdks/merchant-web-sdk/types/revolut-checkout-error","title":"RevolutCheckoutError","to":"/docs/sdks/merchant-web-sdk/types/revolut-checkout-error","use":"$3"},{"id":"/docs/sdks/merchant-web-sdk/types/validation-error","title":"ValidationError","to":"/docs/sdks/merchant-web-sdk/types/validation-error","use":"$3"}]},{"id":"/docs/sdks/merchant-web-sdk/integration-examples","title":"Integration examples","to":"/docs/sdks/merchant-web-sdk/integration-examples","use":"$3"}]},{"id":"/docs/sdks/reverywhere-web-sdk","title":"RevEverywhere Web SDK","use":"$3","root":true,"items":[{"id":"/docs/sdks/reverywhere-web-sdk/introduction-and-setup","title":"Introduction and setup","to":"/docs/sdks/reverywhere-web-sdk/introduction-and-setup","use":"$3"}]},{"id":"/docs/sdks/revolut-id-sdk","title":"(BETA) Revolut ID SDK","use":"$3","root":true,"items":[{"id":"/docs/sdks/revolut-id-sdk/introduction","title":"Introduction","to":"/docs/sdks/revolut-id-sdk/introduction","use":"$3"},{"id":"/docs/sdks/revolut-id-sdk/web","title":"Web","use":"$3","items":[{"id":"/docs/sdks/revolut-id-sdk/web/introduction","title":"Introduction","to":"/docs/sdks/revolut-id-sdk/web/introduction","use":"$3"},{"id":"/docs/sdks/revolut-id-sdk/web/configure-client","title":"Configure client","to":"/docs/sdks/revolut-id-sdk/web/configure-client","use":"$3"},{"id":"/docs/sdks/revolut-id-sdk/web/integrate-sdk","title":"Integrate SDK","use":"$3","items":[{"id":"/docs/sdks/revolut-id-sdk/web/integrate-sdk/java-script","title":"JavaScript","to":"/docs/sdks/revolut-id-sdk/web/integrate-sdk/java-script","use":"$3"},{"id":"/docs/sdks/revolut-id-sdk/web/integrate-sdk/react","title":"React","to":"/docs/sdks/revolut-id-sdk/web/integrate-sdk/react","use":"$3"}]},{"id":"/docs/sdks/revolut-id-sdk/web/code-exchange","title":"Code exchange","to":"/docs/sdks/revolut-id-sdk/web/code-exchange","use":"$3"},{"id":"/docs/sdks/revolut-id-sdk/web/api-reference","title":"API reference","use":"$3","to":"/docs/sdks/revolut-id-sdk/web/api-reference","items":[{"id":"/docs/sdks/revolut-id-sdk/web/api-reference/revolut-id","title":"RevolutId","to":"/docs/sdks/revolut-id-sdk/web/api-reference/revolut-id","use":"$3"},{"id":"/docs/sdks/revolut-id-sdk/web/api-reference/revolutid-loader","title":"RevolutIdLoader","to":"/docs/sdks/revolut-id-sdk/web/api-reference/revolutid-loader","use":"$3"},{"id":"/docs/sdks/revolut-id-sdk/web/api-reference/button-client","title":"ButtonClient","to":"/docs/sdks/revolut-id-sdk/web/api-reference/button-client","use":"$3"},{"id":"/docs/sdks/revolut-id-sdk/web/api-reference/button-style","title":"ButtonStyle","to":"/docs/sdks/revolut-id-sdk/web/api-reference/button-style","use":"$3"},{"id":"/docs/sdks/revolut-id-sdk/web/api-reference/openid-configuration","title":"OIDC Configuration","to":"/docs/sdks/revolut-id-sdk/web/api-reference/openid-configuration","use":"$3"}]}]},{"id":"/docs/sdks/revolut-id-sdk/ios","title":"iOS","use":"$3","items":[{"id":"/docs/sdks/revolut-id-sdk/ios/introduction","title":"Introduction","to":"/docs/sdks/revolut-id-sdk/ios/introduction","use":"$3"},{"id":"/docs/sdks/revolut-id-sdk/ios/integration-guide","title":"Integration guide","to":"/docs/sdks/revolut-id-sdk/ios/integration-guide","use":"$3"},{"id":"/docs/sdks/revolut-id-sdk/ios/code-exchange","title":"Code exchange","to":"/docs/sdks/revolut-id-sdk/ios/code-exchange","use":"$3"},{"id":"/docs/sdks/revolut-id-sdk/ios/api-reference","title":"Methods and parameters","use":"$3","to":"/docs/sdks/revolut-id-sdk/ios/api-reference","items":[]}]},{"id":"/docs/sdks/revolut-id-sdk/android","title":"Android","use":"$3","items":[{"id":"/docs/sdks/revolut-id-sdk/android/introduction","title":"Introduction","to":"/docs/sdks/revolut-id-sdk/android/introduction","use":"$3"},{"id":"/docs/sdks/revolut-id-sdk/android/integration-guide","title":"Integration guide","to":"/docs/sdks/revolut-id-sdk/android/integration-guide","use":"$3"},{"id":"/docs/sdks/revolut-id-sdk/android/code-exchange","title":"Code exchange","to":"/docs/sdks/revolut-id-sdk/android/code-exchange","use":"$3"},{"id":"/docs/sdks/revolut-id-sdk/android/methods-parameters","title":"Methods and parameters","to":"/docs/sdks/revolut-id-sdk/android/methods-parameters","use":"$3"}]}]},{"id":"/docs/sdks/ui-kit-miniapp-web-sdk","title":"UI Kit MiniApp Web SDK","use":"$3","root":true,"items":[{"id":"/docs/sdks/ui-kit-miniapp-web-sdk/introduction","title":"Introduction","to":"/docs/sdks/ui-kit-miniapp-web-sdk/introduction","use":"$3"},{"id":"/docs/sdks/ui-kit-miniapp-web-sdk/components","title":"Components","use":"$3","items":[{"id":"/docs/sdks/ui-kit-miniapp-web-sdk/components/Action","title":"Action","to":"/docs/sdks/ui-kit-miniapp-web-sdk/components/Action","use":"$3"},{"id":"/docs/sdks/ui-kit-miniapp-web-sdk/components/ActionButton","title":"ActionButton","to":"/docs/sdks/ui-kit-miniapp-web-sdk/components/ActionButton","use":"$3"},{"id":"/docs/sdks/ui-kit-miniapp-web-sdk/components/Avatar","title":"Avatar","to":"/docs/sdks/ui-kit-miniapp-web-sdk/components/Avatar","use":"$3"},{"id":"/docs/sdks/ui-kit-miniapp-web-sdk/components/Badge","title":"Badge","to":"/docs/sdks/ui-kit-miniapp-web-sdk/components/Badge","use":"$3"},{"id":"/docs/sdks/ui-kit-miniapp-web-sdk/components/BottomSheet","title":"BottomSheet","to":"/docs/sdks/ui-kit-miniapp-web-sdk/components/BottomSheet","use":"$3"},{"id":"/docs/sdks/ui-kit-miniapp-web-sdk/components/Button","title":"Button","to":"/docs/sdks/ui-kit-miniapp-web-sdk/components/Button","use":"$3"},{"id":"/docs/sdks/ui-kit-miniapp-web-sdk/components/Calendar","title":"Calendar","to":"/docs/sdks/ui-kit-miniapp-web-sdk/components/Calendar","use":"$3"},{"id":"/docs/sdks/ui-kit-miniapp-web-sdk/components/Cell","title":"Cell","to":"/docs/sdks/ui-kit-miniapp-web-sdk/components/Cell","use":"$3"},{"id":"/docs/sdks/ui-kit-miniapp-web-sdk/components/CellSkeleton","title":"CellSkeleton","to":"/docs/sdks/ui-kit-miniapp-web-sdk/components/CellSkeleton","use":"$3"},{"id":"/docs/sdks/ui-kit-miniapp-web-sdk/components/Checkbox","title":"Checkbox","to":"/docs/sdks/ui-kit-miniapp-web-sdk/components/Checkbox","use":"$3"},{"id":"/docs/sdks/ui-kit-miniapp-web-sdk/components/CompactInput","title":"CompactInput","to":"/docs/sdks/ui-kit-miniapp-web-sdk/components/CompactInput","use":"$3"},{"id":"/docs/sdks/ui-kit-miniapp-web-sdk/components/Copyable","title":"Copyable","to":"/docs/sdks/ui-kit-miniapp-web-sdk/components/Copyable","use":"$3"},{"id":"/docs/sdks/ui-kit-miniapp-web-sdk/components/DetailsCell","title":"DetailsCell","to":"/docs/sdks/ui-kit-miniapp-web-sdk/components/DetailsCell","use":"$3"},{"id":"/docs/sdks/ui-kit-miniapp-web-sdk/components/Dropdown","title":"Dropdown","to":"/docs/sdks/ui-kit-miniapp-web-sdk/components/Dropdown","use":"$3"},{"id":"/docs/sdks/ui-kit-miniapp-web-sdk/components/FilterButton","title":"FilterButton","to":"/docs/sdks/ui-kit-miniapp-web-sdk/components/FilterButton","use":"$3"},{"id":"/docs/sdks/ui-kit-miniapp-web-sdk/components/Footnote","title":"Footnote","to":"/docs/sdks/ui-kit-miniapp-web-sdk/components/Footnote","use":"$3"},{"id":"/docs/sdks/ui-kit-miniapp-web-sdk/components/Group","title":"Group","to":"/docs/sdks/ui-kit-miniapp-web-sdk/components/Group","use":"$3"},{"id":"/docs/sdks/ui-kit-miniapp-web-sdk/components/HStack","title":"HStack","to":"/docs/sdks/ui-kit-miniapp-web-sdk/components/HStack","use":"$3"},{"id":"/docs/sdks/ui-kit-miniapp-web-sdk/components/Icon","title":"Icon","to":"/docs/sdks/ui-kit-miniapp-web-sdk/components/Icon","use":"$3"},{"id":"/docs/sdks/ui-kit-miniapp-web-sdk/components/Image","title":"Image","to":"/docs/sdks/ui-kit-miniapp-web-sdk/components/Image","use":"$3"},{"id":"/docs/sdks/ui-kit-miniapp-web-sdk/components/Input","title":"Input","to":"/docs/sdks/ui-kit-miniapp-web-sdk/components/Input","use":"$3"},{"id":"/docs/sdks/ui-kit-miniapp-web-sdk/components/Link","title":"Link","to":"/docs/sdks/ui-kit-miniapp-web-sdk/components/Link","use":"$3"},{"id":"/docs/sdks/ui-kit-miniapp-web-sdk/components/List","title":"List","to":"/docs/sdks/ui-kit-miniapp-web-sdk/components/List","use":"$3"},{"id":"/docs/sdks/ui-kit-miniapp-web-sdk/components/MessageBubble","title":"MessageBubble","to":"/docs/sdks/ui-kit-miniapp-web-sdk/components/MessageBubble","use":"$3"},{"id":"/docs/sdks/ui-kit-miniapp-web-sdk/components/Page","title":"Page","to":"/docs/sdks/ui-kit-miniapp-web-sdk/components/Page","use":"$3"},{"id":"/docs/sdks/ui-kit-miniapp-web-sdk/components/Placeholder","title":"Placeholder","to":"/docs/sdks/ui-kit-miniapp-web-sdk/components/Placeholder","use":"$3"},{"id":"/docs/sdks/ui-kit-miniapp-web-sdk/components/Popup","title":"Popup","to":"/docs/sdks/ui-kit-miniapp-web-sdk/components/Popup","use":"$3"},{"id":"/docs/sdks/ui-kit-miniapp-web-sdk/components/ProgressSteps","title":"ProgressSteps","to":"/docs/sdks/ui-kit-miniapp-web-sdk/components/ProgressSteps","use":"$3"},{"id":"/docs/sdks/ui-kit-miniapp-web-sdk/components/Radio","title":"Radio","to":"/docs/sdks/ui-kit-miniapp-web-sdk/components/Radio","use":"$3"},{"id":"/docs/sdks/ui-kit-miniapp-web-sdk/components/RootProvider","title":"RootProvider","to":"/docs/sdks/ui-kit-miniapp-web-sdk/components/RootProvider","use":"$3"},{"id":"/docs/sdks/ui-kit-miniapp-web-sdk/components/Search","title":"Search","to":"/docs/sdks/ui-kit-miniapp-web-sdk/components/Search","use":"$3"},{"id":"/docs/sdks/ui-kit-miniapp-web-sdk/components/Spacer","title":"Spacer","to":"/docs/sdks/ui-kit-miniapp-web-sdk/components/Spacer","use":"$3"},{"id":"/docs/sdks/ui-kit-miniapp-web-sdk/components/Subheader","title":"Subheader","to":"/docs/sdks/ui-kit-miniapp-web-sdk/components/Subheader","use":"$3"},{"id":"/docs/sdks/ui-kit-miniapp-web-sdk/components/Switch","title":"Switch","to":"/docs/sdks/ui-kit-miniapp-web-sdk/components/Switch","use":"$3"},{"id":"/docs/sdks/ui-kit-miniapp-web-sdk/components/TabBar","title":"TabBar","to":"/docs/sdks/ui-kit-miniapp-web-sdk/components/TabBar","use":"$3"},{"id":"/docs/sdks/ui-kit-miniapp-web-sdk/components/Text","title":"Text","to":"/docs/sdks/ui-kit-miniapp-web-sdk/components/Text","use":"$3"},{"id":"/docs/sdks/ui-kit-miniapp-web-sdk/components/TextArea","title":"TextArea","to":"/docs/sdks/ui-kit-miniapp-web-sdk/components/TextArea","use":"$3"},{"id":"/docs/sdks/ui-kit-miniapp-web-sdk/components/ToggleButton","title":"ToggleButton","to":"/docs/sdks/ui-kit-miniapp-web-sdk/components/ToggleButton","use":"$3"},{"id":"/docs/sdks/ui-kit-miniapp-web-sdk/components/Toast","title":"Toast","to":"/docs/sdks/ui-kit-miniapp-web-sdk/components/Toast","use":"$3"},{"id":"/docs/sdks/ui-kit-miniapp-web-sdk/components/VStack","title":"VStack","to":"/docs/sdks/ui-kit-miniapp-web-sdk/components/VStack","use":"$3"},{"id":"/docs/sdks/ui-kit-miniapp-web-sdk/components/VisuallyHidden","title":"VisuallyHidden","to":"/docs/sdks/ui-kit-miniapp-web-sdk/components/VisuallyHidden","use":"$3"}]},{"id":"/docs/sdks/ui-kit-miniapp-web-sdk/hooks","title":"Hooks","use":"$3","items":[{"id":"/docs/sdks/ui-kit-miniapp-web-sdk/hooks/useStatusSheet","title":"useStatusSheet","to":"/docs/sdks/ui-kit-miniapp-web-sdk/hooks/useStatusSheet","use":"$3"},{"id":"/docs/sdks/ui-kit-miniapp-web-sdk/hooks/useToast","title":"useToast","to":"/docs/sdks/ui-kit-miniapp-web-sdk/hooks/useToast","use":"$3"}]},{"id":"/docs/sdks/ui-kit-miniapp-web-sdk/constants","title":"Constants","use":"$3","items":[{"id":"/docs/sdks/ui-kit-miniapp-web-sdk/constants/token","title":"Token","to":"/docs/sdks/ui-kit-miniapp-web-sdk/constants/token","use":"$3"}]},{"id":"/docs/sdks/ui-kit-miniapp-web-sdk/types","title":"Types","use":"$3","to":"/docs/sdks/ui-kit-miniapp-web-sdk/types","items":[{"id":"/docs/sdks/ui-kit-miniapp-web-sdk/types/HTMLTag","title":"HTMLTag","to":"/docs/sdks/ui-kit-miniapp-web-sdk/types/HTMLTag","use":"$3"},{"id":"/docs/sdks/ui-kit-miniapp-web-sdk/types/IconName","title":"IconName","to":"/docs/sdks/ui-kit-miniapp-web-sdk/types/IconName","use":"$3"},{"id":"/docs/sdks/ui-kit-miniapp-web-sdk/types/NativeButtonProps","title":"NativeButtonProps","to":"/docs/sdks/ui-kit-miniapp-web-sdk/types/NativeButtonProps","use":"$3"},{"id":"/docs/sdks/ui-kit-miniapp-web-sdk/types/NativeDivProps","title":"NativeDivProps","to":"/docs/sdks/ui-kit-miniapp-web-sdk/types/NativeDivProps","use":"$3"},{"id":"/docs/sdks/ui-kit-miniapp-web-sdk/types/NativeHeadingProps","title":"NativeHeadingProps","to":"/docs/sdks/ui-kit-miniapp-web-sdk/types/NativeHeadingProps","use":"$3"},{"id":"/docs/sdks/ui-kit-miniapp-web-sdk/types/NativeMainProps","title":"NativeMainProps","to":"/docs/sdks/ui-kit-miniapp-web-sdk/types/NativeMainProps","use":"$3"},{"id":"/docs/sdks/ui-kit-miniapp-web-sdk/types/NativeSpanProps","title":"NativeSpanProps","to":"/docs/sdks/ui-kit-miniapp-web-sdk/types/NativeSpanProps","use":"$3"}]}]}],"blog":[{"id":"/blog/2026-07-14-tap-to-pay-sdk","title":"New: Tap to Pay SDK for iOS","use":"$3","to":"/blog/2026-07-14-tap-to-pay-sdk"},{"id":"/blog/2026-07-06-revolut-checkout-hide-customer-details","title":"Revolut Checkout: hide customer details with pre-fill","use":"$3","to":"/blog/2026-07-06-revolut-checkout-hide-customer-details"},{"id":"/blog/2026-06-02-react-native-merchant-sdks","title":"New: Revolut Pay and Card Form SDKs for React Native","use":"$3","to":"/blog/2026-06-02-react-native-merchant-sdks"},{"id":"/blog/2026-05-28-incremental-authorisation-sandbox","title":"Incremental Authorisation: Sandbox testing now available","use":"$3","to":"/blog/2026-05-28-incremental-authorisation-sandbox"},{"id":"/blog/2026-05-06-revolut-checkout-sdk-reference","title":"Revolut Checkout: full SDK reference and shipping options now documented","use":"$3","to":"/blog/2026-05-06-revolut-checkout-sdk-reference"},{"id":"/blog/2026-04-22-merchant-api-version-2026-04-20","title":"New Merchant API version: 2026-04-20","use":"$3","to":"/blog/2026-04-22-merchant-api-version-2026-04-20"},{"id":"/blog/2026-03-14-billing-address-card-payments","title":"Billing address is now required for card payments in the Web SDK","use":"$3","to":"/blog/2026-03-14-billing-address-card-payments"},{"id":"/blog/2026-03-01-hosted-checkout-page","title":"Merchant API: Hosted Checkout Page documentation restructuring","use":"$3","to":"/blog/2026-03-01-hosted-checkout-page"},{"id":"/blog/2026-02-05-incremental-authorisation","title":"New: Incremental Authorisation for card payments","use":"$3","to":"/blog/2026-02-05-incremental-authorisation"},{"id":"/blog/2026-02-01-revolut-checkout","title":"Release announcement: Revolut Checkout","use":"$3","to":"/blog/2026-02-01-revolut-checkout"},{"id":"/blog/2025-12-15-open-banking-minor-updates","title":"Open Banking API: Updates to OpenID config file, account subtype, and DCR scopes","use":"$3","to":"/blog/2025-12-15-open-banking-minor-updates"},{"id":"/blog/2025-12-01-push-payments-to-terminal","title":"Merchant API: Push payments to Revolut Terminal","use":"$3","to":"/blog/2025-12-01-push-payments-to-terminal"},{"id":"/blog/2025-08-15-pay-by-bank-example","title":"New Pay by Bank integration example on GitHub","use":"$3","to":"/blog/2025-08-15-pay-by-bank-example"},{"id":"/blog/2025-07-11-revolut-openapi-github-repository","title":"Revolut APIs: Public API Specs on GitHub","use":"$3","to":"/blog/2025-07-11-revolut-openapi-github-repository"},{"id":"/blog/2025-06-18-new-disputes-endpoints","title":"Merchant API: New Disputes endpoints","use":"$3","to":"/blog/2025-06-18-new-disputes-endpoints"},{"id":"/blog/2025-06-03-apple-pay-unregister","title":"Merchant API: New Apple Pay unregistration endpoint","use":"$3","to":"/blog/2025-06-03-apple-pay-unregister"},{"id":"/blog/2025-05-28-pay-by-bank","title":"Release announcement: Pay by Bank","use":"$3","to":"/blog/2025-05-28-pay-by-bank"},{"id":"/blog/2025-03-19-open-banking-refresh-tokens","title":"Open Banking API Refresh Tokens","use":"$3","to":"/blog/2025-03-19-open-banking-refresh-tokens"},{"id":"/blog/2025-03-04-open-banking-fapi1-advanced","title":"Financial-grade API 1.0 (FAPI 1) Advanced","use":"$3","to":"/blog/2025-03-04-open-banking-fapi1-advanced"},{"id":"/blog/2025-02-03-open-banking-accounts-endpoint","title":"Open Banking API SCA restrictions update","use":"$3","to":"/blog/2025-02-03-open-banking-accounts-endpoint"},{"id":"/blog/2024-09-16-open-banking-ais-restrictions","title":"Restrictions on AIS endpoints","use":"$3","to":"/blog/2024-09-16-open-banking-ais-restrictions"},{"id":"/blog/2024-09-14-open-banking-payment-status","title":"Payment Initiation status update","use":"$3","to":"/blog/2024-09-14-open-banking-payment-status"},{"id":"/blog/2024-08-16-open-banking-migration-of-swiss-users","title":"Migration of Swiss users","use":"$3","to":"/blog/2024-08-16-open-banking-migration-of-swiss-users"}],"openapiByPath":{"/docs/api/business":{"items":[{"id":"/docs/api/business#tag-accounting","title":"Accounting","use":"a","href":"#tag-accounting","items":[{"id":"/docs/api/business#create-accounting-category","title":"Create an accounting category","use":"a","href":"#create-accounting-category","options":{"method":"post"}},{"id":"/docs/api/business#get-accounting-categories","title":"Retrieve a list of accounting categories","use":"a","href":"#get-accounting-categories","options":{"method":"get"}},{"id":"/docs/api/business#get-accounting-category","title":"Retrieve accounting category details","use":"a","href":"#get-accounting-category","options":{"method":"get"}},{"id":"/docs/api/business#update-accounting-category","title":"Update accounting category settings","use":"a","href":"#update-accounting-category","options":{"method":"patch"}},{"id":"/docs/api/business#delete-accounting-category","title":"Delete an accounting category","use":"a","href":"#delete-accounting-category","options":{"method":"delete"}},{"id":"/docs/api/business#create-label-group","title":"Create a new label group","use":"a","href":"#create-label-group","options":{"method":"post"}},{"id":"/docs/api/business#get-label-groups","title":"Retrieve a list of label groups","use":"a","href":"#get-label-groups","options":{"method":"get"}},{"id":"/docs/api/business#get-label-group","title":"Retrieve label group details","use":"a","href":"#get-label-group","options":{"method":"get"}},{"id":"/docs/api/business#update-label-group","title":"Update label group settings","use":"a","href":"#update-label-group","options":{"method":"patch"}},{"id":"/docs/api/business#delete-label-group","title":"Delete a label group","use":"a","href":"#delete-label-group","options":{"method":"delete"}},{"id":"/docs/api/business#create-label","title":"Create a new label","use":"a","href":"#create-label","options":{"method":"post"}},{"id":"/docs/api/business#get-labels","title":"Retrieve a list of labels from a label group","use":"a","href":"#get-labels","options":{"method":"get"}},{"id":"/docs/api/business#update-label","title":"Update a label","use":"a","href":"#update-label","options":{"method":"patch"}},{"id":"/docs/api/business#delete-label","title":"Delete a label","use":"a","href":"#delete-label","options":{"method":"delete"}},{"id":"/docs/api/business#create-tax-rate","title":"Create a new tax rate","use":"a","href":"#create-tax-rate","options":{"method":"post"}},{"id":"/docs/api/business#get-tax-rates","title":"Retrieve a list of tax rates","use":"a","href":"#get-tax-rates","options":{"method":"get"}},{"id":"/docs/api/business#get-tax-rate","title":"Retrieve tax rate details","use":"a","href":"#get-tax-rate","options":{"method":"get"}},{"id":"/docs/api/business#update-tax-rate","title":"Update tax rate settings","use":"a","href":"#update-tax-rate","options":{"method":"patch"}},{"id":"/docs/api/business#delete-tax-rate","title":"Delete a tax rate","use":"a","href":"#delete-tax-rate","options":{"method":"delete"}}]},{"id":"/docs/api/business#tag-accounts","title":"Accounts","use":"a","href":"#tag-accounts","items":[{"id":"/docs/api/business#get-accounts","title":"Retrieve all accounts","use":"a","href":"#get-accounts","options":{"method":"get"}},{"id":"/docs/api/business#get-account","title":"Retrieve an account","use":"a","href":"#get-account","options":{"method":"get"}},{"id":"/docs/api/business#get-account-details","title":"Retrieve account's full bank details","use":"a","href":"#get-account-details","options":{"method":"get"}}]},{"id":"/docs/api/business#tag-cards","title":"Cards","use":"a","href":"#tag-cards","items":[{"id":"/docs/api/business#get-cards","title":"Retrieve a list of cards","use":"a","href":"#get-cards","options":{"method":"get"}},{"id":"/docs/api/business#create-card","title":"Create a card","use":"a","href":"#create-card","options":{"method":"post"}},{"id":"/docs/api/business#get-card","title":"Retrieve card details","use":"a","href":"#get-card","options":{"method":"get"}},{"id":"/docs/api/business#update-card","title":"Update card settings","use":"a","href":"#update-card","options":{"method":"patch"}},{"id":"/docs/api/business#delete-card","title":"Terminate a card","use":"a","href":"#delete-card","options":{"method":"delete"}},{"id":"/docs/api/business#update-card-contacts","title":"Update card contacts","use":"a","href":"#update-card-contacts","options":{"method":"put"}},{"id":"/docs/api/business#update-card-references","title":"Update card references","use":"a","href":"#update-card-references","options":{"method":"put"}},{"id":"/docs/api/business#freeze-card","title":"Freeze a card","use":"a","href":"#freeze-card","options":{"method":"post"}},{"id":"/docs/api/business#unfreeze-card","title":"Unfreeze a card","use":"a","href":"#unfreeze-card","options":{"method":"post"}},{"id":"/docs/api/business#lock-card","title":"Lock a card","use":"a","href":"#lock-card","options":{"method":"post"}},{"id":"/docs/api/business#unlock-card","title":"Unlock a card","use":"a","href":"#unlock-card","options":{"method":"post"}},{"id":"/docs/api/business#get-sensitive-card-details","title":"Retrieve sensitive card details","use":"a","href":"#get-sensitive-card-details","options":{"method":"get"}}]},{"id":"/docs/api/business#tag-card-invitations","title":"Card invitations","use":"a","href":"#tag-card-invitations","items":[{"id":"/docs/api/business#create-card-invitation","title":"Create a card invitation","use":"a","href":"#create-card-invitation","options":{"method":"post"}},{"id":"/docs/api/business#get-card-invitations","title":"Retrieve a list of card invitations","use":"a","href":"#get-card-invitations","options":{"method":"get"}},{"id":"/docs/api/business#get-card-invitation","title":"Retrieve card invitation details","use":"a","href":"#get-card-invitation","options":{"method":"get"}},{"id":"/docs/api/business#update-card-invitation","title":"Update card invitation settings","use":"a","href":"#update-card-invitation","options":{"method":"patch"}},{"id":"/docs/api/business#cancel-card-invitation","title":"Cancel a card invitation","use":"a","href":"#cancel-card-invitation","options":{"method":"post"}}]},{"id":"/docs/api/business#tag-counterparties","title":"Counterparties","use":"a","href":"#tag-counterparties","items":[{"id":"/docs/api/business#validate-account-name","title":"Validate an account name (CoP/VoP)","use":"a","href":"#validate-account-name","options":{"method":"post"}},{"id":"/docs/api/business#get-counterparties","title":"Retrieve a list of counterparties","use":"a","href":"#get-counterparties","options":{"method":"get"}},{"id":"/docs/api/business#add-counterparty","title":"Create a counterparty","use":"a","href":"#add-counterparty","options":{"method":"post"}},{"id":"/docs/api/business#get-counterparty-countries","title":"Check supported countries and currencies","use":"a","href":"#get-counterparty-countries","options":{"method":"get"}},{"id":"/docs/api/business#get-counterparty-requirements","title":"Check counterparty field requirements","use":"a","href":"#get-counterparty-requirements","options":{"method":"get"}},{"id":"/docs/api/business#get-counterparty","title":"Retrieve a counterparty","use":"a","href":"#get-counterparty","options":{"method":"get"}},{"id":"/docs/api/business#delete-counterparty","title":"Delete a counterparty","use":"a","href":"#delete-counterparty","options":{"method":"delete"}},{"id":"/docs/api/business#update-counterparty-payment-method","title":"Update a counterparty's payment method","use":"a","href":"#update-counterparty-payment-method","options":{"method":"patch"}}]},{"id":"/docs/api/business#tag-expenses","title":"Expenses","use":"a","href":"#tag-expenses","items":[{"id":"/docs/api/business#get-expenses","title":"Retrieve a list of expenses","use":"a","href":"#get-expenses","options":{"method":"get"}},{"id":"/docs/api/business#get-expense","title":"Retrieve an expense","use":"a","href":"#get-expense","options":{"method":"get"}},{"id":"/docs/api/business#get-expense-receipt","title":"Retrieve a receipt related to an expense","use":"a","href":"#get-expense-receipt","options":{"method":"get"}}]},{"id":"/docs/api/business#tag-foreign-exchange","title":"Foreign exchange","use":"a","href":"#tag-foreign-exchange","items":[{"id":"/docs/api/business#get-rate","title":"Get an exchange rate","use":"a","href":"#get-rate","options":{"method":"get"}},{"id":"/docs/api/business#exchange-money","title":"Exchange money","use":"a","href":"#exchange-money","options":{"method":"post"}},{"id":"/docs/api/business#get-exchange-reasons","title":"Get exchange reasons","use":"a","href":"#get-exchange-reasons","options":{"method":"get"}}]},{"id":"/docs/api/business#tag-payment-drafts","title":"Payment drafts","use":"a","href":"#tag-payment-drafts","items":[{"id":"/docs/api/business#get-payment-drafts","title":"Retrieve a list of payment drafts","use":"a","href":"#get-payment-drafts","options":{"method":"get"}},{"id":"/docs/api/business#create-payment-draft","title":"Create a payment draft","use":"a","href":"#create-payment-draft","options":{"method":"post"}},{"id":"/docs/api/business#get-payment-draft","title":"Retrieve a payment draft","use":"a","href":"#get-payment-draft","options":{"method":"get"}},{"id":"/docs/api/business#delete-payment-draft","title":"Delete a payment draft","use":"a","href":"#delete-payment-draft","options":{"method":"delete"}},{"id":"/docs/api/business#update-payment-draft","title":"Update a payment draft","use":"a","href":"#update-payment-draft","options":{"method":"patch"}},{"id":"/docs/api/business#add-payment-draft-payment","title":"Add a payment to a payment draft","use":"a","href":"#add-payment-draft-payment","options":{"method":"post"}},{"id":"/docs/api/business#update-payment-draft-payment","title":"Update a payment in a payment draft","use":"a","href":"#update-payment-draft-payment","options":{"method":"patch"}},{"id":"/docs/api/business#delete-payment-draft-payment","title":"Delete a payment from a payment draft","use":"a","href":"#delete-payment-draft-payment","options":{"method":"delete"}}]},{"id":"/docs/api/business#tag-payout-links","title":"Payout links","use":"a","href":"#tag-payout-links","items":[{"id":"/docs/api/business#create-payout-link","title":"Create a payout link","use":"a","href":"#create-payout-link","options":{"method":"post"}},{"id":"/docs/api/business#get-payout-links","title":"Retrieve a list of payout links","use":"a","href":"#get-payout-links","options":{"method":"get"}},{"id":"/docs/api/business#get-payout-link","title":"Retrieve a payout link","use":"a","href":"#get-payout-link","options":{"method":"get"}},{"id":"/docs/api/business#cancel-payout-link","title":"Cancel a payout link","use":"a","href":"#cancel-payout-link","options":{"method":"post"}}]},{"id":"/docs/api/business#tag-simulations","title":"Simulations","use":"a","href":"#tag-simulations","items":[{"id":"/docs/api/business#simulate-transfer-state-update","title":"Simulate a transfer state update (Sandbox only)","use":"a","href":"#simulate-transfer-state-update","options":{"method":"post"}},{"id":"/docs/api/business#simulate-top-up","title":"Simulate an account top-up (Sandbox only)","use":"a","href":"#simulate-top-up","options":{"method":"post"}}]},{"id":"/docs/api/business#tag-team-members","title":"Team members","use":"a","href":"#tag-team-members","items":[{"id":"/docs/api/business#get-team-members","title":"Retrieve a list of team members","use":"a","href":"#get-team-members","options":{"method":"get"}},{"id":"/docs/api/business#invite-team-member","title":"Invite a new member to your business","use":"a","href":"#invite-team-member","options":{"method":"post"}},{"id":"/docs/api/business#delete-team-member","title":"Delete a team member","use":"a","href":"#delete-team-member","options":{"method":"delete"}},{"id":"/docs/api/business#get-roles","title":"Retrieve team roles","use":"a","href":"#get-roles","options":{"method":"get"}}]},{"id":"/docs/api/business#tag-transactions","title":"Transactions","use":"a","href":"#tag-transactions","items":[{"id":"/docs/api/business#get-transactions","title":"Retrieve a list of transactions","use":"a","href":"#get-transactions","options":{"method":"get"}},{"id":"/docs/api/business#get-transaction","title":"Retrieve a transaction","use":"a","href":"#get-transaction","options":{"method":"get"}}]},{"id":"/docs/api/business#tag-transfers","title":"Transfers","use":"a","href":"#tag-transfers","items":[{"id":"/docs/api/business#create-payment","title":"Create a transfer to another account or card","use":"a","href":"#create-payment","options":{"method":"post"}},{"id":"/docs/api/business#get-indicative-quote","title":"Get an indicative quote for a transfer","use":"a","href":"#get-indicative-quote","options":{"method":"post"}},{"id":"/docs/api/business#get-payment-requirements","title":"Check transfer field requirements","use":"a","href":"#get-payment-requirements","options":{"method":"post"}},{"id":"/docs/api/business#create-transfer","title":"Move money between your accounts","use":"a","href":"#create-transfer","options":{"method":"post"}},{"id":"/docs/api/business#get-transfer-reasons","title":"Get transfer reasons","use":"a","href":"#get-transfer-reasons","options":{"method":"get"}}]},{"id":"/docs/api/business#tag-webhooks-v1-deprecated","title":"Webhooks (v1) (deprecated)","use":"a","href":"#tag-webhooks-v1-deprecated","items":[{"id":"/docs/api/business#get-webhook-v1","title":"Retrieve a webhook","use":"a","href":"#get-webhook-v1","options":{"method":"get"}},{"id":"/docs/api/business#set-up-webhook","title":"Set a webhook","use":"a","href":"#set-up-webhook","options":{"method":"post"}},{"id":"/docs/api/business#delete-webhook-v1","title":"Delete a webhook","use":"a","href":"#delete-webhook-v1","options":{"method":"delete"}}]},{"id":"/docs/api/business#tag-webhooks-v2","title":"Webhooks (v2)","use":"a","href":"#tag-webhooks-v2","items":[{"id":"/docs/api/business#create-webhook","title":"Create a new webhook","use":"a","href":"#create-webhook","options":{"method":"post"}},{"id":"/docs/api/business#get-webhooks","title":"Retrieve a list of webhooks","use":"a","href":"#get-webhooks","options":{"method":"get"}},{"id":"/docs/api/business#get-webhook","title":"Retrieve a webhook","use":"a","href":"#get-webhook","options":{"method":"get"}},{"id":"/docs/api/business#update-webhook","title":"Update a webhook","use":"a","href":"#update-webhook","options":{"method":"patch"}},{"id":"/docs/api/business#delete-webhook","title":"Delete a webhook","use":"a","href":"#delete-webhook","options":{"method":"delete"}},{"id":"/docs/api/business#rotate-webhook-signing-secret","title":"Rotate a webhook signing secret","use":"a","href":"#rotate-webhook-signing-secret","options":{"method":"post"}},{"id":"/docs/api/business#get-failed-webhook-events","title":"Retrieve a list of failed webhook events","use":"a","href":"#get-failed-webhook-events","options":{"method":"get"}}]}],"versions":"$undefined"},"/docs/api/crypto-ramp/2.0.0":{"items":[{"id":"/docs/api/crypto-ramp/2.0.0#tag-partners","title":"Partners","use":"a","href":"#tag-partners","items":[{"id":"/docs/api/crypto-ramp/2.0.0#retrieve-configuration","title":"Retrieve configuration","use":"a","href":"#retrieve-configuration","options":{"method":"get"}},{"id":"/docs/api/crypto-ramp/2.0.0#retrieve-an-order-quote","title":"Retrieve an order quote","use":"a","href":"#retrieve-an-order-quote","options":{"method":"get"}},{"id":"/docs/api/crypto-ramp/2.0.0#retrieve-a-redirect-url","title":"Retrieve a redirect URL","use":"a","href":"#retrieve-a-redirect-url","options":{"method":"get"}},{"id":"/docs/api/crypto-ramp/2.0.0#retrieve-an-order","title":"Retrieve an order","use":"a","href":"#retrieve-an-order","options":{"method":"get"}},{"id":"/docs/api/crypto-ramp/2.0.0#retrieve-all-orders","title":"Retrieve all orders","use":"a","href":"#retrieve-all-orders","options":{"method":"get"}}]},{"id":"/docs/api/crypto-ramp/2.0.0#tag-webhooks","title":"Webhooks","use":"a","href":"#tag-webhooks","items":[{"id":"/docs/api/crypto-ramp/2.0.0#retrieve-a-webhook","title":"Retrieve a webhook","use":"a","href":"#retrieve-a-webhook","options":{"method":"get"}},{"id":"/docs/api/crypto-ramp/2.0.0#update-a-webhook","title":"Update a webhook","use":"a","href":"#update-a-webhook","options":{"method":"patch"}},{"id":"/docs/api/crypto-ramp/2.0.0#delete-a-webhook","title":"Delete a webhook","use":"a","href":"#delete-a-webhook","options":{"method":"delete"}},{"id":"/docs/api/crypto-ramp/2.0.0#retrieve-a-list-of-webhooks","title":"Retrieve a list of webhooks","use":"a","href":"#retrieve-a-list-of-webhooks","options":{"method":"get"}},{"id":"/docs/api/crypto-ramp/2.0.0#create-a-webhook","title":"Create a webhook","use":"a","href":"#create-a-webhook","options":{"method":"post"}}]}],"versions":[{"label":"2.0.0","path":"/docs/api/crypto-ramp","latest":true},{"label":"1.0.0","path":"/docs/api/crypto-ramp/1.0.0","latest":false}]},"/docs/api/crypto-ramp/1.0.0":{"items":[{"id":"/docs/api/crypto-ramp/1.0.0#tag-partners","title":"Partners","use":"a","href":"#tag-partners","items":[{"id":"/docs/api/crypto-ramp/1.0.0#retrieve-configuration","title":"Retrieve configuration","use":"a","href":"#retrieve-configuration","options":{"method":"get"}},{"id":"/docs/api/crypto-ramp/1.0.0#retrieve-an-order-quote","title":"Retrieve an order quote","use":"a","href":"#retrieve-an-order-quote","options":{"method":"get"}},{"id":"/docs/api/crypto-ramp/1.0.0#retrieve-a-redirect-url","title":"Retrieve a redirect URL","use":"a","href":"#retrieve-a-redirect-url","options":{"method":"get"}},{"id":"/docs/api/crypto-ramp/1.0.0#retrieve-an-order","title":"Retrieve an order","use":"a","href":"#retrieve-an-order","options":{"method":"get"}},{"id":"/docs/api/crypto-ramp/1.0.0#retrieve-all-orders","title":"Retrieve all orders","use":"a","href":"#retrieve-all-orders","options":{"method":"get"}}]},{"id":"/docs/api/crypto-ramp/1.0.0#tag-webhooks","title":"Webhooks","use":"a","href":"#tag-webhooks","items":[{"id":"/docs/api/crypto-ramp/1.0.0#retrieve-a-webhook","title":"Retrieve a webhook","use":"a","href":"#retrieve-a-webhook","options":{"method":"get"}},{"id":"/docs/api/crypto-ramp/1.0.0#update-a-webhook","title":"Update a webhook","use":"a","href":"#update-a-webhook","options":{"method":"patch"}},{"id":"/docs/api/crypto-ramp/1.0.0#delete-a-webhook","title":"Delete a webhook","use":"a","href":"#delete-a-webhook","options":{"method":"delete"}},{"id":"/docs/api/crypto-ramp/1.0.0#retrieve-a-list-of-webhooks","title":"Retrieve a list of webhooks","use":"a","href":"#retrieve-a-list-of-webhooks","options":{"method":"get"}},{"id":"/docs/api/crypto-ramp/1.0.0#create-a-webhook","title":"Create a webhook","use":"a","href":"#create-a-webhook","options":{"method":"post"}}]}],"versions":[{"label":"2.0.0","path":"/docs/api/crypto-ramp","latest":true},{"label":"1.0.0","path":"/docs/api/crypto-ramp/1.0.0","latest":false}]},"/docs/api/crypto-ramp":{"items":[{"id":"/docs/api/crypto-ramp#tag-partners","title":"Partners","use":"a","href":"#tag-partners","items":[{"id":"/docs/api/crypto-ramp#retrieve-configuration","title":"Retrieve configuration","use":"a","href":"#retrieve-configuration","options":{"method":"get"}},{"id":"/docs/api/crypto-ramp#retrieve-an-order-quote","title":"Retrieve an order quote","use":"a","href":"#retrieve-an-order-quote","options":{"method":"get"}},{"id":"/docs/api/crypto-ramp#retrieve-a-redirect-url","title":"Retrieve a redirect URL","use":"a","href":"#retrieve-a-redirect-url","options":{"method":"get"}},{"id":"/docs/api/crypto-ramp#retrieve-an-order","title":"Retrieve an order","use":"a","href":"#retrieve-an-order","options":{"method":"get"}},{"id":"/docs/api/crypto-ramp#retrieve-all-orders","title":"Retrieve all orders","use":"a","href":"#retrieve-all-orders","options":{"method":"get"}}]},{"id":"/docs/api/crypto-ramp#tag-webhooks","title":"Webhooks","use":"a","href":"#tag-webhooks","items":[{"id":"/docs/api/crypto-ramp#retrieve-a-webhook","title":"Retrieve a webhook","use":"a","href":"#retrieve-a-webhook","options":{"method":"get"}},{"id":"/docs/api/crypto-ramp#update-a-webhook","title":"Update a webhook","use":"a","href":"#update-a-webhook","options":{"method":"patch"}},{"id":"/docs/api/crypto-ramp#delete-a-webhook","title":"Delete a webhook","use":"a","href":"#delete-a-webhook","options":{"method":"delete"}},{"id":"/docs/api/crypto-ramp#retrieve-a-list-of-webhooks","title":"Retrieve a list of webhooks","use":"a","href":"#retrieve-a-list-of-webhooks","options":{"method":"get"}},{"id":"/docs/api/crypto-ramp#create-a-webhook","title":"Create a webhook","use":"a","href":"#create-a-webhook","options":{"method":"post"}}]}],"versions":[{"label":"2.0.0","path":"/docs/api/crypto-ramp","latest":true},{"label":"1.0.0","path":"/docs/api/crypto-ramp/1.0.0","latest":false}]},"/docs/api/merchant/2026-04-20":{"items":[{"id":"/docs/api/merchant/2026-04-20#tag-orders","title":"Orders","use":"a","href":"#tag-orders","items":[{"id":"/docs/api/merchant/2026-04-20#create-order","title":"Create an order","use":"a","href":"#create-order","options":{"method":"post"}},{"id":"/docs/api/merchant/2026-04-20#retrieve-order-list","title":"Retrieve an order list","use":"a","href":"#retrieve-order-list","options":{"method":"get"}},{"id":"/docs/api/merchant/2026-04-20#retrieve-order","title":"Retrieve an order","use":"a","href":"#retrieve-order","options":{"method":"get"}},{"id":"/docs/api/merchant/2026-04-20#update-order","title":"Update an order","use":"a","href":"#update-order","options":{"method":"patch"}},{"id":"/docs/api/merchant/2026-04-20#increment-authorisation","title":"Increment authorisation","use":"a","href":"#increment-authorisation","options":{"method":"post"}},{"id":"/docs/api/merchant/2026-04-20#capture-order","title":"Capture an order","use":"a","href":"#capture-order","options":{"method":"post"}},{"id":"/docs/api/merchant/2026-04-20#cancel-order","title":"Cancel an order","use":"a","href":"#cancel-order","options":{"method":"post"}},{"id":"/docs/api/merchant/2026-04-20#refund-order","title":"Refund an order","use":"a","href":"#refund-order","options":{"method":"post"}},{"id":"/docs/api/merchant/2026-04-20#pay-order","title":"Pay for an order","use":"a","href":"#pay-order","options":{"method":"post"}},{"id":"/docs/api/merchant/2026-04-20#retrieve-payment-list","title":"Retrieve payment list of an order","use":"a","href":"#retrieve-payment-list","options":{"method":"get"}}]},{"id":"/docs/api/merchant/2026-04-20#tag-customers","title":"Customers","use":"a","href":"#tag-customers","items":[{"id":"/docs/api/merchant/2026-04-20#create-customer","title":"Create a customer","use":"a","href":"#create-customer","options":{"method":"post"}},{"id":"/docs/api/merchant/2026-04-20#retrieve-customer-list","title":"Retrieve a customer list","use":"a","href":"#retrieve-customer-list","options":{"method":"get"}},{"id":"/docs/api/merchant/2026-04-20#retrieve-customer","title":"Retrieve a customer","use":"a","href":"#retrieve-customer","options":{"method":"get"}},{"id":"/docs/api/merchant/2026-04-20#update-customer","title":"Update a customer","use":"a","href":"#update-customer","options":{"method":"patch"}},{"id":"/docs/api/merchant/2026-04-20#delete-customer","title":"Delete a customer","use":"a","href":"#delete-customer","options":{"method":"delete"}},{"id":"/docs/api/merchant/2026-04-20#retrieve-payment-method-list","title":"Retrieve payment method list of a customer","use":"a","href":"#retrieve-payment-method-list","options":{"method":"get"}},{"id":"/docs/api/merchant/2026-04-20#retrieve-payment-method","title":"Retrieve a customer's payment method","use":"a","href":"#retrieve-payment-method","options":{"method":"get"}},{"id":"/docs/api/merchant/2026-04-20#update-payment-method","title":"Update a customer's payment method","use":"a","href":"#update-payment-method","options":{"method":"patch"}},{"id":"/docs/api/merchant/2026-04-20#delete-payment-method","title":"Delete a customer's payment method","use":"a","href":"#delete-payment-method","options":{"method":"delete"}}]},{"id":"/docs/api/merchant/2026-04-20#tag-payments","title":"Payments","use":"a","href":"#tag-payments","items":[{"id":"/docs/api/merchant/2026-04-20#retrieve-payment-details","title":"Retrieve payment details","use":"a","href":"#retrieve-payment-details","options":{"method":"get"}}]},{"id":"/docs/api/merchant/2026-04-20#tag-subscriptions","title":"Subscriptions","use":"a","href":"#tag-subscriptions","items":[{"id":"/docs/api/merchant/2026-04-20#create-subscription-plan","title":"Create a subscription plan","use":"a","href":"#create-subscription-plan","options":{"method":"post"}},{"id":"/docs/api/merchant/2026-04-20#retrieve-subscription-plan-list","title":"Retrieve a subscription plan list","use":"a","href":"#retrieve-subscription-plan-list","options":{"method":"get"}},{"id":"/docs/api/merchant/2026-04-20#retrieve-subscription-plan","title":"Retrieve a subscription plan","use":"a","href":"#retrieve-subscription-plan","options":{"method":"get"}},{"id":"/docs/api/merchant/2026-04-20#create-subscription","title":"Create a subscription","use":"a","href":"#create-subscription","options":{"method":"post"}},{"id":"/docs/api/merchant/2026-04-20#retrieve-subscription-list","title":"Retrieve a subscription list","use":"a","href":"#retrieve-subscription-list","options":{"method":"get"}},{"id":"/docs/api/merchant/2026-04-20#retrieve-subscription","title":"Retrieve a subscription","use":"a","href":"#retrieve-subscription","options":{"method":"get"}},{"id":"/docs/api/merchant/2026-04-20#update-subscription","title":"Update a subscription","use":"a","href":"#update-subscription","options":{"method":"patch"}},{"id":"/docs/api/merchant/2026-04-20#change-subscription-plan","title":"Change a subscription plan","use":"a","href":"#change-subscription-plan","options":{"method":"post"}},{"id":"/docs/api/merchant/2026-04-20#update-subscription-renewal-date","title":"Update a subscription renewal date","use":"a","href":"#update-subscription-renewal-date","options":{"method":"post"}},{"id":"/docs/api/merchant/2026-04-20#cancel-subscription","title":"Cancel a subscription","use":"a","href":"#cancel-subscription","options":{"method":"post"}},{"id":"/docs/api/merchant/2026-04-20#retrieve-subscription-cycle-list","title":"Retrieve a subscription cycle list","use":"a","href":"#retrieve-subscription-cycle-list","options":{"method":"get"}},{"id":"/docs/api/merchant/2026-04-20#retrieve-subscription-cycle","title":"Retrieve a subscription cycle","use":"a","href":"#retrieve-subscription-cycle","options":{"method":"get"}},{"id":"/docs/api/merchant/2026-04-20#create-subscription-usage","title":"Create a subscription usage","use":"a","href":"#create-subscription-usage","options":{"method":"post"}},{"id":"/docs/api/merchant/2026-04-20#retrieve-subscription-usage-list","title":"Retrieve a subscription usage list","use":"a","href":"#retrieve-subscription-usage-list","options":{"method":"get"}},{"id":"/docs/api/merchant/2026-04-20#retrieve-subscription-usage","title":"Retrieve a subscription usage","use":"a","href":"#retrieve-subscription-usage","options":{"method":"get"}},{"id":"/docs/api/merchant/2026-04-20#update-subscription-usage","title":"Update a subscription usage","use":"a","href":"#update-subscription-usage","options":{"method":"patch"}},{"id":"/docs/api/merchant/2026-04-20#delete-subscription-usage","title":"Delete a subscription usage","use":"a","href":"#delete-subscription-usage","options":{"method":"delete"}}]},{"id":"/docs/api/merchant/2026-04-20#tag-payouts","title":"Payouts","use":"a","href":"#tag-payouts","items":[{"id":"/docs/api/merchant/2026-04-20#retrieve-payout-list","title":"Retrieve a payout list","use":"a","href":"#retrieve-payout-list","options":{"method":"get"}},{"id":"/docs/api/merchant/2026-04-20#retrieve-payout","title":"Retrieve a payout","use":"a","href":"#retrieve-payout","options":{"method":"get"}}]},{"id":"/docs/api/merchant/2026-04-20#tag-disputes","title":"Disputes","use":"a","href":"#tag-disputes","items":[{"id":"/docs/api/merchant/2026-04-20#retrieve-dispute-list","title":"Retrieve a dispute list","use":"a","href":"#retrieve-dispute-list","options":{"method":"get"}},{"id":"/docs/api/merchant/2026-04-20#retrieve-dispute","title":"Retrieve a dispute","use":"a","href":"#retrieve-dispute","options":{"method":"get"}},{"id":"/docs/api/merchant/2026-04-20#accept-dispute","title":"Accept a dispute","use":"a","href":"#accept-dispute","options":{"method":"post"}},{"id":"/docs/api/merchant/2026-04-20#upload-dispute-evidence","title":"Upload evidence for a dispute","use":"a","href":"#upload-dispute-evidence","options":{"method":"post"}},{"id":"/docs/api/merchant/2026-04-20#challenge-dispute","title":"Challenge a dispute","use":"a","href":"#challenge-dispute","options":{"method":"post"}}]},{"id":"/docs/api/merchant/2026-04-20#tag-report-runs","title":"Report runs","use":"a","href":"#tag-report-runs","items":[{"id":"/docs/api/merchant/2026-04-20#create-report-run","title":"Create a report run","use":"a","href":"#create-report-run","options":{"method":"post"}},{"id":"/docs/api/merchant/2026-04-20#retrieve-report-run","title":"Retrieve a report run","use":"a","href":"#retrieve-report-run","options":{"method":"get"}},{"id":"/docs/api/merchant/2026-04-20#download-report-file","title":"Download report file","use":"a","href":"#download-report-file","options":{"method":"get"}}]},{"id":"/docs/api/merchant/2026-04-20#tag-webhooks","title":"Webhooks","use":"a","href":"#tag-webhooks","items":[{"id":"/docs/api/merchant/2026-04-20#create-webhook","title":"Create a webhook","use":"a","href":"#create-webhook","options":{"method":"post"}},{"id":"/docs/api/merchant/2026-04-20#retrieve-webhook-list","title":"Retrieve a webhook list","use":"a","href":"#retrieve-webhook-list","options":{"method":"get"}},{"id":"/docs/api/merchant/2026-04-20#retrieve-webhook","title":"Retrieve a webhook","use":"a","href":"#retrieve-webhook","options":{"method":"get"}},{"id":"/docs/api/merchant/2026-04-20#update-webhook","title":"Update a webhook","use":"a","href":"#update-webhook","options":{"method":"patch"}},{"id":"/docs/api/merchant/2026-04-20#delete-webhook","title":"Delete a webhook","use":"a","href":"#delete-webhook","options":{"method":"delete"}},{"id":"/docs/api/merchant/2026-04-20#rotate-webhook-signing-secret","title":"Rotate a webhook signing secret","use":"a","href":"#rotate-webhook-signing-secret","options":{"method":"post"}}]},{"id":"/docs/api/merchant/2026-04-20#tag-locations","title":"Locations","use":"a","href":"#tag-locations","items":[{"id":"/docs/api/merchant/2026-04-20#create-location","title":"Create a location","use":"a","href":"#create-location","options":{"method":"post"}},{"id":"/docs/api/merchant/2026-04-20#retrieve-location-list","title":"Retrieve location list","use":"a","href":"#retrieve-location-list","options":{"method":"get"}},{"id":"/docs/api/merchant/2026-04-20#retrieve-location","title":"Retrieve a location","use":"a","href":"#retrieve-location","options":{"method":"get"}},{"id":"/docs/api/merchant/2026-04-20#update-location","title":"Update a location","use":"a","href":"#update-location","options":{"method":"patch"}},{"id":"/docs/api/merchant/2026-04-20#delete-location","title":"Delete a location","use":"a","href":"#delete-location","options":{"method":"delete"}}]},{"id":"/docs/api/merchant/2026-04-20#tag-terminals","title":"Terminals","use":"a","href":"#tag-terminals","items":[{"id":"/docs/api/merchant/2026-04-20#retrieve-terminal-list","title":"Retrieve terminal list","use":"a","href":"#retrieve-terminal-list","options":{"method":"get"}}]},{"id":"/docs/api/merchant/2026-04-20#tag-payment-intents","title":"Payment intents","use":"a","href":"#tag-payment-intents","items":[{"id":"/docs/api/merchant/2026-04-20#create-payment-intent","title":"Create a payment intent","use":"a","href":"#create-payment-intent","options":{"method":"post"}},{"id":"/docs/api/merchant/2026-04-20#retrieve-payment-intent","title":"Retrieve a payment intent","use":"a","href":"#retrieve-payment-intent","options":{"method":"get"}},{"id":"/docs/api/merchant/2026-04-20#cancel-payment-intent","title":"Cancel a payment intent","use":"a","href":"#cancel-payment-intent","options":{"method":"post"}}]},{"id":"/docs/api/merchant/2026-04-20#tag-apple-pay-merchant-registration","title":"Apple Pay merchant registration","use":"a","href":"#tag-apple-pay-merchant-registration","items":[{"id":"/docs/api/merchant/2026-04-20#register-domain-apple-pay","title":"Register domain for Apple Pay","use":"a","href":"#register-domain-apple-pay","options":{"method":"post"}},{"id":"/docs/api/merchant/2026-04-20#unregister-domain-apple-pay","title":"Unregister domain for Apple Pay","use":"a","href":"#unregister-domain-apple-pay","options":{"method":"post"}}]},{"id":"/docs/api/merchant/2026-04-20#tag-other","title":"Other","use":"a","href":"#tag-other","items":[{"id":"/docs/api/merchant/2026-04-20#register-address-validation-endpoint","title":"Register address validation endpoint for Fast checkout","use":"a","href":"#register-address-validation-endpoint","options":{"method":"post"}},{"id":"/docs/api/merchant/2026-04-20#retrieve-synchronous-webhook-list","title":"Retrieve a synchronous webhook list","use":"a","href":"#retrieve-synchronous-webhook-list","options":{"method":"get"}},{"id":"/docs/api/merchant/2026-04-20#delete-synchronous-webhook","title":"Delete a synchronous webhook","use":"a","href":"#delete-synchronous-webhook","options":{"method":"delete"}}]}],"versions":[{"label":"2026-04-20","path":"/docs/api/merchant","latest":true},{"label":"2026-03-12","path":"/docs/api/merchant/2026-03-12","latest":false},{"label":"2025-12-04","path":"/docs/api/merchant/2025-12-04","latest":false},{"label":"2025-10-16","path":"/docs/api/merchant/2025-10-16","latest":false},{"label":"2024-09-01","path":"/docs/api/merchant/2024-09-01","latest":false},{"label":"2024-05-01","path":"/docs/api/merchant/2024-05-01","latest":false},{"label":"2023-09-01","path":"/docs/api/merchant/2023-09-01","latest":false},{"label":"Legacy","path":"/docs/api/merchant/Legacy","latest":false}]},"/docs/api/merchant/2026-03-12":{"items":[{"id":"/docs/api/merchant/2026-03-12#tag-orders","title":"Orders","use":"a","href":"#tag-orders","items":[{"id":"/docs/api/merchant/2026-03-12#create-order","title":"Create an order","use":"a","href":"#create-order","options":{"method":"post"}},{"id":"/docs/api/merchant/2026-03-12#retrieve-order-list","title":"Retrieve an order list","use":"a","href":"#retrieve-order-list","options":{"method":"get"}},{"id":"/docs/api/merchant/2026-03-12#retrieve-order","title":"Retrieve an order","use":"a","href":"#retrieve-order","options":{"method":"get"}},{"id":"/docs/api/merchant/2026-03-12#update-order","title":"Update an order","use":"a","href":"#update-order","options":{"method":"patch"}},{"id":"/docs/api/merchant/2026-03-12#increment-authorisation","title":"Increment authorisation","use":"a","href":"#increment-authorisation","options":{"method":"post"}},{"id":"/docs/api/merchant/2026-03-12#capture-order","title":"Capture an order","use":"a","href":"#capture-order","options":{"method":"post"}},{"id":"/docs/api/merchant/2026-03-12#cancel-order","title":"Cancel an order","use":"a","href":"#cancel-order","options":{"method":"post"}},{"id":"/docs/api/merchant/2026-03-12#refund-order","title":"Refund an order","use":"a","href":"#refund-order","options":{"method":"post"}},{"id":"/docs/api/merchant/2026-03-12#pay-order","title":"Pay for an order","use":"a","href":"#pay-order","options":{"method":"post"}},{"id":"/docs/api/merchant/2026-03-12#retrieve-payment-list","title":"Retrieve payment list of an order","use":"a","href":"#retrieve-payment-list","options":{"method":"get"}}]},{"id":"/docs/api/merchant/2026-03-12#tag-customers","title":"Customers","use":"a","href":"#tag-customers","items":[{"id":"/docs/api/merchant/2026-03-12#create-customer","title":"Create a customer","use":"a","href":"#create-customer","options":{"method":"post"}},{"id":"/docs/api/merchant/2026-03-12#retrieve-customer-list","title":"Retrieve a customer list","use":"a","href":"#retrieve-customer-list","options":{"method":"get"}},{"id":"/docs/api/merchant/2026-03-12#retrieve-customer","title":"Retrieve a customer","use":"a","href":"#retrieve-customer","options":{"method":"get"}},{"id":"/docs/api/merchant/2026-03-12#update-customer","title":"Update a customer","use":"a","href":"#update-customer","options":{"method":"patch"}},{"id":"/docs/api/merchant/2026-03-12#delete-customer","title":"Delete a customer","use":"a","href":"#delete-customer","options":{"method":"delete"}},{"id":"/docs/api/merchant/2026-03-12#retrieve-payment-method-list","title":"Retrieve payment method list of a customer","use":"a","href":"#retrieve-payment-method-list","options":{"method":"get"}},{"id":"/docs/api/merchant/2026-03-12#retrieve-payment-method","title":"Retrieve a customer's payment method","use":"a","href":"#retrieve-payment-method","options":{"method":"get"}},{"id":"/docs/api/merchant/2026-03-12#update-payment-method","title":"Update a customer's payment method","use":"a","href":"#update-payment-method","options":{"method":"patch"}},{"id":"/docs/api/merchant/2026-03-12#delete-payment-method","title":"Delete a customer's payment method","use":"a","href":"#delete-payment-method","options":{"method":"delete"}}]},{"id":"/docs/api/merchant/2026-03-12#tag-payments","title":"Payments","use":"a","href":"#tag-payments","items":[{"id":"/docs/api/merchant/2026-03-12#retrieve-payment-details","title":"Retrieve payment details","use":"a","href":"#retrieve-payment-details","options":{"method":"get"}}]},{"id":"/docs/api/merchant/2026-03-12#tag-subscriptions","title":"Subscriptions","use":"a","href":"#tag-subscriptions","items":[{"id":"/docs/api/merchant/2026-03-12#create-subscription-plan","title":"Create a subscription plan","use":"a","href":"#create-subscription-plan","options":{"method":"post"}},{"id":"/docs/api/merchant/2026-03-12#retrieve-subscription-plan-list","title":"Retrieve a subscription plan list","use":"a","href":"#retrieve-subscription-plan-list","options":{"method":"get"}},{"id":"/docs/api/merchant/2026-03-12#retrieve-subscription-plan","title":"Retrieve a subscription plan","use":"a","href":"#retrieve-subscription-plan","options":{"method":"get"}},{"id":"/docs/api/merchant/2026-03-12#create-subscription","title":"Create a subscription","use":"a","href":"#create-subscription","options":{"method":"post"}},{"id":"/docs/api/merchant/2026-03-12#retrieve-subscription-list","title":"Retrieve a subscription list","use":"a","href":"#retrieve-subscription-list","options":{"method":"get"}},{"id":"/docs/api/merchant/2026-03-12#retrieve-subscription","title":"Retrieve a subscription","use":"a","href":"#retrieve-subscription","options":{"method":"get"}},{"id":"/docs/api/merchant/2026-03-12#update-subscription","title":"Update a subscription","use":"a","href":"#update-subscription","options":{"method":"patch"}},{"id":"/docs/api/merchant/2026-03-12#change-subscription-plan","title":"Change a subscription plan","use":"a","href":"#change-subscription-plan","options":{"method":"post"}},{"id":"/docs/api/merchant/2026-03-12#update-subscription-renewal-date","title":"Update a subscription renewal date","use":"a","href":"#update-subscription-renewal-date","options":{"method":"post"}},{"id":"/docs/api/merchant/2026-03-12#cancel-subscription","title":"Cancel a subscription","use":"a","href":"#cancel-subscription","options":{"method":"post"}},{"id":"/docs/api/merchant/2026-03-12#retrieve-subscription-cycle-list","title":"Retrieve a subscription cycle list","use":"a","href":"#retrieve-subscription-cycle-list","options":{"method":"get"}},{"id":"/docs/api/merchant/2026-03-12#retrieve-subscription-cycle","title":"Retrieve a subscription cycle","use":"a","href":"#retrieve-subscription-cycle","options":{"method":"get"}},{"id":"/docs/api/merchant/2026-03-12#create-subscription-usage","title":"Create a subscription usage","use":"a","href":"#create-subscription-usage","options":{"method":"post"}},{"id":"/docs/api/merchant/2026-03-12#retrieve-subscription-usage-list","title":"Retrieve a subscription usage list","use":"a","href":"#retrieve-subscription-usage-list","options":{"method":"get"}},{"id":"/docs/api/merchant/2026-03-12#retrieve-subscription-usage","title":"Retrieve a subscription usage","use":"a","href":"#retrieve-subscription-usage","options":{"method":"get"}},{"id":"/docs/api/merchant/2026-03-12#update-subscription-usage","title":"Update a subscription usage","use":"a","href":"#update-subscription-usage","options":{"method":"patch"}},{"id":"/docs/api/merchant/2026-03-12#delete-subscription-usage","title":"Delete a subscription usage","use":"a","href":"#delete-subscription-usage","options":{"method":"delete"}}]},{"id":"/docs/api/merchant/2026-03-12#tag-payouts","title":"Payouts","use":"a","href":"#tag-payouts","items":[{"id":"/docs/api/merchant/2026-03-12#retrieve-payout-list","title":"Retrieve a payout list","use":"a","href":"#retrieve-payout-list","options":{"method":"get"}},{"id":"/docs/api/merchant/2026-03-12#retrieve-payout","title":"Retrieve a payout","use":"a","href":"#retrieve-payout","options":{"method":"get"}}]},{"id":"/docs/api/merchant/2026-03-12#tag-disputes","title":"Disputes","use":"a","href":"#tag-disputes","items":[{"id":"/docs/api/merchant/2026-03-12#retrieve-dispute-list","title":"Retrieve a dispute list","use":"a","href":"#retrieve-dispute-list","options":{"method":"get"}},{"id":"/docs/api/merchant/2026-03-12#retrieve-dispute","title":"Retrieve a dispute","use":"a","href":"#retrieve-dispute","options":{"method":"get"}},{"id":"/docs/api/merchant/2026-03-12#accept-dispute","title":"Accept a dispute","use":"a","href":"#accept-dispute","options":{"method":"post"}},{"id":"/docs/api/merchant/2026-03-12#upload-dispute-evidence","title":"Upload evidence for a dispute","use":"a","href":"#upload-dispute-evidence","options":{"method":"post"}},{"id":"/docs/api/merchant/2026-03-12#challenge-dispute","title":"Challenge a dispute","use":"a","href":"#challenge-dispute","options":{"method":"post"}}]},{"id":"/docs/api/merchant/2026-03-12#tag-report-runs","title":"Report runs","use":"a","href":"#tag-report-runs","items":[{"id":"/docs/api/merchant/2026-03-12#create-report-run","title":"Create a report run","use":"a","href":"#create-report-run","options":{"method":"post"}},{"id":"/docs/api/merchant/2026-03-12#retrieve-report-run","title":"Retrieve a report run","use":"a","href":"#retrieve-report-run","options":{"method":"get"}},{"id":"/docs/api/merchant/2026-03-12#download-report-file","title":"Download report file","use":"a","href":"#download-report-file","options":{"method":"get"}}]},{"id":"/docs/api/merchant/2026-03-12#tag-webhooks","title":"Webhooks","use":"a","href":"#tag-webhooks","items":[{"id":"/docs/api/merchant/2026-03-12#create-webhook","title":"Create a webhook","use":"a","href":"#create-webhook","options":{"method":"post"}},{"id":"/docs/api/merchant/2026-03-12#retrieve-webhook-list","title":"Retrieve a webhook list","use":"a","href":"#retrieve-webhook-list","options":{"method":"get"}},{"id":"/docs/api/merchant/2026-03-12#retrieve-webhook","title":"Retrieve a webhook","use":"a","href":"#retrieve-webhook","options":{"method":"get"}},{"id":"/docs/api/merchant/2026-03-12#update-webhook","title":"Update a webhook","use":"a","href":"#update-webhook","options":{"method":"patch"}},{"id":"/docs/api/merchant/2026-03-12#delete-webhook","title":"Delete a webhook","use":"a","href":"#delete-webhook","options":{"method":"delete"}},{"id":"/docs/api/merchant/2026-03-12#rotate-webhook-signing-secret","title":"Rotate a webhook signing secret","use":"a","href":"#rotate-webhook-signing-secret","options":{"method":"post"}}]},{"id":"/docs/api/merchant/2026-03-12#tag-locations","title":"Locations","use":"a","href":"#tag-locations","items":[{"id":"/docs/api/merchant/2026-03-12#create-location","title":"Create a location","use":"a","href":"#create-location","options":{"method":"post"}},{"id":"/docs/api/merchant/2026-03-12#retrieve-location-list","title":"Retrieve location list","use":"a","href":"#retrieve-location-list","options":{"method":"get"}},{"id":"/docs/api/merchant/2026-03-12#retrieve-location","title":"Retrieve a location","use":"a","href":"#retrieve-location","options":{"method":"get"}},{"id":"/docs/api/merchant/2026-03-12#update-location","title":"Update a location","use":"a","href":"#update-location","options":{"method":"patch"}},{"id":"/docs/api/merchant/2026-03-12#delete-location","title":"Delete a location","use":"a","href":"#delete-location","options":{"method":"delete"}}]},{"id":"/docs/api/merchant/2026-03-12#tag-terminals","title":"Terminals","use":"a","href":"#tag-terminals","items":[{"id":"/docs/api/merchant/2026-03-12#retrieve-terminal-list","title":"Retrieve terminal list","use":"a","href":"#retrieve-terminal-list","options":{"method":"get"}}]},{"id":"/docs/api/merchant/2026-03-12#tag-payment-intents","title":"Payment intents","use":"a","href":"#tag-payment-intents","items":[{"id":"/docs/api/merchant/2026-03-12#create-payment-intent","title":"Create a payment intent","use":"a","href":"#create-payment-intent","options":{"method":"post"}},{"id":"/docs/api/merchant/2026-03-12#retrieve-payment-intent","title":"Retrieve a payment intent","use":"a","href":"#retrieve-payment-intent","options":{"method":"get"}},{"id":"/docs/api/merchant/2026-03-12#cancel-payment-intent","title":"Cancel a payment intent","use":"a","href":"#cancel-payment-intent","options":{"method":"post"}}]},{"id":"/docs/api/merchant/2026-03-12#tag-apple-pay-merchant-registration","title":"Apple Pay merchant registration","use":"a","href":"#tag-apple-pay-merchant-registration","items":[{"id":"/docs/api/merchant/2026-03-12#register-domain-apple-pay","title":"Register domain for Apple Pay","use":"a","href":"#register-domain-apple-pay","options":{"method":"post"}},{"id":"/docs/api/merchant/2026-03-12#unregister-domain-apple-pay","title":"Unregister domain for Apple Pay","use":"a","href":"#unregister-domain-apple-pay","options":{"method":"post"}}]},{"id":"/docs/api/merchant/2026-03-12#tag-other","title":"Other","use":"a","href":"#tag-other","items":[{"id":"/docs/api/merchant/2026-03-12#register-address-validation-endpoint","title":"Register address validation endpoint for Fast checkout","use":"a","href":"#register-address-validation-endpoint","options":{"method":"post"}},{"id":"/docs/api/merchant/2026-03-12#retrieve-synchronous-webhook-list","title":"Retrieve a synchronous webhook list","use":"a","href":"#retrieve-synchronous-webhook-list","options":{"method":"get"}},{"id":"/docs/api/merchant/2026-03-12#delete-synchronous-webhook","title":"Delete a synchronous webhook","use":"a","href":"#delete-synchronous-webhook","options":{"method":"delete"}}]}],"versions":[{"label":"2026-04-20","path":"/docs/api/merchant","latest":true},{"label":"2026-03-12","path":"/docs/api/merchant/2026-03-12","latest":false},{"label":"2025-12-04","path":"/docs/api/merchant/2025-12-04","latest":false},{"label":"2025-10-16","path":"/docs/api/merchant/2025-10-16","latest":false},{"label":"2024-09-01","path":"/docs/api/merchant/2024-09-01","latest":false},{"label":"2024-05-01","path":"/docs/api/merchant/2024-05-01","latest":false},{"label":"2023-09-01","path":"/docs/api/merchant/2023-09-01","latest":false},{"label":"Legacy","path":"/docs/api/merchant/Legacy","latest":false}]},"/docs/api/merchant/2025-12-04":{"items":[{"id":"/docs/api/merchant/2025-12-04#tag-orders","title":"Orders","use":"a","href":"#tag-orders","items":[{"id":"/docs/api/merchant/2025-12-04#create-order","title":"Create an order","use":"a","href":"#create-order","options":{"method":"post"}},{"id":"/docs/api/merchant/2025-12-04#retrieve-order-list","title":"Retrieve an order list","use":"a","href":"#retrieve-order-list","options":{"method":"get"}},{"id":"/docs/api/merchant/2025-12-04#retrieve-order","title":"Retrieve an order","use":"a","href":"#retrieve-order","options":{"method":"get"}},{"id":"/docs/api/merchant/2025-12-04#update-order","title":"Update an order","use":"a","href":"#update-order","options":{"method":"patch"}},{"id":"/docs/api/merchant/2025-12-04#increment-authorisation","title":"Increment authorisation","use":"a","href":"#increment-authorisation","options":{"method":"post"}},{"id":"/docs/api/merchant/2025-12-04#capture-order","title":"Capture an order","use":"a","href":"#capture-order","options":{"method":"post"}},{"id":"/docs/api/merchant/2025-12-04#cancel-order","title":"Cancel an order","use":"a","href":"#cancel-order","options":{"method":"post"}},{"id":"/docs/api/merchant/2025-12-04#refund-order","title":"Refund an order","use":"a","href":"#refund-order","options":{"method":"post"}},{"id":"/docs/api/merchant/2025-12-04#pay-order","title":"Pay for an order","use":"a","href":"#pay-order","options":{"method":"post"}},{"id":"/docs/api/merchant/2025-12-04#retrieve-payment-list","title":"Retrieve payment list of an order","use":"a","href":"#retrieve-payment-list","options":{"method":"get"}}]},{"id":"/docs/api/merchant/2025-12-04#tag-customers","title":"Customers","use":"a","href":"#tag-customers","items":[{"id":"/docs/api/merchant/2025-12-04#create-customer","title":"Create a customer","use":"a","href":"#create-customer","options":{"method":"post"}},{"id":"/docs/api/merchant/2025-12-04#retrieve-customer-list","title":"Retrieve a customer list","use":"a","href":"#retrieve-customer-list","options":{"method":"get"}},{"id":"/docs/api/merchant/2025-12-04#retrieve-customer","title":"Retrieve a customer","use":"a","href":"#retrieve-customer","options":{"method":"get"}},{"id":"/docs/api/merchant/2025-12-04#update-customer","title":"Update a customer","use":"a","href":"#update-customer","options":{"method":"patch"}},{"id":"/docs/api/merchant/2025-12-04#delete-customer","title":"Delete a customer","use":"a","href":"#delete-customer","options":{"method":"delete"}},{"id":"/docs/api/merchant/2025-12-04#retrieve-payment-method-list","title":"Retrieve payment method list of a customer","use":"a","href":"#retrieve-payment-method-list","options":{"method":"get"}},{"id":"/docs/api/merchant/2025-12-04#retrieve-payment-method","title":"Retrieve a customer's payment method","use":"a","href":"#retrieve-payment-method","options":{"method":"get"}},{"id":"/docs/api/merchant/2025-12-04#update-payment-method","title":"Update a customer's payment method","use":"a","href":"#update-payment-method","options":{"method":"patch"}},{"id":"/docs/api/merchant/2025-12-04#delete-payment-method","title":"Delete a customer's payment method","use":"a","href":"#delete-payment-method","options":{"method":"delete"}}]},{"id":"/docs/api/merchant/2025-12-04#tag-payments","title":"Payments","use":"a","href":"#tag-payments","items":[{"id":"/docs/api/merchant/2025-12-04#retrieve-payment-details","title":"Retrieve payment details","use":"a","href":"#retrieve-payment-details","options":{"method":"get"}}]},{"id":"/docs/api/merchant/2025-12-04#tag-subscriptions","title":"Subscriptions","use":"a","href":"#tag-subscriptions","items":[{"id":"/docs/api/merchant/2025-12-04#create-subscription-plan","title":"Create a subscription plan","use":"a","href":"#create-subscription-plan","options":{"method":"post"}},{"id":"/docs/api/merchant/2025-12-04#retrieve-subscription-plan-list","title":"Retrieve a subscription plan list","use":"a","href":"#retrieve-subscription-plan-list","options":{"method":"get"}},{"id":"/docs/api/merchant/2025-12-04#retrieve-subscription-plan","title":"Retrieve a subscription plan","use":"a","href":"#retrieve-subscription-plan","options":{"method":"get"}},{"id":"/docs/api/merchant/2025-12-04#create-subscription","title":"Create a subscription","use":"a","href":"#create-subscription","options":{"method":"post"}},{"id":"/docs/api/merchant/2025-12-04#retrieve-subscription-list","title":"Retrieve a subscription list","use":"a","href":"#retrieve-subscription-list","options":{"method":"get"}},{"id":"/docs/api/merchant/2025-12-04#retrieve-subscription","title":"Retrieve a subscription","use":"a","href":"#retrieve-subscription","options":{"method":"get"}},{"id":"/docs/api/merchant/2025-12-04#update-subscription","title":"Update a subscription","use":"a","href":"#update-subscription","options":{"method":"patch"}},{"id":"/docs/api/merchant/2025-12-04#cancel-subscription","title":"Cancel a subscription","use":"a","href":"#cancel-subscription","options":{"method":"post"}},{"id":"/docs/api/merchant/2025-12-04#change-subscription-plan","title":"Change a subscription plan","use":"a","href":"#change-subscription-plan","options":{"method":"post"}},{"id":"/docs/api/merchant/2025-12-04#update-subscription-renewal-date","title":"Update a subscription renewal date","use":"a","href":"#update-subscription-renewal-date","options":{"method":"post"}},{"id":"/docs/api/merchant/2025-12-04#retrieve-subscription-cycle-list","title":"Retrieve a subscription cycle list","use":"a","href":"#retrieve-subscription-cycle-list","options":{"method":"get"}},{"id":"/docs/api/merchant/2025-12-04#retrieve-subscription-cycle","title":"Retrieve a subscription cycle","use":"a","href":"#retrieve-subscription-cycle","options":{"method":"get"}},{"id":"/docs/api/merchant/2025-12-04#create-subscription-usage","title":"Create a subscription usage","use":"a","href":"#create-subscription-usage","options":{"method":"post"}},{"id":"/docs/api/merchant/2025-12-04#retrieve-subscription-usage-list","title":"Retrieve a subscription usage list","use":"a","href":"#retrieve-subscription-usage-list","options":{"method":"get"}},{"id":"/docs/api/merchant/2025-12-04#retrieve-subscription-usage","title":"Retrieve a subscription usage","use":"a","href":"#retrieve-subscription-usage","options":{"method":"get"}},{"id":"/docs/api/merchant/2025-12-04#update-subscription-usage","title":"Update a subscription usage","use":"a","href":"#update-subscription-usage","options":{"method":"patch"}},{"id":"/docs/api/merchant/2025-12-04#delete-subscription-usage","title":"Delete a subscription usage","use":"a","href":"#delete-subscription-usage","options":{"method":"delete"}}]},{"id":"/docs/api/merchant/2025-12-04#tag-payouts","title":"Payouts","use":"a","href":"#tag-payouts","items":[{"id":"/docs/api/merchant/2025-12-04#retrieve-payout-list","title":"Retrieve a payout list","use":"a","href":"#retrieve-payout-list","options":{"method":"get"}},{"id":"/docs/api/merchant/2025-12-04#retrieve-payout","title":"Retrieve a payout","use":"a","href":"#retrieve-payout","options":{"method":"get"}}]},{"id":"/docs/api/merchant/2025-12-04#tag-disputes","title":"Disputes","use":"a","href":"#tag-disputes","items":[{"id":"/docs/api/merchant/2025-12-04#retrieve-dispute-list","title":"Retrieve a dispute list","use":"a","href":"#retrieve-dispute-list","options":{"method":"get"}},{"id":"/docs/api/merchant/2025-12-04#retrieve-dispute","title":"Retrieve a dispute","use":"a","href":"#retrieve-dispute","options":{"method":"get"}},{"id":"/docs/api/merchant/2025-12-04#accept-dispute","title":"Accept a dispute","use":"a","href":"#accept-dispute","options":{"method":"post"}},{"id":"/docs/api/merchant/2025-12-04#upload-dispute-evidence","title":"Upload evidence for a dispute","use":"a","href":"#upload-dispute-evidence","options":{"method":"post"}},{"id":"/docs/api/merchant/2025-12-04#challenge-dispute","title":"Challenge a dispute","use":"a","href":"#challenge-dispute","options":{"method":"post"}}]},{"id":"/docs/api/merchant/2025-12-04#tag-report-runs","title":"Report runs","use":"a","href":"#tag-report-runs","items":[{"id":"/docs/api/merchant/2025-12-04#create-report-run","title":"Create a report run","use":"a","href":"#create-report-run","options":{"method":"post"}},{"id":"/docs/api/merchant/2025-12-04#retrieve-report-run","title":"Retrieve a report run","use":"a","href":"#retrieve-report-run","options":{"method":"get"}},{"id":"/docs/api/merchant/2025-12-04#download-report-file","title":"Download report file","use":"a","href":"#download-report-file","options":{"method":"get"}}]},{"id":"/docs/api/merchant/2025-12-04#tag-webhooks","title":"Webhooks","use":"a","href":"#tag-webhooks","items":[{"id":"/docs/api/merchant/2025-12-04#create-webhook","title":"Create a webhook","use":"a","href":"#create-webhook","options":{"method":"post"}},{"id":"/docs/api/merchant/2025-12-04#retrieve-webhook-list","title":"Retrieve a webhook list","use":"a","href":"#retrieve-webhook-list","options":{"method":"get"}},{"id":"/docs/api/merchant/2025-12-04#retrieve-webhook","title":"Retrieve a webhook","use":"a","href":"#retrieve-webhook","options":{"method":"get"}},{"id":"/docs/api/merchant/2025-12-04#update-webhook","title":"Update a webhook","use":"a","href":"#update-webhook","options":{"method":"patch"}},{"id":"/docs/api/merchant/2025-12-04#delete-webhook","title":"Delete a webhook","use":"a","href":"#delete-webhook","options":{"method":"delete"}},{"id":"/docs/api/merchant/2025-12-04#rotate-webhook-signing-secret","title":"Rotate a webhook signing secret","use":"a","href":"#rotate-webhook-signing-secret","options":{"method":"post"}}]},{"id":"/docs/api/merchant/2025-12-04#tag-locations","title":"Locations","use":"a","href":"#tag-locations","items":[{"id":"/docs/api/merchant/2025-12-04#create-location","title":"Create a location","use":"a","href":"#create-location","options":{"method":"post"}},{"id":"/docs/api/merchant/2025-12-04#retrieve-location-list","title":"Retrieve location list","use":"a","href":"#retrieve-location-list","options":{"method":"get"}},{"id":"/docs/api/merchant/2025-12-04#retrieve-location","title":"Retrieve a location","use":"a","href":"#retrieve-location","options":{"method":"get"}},{"id":"/docs/api/merchant/2025-12-04#update-location","title":"Update a location","use":"a","href":"#update-location","options":{"method":"patch"}},{"id":"/docs/api/merchant/2025-12-04#delete-location","title":"Delete a location","use":"a","href":"#delete-location","options":{"method":"delete"}}]},{"id":"/docs/api/merchant/2025-12-04#tag-terminals","title":"Terminals","use":"a","href":"#tag-terminals","items":[{"id":"/docs/api/merchant/2025-12-04#retrieve-terminal-list","title":"Retrieve terminal list","use":"a","href":"#retrieve-terminal-list","options":{"method":"get"}}]},{"id":"/docs/api/merchant/2025-12-04#tag-payment-intents","title":"Payment intents","use":"a","href":"#tag-payment-intents","items":[{"id":"/docs/api/merchant/2025-12-04#create-payment-intent","title":"Create a payment intent","use":"a","href":"#create-payment-intent","options":{"method":"post"}},{"id":"/docs/api/merchant/2025-12-04#retrieve-payment-intent","title":"Retrieve a payment intent","use":"a","href":"#retrieve-payment-intent","options":{"method":"get"}},{"id":"/docs/api/merchant/2025-12-04#cancel-payment-intent","title":"Cancel a payment intent","use":"a","href":"#cancel-payment-intent","options":{"method":"post"}}]},{"id":"/docs/api/merchant/2025-12-04#tag-apple-pay-merchant-registration","title":"Apple Pay merchant registration","use":"a","href":"#tag-apple-pay-merchant-registration","items":[{"id":"/docs/api/merchant/2025-12-04#register-domain-apple-pay","title":"Register domain for Apple Pay","use":"a","href":"#register-domain-apple-pay","options":{"method":"post"}},{"id":"/docs/api/merchant/2025-12-04#unregister-domain-apple-pay","title":"Unregister domain for Apple Pay","use":"a","href":"#unregister-domain-apple-pay","options":{"method":"post"}}]},{"id":"/docs/api/merchant/2025-12-04#tag-other","title":"Other","use":"a","href":"#tag-other","items":[{"id":"/docs/api/merchant/2025-12-04#register-address-validation-endpoint","title":"Register address validation endpoint for Fast checkout","use":"a","href":"#register-address-validation-endpoint","options":{"method":"post"}},{"id":"/docs/api/merchant/2025-12-04#retrieve-synchronous-webhook-list","title":"Retrieve a synchronous webhook list","use":"a","href":"#retrieve-synchronous-webhook-list","options":{"method":"get"}},{"id":"/docs/api/merchant/2025-12-04#delete-synchronous-webhook","title":"Delete a synchronous webhook","use":"a","href":"#delete-synchronous-webhook","options":{"method":"delete"}}]}],"versions":[{"label":"2026-04-20","path":"/docs/api/merchant","latest":true},{"label":"2026-03-12","path":"/docs/api/merchant/2026-03-12","latest":false},{"label":"2025-12-04","path":"/docs/api/merchant/2025-12-04","latest":false},{"label":"2025-10-16","path":"/docs/api/merchant/2025-10-16","latest":false},{"label":"2024-09-01","path":"/docs/api/merchant/2024-09-01","latest":false},{"label":"2024-05-01","path":"/docs/api/merchant/2024-05-01","latest":false},{"label":"2023-09-01","path":"/docs/api/merchant/2023-09-01","latest":false},{"label":"Legacy","path":"/docs/api/merchant/Legacy","latest":false}]},"/docs/api/merchant/2025-10-16":{"items":[{"id":"/docs/api/merchant/2025-10-16#tag-orders","title":"Orders","use":"a","href":"#tag-orders","items":[{"id":"/docs/api/merchant/2025-10-16#create-order","title":"Create an order","use":"a","href":"#create-order","options":{"method":"post"}},{"id":"/docs/api/merchant/2025-10-16#retrieve-order-list","title":"Retrieve an order list","use":"a","href":"#retrieve-order-list","options":{"method":"get"}},{"id":"/docs/api/merchant/2025-10-16#retrieve-order","title":"Retrieve an order","use":"a","href":"#retrieve-order","options":{"method":"get"}},{"id":"/docs/api/merchant/2025-10-16#update-order","title":"Update an order","use":"a","href":"#update-order","options":{"method":"patch"}},{"id":"/docs/api/merchant/2025-10-16#increment-order-authorisation","title":"Increment authorisation","use":"a","href":"#increment-order-authorisation","options":{"method":"post"}},{"id":"/docs/api/merchant/2025-10-16#capture-order","title":"Capture an order","use":"a","href":"#capture-order","options":{"method":"post"}},{"id":"/docs/api/merchant/2025-10-16#cancel-order","title":"Cancel an order","use":"a","href":"#cancel-order","options":{"method":"post"}},{"id":"/docs/api/merchant/2025-10-16#refund-order","title":"Refund an order","use":"a","href":"#refund-order","options":{"method":"post"}},{"id":"/docs/api/merchant/2025-10-16#pay-order","title":"Pay for an order","use":"a","href":"#pay-order","options":{"method":"post"}},{"id":"/docs/api/merchant/2025-10-16#retrieve-payment-list","title":"Retrieve payment list of an order","use":"a","href":"#retrieve-payment-list","options":{"method":"get"}}]},{"id":"/docs/api/merchant/2025-10-16#tag-customers","title":"Customers","use":"a","href":"#tag-customers","items":[{"id":"/docs/api/merchant/2025-10-16#create-customer","title":"Create a customer","use":"a","href":"#create-customer","options":{"method":"post"}},{"id":"/docs/api/merchant/2025-10-16#retrieve-customer-list","title":"Retrieve a customer list","use":"a","href":"#retrieve-customer-list","options":{"method":"get"}},{"id":"/docs/api/merchant/2025-10-16#retrieve-customer","title":"Retrieve a customer","use":"a","href":"#retrieve-customer","options":{"method":"get"}},{"id":"/docs/api/merchant/2025-10-16#update-customer","title":"Update a customer","use":"a","href":"#update-customer","options":{"method":"patch"}},{"id":"/docs/api/merchant/2025-10-16#delete-customer","title":"Delete a customer","use":"a","href":"#delete-customer","options":{"method":"delete"}},{"id":"/docs/api/merchant/2025-10-16#retrieve-payment-method-list","title":"Retrieve payment method list of a customer","use":"a","href":"#retrieve-payment-method-list","options":{"method":"get"}},{"id":"/docs/api/merchant/2025-10-16#retrieve-payment-method","title":"Retrieve a customer's payment method","use":"a","href":"#retrieve-payment-method","options":{"method":"get"}},{"id":"/docs/api/merchant/2025-10-16#update-payment-method","title":"Update a customer's payment method","use":"a","href":"#update-payment-method","options":{"method":"patch"}},{"id":"/docs/api/merchant/2025-10-16#delete-payment-method","title":"Delete a customer's payment method","use":"a","href":"#delete-payment-method","options":{"method":"delete"}}]},{"id":"/docs/api/merchant/2025-10-16#tag-payments","title":"Payments","use":"a","href":"#tag-payments","items":[{"id":"/docs/api/merchant/2025-10-16#retrieve-payment-details","title":"Retrieve payment details","use":"a","href":"#retrieve-payment-details","options":{"method":"get"}}]},{"id":"/docs/api/merchant/2025-10-16#tag-subscriptions","title":"Subscriptions","use":"a","href":"#tag-subscriptions","items":[{"id":"/docs/api/merchant/2025-10-16#create-subscription-plan","title":"Create a subscription plan","use":"a","href":"#create-subscription-plan","options":{"method":"post"}},{"id":"/docs/api/merchant/2025-10-16#retrieve-subscription-plan-list","title":"Retrieve a subscription plan list","use":"a","href":"#retrieve-subscription-plan-list","options":{"method":"get"}},{"id":"/docs/api/merchant/2025-10-16#retrieve-subscription-plan","title":"Retrieve a subscription plan","use":"a","href":"#retrieve-subscription-plan","options":{"method":"get"}},{"id":"/docs/api/merchant/2025-10-16#create-subscription","title":"Create a subscription","use":"a","href":"#create-subscription","options":{"method":"post"}},{"id":"/docs/api/merchant/2025-10-16#retrieve-subscription-list","title":"Retrieve a subscription list","use":"a","href":"#retrieve-subscription-list","options":{"method":"get"}},{"id":"/docs/api/merchant/2025-10-16#retrieve-subscription","title":"Retrieve a subscription","use":"a","href":"#retrieve-subscription","options":{"method":"get"}},{"id":"/docs/api/merchant/2025-10-16#update-subscription","title":"Update a subscription","use":"a","href":"#update-subscription","options":{"method":"patch"}},{"id":"/docs/api/merchant/2025-10-16#cancel-subscription","title":"Cancel a subscription","use":"a","href":"#cancel-subscription","options":{"method":"post"}},{"id":"/docs/api/merchant/2025-10-16#change-subscription-plan","title":"Change a subscription plan","use":"a","href":"#change-subscription-plan","options":{"method":"post"}},{"id":"/docs/api/merchant/2025-10-16#update-subscription-renewal-date","title":"Update a subscription renewal date","use":"a","href":"#update-subscription-renewal-date","options":{"method":"post"}},{"id":"/docs/api/merchant/2025-10-16#retrieve-subscription-cycle-list","title":"Retrieve a subscription cycle list","use":"a","href":"#retrieve-subscription-cycle-list","options":{"method":"get"}},{"id":"/docs/api/merchant/2025-10-16#retrieve-subscription-cycle","title":"Retrieve a subscription cycle","use":"a","href":"#retrieve-subscription-cycle","options":{"method":"get"}},{"id":"/docs/api/merchant/2025-10-16#create-subscription-usage","title":"Create a subscription usage","use":"a","href":"#create-subscription-usage","options":{"method":"post"}},{"id":"/docs/api/merchant/2025-10-16#retrieve-subscription-usage-list","title":"Retrieve a subscription usage list","use":"a","href":"#retrieve-subscription-usage-list","options":{"method":"get"}},{"id":"/docs/api/merchant/2025-10-16#retrieve-subscription-usage","title":"Retrieve a subscription usage","use":"a","href":"#retrieve-subscription-usage","options":{"method":"get"}},{"id":"/docs/api/merchant/2025-10-16#update-subscription-usage","title":"Update a subscription usage","use":"a","href":"#update-subscription-usage","options":{"method":"patch"}},{"id":"/docs/api/merchant/2025-10-16#delete-subscription-usage","title":"Delete a subscription usage","use":"a","href":"#delete-subscription-usage","options":{"method":"delete"}}]},{"id":"/docs/api/merchant/2025-10-16#tag-payouts","title":"Payouts","use":"a","href":"#tag-payouts","items":[{"id":"/docs/api/merchant/2025-10-16#retrieve-payout-list","title":"Retrieve a payout list","use":"a","href":"#retrieve-payout-list","options":{"method":"get"}},{"id":"/docs/api/merchant/2025-10-16#retrieve-payout","title":"Retrieve a payout","use":"a","href":"#retrieve-payout","options":{"method":"get"}}]},{"id":"/docs/api/merchant/2025-10-16#tag-disputes","title":"Disputes","use":"a","href":"#tag-disputes","items":[{"id":"/docs/api/merchant/2025-10-16#retrieve-dispute-list","title":"Retrieve a dispute list","use":"a","href":"#retrieve-dispute-list","options":{"method":"get"}},{"id":"/docs/api/merchant/2025-10-16#retrieve-dispute","title":"Retrieve a dispute","use":"a","href":"#retrieve-dispute","options":{"method":"get"}},{"id":"/docs/api/merchant/2025-10-16#accept-dispute","title":"Accept a dispute","use":"a","href":"#accept-dispute","options":{"method":"post"}},{"id":"/docs/api/merchant/2025-10-16#upload-dispute-evidence","title":"Upload evidence for a dispute","use":"a","href":"#upload-dispute-evidence","options":{"method":"post"}},{"id":"/docs/api/merchant/2025-10-16#challenge-dispute","title":"Challenge a dispute","use":"a","href":"#challenge-dispute","options":{"method":"post"}}]},{"id":"/docs/api/merchant/2025-10-16#tag-report-runs","title":"Report runs","use":"a","href":"#tag-report-runs","items":[{"id":"/docs/api/merchant/2025-10-16#create-report-run","title":"Create a report run","use":"a","href":"#create-report-run","options":{"method":"post"}},{"id":"/docs/api/merchant/2025-10-16#retrieve-report-run","title":"Retrieve a report run","use":"a","href":"#retrieve-report-run","options":{"method":"get"}},{"id":"/docs/api/merchant/2025-10-16#download-report-file","title":"Download report file","use":"a","href":"#download-report-file","options":{"method":"get"}}]},{"id":"/docs/api/merchant/2025-10-16#tag-webhooks","title":"Webhooks","use":"a","href":"#tag-webhooks","items":[{"id":"/docs/api/merchant/2025-10-16#create-webhook","title":"Create a webhook","use":"a","href":"#create-webhook","options":{"method":"post"}},{"id":"/docs/api/merchant/2025-10-16#retrieve-webhook-list","title":"Retrieve a webhook list","use":"a","href":"#retrieve-webhook-list","options":{"method":"get"}},{"id":"/docs/api/merchant/2025-10-16#retrieve-webhook","title":"Retrieve a webhook","use":"a","href":"#retrieve-webhook","options":{"method":"get"}},{"id":"/docs/api/merchant/2025-10-16#update-webhook","title":"Update a webhook","use":"a","href":"#update-webhook","options":{"method":"patch"}},{"id":"/docs/api/merchant/2025-10-16#delete-webhook","title":"Delete a webhook","use":"a","href":"#delete-webhook","options":{"method":"delete"}},{"id":"/docs/api/merchant/2025-10-16#rotate-webhook-signing-secret","title":"Rotate a webhook signing secret","use":"a","href":"#rotate-webhook-signing-secret","options":{"method":"post"}}]},{"id":"/docs/api/merchant/2025-10-16#tag-locations","title":"Locations","use":"a","href":"#tag-locations","items":[{"id":"/docs/api/merchant/2025-10-16#create-location","title":"Create a location","use":"a","href":"#create-location","options":{"method":"post"}},{"id":"/docs/api/merchant/2025-10-16#retrieve-location-list","title":"Retrieve location list","use":"a","href":"#retrieve-location-list","options":{"method":"get"}},{"id":"/docs/api/merchant/2025-10-16#retrieve-location","title":"Retrieve a location","use":"a","href":"#retrieve-location","options":{"method":"get"}},{"id":"/docs/api/merchant/2025-10-16#update-location","title":"Update a location","use":"a","href":"#update-location","options":{"method":"patch"}},{"id":"/docs/api/merchant/2025-10-16#delete-location","title":"Delete a location","use":"a","href":"#delete-location","options":{"method":"delete"}}]},{"id":"/docs/api/merchant/2025-10-16#tag-terminals","title":"Terminals","use":"a","href":"#tag-terminals","items":[{"id":"/docs/api/merchant/2025-10-16#retrieve-terminal-list","title":"Retrieve terminal list","use":"a","href":"#retrieve-terminal-list","options":{"method":"get"}}]},{"id":"/docs/api/merchant/2025-10-16#tag-payment-intents","title":"Payment intents","use":"a","href":"#tag-payment-intents","items":[{"id":"/docs/api/merchant/2025-10-16#create-payment-intent","title":"Create a payment intent","use":"a","href":"#create-payment-intent","options":{"method":"post"}},{"id":"/docs/api/merchant/2025-10-16#retrieve-payment-intent","title":"Retrieve a payment intent","use":"a","href":"#retrieve-payment-intent","options":{"method":"get"}},{"id":"/docs/api/merchant/2025-10-16#cancel-payment-intent","title":"Cancel a payment intent","use":"a","href":"#cancel-payment-intent","options":{"method":"post"}}]},{"id":"/docs/api/merchant/2025-10-16#tag-apple-pay-merchant-registration","title":"Apple Pay merchant registration","use":"a","href":"#tag-apple-pay-merchant-registration","items":[{"id":"/docs/api/merchant/2025-10-16#register-domain-apple-pay","title":"Register domain for Apple Pay","use":"a","href":"#register-domain-apple-pay","options":{"method":"post"}},{"id":"/docs/api/merchant/2025-10-16#unregister-domain-apple-pay","title":"Unregister domain for Apple Pay","use":"a","href":"#unregister-domain-apple-pay","options":{"method":"post"}}]},{"id":"/docs/api/merchant/2025-10-16#tag-other","title":"Other","use":"a","href":"#tag-other","items":[{"id":"/docs/api/merchant/2025-10-16#register-address-validation-endpoint","title":"Register address validation endpoint for Fast checkout","use":"a","href":"#register-address-validation-endpoint","options":{"method":"post"}},{"id":"/docs/api/merchant/2025-10-16#retrieve-synchronous-webhook-list","title":"Retrieve a synchronous webhook list","use":"a","href":"#retrieve-synchronous-webhook-list","options":{"method":"get"}},{"id":"/docs/api/merchant/2025-10-16#delete-synchronous-webhook","title":"Delete a synchronous webhook","use":"a","href":"#delete-synchronous-webhook","options":{"method":"delete"}}]}],"versions":[{"label":"2026-04-20","path":"/docs/api/merchant","latest":true},{"label":"2026-03-12","path":"/docs/api/merchant/2026-03-12","latest":false},{"label":"2025-12-04","path":"/docs/api/merchant/2025-12-04","latest":false},{"label":"2025-10-16","path":"/docs/api/merchant/2025-10-16","latest":false},{"label":"2024-09-01","path":"/docs/api/merchant/2024-09-01","latest":false},{"label":"2024-05-01","path":"/docs/api/merchant/2024-05-01","latest":false},{"label":"2023-09-01","path":"/docs/api/merchant/2023-09-01","latest":false},{"label":"Legacy","path":"/docs/api/merchant/Legacy","latest":false}]},"/docs/api/merchant/2024-09-01":{"items":[{"id":"/docs/api/merchant/2024-09-01#tag-orders","title":"Orders","use":"a","href":"#tag-orders","items":[{"id":"/docs/api/merchant/2024-09-01#create-order","title":"Create an order","use":"a","href":"#create-order","options":{"method":"post"}},{"id":"/docs/api/merchant/2024-09-01#retrieve-order-list","title":"Retrieve an order list","use":"a","href":"#retrieve-order-list","options":{"method":"get"}},{"id":"/docs/api/merchant/2024-09-01#retrieve-order","title":"Retrieve an order","use":"a","href":"#retrieve-order","options":{"method":"get"}},{"id":"/docs/api/merchant/2024-09-01#update-order","title":"Update an order","use":"a","href":"#update-order","options":{"method":"patch"}},{"id":"/docs/api/merchant/2024-09-01#increment-order-authorisation","title":"Increment authorisation","use":"a","href":"#increment-order-authorisation","options":{"method":"post"}},{"id":"/docs/api/merchant/2024-09-01#capture-order","title":"Capture an order","use":"a","href":"#capture-order","options":{"method":"post"}},{"id":"/docs/api/merchant/2024-09-01#cancel-order","title":"Cancel an order","use":"a","href":"#cancel-order","options":{"method":"post"}},{"id":"/docs/api/merchant/2024-09-01#refund-order","title":"Refund an order","use":"a","href":"#refund-order","options":{"method":"post"}},{"id":"/docs/api/merchant/2024-09-01#pay-order","title":"Pay for an order","use":"a","href":"#pay-order","options":{"method":"post"}},{"id":"/docs/api/merchant/2024-09-01#retrieve-payment-list","title":"Retrieve payment list of an order","use":"a","href":"#retrieve-payment-list","options":{"method":"get"}}]},{"id":"/docs/api/merchant/2024-09-01#tag-customers","title":"Customers","use":"a","href":"#tag-customers","items":[{"id":"/docs/api/merchant/2024-09-01#create-customer","title":"Create a customer","use":"a","href":"#create-customer","options":{"method":"post"}},{"id":"/docs/api/merchant/2024-09-01#retrieve-customer-list","title":"Retrieve a customer list","use":"a","href":"#retrieve-customer-list","options":{"method":"get"}},{"id":"/docs/api/merchant/2024-09-01#retrieve-customer","title":"Retrieve a customer","use":"a","href":"#retrieve-customer","options":{"method":"get"}},{"id":"/docs/api/merchant/2024-09-01#update-customer","title":"Update a customer","use":"a","href":"#update-customer","options":{"method":"patch"}},{"id":"/docs/api/merchant/2024-09-01#delete-customer","title":"Delete a customer","use":"a","href":"#delete-customer","options":{"method":"delete"}},{"id":"/docs/api/merchant/2024-09-01#retrieve-payment-method-list","title":"Retrieve payment method list of a customer","use":"a","href":"#retrieve-payment-method-list","options":{"method":"get"}},{"id":"/docs/api/merchant/2024-09-01#retrieve-payment-method","title":"Retrieve a customer's payment method","use":"a","href":"#retrieve-payment-method","options":{"method":"get"}},{"id":"/docs/api/merchant/2024-09-01#update-payment-method","title":"Update a customer's payment method","use":"a","href":"#update-payment-method","options":{"method":"patch"}},{"id":"/docs/api/merchant/2024-09-01#delete-payment-method","title":"Delete a customer's payment method","use":"a","href":"#delete-payment-method","options":{"method":"delete"}}]},{"id":"/docs/api/merchant/2024-09-01#tag-payments","title":"Payments","use":"a","href":"#tag-payments","items":[{"id":"/docs/api/merchant/2024-09-01#retrieve-payment-details","title":"Retrieve payment details","use":"a","href":"#retrieve-payment-details","options":{"method":"get"}}]},{"id":"/docs/api/merchant/2024-09-01#tag-subscriptions","title":"Subscriptions","use":"a","href":"#tag-subscriptions","items":[{"id":"/docs/api/merchant/2024-09-01#create-subscription-plan","title":"Create a subscription plan","use":"a","href":"#create-subscription-plan","options":{"method":"post"}},{"id":"/docs/api/merchant/2024-09-01#retrieve-subscription-plan-list","title":"Retrieve a subscription plan list","use":"a","href":"#retrieve-subscription-plan-list","options":{"method":"get"}},{"id":"/docs/api/merchant/2024-09-01#retrieve-subscription-plan","title":"Retrieve a subscription plan","use":"a","href":"#retrieve-subscription-plan","options":{"method":"get"}},{"id":"/docs/api/merchant/2024-09-01#create-subscription","title":"Create a subscription","use":"a","href":"#create-subscription","options":{"method":"post"}},{"id":"/docs/api/merchant/2024-09-01#retrieve-subscription-list","title":"Retrieve a subscription list","use":"a","href":"#retrieve-subscription-list","options":{"method":"get"}},{"id":"/docs/api/merchant/2024-09-01#retrieve-subscription","title":"Retrieve a subscription","use":"a","href":"#retrieve-subscription","options":{"method":"get"}},{"id":"/docs/api/merchant/2024-09-01#update-subscription","title":"Update a subscription","use":"a","href":"#update-subscription","options":{"method":"patch"}},{"id":"/docs/api/merchant/2024-09-01#cancel-subscription","title":"Cancel a subscription","use":"a","href":"#cancel-subscription","options":{"method":"post"}},{"id":"/docs/api/merchant/2024-09-01#change-subscription-plan","title":"Change a subscription plan","use":"a","href":"#change-subscription-plan","options":{"method":"post"}},{"id":"/docs/api/merchant/2024-09-01#update-subscription-renewal-date","title":"Update a subscription renewal date","use":"a","href":"#update-subscription-renewal-date","options":{"method":"post"}},{"id":"/docs/api/merchant/2024-09-01#retrieve-subscription-cycle-list","title":"Retrieve a subscription cycle list","use":"a","href":"#retrieve-subscription-cycle-list","options":{"method":"get"}},{"id":"/docs/api/merchant/2024-09-01#retrieve-subscription-cycle","title":"Retrieve a subscription cycle","use":"a","href":"#retrieve-subscription-cycle","options":{"method":"get"}},{"id":"/docs/api/merchant/2024-09-01#create-subscription-usage","title":"Create a subscription usage","use":"a","href":"#create-subscription-usage","options":{"method":"post"}},{"id":"/docs/api/merchant/2024-09-01#retrieve-subscription-usage-list","title":"Retrieve a subscription usage list","use":"a","href":"#retrieve-subscription-usage-list","options":{"method":"get"}},{"id":"/docs/api/merchant/2024-09-01#retrieve-subscription-usage","title":"Retrieve a subscription usage","use":"a","href":"#retrieve-subscription-usage","options":{"method":"get"}},{"id":"/docs/api/merchant/2024-09-01#update-subscription-usage","title":"Update a subscription usage","use":"a","href":"#update-subscription-usage","options":{"method":"patch"}},{"id":"/docs/api/merchant/2024-09-01#delete-subscription-usage","title":"Delete a subscription usage","use":"a","href":"#delete-subscription-usage","options":{"method":"delete"}}]},{"id":"/docs/api/merchant/2024-09-01#tag-payouts","title":"Payouts","use":"a","href":"#tag-payouts","items":[{"id":"/docs/api/merchant/2024-09-01#retrieve-payout-list","title":"Retrieve a payout list","use":"a","href":"#retrieve-payout-list","options":{"method":"get"}},{"id":"/docs/api/merchant/2024-09-01#retrieve-payout","title":"Retrieve a payout","use":"a","href":"#retrieve-payout","options":{"method":"get"}}]},{"id":"/docs/api/merchant/2024-09-01#tag-disputes","title":"Disputes","use":"a","href":"#tag-disputes","items":[{"id":"/docs/api/merchant/2024-09-01#retrieve-dispute-list","title":"Retrieve a dispute list","use":"a","href":"#retrieve-dispute-list","options":{"method":"get"}},{"id":"/docs/api/merchant/2024-09-01#retrieve-dispute","title":"Retrieve a dispute","use":"a","href":"#retrieve-dispute","options":{"method":"get"}},{"id":"/docs/api/merchant/2024-09-01#accept-dispute","title":"Accept a dispute","use":"a","href":"#accept-dispute","options":{"method":"post"}},{"id":"/docs/api/merchant/2024-09-01#upload-dispute-evidence","title":"Upload evidence for a dispute","use":"a","href":"#upload-dispute-evidence","options":{"method":"post"}},{"id":"/docs/api/merchant/2024-09-01#challenge-dispute","title":"Challenge a dispute","use":"a","href":"#challenge-dispute","options":{"method":"post"}}]},{"id":"/docs/api/merchant/2024-09-01#tag-report-runs","title":"Report runs","use":"a","href":"#tag-report-runs","items":[{"id":"/docs/api/merchant/2024-09-01#create-report-run","title":"Create a report run","use":"a","href":"#create-report-run","options":{"method":"post"}},{"id":"/docs/api/merchant/2024-09-01#retrieve-report-run","title":"Retrieve a report run","use":"a","href":"#retrieve-report-run","options":{"method":"get"}},{"id":"/docs/api/merchant/2024-09-01#download-report-file","title":"Download report file","use":"a","href":"#download-report-file","options":{"method":"get"}}]},{"id":"/docs/api/merchant/2024-09-01#tag-webhooks","title":"Webhooks","use":"a","href":"#tag-webhooks","items":[{"id":"/docs/api/merchant/2024-09-01#create-webhook","title":"Create a webhook","use":"a","href":"#create-webhook","options":{"method":"post"}},{"id":"/docs/api/merchant/2024-09-01#retrieve-webhook-list","title":"Retrieve a webhook list","use":"a","href":"#retrieve-webhook-list","options":{"method":"get"}},{"id":"/docs/api/merchant/2024-09-01#retrieve-webhook","title":"Retrieve a webhook","use":"a","href":"#retrieve-webhook","options":{"method":"get"}},{"id":"/docs/api/merchant/2024-09-01#update-webhook","title":"Update a webhook","use":"a","href":"#update-webhook","options":{"method":"patch"}},{"id":"/docs/api/merchant/2024-09-01#delete-webhook","title":"Delete a webhook","use":"a","href":"#delete-webhook","options":{"method":"delete"}},{"id":"/docs/api/merchant/2024-09-01#rotate-webhook-signing-secret","title":"Rotate a webhook signing secret","use":"a","href":"#rotate-webhook-signing-secret","options":{"method":"post"}}]},{"id":"/docs/api/merchant/2024-09-01#tag-locations","title":"Locations","use":"a","href":"#tag-locations","items":[{"id":"/docs/api/merchant/2024-09-01#create-location","title":"Create a location","use":"a","href":"#create-location","options":{"method":"post"}},{"id":"/docs/api/merchant/2024-09-01#retrieve-location-list","title":"Retrieve location list","use":"a","href":"#retrieve-location-list","options":{"method":"get"}},{"id":"/docs/api/merchant/2024-09-01#retrieve-location","title":"Retrieve a location","use":"a","href":"#retrieve-location","options":{"method":"get"}},{"id":"/docs/api/merchant/2024-09-01#update-location","title":"Update a location","use":"a","href":"#update-location","options":{"method":"patch"}},{"id":"/docs/api/merchant/2024-09-01#delete-location","title":"Delete a location","use":"a","href":"#delete-location","options":{"method":"delete"}}]},{"id":"/docs/api/merchant/2024-09-01#tag-terminals","title":"Terminals","use":"a","href":"#tag-terminals","items":[{"id":"/docs/api/merchant/2024-09-01#retrieve-terminal-list","title":"Retrieve terminal list","use":"a","href":"#retrieve-terminal-list","options":{"method":"get"}}]},{"id":"/docs/api/merchant/2024-09-01#tag-payment-intents","title":"Payment intents","use":"a","href":"#tag-payment-intents","items":[{"id":"/docs/api/merchant/2024-09-01#create-payment-intent","title":"Create a payment intent","use":"a","href":"#create-payment-intent","options":{"method":"post"}},{"id":"/docs/api/merchant/2024-09-01#retrieve-payment-intent","title":"Retrieve a payment intent","use":"a","href":"#retrieve-payment-intent","options":{"method":"get"}},{"id":"/docs/api/merchant/2024-09-01#cancel-payment-intent","title":"Cancel a payment intent","use":"a","href":"#cancel-payment-intent","options":{"method":"post"}}]},{"id":"/docs/api/merchant/2024-09-01#tag-apple-pay-merchant-registration","title":"Apple Pay merchant registration","use":"a","href":"#tag-apple-pay-merchant-registration","items":[{"id":"/docs/api/merchant/2024-09-01#register-domain-apple-pay","title":"Register domain for Apple Pay","use":"a","href":"#register-domain-apple-pay","options":{"method":"post"}},{"id":"/docs/api/merchant/2024-09-01#unregister-domain-apple-pay","title":"Unregister domain for Apple Pay","use":"a","href":"#unregister-domain-apple-pay","options":{"method":"post"}}]},{"id":"/docs/api/merchant/2024-09-01#tag-other","title":"Other","use":"a","href":"#tag-other","items":[{"id":"/docs/api/merchant/2024-09-01#register-address-validation-endpoint","title":"Register address validation endpoint for Fast checkout","use":"a","href":"#register-address-validation-endpoint","options":{"method":"post"}},{"id":"/docs/api/merchant/2024-09-01#retrieve-synchronous-webhook-list","title":"Retrieve a synchronous webhook list","use":"a","href":"#retrieve-synchronous-webhook-list","options":{"method":"get"}},{"id":"/docs/api/merchant/2024-09-01#delete-synchronous-webhook","title":"Delete a synchronous webhook","use":"a","href":"#delete-synchronous-webhook","options":{"method":"delete"}}]}],"versions":[{"label":"2026-04-20","path":"/docs/api/merchant","latest":true},{"label":"2026-03-12","path":"/docs/api/merchant/2026-03-12","latest":false},{"label":"2025-12-04","path":"/docs/api/merchant/2025-12-04","latest":false},{"label":"2025-10-16","path":"/docs/api/merchant/2025-10-16","latest":false},{"label":"2024-09-01","path":"/docs/api/merchant/2024-09-01","latest":false},{"label":"2024-05-01","path":"/docs/api/merchant/2024-05-01","latest":false},{"label":"2023-09-01","path":"/docs/api/merchant/2023-09-01","latest":false},{"label":"Legacy","path":"/docs/api/merchant/Legacy","latest":false}]},"/docs/api/merchant/2024-05-01":{"items":[{"id":"/docs/api/merchant/2024-05-01#tag-orders","title":"Orders","use":"a","href":"#tag-orders","items":[{"id":"/docs/api/merchant/2024-05-01#create-order","title":"Create an order","use":"a","href":"#create-order","options":{"method":"post"}},{"id":"/docs/api/merchant/2024-05-01#retrieve-order","title":"Retrieve an order","use":"a","href":"#retrieve-order","options":{"method":"get"}},{"id":"/docs/api/merchant/2024-05-01#update-order","title":"Update an order","use":"a","href":"#update-order","options":{"method":"patch"}},{"id":"/docs/api/merchant/2024-05-01#retrieve-order-list","title":"Retrieve an order list","use":"a","href":"#retrieve-order-list","options":{"method":"get"}},{"id":"/docs/api/merchant/2024-05-01#increment-order-authorisation","title":"Increment authorisation","use":"a","href":"#increment-order-authorisation","options":{"method":"post"}},{"id":"/docs/api/merchant/2024-05-01#capture-order","title":"Capture an order","use":"a","href":"#capture-order","options":{"method":"post"}},{"id":"/docs/api/merchant/2024-05-01#cancel-order","title":"Cancel an order","use":"a","href":"#cancel-order","options":{"method":"post"}},{"id":"/docs/api/merchant/2024-05-01#refund-order-deprecated","title":"Refund an order (Deprecated)","use":"a","href":"#refund-order-deprecated","options":{"method":"post"}},{"id":"/docs/api/merchant/2024-05-01#pay-order","title":"Pay for an order","use":"a","href":"#pay-order","options":{"method":"post"}},{"id":"/docs/api/merchant/2024-05-01#retrieve-payment-list","title":"Retrieve payment list of an order","use":"a","href":"#retrieve-payment-list","options":{"method":"get"}}]},{"id":"/docs/api/merchant/2024-05-01#tag-customers","title":"Customers","use":"a","href":"#tag-customers","items":[{"id":"/docs/api/merchant/2024-05-01#create-customer-deprecated","title":"Create a customer (Deprecated)","use":"a","href":"#create-customer-deprecated","options":{"method":"post"}},{"id":"/docs/api/merchant/2024-05-01#retrieve-all-customers-deprecated","title":"Retrieve a customer list (Deprecated)","use":"a","href":"#retrieve-all-customers-deprecated","options":{"method":"get"}},{"id":"/docs/api/merchant/2024-05-01#retrieve-customer-deprecated","title":"Retrieve a customer (Deprecated)","use":"a","href":"#retrieve-customer-deprecated","options":{"method":"get"}},{"id":"/docs/api/merchant/2024-05-01#update-customer-deprecated","title":"Update a customer (Deprecated)","use":"a","href":"#update-customer-deprecated","options":{"method":"patch"}},{"id":"/docs/api/merchant/2024-05-01#delete-customer-deprecated","title":"Delete a customer (Deprecated)","use":"a","href":"#delete-customer-deprecated","options":{"method":"delete"}},{"id":"/docs/api/merchant/2024-05-01#retrieve-all-payment-methods-deprecated","title":"Retrieve all payment methods of a customer (Deprecated)","use":"a","href":"#retrieve-all-payment-methods-deprecated","options":{"method":"get"}},{"id":"/docs/api/merchant/2024-05-01#retrieve-payment-method-deprecated","title":"Retrieve a customer's payment method (Deprecated)","use":"a","href":"#retrieve-payment-method-deprecated","options":{"method":"get"}},{"id":"/docs/api/merchant/2024-05-01#update-payment-method-deprecated","title":"Update a customer's payment method (Deprecated)","use":"a","href":"#update-payment-method-deprecated","options":{"method":"patch"}},{"id":"/docs/api/merchant/2024-05-01#delete-payment-method-deprecated","title":"Delete a customer's payment method (Deprecated)","use":"a","href":"#delete-payment-method-deprecated","options":{"method":"delete"}}]},{"id":"/docs/api/merchant/2024-05-01#tag-payments","title":"Payments","use":"a","href":"#tag-payments","items":[{"id":"/docs/api/merchant/2024-05-01#retrieve-payment-details","title":"Retrieve payment details","use":"a","href":"#retrieve-payment-details","options":{"method":"get"}}]},{"id":"/docs/api/merchant/2024-05-01#tag-payouts","title":"Payouts","use":"a","href":"#tag-payouts","items":[{"id":"/docs/api/merchant/2024-05-01#retrieve-payout-list","title":"Retrieve a payout list","use":"a","href":"#retrieve-payout-list","options":{"method":"get"}},{"id":"/docs/api/merchant/2024-05-01#retrieve-payout","title":"Retrieve a payout","use":"a","href":"#retrieve-payout","options":{"method":"get"}}]},{"id":"/docs/api/merchant/2024-05-01#tag-report-runs","title":"Report runs","use":"a","href":"#tag-report-runs","items":[{"id":"/docs/api/merchant/2024-05-01#create-report-run","title":"Create a report run","use":"a","href":"#create-report-run","options":{"method":"post"}},{"id":"/docs/api/merchant/2024-05-01#retrieve-report-run","title":"Retrieve a report run","use":"a","href":"#retrieve-report-run","options":{"method":"get"}},{"id":"/docs/api/merchant/2024-05-01#download-report-file","title":"Download report file","use":"a","href":"#download-report-file","options":{"method":"get"}}]},{"id":"/docs/api/merchant/2024-05-01#tag-webhooks","title":"Webhooks","use":"a","href":"#tag-webhooks","items":[{"id":"/docs/api/merchant/2024-05-01#create-webhook-deprecated","title":"Create a webhook (Deprecated)","use":"a","href":"#create-webhook-deprecated","options":{"method":"post"}},{"id":"/docs/api/merchant/2024-05-01#retrieve-all-webhooks-deprecated","title":"Retrieve a webhook list (Deprecated)","use":"a","href":"#retrieve-all-webhooks-deprecated","options":{"method":"get"}},{"id":"/docs/api/merchant/2024-05-01#retrieve-webhook-deprecated","title":"Retrieve a webhook (Deprecated)","use":"a","href":"#retrieve-webhook-deprecated","options":{"method":"get"}},{"id":"/docs/api/merchant/2024-05-01#update-webhook-deprecated","title":"Update a webhook (Deprecated)","use":"a","href":"#update-webhook-deprecated","options":{"method":"put"}},{"id":"/docs/api/merchant/2024-05-01#delete-webhook-deprecated","title":"Delete a webhook (Deprecated)","use":"a","href":"#delete-webhook-deprecated","options":{"method":"delete"}},{"id":"/docs/api/merchant/2024-05-01#rotate-webhook-signing-secret-deprecated","title":"Rotate a webhook signing secret (Deprecated)","use":"a","href":"#rotate-webhook-signing-secret-deprecated","options":{"method":"post"}}]},{"id":"/docs/api/merchant/2024-05-01#tag-locations","title":"Locations","use":"a","href":"#tag-locations","items":[{"id":"/docs/api/merchant/2024-05-01#create-location","title":"Create a location","use":"a","href":"#create-location","options":{"method":"post"}},{"id":"/docs/api/merchant/2024-05-01#retrieve-location-list","title":"Retrieve location list","use":"a","href":"#retrieve-location-list","options":{"method":"get"}},{"id":"/docs/api/merchant/2024-05-01#retrieve-location","title":"Retrieve a location","use":"a","href":"#retrieve-location","options":{"method":"get"}},{"id":"/docs/api/merchant/2024-05-01#update-location","title":"Update a location","use":"a","href":"#update-location","options":{"method":"patch"}},{"id":"/docs/api/merchant/2024-05-01#delete-location","title":"Delete a location","use":"a","href":"#delete-location","options":{"method":"delete"}}]},{"id":"/docs/api/merchant/2024-05-01#tag-terminals","title":"Terminals","use":"a","href":"#tag-terminals","items":[{"id":"/docs/api/merchant/2024-05-01#retrieve-terminal-list","title":"Retrieve terminal list","use":"a","href":"#retrieve-terminal-list","options":{"method":"get"}}]},{"id":"/docs/api/merchant/2024-05-01#tag-payment-intents","title":"Payment intents","use":"a","href":"#tag-payment-intents","items":[{"id":"/docs/api/merchant/2024-05-01#create-payment-intent","title":"Create a payment intent","use":"a","href":"#create-payment-intent","options":{"method":"post"}},{"id":"/docs/api/merchant/2024-05-01#retrieve-payment-intent","title":"Retrieve a payment intent","use":"a","href":"#retrieve-payment-intent","options":{"method":"get"}},{"id":"/docs/api/merchant/2024-05-01#cancel-payment-intent","title":"Cancel a payment intent","use":"a","href":"#cancel-payment-intent","options":{"method":"post"}}]},{"id":"/docs/api/merchant/2024-05-01#tag-apple-pay-merchant-registration","title":"Apple Pay merchant registration","use":"a","href":"#tag-apple-pay-merchant-registration","items":[{"id":"/docs/api/merchant/2024-05-01#register-domain-apple-pay","title":"Register domain for Apple Pay","use":"a","href":"#register-domain-apple-pay","options":{"method":"post"}},{"id":"/docs/api/merchant/2024-05-01#unregister-domain-apple-pay","title":"Unregister domain for Apple Pay","use":"a","href":"#unregister-domain-apple-pay","options":{"method":"post"}}]},{"id":"/docs/api/merchant/2024-05-01#tag-other","title":"Other","use":"a","href":"#tag-other","items":[{"id":"/docs/api/merchant/2024-05-01#register-address-validation-endpoint","title":"Register address validation endpoint for Fast checkout","use":"a","href":"#register-address-validation-endpoint","options":{"method":"post"}},{"id":"/docs/api/merchant/2024-05-01#retrieve-synchronous-webhook-list","title":"Retrieve a synchronous webhook list","use":"a","href":"#retrieve-synchronous-webhook-list","options":{"method":"get"}},{"id":"/docs/api/merchant/2024-05-01#delete-synchronous-webhook","title":"Delete a synchronous webhook","use":"a","href":"#delete-synchronous-webhook","options":{"method":"delete"}}]}],"versions":[{"label":"2026-04-20","path":"/docs/api/merchant","latest":true},{"label":"2026-03-12","path":"/docs/api/merchant/2026-03-12","latest":false},{"label":"2025-12-04","path":"/docs/api/merchant/2025-12-04","latest":false},{"label":"2025-10-16","path":"/docs/api/merchant/2025-10-16","latest":false},{"label":"2024-09-01","path":"/docs/api/merchant/2024-09-01","latest":false},{"label":"2024-05-01","path":"/docs/api/merchant/2024-05-01","latest":false},{"label":"2023-09-01","path":"/docs/api/merchant/2023-09-01","latest":false},{"label":"Legacy","path":"/docs/api/merchant/Legacy","latest":false}]},"/docs/api/merchant/2023-09-01":{"items":[{"id":"/docs/api/merchant/2023-09-01#tag-orders","title":"Orders","use":"a","href":"#tag-orders","items":[{"id":"/docs/api/merchant/2023-09-01#create-order","title":"Create an order","use":"a","href":"#create-order","options":{"method":"post"}},{"id":"/docs/api/merchant/2023-09-01#retrieve-order","title":"Retrieve an order","use":"a","href":"#retrieve-order","options":{"method":"get"}},{"id":"/docs/api/merchant/2023-09-01#update-order","title":"Update an order","use":"a","href":"#update-order","options":{"method":"patch"}},{"id":"/docs/api/merchant/2023-09-01#retrieve-order-list","title":"Retrieve an order list","use":"a","href":"#retrieve-order-list","options":{"method":"get"}},{"id":"/docs/api/merchant/2023-09-01#capture-order","title":"Capture an order","use":"a","href":"#capture-order","options":{"method":"post"}},{"id":"/docs/api/merchant/2023-09-01#cancel-order","title":"Cancel an order","use":"a","href":"#cancel-order","options":{"method":"post"}},{"id":"/docs/api/merchant/2023-09-01#refund-order-deprecated","title":"Refund an order (Deprecated)","use":"a","href":"#refund-order-deprecated","options":{"method":"post"}},{"id":"/docs/api/merchant/2023-09-01#pay-order","title":"Pay for an order","use":"a","href":"#pay-order","options":{"method":"post"}},{"id":"/docs/api/merchant/2023-09-01#retrieve-payment-list","title":"Retrieve payment list of an order","use":"a","href":"#retrieve-payment-list","options":{"method":"get"}}]},{"id":"/docs/api/merchant/2023-09-01#tag-customers","title":"Customers","use":"a","href":"#tag-customers","items":[{"id":"/docs/api/merchant/2023-09-01#create-customer-deprecated","title":"Create a customer (Deprecated)","use":"a","href":"#create-customer-deprecated","options":{"method":"post"}},{"id":"/docs/api/merchant/2023-09-01#retrieve-all-customers-deprecated","title":"Retrieve a customer list (Deprecated)","use":"a","href":"#retrieve-all-customers-deprecated","options":{"method":"get"}},{"id":"/docs/api/merchant/2023-09-01#retrieve-customer-deprecated","title":"Retrieve a customer (Deprecated)","use":"a","href":"#retrieve-customer-deprecated","options":{"method":"get"}},{"id":"/docs/api/merchant/2023-09-01#update-customer-deprecated","title":"Update a customer (Deprecated)","use":"a","href":"#update-customer-deprecated","options":{"method":"patch"}},{"id":"/docs/api/merchant/2023-09-01#delete-customer-deprecated","title":"Delete a customer (Deprecated)","use":"a","href":"#delete-customer-deprecated","options":{"method":"delete"}},{"id":"/docs/api/merchant/2023-09-01#retrieve-all-payment-methods-deprecated","title":"Retrieve all payment methods of a customer (Deprecated)","use":"a","href":"#retrieve-all-payment-methods-deprecated","options":{"method":"get"}},{"id":"/docs/api/merchant/2023-09-01#retrieve-payment-method-deprecated","title":"Retrieve a customer's payment method (Deprecated)","use":"a","href":"#retrieve-payment-method-deprecated","options":{"method":"get"}},{"id":"/docs/api/merchant/2023-09-01#update-payment-method-deprecated","title":"Update a customer's payment method (Deprecated)","use":"a","href":"#update-payment-method-deprecated","options":{"method":"patch"}},{"id":"/docs/api/merchant/2023-09-01#delete-payment-method-deprecated","title":"Delete a customer's payment method (Deprecated)","use":"a","href":"#delete-payment-method-deprecated","options":{"method":"delete"}}]},{"id":"/docs/api/merchant/2023-09-01#tag-payments","title":"Payments","use":"a","href":"#tag-payments","items":[{"id":"/docs/api/merchant/2023-09-01#retrieve-payment-details","title":"Retrieve payment details","use":"a","href":"#retrieve-payment-details","options":{"method":"get"}}]},{"id":"/docs/api/merchant/2023-09-01#tag-payouts","title":"Payouts","use":"a","href":"#tag-payouts","items":[{"id":"/docs/api/merchant/2023-09-01#retrieve-payout-list","title":"Retrieve a payout list","use":"a","href":"#retrieve-payout-list","options":{"method":"get"}},{"id":"/docs/api/merchant/2023-09-01#retrieve-payout","title":"Retrieve a payout","use":"a","href":"#retrieve-payout","options":{"method":"get"}}]},{"id":"/docs/api/merchant/2023-09-01#tag-report-runs","title":"Report runs","use":"a","href":"#tag-report-runs","items":[{"id":"/docs/api/merchant/2023-09-01#create-report-run","title":"Create a report run","use":"a","href":"#create-report-run","options":{"method":"post"}},{"id":"/docs/api/merchant/2023-09-01#retrieve-report-run","title":"Retrieve a report run","use":"a","href":"#retrieve-report-run","options":{"method":"get"}},{"id":"/docs/api/merchant/2023-09-01#download-report-file","title":"Download report file","use":"a","href":"#download-report-file","options":{"method":"get"}}]},{"id":"/docs/api/merchant/2023-09-01#tag-webhooks","title":"Webhooks","use":"a","href":"#tag-webhooks","items":[{"id":"/docs/api/merchant/2023-09-01#create-webhook-deprecated","title":"Create a webhook (Deprecated)","use":"a","href":"#create-webhook-deprecated","options":{"method":"post"}},{"id":"/docs/api/merchant/2023-09-01#retrieve-all-webhooks-deprecated","title":"Retrieve a webhook list (Deprecated)","use":"a","href":"#retrieve-all-webhooks-deprecated","options":{"method":"get"}},{"id":"/docs/api/merchant/2023-09-01#retrieve-webhook-deprecated","title":"Retrieve a webhook (Deprecated)","use":"a","href":"#retrieve-webhook-deprecated","options":{"method":"get"}},{"id":"/docs/api/merchant/2023-09-01#update-webhook-deprecated","title":"Update a webhook (Deprecated)","use":"a","href":"#update-webhook-deprecated","options":{"method":"put"}},{"id":"/docs/api/merchant/2023-09-01#delete-webhook-deprecated","title":"Delete a webhook (Deprecated)","use":"a","href":"#delete-webhook-deprecated","options":{"method":"delete"}},{"id":"/docs/api/merchant/2023-09-01#rotate-webhook-signing-secret-deprecated","title":"Rotate a webhook signing secret (Deprecated)","use":"a","href":"#rotate-webhook-signing-secret-deprecated","options":{"method":"post"}}]},{"id":"/docs/api/merchant/2023-09-01#tag-locations","title":"Locations","use":"a","href":"#tag-locations","items":[{"id":"/docs/api/merchant/2023-09-01#create-location","title":"Create a location","use":"a","href":"#create-location","options":{"method":"post"}},{"id":"/docs/api/merchant/2023-09-01#retrieve-location-list","title":"Retrieve location list","use":"a","href":"#retrieve-location-list","options":{"method":"get"}},{"id":"/docs/api/merchant/2023-09-01#retrieve-location","title":"Retrieve a location","use":"a","href":"#retrieve-location","options":{"method":"get"}},{"id":"/docs/api/merchant/2023-09-01#update-location","title":"Update a location","use":"a","href":"#update-location","options":{"method":"patch"}},{"id":"/docs/api/merchant/2023-09-01#delete-location","title":"Delete a location","use":"a","href":"#delete-location","options":{"method":"delete"}}]},{"id":"/docs/api/merchant/2023-09-01#tag-terminals","title":"Terminals","use":"a","href":"#tag-terminals","items":[{"id":"/docs/api/merchant/2023-09-01#retrieve-terminal-list","title":"Retrieve terminal list","use":"a","href":"#retrieve-terminal-list","options":{"method":"get"}}]},{"id":"/docs/api/merchant/2023-09-01#tag-payment-intents","title":"Payment intents","use":"a","href":"#tag-payment-intents","items":[{"id":"/docs/api/merchant/2023-09-01#create-payment-intent","title":"Create a payment intent","use":"a","href":"#create-payment-intent","options":{"method":"post"}},{"id":"/docs/api/merchant/2023-09-01#retrieve-payment-intent","title":"Retrieve a payment intent","use":"a","href":"#retrieve-payment-intent","options":{"method":"get"}},{"id":"/docs/api/merchant/2023-09-01#cancel-payment-intent","title":"Cancel a payment intent","use":"a","href":"#cancel-payment-intent","options":{"method":"post"}}]},{"id":"/docs/api/merchant/2023-09-01#tag-apple-pay-merchant-registration","title":"Apple Pay merchant registration","use":"a","href":"#tag-apple-pay-merchant-registration","items":[{"id":"/docs/api/merchant/2023-09-01#register-domain-apple-pay","title":"Register domain for Apple Pay","use":"a","href":"#register-domain-apple-pay","options":{"method":"post"}},{"id":"/docs/api/merchant/2023-09-01#unregister-domain-apple-pay","title":"Unregister domain for Apple Pay","use":"a","href":"#unregister-domain-apple-pay","options":{"method":"post"}}]},{"id":"/docs/api/merchant/2023-09-01#tag-other","title":"Other","use":"a","href":"#tag-other","items":[{"id":"/docs/api/merchant/2023-09-01#register-address-validation-endpoint","title":"Register address validation endpoint for Fast checkout","use":"a","href":"#register-address-validation-endpoint","options":{"method":"post"}},{"id":"/docs/api/merchant/2023-09-01#retrieve-synchronous-webhook-list","title":"Retrieve a synchronous webhook list","use":"a","href":"#retrieve-synchronous-webhook-list","options":{"method":"get"}},{"id":"/docs/api/merchant/2023-09-01#delete-synchronous-webhook","title":"Delete a synchronous webhook","use":"a","href":"#delete-synchronous-webhook","options":{"method":"delete"}}]}],"versions":[{"label":"2026-04-20","path":"/docs/api/merchant","latest":true},{"label":"2026-03-12","path":"/docs/api/merchant/2026-03-12","latest":false},{"label":"2025-12-04","path":"/docs/api/merchant/2025-12-04","latest":false},{"label":"2025-10-16","path":"/docs/api/merchant/2025-10-16","latest":false},{"label":"2024-09-01","path":"/docs/api/merchant/2024-09-01","latest":false},{"label":"2024-05-01","path":"/docs/api/merchant/2024-05-01","latest":false},{"label":"2023-09-01","path":"/docs/api/merchant/2023-09-01","latest":false},{"label":"Legacy","path":"/docs/api/merchant/Legacy","latest":false}]},"/docs/api/merchant/Legacy":{"items":[{"id":"/docs/api/merchant/Legacy#tag-orders","title":"Orders","use":"a","href":"#tag-orders","items":[{"id":"/docs/api/merchant/Legacy#create-order-deprecated","title":"Create an order (Deprecated)","use":"a","href":"#create-order-deprecated","options":{"method":"post"}},{"id":"/docs/api/merchant/Legacy#retrieve-order-list-deprecated","title":"Retrieve an order list (Deprecated)","use":"a","href":"#retrieve-order-list-deprecated","options":{"method":"get"}},{"id":"/docs/api/merchant/Legacy#retrieve-order-deprecated","title":"Retrieve an order (Deprecated)","use":"a","href":"#retrieve-order-deprecated","options":{"method":"get"}},{"id":"/docs/api/merchant/Legacy#update-order-deprecated","title":"Update an order (Deprecated)","use":"a","href":"#update-order-deprecated","options":{"method":"patch"}},{"id":"/docs/api/merchant/Legacy#capture-order-deprecated","title":"Capture an order (Deprecated)","use":"a","href":"#capture-order-deprecated","options":{"method":"post"}},{"id":"/docs/api/merchant/Legacy#cancel-order-deprecated","title":"Cancel an order (Deprecated)","use":"a","href":"#cancel-order-deprecated","options":{"method":"post"}},{"id":"/docs/api/merchant/Legacy#refund-order-deprecated","title":"Refund an order (Deprecated)","use":"a","href":"#refund-order-deprecated","options":{"method":"post"}},{"id":"/docs/api/merchant/Legacy#pay-order","title":"Pay for an order","use":"a","href":"#pay-order","options":{"method":"post"}},{"id":"/docs/api/merchant/Legacy#retrieve-payment-list","title":"Retrieve payment list of an order","use":"a","href":"#retrieve-payment-list","options":{"method":"get"}}]},{"id":"/docs/api/merchant/Legacy#tag-customers","title":"Customers","use":"a","href":"#tag-customers","items":[{"id":"/docs/api/merchant/Legacy#create-customer-deprecated","title":"Create a customer (Deprecated)","use":"a","href":"#create-customer-deprecated","options":{"method":"post"}},{"id":"/docs/api/merchant/Legacy#retrieve-all-customers-deprecated","title":"Retrieve a customer list (Deprecated)","use":"a","href":"#retrieve-all-customers-deprecated","options":{"method":"get"}},{"id":"/docs/api/merchant/Legacy#retrieve-customer-deprecated","title":"Retrieve a customer (Deprecated)","use":"a","href":"#retrieve-customer-deprecated","options":{"method":"get"}},{"id":"/docs/api/merchant/Legacy#update-customer-deprecated","title":"Update a customer (Deprecated)","use":"a","href":"#update-customer-deprecated","options":{"method":"patch"}},{"id":"/docs/api/merchant/Legacy#delete-customer-deprecated","title":"Delete a customer (Deprecated)","use":"a","href":"#delete-customer-deprecated","options":{"method":"delete"}},{"id":"/docs/api/merchant/Legacy#retrieve-all-payment-methods-deprecated","title":"Retrieve all payment methods of a customer (Deprecated)","use":"a","href":"#retrieve-all-payment-methods-deprecated","options":{"method":"get"}},{"id":"/docs/api/merchant/Legacy#retrieve-payment-method-deprecated","title":"Retrieve a customer's payment method (Deprecated)","use":"a","href":"#retrieve-payment-method-deprecated","options":{"method":"get"}},{"id":"/docs/api/merchant/Legacy#update-payment-method-deprecated","title":"Update a customer's payment method (Deprecated)","use":"a","href":"#update-payment-method-deprecated","options":{"method":"patch"}},{"id":"/docs/api/merchant/Legacy#delete-payment-method-deprecated","title":"Delete a customer's payment method (Deprecated)","use":"a","href":"#delete-payment-method-deprecated","options":{"method":"delete"}}]},{"id":"/docs/api/merchant/Legacy#tag-payments","title":"Payments","use":"a","href":"#tag-payments","items":[{"id":"/docs/api/merchant/Legacy#retrieve-payment-details","title":"Retrieve payment details","use":"a","href":"#retrieve-payment-details","options":{"method":"get"}}]},{"id":"/docs/api/merchant/Legacy#tag-report-runs","title":"Report runs","use":"a","href":"#tag-report-runs","items":[{"id":"/docs/api/merchant/Legacy#create-report-run","title":"Create a report run","use":"a","href":"#create-report-run","options":{"method":"post"}},{"id":"/docs/api/merchant/Legacy#retrieve-report-run","title":"Retrieve a report run","use":"a","href":"#retrieve-report-run","options":{"method":"get"}},{"id":"/docs/api/merchant/Legacy#download-report-file","title":"Download report file","use":"a","href":"#download-report-file","options":{"method":"get"}}]},{"id":"/docs/api/merchant/Legacy#tag-webhooks","title":"Webhooks","use":"a","href":"#tag-webhooks","items":[{"id":"/docs/api/merchant/Legacy#create-webhook-deprecated","title":"Create a webhook (Deprecated)","use":"a","href":"#create-webhook-deprecated","options":{"method":"post"}},{"id":"/docs/api/merchant/Legacy#retrieve-all-webhooks-deprecated","title":"Retrieve a webhook list (Deprecated)","use":"a","href":"#retrieve-all-webhooks-deprecated","options":{"method":"get"}},{"id":"/docs/api/merchant/Legacy#retrieve-webhook-deprecated","title":"Retrieve a webhook (Deprecated)","use":"a","href":"#retrieve-webhook-deprecated","options":{"method":"get"}},{"id":"/docs/api/merchant/Legacy#update-webhook-deprecated","title":"Update a webhook (Deprecated)","use":"a","href":"#update-webhook-deprecated","options":{"method":"put"}},{"id":"/docs/api/merchant/Legacy#delete-webhook-deprecated","title":"Delete a webhook (Deprecated)","use":"a","href":"#delete-webhook-deprecated","options":{"method":"delete"}},{"id":"/docs/api/merchant/Legacy#rotate-webhook-signing-secret-deprecated","title":"Rotate a webhook signing secret (Deprecated)","use":"a","href":"#rotate-webhook-signing-secret-deprecated","options":{"method":"post"}}]},{"id":"/docs/api/merchant/Legacy#tag-locations","title":"Locations","use":"a","href":"#tag-locations","items":[{"id":"/docs/api/merchant/Legacy#create-location","title":"Create a location","use":"a","href":"#create-location","options":{"method":"post"}},{"id":"/docs/api/merchant/Legacy#retrieve-location-list","title":"Retrieve location list","use":"a","href":"#retrieve-location-list","options":{"method":"get"}},{"id":"/docs/api/merchant/Legacy#retrieve-location","title":"Retrieve a location","use":"a","href":"#retrieve-location","options":{"method":"get"}},{"id":"/docs/api/merchant/Legacy#update-location","title":"Update a location","use":"a","href":"#update-location","options":{"method":"patch"}},{"id":"/docs/api/merchant/Legacy#delete-location","title":"Delete a location","use":"a","href":"#delete-location","options":{"method":"delete"}}]},{"id":"/docs/api/merchant/Legacy#tag-apple-pay-merchant-registration","title":"Apple Pay merchant registration","use":"a","href":"#tag-apple-pay-merchant-registration","items":[{"id":"/docs/api/merchant/Legacy#register-domain-apple-pay","title":"Register domain for Apple Pay","use":"a","href":"#register-domain-apple-pay","options":{"method":"post"}},{"id":"/docs/api/merchant/Legacy#unregister-domain-apple-pay","title":"Unregister domain for Apple Pay","use":"a","href":"#unregister-domain-apple-pay","options":{"method":"post"}}]},{"id":"/docs/api/merchant/Legacy#tag-other","title":"Other","use":"a","href":"#tag-other","items":[{"id":"/docs/api/merchant/Legacy#register-address-validation-endpoint","title":"Register address validation endpoint for Fast checkout","use":"a","href":"#register-address-validation-endpoint","options":{"method":"post"}},{"id":"/docs/api/merchant/Legacy#retrieve-synchronous-webhook-list","title":"Retrieve a synchronous webhook list","use":"a","href":"#retrieve-synchronous-webhook-list","options":{"method":"get"}},{"id":"/docs/api/merchant/Legacy#delete-synchronous-webhook","title":"Delete a synchronous webhook","use":"a","href":"#delete-synchronous-webhook","options":{"method":"delete"}}]}],"versions":[{"label":"2026-04-20","path":"/docs/api/merchant","latest":true},{"label":"2026-03-12","path":"/docs/api/merchant/2026-03-12","latest":false},{"label":"2025-12-04","path":"/docs/api/merchant/2025-12-04","latest":false},{"label":"2025-10-16","path":"/docs/api/merchant/2025-10-16","latest":false},{"label":"2024-09-01","path":"/docs/api/merchant/2024-09-01","latest":false},{"label":"2024-05-01","path":"/docs/api/merchant/2024-05-01","latest":false},{"label":"2023-09-01","path":"/docs/api/merchant/2023-09-01","latest":false},{"label":"Legacy","path":"/docs/api/merchant/Legacy","latest":false}]},"/docs/api/merchant":{"items":[{"id":"/docs/api/merchant#tag-orders","title":"Orders","use":"a","href":"#tag-orders","items":[{"id":"/docs/api/merchant#create-order","title":"Create an order","use":"a","href":"#create-order","options":{"method":"post"}},{"id":"/docs/api/merchant#retrieve-order-list","title":"Retrieve an order list","use":"a","href":"#retrieve-order-list","options":{"method":"get"}},{"id":"/docs/api/merchant#retrieve-order","title":"Retrieve an order","use":"a","href":"#retrieve-order","options":{"method":"get"}},{"id":"/docs/api/merchant#update-order","title":"Update an order","use":"a","href":"#update-order","options":{"method":"patch"}},{"id":"/docs/api/merchant#increment-authorisation","title":"Increment authorisation","use":"a","href":"#increment-authorisation","options":{"method":"post"}},{"id":"/docs/api/merchant#capture-order","title":"Capture an order","use":"a","href":"#capture-order","options":{"method":"post"}},{"id":"/docs/api/merchant#cancel-order","title":"Cancel an order","use":"a","href":"#cancel-order","options":{"method":"post"}},{"id":"/docs/api/merchant#refund-order","title":"Refund an order","use":"a","href":"#refund-order","options":{"method":"post"}},{"id":"/docs/api/merchant#pay-order","title":"Pay for an order","use":"a","href":"#pay-order","options":{"method":"post"}},{"id":"/docs/api/merchant#retrieve-payment-list","title":"Retrieve payment list of an order","use":"a","href":"#retrieve-payment-list","options":{"method":"get"}}]},{"id":"/docs/api/merchant#tag-customers","title":"Customers","use":"a","href":"#tag-customers","items":[{"id":"/docs/api/merchant#create-customer","title":"Create a customer","use":"a","href":"#create-customer","options":{"method":"post"}},{"id":"/docs/api/merchant#retrieve-customer-list","title":"Retrieve a customer list","use":"a","href":"#retrieve-customer-list","options":{"method":"get"}},{"id":"/docs/api/merchant#retrieve-customer","title":"Retrieve a customer","use":"a","href":"#retrieve-customer","options":{"method":"get"}},{"id":"/docs/api/merchant#update-customer","title":"Update a customer","use":"a","href":"#update-customer","options":{"method":"patch"}},{"id":"/docs/api/merchant#delete-customer","title":"Delete a customer","use":"a","href":"#delete-customer","options":{"method":"delete"}},{"id":"/docs/api/merchant#retrieve-payment-method-list","title":"Retrieve payment method list of a customer","use":"a","href":"#retrieve-payment-method-list","options":{"method":"get"}},{"id":"/docs/api/merchant#retrieve-payment-method","title":"Retrieve a customer's payment method","use":"a","href":"#retrieve-payment-method","options":{"method":"get"}},{"id":"/docs/api/merchant#update-payment-method","title":"Update a customer's payment method","use":"a","href":"#update-payment-method","options":{"method":"patch"}},{"id":"/docs/api/merchant#delete-payment-method","title":"Delete a customer's payment method","use":"a","href":"#delete-payment-method","options":{"method":"delete"}}]},{"id":"/docs/api/merchant#tag-payments","title":"Payments","use":"a","href":"#tag-payments","items":[{"id":"/docs/api/merchant#retrieve-payment-details","title":"Retrieve payment details","use":"a","href":"#retrieve-payment-details","options":{"method":"get"}}]},{"id":"/docs/api/merchant#tag-subscriptions","title":"Subscriptions","use":"a","href":"#tag-subscriptions","items":[{"id":"/docs/api/merchant#create-subscription-plan","title":"Create a subscription plan","use":"a","href":"#create-subscription-plan","options":{"method":"post"}},{"id":"/docs/api/merchant#retrieve-subscription-plan-list","title":"Retrieve a subscription plan list","use":"a","href":"#retrieve-subscription-plan-list","options":{"method":"get"}},{"id":"/docs/api/merchant#retrieve-subscription-plan","title":"Retrieve a subscription plan","use":"a","href":"#retrieve-subscription-plan","options":{"method":"get"}},{"id":"/docs/api/merchant#create-subscription","title":"Create a subscription","use":"a","href":"#create-subscription","options":{"method":"post"}},{"id":"/docs/api/merchant#retrieve-subscription-list","title":"Retrieve a subscription list","use":"a","href":"#retrieve-subscription-list","options":{"method":"get"}},{"id":"/docs/api/merchant#retrieve-subscription","title":"Retrieve a subscription","use":"a","href":"#retrieve-subscription","options":{"method":"get"}},{"id":"/docs/api/merchant#update-subscription","title":"Update a subscription","use":"a","href":"#update-subscription","options":{"method":"patch"}},{"id":"/docs/api/merchant#change-subscription-plan","title":"Change a subscription plan","use":"a","href":"#change-subscription-plan","options":{"method":"post"}},{"id":"/docs/api/merchant#update-subscription-renewal-date","title":"Update a subscription renewal date","use":"a","href":"#update-subscription-renewal-date","options":{"method":"post"}},{"id":"/docs/api/merchant#cancel-subscription","title":"Cancel a subscription","use":"a","href":"#cancel-subscription","options":{"method":"post"}},{"id":"/docs/api/merchant#retrieve-subscription-cycle-list","title":"Retrieve a subscription cycle list","use":"a","href":"#retrieve-subscription-cycle-list","options":{"method":"get"}},{"id":"/docs/api/merchant#retrieve-subscription-cycle","title":"Retrieve a subscription cycle","use":"a","href":"#retrieve-subscription-cycle","options":{"method":"get"}},{"id":"/docs/api/merchant#create-subscription-usage","title":"Create a subscription usage","use":"a","href":"#create-subscription-usage","options":{"method":"post"}},{"id":"/docs/api/merchant#retrieve-subscription-usage-list","title":"Retrieve a subscription usage list","use":"a","href":"#retrieve-subscription-usage-list","options":{"method":"get"}},{"id":"/docs/api/merchant#retrieve-subscription-usage","title":"Retrieve a subscription usage","use":"a","href":"#retrieve-subscription-usage","options":{"method":"get"}},{"id":"/docs/api/merchant#update-subscription-usage","title":"Update a subscription usage","use":"a","href":"#update-subscription-usage","options":{"method":"patch"}},{"id":"/docs/api/merchant#delete-subscription-usage","title":"Delete a subscription usage","use":"a","href":"#delete-subscription-usage","options":{"method":"delete"}}]},{"id":"/docs/api/merchant#tag-payouts","title":"Payouts","use":"a","href":"#tag-payouts","items":[{"id":"/docs/api/merchant#retrieve-payout-list","title":"Retrieve a payout list","use":"a","href":"#retrieve-payout-list","options":{"method":"get"}},{"id":"/docs/api/merchant#retrieve-payout","title":"Retrieve a payout","use":"a","href":"#retrieve-payout","options":{"method":"get"}}]},{"id":"/docs/api/merchant#tag-disputes","title":"Disputes","use":"a","href":"#tag-disputes","items":[{"id":"/docs/api/merchant#retrieve-dispute-list","title":"Retrieve a dispute list","use":"a","href":"#retrieve-dispute-list","options":{"method":"get"}},{"id":"/docs/api/merchant#retrieve-dispute","title":"Retrieve a dispute","use":"a","href":"#retrieve-dispute","options":{"method":"get"}},{"id":"/docs/api/merchant#accept-dispute","title":"Accept a dispute","use":"a","href":"#accept-dispute","options":{"method":"post"}},{"id":"/docs/api/merchant#upload-dispute-evidence","title":"Upload evidence for a dispute","use":"a","href":"#upload-dispute-evidence","options":{"method":"post"}},{"id":"/docs/api/merchant#challenge-dispute","title":"Challenge a dispute","use":"a","href":"#challenge-dispute","options":{"method":"post"}}]},{"id":"/docs/api/merchant#tag-report-runs","title":"Report runs","use":"a","href":"#tag-report-runs","items":[{"id":"/docs/api/merchant#create-report-run","title":"Create a report run","use":"a","href":"#create-report-run","options":{"method":"post"}},{"id":"/docs/api/merchant#retrieve-report-run","title":"Retrieve a report run","use":"a","href":"#retrieve-report-run","options":{"method":"get"}},{"id":"/docs/api/merchant#download-report-file","title":"Download report file","use":"a","href":"#download-report-file","options":{"method":"get"}}]},{"id":"/docs/api/merchant#tag-webhooks","title":"Webhooks","use":"a","href":"#tag-webhooks","items":[{"id":"/docs/api/merchant#create-webhook","title":"Create a webhook","use":"a","href":"#create-webhook","options":{"method":"post"}},{"id":"/docs/api/merchant#retrieve-webhook-list","title":"Retrieve a webhook list","use":"a","href":"#retrieve-webhook-list","options":{"method":"get"}},{"id":"/docs/api/merchant#retrieve-webhook","title":"Retrieve a webhook","use":"a","href":"#retrieve-webhook","options":{"method":"get"}},{"id":"/docs/api/merchant#update-webhook","title":"Update a webhook","use":"a","href":"#update-webhook","options":{"method":"patch"}},{"id":"/docs/api/merchant#delete-webhook","title":"Delete a webhook","use":"a","href":"#delete-webhook","options":{"method":"delete"}},{"id":"/docs/api/merchant#rotate-webhook-signing-secret","title":"Rotate a webhook signing secret","use":"a","href":"#rotate-webhook-signing-secret","options":{"method":"post"}}]},{"id":"/docs/api/merchant#tag-locations","title":"Locations","use":"a","href":"#tag-locations","items":[{"id":"/docs/api/merchant#create-location","title":"Create a location","use":"a","href":"#create-location","options":{"method":"post"}},{"id":"/docs/api/merchant#retrieve-location-list","title":"Retrieve location list","use":"a","href":"#retrieve-location-list","options":{"method":"get"}},{"id":"/docs/api/merchant#retrieve-location","title":"Retrieve a location","use":"a","href":"#retrieve-location","options":{"method":"get"}},{"id":"/docs/api/merchant#update-location","title":"Update a location","use":"a","href":"#update-location","options":{"method":"patch"}},{"id":"/docs/api/merchant#delete-location","title":"Delete a location","use":"a","href":"#delete-location","options":{"method":"delete"}}]},{"id":"/docs/api/merchant#tag-terminals","title":"Terminals","use":"a","href":"#tag-terminals","items":[{"id":"/docs/api/merchant#retrieve-terminal-list","title":"Retrieve terminal list","use":"a","href":"#retrieve-terminal-list","options":{"method":"get"}}]},{"id":"/docs/api/merchant#tag-payment-intents","title":"Payment intents","use":"a","href":"#tag-payment-intents","items":[{"id":"/docs/api/merchant#create-payment-intent","title":"Create a payment intent","use":"a","href":"#create-payment-intent","options":{"method":"post"}},{"id":"/docs/api/merchant#retrieve-payment-intent","title":"Retrieve a payment intent","use":"a","href":"#retrieve-payment-intent","options":{"method":"get"}},{"id":"/docs/api/merchant#cancel-payment-intent","title":"Cancel a payment intent","use":"a","href":"#cancel-payment-intent","options":{"method":"post"}}]},{"id":"/docs/api/merchant#tag-apple-pay-merchant-registration","title":"Apple Pay merchant registration","use":"a","href":"#tag-apple-pay-merchant-registration","items":[{"id":"/docs/api/merchant#register-domain-apple-pay","title":"Register domain for Apple Pay","use":"a","href":"#register-domain-apple-pay","options":{"method":"post"}},{"id":"/docs/api/merchant#unregister-domain-apple-pay","title":"Unregister domain for Apple Pay","use":"a","href":"#unregister-domain-apple-pay","options":{"method":"post"}}]},{"id":"/docs/api/merchant#tag-other","title":"Other","use":"a","href":"#tag-other","items":[{"id":"/docs/api/merchant#register-address-validation-endpoint","title":"Register address validation endpoint for Fast checkout","use":"a","href":"#register-address-validation-endpoint","options":{"method":"post"}},{"id":"/docs/api/merchant#retrieve-synchronous-webhook-list","title":"Retrieve a synchronous webhook list","use":"a","href":"#retrieve-synchronous-webhook-list","options":{"method":"get"}},{"id":"/docs/api/merchant#delete-synchronous-webhook","title":"Delete a synchronous webhook","use":"a","href":"#delete-synchronous-webhook","options":{"method":"delete"}}]}],"versions":[{"label":"2026-04-20","path":"/docs/api/merchant","latest":true},{"label":"2026-03-12","path":"/docs/api/merchant/2026-03-12","latest":false},{"label":"2025-12-04","path":"/docs/api/merchant/2025-12-04","latest":false},{"label":"2025-10-16","path":"/docs/api/merchant/2025-10-16","latest":false},{"label":"2024-09-01","path":"/docs/api/merchant/2024-09-01","latest":false},{"label":"2024-05-01","path":"/docs/api/merchant/2024-05-01","latest":false},{"label":"2023-09-01","path":"/docs/api/merchant/2023-09-01","latest":false},{"label":"Legacy","path":"/docs/api/merchant/Legacy","latest":false}]},"/docs/api/open-banking":{"items":[{"id":"/docs/api/open-banking#tag-applications","title":"Applications","use":"a","href":"#tag-applications","items":[{"id":"/docs/api/open-banking#get-distinguished-name","title":"Get a distinguished name (DN)","use":"a","href":"#get-distinguished-name","options":{"method":"get"}},{"id":"/docs/api/open-banking#register-application","title":"Register an application","use":"a","href":"#register-application","options":{"method":"post"}},{"id":"/docs/api/open-banking#get-application","title":"Get an application","use":"a","href":"#get-application","options":{"method":"get"}},{"id":"/docs/api/open-banking#update-application","title":"Update an application","use":"a","href":"#update-application","options":{"method":"put"}},{"id":"/docs/api/open-banking#delete-application","title":"Delete an application","use":"a","href":"#delete-application","options":{"method":"delete"}}]},{"id":"/docs/api/open-banking#tag-accounts","title":"Accounts","use":"a","href":"#tag-accounts","items":[{"id":"/docs/api/open-banking#create-account-access-consents","title":"Create an account access consent","use":"a","href":"#create-account-access-consents","options":{"method":"post"}},{"id":"/docs/api/open-banking#get-account-access-consents-consent-id","title":"Retrieve an account access consent","use":"a","href":"#get-account-access-consents-consent-id","options":{"method":"get"}},{"id":"/docs/api/open-banking#delete-account-access-consents-consent-id","title":"Delete an account access consent","use":"a","href":"#delete-account-access-consents-consent-id","options":{"method":"delete"}},{"id":"/docs/api/open-banking#get-accounts","title":"Retrieve all accounts","use":"a","href":"#get-accounts","options":{"method":"get"}},{"id":"/docs/api/open-banking#get-accounts-account-id","title":"Retrieve an account","use":"a","href":"#get-accounts-account-id","options":{"method":"get"}},{"id":"/docs/api/open-banking#get-accounts-account-id-balances","title":"Retrieve an account balance","use":"a","href":"#get-accounts-account-id-balances","options":{"method":"get"}},{"id":"/docs/api/open-banking#get-accounts-account-id-beneficiaries","title":"Retrieve all account's beneficiaries","use":"a","href":"#get-accounts-account-id-beneficiaries","options":{"method":"get"}}]},{"id":"/docs/api/open-banking#tag-transactions","title":"Transactions","use":"a","href":"#tag-transactions","items":[{"id":"/docs/api/open-banking#get-accounts-account-id-direct-debits","title":"Retrieve all account's direct debits","use":"a","href":"#get-accounts-account-id-direct-debits","options":{"method":"get"}},{"id":"/docs/api/open-banking#get-accounts-account-id-standing-orders","title":"Retrieve all account's standing orders","use":"a","href":"#get-accounts-account-id-standing-orders","options":{"method":"get"}},{"id":"/docs/api/open-banking#get-accounts-account-id-transactions","title":"Retrieve all transactions","use":"a","href":"#get-accounts-account-id-transactions","options":{"method":"get"}}]},{"id":"/docs/api/open-banking#tag-domestic-payment","title":"Domestic payment","use":"a","href":"#tag-domestic-payment","items":[{"id":"/docs/api/open-banking#create-domestic-payment-consents","title":"Create a domestic payment consent","use":"a","href":"#create-domestic-payment-consents","options":{"method":"post"}},{"id":"/docs/api/open-banking#get-domestic-payment-consents-consent-id","title":"Retrieve a domestic payment consent","use":"a","href":"#get-domestic-payment-consents-consent-id","options":{"method":"get"}},{"id":"/docs/api/open-banking#get-domestic-payment-consents-consent-id-funds-confirmation","title":"Get funds confirmation for a domestic payment consent","use":"a","href":"#get-domestic-payment-consents-consent-id-funds-confirmation","options":{"method":"get"}},{"id":"/docs/api/open-banking#create-domestic-payments","title":"Create a domestic payment","use":"a","href":"#create-domestic-payments","options":{"method":"post"}},{"id":"/docs/api/open-banking#get-domestic-payments-domestic-payment-id","title":"Retrieve a domestic payment","use":"a","href":"#get-domestic-payments-domestic-payment-id","options":{"method":"get"}}]},{"id":"/docs/api/open-banking#tag-domestic-scheduled-payment","title":"Domestic scheduled payment","use":"a","href":"#tag-domestic-scheduled-payment","items":[{"id":"/docs/api/open-banking#create-domestic-scheduled-payment-consents","title":"Create a domestic scheduled payment consent","use":"a","href":"#create-domestic-scheduled-payment-consents","options":{"method":"post"}},{"id":"/docs/api/open-banking#get-domestic-scheduled-payment-consents-consent-id","title":"Retrieve a domestic scheduled payment consent","use":"a","href":"#get-domestic-scheduled-payment-consents-consent-id","options":{"method":"get"}},{"id":"/docs/api/open-banking#create-domestic-scheduled-payments","title":"Create a domestic scheduled payment","use":"a","href":"#create-domestic-scheduled-payments","options":{"method":"post"}},{"id":"/docs/api/open-banking#get-domestic-scheduled-payments-domestic-scheduled-payment-id","title":"Retrieve a domestic scheduled payment","use":"a","href":"#get-domestic-scheduled-payments-domestic-scheduled-payment-id","options":{"method":"get"}}]},{"id":"/docs/api/open-banking#tag-domestic-standing-order","title":"Domestic standing order","use":"a","href":"#tag-domestic-standing-order","items":[{"id":"/docs/api/open-banking#create-domestic-standing-order-consents","title":"Create a domestic standing order consent","use":"a","href":"#create-domestic-standing-order-consents","options":{"method":"post"}},{"id":"/docs/api/open-banking#get-domestic-standing-order-consents-consent-id","title":"Retrieve a domestic standing order consent","use":"a","href":"#get-domestic-standing-order-consents-consent-id","options":{"method":"get"}},{"id":"/docs/api/open-banking#create-domestic-standing-orders","title":"Create a domestic standing order","use":"a","href":"#create-domestic-standing-orders","options":{"method":"post"}},{"id":"/docs/api/open-banking#get-domestic-standing-orders-domestic-standing-order-id","title":"Retrieve a domestic standing order","use":"a","href":"#get-domestic-standing-orders-domestic-standing-order-id","options":{"method":"get"}}]},{"id":"/docs/api/open-banking#tag-file-payment","title":"File payment","use":"a","href":"#tag-file-payment","items":[{"id":"/docs/api/open-banking#create-file-payment-consents","title":"Create a file payment consent","use":"a","href":"#create-file-payment-consents","options":{"method":"post"}},{"id":"/docs/api/open-banking#get-file-payment-consents-consent-id-file","title":"Retrieve an uploaded payment file","use":"a","href":"#get-file-payment-consents-consent-id-file","options":{"method":"get"}},{"id":"/docs/api/open-banking#create-file-payment-consents-consent-id-file","title":"Upload a payment file","use":"a","href":"#create-file-payment-consents-consent-id-file","options":{"method":"post"}},{"id":"/docs/api/open-banking#create-file-payments","title":"Create a file payment","use":"a","href":"#create-file-payments","options":{"method":"post"}},{"id":"/docs/api/open-banking#get-file-payments-file-payment-id","title":"Retrieve a file payment","use":"a","href":"#get-file-payments-file-payment-id","options":{"method":"get"}},{"id":"/docs/api/open-banking#get-file-payments-file-payment-id-report-file","title":"Retrieve all payments of a file payment","use":"a","href":"#get-file-payments-file-payment-id-report-file","options":{"method":"get"}}]},{"id":"/docs/api/open-banking#tag-international-payment","title":"International payment","use":"a","href":"#tag-international-payment","items":[{"id":"/docs/api/open-banking#create-international-payment-consents","title":"Create an international payment consent","use":"a","href":"#create-international-payment-consents","options":{"method":"post"}},{"id":"/docs/api/open-banking#get-international-payment-consents-consent-id","title":"Retrieve an international payment consent","use":"a","href":"#get-international-payment-consents-consent-id","options":{"method":"get"}},{"id":"/docs/api/open-banking#get-international-payment-consents-consent-id-funds-confirmation","title":"Get funds confirmation for an international payment consent","use":"a","href":"#get-international-payment-consents-consent-id-funds-confirmation","options":{"method":"get"}},{"id":"/docs/api/open-banking#create-international-payments","title":"Create an international payment","use":"a","href":"#create-international-payments","options":{"method":"post"}},{"id":"/docs/api/open-banking#get-international-payments-international-payment-id","title":"Retrieve an international payment","use":"a","href":"#get-international-payments-international-payment-id","options":{"method":"get"}}]},{"id":"/docs/api/open-banking#tag-international-scheduled-payment","title":"International scheduled payment","use":"a","href":"#tag-international-scheduled-payment","items":[{"id":"/docs/api/open-banking#create-international-scheduled-payment-consents","title":"Create an international scheduled payment consent","use":"a","href":"#create-international-scheduled-payment-consents","options":{"method":"post"}},{"id":"/docs/api/open-banking#get-international-scheduled-payment-consents-consent-id","title":"Retrieve an international scheduled payment consent","use":"a","href":"#get-international-scheduled-payment-consents-consent-id","options":{"method":"get"}},{"id":"/docs/api/open-banking#get-international-scheduled-payment-consents-consent-id-funds-confirmation","title":"Get funds confirmation for an international scheduled payment","use":"a","href":"#get-international-scheduled-payment-consents-consent-id-funds-confirmation","options":{"method":"get"}},{"id":"/docs/api/open-banking#create-international-scheduled-payments","title":"Create an international scheduled payment","use":"a","href":"#create-international-scheduled-payments","options":{"method":"post"}},{"id":"/docs/api/open-banking#get-international-scheduled-payments-international-scheduled-payment-id","title":"Retrieve an international scheduled payment","use":"a","href":"#get-international-scheduled-payments-international-scheduled-payment-id","options":{"method":"get"}}]},{"id":"/docs/api/open-banking#tag-international-standing-order","title":"International standing order","use":"a","href":"#tag-international-standing-order","items":[{"id":"/docs/api/open-banking#create-international-standing-order-consents","title":"Create an international standing order consent","use":"a","href":"#create-international-standing-order-consents","options":{"method":"post"}},{"id":"/docs/api/open-banking#get-international-standing-order-consents-consent-id","title":"Retrieve an international standing order consent","use":"a","href":"#get-international-standing-order-consents-consent-id","options":{"method":"get"}},{"id":"/docs/api/open-banking#create-international-standing-orders","title":"Create an international standing order","use":"a","href":"#create-international-standing-orders","options":{"method":"post"}},{"id":"/docs/api/open-banking#get-international-standing-orders-international-standing-order-id","title":"Retrieve an international standing order","use":"a","href":"#get-international-standing-orders-international-standing-order-id","options":{"method":"get"}}]},{"id":"/docs/api/open-banking#tag-draft-payment","title":"Draft payment","use":"a","href":"#tag-draft-payment","items":[{"id":"/docs/api/open-banking#list-draft-payment","title":"List draft payments","use":"a","href":"#list-draft-payment","options":{"method":"get"}},{"id":"/docs/api/open-banking#create-draft-payment","title":"Create a draft payment","use":"a","href":"#create-draft-payment","options":{"method":"post"}},{"id":"/docs/api/open-banking#delete-draft-payment-transfer","title":"Delete a draft payment transfer","use":"a","href":"#delete-draft-payment-transfer","options":{"method":"delete"}},{"id":"/docs/api/open-banking#find-draft-payment","title":"Retrieve a draft payment","use":"a","href":"#find-draft-payment","options":{"method":"get"}},{"id":"/docs/api/open-banking#delete-draft-payment","title":"Delete a draft payment","use":"a","href":"#delete-draft-payment","options":{"method":"delete"}}]},{"id":"/docs/api/open-banking#tag-untagged","title":"Untagged","use":"a","href":"#tag-untagged","items":[{"id":"/docs/api/open-banking#get-file-payment-consents-consent-id","title":"Retrieve a file payment consent","use":"a","href":"#get-file-payment-consents-consent-id","options":{"method":"get"}}]}],"versions":"$undefined"},"/docs/api/revolut-wallet-callbacks":{"items":[{"id":"/docs/api/revolut-wallet-callbacks#tag-transaction-outcomes","title":"Transaction outcomes","use":"a","href":"#tag-transaction-outcomes","items":[{"id":"/docs/api/revolut-wallet-callbacks#search-transaction-outcomes","title":"Fetch transaction outcomes for a transaction","use":"a","href":"#search-transaction-outcomes","options":{"method":"post"}}]},{"id":"/docs/api/revolut-wallet-callbacks#tag-passes","title":"Passes","use":"a","href":"#tag-passes","items":[{"id":"/docs/api/revolut-wallet-callbacks#fetch-pass","title":"Retrieve a pass","use":"a","href":"#fetch-pass","options":{"method":"get"}}]}],"versions":"$undefined"},"/docs/api/revolut-wallet-partner":{"items":[{"id":"/docs/api/revolut-wallet-partner#tag-passes","title":"Passes","use":"a","href":"#tag-passes","items":[{"id":"/docs/api/revolut-wallet-partner#create-pass","title":"Create a pass","use":"a","href":"#create-pass","options":{"method":"post"}},{"id":"/docs/api/revolut-wallet-partner#push-pass-update","title":"Update a pass","use":"a","href":"#push-pass-update","options":{"method":"put"}}]}],"versions":"$undefined"},"/docs/api/revolut-x-crypto-exchange":{"items":[{"id":"/docs/api/revolut-x-crypto-exchange#tag-balance","title":"Balance","use":"a","href":"#tag-balance","items":[{"id":"/docs/api/revolut-x-crypto-exchange#get-all-balances","title":"Get all balances","use":"a","href":"#get-all-balances","options":{"method":"get"}}]},{"id":"/docs/api/revolut-x-crypto-exchange#tag-configuration","title":"Configuration","use":"a","href":"#tag-configuration","items":[{"id":"/docs/api/revolut-x-crypto-exchange#get-all-currencies","title":"Get all currencies","use":"a","href":"#get-all-currencies","options":{"method":"get"}},{"id":"/docs/api/revolut-x-crypto-exchange#get-all-currency-pairs","title":"Get all currency pairs","use":"a","href":"#get-all-currency-pairs","options":{"method":"get"}},{"id":"/docs/api/revolut-x-crypto-exchange#get-all-public-currencies","title":"Get all currencies public","use":"a","href":"#get-all-public-currencies","options":{"method":"get"}},{"id":"/docs/api/revolut-x-crypto-exchange#get-all-public-currency-pairs","title":"Get all currency pairs public","use":"a","href":"#get-all-public-currency-pairs","options":{"method":"get"}}]},{"id":"/docs/api/revolut-x-crypto-exchange#tag-public-market-data","title":"Public Market Data","use":"a","href":"#tag-public-market-data","items":[{"id":"/docs/api/revolut-x-crypto-exchange#get-last-trades","title":"Get last trades","use":"a","href":"#get-last-trades","options":{"method":"get"}},{"id":"/docs/api/revolut-x-crypto-exchange#get-all-trades-public","title":"Get public trades (market history)","use":"a","href":"#get-all-trades-public","options":{"method":"get"}},{"id":"/docs/api/revolut-x-crypto-exchange#get-public-order-book","title":"Get order book","use":"a","href":"#get-public-order-book","options":{"method":"get"}},{"id":"/docs/api/revolut-x-crypto-exchange#get-public-order-book-v2","title":"Get order book V2","use":"a","href":"#get-public-order-book-v2","options":{"method":"get"}},{"id":"/docs/api/revolut-x-crypto-exchange#get-public-candles","title":"Get public historical OHLCV candles","use":"a","href":"#get-public-candles","options":{"method":"get"}},{"id":"/docs/api/revolut-x-crypto-exchange#get-public-tickers","title":"Get public tickers","use":"a","href":"#get-public-tickers","options":{"method":"get"}}]},{"id":"/docs/api/revolut-x-crypto-exchange#tag-orders","title":"Orders","use":"a","href":"#tag-orders","items":[{"id":"/docs/api/revolut-x-crypto-exchange#place-order","title":"Place order","use":"a","href":"#place-order","options":{"method":"post"}},{"id":"/docs/api/revolut-x-crypto-exchange#cancel-all-orders","title":"Cancel all active orders","use":"a","href":"#cancel-all-orders","options":{"method":"delete"}},{"id":"/docs/api/revolut-x-crypto-exchange#get-active-orders","title":"Get active orders","use":"a","href":"#get-active-orders","options":{"method":"get"}},{"id":"/docs/api/revolut-x-crypto-exchange#get-historical-orders","title":"Get historical orders","use":"a","href":"#get-historical-orders","options":{"method":"get"}},{"id":"/docs/api/revolut-x-crypto-exchange#get-order","title":"Get order by ID","use":"a","href":"#get-order","options":{"method":"get"}},{"id":"/docs/api/revolut-x-crypto-exchange#cancel-order","title":"Cancel order by ID","use":"a","href":"#cancel-order","options":{"method":"delete"}},{"id":"/docs/api/revolut-x-crypto-exchange#replace-order","title":"Replace order","use":"a","href":"#replace-order","options":{"method":"put"}},{"id":"/docs/api/revolut-x-crypto-exchange#get-order-fills","title":"Get fills of order by ID","use":"a","href":"#get-order-fills","options":{"method":"get"}}]},{"id":"/docs/api/revolut-x-crypto-exchange#tag-trades","title":"Trades","use":"a","href":"#tag-trades","items":[{"id":"/docs/api/revolut-x-crypto-exchange#get-all-trades","title":"Get public trades for a specific symbol (market history)","use":"a","href":"#get-all-trades","options":{"method":"get"}},{"id":"/docs/api/revolut-x-crypto-exchange#get-private-trades","title":"Get client trades (associated with the provided API key) for a specific symbol","use":"a","href":"#get-private-trades","options":{"method":"get"}}]},{"id":"/docs/api/revolut-x-crypto-exchange#tag-market-data","title":"Market Data","use":"a","href":"#tag-market-data","items":[{"id":"/docs/api/revolut-x-crypto-exchange#get-order-book","title":"Get order book snapshot","use":"a","href":"#get-order-book","options":{"method":"get"}},{"id":"/docs/api/revolut-x-crypto-exchange#get-candles","title":"Get historical OHLCV candles","use":"a","href":"#get-candles","options":{"method":"get"}},{"id":"/docs/api/revolut-x-crypto-exchange#get-ticker","title":"Get all tickers","use":"a","href":"#get-ticker","options":{"method":"get"}}]}],"versions":"$undefined"}},"alphaByPath":{}},"children":["$undefined","$L4","$L5"]}]}]}]]}]} 5:["$","footer",null,{"className":"_19k157u0","children":["$","div",null,{"className":"_19k157u1","children":[["$","div",null,{"className":"_19k157u2","children":[["$","img",null,{"data-revpress-display":"light","className":"_19k157u8","src":"https://storage.googleapis.com/revolut-prod-apps_cdn/Brand/Retail/Logos/Wordmark/Revolut_Black.svg","alt":"Revolut"}],["$","img",null,{"data-revpress-display":"dark","className":"_19k157u8","src":"https://storage.googleapis.com/revolut-prod-apps_cdn/Brand/Retail/Logos/Wordmark/Revolut_White.svg","alt":"Revolut"}],[["$","div","0",{"className":"_19k157u4","children":[["$","span",null,{"className":"_19k157u3","children":"Company and products"}],[["$","$L3","0",{"className":"_19k157u5","to":"https://revolut.com/","children":"Discover Revolut"}],["$","$L3","1",{"className":"_19k157u5","to":"https://www.revolut.com/careers/","children":"Join the team!"}],["$","$L3","2",{"className":"_19k157u5","to":"mailto:api-requests@revolut.com","children":"Email us for API support"}]]]}],["$","div","1",{"className":"_19k157u4","children":[["$","span",null,{"className":"_19k157u3","children":"Build Banking Apps"}],[["$","$L3","0",{"className":"_19k157u5","to":"/docs/guides/build-banking-apps/introduction-to-the-open-banking-api/introduction","children":"Documentation"}],["$","$L3","1",{"className":"_19k157u5","to":"/docs/api/open-banking","children":"Open Banking API"}],["$","$L3","2",{"className":"_19k157u5","to":"/docs/guides/build-banking-apps/api-metrics","children":"API Status"}],["$","$L3","3",{"className":"_19k157u5","to":"https://developer.revolut.com/portal/signup","children":"Developer Portal"}],["$","$L3","4",{"className":"_19k157u5","to":"mailto:api-requests@revolut.com","children":"Request Sandbox access"}]]]}],["$","div","2",{"className":"_19k157u4","children":[["$","span",null,{"className":"_19k157u3","children":"Manage Accounts"}],[["$","$L3","0",{"className":"_19k157u5","to":"/docs/guides/manage-accounts/introduction","children":"Documentation"}],["$","$L3","1",{"className":"_19k157u5","to":"/docs/api/business","children":"Business API"}]]]}],["$","div","3",{"className":"_19k157u4","children":[["$","span",null,{"className":"_19k157u3","children":"Accept Payments"}],[["$","$L3","0",{"className":"_19k157u5","to":"/docs/guides/merchant/introduction","children":"Documentation"}],["$","$L3","1",{"className":"_19k157u5","to":"/docs/api/merchant","children":"Merchant API"}],["$","$L3","2",{"className":"_19k157u5","to":"/docs/sdks/merchant-web-sdk/introduction","children":"Merchant Web SDKs"}],["$","$L3","3",{"className":"_19k157u5","to":"/docs/sdks/merchant-ios-sdk/introduction","children":"Merchant iOS SDKs"}],["$","$L3","4",{"className":"_19k157u5","to":"/docs/sdks/merchant-android-sdk/introduction","children":"Merchant Android SDKs"}]]]}],["$","div","4",{"className":"_19k157u4","children":[["$","span",null,{"className":"_19k157u3","children":"In-person Payments"}],[["$","$L3","0",{"className":"_19k157u5","to":"/docs/guides/merchant/accept-payments/in-person-payments/introduction","children":"Documentation"}],["$","$L3","1",{"className":"_19k157u5","to":"/docs/guides/merchant/accept-payments/in-person-payments/pos/introduction","children":"Revolut POS"}],["$","$L3","2",{"className":"_19k157u5","to":"https://apps.apple.com/gb/app/revolut-pos/id1604861598","children":"Download the Revolut POS app"}],["$","$L3","3",{"className":"_19k157u5","to":"/docs/guides/merchant/accept-payments/in-person-payments/reader/introduction","children":"Revolut Reader"}],["$","$L3","4",{"className":"_19k157u5","to":"/docs/guides/merchant/accept-payments/in-person-payments/terminal/introduction","children":"Revolut Terminal"}]]]}]]]}],["$","div",null,{"data-has-links":true,"className":"_19k157u6","children":[["$","p",null,{"className":"_19k157u7","children":["© Revolut Ltd ",2026]}],[["$","p","0",{"className":"_19k157u7","children":"If you would like to find out more about which Revolut entity you receive services from, or if you have any other questions, please reach out to us via the in-app chat in the Revolut app. Revolut Ltd (No. 08804411) is authorised by the Financial Conduct Authority under the Electronic Money Regulations 2011 (Firm Reference 900562). Registered address: 30 South Colonnade, Canary Wharf, London, England, E14 5HX. Insurance related-products are arranged by Revolut Travel Ltd which is authorised by the Financial Conduct Authority to undertake insurance distribution activities (FCA No: 780586) and by Revolut Ltd, an Appointed Representative of Revolut Travel Ltd in relation to insurance distribution activities. Trading and investment products are provided by Revolut Trading Ltd (No. 832790) is wholly owned subsidiary of Revolut Ltd and is an appointed representative of Resolution Compliance Ltd which is authorised and regulated by the Financial Conduct Authority."}],"$L6","$L7"]]}]]}]}] 6:["$","p","1",{"className":"_19k157u7","children":"We are also registered with the Financial Conduct Authority to offer cryptocurrency services under the Money Laundering, Terrorist Financing and Transfer of Funds (Information on the Payer) Regulations 2017."}] 7:["$","p","2",{"className":"_19k157u7","children":"Revolut's commodities service is not regulated by the FCA."}] 8:T882,Welcome to the Revolut Merchant API - your solution to managing the core aspects of e-commerce and accepting online payments. Whether you're a startup, a growing business, or an established enterprise in the e-commerce industry, our API helps you streamline your operations. As a Revolut Business customer with a Merchant Account, you can use the Merchant API to leverage the following features: - [Order management](https://developer.revolut.com/docs/api/merchant/2025-10-16#tag-orders) - [Customer management](https://developer.revolut.com/docs/api/merchant/2025-10-16#tag-customers) - [Payment management](https://developer.revolut.com/docs/api/merchant/2025-10-16#tag-payments) - [Subscription management](https://developer.revolut.com/docs/api/merchant/2025-10-16#tag-subscriptions) - [Payout management](https://developer.revolut.com/docs/api/merchant/2025-10-16#tag-payouts) - [Dispute management](https://developer.revolut.com/docs/api/merchant/2025-10-16#tag-disputes) - [Reporting analytics](https://developer.revolut.com/docs/api/merchant/2025-10-16#tag-report-runs) - [Webhook management](https://developer.revolut.com/docs/api/merchant/2025-10-16#tag-webhooks) - [Location management](https://developer.revolut.com/docs/api/merchant/2025-10-16#tag-locations) ... and more. ### API versions :::warning We highly recommend using versioning in your API calls. If you don't provide a version header on the operations where it's required, you will receive an error response. ::: The Merchant API uses request header versioning. Where it is required you need to use the `Revolut-Api-Version` header parameter to specify an API version. Each request, where it is indicated in the API specification, must contain a version header in the following format: ``` 'Revolut-Api-Version: 2025-10-16' ``` :::info For more information, see: [API versions](https://developer.revolut.com/docs/guides/merchant/reference/versioning/api-versions) ::: ### Test the Merchant API You can test the Merchant API in Postman by forking this collection: [![View in Postman](https://run.pstmn.io/button.svg)](https://www.postman.com/revolut-api/workspace/revolut-developers/overview)9:T882,Welcome to the Revolut Merchant API - your solution to managing the core aspects of e-commerce and accepting online payments. Whether you're a startup, a growing business, or an established enterprise in the e-commerce industry, our API helps you streamline your operations. As a Revolut Business customer with a Merchant Account, you can use the Merchant API to leverage the following features: - [Order management](https://developer.revolut.com/docs/api/merchant/2025-10-16#tag-orders) - [Customer management](https://developer.revolut.com/docs/api/merchant/2025-10-16#tag-customers) - [Payment management](https://developer.revolut.com/docs/api/merchant/2025-10-16#tag-payments) - [Subscription management](https://developer.revolut.com/docs/api/merchant/2025-10-16#tag-subscriptions) - [Payout management](https://developer.revolut.com/docs/api/merchant/2025-10-16#tag-payouts) - [Dispute management](https://developer.revolut.com/docs/api/merchant/2025-10-16#tag-disputes) - [Reporting analytics](https://developer.revolut.com/docs/api/merchant/2025-10-16#tag-report-runs) - [Webhook management](https://developer.revolut.com/docs/api/merchant/2025-10-16#tag-webhooks) - [Location management](https://developer.revolut.com/docs/api/merchant/2025-10-16#tag-locations) ... and more. ### API versions :::warning We highly recommend using versioning in your API calls. If you don't provide a version header on the operations where it's required, you will receive an error response. ::: The Merchant API uses request header versioning. Where it is required you need to use the `Revolut-Api-Version` header parameter to specify an API version. Each request, where it is indicated in the API specification, must contain a version header in the following format: ``` 'Revolut-Api-Version: 2025-10-16' ``` :::info For more information, see: [API versions](https://developer.revolut.com/docs/guides/merchant/reference/versioning/api-versions) ::: ### Test the Merchant API You can test the Merchant API in Postman by forking this collection: [![View in Postman](https://run.pstmn.io/button.svg)](https://www.postman.com/revolut-api/workspace/revolut-developers/overview)4:[["$","title",null,{"children":"Merchant API | Developer"}],["$","meta",null,{"property":"og:title","content":"Merchant API | Developer"}],[["$","meta",null,{"name":"description","content":"$8"}],["$","meta",null,{"property":"og:description","content":"$9"}]],"$undefined","$La","$Lb","$Lc"] a:["$","meta",null,{"property":"og:url","content":"https://developer.revolut.com/docs/api/merchant/2025-10-16"}] b:[["$","meta",null,{"property":"og:image","content":"https://developer.revolut.com/_assets/og/docs/api/merchant/2025-10-16.png"}],["$","meta",null,{"property":"og:image:width","content":"1200"}],["$","meta",null,{"property":"og:image:height","content":"630"}],["$","meta",null,{"property":"og:image:type","content":"image/png"}],["$","meta",null,{"name":"twitter:card","content":"summary_large_image"}]] c:["$","$Ld",null,{"children":["$","div",null,{"data-variant":"menu-wide","data-has-feed":false,"data-revpress":"layout","className":"wp3eky1","children":[["$","$Le",null,{"actions":"$undefined"}],["$","$Lf",null,{}],["$","main",null,{"data-variant":"$undefined","className":"_12jbm4g0","children":[["$","nav",null,{"className":"e43y4a0","data-event-key":"breadcrumbs","children":["$","ol",null,{"className":"e43y4a1","children":[["$","li","/-0",{"className":"e43y4a2","children":["$","$L3",null,{"className":"e43y4a3","to":"/","children":"Home"}]}],["$","li","/docs/api/merchant/2025-10-16-1",{"className":"e43y4a2","children":null}]]}]}],["$","div",null,{"className":"nizrjz0","children":[["$","h1",null,{"className":"nizrjz2","children":["Merchant API",["$","span",null,{"className":"ubxf1y0","children":["$","$L10",null,{"variant":"faded","color":"accent","children":"2025-10-16"}]}]]}],["$","div",null,{"className":"nizrjz1","children":["$","$L11",null,{"color":"var(--rui-color-grey-tone-50)","className":"_107lvaj3","useIcon":"16/Code","use":"a","href":"/docs/api/merchant/2025-10-16.yaml","target":"_blank","rel":"noreferrer noopener","children":"View schema"}]}]]}],["$","article",null,{"className":"_8qmzte0 ubxf1y1","children":[["$","div",null,{"className":"_107lvaj0","children":["$undefined","$L12",["$","$L13",null,{"authorization":{"Api-Key":{"type":"apiKey","in":"header","name":"Authorization","description":"Each Merchant API request must contain an authorization header in the following format:\n\n```\n'Authorization: Bearer '\n```\n\nTo use this API, you need to generate API keys from your Revolut Business account. The Secret key is used in the authorization header for all server calls, while the Public key is provided with payment methods at checkout.\n\n:::info\nFor detailed instructions on generating your API keys, see: [Generate API keys](https://developer.revolut.com/docs/guides/merchant/get-started#generate-api-keys).\n:::","descriptionNode":"$L14"}}}]]}],[["$","div","tag-orders",{"children":[["$","div",null,{"className":"ezz1n30","children":[["$","div",null,{"data-header":"$undefined","className":"ezz1n31","children":["$","div",null,{"className":"_107lvaj1","children":[["$","div",null,{"className":"_107lvaj2","children":[["$","h2",null,{"id":"tag-orders","children":["Orders",["$","$L15",null,{"id":"tag-orders"}]]}],["$","$L16",null,{"url":"/docs/api/merchant/2025-10-16/tags/tag-orders.md"}]]}],"$L17"]}]}],"$undefined"]}],["$L18","$L19","$L1a","$L1b","$L1c","$L1d","$L1e","$L1f","$L20","$L21"]]}],["$","div","tag-customers",{"children":[["$","div",null,{"className":"ezz1n30","children":[["$","div",null,{"data-header":"$undefined","className":"ezz1n31","children":["$","div",null,{"className":"_107lvaj1","children":[["$","div",null,{"className":"_107lvaj2","children":[["$","h2",null,{"id":"tag-customers","children":["Customers",["$","$L15",null,{"id":"tag-customers"}]]}],["$","$L16",null,{"url":"/docs/api/merchant/2025-10-16/tags/tag-customers.md"}]]}],"$L22"]}]}],"$undefined"]}],["$L23","$L24","$L25","$L26","$L27","$L28","$L29","$L2a","$L2b"]]}],["$","div","tag-payments",{"children":[["$","div",null,{"className":"ezz1n30","children":[["$","div",null,{"data-header":"$undefined","className":"ezz1n31","children":["$","div",null,{"className":"_107lvaj1","children":[["$","div",null,{"className":"_107lvaj2","children":[["$","h2",null,{"id":"tag-payments","children":["Payments",["$","$L15",null,{"id":"tag-payments"}]]}],["$","$L16",null,{"url":"/docs/api/merchant/2025-10-16/tags/tag-payments.md"}]]}],"$L2c"]}]}],"$undefined"]}],["$L2d"]]}],["$","div","tag-subscriptions",{"children":[["$","div",null,{"className":"ezz1n30","children":[["$","div",null,{"data-header":"$undefined","className":"ezz1n31","children":["$","div",null,{"className":"_107lvaj1","children":[["$","div",null,{"className":"_107lvaj2","children":[["$","h2",null,{"id":"tag-subscriptions","children":["Subscriptions",["$","$L15",null,{"id":"tag-subscriptions"}]]}],["$","$L16",null,{"url":"/docs/api/merchant/2025-10-16/tags/tag-subscriptions.md"}]]}],"$L2e"]}]}],"$undefined"]}],["$L2f","$L30","$L31","$L32","$L33","$L34","$L35","$L36","$L37","$L38","$L39","$L3a","$L3b","$L3c","$L3d","$L3e","$L3f"]]}],["$","div","tag-payouts",{"children":[["$","div",null,{"className":"ezz1n30","children":[["$","div",null,{"data-header":"$undefined","className":"ezz1n31","children":["$","div",null,{"className":"_107lvaj1","children":[["$","div",null,{"className":"_107lvaj2","children":[["$","h2",null,{"id":"tag-payouts","children":["Payouts",["$","$L15",null,{"id":"tag-payouts"}]]}],["$","$L16",null,{"url":"/docs/api/merchant/2025-10-16/tags/tag-payouts.md"}]]}],"$L40"]}]}],"$undefined"]}],["$L41","$L42"]]}],["$","div","tag-disputes",{"children":[["$","div",null,{"className":"ezz1n30","children":[["$","div",null,{"data-header":"$undefined","className":"ezz1n31","children":["$","div",null,{"className":"_107lvaj1","children":[["$","div",null,{"className":"_107lvaj2","children":[["$","h2",null,{"id":"tag-disputes","children":["Disputes",["$","$L15",null,{"id":"tag-disputes"}]]}],["$","$L16",null,{"url":"/docs/api/merchant/2025-10-16/tags/tag-disputes.md"}]]}],"$L43"]}]}],"$undefined"]}],["$L44","$L45","$L46","$L47","$L48"]]}],"$L49","$L4a","$L4b","$L4c","$L4d","$L4e","$L4f"],"$L50"]}]]}],"$L51"]}]}] 49:["$","div","tag-report-runs",{"children":[["$","div",null,{"className":"ezz1n30","children":[["$","div",null,{"data-header":"$undefined","className":"ezz1n31","children":["$","div",null,{"className":"_107lvaj1","children":[["$","div",null,{"className":"_107lvaj2","children":[["$","h2",null,{"id":"tag-report-runs","children":["Report runs",["$","$L15",null,{"id":"tag-report-runs"}]]}],["$","$L16",null,{"url":"/docs/api/merchant/2025-10-16/tags/tag-report-runs.md"}]]}],"$L52"]}]}],"$undefined"]}],["$L53","$L54","$L55"]]}] 4a:["$","div","tag-webhooks",{"children":[["$","div",null,{"className":"ezz1n30","children":[["$","div",null,{"data-header":"$undefined","className":"ezz1n31","children":["$","div",null,{"className":"_107lvaj1","children":[["$","div",null,{"className":"_107lvaj2","children":[["$","h2",null,{"id":"tag-webhooks","children":["Webhooks",["$","$L15",null,{"id":"tag-webhooks"}]]}],["$","$L16",null,{"url":"/docs/api/merchant/2025-10-16/tags/tag-webhooks.md"}]]}],"$L56"]}]}],"$undefined"]}],["$L57","$L58","$L59","$L5a","$L5b","$L5c"]]}] 4b:["$","div","tag-locations",{"children":[["$","div",null,{"className":"ezz1n30","children":[["$","div",null,{"data-header":"$undefined","className":"ezz1n31","children":["$","div",null,{"className":"_107lvaj1","children":[["$","div",null,{"className":"_107lvaj2","children":[["$","h2",null,{"id":"tag-locations","children":["Locations",["$","$L15",null,{"id":"tag-locations"}]]}],["$","$L16",null,{"url":"/docs/api/merchant/2025-10-16/tags/tag-locations.md"}]]}],"$L5d"]}]}],"$undefined"]}],["$L5e","$L5f","$L60","$L61","$L62"]]}] 4c:["$","div","tag-terminals",{"children":[["$","div",null,{"className":"ezz1n30","children":[["$","div",null,{"data-header":"$undefined","className":"ezz1n31","children":["$","div",null,{"className":"_107lvaj1","children":[["$","div",null,{"className":"_107lvaj2","children":[["$","h2",null,{"id":"tag-terminals","children":["Terminals",["$","$L15",null,{"id":"tag-terminals"}]]}],["$","$L16",null,{"url":"/docs/api/merchant/2025-10-16/tags/tag-terminals.md"}]]}],"$L63"]}]}],"$undefined"]}],["$L64"]]}] 4d:["$","div","tag-payment-intents",{"children":[["$","div",null,{"className":"ezz1n30","children":[["$","div",null,{"data-header":"$undefined","className":"ezz1n31","children":["$","div",null,{"className":"_107lvaj1","children":[["$","div",null,{"className":"_107lvaj2","children":[["$","h2",null,{"id":"tag-payment-intents","children":["Payment intents",["$","$L15",null,{"id":"tag-payment-intents"}]]}],["$","$L16",null,{"url":"/docs/api/merchant/2025-10-16/tags/tag-payment-intents.md"}]]}],"$L65"]}]}],"$undefined"]}],["$L66","$L67","$L68"]]}] 4e:["$","div","tag-apple-pay-merchant-registration",{"children":[["$","div",null,{"className":"ezz1n30","children":[["$","div",null,{"data-header":"$undefined","className":"ezz1n31","children":["$","div",null,{"className":"_107lvaj1","children":[["$","div",null,{"className":"_107lvaj2","children":[["$","h2",null,{"id":"tag-apple-pay-merchant-registration","children":["Apple Pay merchant registration",["$","$L15",null,{"id":"tag-apple-pay-merchant-registration"}]]}],["$","$L16",null,{"url":"/docs/api/merchant/2025-10-16/tags/tag-apple-pay-merchant-registration.md"}]]}],"$L69"]}]}],"$undefined"]}],["$L6a","$L6b"]]}] 4f:["$","div","tag-other",{"children":[["$","div",null,{"className":"ezz1n30","children":[["$","div",null,{"data-header":"$undefined","className":"ezz1n31","children":["$","div",null,{"className":"_107lvaj1","children":[["$","div",null,{"className":"_107lvaj2","children":[["$","h2",null,{"id":"tag-other","children":["Other",["$","$L15",null,{"id":"tag-other"}]]}],["$","$L16",null,{"url":"/docs/api/merchant/2025-10-16/tags/tag-other.md"}]]}],"$L6c"]}]}],"$undefined"]}],["$L6d","$L6e","$L6f"]]}] 50:["$","$L70",null,{"sectionIds":["tag-orders","create-order","retrieve-order-list","retrieve-order","update-order","increment-order-authorisation","capture-order","cancel-order","refund-order","pay-order","retrieve-payment-list","tag-customers","create-customer","retrieve-customer-list","retrieve-customer","update-customer","delete-customer","retrieve-payment-method-list","retrieve-payment-method","update-payment-method","delete-payment-method","tag-payments","retrieve-payment-details","tag-subscriptions","create-subscription-plan","retrieve-subscription-plan-list","retrieve-subscription-plan","create-subscription","retrieve-subscription-list","retrieve-subscription","update-subscription","cancel-subscription","change-subscription-plan","update-subscription-renewal-date","retrieve-subscription-cycle-list","retrieve-subscription-cycle","create-subscription-usage","retrieve-subscription-usage-list","retrieve-subscription-usage","update-subscription-usage","delete-subscription-usage","tag-payouts","retrieve-payout-list","retrieve-payout","tag-disputes","retrieve-dispute-list","retrieve-dispute","accept-dispute","upload-dispute-evidence","challenge-dispute","tag-report-runs","create-report-run","retrieve-report-run","download-report-file","tag-webhooks","create-webhook","retrieve-webhook-list","retrieve-webhook","update-webhook","delete-webhook","rotate-webhook-signing-secret","tag-locations","create-location","retrieve-location-list","retrieve-location","update-location","delete-location","tag-terminals","retrieve-terminal-list","tag-payment-intents","create-payment-intent","retrieve-payment-intent","cancel-payment-intent","tag-apple-pay-merchant-registration","register-domain-apple-pay","unregister-domain-apple-pay","tag-other","register-address-validation-endpoint","retrieve-synchronous-webhook-list","delete-synchronous-webhook"]}] 51:["$","div",null,{"className":"wp3eky0","children":["$","$L71",null,{}]}] 73:I["98d563c3c055",[],"Icon",1] 14:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Each Merchant API request must contain an authorization header in the following format:"}],"\n","$L72","\n",["$","p","p-1",{"children":"To use this API, you need to generate API keys from your Revolut Business account. The Secret key is used in the authorization header for all server calls, while the Public key is provided with payment methods at checkout."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For detailed instructions on generating your API keys, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/get-started#generate-api-keys","target":"_blank","rel":"noreferrer","children":"Generate API keys"}],"."]}]}]]}]]}] 17:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The Orders resource in the Merchant API offers a comprehensive solution for managing the lifecycle of orders within your e-commerce or retail platform. Designed to streamline order processing, this resource encapsulates a suite of operations that allow for efficiently handling order management-related tasks. For more information about the order lifecycle, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/reference/order-lifecycle","target":"_blank","rel":"noreferrer","children":"Order and payment lifecycle"}],"."]}],"\n",["$","p","p-1",{"children":"These operations are equipped to handle various order management scenarios, providing a robust interface for businesses to interact with their order data."}],"\n",["$","p","p-2",{"children":["To process a payment related to your customers' purchases, you need to create an ",["$","code","code-0",{"children":"Order"}]," object. Then you can use an order's unique ",["$","code","code-1",{"children":"token"}]," to process and accept payments via the Revolut Checkout Widget."]}],"\n",["$","div","inlinealert-0",{"data-type":"warning","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMark","color":"var(--rui-color-warning)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant/2025-10-16#create-order","target":"_blank","rel":"noreferrer","children":"Create an order endpoint"}]," was updated to a new version and now returns ",["$","code","code-0",{"children":"token"}]," as the public identifier for the order. Previous integrations might still use the deprecated endpoint returning ",["$","code","code-1",{"children":"public_id"}],"."]}],["$","p","p-1",{"children":["We strongly advise upgrading to the new ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant/2025-10-16#create-order","target":"_blank","rel":"noreferrer","children":"Create an order endpoint"}],"."]}]]}]]}]]}] 22:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The Customers resource in the Merchant API is a pivotal tool for tracking and managing customer-related transactions within your e-commerce or retail platform. This resource provides a structured approach to customer management, enabling you to maintain a consistent record of customer transactions."}],"\n",["$","p","p-1",{"children":["A ",["$","code","code-0",{"children":"Customer"}]," object can be created using the ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant/2025-10-16#create-customer","target":"_blank","rel":"noreferrer","children":"Create a customer"}]," endpoint and you can then retrieve, update and delete a customer using its ",["$","code","code-1",{"children":"id"}],". ",["$","code","code-2",{"children":"Customer"}]," objects enable you to track multiple transactions in your system associated with the same customer in the Merchant API."]}],"\n",["$","p","p-2",{"children":["You can save and store payment methods of a customer in the ",["$","code","code-0",{"children":"payment_method"}]," object, for more information, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/optimise-checkout/save-payment-methods/charge-saved-payment-method","target":"_blank","rel":"noreferrer","children":"Charge a customer's saved payment method"}],". A merchant can store the details of the payment securely and group transactions from the same payment method in their system."]}],"\n",["$","p","p-3",{"children":"A payment method is unique for each customer. For example, if the same card is used for a transaction by two different customers, two payment method objects are created linked to each customer."}],"\n",["$","p","p-4",{"children":"Similar principle applies when saving payment methods via Revolut Pay for merchant initiated transaction (MIT - useful for recurring payments). If a customer saves their details through Revolut Pay for MIT in separate sessions, each session will create a new payment method object linked to the customer."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":"You cannot create a payment method explicitly because they are generated as part of a payment. You can only retrieve, update or delete a payment method, or you can retrieve all payment methods of a customer."}]}]]}]]}] 2c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Payment operations enable you to initiate payments, or track payment status transitions. You can use the ID of the payment to retrieve information about a specific payment."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information about the payment lifecycle, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/reference/order-lifecycle","target":"_blank","rel":"noreferrer","children":"Order and payment lifecycle"}],"."]}]}]]}]]}] 2e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The Subscriptions API provides a complete solution for creating and managing recurring billing for your customers."}],"\n",["$","p","p-1",{"children":"You can automatically charge customers on flexible billing cycles, manage sophisticated subscription plans, and track the entire billing history for every subscriber."}],"\n",["$","h3","h3-0",{"children":"How it works?"}],"\n",["$","p","p-2",{"children":["A subscription's billing structure is defined by a ",["$","strong","strong-0",{"children":"Subscription plan"}],". This model gives you granular control:"]}],"\n",["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":[["$","strong","strong-0",{"children":"Plans"}]," contain one or more ",["$","strong","strong-1",{"children":"variations"}]," (e.g., a \"Gold\" plan could have \"Monthly\" and \"Yearly\" variations)."]}],"\n",["$","li","li-1",{"children":[["$","strong","strong-0",{"children":"Variations"}]," can have multiple ",["$","strong","strong-1",{"children":"phases"}]," (e.g., a 7-day free trial followed by a regular billing phase)."]}],"\n"]}],"\n",["$","p","p-3",{"children":"This powerful structure allows you to build complex pricing models, including free trials, introductory offers, and tiered pricing."}],"\n",["$","h4","h4-0",{"children":"Key features"}],"\n",["$","ul","ul-1",{"children":["\n",["$","li","li-0",{"children":[["$","strong","strong-0",{"children":"Flexible pricing models:"}]," Create plans with multiple variations and phases to support any billing scenario."]}],"\n",["$","li","li-1",{"children":[["$","strong","strong-0",{"children":"Automated charging:"}]," Automatically charge a customer's saved payment method at the start of each billing cycle."]}],"\n",["$","li","li-2",{"children":[["$","strong","strong-0",{"children":"Hosted onboarding:"}]," For new customers, generate a setup order with a redirect URL to Revolut's Hosted Payment Page, allowing them to securely add a payment method."]}],"\n",["$","li","li-3",{"children":[["$","strong","strong-0",{"children":"Lifecycle tracking:"}]," Monitor each billing cycle's state, view all associated orders, and access complete payment histories."]}],"\n",["$","li","li-4",{"children":[["$","strong","strong-0",{"children":"Full subscription management:"}]," Easily update customer payment methods, cancel subscriptions, and view a complete billing history."]}],"\n"]}]]}] 40:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Endpoints for retrieving information about payouts, allowing merchants to access details of funds withdrawn from their Merchant account to external bank accounts."}],"\n",["$","p","p-1",{"children":["Merchants can use these endpoints to retrieve a list of payouts and specific payout details. The payout IDs obtained can be used to ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant/2025-10-16#tag-report-runs","target":"_blank","rel":"noreferrer","children":"generate detailed reports"}]," that provide comprehensive breakdowns of all transactions contributing to the payout amounts."]}],"\n",["$","p","p-2",{"children":["Payout information, including IDs, can be retrieved via the ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant/2025-10-16#retrieve-payout-list","target":"_blank","rel":"noreferrer","children":"Retrieve payout list"}]," endpoint or from ",["$","a","a-1",{"href":"https://developer.revolut.com/docs/api/merchant/2025-10-16#create-webhook#callbacks","target":"_blank","rel":"noreferrer","children":"webhook events related to payouts"}],"."]}]]}] 43:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Endpoints that allow merchants to view customer payment disputes."}],"\n",["$","p","p-1",{"children":["It provides a robust framework with high-level states (e.g., ",["$","code","code-0",{"children":"won"}],", ",["$","code","code-1",{"children":"lost"}],", ",["$","code","code-2",{"children":"needs_response"}],", ",["$","code","code-3",{"children":"under_review"}],") and detailed substates (e.g., ",["$","code","code-4",{"children":"lost_expired"}],", ",["$","code","code-5",{"children":"pre_arbitration"}],", ",["$","code","code-6",{"children":"won_pre_arbitration"}],", etc.) to accurately track the dispute lifecycle."]}],"\n",["$","p","p-2",{"children":"Additionally, the API integrates standard dispute reason codes and human-readable descriptions, offering a customisable approach to dispute resolution that facilitates effective dispute management."}]]}] 52:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["Use ",["$","strong","strong-0",{"children":"Report runs"}]," operations to generate CSV reports of your Merchant account transactions. Choose from the following report types based on your use case:"]}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Report type","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"custom_report"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Settled and processing transactions with a configurable set of columns.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"settlement_report"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"All settled transactions, with a configurable set of columns.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"payments_report"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"All payments, including failed and declined ones.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"payout_statement_report"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"All transactions that contributed to a specific payout.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-4",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"icpp_fee_breakdown_report"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"IC++ fee components broken down per transaction for a specific IC++ charge.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information about how to generate CSV reports, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/monitor-and-observe/reports-reconciliation","target":"_blank","rel":"noreferrer","children":"Create CSV reports of transactions"}],"."]}]}]]}]]}] 56:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["A ",["$","code","code-0",{"children":"webhook"}]," (also called a web callback) allows your system to receive an event from a different app immediately after it happens."]}],"\n",["$","p","p-1",{"children":["For example, you can subscribe to a webhook when an order changes from ",["$","code","code-0",{"children":"pending"}]," to ",["$","code","code-1",{"children":"completed"}]," status. When the payment is cleared and the order is completed, Revolut servers send a notification to the URL of your choice. This is a more efficient way to know when an order is paid as opposed to trying to get the status of the order every few seconds."]}],"\n",["$","p","p-2",{"children":["Many events that happen to a Revolut Merchant account are synchronous, which means they arrive instantly and have immediate results. For example, a successful request to create a customer immediately returns a ",["$","code","code-0",{"children":"Customer"}]," object. Such requests don't require webhooks."]}],"\n",["$","p","p-3",{"children":["The Revolut Merchant API supports webhooks for events including ",["$","code","code-0",{"children":"ORDER_COMPLETED"}]," and ",["$","code","code-1",{"children":"ORDER_AUTHORISED"}],"."]}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["Because we cannot guarantee the delivery order of the status (",["$","code","code-0",{"children":"events"}],"), you might receive the status not in the expected order. Make sure that your implementation does not rely on the order that the events are being received in."]}]}]]}],"\n",["$","p","p-4",{"children":["For example, for a completed order, you should receive the ",["$","code","code-0",{"children":"ORDER_AUTHORISED"}]," status first and then ",["$","code","code-1",{"children":"ORDER_COMPLETED"}],". However, if the ",["$","code","code-2",{"children":"ORDER_AUTHORISED"}]," status isn't sent successfully at first, it's moved to the queue to be resent in the next few minutes. Before then, if the ",["$","code","code-3",{"children":"ORDER_COMPLETED"}]," status is sent successfully, you get ",["$","code","code-4",{"children":"ORDER_COMPLETED"}]," first and then ",["$","code","code-5",{"children":"ORDER_AUTHORISED"}],"."]}],"\n",["$","p","p-5",{"children":["Check out our tutorial for ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/monitor-and-observe/webhooks/using-webhooks","target":"_blank","rel":"noreferrer","children":"Using webhooks to keep track of the payment lifecycle"}],"."]}],"\n",["$","div","inlinealert-1",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information about the order and payment lifecycle, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/reference/order-lifecycle","target":"_blank","rel":"noreferrer","children":"Order and payment lifecycle"}],"."]}]}]]}]]}] 5d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The Locations API is designed to help merchants manage multiple points of sale, including both ",["$","strong","strong-0",{"children":"online storefronts"}]," and ",["$","strong","strong-1",{"children":"physical stores"}],". Registering locations lets you differentiate and group your orders from different stores. You can also introduce custom business logic for each location, such as different inventory management, pricing, or shipping rules."]}],"\n",["$","p","p-1",{"children":"To start using locations, follow the relevant use case for your business:"}],"\n",["$","h3","h3-0",{"children":"Online locations"}],"\n",["$","ol","ol-0",{"children":["\n",["$","li","li-0",{"children":["Register an online location using the ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant/2025-10-16#create-location","target":"_blank","rel":"noreferrer","children":"Create a location"}]," endpoint, setting the ",["$","code","code-0",{"children":"type"}]," to ",["$","code","code-1",{"children":"online"}],"."]}],"\n",["$","li","li-1",{"children":"Configure your custom processes on your backend for each registered location (e.g., grouping orders, custom pricing, etc.)."}],"\n",["$","li","li-2",{"children":["Send the ",["$","code","code-0",{"children":"location_id"}]," parameter in the request body during ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant/2025-10-16#create-order","target":"_blank","rel":"noreferrer","children":"order creation"}]," to assign the order to a specific location."]}],"\n"]}],"\n",["$","h5","h5-0",{"children":"Physical locations"}],"\n",["$","ol","ol-1",{"children":["\n",["$","li","li-0",{"children":["Register a physical location using the ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant/2025-10-16#create-location","target":"_blank","rel":"noreferrer","children":"Create a location"}]," endpoint, setting the ",["$","code","code-0",{"children":"type"}]," to ",["$","code","code-1",{"children":"physical"}],"."]}],"\n",["$","li","li-1",{"children":["In case of Revolut POS, our system handles order creation including ",["$","code","code-0",{"children":"location_id"}]," to associate the order with your location."]}],"\n"]}],"\n",["$","h4","h4-0",{"children":"Fast checkout for multiple storefronts"}],"\n",["$","p","p-2",{"children":["Locations are particularly useful for tailoring the user experience on each of your online storefronts, especially when using features like ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/optimise-checkout/fast-checkout","target":"_blank","rel":"noreferrer","children":["$","strong","strong-0",{"children":"Fast checkout"}]}],"."]}],"\n",["$","p","p-3",{"children":["For example, if you operate two online stores with different shipping rules, you can register two separate ",["$","code","code-0",{"children":"online"}]," locations. By then using the ",["$","code","code-1",{"children":"location_id"}]," to ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant/2025-10-16#register-address-validation-endpoint","target":"_blank","rel":"noreferrer","children":"register a distinct address validation endpoint"}]," for each one, your backend can apply the correct shipping logic and pricing for the specific storefront a customer is buying from."]}]]}] 63:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Operations for managing Revolut Terminal devices and push payment integrations with Point of Sale (POS) systems."}],"\n",["$","p","p-1",{"children":["The Terminals API enables POS software providers to integrate with Revolut Terminal devices for accepting in-person payments through a ",["$","strong","strong-0",{"children":"push payments"}]," model. This server-to-server integration allows your POS system to:"]}],"\n",["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":"Discover available terminals at specific locations"}],"\n",["$","li","li-1",{"children":"Push payment requests to physical terminal devices"}],"\n",["$","li","li-2",{"children":"Track payment intent and payment status in real-time"}],"\n",["$","li","li-3",{"children":"Cancel pending payment requests when needed"}],"\n"]}],"\n",["$","h3","h3-0",{"children":"Push payments workflow"}],"\n",["$","ol","ol-0",{"children":["\n",["$","li","li-0",{"children":[["$","strong","strong-0",{"children":"Terminal discovery:"}]," Use the ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant/2025-10-16#retrieve-terminal-list","target":"_blank","rel":"noreferrer","children":"Retrieve terminal list"}]," endpoint to find available terminals at a location (filtered by ",["$","code","code-0",{"children":"operation_mode=pos"}],")"]}],"\n",["$","li","li-1",{"children":[["$","strong","strong-0",{"children":"Payment intent creation:"}]," Push a payment request to a specific terminal using ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant/2025-10-16#create-payment-intent","target":"_blank","rel":"noreferrer","children":"Create a payment intent"}]]}],"\n",["$","li","li-2",{"children":[["$","strong","strong-0",{"children":"Status tracking:"}]," Poll the payment intent status until completion using ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant/2025-10-16#retrieve-payment-intent","target":"_blank","rel":"noreferrer","children":"Retrieve a payment intent"}]," endpoint"]}],"\n",["$","li","li-3",{"children":[["$","strong","strong-0",{"children":"Payment confirmation:"}]," Once the payment intent reaches ",["$","code","code-0",{"children":"completed"}]," state, ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant/2025-10-16#retrieve-payment-details","target":"_blank","rel":"noreferrer","children":"retrieve the final payment status"}]," using the returned ",["$","code","code-1",{"children":"payment_id"}]]}],"\n"]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For detailed implementation guidance, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/accept-payments/in-person-payments/terminal/push-payments","target":"_blank","rel":"noreferrer","children":"Push payments to Revolut Terminal"}],"."]}]}]]}]]}] 65:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Operations for managing payment intents in the push payments to Revolut Terminal flow."}],"\n",["$","p","p-1",{"children":["A ",["$","strong","strong-0",{"children":"payment intent"}]," represents the intention to complete payment for a specific order on a specific Revolut Terminal device. Payment intents are the mechanism that links orders created via the Merchant API with physical terminal devices in ",["$","strong","strong-1",{"children":"Pay at Counter"}]," mode."]}],"\n",["$","h3","h3-0",{"children":"What is a payment intent?"}],"\n",["$","p","p-2",{"children":"When you create a payment intent, you're pushing a payment request from your POS system to a Revolut Terminal. The payment intent:"}],"\n",["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":"Links an order to a specific terminal device"}],"\n",["$","li","li-1",{"children":"Triggers the payment request to appear on the terminal screen"}],"\n",["$","li","li-2",{"children":"Tracks the customer's interaction with the terminal (pending → processing → completed)"}],"\n",["$","li","li-3",{"children":["Provides a ",["$","code","code-0",{"children":"payment_id"}]," when completed, which you use to retrieve the final payment status"]}],"\n"]}],"\n",["$","h4","h4-0",{"children":"Payment intent lifecycle"}],"\n",["$","ol","ol-0",{"children":["\n",["$","li","li-0",{"children":[["$","strong","strong-0",{"children":"Create:"}]," Push a payment intent to a terminal by ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant/2025-10-16#create-payment-intent","target":"_blank","rel":"noreferrer","children":"creating a payment intent"}]]}],"\n",["$","li","li-1",{"children":[["$","strong","strong-0",{"children":"Track:"}]," Poll the payment intent status by ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant/2025-10-16#retrieve-payment-intent","target":"_blank","rel":"noreferrer","children":"retrieving payment intent details"}]," until it reaches a final state"]}],"\n",["$","li","li-2",{"children":[["$","strong","strong-0",{"children":"Complete:"}]," When state is ",["$","code","code-0",{"children":"completed"}],", extract the ",["$","code","code-1",{"children":"payment_id"}]," and ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant/2025-10-16#retrieve-payment-details","target":"_blank","rel":"noreferrer","children":"retrieve the final payment status"}]]}],"\n",["$","li","li-3",{"children":[["$","strong","strong-0",{"children":"Cancel (optional):"}]," Cancel pending payment intents using ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant/2025-10-16#cancel-payment-intent","target":"_blank","rel":"noreferrer","children":"Cancel a payment intent"}]]}],"\n"]}],"\n",["$","h4","h4-1",{"children":"Important notes"}],"\n",["$","ul","ul-1",{"children":["\n",["$","li","li-0",{"children":["A payment intent reaching ",["$","code","code-0",{"children":"completed"}]," state means the checkout process finished on the terminal, but it does ",["$","strong","strong-0",{"children":"not"}]," guarantee the payment succeeded"]}],"\n",["$","li","li-1",{"children":["You must check the actual payment status using the ",["$","code","code-0",{"children":"payment_id"}]," returned in the completed payment intent"]}],"\n",["$","li","li-2",{"children":["Payment status can be ",["$","code","code-0",{"children":"captured"}],"/",["$","code","code-1",{"children":"completed"}]," (successful), ",["$","code","code-2",{"children":"declined"}]," (card rejected), ",["$","code","code-3",{"children":"failed"}]," (technical error), or ",["$","code","code-4",{"children":"cancelled"}]]}],"\n"]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For the complete push payments integration guide, see: ","$L74","."]}]}]]}]]}] 69:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Operations for managing a merchant's domain registration and configuration with Apple for integration of Apple Pay via Revolut."}],"\n",["$","p","p-1",{"children":"This includes initiating domain validation with Apple, a necessary step for merchants to offer Apple Pay as a payment method on their websites or apps."}],"\n",["$","p","p-2",{"children":["These endpoints interact with Apple's ",["$","a","a-0",{"href":"https://developer.apple.com/documentation/applepaywebmerchantregistrationapi","target":"_blank","rel":"noreferrer","children":"Apple Pay Web Merchant Registration services"}],"."]}]]}] 6c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Other operations that can be done with the Merchant API."}]]}] 12:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Welcome to the Revolut Merchant API - your solution to managing the core aspects of e-commerce and accepting online payments. Whether you're a startup, a growing business, or an established enterprise in the e-commerce industry, our API helps you streamline your operations."}],"\n",["$","p","p-1",{"children":"As a Revolut Business customer with a Merchant Account, you can use the\nMerchant API to leverage the following features:"}],"\n",["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant/2025-10-16#tag-orders","target":"_blank","rel":"noreferrer","children":"Order management"}]}],"\n",["$","li","li-1",{"children":["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant/2025-10-16#tag-customers","target":"_blank","rel":"noreferrer","children":"Customer management"}]}],"\n",["$","li","li-2",{"children":["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant/2025-10-16#tag-payments","target":"_blank","rel":"noreferrer","children":"Payment management"}]}],"\n",["$","li","li-3",{"children":["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant/2025-10-16#tag-subscriptions","target":"_blank","rel":"noreferrer","children":"Subscription management"}]}],"\n",["$","li","li-4",{"children":["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant/2025-10-16#tag-payouts","target":"_blank","rel":"noreferrer","children":"Payout management"}]}],"\n",["$","li","li-5",{"children":["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant/2025-10-16#tag-disputes","target":"_blank","rel":"noreferrer","children":"Dispute management"}]}],"\n",["$","li","li-6",{"children":["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant/2025-10-16#tag-report-runs","target":"_blank","rel":"noreferrer","children":"Reporting analytics"}]}],"\n",["$","li","li-7",{"children":["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant/2025-10-16#tag-webhooks","target":"_blank","rel":"noreferrer","children":"Webhook management"}]}],"\n",["$","li","li-8",{"children":["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant/2025-10-16#tag-locations","target":"_blank","rel":"noreferrer","children":"Location management"}]}],"\n"]}],"\n",["$","p","p-2",{"children":"... and more."}],"\n",["$","h2","h2-0",{"children":"API versions"}],"\n",["$","div","inlinealert-0",{"data-type":"warning","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMark","color":"var(--rui-color-warning)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":"We highly recommend using versioning in your API calls. If you don't provide a version header on the operations where it's required, you will receive an error response."}]}]]}],"\n",["$","p","p-3",{"children":["The Merchant API uses request header versioning. Where it is required you need to use the ",["$","code","code-0",{"children":"Revolut-Api-Version"}]," header parameter to specify an API version. Each request, where it is indicated in the API specification, must contain a version header in the following format:"]}],"\n","$L75","\n",["$","div","inlinealert-1",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/reference/versioning/api-versions","target":"_blank","rel":"noreferrer","children":"API versions"}]]}]}]]}],"\n",["$","h4","h4-0",{"children":"Test the Merchant API"}],"\n",["$","p","p-4",{"children":"You can test the Merchant API in Postman by forking this collection:"}],"\n",["$","p","p-5",{"children":["$","a","a-0",{"href":"https://www.postman.com/revolut-api/workspace/revolut-developers/overview","target":"_blank","rel":"noreferrer","children":"$L76"}]}]]}] 77:I["5a58dc8a966f",[],"Media",1] 74:["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/accept-payments/in-person-payments/terminal/push-payments","target":"_blank","rel":"noreferrer","children":"Push payments to Revolut Terminal"}] 76:["$","$L77","img-0",{"src":"https://run.pstmn.io/button.svg","alt":"View in Postman"}] 78:I["50460d952402",[],"ScrollArea",1] 79:I["669a0b877249",[],"CopyButton",1] 72:["$","div","CodeBlock-0",{"className":"wzy01m0 _18b50nc0","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"
'Authorization: Bearer <yourSecretApiKey>'
"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"'Authorization: Bearer '\n"}]}]]}] 75:["$","div","CodeBlock-0",{"className":"wzy01m0 _18b50nc0","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"
'Revolut-Api-Version: 2025-10-16'
"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"'Revolut-Api-Version: 2025-10-16'\n"}]}]]}] 7a:"$Sreact.fragment" 7b:I["18c949fc15ff",[],"ApiEndpointProvider",1] 85:I["fb6f11acc98a",[],"Request",1] 89:I["1ec75fa958bc",[],"Response",1] 8a:I["f366e5914c23",[],"CodeSnippets",1] 8b:T8b1,
fetch("https://merchant.revolut.com/api/locations/__RP_TOK_0__", {
  method: "DELETE",
  headers: {
    "Authorization": "__RP_TOK_1__"
  }
})
  .then(response => response.json())
  .then(data => console.log(data));
8c:Td99,
package main

import (
  "fmt"
  "net/http"
)

func main() {
  url := "https://merchant.revolut.com/api/locations/__RP_TOK_0__"
  req, _ := http.NewRequest("DELETE", url, nil)
  req.Header.Add("Authorization", "__RP_TOK_1__")

  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  fmt.Println(res)
}
8d:T6c5,
import requests

url = "https://merchant.revolut.com/api/locations/__RP_TOK_0__"
headers = {
  "Authorization": "__RP_TOK_1__"
}

response = requests.delete(url, headers=headers)
print(response.json())
8e:T153d,
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;

public class Main {
  public static void main(String[] args) {
    HttpClient client = HttpClient.newHttpClient();
    HttpRequest request = HttpRequest.newBuilder()
      .uri(URI.create("https://merchant.revolut.com/api/locations/__RP_TOK_0__"))
      .header("Authorization", "__RP_TOK_1__")
      .DELETE(HttpRequest.BodyPublishers.noBody())
      .build();

    client.sendAsync(request, HttpResponse.BodyHandlers.ofString())
      .thenApply(HttpResponse::body)
      .thenAccept(System.out::println)
      .join();
  }
}
8f:T145d,
using System.Net.Http;
using System.Net.Http.Headers;

var client = new HttpClient();
var request = new HttpRequestMessage
{
  Method = HttpMethod.Delete,
  RequestUri = new Uri("https://merchant.revolut.com/api/locations/__RP_TOK_0__"),
  Headers =
  {
    { "Authorization", "__RP_TOK_1__" },
  }
};

using (var response = await client.SendAsync(request))
{
  response.EnsureSuccessStatusCode();
  var body = await response.Content.ReadAsStringAsync();
  Console.WriteLine(body);
}
90:T8b9,
fetch("https://sandbox-merchant.revolut.com/api/locations/__RP_TOK_0__", {
  method: "DELETE",
  headers: {
    "Authorization": "__RP_TOK_1__"
  }
})
  .then(response => response.json())
  .then(data => console.log(data));
91:Tda1,
package main

import (
  "fmt"
  "net/http"
)

func main() {
  url := "https://sandbox-merchant.revolut.com/api/locations/__RP_TOK_0__"
  req, _ := http.NewRequest("DELETE", url, nil)
  req.Header.Add("Authorization", "__RP_TOK_1__")

  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  fmt.Println(res)
}
92:T6cd,
import requests

url = "https://sandbox-merchant.revolut.com/api/locations/__RP_TOK_0__"
headers = {
  "Authorization": "__RP_TOK_1__"
}

response = requests.delete(url, headers=headers)
print(response.json())
93:T1545,
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;

public class Main {
  public static void main(String[] args) {
    HttpClient client = HttpClient.newHttpClient();
    HttpRequest request = HttpRequest.newBuilder()
      .uri(URI.create("https://sandbox-merchant.revolut.com/api/locations/__RP_TOK_0__"))
      .header("Authorization", "__RP_TOK_1__")
      .DELETE(HttpRequest.BodyPublishers.noBody())
      .build();

    client.sendAsync(request, HttpResponse.BodyHandlers.ofString())
      .thenApply(HttpResponse::body)
      .thenAccept(System.out::println)
      .join();
  }
}
94:T1465,
using System.Net.Http;
using System.Net.Http.Headers;

var client = new HttpClient();
var request = new HttpRequestMessage
{
  Method = HttpMethod.Delete,
  RequestUri = new Uri("https://sandbox-merchant.revolut.com/api/locations/__RP_TOK_0__"),
  Headers =
  {
    { "Authorization", "__RP_TOK_1__" },
  }
};

using (var response = await client.SendAsync(request))
{
  response.EnsureSuccessStatusCode();
  var body = await response.Content.ReadAsStringAsync();
  Console.WriteLine(body);
}
62:["$","$7a","delete-location",{"children":[["$","section",null,{"className":"y9a0do0","data-variant":"endpoint","children":["$","$L7b",null,{"responses":{"204":{"description":"Location deleted","descriptionNode":"$L7c"},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"errorId":{"type":"string","description":"The ID of the error. You can share this ID with Revolut support for troubleshooting.","descriptionNode":"$L7d"},"timestamp":{"type":"integer","description":"The date and time the error happened.","descriptionNode":"$L7e"}},"required":["errorId","timestamp"]}}},"descriptionNode":"$L7f"},"404":{"description":"Not Found","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"errorId":{"type":"string","description":"The ID of the error. You can share this ID with Revolut support for troubleshooting.","descriptionNode":"$L80"},"timestamp":{"type":"integer","description":"The date and time the error happened.","descriptionNode":"$L81"}},"required":"$62:props:children:0:props:children:props:responses:401:content:application/json:schema:required"}}},"descriptionNode":"$L82"}},"requestBody":"$undefined","variantLabels":[],"children":[["$","div",null,{"className":"ezz1n30","children":[["$","div",null,{"data-header":"$undefined","className":"ezz1n31","children":["$","div",null,{"className":"y9a0do1","children":[["$","h2",null,{"id":"delete-location","children":[["$L83","$undefined"],["$","$L15",null,{"id":"delete-location"}]]}],["$","$L16",null,{"url":"/docs/api/merchant/2025-10-16/operations/delete-location.md"}]]}]}],"$undefined"]}],["$","div",null,{"className":"ezz1n30","children":[["$","div",null,{"data-header":"$undefined","className":"ezz1n31","children":["$L84",["$","$L85",null,{"parameters":[{"name":"Authorization","in":"header","schema":{"type":"string","format":"Bearer ","examples":["Bearer sk_1234567890ABCdefGHIjklMNOpqrSTUvwxYZ_1234567890-Ab_cdeFGHijkLMNopq"]},"required":true,"description":"This parameter accepts the [Merchant API Secret key](https://business.revolut.com/settings/apis?tab=merchant-api) to authorise requests coming from the merchant's backend. \n\nIt ensures that ensures that each request is authenticated and authorised by verifying the secret key. The secret key should be included in all request headers as a `Bearer` token.\n\n:::info\nFor more information, see: [Authentication](https://developer.revolut.com/docs/api/merchant#authentication)\n:::","descriptionNode":"$L86"},{"name":"location_id","schema":{"type":"string","format":"uuid","description":"A UUID string, typically used to identify resources.","descriptionNode":"$L87"},"in":"path","required":true,"description":"The ID of the location.","descriptionNode":"$L88"}],"requestBody":"$undefined","heading":"Request","requestBodySchemaTitle":"Request body","headingAs":"h3"}],["$","$L89",null,{"responses":"$62:props:children:0:props:children:props:responses","headingAs":"h3"}]]}],["$","div",null,{"className":"ezz1n32","children":[[["$","$L8a",null,{"itemsByServer":{"https://merchant.revolut.com":[{"id":"curl","label":"cURL","templateCode":"curl -X DELETE \"https://merchant.revolut.com/api/locations/__RP_TOK_0__\" \\\n -H \"Authorization: __RP_TOK_1__\"","templateHtml":"
curl -X DELETE \"https://merchant.revolut.com/api/locations/__RP_TOK_0__\" \\\n  -H \"Authorization: __RP_TOK_1__\"
","tokens":[{"marker":"__RP_TOK_0__","paramName":"location_id","paramIn":"path","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["shell-double-inner"]}],"defaults":{"header:Authorization":"Bearer ","path:location_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"javascript","label":"JavaScript","templateCode":"fetch(\"https://merchant.revolut.com/api/locations/__RP_TOK_0__\", {\n method: \"DELETE\",\n headers: {\n \"Authorization\": \"__RP_TOK_1__\"\n }\n})\n .then(response => response.json())\n .then(data => console.log(data));","templateHtml":"$8b","tokens":[{"marker":"__RP_TOK_0__","paramName":"location_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","path:location_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"go","label":"Go","templateCode":"package main\n\nimport (\n \"fmt\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://merchant.revolut.com/api/locations/__RP_TOK_0__\"\n req, _ := http.NewRequest(\"DELETE\", url, nil)\n req.Header.Add(\"Authorization\", \"__RP_TOK_1__\")\n\n res, _ := http.DefaultClient.Do(req)\n defer res.Body.Close()\n fmt.Println(res)\n}","templateHtml":"$8c","tokens":[{"marker":"__RP_TOK_0__","paramName":"location_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","path:location_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"python","label":"Python","templateCode":"import requests\n\nurl = \"https://merchant.revolut.com/api/locations/__RP_TOK_0__\"\nheaders = {\n \"Authorization\": \"__RP_TOK_1__\"\n}\n\nresponse = requests.delete(url, headers=headers)\nprint(response.json())","templateHtml":"$8d","tokens":[{"marker":"__RP_TOK_0__","paramName":"location_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","path:location_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"java","label":"Java","templateCode":"import java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\nimport java.net.URI;\n\npublic class Main {\n public static void main(String[] args) {\n HttpClient client = HttpClient.newHttpClient();\n HttpRequest request = HttpRequest.newBuilder()\n .uri(URI.create(\"https://merchant.revolut.com/api/locations/__RP_TOK_0__\"))\n .header(\"Authorization\", \"__RP_TOK_1__\")\n .DELETE(HttpRequest.BodyPublishers.noBody())\n .build();\n\n client.sendAsync(request, HttpResponse.BodyHandlers.ofString())\n .thenApply(HttpResponse::body)\n .thenAccept(System.out::println)\n .join();\n }\n}","templateHtml":"$8e","tokens":[{"marker":"__RP_TOK_0__","paramName":"location_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","path:location_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"csharp","label":"C#","templateCode":"using System.Net.Http;\nusing System.Net.Http.Headers;\n\nvar client = new HttpClient();\nvar request = new HttpRequestMessage\n{\n Method = HttpMethod.Delete,\n RequestUri = new Uri(\"https://merchant.revolut.com/api/locations/__RP_TOK_0__\"),\n Headers =\n {\n { \"Authorization\", \"__RP_TOK_1__\" },\n }\n};\n\nusing (var response = await client.SendAsync(request))\n{\n response.EnsureSuccessStatusCode();\n var body = await response.Content.ReadAsStringAsync();\n Console.WriteLine(body);\n}","templateHtml":"$8f","tokens":[{"marker":"__RP_TOK_0__","paramName":"location_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","path:location_id":"123e4567-e89b-12d3-a456-426614174000"}}],"https://sandbox-merchant.revolut.com":[{"id":"curl","label":"cURL","templateCode":"curl -X DELETE \"https://sandbox-merchant.revolut.com/api/locations/__RP_TOK_0__\" \\\n -H \"Authorization: __RP_TOK_1__\"","templateHtml":"
curl -X DELETE \"https://sandbox-merchant.revolut.com/api/locations/__RP_TOK_0__\" \\\n  -H \"Authorization: __RP_TOK_1__\"
","tokens":[{"marker":"__RP_TOK_0__","paramName":"location_id","paramIn":"path","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["shell-double-inner"]}],"defaults":{"header:Authorization":"Bearer ","path:location_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"javascript","label":"JavaScript","templateCode":"fetch(\"https://sandbox-merchant.revolut.com/api/locations/__RP_TOK_0__\", {\n method: \"DELETE\",\n headers: {\n \"Authorization\": \"__RP_TOK_1__\"\n }\n})\n .then(response => response.json())\n .then(data => console.log(data));","templateHtml":"$90","tokens":[{"marker":"__RP_TOK_0__","paramName":"location_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","path:location_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"go","label":"Go","templateCode":"package main\n\nimport (\n \"fmt\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://sandbox-merchant.revolut.com/api/locations/__RP_TOK_0__\"\n req, _ := http.NewRequest(\"DELETE\", url, nil)\n req.Header.Add(\"Authorization\", \"__RP_TOK_1__\")\n\n res, _ := http.DefaultClient.Do(req)\n defer res.Body.Close()\n fmt.Println(res)\n}","templateHtml":"$91","tokens":[{"marker":"__RP_TOK_0__","paramName":"location_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","path:location_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"python","label":"Python","templateCode":"import requests\n\nurl = \"https://sandbox-merchant.revolut.com/api/locations/__RP_TOK_0__\"\nheaders = {\n \"Authorization\": \"__RP_TOK_1__\"\n}\n\nresponse = requests.delete(url, headers=headers)\nprint(response.json())","templateHtml":"$92","tokens":[{"marker":"__RP_TOK_0__","paramName":"location_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","path:location_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"java","label":"Java","templateCode":"import java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\nimport java.net.URI;\n\npublic class Main {\n public static void main(String[] args) {\n HttpClient client = HttpClient.newHttpClient();\n HttpRequest request = HttpRequest.newBuilder()\n .uri(URI.create(\"https://sandbox-merchant.revolut.com/api/locations/__RP_TOK_0__\"))\n .header(\"Authorization\", \"__RP_TOK_1__\")\n .DELETE(HttpRequest.BodyPublishers.noBody())\n .build();\n\n client.sendAsync(request, HttpResponse.BodyHandlers.ofString())\n .thenApply(HttpResponse::body)\n .thenAccept(System.out::println)\n .join();\n }\n}","templateHtml":"$93","tokens":[{"marker":"__RP_TOK_0__","paramName":"location_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","path:location_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"csharp","label":"C#","templateCode":"using System.Net.Http;\nusing System.Net.Http.Headers;\n\nvar client = new HttpClient();\nvar request = new HttpRequestMessage\n{\n Method = HttpMethod.Delete,\n RequestUri = new Uri(\"https://sandbox-merchant.revolut.com/api/locations/__RP_TOK_0__\"),\n Headers =\n {\n { \"Authorization\", \"__RP_TOK_1__\" },\n }\n};\n\nusing (var response = await client.SendAsync(request))\n{\n response.EnsureSuccessStatusCode();\n var body = await response.Content.ReadAsStringAsync();\n Console.WriteLine(body);\n}","templateHtml":"$94","tokens":[{"marker":"__RP_TOK_0__","paramName":"location_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","path:location_id":"123e4567-e89b-12d3-a456-426614174000"}}]},"method":"delete","servers":["https://merchant.revolut.com","https://sandbox-merchant.revolut.com"],"path":"/api/locations/{location_id}","parameters":["$62:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:0","$62:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:1"]}],"$L95"],"$L96","$L97"]}]]}]]}]}],false]}] a2:T8bc,
fetch("https://merchant.revolut.com/api/synchronous-webhooks/__RP_TOK_0__", {
  method: "DELETE",
  headers: {
    "Authorization": "__RP_TOK_1__"
  }
})
  .then(response => response.json())
  .then(data => console.log(data));
a3:Tda4,
package main

import (
  "fmt"
  "net/http"
)

func main() {
  url := "https://merchant.revolut.com/api/synchronous-webhooks/__RP_TOK_0__"
  req, _ := http.NewRequest("DELETE", url, nil)
  req.Header.Add("Authorization", "__RP_TOK_1__")

  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  fmt.Println(res)
}
a4:T6d0,
import requests

url = "https://merchant.revolut.com/api/synchronous-webhooks/__RP_TOK_0__"
headers = {
  "Authorization": "__RP_TOK_1__"
}

response = requests.delete(url, headers=headers)
print(response.json())
a5:T1548,
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;

public class Main {
  public static void main(String[] args) {
    HttpClient client = HttpClient.newHttpClient();
    HttpRequest request = HttpRequest.newBuilder()
      .uri(URI.create("https://merchant.revolut.com/api/synchronous-webhooks/__RP_TOK_0__"))
      .header("Authorization", "__RP_TOK_1__")
      .DELETE(HttpRequest.BodyPublishers.noBody())
      .build();

    client.sendAsync(request, HttpResponse.BodyHandlers.ofString())
      .thenApply(HttpResponse::body)
      .thenAccept(System.out::println)
      .join();
  }
}
a6:T1468,
using System.Net.Http;
using System.Net.Http.Headers;

var client = new HttpClient();
var request = new HttpRequestMessage
{
  Method = HttpMethod.Delete,
  RequestUri = new Uri("https://merchant.revolut.com/api/synchronous-webhooks/__RP_TOK_0__"),
  Headers =
  {
    { "Authorization", "__RP_TOK_1__" },
  }
};

using (var response = await client.SendAsync(request))
{
  response.EnsureSuccessStatusCode();
  var body = await response.Content.ReadAsStringAsync();
  Console.WriteLine(body);
}
a7:T8c4,
fetch("https://sandbox-merchant.revolut.com/api/synchronous-webhooks/__RP_TOK_0__", {
  method: "DELETE",
  headers: {
    "Authorization": "__RP_TOK_1__"
  }
})
  .then(response => response.json())
  .then(data => console.log(data));
a8:Tdac,
package main

import (
  "fmt"
  "net/http"
)

func main() {
  url := "https://sandbox-merchant.revolut.com/api/synchronous-webhooks/__RP_TOK_0__"
  req, _ := http.NewRequest("DELETE", url, nil)
  req.Header.Add("Authorization", "__RP_TOK_1__")

  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  fmt.Println(res)
}
a9:T6d8,
import requests

url = "https://sandbox-merchant.revolut.com/api/synchronous-webhooks/__RP_TOK_0__"
headers = {
  "Authorization": "__RP_TOK_1__"
}

response = requests.delete(url, headers=headers)
print(response.json())
aa:T1550,
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;

public class Main {
  public static void main(String[] args) {
    HttpClient client = HttpClient.newHttpClient();
    HttpRequest request = HttpRequest.newBuilder()
      .uri(URI.create("https://sandbox-merchant.revolut.com/api/synchronous-webhooks/__RP_TOK_0__"))
      .header("Authorization", "__RP_TOK_1__")
      .DELETE(HttpRequest.BodyPublishers.noBody())
      .build();

    client.sendAsync(request, HttpResponse.BodyHandlers.ofString())
      .thenApply(HttpResponse::body)
      .thenAccept(System.out::println)
      .join();
  }
}
ab:T1470,
using System.Net.Http;
using System.Net.Http.Headers;

var client = new HttpClient();
var request = new HttpRequestMessage
{
  Method = HttpMethod.Delete,
  RequestUri = new Uri("https://sandbox-merchant.revolut.com/api/synchronous-webhooks/__RP_TOK_0__"),
  Headers =
  {
    { "Authorization", "__RP_TOK_1__" },
  }
};

using (var response = await client.SendAsync(request))
{
  response.EnsureSuccessStatusCode();
  var body = await response.Content.ReadAsStringAsync();
  Console.WriteLine(body);
}
6f:["$","$7a","delete-synchronous-webhook",{"children":[["$","section",null,{"className":"y9a0do0","data-variant":"endpoint","children":["$","$L7b",null,{"responses":{"204":{"description":"Synchronous webhook deleted","descriptionNode":"$L98"},"401":{"description":"Unauthorized","descriptionNode":"$L99"},"404":{"description":"Not Found","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"errorId":{"type":"string","description":"The ID of the error. You can share this ID with Revolut support for troubleshooting.","descriptionNode":"$L9a"},"timestamp":{"type":"integer","description":"The date and time the error happened.","descriptionNode":"$L9b"}},"required":"$62:props:children:0:props:children:props:responses:401:content:application/json:schema:required"}}},"descriptionNode":"$L9c"}},"requestBody":"$undefined","variantLabels":[],"children":[["$","div",null,{"className":"ezz1n30","children":[["$","div",null,{"data-header":"$undefined","className":"ezz1n31","children":["$","div",null,{"className":"y9a0do1","children":[["$","h2",null,{"id":"delete-synchronous-webhook","children":[["$L9d","$undefined"],["$","$L15",null,{"id":"delete-synchronous-webhook"}]]}],["$","$L16",null,{"url":"/docs/api/merchant/2025-10-16/operations/delete-synchronous-webhook.md"}]]}]}],"$undefined"]}],["$","div",null,{"className":"ezz1n30","children":[["$","div",null,{"data-header":"$undefined","className":"ezz1n31","children":["$L9e",["$","$L85",null,{"parameters":[{"name":"Authorization","in":"header","schema":{"type":"string","format":"Bearer ","examples":"$62:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:0:schema:examples"},"required":true,"description":"This parameter accepts the [Merchant API Secret key](https://business.revolut.com/settings/apis?tab=merchant-api) to authorise requests coming from the merchant's backend. \n\nIt ensures that ensures that each request is authenticated and authorised by verifying the secret key. The secret key should be included in all request headers as a `Bearer` token.\n\n:::info\nFor more information, see: [Authentication](https://developer.revolut.com/docs/api/merchant#authentication)\n:::","descriptionNode":"$L9f"},{"name":"synchronous_webhook_id","in":"path","schema":{"type":"string","format":"uuid","description":"A UUID string, typically used to identify resources.","descriptionNode":"$La0"},"required":true,"description":"The ID of the synchronous webhook.","descriptionNode":"$La1"}],"requestBody":"$undefined","heading":"Request","requestBodySchemaTitle":"Request body","headingAs":"h3"}],["$","$L89",null,{"responses":"$6f:props:children:0:props:children:props:responses","headingAs":"h3"}]]}],["$","div",null,{"className":"ezz1n32","children":[[["$","$L8a",null,{"itemsByServer":{"https://merchant.revolut.com":[{"id":"curl","label":"cURL","templateCode":"curl -X DELETE \"https://merchant.revolut.com/api/synchronous-webhooks/__RP_TOK_0__\" \\\n -H \"Authorization: __RP_TOK_1__\"","templateHtml":"
curl -X DELETE \"https://merchant.revolut.com/api/synchronous-webhooks/__RP_TOK_0__\" \\\n  -H \"Authorization: __RP_TOK_1__\"
","tokens":[{"marker":"__RP_TOK_0__","paramName":"synchronous_webhook_id","paramIn":"path","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["shell-double-inner"]}],"defaults":{"header:Authorization":"Bearer ","path:synchronous_webhook_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"javascript","label":"JavaScript","templateCode":"fetch(\"https://merchant.revolut.com/api/synchronous-webhooks/__RP_TOK_0__\", {\n method: \"DELETE\",\n headers: {\n \"Authorization\": \"__RP_TOK_1__\"\n }\n})\n .then(response => response.json())\n .then(data => console.log(data));","templateHtml":"$a2","tokens":[{"marker":"__RP_TOK_0__","paramName":"synchronous_webhook_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","path:synchronous_webhook_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"go","label":"Go","templateCode":"package main\n\nimport (\n \"fmt\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://merchant.revolut.com/api/synchronous-webhooks/__RP_TOK_0__\"\n req, _ := http.NewRequest(\"DELETE\", url, nil)\n req.Header.Add(\"Authorization\", \"__RP_TOK_1__\")\n\n res, _ := http.DefaultClient.Do(req)\n defer res.Body.Close()\n fmt.Println(res)\n}","templateHtml":"$a3","tokens":[{"marker":"__RP_TOK_0__","paramName":"synchronous_webhook_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","path:synchronous_webhook_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"python","label":"Python","templateCode":"import requests\n\nurl = \"https://merchant.revolut.com/api/synchronous-webhooks/__RP_TOK_0__\"\nheaders = {\n \"Authorization\": \"__RP_TOK_1__\"\n}\n\nresponse = requests.delete(url, headers=headers)\nprint(response.json())","templateHtml":"$a4","tokens":[{"marker":"__RP_TOK_0__","paramName":"synchronous_webhook_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","path:synchronous_webhook_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"java","label":"Java","templateCode":"import java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\nimport java.net.URI;\n\npublic class Main {\n public static void main(String[] args) {\n HttpClient client = HttpClient.newHttpClient();\n HttpRequest request = HttpRequest.newBuilder()\n .uri(URI.create(\"https://merchant.revolut.com/api/synchronous-webhooks/__RP_TOK_0__\"))\n .header(\"Authorization\", \"__RP_TOK_1__\")\n .DELETE(HttpRequest.BodyPublishers.noBody())\n .build();\n\n client.sendAsync(request, HttpResponse.BodyHandlers.ofString())\n .thenApply(HttpResponse::body)\n .thenAccept(System.out::println)\n .join();\n }\n}","templateHtml":"$a5","tokens":[{"marker":"__RP_TOK_0__","paramName":"synchronous_webhook_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","path:synchronous_webhook_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"csharp","label":"C#","templateCode":"using System.Net.Http;\nusing System.Net.Http.Headers;\n\nvar client = new HttpClient();\nvar request = new HttpRequestMessage\n{\n Method = HttpMethod.Delete,\n RequestUri = new Uri(\"https://merchant.revolut.com/api/synchronous-webhooks/__RP_TOK_0__\"),\n Headers =\n {\n { \"Authorization\", \"__RP_TOK_1__\" },\n }\n};\n\nusing (var response = await client.SendAsync(request))\n{\n response.EnsureSuccessStatusCode();\n var body = await response.Content.ReadAsStringAsync();\n Console.WriteLine(body);\n}","templateHtml":"$a6","tokens":[{"marker":"__RP_TOK_0__","paramName":"synchronous_webhook_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","path:synchronous_webhook_id":"123e4567-e89b-12d3-a456-426614174000"}}],"https://sandbox-merchant.revolut.com":[{"id":"curl","label":"cURL","templateCode":"curl -X DELETE \"https://sandbox-merchant.revolut.com/api/synchronous-webhooks/__RP_TOK_0__\" \\\n -H \"Authorization: __RP_TOK_1__\"","templateHtml":"
curl -X DELETE \"https://sandbox-merchant.revolut.com/api/synchronous-webhooks/__RP_TOK_0__\" \\\n  -H \"Authorization: __RP_TOK_1__\"
","tokens":[{"marker":"__RP_TOK_0__","paramName":"synchronous_webhook_id","paramIn":"path","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["shell-double-inner"]}],"defaults":{"header:Authorization":"Bearer ","path:synchronous_webhook_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"javascript","label":"JavaScript","templateCode":"fetch(\"https://sandbox-merchant.revolut.com/api/synchronous-webhooks/__RP_TOK_0__\", {\n method: \"DELETE\",\n headers: {\n \"Authorization\": \"__RP_TOK_1__\"\n }\n})\n .then(response => response.json())\n .then(data => console.log(data));","templateHtml":"$a7","tokens":[{"marker":"__RP_TOK_0__","paramName":"synchronous_webhook_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","path:synchronous_webhook_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"go","label":"Go","templateCode":"package main\n\nimport (\n \"fmt\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://sandbox-merchant.revolut.com/api/synchronous-webhooks/__RP_TOK_0__\"\n req, _ := http.NewRequest(\"DELETE\", url, nil)\n req.Header.Add(\"Authorization\", \"__RP_TOK_1__\")\n\n res, _ := http.DefaultClient.Do(req)\n defer res.Body.Close()\n fmt.Println(res)\n}","templateHtml":"$a8","tokens":[{"marker":"__RP_TOK_0__","paramName":"synchronous_webhook_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","path:synchronous_webhook_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"python","label":"Python","templateCode":"import requests\n\nurl = \"https://sandbox-merchant.revolut.com/api/synchronous-webhooks/__RP_TOK_0__\"\nheaders = {\n \"Authorization\": \"__RP_TOK_1__\"\n}\n\nresponse = requests.delete(url, headers=headers)\nprint(response.json())","templateHtml":"$a9","tokens":[{"marker":"__RP_TOK_0__","paramName":"synchronous_webhook_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","path:synchronous_webhook_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"java","label":"Java","templateCode":"import java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\nimport java.net.URI;\n\npublic class Main {\n public static void main(String[] args) {\n HttpClient client = HttpClient.newHttpClient();\n HttpRequest request = HttpRequest.newBuilder()\n .uri(URI.create(\"https://sandbox-merchant.revolut.com/api/synchronous-webhooks/__RP_TOK_0__\"))\n .header(\"Authorization\", \"__RP_TOK_1__\")\n .DELETE(HttpRequest.BodyPublishers.noBody())\n .build();\n\n client.sendAsync(request, HttpResponse.BodyHandlers.ofString())\n .thenApply(HttpResponse::body)\n .thenAccept(System.out::println)\n .join();\n }\n}","templateHtml":"$aa","tokens":[{"marker":"__RP_TOK_0__","paramName":"synchronous_webhook_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","path:synchronous_webhook_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"csharp","label":"C#","templateCode":"using System.Net.Http;\nusing System.Net.Http.Headers;\n\nvar client = new HttpClient();\nvar request = new HttpRequestMessage\n{\n Method = HttpMethod.Delete,\n RequestUri = new Uri(\"https://sandbox-merchant.revolut.com/api/synchronous-webhooks/__RP_TOK_0__\"),\n Headers =\n {\n { \"Authorization\", \"__RP_TOK_1__\" },\n }\n};\n\nusing (var response = await client.SendAsync(request))\n{\n response.EnsureSuccessStatusCode();\n var body = await response.Content.ReadAsStringAsync();\n Console.WriteLine(body);\n}","templateHtml":"$ab","tokens":[{"marker":"__RP_TOK_0__","paramName":"synchronous_webhook_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","path:synchronous_webhook_id":"123e4567-e89b-12d3-a456-426614174000"}}]},"method":"delete","servers":"$62:props:children:0:props:children:props:children:1:props:children:1:props:children:0:0:props:servers","path":"/api/synchronous-webhooks/{synchronous_webhook_id}","parameters":["$6f:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:0","$6f:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:1"]}],"$Lac"],"$Lad","$Lae"]}]]}]]}]}],false]}] be:T9d6,
fetch("https://merchant.revolut.com/api/customers/__RP_TOK_0__", {
  method: "DELETE",
  headers: {
    "Authorization": "__RP_TOK_1__",
    "Revolut-Api-Version": "__RP_TOK_2__"
  }
})
  .then(response => response.json())
  .then(data => console.log(data));
bf:Tf73,
package main

import (
  "fmt"
  "net/http"
)

func main() {
  url := "https://merchant.revolut.com/api/customers/__RP_TOK_0__"
  req, _ := http.NewRequest("DELETE", url, nil)
  req.Header.Add("Authorization", "__RP_TOK_1__")
  req.Header.Add("Revolut-Api-Version", "__RP_TOK_2__")

  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  fmt.Println(res)
}
c0:T7e8,
import requests

url = "https://merchant.revolut.com/api/customers/__RP_TOK_0__"
headers = {
  "Authorization": "__RP_TOK_1__",
  "Revolut-Api-Version": "__RP_TOK_2__"
}

response = requests.delete(url, headers=headers)
print(response.json())
c1:T1714,
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;

public class Main {
  public static void main(String[] args) {
    HttpClient client = HttpClient.newHttpClient();
    HttpRequest request = HttpRequest.newBuilder()
      .uri(URI.create("https://merchant.revolut.com/api/customers/__RP_TOK_0__"))
      .header("Authorization", "__RP_TOK_1__")
      .header("Revolut-Api-Version", "__RP_TOK_2__")
      .DELETE(HttpRequest.BodyPublishers.noBody())
      .build();

    client.sendAsync(request, HttpResponse.BodyHandlers.ofString())
      .thenApply(HttpResponse::body)
      .thenAccept(System.out::println)
      .join();
  }
}
c2:T15be,
using System.Net.Http;
using System.Net.Http.Headers;

var client = new HttpClient();
var request = new HttpRequestMessage
{
  Method = HttpMethod.Delete,
  RequestUri = new Uri("https://merchant.revolut.com/api/customers/__RP_TOK_0__"),
  Headers =
  {
    { "Authorization", "__RP_TOK_1__" },
    { "Revolut-Api-Version", "__RP_TOK_2__" },
  }
};

using (var response = await client.SendAsync(request))
{
  response.EnsureSuccessStatusCode();
  var body = await response.Content.ReadAsStringAsync();
  Console.WriteLine(body);
}
c3:T9de,
fetch("https://sandbox-merchant.revolut.com/api/customers/__RP_TOK_0__", {
  method: "DELETE",
  headers: {
    "Authorization": "__RP_TOK_1__",
    "Revolut-Api-Version": "__RP_TOK_2__"
  }
})
  .then(response => response.json())
  .then(data => console.log(data));
c4:Tf7b,
package main

import (
  "fmt"
  "net/http"
)

func main() {
  url := "https://sandbox-merchant.revolut.com/api/customers/__RP_TOK_0__"
  req, _ := http.NewRequest("DELETE", url, nil)
  req.Header.Add("Authorization", "__RP_TOK_1__")
  req.Header.Add("Revolut-Api-Version", "__RP_TOK_2__")

  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  fmt.Println(res)
}
c5:T7f0,
import requests

url = "https://sandbox-merchant.revolut.com/api/customers/__RP_TOK_0__"
headers = {
  "Authorization": "__RP_TOK_1__",
  "Revolut-Api-Version": "__RP_TOK_2__"
}

response = requests.delete(url, headers=headers)
print(response.json())
c6:T171c,
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;

public class Main {
  public static void main(String[] args) {
    HttpClient client = HttpClient.newHttpClient();
    HttpRequest request = HttpRequest.newBuilder()
      .uri(URI.create("https://sandbox-merchant.revolut.com/api/customers/__RP_TOK_0__"))
      .header("Authorization", "__RP_TOK_1__")
      .header("Revolut-Api-Version", "__RP_TOK_2__")
      .DELETE(HttpRequest.BodyPublishers.noBody())
      .build();

    client.sendAsync(request, HttpResponse.BodyHandlers.ofString())
      .thenApply(HttpResponse::body)
      .thenAccept(System.out::println)
      .join();
  }
}
c7:T15c6,
using System.Net.Http;
using System.Net.Http.Headers;

var client = new HttpClient();
var request = new HttpRequestMessage
{
  Method = HttpMethod.Delete,
  RequestUri = new Uri("https://sandbox-merchant.revolut.com/api/customers/__RP_TOK_0__"),
  Headers =
  {
    { "Authorization", "__RP_TOK_1__" },
    { "Revolut-Api-Version", "__RP_TOK_2__" },
  }
};

using (var response = await client.SendAsync(request))
{
  response.EnsureSuccessStatusCode();
  var body = await response.Content.ReadAsStringAsync();
  Console.WriteLine(body);
}
27:["$","$7a","delete-customer",{"children":[["$","section",null,{"className":"y9a0do0","data-variant":"endpoint","children":["$","$L7b",null,{"responses":{"204":{"description":"No Content","descriptionNode":"$Laf"},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"code":{"type":"string","description":"An identifier that can be used to determine what went wrong.\n\nError codes are not globally unique, but uniqueness is guaranteed within endpoints.","descriptionNode":"$Lb0"},"message":{"type":"string","description":"Some human readable text describing what went wrong.","descriptionNode":"$Lb1"},"timestamp":{"type":"integer","description":"The [UNIX timestamp](https://www.unixtimestamp.com/) of the date and time the error happened.","descriptionNode":"$Lb2"}}}}},"descriptionNode":"$Lb3"},"404":{"description":"Not Found","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"code":{"type":"string","description":"An identifier that can be used to determine what went wrong.\n\nError codes are not globally unique, but uniqueness is guaranteed within endpoints.","descriptionNode":"$Lb4"},"message":{"type":"string","description":"Some human readable text describing what went wrong.","descriptionNode":"$Lb5"},"timestamp":{"type":"integer","description":"The [UNIX timestamp](https://www.unixtimestamp.com/) of the date and time the error happened.","descriptionNode":"$Lb6"}}}}},"descriptionNode":"$Lb7"}},"requestBody":"$undefined","variantLabels":[],"children":[["$","div",null,{"className":"ezz1n30","children":[["$","div",null,{"data-header":"$undefined","className":"ezz1n31","children":["$","div",null,{"className":"y9a0do1","children":[["$","h2",null,{"id":"delete-customer","children":[["$Lb8","$undefined"],["$","$L15",null,{"id":"delete-customer"}]]}],["$","$L16",null,{"url":"/docs/api/merchant/2025-10-16/operations/delete-customer.md"}]]}]}],"$undefined"]}],["$","div",null,{"className":"ezz1n30","children":[["$","div",null,{"data-header":"$undefined","className":"ezz1n31","children":["$Lb9",["$","$L85",null,{"parameters":[{"name":"Authorization","in":"header","schema":{"type":"string","format":"Bearer ","examples":"$62:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:0:schema:examples"},"required":true,"description":"This parameter accepts the [Merchant API Secret key](https://business.revolut.com/settings/apis?tab=merchant-api) to authorise requests coming from the merchant's backend. \n\nIt ensures that ensures that each request is authenticated and authorised by verifying the secret key. The secret key should be included in all request headers as a `Bearer` token.\n\n:::info\nFor more information, see: [Authentication](https://developer.revolut.com/docs/api/merchant#authentication)\n:::","descriptionNode":"$Lba"},{"name":"Revolut-Api-Version","in":"header","schema":{"type":"string","format":"date","enum":["2024-09-01","2025-10-16","2025-12-04","2026-03-12","2026-04-20"],"examples":["2026-04-20"]},"required":true,"description":"The version of the Merchant API, specified in `YYYY-MM-DD` format.\n\nThis endpoint is available from version `2024-09-01`. If a version earlier than `2024-09-01` is provided, the endpoint returns a `404` response.\n\nIf not specified, you will receive an error.\n\n\n:::info\nFor more information about API versioning, see: [API versions](https://developer.revolut.com/docs/guides/merchant/reference/versioning/api-versions).\n:::","x-config-always-visible-in-example":true,"example":"2025-10-16","descriptionNode":"$Lbb"},{"name":"customer_id","in":"path","schema":{"type":"string","format":"uuid","description":"A UUID string, typically used to identify resources.","descriptionNode":"$Lbc"},"required":true,"description":"The ID of the `Customer` object.","descriptionNode":"$Lbd"}],"requestBody":"$undefined","heading":"Request","requestBodySchemaTitle":"Request body","headingAs":"h3"}],["$","$L89",null,{"responses":"$27:props:children:0:props:children:props:responses","headingAs":"h3"}]]}],["$","div",null,{"className":"ezz1n32","children":[[["$","$L8a",null,{"itemsByServer":{"https://merchant.revolut.com":[{"id":"curl","label":"cURL","templateCode":"curl -X DELETE \"https://merchant.revolut.com/api/customers/__RP_TOK_0__\" \\\n -H \"Authorization: __RP_TOK_1__\" \\\n -H \"Revolut-Api-Version: __RP_TOK_2__\"","templateHtml":"
curl -X DELETE \"https://merchant.revolut.com/api/customers/__RP_TOK_0__\" \\\n  -H \"Authorization: __RP_TOK_1__\" \\\n  -H \"Revolut-Api-Version: __RP_TOK_2__\"
","tokens":[{"marker":"__RP_TOK_0__","paramName":"customer_id","paramIn":"path","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["shell-double-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:customer_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"javascript","label":"JavaScript","templateCode":"fetch(\"https://merchant.revolut.com/api/customers/__RP_TOK_0__\", {\n method: \"DELETE\",\n headers: {\n \"Authorization\": \"__RP_TOK_1__\",\n \"Revolut-Api-Version\": \"__RP_TOK_2__\"\n }\n})\n .then(response => response.json())\n .then(data => console.log(data));","templateHtml":"$be","tokens":[{"marker":"__RP_TOK_0__","paramName":"customer_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:customer_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"go","label":"Go","templateCode":"package main\n\nimport (\n \"fmt\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://merchant.revolut.com/api/customers/__RP_TOK_0__\"\n req, _ := http.NewRequest(\"DELETE\", url, nil)\n req.Header.Add(\"Authorization\", \"__RP_TOK_1__\")\n req.Header.Add(\"Revolut-Api-Version\", \"__RP_TOK_2__\")\n\n res, _ := http.DefaultClient.Do(req)\n defer res.Body.Close()\n fmt.Println(res)\n}","templateHtml":"$bf","tokens":[{"marker":"__RP_TOK_0__","paramName":"customer_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:customer_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"python","label":"Python","templateCode":"import requests\n\nurl = \"https://merchant.revolut.com/api/customers/__RP_TOK_0__\"\nheaders = {\n \"Authorization\": \"__RP_TOK_1__\",\n \"Revolut-Api-Version\": \"__RP_TOK_2__\"\n}\n\nresponse = requests.delete(url, headers=headers)\nprint(response.json())","templateHtml":"$c0","tokens":[{"marker":"__RP_TOK_0__","paramName":"customer_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:customer_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"java","label":"Java","templateCode":"import java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\nimport java.net.URI;\n\npublic class Main {\n public static void main(String[] args) {\n HttpClient client = HttpClient.newHttpClient();\n HttpRequest request = HttpRequest.newBuilder()\n .uri(URI.create(\"https://merchant.revolut.com/api/customers/__RP_TOK_0__\"))\n .header(\"Authorization\", \"__RP_TOK_1__\")\n .header(\"Revolut-Api-Version\", \"__RP_TOK_2__\")\n .DELETE(HttpRequest.BodyPublishers.noBody())\n .build();\n\n client.sendAsync(request, HttpResponse.BodyHandlers.ofString())\n .thenApply(HttpResponse::body)\n .thenAccept(System.out::println)\n .join();\n }\n}","templateHtml":"$c1","tokens":[{"marker":"__RP_TOK_0__","paramName":"customer_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:customer_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"csharp","label":"C#","templateCode":"using System.Net.Http;\nusing System.Net.Http.Headers;\n\nvar client = new HttpClient();\nvar request = new HttpRequestMessage\n{\n Method = HttpMethod.Delete,\n RequestUri = new Uri(\"https://merchant.revolut.com/api/customers/__RP_TOK_0__\"),\n Headers =\n {\n { \"Authorization\", \"__RP_TOK_1__\" },\n { \"Revolut-Api-Version\", \"__RP_TOK_2__\" },\n }\n};\n\nusing (var response = await client.SendAsync(request))\n{\n response.EnsureSuccessStatusCode();\n var body = await response.Content.ReadAsStringAsync();\n Console.WriteLine(body);\n}","templateHtml":"$c2","tokens":[{"marker":"__RP_TOK_0__","paramName":"customer_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:customer_id":"123e4567-e89b-12d3-a456-426614174000"}}],"https://sandbox-merchant.revolut.com":[{"id":"curl","label":"cURL","templateCode":"curl -X DELETE \"https://sandbox-merchant.revolut.com/api/customers/__RP_TOK_0__\" \\\n -H \"Authorization: __RP_TOK_1__\" \\\n -H \"Revolut-Api-Version: __RP_TOK_2__\"","templateHtml":"
curl -X DELETE \"https://sandbox-merchant.revolut.com/api/customers/__RP_TOK_0__\" \\\n  -H \"Authorization: __RP_TOK_1__\" \\\n  -H \"Revolut-Api-Version: __RP_TOK_2__\"
","tokens":[{"marker":"__RP_TOK_0__","paramName":"customer_id","paramIn":"path","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["shell-double-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:customer_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"javascript","label":"JavaScript","templateCode":"fetch(\"https://sandbox-merchant.revolut.com/api/customers/__RP_TOK_0__\", {\n method: \"DELETE\",\n headers: {\n \"Authorization\": \"__RP_TOK_1__\",\n \"Revolut-Api-Version\": \"__RP_TOK_2__\"\n }\n})\n .then(response => response.json())\n .then(data => console.log(data));","templateHtml":"$c3","tokens":[{"marker":"__RP_TOK_0__","paramName":"customer_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:customer_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"go","label":"Go","templateCode":"package main\n\nimport (\n \"fmt\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://sandbox-merchant.revolut.com/api/customers/__RP_TOK_0__\"\n req, _ := http.NewRequest(\"DELETE\", url, nil)\n req.Header.Add(\"Authorization\", \"__RP_TOK_1__\")\n req.Header.Add(\"Revolut-Api-Version\", \"__RP_TOK_2__\")\n\n res, _ := http.DefaultClient.Do(req)\n defer res.Body.Close()\n fmt.Println(res)\n}","templateHtml":"$c4","tokens":[{"marker":"__RP_TOK_0__","paramName":"customer_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:customer_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"python","label":"Python","templateCode":"import requests\n\nurl = \"https://sandbox-merchant.revolut.com/api/customers/__RP_TOK_0__\"\nheaders = {\n \"Authorization\": \"__RP_TOK_1__\",\n \"Revolut-Api-Version\": \"__RP_TOK_2__\"\n}\n\nresponse = requests.delete(url, headers=headers)\nprint(response.json())","templateHtml":"$c5","tokens":[{"marker":"__RP_TOK_0__","paramName":"customer_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:customer_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"java","label":"Java","templateCode":"import java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\nimport java.net.URI;\n\npublic class Main {\n public static void main(String[] args) {\n HttpClient client = HttpClient.newHttpClient();\n HttpRequest request = HttpRequest.newBuilder()\n .uri(URI.create(\"https://sandbox-merchant.revolut.com/api/customers/__RP_TOK_0__\"))\n .header(\"Authorization\", \"__RP_TOK_1__\")\n .header(\"Revolut-Api-Version\", \"__RP_TOK_2__\")\n .DELETE(HttpRequest.BodyPublishers.noBody())\n .build();\n\n client.sendAsync(request, HttpResponse.BodyHandlers.ofString())\n .thenApply(HttpResponse::body)\n .thenAccept(System.out::println)\n .join();\n }\n}","templateHtml":"$c6","tokens":[{"marker":"__RP_TOK_0__","paramName":"customer_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:customer_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"csharp","label":"C#","templateCode":"using System.Net.Http;\nusing System.Net.Http.Headers;\n\nvar client = new HttpClient();\nvar request = new HttpRequestMessage\n{\n Method = HttpMethod.Delete,\n RequestUri = new Uri(\"https://sandbox-merchant.revolut.com/api/customers/__RP_TOK_0__\"),\n Headers =\n {\n { \"Authorization\", \"__RP_TOK_1__\" },\n { \"Revolut-Api-Version\", \"__RP_TOK_2__\" },\n }\n};\n\nusing (var response = await client.SendAsync(request))\n{\n response.EnsureSuccessStatusCode();\n var body = await response.Content.ReadAsStringAsync();\n Console.WriteLine(body);\n}","templateHtml":"$c7","tokens":[{"marker":"__RP_TOK_0__","paramName":"customer_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:customer_id":"123e4567-e89b-12d3-a456-426614174000"}}]},"method":"delete","servers":"$62:props:children:0:props:children:props:children:1:props:children:1:props:children:0:0:props:servers","path":"/api/customers/{customer_id}","parameters":["$27:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:0","$27:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:1","$27:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:2"]}],"$Lc8"],"$Lc9","$Lca"]}]]}]]}]}],false]}] 2b:["$","$7a","delete-payment-method",{"children":[["$","section",null,{"className":"y9a0do0","data-variant":"endpoint","children":["$","$L7b",null,{"responses":{"204":{"description":"No Content","descriptionNode":"$Lcb"},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"code":{"type":"string","description":"An identifier that can be used to determine what went wrong.\n\nError codes are not globally unique, but uniqueness is guaranteed within endpoints.","descriptionNode":"$Lcc"},"message":{"type":"string","description":"Some human readable text describing what went wrong.","descriptionNode":"$Lcd"},"timestamp":{"type":"integer","description":"The [UNIX timestamp](https://www.unixtimestamp.com/) of the date and time the error happened.","descriptionNode":"$Lce"}}}}},"descriptionNode":"$Lcf"},"404":{"description":"Not Found","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"code":{"type":"string","description":"An identifier that can be used to determine what went wrong.\n\nError codes are not globally unique, but uniqueness is guaranteed within endpoints.","descriptionNode":"$Ld0"},"message":{"type":"string","description":"Some human readable text describing what went wrong.","descriptionNode":"$Ld1"},"timestamp":{"type":"integer","description":"The [UNIX timestamp](https://www.unixtimestamp.com/) of the date and time the error happened.","descriptionNode":"$Ld2"}}}}},"descriptionNode":"$Ld3"}},"requestBody":"$undefined","variantLabels":[],"children":[["$","div",null,{"className":"ezz1n30","children":[["$","div",null,{"data-header":"$undefined","className":"ezz1n31","children":["$","div",null,{"className":"y9a0do1","children":[["$","h2",null,{"id":"delete-payment-method","children":[["$Ld4","$undefined"],["$","$L15",null,{"id":"delete-payment-method"}]]}],["$","$L16",null,{"url":"/docs/api/merchant/2025-10-16/operations/delete-payment-method.md"}]]}]}],"$undefined"]}],["$","div",null,{"className":"ezz1n30","children":[["$","div",null,{"data-header":"$undefined","className":"ezz1n31","children":["$Ld5",["$","$L85",null,{"parameters":[{"name":"Authorization","in":"header","schema":{"type":"string","format":"Bearer ","examples":"$62:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:0:schema:examples"},"required":true,"description":"This parameter accepts the [Merchant API Secret key](https://business.revolut.com/settings/apis?tab=merchant-api) to authorise requests coming from the merchant's backend. \n\nIt ensures that ensures that each request is authenticated and authorised by verifying the secret key. The secret key should be included in all request headers as a `Bearer` token.\n\n:::info\nFor more information, see: [Authentication](https://developer.revolut.com/docs/api/merchant#authentication)\n:::","descriptionNode":"$Ld6"},{"name":"Revolut-Api-Version","in":"header","schema":{"type":"string","format":"date","enum":"$27:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:1:schema:enum","examples":"$27:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:1:schema:examples"},"required":true,"description":"The version of the Merchant API, specified in `YYYY-MM-DD` format.\n\nThis endpoint is available from version `2024-09-01`. If a version earlier than `2024-09-01` is provided, the endpoint returns a `404` response.\n\nIf not specified, you will receive an error.\n\n\n:::info\nFor more information about API versioning, see: [API versions](https://developer.revolut.com/docs/guides/merchant/reference/versioning/api-versions).\n:::","x-config-always-visible-in-example":true,"example":"2025-10-16","descriptionNode":"$Ld7"},{"name":"customer_id","in":"path","schema":{"type":"string","format":"uuid","description":"A UUID string, typically used to identify resources.","descriptionNode":"$Ld8"},"required":true,"description":"The ID of the `Customer` object.","descriptionNode":"$Ld9"},{"name":"payment_method_id","in":"path","schema":{"type":"string","format":"uuid","description":"A UUID string, typically used to identify resources.","descriptionNode":"$Lda"},"required":true,"description":"The ID of the payment method.","descriptionNode":"$Ldb"}],"requestBody":"$undefined","heading":"Request","requestBodySchemaTitle":"Request body","headingAs":"h3"}],["$","$L89",null,{"responses":"$2b:props:children:0:props:children:props:responses","headingAs":"h3"}]]}],["$","div",null,{"className":"ezz1n32","children":"$Ldc"}]]}]]}]}],false]}] 36:["$","$7a","cancel-subscription",{"children":[["$","section",null,{"className":"y9a0do0","data-variant":"endpoint","children":["$","$L7b",null,{"responses":{"204":{"description":"Subscription cancelled successfully","descriptionNode":"$Ldd"},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"code":{"type":"string","description":"An identifier that can be used to determine what went wrong.\n\nError codes are not globally unique, but uniqueness is guaranteed within endpoints.","descriptionNode":"$Lde"},"message":{"type":"string","description":"Some human readable text describing what went wrong.","descriptionNode":"$Ldf"},"timestamp":{"type":"integer","description":"The [UNIX timestamp](https://www.unixtimestamp.com/) of the date and time the error happened.","descriptionNode":"$Le0"}}}}},"descriptionNode":"$Le1"},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"code":{"type":"string","description":"An identifier that can be used to determine what went wrong.\n\nError codes are not globally unique, but uniqueness is guaranteed within endpoints.","descriptionNode":"$Le2"},"message":{"type":"string","description":"Some human readable text describing what went wrong.","descriptionNode":"$Le3"},"timestamp":{"type":"integer","description":"The [UNIX timestamp](https://www.unixtimestamp.com/) of the date and time the error happened.","descriptionNode":"$Le4"}}}}},"descriptionNode":"$Le5"},"404":{"description":"Subscription not found","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"code":{"type":"string","description":"An identifier that can be used to determine what went wrong.\n\nError codes are not globally unique, but uniqueness is guaranteed within endpoints.","descriptionNode":"$Le6"},"message":{"type":"string","description":"Some human readable text describing what went wrong.","descriptionNode":"$Le7"},"timestamp":{"type":"integer","description":"The [UNIX timestamp](https://www.unixtimestamp.com/) of the date and time the error happened.","descriptionNode":"$Le8"}}}}},"descriptionNode":"$Le9"},"default":{"description":"Error response","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"code":{"type":"string","description":"An identifier that can be used to determine what went wrong.\n\nError codes are not globally unique, but uniqueness is guaranteed within endpoints.","descriptionNode":"$Lea"},"message":{"type":"string","description":"Some human readable text describing what went wrong.","descriptionNode":"$Leb"},"timestamp":{"type":"integer","description":"The [UNIX timestamp](https://www.unixtimestamp.com/) of the date and time the error happened.","descriptionNode":"$Lec"}}}}},"descriptionNode":"$Led"}},"requestBody":"$undefined","variantLabels":[],"children":[["$","div",null,{"className":"ezz1n30","children":[["$","div",null,{"data-header":"$undefined","className":"ezz1n31","children":["$","div",null,{"className":"y9a0do1","children":[["$","h2",null,{"id":"cancel-subscription","children":[["$Lee","$undefined"],["$","$L15",null,{"id":"cancel-subscription"}]]}],["$","$L16",null,{"url":"/docs/api/merchant/2025-10-16/operations/cancel-subscription.md"}]]}]}],"$undefined"]}],["$","div",null,{"className":"ezz1n30","children":[["$","div",null,{"data-header":"$undefined","className":"ezz1n31","children":["$Lef",["$","$L85",null,{"parameters":[{"name":"Authorization","in":"header","schema":{"type":"string","format":"Bearer ","examples":"$62:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:0:schema:examples"},"required":true,"description":"This parameter accepts the [Merchant API Secret key](https://business.revolut.com/settings/apis?tab=merchant-api) to authorise requests coming from the merchant's backend. \n\nIt ensures that ensures that each request is authenticated and authorised by verifying the secret key. The secret key should be included in all request headers as a `Bearer` token.\n\n:::info\nFor more information, see: [Authentication](https://developer.revolut.com/docs/api/merchant#authentication)\n:::","descriptionNode":"$Lf0"},{"name":"Revolut-Api-Version","in":"header","schema":{"type":"string","format":"date","enum":["2023-09-01","2024-05-01","2024-09-01","2025-10-16","2025-12-04","2026-03-12","2026-04-20"],"examples":["2026-04-20"]},"required":true,"description":"The version of the Merchant API, specified in `YYYY-MM-DD` format.\n\nIf not specified, you will receive an error.\n\n\n:::info\nFor more information about API versioning, see: [API versions](https://developer.revolut.com/docs/guides/merchant/reference/versioning/api-versions).\n:::","x-config-always-visible-in-example":true,"example":"2025-10-16","descriptionNode":"$Lf1"},{"name":"subscription_id","in":"path","schema":{"type":"string","format":"uuid","description":"A UUID string, typically used to identify resources.","descriptionNode":"$Lf2"},"required":true,"description":"The ID of the subscription.","descriptionNode":"$Lf3"}],"requestBody":"$undefined","heading":"Request","requestBodySchemaTitle":"Request body","headingAs":"h3"}],"$Lf4"]}],"$Lf5"]}]]}]}],false]}] 3f:["$","$7a","delete-subscription-usage",{"children":[["$","section",null,{"className":"y9a0do0","data-variant":"endpoint","children":["$","$L7b",null,{"responses":{"204":{"description":"Usage deleted successfully","descriptionNode":"$Lf6"},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"code":{"type":"string","description":"An identifier that can be used to determine what went wrong.\n\nError codes are not globally unique, but uniqueness is guaranteed within endpoints.","descriptionNode":"$Lf7"},"message":{"type":"string","description":"Some human readable text describing what went wrong.","descriptionNode":"$Lf8"},"timestamp":{"type":"integer","description":"The [UNIX timestamp](https://www.unixtimestamp.com/) of the date and time the error happened.","descriptionNode":"$Lf9"}}}}},"descriptionNode":"$Lfa"},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"code":{"type":"string","description":"An identifier that can be used to determine what went wrong.\n\nError codes are not globally unique, but uniqueness is guaranteed within endpoints.","descriptionNode":"$Lfb"},"message":{"type":"string","description":"Some human readable text describing what went wrong.","descriptionNode":"$Lfc"},"timestamp":{"type":"integer","description":"The [UNIX timestamp](https://www.unixtimestamp.com/) of the date and time the error happened.","descriptionNode":"$Lfd"}}}}},"descriptionNode":"$Lfe"},"404":{"description":"Usage not found","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"code":{"type":"string","description":"An identifier that can be used to determine what went wrong.\n\nError codes are not globally unique, but uniqueness is guaranteed within endpoints.","descriptionNode":"$Lff"},"message":{"type":"string","description":"Some human readable text describing what went wrong.","descriptionNode":"$L100"},"timestamp":{"type":"integer","description":"The [UNIX timestamp](https://www.unixtimestamp.com/) of the date and time the error happened.","descriptionNode":"$L101"}}}}},"descriptionNode":"$L102"},"422":{"description":"Unprocessable entity (business rule violation)","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"code":{"type":"string","description":"An identifier that can be used to determine what went wrong.\n\nError codes are not globally unique, but uniqueness is guaranteed within endpoints.","descriptionNode":"$L103"},"message":{"type":"string","description":"Some human readable text describing what went wrong.","descriptionNode":"$L104"},"timestamp":{"type":"integer","description":"The [UNIX timestamp](https://www.unixtimestamp.com/) of the date and time the error happened.","descriptionNode":"$L105"}}},"examples":{"usage_locked":{"summary":"Cycle is past the usage cutoff date","value":{"code":"subscription_usage_locked","message":"Cannot modify usage for a locked cycle","timestamp":1743465600}}}}},"descriptionNode":"$L106"},"default":{"description":"Error response","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"code":{"type":"string","description":"An identifier that can be used to determine what went wrong.\n\nError codes are not globally unique, but uniqueness is guaranteed within endpoints.","descriptionNode":"$L107"},"message":{"type":"string","description":"Some human readable text describing what went wrong.","descriptionNode":"$L108"},"timestamp":{"type":"integer","description":"The [UNIX timestamp](https://www.unixtimestamp.com/) of the date and time the error happened.","descriptionNode":"$L109"}}}}},"descriptionNode":"$L10a"}},"requestBody":"$undefined","variantLabels":[],"children":[["$","div",null,{"className":"ezz1n30","children":[["$","div",null,{"data-header":"$undefined","className":"ezz1n31","children":["$","div",null,{"className":"y9a0do1","children":[["$","h2",null,{"id":"delete-subscription-usage","children":[["$L10b","$undefined"],["$","$L15",null,{"id":"delete-subscription-usage"}]]}],["$","$L16",null,{"url":"/docs/api/merchant/2025-10-16/operations/delete-subscription-usage.md"}]]}]}],"$undefined"]}],"$L10c"]}]}],false]}] 10d:I["9e60c70d72c7",[],"Authorization",1] 10f:I["48c2ae8093a4",[],"RequestSample",1] 110:I["b2446624eec0",[],"ResponseSample",1] 95:["$","$L10d",null,{"security":[{"Api-Key":[]}],"authorization":{"Api-Key":{"type":"apiKey","in":"header","name":"Authorization","description":"Each Merchant API request must contain an authorization header in the following format:\n\n```\n'Authorization: Bearer '\n```\n\nTo use this API, you need to generate API keys from your Revolut Business account. The Secret key is used in the authorization header for all server calls, while the Public key is provided with payment methods at checkout.\n\n:::info\nFor detailed instructions on generating your API keys, see: [Generate API keys](https://developer.revolut.com/docs/guides/merchant/get-started#generate-api-keys).\n:::","descriptionNode":"$L10e"}}}] 96:["$","$L10f",null,{"exampleBlocks":{},"title":"Request body samples","headingAs":"h4"}] 97:["$","$L110",null,{"exampleBlocks":{"204":{},"401":{"application/json":{"variants":[{"key":"default","label":"Example","rawValue":{"errorId":"string","timestamp":123},"block":"$L111"}],"syncedPropertyName":"$undefined"}},"404":{"application/json":{"variants":[{"key":"default","label":"Example","rawValue":{"errorId":"string","timestamp":123},"block":"$L112"}],"syncedPropertyName":"$undefined"}}},"headingAs":"h4"}] ac:["$","$L10d",null,{"security":[{"Api-Key":[]}],"authorization":{"Api-Key":{"type":"apiKey","in":"header","name":"Authorization","description":"Each Merchant API request must contain an authorization header in the following format:\n\n```\n'Authorization: Bearer '\n```\n\nTo use this API, you need to generate API keys from your Revolut Business account. The Secret key is used in the authorization header for all server calls, while the Public key is provided with payment methods at checkout.\n\n:::info\nFor detailed instructions on generating your API keys, see: [Generate API keys](https://developer.revolut.com/docs/guides/merchant/get-started#generate-api-keys).\n:::","descriptionNode":"$L113"}}}] ad:["$","$L10f",null,{"exampleBlocks":{},"title":"Request body samples","headingAs":"h4"}] ae:["$","$L110",null,{"exampleBlocks":{"204":{},"401":{},"404":{"application/json":{"variants":[{"key":"default","label":"Example","rawValue":{"errorId":"string","timestamp":123},"block":"$L114"}],"syncedPropertyName":"$undefined"}}},"headingAs":"h4"}] c8:["$","$L10d",null,{"security":[{"Api-Key":[]}],"authorization":{"Api-Key":{"type":"apiKey","in":"header","name":"Authorization","description":"Each Merchant API request must contain an authorization header in the following format:\n\n```\n'Authorization: Bearer '\n```\n\nTo use this API, you need to generate API keys from your Revolut Business account. The Secret key is used in the authorization header for all server calls, while the Public key is provided with payment methods at checkout.\n\n:::info\nFor detailed instructions on generating your API keys, see: [Generate API keys](https://developer.revolut.com/docs/guides/merchant/get-started#generate-api-keys).\n:::","descriptionNode":"$L115"}}}] c9:["$","$L10f",null,{"exampleBlocks":{},"title":"Request body samples","headingAs":"h4"}] ca:["$","$L110",null,{"exampleBlocks":{"204":{},"401":{"application/json":{"variants":[{"key":"default","label":"Example","rawValue":{"code":"string","message":"string","timestamp":123},"block":"$L116"}],"syncedPropertyName":"$undefined"}},"404":{"application/json":{"variants":[{"key":"default","label":"Example","rawValue":{"code":"string","message":"string","timestamp":123},"block":"$L117"}],"syncedPropertyName":"$undefined"}}},"headingAs":"h4"}] 118:T9f3,
fetch("https://merchant.revolut.com/api/customers/__RP_TOK_0__/payment-methods/__RP_TOK_1__", {
  method: "DELETE",
  headers: {
    "Authorization": "__RP_TOK_2__",
    "Revolut-Api-Version": "__RP_TOK_3__"
  }
})
  .then(response => response.json())
  .then(data => console.log(data));
119:Tf90,
package main

import (
  "fmt"
  "net/http"
)

func main() {
  url := "https://merchant.revolut.com/api/customers/__RP_TOK_0__/payment-methods/__RP_TOK_1__"
  req, _ := http.NewRequest("DELETE", url, nil)
  req.Header.Add("Authorization", "__RP_TOK_2__")
  req.Header.Add("Revolut-Api-Version", "__RP_TOK_3__")

  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  fmt.Println(res)
}
11a:T805,
import requests

url = "https://merchant.revolut.com/api/customers/__RP_TOK_0__/payment-methods/__RP_TOK_1__"
headers = {
  "Authorization": "__RP_TOK_2__",
  "Revolut-Api-Version": "__RP_TOK_3__"
}

response = requests.delete(url, headers=headers)
print(response.json())
11b:T1731,
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;

public class Main {
  public static void main(String[] args) {
    HttpClient client = HttpClient.newHttpClient();
    HttpRequest request = HttpRequest.newBuilder()
      .uri(URI.create("https://merchant.revolut.com/api/customers/__RP_TOK_0__/payment-methods/__RP_TOK_1__"))
      .header("Authorization", "__RP_TOK_2__")
      .header("Revolut-Api-Version", "__RP_TOK_3__")
      .DELETE(HttpRequest.BodyPublishers.noBody())
      .build();

    client.sendAsync(request, HttpResponse.BodyHandlers.ofString())
      .thenApply(HttpResponse::body)
      .thenAccept(System.out::println)
      .join();
  }
}
11c:T15db,
using System.Net.Http;
using System.Net.Http.Headers;

var client = new HttpClient();
var request = new HttpRequestMessage
{
  Method = HttpMethod.Delete,
  RequestUri = new Uri("https://merchant.revolut.com/api/customers/__RP_TOK_0__/payment-methods/__RP_TOK_1__"),
  Headers =
  {
    { "Authorization", "__RP_TOK_2__" },
    { "Revolut-Api-Version", "__RP_TOK_3__" },
  }
};

using (var response = await client.SendAsync(request))
{
  response.EnsureSuccessStatusCode();
  var body = await response.Content.ReadAsStringAsync();
  Console.WriteLine(body);
}
11d:T9fb,
fetch("https://sandbox-merchant.revolut.com/api/customers/__RP_TOK_0__/payment-methods/__RP_TOK_1__", {
  method: "DELETE",
  headers: {
    "Authorization": "__RP_TOK_2__",
    "Revolut-Api-Version": "__RP_TOK_3__"
  }
})
  .then(response => response.json())
  .then(data => console.log(data));
11e:Tf98,
package main

import (
  "fmt"
  "net/http"
)

func main() {
  url := "https://sandbox-merchant.revolut.com/api/customers/__RP_TOK_0__/payment-methods/__RP_TOK_1__"
  req, _ := http.NewRequest("DELETE", url, nil)
  req.Header.Add("Authorization", "__RP_TOK_2__")
  req.Header.Add("Revolut-Api-Version", "__RP_TOK_3__")

  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  fmt.Println(res)
}
11f:T80d,
import requests

url = "https://sandbox-merchant.revolut.com/api/customers/__RP_TOK_0__/payment-methods/__RP_TOK_1__"
headers = {
  "Authorization": "__RP_TOK_2__",
  "Revolut-Api-Version": "__RP_TOK_3__"
}

response = requests.delete(url, headers=headers)
print(response.json())
120:T1739,
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;

public class Main {
  public static void main(String[] args) {
    HttpClient client = HttpClient.newHttpClient();
    HttpRequest request = HttpRequest.newBuilder()
      .uri(URI.create("https://sandbox-merchant.revolut.com/api/customers/__RP_TOK_0__/payment-methods/__RP_TOK_1__"))
      .header("Authorization", "__RP_TOK_2__")
      .header("Revolut-Api-Version", "__RP_TOK_3__")
      .DELETE(HttpRequest.BodyPublishers.noBody())
      .build();

    client.sendAsync(request, HttpResponse.BodyHandlers.ofString())
      .thenApply(HttpResponse::body)
      .thenAccept(System.out::println)
      .join();
  }
}
121:T15e3,
using System.Net.Http;
using System.Net.Http.Headers;

var client = new HttpClient();
var request = new HttpRequestMessage
{
  Method = HttpMethod.Delete,
  RequestUri = new Uri("https://sandbox-merchant.revolut.com/api/customers/__RP_TOK_0__/payment-methods/__RP_TOK_1__"),
  Headers =
  {
    { "Authorization", "__RP_TOK_2__" },
    { "Revolut-Api-Version", "__RP_TOK_3__" },
  }
};

using (var response = await client.SendAsync(request))
{
  response.EnsureSuccessStatusCode();
  var body = await response.Content.ReadAsStringAsync();
  Console.WriteLine(body);
}
dc:[[["$","$L8a",null,{"itemsByServer":{"https://merchant.revolut.com":[{"id":"curl","label":"cURL","templateCode":"curl -X DELETE \"https://merchant.revolut.com/api/customers/__RP_TOK_0__/payment-methods/__RP_TOK_1__\" \\\n -H \"Authorization: __RP_TOK_2__\" \\\n -H \"Revolut-Api-Version: __RP_TOK_3__\"","templateHtml":"
curl -X DELETE \"https://merchant.revolut.com/api/customers/__RP_TOK_0__/payment-methods/__RP_TOK_1__\" \\\n  -H \"Authorization: __RP_TOK_2__\" \\\n  -H \"Revolut-Api-Version: __RP_TOK_3__\"
","tokens":[{"marker":"__RP_TOK_0__","paramName":"customer_id","paramIn":"path","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_1__","paramName":"payment_method_id","paramIn":"path","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_2__","paramName":"Authorization","paramIn":"header","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_3__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["shell-double-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:customer_id":"123e4567-e89b-12d3-a456-426614174000","path:payment_method_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"javascript","label":"JavaScript","templateCode":"fetch(\"https://merchant.revolut.com/api/customers/__RP_TOK_0__/payment-methods/__RP_TOK_1__\", {\n method: \"DELETE\",\n headers: {\n \"Authorization\": \"__RP_TOK_2__\",\n \"Revolut-Api-Version\": \"__RP_TOK_3__\"\n }\n})\n .then(response => response.json())\n .then(data => console.log(data));","templateHtml":"$118","tokens":[{"marker":"__RP_TOK_0__","paramName":"customer_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"payment_method_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_3__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:customer_id":"123e4567-e89b-12d3-a456-426614174000","path:payment_method_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"go","label":"Go","templateCode":"package main\n\nimport (\n \"fmt\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://merchant.revolut.com/api/customers/__RP_TOK_0__/payment-methods/__RP_TOK_1__\"\n req, _ := http.NewRequest(\"DELETE\", url, nil)\n req.Header.Add(\"Authorization\", \"__RP_TOK_2__\")\n req.Header.Add(\"Revolut-Api-Version\", \"__RP_TOK_3__\")\n\n res, _ := http.DefaultClient.Do(req)\n defer res.Body.Close()\n fmt.Println(res)\n}","templateHtml":"$119","tokens":[{"marker":"__RP_TOK_0__","paramName":"customer_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"payment_method_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_3__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:customer_id":"123e4567-e89b-12d3-a456-426614174000","path:payment_method_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"python","label":"Python","templateCode":"import requests\n\nurl = \"https://merchant.revolut.com/api/customers/__RP_TOK_0__/payment-methods/__RP_TOK_1__\"\nheaders = {\n \"Authorization\": \"__RP_TOK_2__\",\n \"Revolut-Api-Version\": \"__RP_TOK_3__\"\n}\n\nresponse = requests.delete(url, headers=headers)\nprint(response.json())","templateHtml":"$11a","tokens":[{"marker":"__RP_TOK_0__","paramName":"customer_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"payment_method_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_3__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:customer_id":"123e4567-e89b-12d3-a456-426614174000","path:payment_method_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"java","label":"Java","templateCode":"import java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\nimport java.net.URI;\n\npublic class Main {\n public static void main(String[] args) {\n HttpClient client = HttpClient.newHttpClient();\n HttpRequest request = HttpRequest.newBuilder()\n .uri(URI.create(\"https://merchant.revolut.com/api/customers/__RP_TOK_0__/payment-methods/__RP_TOK_1__\"))\n .header(\"Authorization\", \"__RP_TOK_2__\")\n .header(\"Revolut-Api-Version\", \"__RP_TOK_3__\")\n .DELETE(HttpRequest.BodyPublishers.noBody())\n .build();\n\n client.sendAsync(request, HttpResponse.BodyHandlers.ofString())\n .thenApply(HttpResponse::body)\n .thenAccept(System.out::println)\n .join();\n }\n}","templateHtml":"$11b","tokens":[{"marker":"__RP_TOK_0__","paramName":"customer_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"payment_method_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_3__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:customer_id":"123e4567-e89b-12d3-a456-426614174000","path:payment_method_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"csharp","label":"C#","templateCode":"using System.Net.Http;\nusing System.Net.Http.Headers;\n\nvar client = new HttpClient();\nvar request = new HttpRequestMessage\n{\n Method = HttpMethod.Delete,\n RequestUri = new Uri(\"https://merchant.revolut.com/api/customers/__RP_TOK_0__/payment-methods/__RP_TOK_1__\"),\n Headers =\n {\n { \"Authorization\", \"__RP_TOK_2__\" },\n { \"Revolut-Api-Version\", \"__RP_TOK_3__\" },\n }\n};\n\nusing (var response = await client.SendAsync(request))\n{\n response.EnsureSuccessStatusCode();\n var body = await response.Content.ReadAsStringAsync();\n Console.WriteLine(body);\n}","templateHtml":"$11c","tokens":[{"marker":"__RP_TOK_0__","paramName":"customer_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"payment_method_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_3__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:customer_id":"123e4567-e89b-12d3-a456-426614174000","path:payment_method_id":"123e4567-e89b-12d3-a456-426614174000"}}],"https://sandbox-merchant.revolut.com":[{"id":"curl","label":"cURL","templateCode":"curl -X DELETE \"https://sandbox-merchant.revolut.com/api/customers/__RP_TOK_0__/payment-methods/__RP_TOK_1__\" \\\n -H \"Authorization: __RP_TOK_2__\" \\\n -H \"Revolut-Api-Version: __RP_TOK_3__\"","templateHtml":"
curl -X DELETE \"https://sandbox-merchant.revolut.com/api/customers/__RP_TOK_0__/payment-methods/__RP_TOK_1__\" \\\n  -H \"Authorization: __RP_TOK_2__\" \\\n  -H \"Revolut-Api-Version: __RP_TOK_3__\"
","tokens":[{"marker":"__RP_TOK_0__","paramName":"customer_id","paramIn":"path","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_1__","paramName":"payment_method_id","paramIn":"path","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_2__","paramName":"Authorization","paramIn":"header","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_3__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["shell-double-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:customer_id":"123e4567-e89b-12d3-a456-426614174000","path:payment_method_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"javascript","label":"JavaScript","templateCode":"fetch(\"https://sandbox-merchant.revolut.com/api/customers/__RP_TOK_0__/payment-methods/__RP_TOK_1__\", {\n method: \"DELETE\",\n headers: {\n \"Authorization\": \"__RP_TOK_2__\",\n \"Revolut-Api-Version\": \"__RP_TOK_3__\"\n }\n})\n .then(response => response.json())\n .then(data => console.log(data));","templateHtml":"$11d","tokens":[{"marker":"__RP_TOK_0__","paramName":"customer_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"payment_method_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_3__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:customer_id":"123e4567-e89b-12d3-a456-426614174000","path:payment_method_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"go","label":"Go","templateCode":"package main\n\nimport (\n \"fmt\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://sandbox-merchant.revolut.com/api/customers/__RP_TOK_0__/payment-methods/__RP_TOK_1__\"\n req, _ := http.NewRequest(\"DELETE\", url, nil)\n req.Header.Add(\"Authorization\", \"__RP_TOK_2__\")\n req.Header.Add(\"Revolut-Api-Version\", \"__RP_TOK_3__\")\n\n res, _ := http.DefaultClient.Do(req)\n defer res.Body.Close()\n fmt.Println(res)\n}","templateHtml":"$11e","tokens":[{"marker":"__RP_TOK_0__","paramName":"customer_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"payment_method_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_3__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:customer_id":"123e4567-e89b-12d3-a456-426614174000","path:payment_method_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"python","label":"Python","templateCode":"import requests\n\nurl = \"https://sandbox-merchant.revolut.com/api/customers/__RP_TOK_0__/payment-methods/__RP_TOK_1__\"\nheaders = {\n \"Authorization\": \"__RP_TOK_2__\",\n \"Revolut-Api-Version\": \"__RP_TOK_3__\"\n}\n\nresponse = requests.delete(url, headers=headers)\nprint(response.json())","templateHtml":"$11f","tokens":[{"marker":"__RP_TOK_0__","paramName":"customer_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"payment_method_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_3__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:customer_id":"123e4567-e89b-12d3-a456-426614174000","path:payment_method_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"java","label":"Java","templateCode":"import java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\nimport java.net.URI;\n\npublic class Main {\n public static void main(String[] args) {\n HttpClient client = HttpClient.newHttpClient();\n HttpRequest request = HttpRequest.newBuilder()\n .uri(URI.create(\"https://sandbox-merchant.revolut.com/api/customers/__RP_TOK_0__/payment-methods/__RP_TOK_1__\"))\n .header(\"Authorization\", \"__RP_TOK_2__\")\n .header(\"Revolut-Api-Version\", \"__RP_TOK_3__\")\n .DELETE(HttpRequest.BodyPublishers.noBody())\n .build();\n\n client.sendAsync(request, HttpResponse.BodyHandlers.ofString())\n .thenApply(HttpResponse::body)\n .thenAccept(System.out::println)\n .join();\n }\n}","templateHtml":"$120","tokens":[{"marker":"__RP_TOK_0__","paramName":"customer_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"payment_method_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_3__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:customer_id":"123e4567-e89b-12d3-a456-426614174000","path:payment_method_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"csharp","label":"C#","templateCode":"using System.Net.Http;\nusing System.Net.Http.Headers;\n\nvar client = new HttpClient();\nvar request = new HttpRequestMessage\n{\n Method = HttpMethod.Delete,\n RequestUri = new Uri(\"https://sandbox-merchant.revolut.com/api/customers/__RP_TOK_0__/payment-methods/__RP_TOK_1__\"),\n Headers =\n {\n { \"Authorization\", \"__RP_TOK_2__\" },\n { \"Revolut-Api-Version\", \"__RP_TOK_3__\" },\n }\n};\n\nusing (var response = await client.SendAsync(request))\n{\n response.EnsureSuccessStatusCode();\n var body = await response.Content.ReadAsStringAsync();\n Console.WriteLine(body);\n}","templateHtml":"$121","tokens":[{"marker":"__RP_TOK_0__","paramName":"customer_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"payment_method_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_3__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:customer_id":"123e4567-e89b-12d3-a456-426614174000","path:payment_method_id":"123e4567-e89b-12d3-a456-426614174000"}}]},"method":"delete","servers":"$62:props:children:0:props:children:props:children:1:props:children:1:props:children:0:0:props:servers","path":"/api/customers/{customer_id}/payment-methods/{payment_method_id}","parameters":["$2b:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:0","$2b:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:1","$2b:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:2","$2b:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:3"]}],"$L122"],"$L123","$L124"] f4:["$","$L89",null,{"responses":"$36:props:children:0:props:children:props:responses","headingAs":"h3"}] 125:T9df,
fetch("https://merchant.revolut.com/api/subscriptions/__RP_TOK_0__/cancel", {
  method: "POST",
  headers: {
    "Authorization": "__RP_TOK_1__",
    "Revolut-Api-Version": "__RP_TOK_2__"
  }
})
  .then(response => response.json())
  .then(data => console.log(data));
126:Tf7c,
package main

import (
  "fmt"
  "net/http"
)

func main() {
  url := "https://merchant.revolut.com/api/subscriptions/__RP_TOK_0__/cancel"
  req, _ := http.NewRequest("POST", url, nil)
  req.Header.Add("Authorization", "__RP_TOK_1__")
  req.Header.Add("Revolut-Api-Version", "__RP_TOK_2__")

  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  fmt.Println(res)
}
127:T7f1,
import requests

url = "https://merchant.revolut.com/api/subscriptions/__RP_TOK_0__/cancel"
headers = {
  "Authorization": "__RP_TOK_1__",
  "Revolut-Api-Version": "__RP_TOK_2__"
}

response = requests.post(url, headers=headers)
print(response.json())
128:T171d,
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;

public class Main {
  public static void main(String[] args) {
    HttpClient client = HttpClient.newHttpClient();
    HttpRequest request = HttpRequest.newBuilder()
      .uri(URI.create("https://merchant.revolut.com/api/subscriptions/__RP_TOK_0__/cancel"))
      .header("Authorization", "__RP_TOK_1__")
      .header("Revolut-Api-Version", "__RP_TOK_2__")
      .POST(HttpRequest.BodyPublishers.noBody())
      .build();

    client.sendAsync(request, HttpResponse.BodyHandlers.ofString())
      .thenApply(HttpResponse::body)
      .thenAccept(System.out::println)
      .join();
  }
}
129:T15c7,
using System.Net.Http;
using System.Net.Http.Headers;

var client = new HttpClient();
var request = new HttpRequestMessage
{
  Method = HttpMethod.Post,
  RequestUri = new Uri("https://merchant.revolut.com/api/subscriptions/__RP_TOK_0__/cancel"),
  Headers =
  {
    { "Authorization", "__RP_TOK_1__" },
    { "Revolut-Api-Version", "__RP_TOK_2__" },
  }
};

using (var response = await client.SendAsync(request))
{
  response.EnsureSuccessStatusCode();
  var body = await response.Content.ReadAsStringAsync();
  Console.WriteLine(body);
}
12a:T9e7,
fetch("https://sandbox-merchant.revolut.com/api/subscriptions/__RP_TOK_0__/cancel", {
  method: "POST",
  headers: {
    "Authorization": "__RP_TOK_1__",
    "Revolut-Api-Version": "__RP_TOK_2__"
  }
})
  .then(response => response.json())
  .then(data => console.log(data));
12b:Tf84,
package main

import (
  "fmt"
  "net/http"
)

func main() {
  url := "https://sandbox-merchant.revolut.com/api/subscriptions/__RP_TOK_0__/cancel"
  req, _ := http.NewRequest("POST", url, nil)
  req.Header.Add("Authorization", "__RP_TOK_1__")
  req.Header.Add("Revolut-Api-Version", "__RP_TOK_2__")

  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  fmt.Println(res)
}
12c:T7f9,
import requests

url = "https://sandbox-merchant.revolut.com/api/subscriptions/__RP_TOK_0__/cancel"
headers = {
  "Authorization": "__RP_TOK_1__",
  "Revolut-Api-Version": "__RP_TOK_2__"
}

response = requests.post(url, headers=headers)
print(response.json())
12d:T1725,
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;

public class Main {
  public static void main(String[] args) {
    HttpClient client = HttpClient.newHttpClient();
    HttpRequest request = HttpRequest.newBuilder()
      .uri(URI.create("https://sandbox-merchant.revolut.com/api/subscriptions/__RP_TOK_0__/cancel"))
      .header("Authorization", "__RP_TOK_1__")
      .header("Revolut-Api-Version", "__RP_TOK_2__")
      .POST(HttpRequest.BodyPublishers.noBody())
      .build();

    client.sendAsync(request, HttpResponse.BodyHandlers.ofString())
      .thenApply(HttpResponse::body)
      .thenAccept(System.out::println)
      .join();
  }
}
12e:T15cf,
using System.Net.Http;
using System.Net.Http.Headers;

var client = new HttpClient();
var request = new HttpRequestMessage
{
  Method = HttpMethod.Post,
  RequestUri = new Uri("https://sandbox-merchant.revolut.com/api/subscriptions/__RP_TOK_0__/cancel"),
  Headers =
  {
    { "Authorization", "__RP_TOK_1__" },
    { "Revolut-Api-Version", "__RP_TOK_2__" },
  }
};

using (var response = await client.SendAsync(request))
{
  response.EnsureSuccessStatusCode();
  var body = await response.Content.ReadAsStringAsync();
  Console.WriteLine(body);
}
f5:["$","div",null,{"className":"ezz1n32","children":[[["$","$L8a",null,{"itemsByServer":{"https://merchant.revolut.com":[{"id":"curl","label":"cURL","templateCode":"curl -X POST \"https://merchant.revolut.com/api/subscriptions/__RP_TOK_0__/cancel\" \\\n -H \"Authorization: __RP_TOK_1__\" \\\n -H \"Revolut-Api-Version: __RP_TOK_2__\"","templateHtml":"
curl -X POST \"https://merchant.revolut.com/api/subscriptions/__RP_TOK_0__/cancel\" \\\n  -H \"Authorization: __RP_TOK_1__\" \\\n  -H \"Revolut-Api-Version: __RP_TOK_2__\"
","tokens":[{"marker":"__RP_TOK_0__","paramName":"subscription_id","paramIn":"path","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["shell-double-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:subscription_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"javascript","label":"JavaScript","templateCode":"fetch(\"https://merchant.revolut.com/api/subscriptions/__RP_TOK_0__/cancel\", {\n method: \"POST\",\n headers: {\n \"Authorization\": \"__RP_TOK_1__\",\n \"Revolut-Api-Version\": \"__RP_TOK_2__\"\n }\n})\n .then(response => response.json())\n .then(data => console.log(data));","templateHtml":"$125","tokens":[{"marker":"__RP_TOK_0__","paramName":"subscription_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:subscription_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"go","label":"Go","templateCode":"package main\n\nimport (\n \"fmt\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://merchant.revolut.com/api/subscriptions/__RP_TOK_0__/cancel\"\n req, _ := http.NewRequest(\"POST\", url, nil)\n req.Header.Add(\"Authorization\", \"__RP_TOK_1__\")\n req.Header.Add(\"Revolut-Api-Version\", \"__RP_TOK_2__\")\n\n res, _ := http.DefaultClient.Do(req)\n defer res.Body.Close()\n fmt.Println(res)\n}","templateHtml":"$126","tokens":[{"marker":"__RP_TOK_0__","paramName":"subscription_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:subscription_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"python","label":"Python","templateCode":"import requests\n\nurl = \"https://merchant.revolut.com/api/subscriptions/__RP_TOK_0__/cancel\"\nheaders = {\n \"Authorization\": \"__RP_TOK_1__\",\n \"Revolut-Api-Version\": \"__RP_TOK_2__\"\n}\n\nresponse = requests.post(url, headers=headers)\nprint(response.json())","templateHtml":"$127","tokens":[{"marker":"__RP_TOK_0__","paramName":"subscription_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:subscription_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"java","label":"Java","templateCode":"import java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\nimport java.net.URI;\n\npublic class Main {\n public static void main(String[] args) {\n HttpClient client = HttpClient.newHttpClient();\n HttpRequest request = HttpRequest.newBuilder()\n .uri(URI.create(\"https://merchant.revolut.com/api/subscriptions/__RP_TOK_0__/cancel\"))\n .header(\"Authorization\", \"__RP_TOK_1__\")\n .header(\"Revolut-Api-Version\", \"__RP_TOK_2__\")\n .POST(HttpRequest.BodyPublishers.noBody())\n .build();\n\n client.sendAsync(request, HttpResponse.BodyHandlers.ofString())\n .thenApply(HttpResponse::body)\n .thenAccept(System.out::println)\n .join();\n }\n}","templateHtml":"$128","tokens":[{"marker":"__RP_TOK_0__","paramName":"subscription_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:subscription_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"csharp","label":"C#","templateCode":"using System.Net.Http;\nusing System.Net.Http.Headers;\n\nvar client = new HttpClient();\nvar request = new HttpRequestMessage\n{\n Method = HttpMethod.Post,\n RequestUri = new Uri(\"https://merchant.revolut.com/api/subscriptions/__RP_TOK_0__/cancel\"),\n Headers =\n {\n { \"Authorization\", \"__RP_TOK_1__\" },\n { \"Revolut-Api-Version\", \"__RP_TOK_2__\" },\n }\n};\n\nusing (var response = await client.SendAsync(request))\n{\n response.EnsureSuccessStatusCode();\n var body = await response.Content.ReadAsStringAsync();\n Console.WriteLine(body);\n}","templateHtml":"$129","tokens":[{"marker":"__RP_TOK_0__","paramName":"subscription_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:subscription_id":"123e4567-e89b-12d3-a456-426614174000"}}],"https://sandbox-merchant.revolut.com":[{"id":"curl","label":"cURL","templateCode":"curl -X POST \"https://sandbox-merchant.revolut.com/api/subscriptions/__RP_TOK_0__/cancel\" \\\n -H \"Authorization: __RP_TOK_1__\" \\\n -H \"Revolut-Api-Version: __RP_TOK_2__\"","templateHtml":"
curl -X POST \"https://sandbox-merchant.revolut.com/api/subscriptions/__RP_TOK_0__/cancel\" \\\n  -H \"Authorization: __RP_TOK_1__\" \\\n  -H \"Revolut-Api-Version: __RP_TOK_2__\"
","tokens":[{"marker":"__RP_TOK_0__","paramName":"subscription_id","paramIn":"path","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["shell-double-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:subscription_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"javascript","label":"JavaScript","templateCode":"fetch(\"https://sandbox-merchant.revolut.com/api/subscriptions/__RP_TOK_0__/cancel\", {\n method: \"POST\",\n headers: {\n \"Authorization\": \"__RP_TOK_1__\",\n \"Revolut-Api-Version\": \"__RP_TOK_2__\"\n }\n})\n .then(response => response.json())\n .then(data => console.log(data));","templateHtml":"$12a","tokens":[{"marker":"__RP_TOK_0__","paramName":"subscription_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:subscription_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"go","label":"Go","templateCode":"package main\n\nimport (\n \"fmt\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://sandbox-merchant.revolut.com/api/subscriptions/__RP_TOK_0__/cancel\"\n req, _ := http.NewRequest(\"POST\", url, nil)\n req.Header.Add(\"Authorization\", \"__RP_TOK_1__\")\n req.Header.Add(\"Revolut-Api-Version\", \"__RP_TOK_2__\")\n\n res, _ := http.DefaultClient.Do(req)\n defer res.Body.Close()\n fmt.Println(res)\n}","templateHtml":"$12b","tokens":[{"marker":"__RP_TOK_0__","paramName":"subscription_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:subscription_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"python","label":"Python","templateCode":"import requests\n\nurl = \"https://sandbox-merchant.revolut.com/api/subscriptions/__RP_TOK_0__/cancel\"\nheaders = {\n \"Authorization\": \"__RP_TOK_1__\",\n \"Revolut-Api-Version\": \"__RP_TOK_2__\"\n}\n\nresponse = requests.post(url, headers=headers)\nprint(response.json())","templateHtml":"$12c","tokens":[{"marker":"__RP_TOK_0__","paramName":"subscription_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:subscription_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"java","label":"Java","templateCode":"import java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\nimport java.net.URI;\n\npublic class Main {\n public static void main(String[] args) {\n HttpClient client = HttpClient.newHttpClient();\n HttpRequest request = HttpRequest.newBuilder()\n .uri(URI.create(\"https://sandbox-merchant.revolut.com/api/subscriptions/__RP_TOK_0__/cancel\"))\n .header(\"Authorization\", \"__RP_TOK_1__\")\n .header(\"Revolut-Api-Version\", \"__RP_TOK_2__\")\n .POST(HttpRequest.BodyPublishers.noBody())\n .build();\n\n client.sendAsync(request, HttpResponse.BodyHandlers.ofString())\n .thenApply(HttpResponse::body)\n .thenAccept(System.out::println)\n .join();\n }\n}","templateHtml":"$12d","tokens":[{"marker":"__RP_TOK_0__","paramName":"subscription_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:subscription_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"csharp","label":"C#","templateCode":"using System.Net.Http;\nusing System.Net.Http.Headers;\n\nvar client = new HttpClient();\nvar request = new HttpRequestMessage\n{\n Method = HttpMethod.Post,\n RequestUri = new Uri(\"https://sandbox-merchant.revolut.com/api/subscriptions/__RP_TOK_0__/cancel\"),\n Headers =\n {\n { \"Authorization\", \"__RP_TOK_1__\" },\n { \"Revolut-Api-Version\", \"__RP_TOK_2__\" },\n }\n};\n\nusing (var response = await client.SendAsync(request))\n{\n response.EnsureSuccessStatusCode();\n var body = await response.Content.ReadAsStringAsync();\n Console.WriteLine(body);\n}","templateHtml":"$12e","tokens":[{"marker":"__RP_TOK_0__","paramName":"subscription_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:subscription_id":"123e4567-e89b-12d3-a456-426614174000"}}]},"method":"post","servers":"$62:props:children:0:props:children:props:children:1:props:children:1:props:children:0:0:props:servers","path":"/api/subscriptions/{subscription_id}/cancel","parameters":["$36:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:0","$36:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:1","$36:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:2"]}],"$L12f"],"$L130","$L131"]}] 137:T9e0,
fetch("https://merchant.revolut.com/api/subscription-usages/__RP_TOK_0__", {
  method: "DELETE",
  headers: {
    "Authorization": "__RP_TOK_1__",
    "Revolut-Api-Version": "__RP_TOK_2__"
  }
})
  .then(response => response.json())
  .then(data => console.log(data));
138:Tf7d,
package main

import (
  "fmt"
  "net/http"
)

func main() {
  url := "https://merchant.revolut.com/api/subscription-usages/__RP_TOK_0__"
  req, _ := http.NewRequest("DELETE", url, nil)
  req.Header.Add("Authorization", "__RP_TOK_1__")
  req.Header.Add("Revolut-Api-Version", "__RP_TOK_2__")

  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  fmt.Println(res)
}
139:T7f2,
import requests

url = "https://merchant.revolut.com/api/subscription-usages/__RP_TOK_0__"
headers = {
  "Authorization": "__RP_TOK_1__",
  "Revolut-Api-Version": "__RP_TOK_2__"
}

response = requests.delete(url, headers=headers)
print(response.json())
13a:T171e,
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;

public class Main {
  public static void main(String[] args) {
    HttpClient client = HttpClient.newHttpClient();
    HttpRequest request = HttpRequest.newBuilder()
      .uri(URI.create("https://merchant.revolut.com/api/subscription-usages/__RP_TOK_0__"))
      .header("Authorization", "__RP_TOK_1__")
      .header("Revolut-Api-Version", "__RP_TOK_2__")
      .DELETE(HttpRequest.BodyPublishers.noBody())
      .build();

    client.sendAsync(request, HttpResponse.BodyHandlers.ofString())
      .thenApply(HttpResponse::body)
      .thenAccept(System.out::println)
      .join();
  }
}
13b:T15c8,
using System.Net.Http;
using System.Net.Http.Headers;

var client = new HttpClient();
var request = new HttpRequestMessage
{
  Method = HttpMethod.Delete,
  RequestUri = new Uri("https://merchant.revolut.com/api/subscription-usages/__RP_TOK_0__"),
  Headers =
  {
    { "Authorization", "__RP_TOK_1__" },
    { "Revolut-Api-Version", "__RP_TOK_2__" },
  }
};

using (var response = await client.SendAsync(request))
{
  response.EnsureSuccessStatusCode();
  var body = await response.Content.ReadAsStringAsync();
  Console.WriteLine(body);
}
13c:T9e8,
fetch("https://sandbox-merchant.revolut.com/api/subscription-usages/__RP_TOK_0__", {
  method: "DELETE",
  headers: {
    "Authorization": "__RP_TOK_1__",
    "Revolut-Api-Version": "__RP_TOK_2__"
  }
})
  .then(response => response.json())
  .then(data => console.log(data));
13d:Tf85,
package main

import (
  "fmt"
  "net/http"
)

func main() {
  url := "https://sandbox-merchant.revolut.com/api/subscription-usages/__RP_TOK_0__"
  req, _ := http.NewRequest("DELETE", url, nil)
  req.Header.Add("Authorization", "__RP_TOK_1__")
  req.Header.Add("Revolut-Api-Version", "__RP_TOK_2__")

  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  fmt.Println(res)
}
13e:T7fa,
import requests

url = "https://sandbox-merchant.revolut.com/api/subscription-usages/__RP_TOK_0__"
headers = {
  "Authorization": "__RP_TOK_1__",
  "Revolut-Api-Version": "__RP_TOK_2__"
}

response = requests.delete(url, headers=headers)
print(response.json())
13f:T1726,
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;

public class Main {
  public static void main(String[] args) {
    HttpClient client = HttpClient.newHttpClient();
    HttpRequest request = HttpRequest.newBuilder()
      .uri(URI.create("https://sandbox-merchant.revolut.com/api/subscription-usages/__RP_TOK_0__"))
      .header("Authorization", "__RP_TOK_1__")
      .header("Revolut-Api-Version", "__RP_TOK_2__")
      .DELETE(HttpRequest.BodyPublishers.noBody())
      .build();

    client.sendAsync(request, HttpResponse.BodyHandlers.ofString())
      .thenApply(HttpResponse::body)
      .thenAccept(System.out::println)
      .join();
  }
}
140:T15d0,
using System.Net.Http;
using System.Net.Http.Headers;

var client = new HttpClient();
var request = new HttpRequestMessage
{
  Method = HttpMethod.Delete,
  RequestUri = new Uri("https://sandbox-merchant.revolut.com/api/subscription-usages/__RP_TOK_0__"),
  Headers =
  {
    { "Authorization", "__RP_TOK_1__" },
    { "Revolut-Api-Version", "__RP_TOK_2__" },
  }
};

using (var response = await client.SendAsync(request))
{
  response.EnsureSuccessStatusCode();
  var body = await response.Content.ReadAsStringAsync();
  Console.WriteLine(body);
}
10c:["$","div",null,{"className":"ezz1n30","children":[["$","div",null,{"data-header":"$undefined","className":"ezz1n31","children":["$L132",["$","$L85",null,{"parameters":[{"name":"Authorization","in":"header","schema":{"type":"string","format":"Bearer ","examples":"$62:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:0:schema:examples"},"required":true,"description":"This parameter accepts the [Merchant API Secret key](https://business.revolut.com/settings/apis?tab=merchant-api) to authorise requests coming from the merchant's backend. \n\nIt ensures that ensures that each request is authenticated and authorised by verifying the secret key. The secret key should be included in all request headers as a `Bearer` token.\n\n:::info\nFor more information, see: [Authentication](https://developer.revolut.com/docs/api/merchant#authentication)\n:::","descriptionNode":"$L133"},{"name":"Revolut-Api-Version","in":"header","schema":{"type":"string","format":"date","enum":"$36:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:1:schema:enum","examples":"$36:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:1:schema:examples"},"required":true,"description":"The version of the Merchant API, specified in `YYYY-MM-DD` format.\n\nIf not specified, you will receive an error.\n\n\n:::info\nFor more information about API versioning, see: [API versions](https://developer.revolut.com/docs/guides/merchant/reference/versioning/api-versions).\n:::","x-config-always-visible-in-example":true,"example":"2025-10-16","descriptionNode":"$L134"},{"name":"usage_id","in":"path","schema":{"type":"string","format":"uuid","description":"A UUID string, typically used to identify resources.","descriptionNode":"$L135"},"required":true,"description":"The ID of the usage record.","descriptionNode":"$L136"}],"requestBody":"$undefined","heading":"Request","requestBodySchemaTitle":"Request body","headingAs":"h3"}],["$","$L89",null,{"responses":"$3f:props:children:0:props:children:props:responses","headingAs":"h3"}]]}],["$","div",null,{"className":"ezz1n32","children":[[["$","$L8a",null,{"itemsByServer":{"https://merchant.revolut.com":[{"id":"curl","label":"cURL","templateCode":"curl -X DELETE \"https://merchant.revolut.com/api/subscription-usages/__RP_TOK_0__\" \\\n -H \"Authorization: __RP_TOK_1__\" \\\n -H \"Revolut-Api-Version: __RP_TOK_2__\"","templateHtml":"
curl -X DELETE \"https://merchant.revolut.com/api/subscription-usages/__RP_TOK_0__\" \\\n  -H \"Authorization: __RP_TOK_1__\" \\\n  -H \"Revolut-Api-Version: __RP_TOK_2__\"
","tokens":[{"marker":"__RP_TOK_0__","paramName":"usage_id","paramIn":"path","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["shell-double-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:usage_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"javascript","label":"JavaScript","templateCode":"fetch(\"https://merchant.revolut.com/api/subscription-usages/__RP_TOK_0__\", {\n method: \"DELETE\",\n headers: {\n \"Authorization\": \"__RP_TOK_1__\",\n \"Revolut-Api-Version\": \"__RP_TOK_2__\"\n }\n})\n .then(response => response.json())\n .then(data => console.log(data));","templateHtml":"$137","tokens":[{"marker":"__RP_TOK_0__","paramName":"usage_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:usage_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"go","label":"Go","templateCode":"package main\n\nimport (\n \"fmt\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://merchant.revolut.com/api/subscription-usages/__RP_TOK_0__\"\n req, _ := http.NewRequest(\"DELETE\", url, nil)\n req.Header.Add(\"Authorization\", \"__RP_TOK_1__\")\n req.Header.Add(\"Revolut-Api-Version\", \"__RP_TOK_2__\")\n\n res, _ := http.DefaultClient.Do(req)\n defer res.Body.Close()\n fmt.Println(res)\n}","templateHtml":"$138","tokens":[{"marker":"__RP_TOK_0__","paramName":"usage_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:usage_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"python","label":"Python","templateCode":"import requests\n\nurl = \"https://merchant.revolut.com/api/subscription-usages/__RP_TOK_0__\"\nheaders = {\n \"Authorization\": \"__RP_TOK_1__\",\n \"Revolut-Api-Version\": \"__RP_TOK_2__\"\n}\n\nresponse = requests.delete(url, headers=headers)\nprint(response.json())","templateHtml":"$139","tokens":[{"marker":"__RP_TOK_0__","paramName":"usage_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:usage_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"java","label":"Java","templateCode":"import java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\nimport java.net.URI;\n\npublic class Main {\n public static void main(String[] args) {\n HttpClient client = HttpClient.newHttpClient();\n HttpRequest request = HttpRequest.newBuilder()\n .uri(URI.create(\"https://merchant.revolut.com/api/subscription-usages/__RP_TOK_0__\"))\n .header(\"Authorization\", \"__RP_TOK_1__\")\n .header(\"Revolut-Api-Version\", \"__RP_TOK_2__\")\n .DELETE(HttpRequest.BodyPublishers.noBody())\n .build();\n\n client.sendAsync(request, HttpResponse.BodyHandlers.ofString())\n .thenApply(HttpResponse::body)\n .thenAccept(System.out::println)\n .join();\n }\n}","templateHtml":"$13a","tokens":[{"marker":"__RP_TOK_0__","paramName":"usage_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:usage_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"csharp","label":"C#","templateCode":"using System.Net.Http;\nusing System.Net.Http.Headers;\n\nvar client = new HttpClient();\nvar request = new HttpRequestMessage\n{\n Method = HttpMethod.Delete,\n RequestUri = new Uri(\"https://merchant.revolut.com/api/subscription-usages/__RP_TOK_0__\"),\n Headers =\n {\n { \"Authorization\", \"__RP_TOK_1__\" },\n { \"Revolut-Api-Version\", \"__RP_TOK_2__\" },\n }\n};\n\nusing (var response = await client.SendAsync(request))\n{\n response.EnsureSuccessStatusCode();\n var body = await response.Content.ReadAsStringAsync();\n Console.WriteLine(body);\n}","templateHtml":"$13b","tokens":[{"marker":"__RP_TOK_0__","paramName":"usage_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:usage_id":"123e4567-e89b-12d3-a456-426614174000"}}],"https://sandbox-merchant.revolut.com":[{"id":"curl","label":"cURL","templateCode":"curl -X DELETE \"https://sandbox-merchant.revolut.com/api/subscription-usages/__RP_TOK_0__\" \\\n -H \"Authorization: __RP_TOK_1__\" \\\n -H \"Revolut-Api-Version: __RP_TOK_2__\"","templateHtml":"
curl -X DELETE \"https://sandbox-merchant.revolut.com/api/subscription-usages/__RP_TOK_0__\" \\\n  -H \"Authorization: __RP_TOK_1__\" \\\n  -H \"Revolut-Api-Version: __RP_TOK_2__\"
","tokens":[{"marker":"__RP_TOK_0__","paramName":"usage_id","paramIn":"path","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["shell-double-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:usage_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"javascript","label":"JavaScript","templateCode":"fetch(\"https://sandbox-merchant.revolut.com/api/subscription-usages/__RP_TOK_0__\", {\n method: \"DELETE\",\n headers: {\n \"Authorization\": \"__RP_TOK_1__\",\n \"Revolut-Api-Version\": \"__RP_TOK_2__\"\n }\n})\n .then(response => response.json())\n .then(data => console.log(data));","templateHtml":"$13c","tokens":[{"marker":"__RP_TOK_0__","paramName":"usage_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:usage_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"go","label":"Go","templateCode":"package main\n\nimport (\n \"fmt\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://sandbox-merchant.revolut.com/api/subscription-usages/__RP_TOK_0__\"\n req, _ := http.NewRequest(\"DELETE\", url, nil)\n req.Header.Add(\"Authorization\", \"__RP_TOK_1__\")\n req.Header.Add(\"Revolut-Api-Version\", \"__RP_TOK_2__\")\n\n res, _ := http.DefaultClient.Do(req)\n defer res.Body.Close()\n fmt.Println(res)\n}","templateHtml":"$13d","tokens":[{"marker":"__RP_TOK_0__","paramName":"usage_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:usage_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"python","label":"Python","templateCode":"import requests\n\nurl = \"https://sandbox-merchant.revolut.com/api/subscription-usages/__RP_TOK_0__\"\nheaders = {\n \"Authorization\": \"__RP_TOK_1__\",\n \"Revolut-Api-Version\": \"__RP_TOK_2__\"\n}\n\nresponse = requests.delete(url, headers=headers)\nprint(response.json())","templateHtml":"$13e","tokens":[{"marker":"__RP_TOK_0__","paramName":"usage_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:usage_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"java","label":"Java","templateCode":"import java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\nimport java.net.URI;\n\npublic class Main {\n public static void main(String[] args) {\n HttpClient client = HttpClient.newHttpClient();\n HttpRequest request = HttpRequest.newBuilder()\n .uri(URI.create(\"https://sandbox-merchant.revolut.com/api/subscription-usages/__RP_TOK_0__\"))\n .header(\"Authorization\", \"__RP_TOK_1__\")\n .header(\"Revolut-Api-Version\", \"__RP_TOK_2__\")\n .DELETE(HttpRequest.BodyPublishers.noBody())\n .build();\n\n client.sendAsync(request, HttpResponse.BodyHandlers.ofString())\n .thenApply(HttpResponse::body)\n .thenAccept(System.out::println)\n .join();\n }\n}","templateHtml":"$13f","tokens":[{"marker":"__RP_TOK_0__","paramName":"usage_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:usage_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"csharp","label":"C#","templateCode":"using System.Net.Http;\nusing System.Net.Http.Headers;\n\nvar client = new HttpClient();\nvar request = new HttpRequestMessage\n{\n Method = HttpMethod.Delete,\n RequestUri = new Uri(\"https://sandbox-merchant.revolut.com/api/subscription-usages/__RP_TOK_0__\"),\n Headers =\n {\n { \"Authorization\", \"__RP_TOK_1__\" },\n { \"Revolut-Api-Version\", \"__RP_TOK_2__\" },\n }\n};\n\nusing (var response = await client.SendAsync(request))\n{\n response.EnsureSuccessStatusCode();\n var body = await response.Content.ReadAsStringAsync();\n Console.WriteLine(body);\n}","templateHtml":"$140","tokens":[{"marker":"__RP_TOK_0__","paramName":"usage_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:usage_id":"123e4567-e89b-12d3-a456-426614174000"}}]},"method":"delete","servers":"$62:props:children:0:props:children:props:children:1:props:children:1:props:children:0:0:props:servers","path":"/api/subscription-usages/{usage_id}","parameters":["$10c:props:children:0:props:children:1:props:parameters:0","$10c:props:children:0:props:children:1:props:parameters:1","$10c:props:children:0:props:children:1:props:parameters:2"]}],"$L141"],"$L142","$L143"]}]]}] 46:["$","$7a","accept-dispute",{"children":[["$","section",null,{"className":"y9a0do0","data-variant":"endpoint","children":["$","$L7b",null,{"responses":{"204":{"description":"Dispute accepted successfully","descriptionNode":"$L144"},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"code":{"type":"string","description":"An identifier that can be used to determine what went wrong.\n\nError codes are not globally unique, but uniqueness is guaranteed within endpoints.","descriptionNode":"$L145"},"message":{"type":"string","description":"Some human readable text describing what went wrong.","descriptionNode":"$L146"},"timestamp":{"type":"integer","description":"The [UNIX timestamp](https://www.unixtimestamp.com/) of the date and time the error happened.","descriptionNode":"$L147"}}},"examples":{"default":{"value":{"code":"bad_request","message":"Missing Revolut-Api-Version header","timestamp":1601296792533}}}}},"descriptionNode":"$L148"},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"code":{"type":"string","description":"An identifier that can be used to determine what went wrong.\n\nError codes are not globally unique, but uniqueness is guaranteed within endpoints.","descriptionNode":"$L149"},"message":{"type":"string","description":"Some human readable text describing what went wrong.","descriptionNode":"$L14a"},"timestamp":{"type":"integer","description":"The [UNIX timestamp](https://www.unixtimestamp.com/) of the date and time the error happened.","descriptionNode":"$L14b"}}},"examples":{"default":{"value":{"code":"unauthenticated","message":"Authentication failed","timestamp":1721049596461}}}}},"descriptionNode":"$L14c"},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"code":{"type":"string","description":"An identifier that can be used to determine what went wrong.\n\nError codes are not globally unique, but uniqueness is guaranteed within endpoints.","descriptionNode":"$L14d"},"message":{"type":"string","description":"Some human readable text describing what went wrong.","descriptionNode":"$L14e"},"timestamp":{"type":"integer","description":"The [UNIX timestamp](https://www.unixtimestamp.com/) of the date and time the error happened.","descriptionNode":"$L14f"}}},"examples":{"default":{"value":{"code":"not_found","message":"The requested operation is forbidden","timestamp":1721050063886}}}}},"descriptionNode":"$L150"},"404":{"description":"Not Found","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"code":{"type":"string","description":"An identifier that can be used to determine what went wrong.\n\nError codes are not globally unique, but uniqueness is guaranteed within endpoints.","descriptionNode":"$L151"},"message":{"type":"string","description":"Some human readable text describing what went wrong.","descriptionNode":"$L152"},"timestamp":{"type":"integer","description":"The [UNIX timestamp](https://www.unixtimestamp.com/) of the date and time the error happened.","descriptionNode":"$L153"}}},"examples":{"default":{"value":{"code":"not_found","message":"The requested resource is not found","timestamp":1721050063886}}}}},"descriptionNode":"$L154"},"422":{"description":"Unprocessable entity","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"code":{"type":"string","description":"An identifier that can be used to determine what went wrong.\n\nError codes are not globally unique, but uniqueness is guaranteed within endpoints.","descriptionNode":"$L155"},"message":{"type":"string","description":"Some human readable text describing what went wrong.","descriptionNode":"$L156"},"timestamp":{"type":"integer","description":"The [UNIX timestamp](https://www.unixtimestamp.com/) of the date and time the error happened.","descriptionNode":"$L157"}}}}},"descriptionNode":"$L158"}},"requestBody":"$undefined","variantLabels":[],"children":[["$","div",null,{"className":"ezz1n30","children":[["$","div",null,{"data-header":"$undefined","className":"ezz1n31","children":["$","div",null,{"className":"y9a0do1","children":["$L159","$L15a"]}]}],"$undefined"]}],"$L15b"]}]}],false]}] 54:["$","$7a","retrieve-report-run",{"children":[["$","section",null,{"className":"y9a0do0","data-variant":"endpoint","children":["$","$L7b",null,{"responses":{"200":{"description":"Report run found","content":{"application/json":{"schema":{"title":"ReportRunDetails","type":"object","description":"The `ReportRunDetails` object contains all information associated with a specific report run, identified by the `report_run_id`.","properties":{"report_run_id":{"type":"string","format":"uuid","description":"Unique ID used for accessing report details. Use this to check report generation status.","descriptionNode":"$L15c"},"status":{"type":"string","description":"Current status of the report run.\n\n| Value | Description |\n| ----- | ----------- |\n| `processing` | Report generation is still in progress. |\n| `completed` | Report generation finished successfully and the file is available to download for 24 hours via `file_url`. |\n| `failed` | Report generation failed and no report file is available. |\n| `expired` | Report generation previously completed, but the 24-hour file availability window has elapsed and the file can no longer be downloaded. |","enum":["processing","completed","failed","expired"],"descriptionNode":"$L15d"},"file_url":{"type":"string","description":"Use this link to download the report file. Available only when `status` is `completed`, and only for 24 hours after report generation finishes.","descriptionNode":"$L15e"}},"required":["report_run_id","status"],"descriptionNode":"$L15f"},"examples":{"report_run_processing":{"summary":"Report run processing","value":{"report_run_id":"d6f6ef64-f668-4e64-8967-1cdf8afb2561","status":"processing"}},"report_run_completed":{"summary":"Report run completed","value":{"report_run_id":"d6f6ef64-f668-4e64-8967-1cdf8afb2561","status":"completed","file_url":"https://merchant.revolut.com/api/report-runs/d6f6ef64-f668-4e64-8967-1cdf8afb2561/file"}},"report_run_expired":{"summary":"Report run expired","value":{"report_run_id":"d6f6ef64-f668-4e64-8967-1cdf8afb2561","status":"expired"}}}}},"descriptionNode":"$L160"},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"code":{"type":"string","description":"An identifier that can be used to determine what went wrong.\n\nError codes are not globally unique, but uniqueness is guaranteed within endpoints.","descriptionNode":"$L161"},"message":{"type":"string","description":"Some human readable text describing what went wrong.","descriptionNode":"$L162"},"timestamp":{"type":"integer","description":"The [UNIX timestamp](https://www.unixtimestamp.com/) of the date and time the error happened.","descriptionNode":"$L163"}}}}},"descriptionNode":"$L164"},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"code":{"type":"string","description":"An identifier that can be used to determine what went wrong.\n\nError codes are not globally unique, but uniqueness is guaranteed within endpoints.","descriptionNode":"$L165"},"message":{"type":"string","description":"Some human readable text describing what went wrong.","descriptionNode":"$L166"},"timestamp":{"type":"integer","description":"The [UNIX timestamp](https://www.unixtimestamp.com/) of the date and time the error happened.","descriptionNode":"$L167"}}}}},"descriptionNode":"$L168"},"404":{"description":"Not Found","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"code":{"type":"string","description":"An identifier that can be used to determine what went wrong.\n\nError codes are not globally unique, but uniqueness is guaranteed within endpoints.","descriptionNode":"$L169"},"message":{"type":"string","description":"Some human readable text describing what went wrong.","descriptionNode":"$L16a"},"timestamp":{"type":"integer","description":"The [UNIX timestamp](https://www.unixtimestamp.com/) of the date and time the error happened.","descriptionNode":"$L16b"}}}}},"descriptionNode":"$L16c"}},"requestBody":"$undefined","variantLabels":["Report run processing","Report run completed","Report run expired"],"children":["$L16d","$L16e"]}]}],false]}] 17e:T9d5,
fetch("https://merchant.revolut.com/api/webhooks/__RP_TOK_0__", {
  method: "DELETE",
  headers: {
    "Authorization": "__RP_TOK_1__",
    "Revolut-Api-Version": "__RP_TOK_2__"
  }
})
  .then(response => response.json())
  .then(data => console.log(data));
17f:Tf72,
package main

import (
  "fmt"
  "net/http"
)

func main() {
  url := "https://merchant.revolut.com/api/webhooks/__RP_TOK_0__"
  req, _ := http.NewRequest("DELETE", url, nil)
  req.Header.Add("Authorization", "__RP_TOK_1__")
  req.Header.Add("Revolut-Api-Version", "__RP_TOK_2__")

  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  fmt.Println(res)
}
180:T7e7,
import requests

url = "https://merchant.revolut.com/api/webhooks/__RP_TOK_0__"
headers = {
  "Authorization": "__RP_TOK_1__",
  "Revolut-Api-Version": "__RP_TOK_2__"
}

response = requests.delete(url, headers=headers)
print(response.json())
181:T1713,
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;

public class Main {
  public static void main(String[] args) {
    HttpClient client = HttpClient.newHttpClient();
    HttpRequest request = HttpRequest.newBuilder()
      .uri(URI.create("https://merchant.revolut.com/api/webhooks/__RP_TOK_0__"))
      .header("Authorization", "__RP_TOK_1__")
      .header("Revolut-Api-Version", "__RP_TOK_2__")
      .DELETE(HttpRequest.BodyPublishers.noBody())
      .build();

    client.sendAsync(request, HttpResponse.BodyHandlers.ofString())
      .thenApply(HttpResponse::body)
      .thenAccept(System.out::println)
      .join();
  }
}
182:T15bd,
using System.Net.Http;
using System.Net.Http.Headers;

var client = new HttpClient();
var request = new HttpRequestMessage
{
  Method = HttpMethod.Delete,
  RequestUri = new Uri("https://merchant.revolut.com/api/webhooks/__RP_TOK_0__"),
  Headers =
  {
    { "Authorization", "__RP_TOK_1__" },
    { "Revolut-Api-Version", "__RP_TOK_2__" },
  }
};

using (var response = await client.SendAsync(request))
{
  response.EnsureSuccessStatusCode();
  var body = await response.Content.ReadAsStringAsync();
  Console.WriteLine(body);
}
183:T9dd,
fetch("https://sandbox-merchant.revolut.com/api/webhooks/__RP_TOK_0__", {
  method: "DELETE",
  headers: {
    "Authorization": "__RP_TOK_1__",
    "Revolut-Api-Version": "__RP_TOK_2__"
  }
})
  .then(response => response.json())
  .then(data => console.log(data));
184:Tf7a,
package main

import (
  "fmt"
  "net/http"
)

func main() {
  url := "https://sandbox-merchant.revolut.com/api/webhooks/__RP_TOK_0__"
  req, _ := http.NewRequest("DELETE", url, nil)
  req.Header.Add("Authorization", "__RP_TOK_1__")
  req.Header.Add("Revolut-Api-Version", "__RP_TOK_2__")

  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  fmt.Println(res)
}
185:T7ef,
import requests

url = "https://sandbox-merchant.revolut.com/api/webhooks/__RP_TOK_0__"
headers = {
  "Authorization": "__RP_TOK_1__",
  "Revolut-Api-Version": "__RP_TOK_2__"
}

response = requests.delete(url, headers=headers)
print(response.json())
186:T171b,
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;

public class Main {
  public static void main(String[] args) {
    HttpClient client = HttpClient.newHttpClient();
    HttpRequest request = HttpRequest.newBuilder()
      .uri(URI.create("https://sandbox-merchant.revolut.com/api/webhooks/__RP_TOK_0__"))
      .header("Authorization", "__RP_TOK_1__")
      .header("Revolut-Api-Version", "__RP_TOK_2__")
      .DELETE(HttpRequest.BodyPublishers.noBody())
      .build();

    client.sendAsync(request, HttpResponse.BodyHandlers.ofString())
      .thenApply(HttpResponse::body)
      .thenAccept(System.out::println)
      .join();
  }
}
187:T15c5,
using System.Net.Http;
using System.Net.Http.Headers;

var client = new HttpClient();
var request = new HttpRequestMessage
{
  Method = HttpMethod.Delete,
  RequestUri = new Uri("https://sandbox-merchant.revolut.com/api/webhooks/__RP_TOK_0__"),
  Headers =
  {
    { "Authorization", "__RP_TOK_1__" },
    { "Revolut-Api-Version", "__RP_TOK_2__" },
  }
};

using (var response = await client.SendAsync(request))
{
  response.EnsureSuccessStatusCode();
  var body = await response.Content.ReadAsStringAsync();
  Console.WriteLine(body);
}
5b:["$","$7a","delete-webhook",{"children":[["$","section",null,{"className":"y9a0do0","data-variant":"endpoint","children":["$","$L7b",null,{"responses":{"204":{"description":"No Content","descriptionNode":"$L16f"},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"code":{"type":"string","description":"An identifier that can be used to determine what went wrong.\n\nError codes are not globally unique, but uniqueness is guaranteed within endpoints.","descriptionNode":"$L170"},"message":{"type":"string","description":"Some human readable text describing what went wrong.","descriptionNode":"$L171"},"timestamp":{"type":"integer","description":"The [UNIX timestamp](https://www.unixtimestamp.com/) of the date and time the error happened.","descriptionNode":"$L172"}}}}},"descriptionNode":"$L173"},"404":{"description":"Not Found","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"code":{"type":"string","description":"An identifier that can be used to determine what went wrong.\n\nError codes are not globally unique, but uniqueness is guaranteed within endpoints.","descriptionNode":"$L174"},"message":{"type":"string","description":"Some human readable text describing what went wrong.","descriptionNode":"$L175"},"timestamp":{"type":"integer","description":"The [UNIX timestamp](https://www.unixtimestamp.com/) of the date and time the error happened.","descriptionNode":"$L176"}}}}},"descriptionNode":"$L177"}},"requestBody":"$undefined","variantLabels":[],"children":[["$","div",null,{"className":"ezz1n30","children":[["$","div",null,{"data-header":"$undefined","className":"ezz1n31","children":["$","div",null,{"className":"y9a0do1","children":[["$","h2",null,{"id":"delete-webhook","children":[["$L178","$undefined"],["$","$L15",null,{"id":"delete-webhook"}]]}],["$","$L16",null,{"url":"/docs/api/merchant/2025-10-16/operations/delete-webhook.md"}]]}]}],"$undefined"]}],["$","div",null,{"className":"ezz1n30","children":[["$","div",null,{"data-header":"$undefined","className":"ezz1n31","children":["$L179",["$","$L85",null,{"parameters":[{"name":"Authorization","in":"header","schema":{"type":"string","format":"Bearer ","examples":"$62:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:0:schema:examples"},"required":true,"description":"This parameter accepts the [Merchant API Secret key](https://business.revolut.com/settings/apis?tab=merchant-api) to authorise requests coming from the merchant's backend. \n\nIt ensures that ensures that each request is authenticated and authorised by verifying the secret key. The secret key should be included in all request headers as a `Bearer` token.\n\n:::info\nFor more information, see: [Authentication](https://developer.revolut.com/docs/api/merchant#authentication)\n:::","descriptionNode":"$L17a"},{"name":"Revolut-Api-Version","in":"header","schema":{"type":"string","format":"date","enum":"$27:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:1:schema:enum","examples":"$27:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:1:schema:examples"},"required":true,"description":"The version of the Merchant API, specified in `YYYY-MM-DD` format.\n\nThis endpoint is available from version `2024-09-01`. If a version earlier than `2024-09-01` is provided, the endpoint returns a `404` response.\n\nIf not specified, you will receive an error.\n\n\n:::info\nFor more information about API versioning, see: [API versions](https://developer.revolut.com/docs/guides/merchant/reference/versioning/api-versions).\n:::","x-config-always-visible-in-example":true,"example":"2025-10-16","descriptionNode":"$L17b"},{"name":"webhook_id","in":"path","schema":{"type":"string","format":"uuid","description":"A UUID string, typically used to identify resources.","descriptionNode":"$L17c"},"required":true,"description":"The ID of the webhook.","descriptionNode":"$L17d"}],"requestBody":"$undefined","heading":"Request","requestBodySchemaTitle":"Request body","headingAs":"h3"}],["$","$L89",null,{"responses":"$5b:props:children:0:props:children:props:responses","headingAs":"h3"}]]}],["$","div",null,{"className":"ezz1n32","children":[[["$","$L8a",null,{"itemsByServer":{"https://merchant.revolut.com":[{"id":"curl","label":"cURL","templateCode":"curl -X DELETE \"https://merchant.revolut.com/api/webhooks/__RP_TOK_0__\" \\\n -H \"Authorization: __RP_TOK_1__\" \\\n -H \"Revolut-Api-Version: __RP_TOK_2__\"","templateHtml":"
curl -X DELETE \"https://merchant.revolut.com/api/webhooks/__RP_TOK_0__\" \\\n  -H \"Authorization: __RP_TOK_1__\" \\\n  -H \"Revolut-Api-Version: __RP_TOK_2__\"
","tokens":[{"marker":"__RP_TOK_0__","paramName":"webhook_id","paramIn":"path","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["shell-double-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:webhook_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"javascript","label":"JavaScript","templateCode":"fetch(\"https://merchant.revolut.com/api/webhooks/__RP_TOK_0__\", {\n method: \"DELETE\",\n headers: {\n \"Authorization\": \"__RP_TOK_1__\",\n \"Revolut-Api-Version\": \"__RP_TOK_2__\"\n }\n})\n .then(response => response.json())\n .then(data => console.log(data));","templateHtml":"$17e","tokens":[{"marker":"__RP_TOK_0__","paramName":"webhook_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:webhook_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"go","label":"Go","templateCode":"package main\n\nimport (\n \"fmt\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://merchant.revolut.com/api/webhooks/__RP_TOK_0__\"\n req, _ := http.NewRequest(\"DELETE\", url, nil)\n req.Header.Add(\"Authorization\", \"__RP_TOK_1__\")\n req.Header.Add(\"Revolut-Api-Version\", \"__RP_TOK_2__\")\n\n res, _ := http.DefaultClient.Do(req)\n defer res.Body.Close()\n fmt.Println(res)\n}","templateHtml":"$17f","tokens":[{"marker":"__RP_TOK_0__","paramName":"webhook_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:webhook_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"python","label":"Python","templateCode":"import requests\n\nurl = \"https://merchant.revolut.com/api/webhooks/__RP_TOK_0__\"\nheaders = {\n \"Authorization\": \"__RP_TOK_1__\",\n \"Revolut-Api-Version\": \"__RP_TOK_2__\"\n}\n\nresponse = requests.delete(url, headers=headers)\nprint(response.json())","templateHtml":"$180","tokens":[{"marker":"__RP_TOK_0__","paramName":"webhook_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:webhook_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"java","label":"Java","templateCode":"import java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\nimport java.net.URI;\n\npublic class Main {\n public static void main(String[] args) {\n HttpClient client = HttpClient.newHttpClient();\n HttpRequest request = HttpRequest.newBuilder()\n .uri(URI.create(\"https://merchant.revolut.com/api/webhooks/__RP_TOK_0__\"))\n .header(\"Authorization\", \"__RP_TOK_1__\")\n .header(\"Revolut-Api-Version\", \"__RP_TOK_2__\")\n .DELETE(HttpRequest.BodyPublishers.noBody())\n .build();\n\n client.sendAsync(request, HttpResponse.BodyHandlers.ofString())\n .thenApply(HttpResponse::body)\n .thenAccept(System.out::println)\n .join();\n }\n}","templateHtml":"$181","tokens":[{"marker":"__RP_TOK_0__","paramName":"webhook_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:webhook_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"csharp","label":"C#","templateCode":"using System.Net.Http;\nusing System.Net.Http.Headers;\n\nvar client = new HttpClient();\nvar request = new HttpRequestMessage\n{\n Method = HttpMethod.Delete,\n RequestUri = new Uri(\"https://merchant.revolut.com/api/webhooks/__RP_TOK_0__\"),\n Headers =\n {\n { \"Authorization\", \"__RP_TOK_1__\" },\n { \"Revolut-Api-Version\", \"__RP_TOK_2__\" },\n }\n};\n\nusing (var response = await client.SendAsync(request))\n{\n response.EnsureSuccessStatusCode();\n var body = await response.Content.ReadAsStringAsync();\n Console.WriteLine(body);\n}","templateHtml":"$182","tokens":[{"marker":"__RP_TOK_0__","paramName":"webhook_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:webhook_id":"123e4567-e89b-12d3-a456-426614174000"}}],"https://sandbox-merchant.revolut.com":[{"id":"curl","label":"cURL","templateCode":"curl -X DELETE \"https://sandbox-merchant.revolut.com/api/webhooks/__RP_TOK_0__\" \\\n -H \"Authorization: __RP_TOK_1__\" \\\n -H \"Revolut-Api-Version: __RP_TOK_2__\"","templateHtml":"
curl -X DELETE \"https://sandbox-merchant.revolut.com/api/webhooks/__RP_TOK_0__\" \\\n  -H \"Authorization: __RP_TOK_1__\" \\\n  -H \"Revolut-Api-Version: __RP_TOK_2__\"
","tokens":[{"marker":"__RP_TOK_0__","paramName":"webhook_id","paramIn":"path","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["shell-double-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:webhook_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"javascript","label":"JavaScript","templateCode":"fetch(\"https://sandbox-merchant.revolut.com/api/webhooks/__RP_TOK_0__\", {\n method: \"DELETE\",\n headers: {\n \"Authorization\": \"__RP_TOK_1__\",\n \"Revolut-Api-Version\": \"__RP_TOK_2__\"\n }\n})\n .then(response => response.json())\n .then(data => console.log(data));","templateHtml":"$183","tokens":[{"marker":"__RP_TOK_0__","paramName":"webhook_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:webhook_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"go","label":"Go","templateCode":"package main\n\nimport (\n \"fmt\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://sandbox-merchant.revolut.com/api/webhooks/__RP_TOK_0__\"\n req, _ := http.NewRequest(\"DELETE\", url, nil)\n req.Header.Add(\"Authorization\", \"__RP_TOK_1__\")\n req.Header.Add(\"Revolut-Api-Version\", \"__RP_TOK_2__\")\n\n res, _ := http.DefaultClient.Do(req)\n defer res.Body.Close()\n fmt.Println(res)\n}","templateHtml":"$184","tokens":[{"marker":"__RP_TOK_0__","paramName":"webhook_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:webhook_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"python","label":"Python","templateCode":"import requests\n\nurl = \"https://sandbox-merchant.revolut.com/api/webhooks/__RP_TOK_0__\"\nheaders = {\n \"Authorization\": \"__RP_TOK_1__\",\n \"Revolut-Api-Version\": \"__RP_TOK_2__\"\n}\n\nresponse = requests.delete(url, headers=headers)\nprint(response.json())","templateHtml":"$185","tokens":[{"marker":"__RP_TOK_0__","paramName":"webhook_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:webhook_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"java","label":"Java","templateCode":"import java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\nimport java.net.URI;\n\npublic class Main {\n public static void main(String[] args) {\n HttpClient client = HttpClient.newHttpClient();\n HttpRequest request = HttpRequest.newBuilder()\n .uri(URI.create(\"https://sandbox-merchant.revolut.com/api/webhooks/__RP_TOK_0__\"))\n .header(\"Authorization\", \"__RP_TOK_1__\")\n .header(\"Revolut-Api-Version\", \"__RP_TOK_2__\")\n .DELETE(HttpRequest.BodyPublishers.noBody())\n .build();\n\n client.sendAsync(request, HttpResponse.BodyHandlers.ofString())\n .thenApply(HttpResponse::body)\n .thenAccept(System.out::println)\n .join();\n }\n}","templateHtml":"$186","tokens":[{"marker":"__RP_TOK_0__","paramName":"webhook_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:webhook_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"csharp","label":"C#","templateCode":"using System.Net.Http;\nusing System.Net.Http.Headers;\n\nvar client = new HttpClient();\nvar request = new HttpRequestMessage\n{\n Method = HttpMethod.Delete,\n RequestUri = new Uri(\"https://sandbox-merchant.revolut.com/api/webhooks/__RP_TOK_0__\"),\n Headers =\n {\n { \"Authorization\", \"__RP_TOK_1__\" },\n { \"Revolut-Api-Version\", \"__RP_TOK_2__\" },\n }\n};\n\nusing (var response = await client.SendAsync(request))\n{\n response.EnsureSuccessStatusCode();\n var body = await response.Content.ReadAsStringAsync();\n Console.WriteLine(body);\n}","templateHtml":"$187","tokens":[{"marker":"__RP_TOK_0__","paramName":"webhook_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:webhook_id":"123e4567-e89b-12d3-a456-426614174000"}}]},"method":"delete","servers":"$62:props:children:0:props:children:props:children:1:props:children:1:props:children:0:0:props:servers","path":"/api/webhooks/{webhook_id}","parameters":["$5b:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:0","$5b:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:1","$5b:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:2"]}],"$L188"],"$L189","$L18a"]}]]}]]}]}],false]}] 122:["$","$L10d",null,{"security":[{"Api-Key":[]}],"authorization":{"Api-Key":{"type":"apiKey","in":"header","name":"Authorization","description":"Each Merchant API request must contain an authorization header in the following format:\n\n```\n'Authorization: Bearer '\n```\n\nTo use this API, you need to generate API keys from your Revolut Business account. The Secret key is used in the authorization header for all server calls, while the Public key is provided with payment methods at checkout.\n\n:::info\nFor detailed instructions on generating your API keys, see: [Generate API keys](https://developer.revolut.com/docs/guides/merchant/get-started#generate-api-keys).\n:::","descriptionNode":"$L18b"}}}] 123:["$","$L10f",null,{"exampleBlocks":{},"title":"Request body samples","headingAs":"h4"}] 124:["$","$L110",null,{"exampleBlocks":{"204":{},"401":{"application/json":{"variants":[{"key":"default","label":"Example","rawValue":{"code":"string","message":"string","timestamp":123},"block":"$L18c"}],"syncedPropertyName":"$undefined"}},"404":{"application/json":{"variants":[{"key":"default","label":"Example","rawValue":{"code":"string","message":"string","timestamp":123},"block":"$L18d"}],"syncedPropertyName":"$undefined"}}},"headingAs":"h4"}] 12f:["$","$L10d",null,{"security":[{"Api-Key":[]}],"authorization":{"Api-Key":{"type":"apiKey","in":"header","name":"Authorization","description":"Each Merchant API request must contain an authorization header in the following format:\n\n```\n'Authorization: Bearer '\n```\n\nTo use this API, you need to generate API keys from your Revolut Business account. The Secret key is used in the authorization header for all server calls, while the Public key is provided with payment methods at checkout.\n\n:::info\nFor detailed instructions on generating your API keys, see: [Generate API keys](https://developer.revolut.com/docs/guides/merchant/get-started#generate-api-keys).\n:::","descriptionNode":"$L18e"}}}] 130:["$","$L10f",null,{"exampleBlocks":{},"title":"Request body samples","headingAs":"h4"}] 131:["$","$L110",null,{"exampleBlocks":{"204":{},"400":{"application/json":{"variants":[{"key":"default","label":"Example","rawValue":{"code":"string","message":"string","timestamp":123},"block":"$L18f"}],"syncedPropertyName":"$undefined"}},"401":{"application/json":{"variants":[{"key":"default","label":"Example","rawValue":{"code":"string","message":"string","timestamp":123},"block":"$L190"}],"syncedPropertyName":"$undefined"}},"404":{"application/json":{"variants":[{"key":"default","label":"Example","rawValue":{"code":"string","message":"string","timestamp":123},"block":"$L191"}],"syncedPropertyName":"$undefined"}},"default":{"application/json":{"variants":[{"key":"default","label":"Example","rawValue":{"code":"string","message":"string","timestamp":123},"block":"$L192"}],"syncedPropertyName":"$undefined"}}},"headingAs":"h4"}] 141:["$","$L10d",null,{"security":[{"Api-Key":[]}],"authorization":{"Api-Key":{"type":"apiKey","in":"header","name":"Authorization","description":"Each Merchant API request must contain an authorization header in the following format:\n\n```\n'Authorization: Bearer '\n```\n\nTo use this API, you need to generate API keys from your Revolut Business account. The Secret key is used in the authorization header for all server calls, while the Public key is provided with payment methods at checkout.\n\n:::info\nFor detailed instructions on generating your API keys, see: [Generate API keys](https://developer.revolut.com/docs/guides/merchant/get-started#generate-api-keys).\n:::","descriptionNode":"$L193"}}}] 142:["$","$L10f",null,{"exampleBlocks":{},"title":"Request body samples","headingAs":"h4"}] 143:["$","$L110",null,{"exampleBlocks":{"204":{},"400":{"application/json":{"variants":[{"key":"default","label":"Example","rawValue":{"code":"string","message":"string","timestamp":123},"block":"$L194"}],"syncedPropertyName":"$undefined"}},"401":{"application/json":{"variants":[{"key":"default","label":"Example","rawValue":{"code":"string","message":"string","timestamp":123},"block":"$L195"}],"syncedPropertyName":"$undefined"}},"404":{"application/json":{"variants":[{"key":"default","label":"Example","rawValue":{"code":"string","message":"string","timestamp":123},"block":"$L196"}],"syncedPropertyName":"$undefined"}},"422":{"application/json":{"variants":[{"key":"usage_locked","label":"Cycle is past the usage cutoff date","rawValue":"$3f:props:children:0:props:children:props:responses:422:content:application/json:examples:usage_locked:value","block":"$L197"}],"syncedPropertyName":"$undefined"}},"default":{"application/json":{"variants":[{"key":"default","label":"Example","rawValue":{"code":"string","message":"string","timestamp":123},"block":"$L198"}],"syncedPropertyName":"$undefined"}}},"headingAs":"h4"}] 159:["$","h2",null,{"id":"accept-dispute","children":[["$L199","$undefined"],["$","$L15",null,{"id":"accept-dispute"}]]}] 15a:["$","$L16",null,{"url":"/docs/api/merchant/2025-10-16/operations/accept-dispute.md"}] 19f:T9da,
fetch("https://merchant.revolut.com/api/disputes/__RP_TOK_0__/accept", {
  method: "POST",
  headers: {
    "Authorization": "__RP_TOK_1__",
    "Revolut-Api-Version": "__RP_TOK_2__"
  }
})
  .then(response => response.json())
  .then(data => console.log(data));
1a0:Tf77,
package main

import (
  "fmt"
  "net/http"
)

func main() {
  url := "https://merchant.revolut.com/api/disputes/__RP_TOK_0__/accept"
  req, _ := http.NewRequest("POST", url, nil)
  req.Header.Add("Authorization", "__RP_TOK_1__")
  req.Header.Add("Revolut-Api-Version", "__RP_TOK_2__")

  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  fmt.Println(res)
}
1a1:T7ec,
import requests

url = "https://merchant.revolut.com/api/disputes/__RP_TOK_0__/accept"
headers = {
  "Authorization": "__RP_TOK_1__",
  "Revolut-Api-Version": "__RP_TOK_2__"
}

response = requests.post(url, headers=headers)
print(response.json())
1a2:T1718,
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;

public class Main {
  public static void main(String[] args) {
    HttpClient client = HttpClient.newHttpClient();
    HttpRequest request = HttpRequest.newBuilder()
      .uri(URI.create("https://merchant.revolut.com/api/disputes/__RP_TOK_0__/accept"))
      .header("Authorization", "__RP_TOK_1__")
      .header("Revolut-Api-Version", "__RP_TOK_2__")
      .POST(HttpRequest.BodyPublishers.noBody())
      .build();

    client.sendAsync(request, HttpResponse.BodyHandlers.ofString())
      .thenApply(HttpResponse::body)
      .thenAccept(System.out::println)
      .join();
  }
}
1a3:T15c2,
using System.Net.Http;
using System.Net.Http.Headers;

var client = new HttpClient();
var request = new HttpRequestMessage
{
  Method = HttpMethod.Post,
  RequestUri = new Uri("https://merchant.revolut.com/api/disputes/__RP_TOK_0__/accept"),
  Headers =
  {
    { "Authorization", "__RP_TOK_1__" },
    { "Revolut-Api-Version", "__RP_TOK_2__" },
  }
};

using (var response = await client.SendAsync(request))
{
  response.EnsureSuccessStatusCode();
  var body = await response.Content.ReadAsStringAsync();
  Console.WriteLine(body);
}
1a4:T9e2,
fetch("https://sandbox-merchant.revolut.com/api/disputes/__RP_TOK_0__/accept", {
  method: "POST",
  headers: {
    "Authorization": "__RP_TOK_1__",
    "Revolut-Api-Version": "__RP_TOK_2__"
  }
})
  .then(response => response.json())
  .then(data => console.log(data));
1a5:Tf7f,
package main

import (
  "fmt"
  "net/http"
)

func main() {
  url := "https://sandbox-merchant.revolut.com/api/disputes/__RP_TOK_0__/accept"
  req, _ := http.NewRequest("POST", url, nil)
  req.Header.Add("Authorization", "__RP_TOK_1__")
  req.Header.Add("Revolut-Api-Version", "__RP_TOK_2__")

  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  fmt.Println(res)
}
1a6:T7f4,
import requests

url = "https://sandbox-merchant.revolut.com/api/disputes/__RP_TOK_0__/accept"
headers = {
  "Authorization": "__RP_TOK_1__",
  "Revolut-Api-Version": "__RP_TOK_2__"
}

response = requests.post(url, headers=headers)
print(response.json())
1a7:T1720,
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;

public class Main {
  public static void main(String[] args) {
    HttpClient client = HttpClient.newHttpClient();
    HttpRequest request = HttpRequest.newBuilder()
      .uri(URI.create("https://sandbox-merchant.revolut.com/api/disputes/__RP_TOK_0__/accept"))
      .header("Authorization", "__RP_TOK_1__")
      .header("Revolut-Api-Version", "__RP_TOK_2__")
      .POST(HttpRequest.BodyPublishers.noBody())
      .build();

    client.sendAsync(request, HttpResponse.BodyHandlers.ofString())
      .thenApply(HttpResponse::body)
      .thenAccept(System.out::println)
      .join();
  }
}
1a8:T15ca,
using System.Net.Http;
using System.Net.Http.Headers;

var client = new HttpClient();
var request = new HttpRequestMessage
{
  Method = HttpMethod.Post,
  RequestUri = new Uri("https://sandbox-merchant.revolut.com/api/disputes/__RP_TOK_0__/accept"),
  Headers =
  {
    { "Authorization", "__RP_TOK_1__" },
    { "Revolut-Api-Version", "__RP_TOK_2__" },
  }
};

using (var response = await client.SendAsync(request))
{
  response.EnsureSuccessStatusCode();
  var body = await response.Content.ReadAsStringAsync();
  Console.WriteLine(body);
}
15b:["$","div",null,{"className":"ezz1n30","children":[["$","div",null,{"data-header":"$undefined","className":"ezz1n31","children":["$L19a",["$","$L85",null,{"parameters":[{"name":"Authorization","in":"header","schema":{"type":"string","format":"Bearer ","examples":"$62:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:0:schema:examples"},"required":true,"description":"This parameter accepts the [Merchant API Secret key](https://business.revolut.com/settings/apis?tab=merchant-api) to authorise requests coming from the merchant's backend. \n\nIt ensures that ensures that each request is authenticated and authorised by verifying the secret key. The secret key should be included in all request headers as a `Bearer` token.\n\n:::info\nFor more information, see: [Authentication](https://developer.revolut.com/docs/api/merchant#authentication)\n:::","descriptionNode":"$L19b"},{"name":"Revolut-Api-Version","in":"header","schema":{"type":"string","format":"date","enum":"$36:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:1:schema:enum","examples":"$36:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:1:schema:examples"},"required":true,"description":"The version of the Merchant API, specified in `YYYY-MM-DD` format.\n\nIf not specified, you will receive an error.\n\n\n:::info\nFor more information about API versioning, see: [API versions](https://developer.revolut.com/docs/guides/merchant/reference/versioning/api-versions).\n:::","x-config-always-visible-in-example":true,"example":"2025-10-16","descriptionNode":"$L19c"},{"name":"dispute_id","in":"path","schema":{"type":"string","format":"uuid","description":"A UUID string, typically used to identify resources.","descriptionNode":"$L19d"},"required":true,"description":"The ID of the `Dispute` object.","descriptionNode":"$L19e"}],"requestBody":"$undefined","heading":"Request","requestBodySchemaTitle":"Request body","headingAs":"h3"}],["$","$L89",null,{"responses":"$46:props:children:0:props:children:props:responses","headingAs":"h3"}]]}],["$","div",null,{"className":"ezz1n32","children":[[["$","$L8a",null,{"itemsByServer":{"https://merchant.revolut.com":[{"id":"curl","label":"cURL","templateCode":"curl -X POST \"https://merchant.revolut.com/api/disputes/__RP_TOK_0__/accept\" \\\n -H \"Authorization: __RP_TOK_1__\" \\\n -H \"Revolut-Api-Version: __RP_TOK_2__\"","templateHtml":"
curl -X POST \"https://merchant.revolut.com/api/disputes/__RP_TOK_0__/accept\" \\\n  -H \"Authorization: __RP_TOK_1__\" \\\n  -H \"Revolut-Api-Version: __RP_TOK_2__\"
","tokens":[{"marker":"__RP_TOK_0__","paramName":"dispute_id","paramIn":"path","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["shell-double-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:dispute_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"javascript","label":"JavaScript","templateCode":"fetch(\"https://merchant.revolut.com/api/disputes/__RP_TOK_0__/accept\", {\n method: \"POST\",\n headers: {\n \"Authorization\": \"__RP_TOK_1__\",\n \"Revolut-Api-Version\": \"__RP_TOK_2__\"\n }\n})\n .then(response => response.json())\n .then(data => console.log(data));","templateHtml":"$19f","tokens":[{"marker":"__RP_TOK_0__","paramName":"dispute_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:dispute_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"go","label":"Go","templateCode":"package main\n\nimport (\n \"fmt\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://merchant.revolut.com/api/disputes/__RP_TOK_0__/accept\"\n req, _ := http.NewRequest(\"POST\", url, nil)\n req.Header.Add(\"Authorization\", \"__RP_TOK_1__\")\n req.Header.Add(\"Revolut-Api-Version\", \"__RP_TOK_2__\")\n\n res, _ := http.DefaultClient.Do(req)\n defer res.Body.Close()\n fmt.Println(res)\n}","templateHtml":"$1a0","tokens":[{"marker":"__RP_TOK_0__","paramName":"dispute_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:dispute_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"python","label":"Python","templateCode":"import requests\n\nurl = \"https://merchant.revolut.com/api/disputes/__RP_TOK_0__/accept\"\nheaders = {\n \"Authorization\": \"__RP_TOK_1__\",\n \"Revolut-Api-Version\": \"__RP_TOK_2__\"\n}\n\nresponse = requests.post(url, headers=headers)\nprint(response.json())","templateHtml":"$1a1","tokens":[{"marker":"__RP_TOK_0__","paramName":"dispute_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:dispute_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"java","label":"Java","templateCode":"import java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\nimport java.net.URI;\n\npublic class Main {\n public static void main(String[] args) {\n HttpClient client = HttpClient.newHttpClient();\n HttpRequest request = HttpRequest.newBuilder()\n .uri(URI.create(\"https://merchant.revolut.com/api/disputes/__RP_TOK_0__/accept\"))\n .header(\"Authorization\", \"__RP_TOK_1__\")\n .header(\"Revolut-Api-Version\", \"__RP_TOK_2__\")\n .POST(HttpRequest.BodyPublishers.noBody())\n .build();\n\n client.sendAsync(request, HttpResponse.BodyHandlers.ofString())\n .thenApply(HttpResponse::body)\n .thenAccept(System.out::println)\n .join();\n }\n}","templateHtml":"$1a2","tokens":[{"marker":"__RP_TOK_0__","paramName":"dispute_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:dispute_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"csharp","label":"C#","templateCode":"using System.Net.Http;\nusing System.Net.Http.Headers;\n\nvar client = new HttpClient();\nvar request = new HttpRequestMessage\n{\n Method = HttpMethod.Post,\n RequestUri = new Uri(\"https://merchant.revolut.com/api/disputes/__RP_TOK_0__/accept\"),\n Headers =\n {\n { \"Authorization\", \"__RP_TOK_1__\" },\n { \"Revolut-Api-Version\", \"__RP_TOK_2__\" },\n }\n};\n\nusing (var response = await client.SendAsync(request))\n{\n response.EnsureSuccessStatusCode();\n var body = await response.Content.ReadAsStringAsync();\n Console.WriteLine(body);\n}","templateHtml":"$1a3","tokens":[{"marker":"__RP_TOK_0__","paramName":"dispute_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:dispute_id":"123e4567-e89b-12d3-a456-426614174000"}}],"https://sandbox-merchant.revolut.com":[{"id":"curl","label":"cURL","templateCode":"curl -X POST \"https://sandbox-merchant.revolut.com/api/disputes/__RP_TOK_0__/accept\" \\\n -H \"Authorization: __RP_TOK_1__\" \\\n -H \"Revolut-Api-Version: __RP_TOK_2__\"","templateHtml":"
curl -X POST \"https://sandbox-merchant.revolut.com/api/disputes/__RP_TOK_0__/accept\" \\\n  -H \"Authorization: __RP_TOK_1__\" \\\n  -H \"Revolut-Api-Version: __RP_TOK_2__\"
","tokens":[{"marker":"__RP_TOK_0__","paramName":"dispute_id","paramIn":"path","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["shell-double-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:dispute_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"javascript","label":"JavaScript","templateCode":"fetch(\"https://sandbox-merchant.revolut.com/api/disputes/__RP_TOK_0__/accept\", {\n method: \"POST\",\n headers: {\n \"Authorization\": \"__RP_TOK_1__\",\n \"Revolut-Api-Version\": \"__RP_TOK_2__\"\n }\n})\n .then(response => response.json())\n .then(data => console.log(data));","templateHtml":"$1a4","tokens":[{"marker":"__RP_TOK_0__","paramName":"dispute_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:dispute_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"go","label":"Go","templateCode":"package main\n\nimport (\n \"fmt\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://sandbox-merchant.revolut.com/api/disputes/__RP_TOK_0__/accept\"\n req, _ := http.NewRequest(\"POST\", url, nil)\n req.Header.Add(\"Authorization\", \"__RP_TOK_1__\")\n req.Header.Add(\"Revolut-Api-Version\", \"__RP_TOK_2__\")\n\n res, _ := http.DefaultClient.Do(req)\n defer res.Body.Close()\n fmt.Println(res)\n}","templateHtml":"$1a5","tokens":[{"marker":"__RP_TOK_0__","paramName":"dispute_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:dispute_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"python","label":"Python","templateCode":"import requests\n\nurl = \"https://sandbox-merchant.revolut.com/api/disputes/__RP_TOK_0__/accept\"\nheaders = {\n \"Authorization\": \"__RP_TOK_1__\",\n \"Revolut-Api-Version\": \"__RP_TOK_2__\"\n}\n\nresponse = requests.post(url, headers=headers)\nprint(response.json())","templateHtml":"$1a6","tokens":[{"marker":"__RP_TOK_0__","paramName":"dispute_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:dispute_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"java","label":"Java","templateCode":"import java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\nimport java.net.URI;\n\npublic class Main {\n public static void main(String[] args) {\n HttpClient client = HttpClient.newHttpClient();\n HttpRequest request = HttpRequest.newBuilder()\n .uri(URI.create(\"https://sandbox-merchant.revolut.com/api/disputes/__RP_TOK_0__/accept\"))\n .header(\"Authorization\", \"__RP_TOK_1__\")\n .header(\"Revolut-Api-Version\", \"__RP_TOK_2__\")\n .POST(HttpRequest.BodyPublishers.noBody())\n .build();\n\n client.sendAsync(request, HttpResponse.BodyHandlers.ofString())\n .thenApply(HttpResponse::body)\n .thenAccept(System.out::println)\n .join();\n }\n}","templateHtml":"$1a7","tokens":[{"marker":"__RP_TOK_0__","paramName":"dispute_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:dispute_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"csharp","label":"C#","templateCode":"using System.Net.Http;\nusing System.Net.Http.Headers;\n\nvar client = new HttpClient();\nvar request = new HttpRequestMessage\n{\n Method = HttpMethod.Post,\n RequestUri = new Uri(\"https://sandbox-merchant.revolut.com/api/disputes/__RP_TOK_0__/accept\"),\n Headers =\n {\n { \"Authorization\", \"__RP_TOK_1__\" },\n { \"Revolut-Api-Version\", \"__RP_TOK_2__\" },\n }\n};\n\nusing (var response = await client.SendAsync(request))\n{\n response.EnsureSuccessStatusCode();\n var body = await response.Content.ReadAsStringAsync();\n Console.WriteLine(body);\n}","templateHtml":"$1a8","tokens":[{"marker":"__RP_TOK_0__","paramName":"dispute_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:dispute_id":"123e4567-e89b-12d3-a456-426614174000"}}]},"method":"post","servers":"$62:props:children:0:props:children:props:children:1:props:children:1:props:children:0:0:props:servers","path":"/api/disputes/{dispute_id}/accept","parameters":["$15b:props:children:0:props:children:1:props:parameters:0","$15b:props:children:0:props:children:1:props:parameters:1","$15b:props:children:0:props:children:1:props:parameters:2"]}],"$L1a9"],"$L1aa","$L1ab"]}]]}] 16d:["$","div",null,{"className":"ezz1n30","children":[["$","div",null,{"data-header":"$undefined","className":"ezz1n31","children":["$","div",null,{"className":"y9a0do1","children":[["$","h2",null,{"id":"retrieve-report-run","children":[["$L1ac","$undefined"],["$","$L15",null,{"id":"retrieve-report-run"}]]}],["$","$L16",null,{"url":"/docs/api/merchant/2025-10-16/operations/retrieve-report-run.md"}]]}]}],"$undefined"]}] 1b1:T8b0,
fetch("https://merchant.revolut.com/api/report-runs/__RP_TOK_0__", {
  method: "GET",
  headers: {
    "Authorization": "__RP_TOK_1__"
  }
})
  .then(response => response.json())
  .then(data => console.log(data));
1b2:Td98,
package main

import (
  "fmt"
  "net/http"
)

func main() {
  url := "https://merchant.revolut.com/api/report-runs/__RP_TOK_0__"
  req, _ := http.NewRequest("GET", url, nil)
  req.Header.Add("Authorization", "__RP_TOK_1__")

  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  fmt.Println(res)
}
1b3:T6c4,
import requests

url = "https://merchant.revolut.com/api/report-runs/__RP_TOK_0__"
headers = {
  "Authorization": "__RP_TOK_1__"
}

response = requests.get(url, headers=headers)
print(response.json())
1b4:T153c,
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;

public class Main {
  public static void main(String[] args) {
    HttpClient client = HttpClient.newHttpClient();
    HttpRequest request = HttpRequest.newBuilder()
      .uri(URI.create("https://merchant.revolut.com/api/report-runs/__RP_TOK_0__"))
      .header("Authorization", "__RP_TOK_1__")
      .GET(HttpRequest.BodyPublishers.noBody())
      .build();

    client.sendAsync(request, HttpResponse.BodyHandlers.ofString())
      .thenApply(HttpResponse::body)
      .thenAccept(System.out::println)
      .join();
  }
}
1b5:T145c,
using System.Net.Http;
using System.Net.Http.Headers;

var client = new HttpClient();
var request = new HttpRequestMessage
{
  Method = HttpMethod.Get,
  RequestUri = new Uri("https://merchant.revolut.com/api/report-runs/__RP_TOK_0__"),
  Headers =
  {
    { "Authorization", "__RP_TOK_1__" },
  }
};

using (var response = await client.SendAsync(request))
{
  response.EnsureSuccessStatusCode();
  var body = await response.Content.ReadAsStringAsync();
  Console.WriteLine(body);
}
1b6:T8b8,
fetch("https://sandbox-merchant.revolut.com/api/report-runs/__RP_TOK_0__", {
  method: "GET",
  headers: {
    "Authorization": "__RP_TOK_1__"
  }
})
  .then(response => response.json())
  .then(data => console.log(data));
1b7:Tda0,
package main

import (
  "fmt"
  "net/http"
)

func main() {
  url := "https://sandbox-merchant.revolut.com/api/report-runs/__RP_TOK_0__"
  req, _ := http.NewRequest("GET", url, nil)
  req.Header.Add("Authorization", "__RP_TOK_1__")

  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  fmt.Println(res)
}
1b8:T6cc,
import requests

url = "https://sandbox-merchant.revolut.com/api/report-runs/__RP_TOK_0__"
headers = {
  "Authorization": "__RP_TOK_1__"
}

response = requests.get(url, headers=headers)
print(response.json())
1b9:T1544,
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;

public class Main {
  public static void main(String[] args) {
    HttpClient client = HttpClient.newHttpClient();
    HttpRequest request = HttpRequest.newBuilder()
      .uri(URI.create("https://sandbox-merchant.revolut.com/api/report-runs/__RP_TOK_0__"))
      .header("Authorization", "__RP_TOK_1__")
      .GET(HttpRequest.BodyPublishers.noBody())
      .build();

    client.sendAsync(request, HttpResponse.BodyHandlers.ofString())
      .thenApply(HttpResponse::body)
      .thenAccept(System.out::println)
      .join();
  }
}
1ba:T1464,
using System.Net.Http;
using System.Net.Http.Headers;

var client = new HttpClient();
var request = new HttpRequestMessage
{
  Method = HttpMethod.Get,
  RequestUri = new Uri("https://sandbox-merchant.revolut.com/api/report-runs/__RP_TOK_0__"),
  Headers =
  {
    { "Authorization", "__RP_TOK_1__" },
  }
};

using (var response = await client.SendAsync(request))
{
  response.EnsureSuccessStatusCode();
  var body = await response.Content.ReadAsStringAsync();
  Console.WriteLine(body);
}
16e:["$","div",null,{"className":"ezz1n30","children":[["$","div",null,{"data-header":"$undefined","className":"ezz1n31","children":["$L1ad",["$","$L85",null,{"parameters":[{"name":"Authorization","in":"header","schema":{"type":"string","format":"Bearer ","examples":"$62:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:0:schema:examples"},"required":true,"description":"This parameter accepts the [Merchant API Secret key](https://business.revolut.com/settings/apis?tab=merchant-api) to authorise requests coming from the merchant's backend. \n\nIt ensures that ensures that each request is authenticated and authorised by verifying the secret key. The secret key should be included in all request headers as a `Bearer` token.\n\n:::info\nFor more information, see: [Authentication](https://developer.revolut.com/docs/api/merchant#authentication)\n:::","descriptionNode":"$L1ae"},{"name":"report_run_id","in":"path","schema":{"type":"string","format":"uuid","description":"A UUID string, typically used to identify resources.","descriptionNode":"$L1af"},"required":true,"description":"Unique ID of the report run.","descriptionNode":"$L1b0"}],"requestBody":"$undefined","heading":"Request","requestBodySchemaTitle":"Request body","headingAs":"h3"}],["$","$L89",null,{"responses":"$54:props:children:0:props:children:props:responses","headingAs":"h3"}]]}],["$","div",null,{"className":"ezz1n32","children":[[["$","$L8a",null,{"itemsByServer":{"https://merchant.revolut.com":[{"id":"curl","label":"cURL","templateCode":"curl -X GET \"https://merchant.revolut.com/api/report-runs/__RP_TOK_0__\" \\\n -H \"Authorization: __RP_TOK_1__\"","templateHtml":"
curl -X GET \"https://merchant.revolut.com/api/report-runs/__RP_TOK_0__\" \\\n  -H \"Authorization: __RP_TOK_1__\"
","tokens":[{"marker":"__RP_TOK_0__","paramName":"report_run_id","paramIn":"path","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["shell-double-inner"]}],"defaults":{"header:Authorization":"Bearer ","path:report_run_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"javascript","label":"JavaScript","templateCode":"fetch(\"https://merchant.revolut.com/api/report-runs/__RP_TOK_0__\", {\n method: \"GET\",\n headers: {\n \"Authorization\": \"__RP_TOK_1__\"\n }\n})\n .then(response => response.json())\n .then(data => console.log(data));","templateHtml":"$1b1","tokens":[{"marker":"__RP_TOK_0__","paramName":"report_run_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","path:report_run_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"go","label":"Go","templateCode":"package main\n\nimport (\n \"fmt\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://merchant.revolut.com/api/report-runs/__RP_TOK_0__\"\n req, _ := http.NewRequest(\"GET\", url, nil)\n req.Header.Add(\"Authorization\", \"__RP_TOK_1__\")\n\n res, _ := http.DefaultClient.Do(req)\n defer res.Body.Close()\n fmt.Println(res)\n}","templateHtml":"$1b2","tokens":[{"marker":"__RP_TOK_0__","paramName":"report_run_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","path:report_run_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"python","label":"Python","templateCode":"import requests\n\nurl = \"https://merchant.revolut.com/api/report-runs/__RP_TOK_0__\"\nheaders = {\n \"Authorization\": \"__RP_TOK_1__\"\n}\n\nresponse = requests.get(url, headers=headers)\nprint(response.json())","templateHtml":"$1b3","tokens":[{"marker":"__RP_TOK_0__","paramName":"report_run_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","path:report_run_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"java","label":"Java","templateCode":"import java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\nimport java.net.URI;\n\npublic class Main {\n public static void main(String[] args) {\n HttpClient client = HttpClient.newHttpClient();\n HttpRequest request = HttpRequest.newBuilder()\n .uri(URI.create(\"https://merchant.revolut.com/api/report-runs/__RP_TOK_0__\"))\n .header(\"Authorization\", \"__RP_TOK_1__\")\n .GET(HttpRequest.BodyPublishers.noBody())\n .build();\n\n client.sendAsync(request, HttpResponse.BodyHandlers.ofString())\n .thenApply(HttpResponse::body)\n .thenAccept(System.out::println)\n .join();\n }\n}","templateHtml":"$1b4","tokens":[{"marker":"__RP_TOK_0__","paramName":"report_run_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","path:report_run_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"csharp","label":"C#","templateCode":"using System.Net.Http;\nusing System.Net.Http.Headers;\n\nvar client = new HttpClient();\nvar request = new HttpRequestMessage\n{\n Method = HttpMethod.Get,\n RequestUri = new Uri(\"https://merchant.revolut.com/api/report-runs/__RP_TOK_0__\"),\n Headers =\n {\n { \"Authorization\", \"__RP_TOK_1__\" },\n }\n};\n\nusing (var response = await client.SendAsync(request))\n{\n response.EnsureSuccessStatusCode();\n var body = await response.Content.ReadAsStringAsync();\n Console.WriteLine(body);\n}","templateHtml":"$1b5","tokens":[{"marker":"__RP_TOK_0__","paramName":"report_run_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","path:report_run_id":"123e4567-e89b-12d3-a456-426614174000"}}],"https://sandbox-merchant.revolut.com":[{"id":"curl","label":"cURL","templateCode":"curl -X GET \"https://sandbox-merchant.revolut.com/api/report-runs/__RP_TOK_0__\" \\\n -H \"Authorization: __RP_TOK_1__\"","templateHtml":"
curl -X GET \"https://sandbox-merchant.revolut.com/api/report-runs/__RP_TOK_0__\" \\\n  -H \"Authorization: __RP_TOK_1__\"
","tokens":[{"marker":"__RP_TOK_0__","paramName":"report_run_id","paramIn":"path","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["shell-double-inner"]}],"defaults":{"header:Authorization":"Bearer ","path:report_run_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"javascript","label":"JavaScript","templateCode":"fetch(\"https://sandbox-merchant.revolut.com/api/report-runs/__RP_TOK_0__\", {\n method: \"GET\",\n headers: {\n \"Authorization\": \"__RP_TOK_1__\"\n }\n})\n .then(response => response.json())\n .then(data => console.log(data));","templateHtml":"$1b6","tokens":[{"marker":"__RP_TOK_0__","paramName":"report_run_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","path:report_run_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"go","label":"Go","templateCode":"package main\n\nimport (\n \"fmt\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://sandbox-merchant.revolut.com/api/report-runs/__RP_TOK_0__\"\n req, _ := http.NewRequest(\"GET\", url, nil)\n req.Header.Add(\"Authorization\", \"__RP_TOK_1__\")\n\n res, _ := http.DefaultClient.Do(req)\n defer res.Body.Close()\n fmt.Println(res)\n}","templateHtml":"$1b7","tokens":[{"marker":"__RP_TOK_0__","paramName":"report_run_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","path:report_run_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"python","label":"Python","templateCode":"import requests\n\nurl = \"https://sandbox-merchant.revolut.com/api/report-runs/__RP_TOK_0__\"\nheaders = {\n \"Authorization\": \"__RP_TOK_1__\"\n}\n\nresponse = requests.get(url, headers=headers)\nprint(response.json())","templateHtml":"$1b8","tokens":[{"marker":"__RP_TOK_0__","paramName":"report_run_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","path:report_run_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"java","label":"Java","templateCode":"import java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\nimport java.net.URI;\n\npublic class Main {\n public static void main(String[] args) {\n HttpClient client = HttpClient.newHttpClient();\n HttpRequest request = HttpRequest.newBuilder()\n .uri(URI.create(\"https://sandbox-merchant.revolut.com/api/report-runs/__RP_TOK_0__\"))\n .header(\"Authorization\", \"__RP_TOK_1__\")\n .GET(HttpRequest.BodyPublishers.noBody())\n .build();\n\n client.sendAsync(request, HttpResponse.BodyHandlers.ofString())\n .thenApply(HttpResponse::body)\n .thenAccept(System.out::println)\n .join();\n }\n}","templateHtml":"$1b9","tokens":[{"marker":"__RP_TOK_0__","paramName":"report_run_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","path:report_run_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"csharp","label":"C#","templateCode":"using System.Net.Http;\nusing System.Net.Http.Headers;\n\nvar client = new HttpClient();\nvar request = new HttpRequestMessage\n{\n Method = HttpMethod.Get,\n RequestUri = new Uri(\"https://sandbox-merchant.revolut.com/api/report-runs/__RP_TOK_0__\"),\n Headers =\n {\n { \"Authorization\", \"__RP_TOK_1__\" },\n }\n};\n\nusing (var response = await client.SendAsync(request))\n{\n response.EnsureSuccessStatusCode();\n var body = await response.Content.ReadAsStringAsync();\n Console.WriteLine(body);\n}","templateHtml":"$1ba","tokens":[{"marker":"__RP_TOK_0__","paramName":"report_run_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","path:report_run_id":"123e4567-e89b-12d3-a456-426614174000"}}]},"method":"get","servers":"$62:props:children:0:props:children:props:children:1:props:children:1:props:children:0:0:props:servers","path":"/api/report-runs/{report_run_id}","parameters":["$16e:props:children:0:props:children:1:props:parameters:0","$16e:props:children:0:props:children:1:props:parameters:1"]}],"$L1bb"],"$L1bc","$L1bd"]}]]}] 188:["$","$L10d",null,{"security":[{"Api-Key":[]}],"authorization":{"Api-Key":{"type":"apiKey","in":"header","name":"Authorization","description":"Each Merchant API request must contain an authorization header in the following format:\n\n```\n'Authorization: Bearer '\n```\n\nTo use this API, you need to generate API keys from your Revolut Business account. The Secret key is used in the authorization header for all server calls, while the Public key is provided with payment methods at checkout.\n\n:::info\nFor detailed instructions on generating your API keys, see: [Generate API keys](https://developer.revolut.com/docs/guides/merchant/get-started#generate-api-keys).\n:::","descriptionNode":"$L1be"}}}] 189:["$","$L10f",null,{"exampleBlocks":{},"title":"Request body samples","headingAs":"h4"}] 18a:["$","$L110",null,{"exampleBlocks":{"204":{},"401":{"application/json":{"variants":[{"key":"default","label":"Example","rawValue":{"code":"string","message":"string","timestamp":123},"block":"$L1bf"}],"syncedPropertyName":"$undefined"}},"404":{"application/json":{"variants":[{"key":"default","label":"Example","rawValue":{"code":"string","message":"string","timestamp":123},"block":"$L1c0"}],"syncedPropertyName":"$undefined"}}},"headingAs":"h4"}] 83:"Delete a location" 1a9:["$","$L10d",null,{"security":[{"Api-Key":[]}],"authorization":{"Api-Key":{"type":"apiKey","in":"header","name":"Authorization","description":"Each Merchant API request must contain an authorization header in the following format:\n\n```\n'Authorization: Bearer '\n```\n\nTo use this API, you need to generate API keys from your Revolut Business account. The Secret key is used in the authorization header for all server calls, while the Public key is provided with payment methods at checkout.\n\n:::info\nFor detailed instructions on generating your API keys, see: [Generate API keys](https://developer.revolut.com/docs/guides/merchant/get-started#generate-api-keys).\n:::","descriptionNode":"$L1c1"}}}] 1aa:["$","$L10f",null,{"exampleBlocks":{},"title":"Request body samples","headingAs":"h4"}] 1ab:["$","$L110",null,{"exampleBlocks":{"204":{},"400":{"application/json":{"variants":[{"key":"default","label":"default","rawValue":"$46:props:children:0:props:children:props:responses:400:content:application/json:examples:default:value","block":"$L1c2"}],"syncedPropertyName":"$undefined"}},"401":{"application/json":{"variants":[{"key":"default","label":"default","rawValue":"$46:props:children:0:props:children:props:responses:401:content:application/json:examples:default:value","block":"$L1c3"}],"syncedPropertyName":"$undefined"}},"403":{"application/json":{"variants":[{"key":"default","label":"default","rawValue":"$46:props:children:0:props:children:props:responses:403:content:application/json:examples:default:value","block":"$L1c4"}],"syncedPropertyName":"$undefined"}},"404":{"application/json":{"variants":[{"key":"default","label":"default","rawValue":"$46:props:children:0:props:children:props:responses:404:content:application/json:examples:default:value","block":"$L1c5"}],"syncedPropertyName":"$undefined"}},"422":{"application/json":{"variants":[{"key":"default","label":"Example","rawValue":{"code":"string","message":"string","timestamp":123},"block":"$L1c6"}],"syncedPropertyName":"$undefined"}}},"headingAs":"h4"}] 1bb:["$","$L10d",null,{"security":[{"Api-Key":[]}],"authorization":{"Api-Key":{"type":"apiKey","in":"header","name":"Authorization","description":"Each Merchant API request must contain an authorization header in the following format:\n\n```\n'Authorization: Bearer '\n```\n\nTo use this API, you need to generate API keys from your Revolut Business account. The Secret key is used in the authorization header for all server calls, while the Public key is provided with payment methods at checkout.\n\n:::info\nFor detailed instructions on generating your API keys, see: [Generate API keys](https://developer.revolut.com/docs/guides/merchant/get-started#generate-api-keys).\n:::","descriptionNode":"$L1c7"}}}] 1bc:["$","$L10f",null,{"exampleBlocks":{},"title":"Request body samples","headingAs":"h4"}] 1bd:["$","$L110",null,{"exampleBlocks":{"200":{"application/json":{"variants":[{"key":"report_run_processing","label":"Report run processing","rawValue":"$54:props:children:0:props:children:props:responses:200:content:application/json:examples:report_run_processing:value","block":"$L1c8"},{"key":"report_run_completed","label":"Report run completed","rawValue":"$54:props:children:0:props:children:props:responses:200:content:application/json:examples:report_run_completed:value","block":"$L1c9"},{"key":"report_run_expired","label":"Report run expired","rawValue":"$54:props:children:0:props:children:props:responses:200:content:application/json:examples:report_run_expired:value","block":"$L1ca"}],"syncedPropertyName":"$undefined"}},"400":{"application/json":{"variants":[{"key":"default","label":"Example","rawValue":{"code":"string","message":"string","timestamp":123},"block":"$L1cb"}],"syncedPropertyName":"$undefined"}},"401":{"application/json":{"variants":[{"key":"default","label":"Example","rawValue":{"code":"string","message":"string","timestamp":123},"block":"$L1cc"}],"syncedPropertyName":"$undefined"}},"404":{"application/json":{"variants":[{"key":"default","label":"Example","rawValue":{"code":"string","message":"string","timestamp":123},"block":"$L1cd"}],"syncedPropertyName":"$undefined"}}},"headingAs":"h4"}] 9d:"Delete a synchronous webhook" b8:"Delete a customer" d4:"Delete a customer's payment method" ee:"Cancel a subscription" 10b:"Delete a subscription usage" 178:"Delete a webhook" 7c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Location deleted"}]]}] 7d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The ID of the error. You can share this ID with Revolut support for troubleshooting."}]]}] 7e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The date and time the error happened."}]]}] 7f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unauthorized"}]]}] 80:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The ID of the error. You can share this ID with Revolut support for troubleshooting."}]]}] 81:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The date and time the error happened."}]]}] 82:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Not Found"}]]}] 84:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Delete a specific location, based on its ID."}]]}] 86:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["This parameter accepts the ",["$","a","a-0",{"href":"https://business.revolut.com/settings/apis?tab=merchant-api","target":"_blank","rel":"noreferrer","children":"Merchant API Secret key"}]," to authorise requests coming from the merchant's backend."]}],"\n",["$","p","p-1",{"children":["It ensures that ensures that each request is authenticated and authorised by verifying the secret key. The secret key should be included in all request headers as a ",["$","code","code-0",{"children":"Bearer"}]," token."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#authentication","target":"_blank","rel":"noreferrer","children":"Authentication"}]]}]}]]}]]}] 87:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A UUID string, typically used to identify resources."}]]}] 88:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The ID of the location."}]]}] 199:"Accept a dispute" 1ac:"Retrieve a report run" 98:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Synchronous webhook deleted"}]]}] 99:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unauthorized"}]]}] 9a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The ID of the error. You can share this ID with Revolut support for troubleshooting."}]]}] 9b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The date and time the error happened."}]]}] 9c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Not Found"}]]}] 9e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Delete a specific synchronous webhook registration, based on its ID."}]]}] 9f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["This parameter accepts the ",["$","a","a-0",{"href":"https://business.revolut.com/settings/apis?tab=merchant-api","target":"_blank","rel":"noreferrer","children":"Merchant API Secret key"}]," to authorise requests coming from the merchant's backend."]}],"\n",["$","p","p-1",{"children":["It ensures that ensures that each request is authenticated and authorised by verifying the secret key. The secret key should be included in all request headers as a ",["$","code","code-0",{"children":"Bearer"}]," token."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#authentication","target":"_blank","rel":"noreferrer","children":"Authentication"}]]}]}]]}]]}] a0:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A UUID string, typically used to identify resources."}]]}] a1:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The ID of the synchronous webhook."}]]}] af:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"No Content"}]]}] b0:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An identifier that can be used to determine what went wrong."}],"\n",["$","p","p-1",{"children":"Error codes are not globally unique, but uniqueness is guaranteed within endpoints."}]]}] b1:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Some human readable text describing what went wrong."}]]}] b2:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://www.unixtimestamp.com/","target":"_blank","rel":"noreferrer","children":"UNIX timestamp"}]," of the date and time the error happened."]}]]}] b3:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unauthorized"}]]}] b4:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An identifier that can be used to determine what went wrong."}],"\n",["$","p","p-1",{"children":"Error codes are not globally unique, but uniqueness is guaranteed within endpoints."}]]}] b5:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Some human readable text describing what went wrong."}]]}] b6:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://www.unixtimestamp.com/","target":"_blank","rel":"noreferrer","children":"UNIX timestamp"}]," of the date and time the error happened."]}]]}] b7:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Not Found"}]]}] b9:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Delete the profile of a specific customer."}]]}] ba:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["This parameter accepts the ",["$","a","a-0",{"href":"https://business.revolut.com/settings/apis?tab=merchant-api","target":"_blank","rel":"noreferrer","children":"Merchant API Secret key"}]," to authorise requests coming from the merchant's backend."]}],"\n",["$","p","p-1",{"children":["It ensures that ensures that each request is authenticated and authorised by verifying the secret key. The secret key should be included in all request headers as a ",["$","code","code-0",{"children":"Bearer"}]," token."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#authentication","target":"_blank","rel":"noreferrer","children":"Authentication"}]]}]}]]}]]}] bb:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The version of the Merchant API, specified in ",["$","code","code-0",{"children":"YYYY-MM-DD"}]," format."]}],"\n",["$","p","p-1",{"children":["This endpoint is available from version ",["$","code","code-0",{"children":"2024-09-01"}],". If a version earlier than ",["$","code","code-1",{"children":"2024-09-01"}]," is provided, the endpoint returns a ",["$","code","code-2",{"children":"404"}]," response."]}],"\n",["$","p","p-2",{"children":"If not specified, you will receive an error."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information about API versioning, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/reference/versioning/api-versions","target":"_blank","rel":"noreferrer","children":"API versions"}],"."]}]}]]}]]}] bc:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A UUID string, typically used to identify resources."}]]}] bd:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ID of the ",["$","code","code-0",{"children":"Customer"}]," object."]}]]}] cb:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"No Content"}]]}] cc:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An identifier that can be used to determine what went wrong."}],"\n",["$","p","p-1",{"children":"Error codes are not globally unique, but uniqueness is guaranteed within endpoints."}]]}] cd:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Some human readable text describing what went wrong."}]]}] ce:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://www.unixtimestamp.com/","target":"_blank","rel":"noreferrer","children":"UNIX timestamp"}]," of the date and time the error happened."]}]]}] cf:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unauthorized"}]]}] d0:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An identifier that can be used to determine what went wrong."}],"\n",["$","p","p-1",{"children":"Error codes are not globally unique, but uniqueness is guaranteed within endpoints."}]]}] d1:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Some human readable text describing what went wrong."}]]}] d2:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://www.unixtimestamp.com/","target":"_blank","rel":"noreferrer","children":"UNIX timestamp"}]," of the date and time the error happened."]}]]}] d3:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Not Found"}]]}] d5:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Delete a specific saved payment method. The payment method is completely removed from the customer's saved payment methods."}],"\n",["$","p","p-1",{"children":"To reuse a deleted payment method, direct your customer to the checkout page to save their card details again."}]]}] d6:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["This parameter accepts the ",["$","a","a-0",{"href":"https://business.revolut.com/settings/apis?tab=merchant-api","target":"_blank","rel":"noreferrer","children":"Merchant API Secret key"}]," to authorise requests coming from the merchant's backend."]}],"\n",["$","p","p-1",{"children":["It ensures that ensures that each request is authenticated and authorised by verifying the secret key. The secret key should be included in all request headers as a ",["$","code","code-0",{"children":"Bearer"}]," token."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#authentication","target":"_blank","rel":"noreferrer","children":"Authentication"}]]}]}]]}]]}] d7:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The version of the Merchant API, specified in ",["$","code","code-0",{"children":"YYYY-MM-DD"}]," format."]}],"\n",["$","p","p-1",{"children":["This endpoint is available from version ",["$","code","code-0",{"children":"2024-09-01"}],". If a version earlier than ",["$","code","code-1",{"children":"2024-09-01"}]," is provided, the endpoint returns a ",["$","code","code-2",{"children":"404"}]," response."]}],"\n",["$","p","p-2",{"children":"If not specified, you will receive an error."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information about API versioning, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/reference/versioning/api-versions","target":"_blank","rel":"noreferrer","children":"API versions"}],"."]}]}]]}]]}] d8:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A UUID string, typically used to identify resources."}]]}] d9:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ID of the ",["$","code","code-0",{"children":"Customer"}]," object."]}]]}] da:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A UUID string, typically used to identify resources."}]]}] db:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The ID of the payment method."}]]}] dd:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Subscription cancelled successfully"}]]}] de:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An identifier that can be used to determine what went wrong."}],"\n",["$","p","p-1",{"children":"Error codes are not globally unique, but uniqueness is guaranteed within endpoints."}]]}] df:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Some human readable text describing what went wrong."}]]}] e0:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://www.unixtimestamp.com/","target":"_blank","rel":"noreferrer","children":"UNIX timestamp"}]," of the date and time the error happened."]}]]}] e1:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Bad Request"}]]}] e2:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An identifier that can be used to determine what went wrong."}],"\n",["$","p","p-1",{"children":"Error codes are not globally unique, but uniqueness is guaranteed within endpoints."}]]}] e3:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Some human readable text describing what went wrong."}]]}] e4:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://www.unixtimestamp.com/","target":"_blank","rel":"noreferrer","children":"UNIX timestamp"}]," of the date and time the error happened."]}]]}] e5:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unauthorized"}]]}] e6:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An identifier that can be used to determine what went wrong."}],"\n",["$","p","p-1",{"children":"Error codes are not globally unique, but uniqueness is guaranteed within endpoints."}]]}] e7:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Some human readable text describing what went wrong."}]]}] e8:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://www.unixtimestamp.com/","target":"_blank","rel":"noreferrer","children":"UNIX timestamp"}]," of the date and time the error happened."]}]]}] e9:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Subscription not found"}]]}] ea:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An identifier that can be used to determine what went wrong."}],"\n",["$","p","p-1",{"children":"Error codes are not globally unique, but uniqueness is guaranteed within endpoints."}]]}] eb:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Some human readable text describing what went wrong."}]]}] ec:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://www.unixtimestamp.com/","target":"_blank","rel":"noreferrer","children":"UNIX timestamp"}]," of the date and time the error happened."]}]]}] ed:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Error response"}]]}] ef:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Cancel a subscription."}],"\n",["$","p","p-1",{"children":["You can cancel a subscription in any state except ",["$","code","code-0",{"children":"cancelled"}]," or ",["$","code","code-1",{"children":"finished"}],". When you cancel a subscription, it will be marked as ",["$","code","code-2",{"children":"cancelled"}]," and no further billing cycles will be created. Any pending orders will be cancelled."]}]]}] f6:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Usage deleted successfully"}]]}] f7:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An identifier that can be used to determine what went wrong."}],"\n",["$","p","p-1",{"children":"Error codes are not globally unique, but uniqueness is guaranteed within endpoints."}]]}] f8:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Some human readable text describing what went wrong."}]]}] f9:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://www.unixtimestamp.com/","target":"_blank","rel":"noreferrer","children":"UNIX timestamp"}]," of the date and time the error happened."]}]]}] fa:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Bad Request"}]]}] fb:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An identifier that can be used to determine what went wrong."}],"\n",["$","p","p-1",{"children":"Error codes are not globally unique, but uniqueness is guaranteed within endpoints."}]]}] fc:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Some human readable text describing what went wrong."}]]}] fd:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://www.unixtimestamp.com/","target":"_blank","rel":"noreferrer","children":"UNIX timestamp"}]," of the date and time the error happened."]}]]}] fe:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unauthorized"}]]}] ff:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An identifier that can be used to determine what went wrong."}],"\n",["$","p","p-1",{"children":"Error codes are not globally unique, but uniqueness is guaranteed within endpoints."}]]}] 100:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Some human readable text describing what went wrong."}]]}] 101:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://www.unixtimestamp.com/","target":"_blank","rel":"noreferrer","children":"UNIX timestamp"}]," of the date and time the error happened."]}]]}] 102:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Usage not found"}]]}] 103:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An identifier that can be used to determine what went wrong."}],"\n",["$","p","p-1",{"children":"Error codes are not globally unique, but uniqueness is guaranteed within endpoints."}]]}] 104:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Some human readable text describing what went wrong."}]]}] 105:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://www.unixtimestamp.com/","target":"_blank","rel":"noreferrer","children":"UNIX timestamp"}]," of the date and time the error happened."]}]]}] 106:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unprocessable entity (business rule violation)"}]]}] 107:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An identifier that can be used to determine what went wrong."}],"\n",["$","p","p-1",{"children":"Error codes are not globally unique, but uniqueness is guaranteed within endpoints."}]]}] 108:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Some human readable text describing what went wrong."}]]}] 109:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://www.unixtimestamp.com/","target":"_blank","rel":"noreferrer","children":"UNIX timestamp"}]," of the date and time the error happened."]}]]}] 10a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Error response"}]]}] 1d0:T47c,List of event types that the webhook is configured to listen to. Each event is related to status changes of a specific object in the Merchant API: | Object | Event types | | --------- | ----------- | | `Order` |
  • `ORDER_COMPLETED`
  • `ORDER_AUTHORISED`
  • `ORDER_CANCELLED`
  • `ORDER_FAILED`
  • `ORDER_INCREMENTAL_AUTHORISATION_AUTHORISED`
  • `ORDER_INCREMENTAL_AUTHORISATION_DECLINED`
  • `ORDER_INCREMENTAL_AUTHORISATION_FAILED`
| | `Payment` |
  • `ORDER_PAYMENT_AUTHENTICATION_CHALLENGED`
  • `ORDER_PAYMENT_AUTHENTICATED`
  • `ORDER_PAYMENT_AUTHORISATION_STARTED`
  • `ORDER_PAYMENT_DECLINED`
  • `ORDER_PAYMENT_FAILED`
| | `Subscription` |
  • `SUBSCRIPTION_INITIATED`
  • `SUBSCRIPTION_FINISHED`
  • `SUBSCRIPTION_CANCELLED`
  • `SUBSCRIPTION_OVERDUE`
| | `Payout` |
  • `PAYOUT_INITIATED`
  • `PAYOUT_COMPLETED`
  • `PAYOUT_FAILED`
| | `Dispute` |
  • `DISPUTE_ACTION_REQUIRED`
  • `DISPUTE_UNDER_REVIEW`
  • `DISPUTE_WON`
  • `DISPUTE_LOST`
|59:["$","$7a","retrieve-webhook",{"children":[["$","section",null,{"className":"y9a0do0","data-variant":"endpoint","children":["$","$L7b",null,{"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"title":"Webhook","type":"object","description":"A webhook object.\n\nUnlike the legacy API, `signing_secret` is included in all webhook responses, not only on creation.","properties":{"id":{"type":"string","format":"uuid","description":"The ID of the webhook.","descriptionNode":"$L1ce"},"url":{"type":"string","format":"uri","pattern":"^https?:\\/{2}.+/gi","maxLength":2000,"description":"Your webhook's URL to which event notifications will be sent. \n\nMust be a valid HTTP or HTTPS URL, capable of receiving `POST` requests.\n\n:::warning\nRestrictions:\n- Must be a valid URI as defined by [RFC 3986](https://datatracker.ietf.org/doc/html/rfc3986)\n- URI scheme is required and must be either `http` or `https`\n- URI host is required and cannot be `localhost` or an IP address\n- Max length: `2000`\n- Reserved or invalid characters must be percent-encoded (for example, use `%20` instead of a space)\n:::","descriptionNode":"$L1cf"},"events":{"type":"array","description":"$1d0","items":{"type":"string","description":"The available event types your can listen to.","enum":["ORDER_COMPLETED","ORDER_AUTHORISED","ORDER_CANCELLED","ORDER_FAILED","ORDER_INCREMENTAL_AUTHORISATION_AUTHORISED","ORDER_INCREMENTAL_AUTHORISATION_DECLINED","ORDER_INCREMENTAL_AUTHORISATION_FAILED","ORDER_PAYMENT_AUTHENTICATION_CHALLENGED","ORDER_PAYMENT_AUTHENTICATED","ORDER_PAYMENT_AUTHORISATION_STARTED","ORDER_PAYMENT_DECLINED","ORDER_PAYMENT_FAILED","SUBSCRIPTION_INITIATED","SUBSCRIPTION_FINISHED","SUBSCRIPTION_CANCELLED","SUBSCRIPTION_OVERDUE","PAYOUT_INITIATED","PAYOUT_COMPLETED","PAYOUT_FAILED","DISPUTE_ACTION_REQUIRED","DISPUTE_UNDER_REVIEW","DISPUTE_WON","DISPUTE_LOST"],"descriptionNode":"$L1d1"},"minItems":1,"descriptionNode":"$L1d2"},"signing_secret":{"type":"string","description":"The signing secret for the webhook. Use it to verify the signature for the webhook request's payload.","descriptionNode":"$L1d3"}},"required":["id","url","events","signing_secret"],"descriptionNode":"$L1d4"},"examples":{"retrieved_webhook":{"summary":"Webhook","value":{"id":"c6b981f4-53b3-47d5-9b24-4f87af1160eb","url":"https://example.com/webhooks","events":["ORDER_AUTHORISED","ORDER_COMPLETED"],"signing_secret":"wsk_4jETWMz1g1b37gCONjNp84t2KSSIT7dK"}}}}},"descriptionNode":"$L1d5"},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"errorId":{"type":"string","description":"The ID of the error. You can share this ID with Revolut support for troubleshooting.","descriptionNode":"$L1d6"},"timestamp":{"type":"integer","description":"The date and time the error happened.","descriptionNode":"$L1d7"}},"required":"$62:props:children:0:props:children:props:responses:401:content:application/json:schema:required"}}},"descriptionNode":"$L1d8"},"404":{"description":"Not Found","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"errorId":{"type":"string","description":"The ID of the error. You can share this ID with Revolut support for troubleshooting.","descriptionNode":"$L1d9"},"timestamp":{"type":"integer","description":"The date and time the error happened.","descriptionNode":"$L1da"}},"required":"$62:props:children:0:props:children:props:responses:401:content:application/json:schema:required"}}},"descriptionNode":"$L1db"}},"requestBody":"$undefined","variantLabels":[],"children":["$L1dc","$L1dd"]}]}],false]}] 10e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Each Merchant API request must contain an authorization header in the following format:"}],"\n","$L1de","\n",["$","p","p-1",{"children":"To use this API, you need to generate API keys from your Revolut Business account. The Secret key is used in the authorization header for all server calls, while the Public key is provided with payment methods at checkout."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For detailed instructions on generating your API keys, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/get-started#generate-api-keys","target":"_blank","rel":"noreferrer","children":"Generate API keys"}],"."]}]}]]}]]}] 113:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Each Merchant API request must contain an authorization header in the following format:"}],"\n","$L1df","\n",["$","p","p-1",{"children":"To use this API, you need to generate API keys from your Revolut Business account. The Secret key is used in the authorization header for all server calls, while the Public key is provided with payment methods at checkout."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For detailed instructions on generating your API keys, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/get-started#generate-api-keys","target":"_blank","rel":"noreferrer","children":"Generate API keys"}],"."]}]}]]}]]}] 115:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Each Merchant API request must contain an authorization header in the following format:"}],"\n","$L1e0","\n",["$","p","p-1",{"children":"To use this API, you need to generate API keys from your Revolut Business account. The Secret key is used in the authorization header for all server calls, while the Public key is provided with payment methods at checkout."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For detailed instructions on generating your API keys, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/get-started#generate-api-keys","target":"_blank","rel":"noreferrer","children":"Generate API keys"}],"."]}]}]]}]]}] f0:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["This parameter accepts the ",["$","a","a-0",{"href":"https://business.revolut.com/settings/apis?tab=merchant-api","target":"_blank","rel":"noreferrer","children":"Merchant API Secret key"}]," to authorise requests coming from the merchant's backend."]}],"\n",["$","p","p-1",{"children":["It ensures that ensures that each request is authenticated and authorised by verifying the secret key. The secret key should be included in all request headers as a ",["$","code","code-0",{"children":"Bearer"}]," token."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#authentication","target":"_blank","rel":"noreferrer","children":"Authentication"}]]}]}]]}]]}] f1:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The version of the Merchant API, specified in ",["$","code","code-0",{"children":"YYYY-MM-DD"}]," format."]}],"\n",["$","p","p-1",{"children":"If not specified, you will receive an error."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information about API versioning, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/reference/versioning/api-versions","target":"_blank","rel":"noreferrer","children":"API versions"}],"."]}]}]]}]]}] f2:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A UUID string, typically used to identify resources."}]]}] f3:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The ID of the subscription."}]]}] 132:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Delete a subscription usage record. This operation is only permitted while the billing cycle is still open."}]]}] 133:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["This parameter accepts the ",["$","a","a-0",{"href":"https://business.revolut.com/settings/apis?tab=merchant-api","target":"_blank","rel":"noreferrer","children":"Merchant API Secret key"}]," to authorise requests coming from the merchant's backend."]}],"\n",["$","p","p-1",{"children":["It ensures that ensures that each request is authenticated and authorised by verifying the secret key. The secret key should be included in all request headers as a ",["$","code","code-0",{"children":"Bearer"}]," token."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#authentication","target":"_blank","rel":"noreferrer","children":"Authentication"}]]}]}]]}]]}] 134:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The version of the Merchant API, specified in ",["$","code","code-0",{"children":"YYYY-MM-DD"}]," format."]}],"\n",["$","p","p-1",{"children":"If not specified, you will receive an error."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information about API versioning, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/reference/versioning/api-versions","target":"_blank","rel":"noreferrer","children":"API versions"}],"."]}]}]]}]]}] 135:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A UUID string, typically used to identify resources."}]]}] 136:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The ID of the usage record."}]]}] 144:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Dispute accepted successfully"}]]}] 145:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An identifier that can be used to determine what went wrong."}],"\n",["$","p","p-1",{"children":"Error codes are not globally unique, but uniqueness is guaranteed within endpoints."}]]}] 146:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Some human readable text describing what went wrong."}]]}] 147:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://www.unixtimestamp.com/","target":"_blank","rel":"noreferrer","children":"UNIX timestamp"}]," of the date and time the error happened."]}]]}] 148:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Bad Request"}]]}] 149:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An identifier that can be used to determine what went wrong."}],"\n",["$","p","p-1",{"children":"Error codes are not globally unique, but uniqueness is guaranteed within endpoints."}]]}] 14a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Some human readable text describing what went wrong."}]]}] 14b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://www.unixtimestamp.com/","target":"_blank","rel":"noreferrer","children":"UNIX timestamp"}]," of the date and time the error happened."]}]]}] 14c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unauthorized"}]]}] 14d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An identifier that can be used to determine what went wrong."}],"\n",["$","p","p-1",{"children":"Error codes are not globally unique, but uniqueness is guaranteed within endpoints."}]]}] 14e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Some human readable text describing what went wrong."}]]}] 14f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://www.unixtimestamp.com/","target":"_blank","rel":"noreferrer","children":"UNIX timestamp"}]," of the date and time the error happened."]}]]}] 150:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Forbidden"}]]}] 151:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An identifier that can be used to determine what went wrong."}],"\n",["$","p","p-1",{"children":"Error codes are not globally unique, but uniqueness is guaranteed within endpoints."}]]}] 152:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Some human readable text describing what went wrong."}]]}] 153:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://www.unixtimestamp.com/","target":"_blank","rel":"noreferrer","children":"UNIX timestamp"}]," of the date and time the error happened."]}]]}] 154:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Not Found"}]]}] 155:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An identifier that can be used to determine what went wrong."}],"\n",["$","p","p-1",{"children":"Error codes are not globally unique, but uniqueness is guaranteed within endpoints."}]]}] 156:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Some human readable text describing what went wrong."}]]}] 157:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://www.unixtimestamp.com/","target":"_blank","rel":"noreferrer","children":"UNIX timestamp"}]," of the date and time the error happened."]}]]}] 158:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unprocessable entity"}]]}] 15c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unique ID used for accessing report details. Use this to check report generation status."}]]}] 15d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Current status of the report run."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Value","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"processing"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Report generation is still in progress.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"completed"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["Report generation finished successfully and the file is available to download for 24 hours via ",["$","code","code-0",{"children":"file_url"}],"."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"failed"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Report generation failed and no report file is available.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"expired"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Report generation previously completed, but the 24-hour file availability window has elapsed and the file can no longer be downloaded.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 15e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["Use this link to download the report file. Available only when ",["$","code","code-0",{"children":"status"}]," is ",["$","code","code-1",{"children":"completed"}],", and only for 24 hours after report generation finishes."]}]]}] 15f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","code","code-0",{"children":"ReportRunDetails"}]," object contains all information associated with a specific report run, identified by the ",["$","code","code-1",{"children":"report_run_id"}],"."]}]]}] 160:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Report run found"}]]}] 161:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An identifier that can be used to determine what went wrong."}],"\n",["$","p","p-1",{"children":"Error codes are not globally unique, but uniqueness is guaranteed within endpoints."}]]}] 162:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Some human readable text describing what went wrong."}]]}] 163:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://www.unixtimestamp.com/","target":"_blank","rel":"noreferrer","children":"UNIX timestamp"}]," of the date and time the error happened."]}]]}] 164:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Bad Request"}]]}] 165:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An identifier that can be used to determine what went wrong."}],"\n",["$","p","p-1",{"children":"Error codes are not globally unique, but uniqueness is guaranteed within endpoints."}]]}] 166:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Some human readable text describing what went wrong."}]]}] 167:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://www.unixtimestamp.com/","target":"_blank","rel":"noreferrer","children":"UNIX timestamp"}]," of the date and time the error happened."]}]]}] 168:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unauthorized"}]]}] 169:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An identifier that can be used to determine what went wrong."}],"\n",["$","p","p-1",{"children":"Error codes are not globally unique, but uniqueness is guaranteed within endpoints."}]]}] 16a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Some human readable text describing what went wrong."}]]}] 16f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"No Content"}]]}] 170:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An identifier that can be used to determine what went wrong."}],"\n",["$","p","p-1",{"children":"Error codes are not globally unique, but uniqueness is guaranteed within endpoints."}]]}] 171:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Some human readable text describing what went wrong."}]]}] 172:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://www.unixtimestamp.com/","target":"_blank","rel":"noreferrer","children":"UNIX timestamp"}]," of the date and time the error happened."]}]]}] 173:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unauthorized"}]]}] 174:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An identifier that can be used to determine what went wrong."}],"\n",["$","p","p-1",{"children":"Error codes are not globally unique, but uniqueness is guaranteed within endpoints."}]]}] 175:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Some human readable text describing what went wrong."}]]}] 176:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://www.unixtimestamp.com/","target":"_blank","rel":"noreferrer","children":"UNIX timestamp"}]," of the date and time the error happened."]}]]}] 177:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Not Found"}]]}] 179:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Delete a webhook so that events are no longer sent to the specified URL."}]]}] 17a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["This parameter accepts the ",["$","a","a-0",{"href":"https://business.revolut.com/settings/apis?tab=merchant-api","target":"_blank","rel":"noreferrer","children":"Merchant API Secret key"}]," to authorise requests coming from the merchant's backend."]}],"\n",["$","p","p-1",{"children":["It ensures that ensures that each request is authenticated and authorised by verifying the secret key. The secret key should be included in all request headers as a ",["$","code","code-0",{"children":"Bearer"}]," token."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#authentication","target":"_blank","rel":"noreferrer","children":"Authentication"}]]}]}]]}]]}] 17b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The version of the Merchant API, specified in ",["$","code","code-0",{"children":"YYYY-MM-DD"}]," format."]}],"\n",["$","p","p-1",{"children":["This endpoint is available from version ",["$","code","code-0",{"children":"2024-09-01"}],". If a version earlier than ",["$","code","code-1",{"children":"2024-09-01"}]," is provided, the endpoint returns a ",["$","code","code-2",{"children":"404"}]," response."]}],"\n",["$","p","p-2",{"children":"If not specified, you will receive an error."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information about API versioning, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/reference/versioning/api-versions","target":"_blank","rel":"noreferrer","children":"API versions"}],"."]}]}]]}]]}] 17c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A UUID string, typically used to identify resources."}]]}] 17d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The ID of the webhook."}]]}] 1dc:["$","div",null,{"className":"ezz1n30","children":[["$","div",null,{"data-header":"$undefined","className":"ezz1n31","children":["$","div",null,{"className":"y9a0do1","children":[["$","h2",null,{"id":"retrieve-webhook","children":[["$L1e1","$undefined"],["$","$L15",null,{"id":"retrieve-webhook"}]]}],["$","$L16",null,{"url":"/docs/api/merchant/2025-10-16/operations/retrieve-webhook.md"}]]}]}],"$undefined"]}] 1e7:T9d2,
fetch("https://merchant.revolut.com/api/webhooks/__RP_TOK_0__", {
  method: "GET",
  headers: {
    "Authorization": "__RP_TOK_1__",
    "Revolut-Api-Version": "__RP_TOK_2__"
  }
})
  .then(response => response.json())
  .then(data => console.log(data));
1e8:Tf6f,
package main

import (
  "fmt"
  "net/http"
)

func main() {
  url := "https://merchant.revolut.com/api/webhooks/__RP_TOK_0__"
  req, _ := http.NewRequest("GET", url, nil)
  req.Header.Add("Authorization", "__RP_TOK_1__")
  req.Header.Add("Revolut-Api-Version", "__RP_TOK_2__")

  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  fmt.Println(res)
}
1e9:T7e4,
import requests

url = "https://merchant.revolut.com/api/webhooks/__RP_TOK_0__"
headers = {
  "Authorization": "__RP_TOK_1__",
  "Revolut-Api-Version": "__RP_TOK_2__"
}

response = requests.get(url, headers=headers)
print(response.json())
1ea:T1710,
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;

public class Main {
  public static void main(String[] args) {
    HttpClient client = HttpClient.newHttpClient();
    HttpRequest request = HttpRequest.newBuilder()
      .uri(URI.create("https://merchant.revolut.com/api/webhooks/__RP_TOK_0__"))
      .header("Authorization", "__RP_TOK_1__")
      .header("Revolut-Api-Version", "__RP_TOK_2__")
      .GET(HttpRequest.BodyPublishers.noBody())
      .build();

    client.sendAsync(request, HttpResponse.BodyHandlers.ofString())
      .thenApply(HttpResponse::body)
      .thenAccept(System.out::println)
      .join();
  }
}
1eb:T15ba,
using System.Net.Http;
using System.Net.Http.Headers;

var client = new HttpClient();
var request = new HttpRequestMessage
{
  Method = HttpMethod.Get,
  RequestUri = new Uri("https://merchant.revolut.com/api/webhooks/__RP_TOK_0__"),
  Headers =
  {
    { "Authorization", "__RP_TOK_1__" },
    { "Revolut-Api-Version", "__RP_TOK_2__" },
  }
};

using (var response = await client.SendAsync(request))
{
  response.EnsureSuccessStatusCode();
  var body = await response.Content.ReadAsStringAsync();
  Console.WriteLine(body);
}
1ec:T9da,
fetch("https://sandbox-merchant.revolut.com/api/webhooks/__RP_TOK_0__", {
  method: "GET",
  headers: {
    "Authorization": "__RP_TOK_1__",
    "Revolut-Api-Version": "__RP_TOK_2__"
  }
})
  .then(response => response.json())
  .then(data => console.log(data));
1ed:Tf77,
package main

import (
  "fmt"
  "net/http"
)

func main() {
  url := "https://sandbox-merchant.revolut.com/api/webhooks/__RP_TOK_0__"
  req, _ := http.NewRequest("GET", url, nil)
  req.Header.Add("Authorization", "__RP_TOK_1__")
  req.Header.Add("Revolut-Api-Version", "__RP_TOK_2__")

  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  fmt.Println(res)
}
1ee:T7ec,
import requests

url = "https://sandbox-merchant.revolut.com/api/webhooks/__RP_TOK_0__"
headers = {
  "Authorization": "__RP_TOK_1__",
  "Revolut-Api-Version": "__RP_TOK_2__"
}

response = requests.get(url, headers=headers)
print(response.json())
1ef:T1718,
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;

public class Main {
  public static void main(String[] args) {
    HttpClient client = HttpClient.newHttpClient();
    HttpRequest request = HttpRequest.newBuilder()
      .uri(URI.create("https://sandbox-merchant.revolut.com/api/webhooks/__RP_TOK_0__"))
      .header("Authorization", "__RP_TOK_1__")
      .header("Revolut-Api-Version", "__RP_TOK_2__")
      .GET(HttpRequest.BodyPublishers.noBody())
      .build();

    client.sendAsync(request, HttpResponse.BodyHandlers.ofString())
      .thenApply(HttpResponse::body)
      .thenAccept(System.out::println)
      .join();
  }
}
1f0:T15c2,
using System.Net.Http;
using System.Net.Http.Headers;

var client = new HttpClient();
var request = new HttpRequestMessage
{
  Method = HttpMethod.Get,
  RequestUri = new Uri("https://sandbox-merchant.revolut.com/api/webhooks/__RP_TOK_0__"),
  Headers =
  {
    { "Authorization", "__RP_TOK_1__" },
    { "Revolut-Api-Version", "__RP_TOK_2__" },
  }
};

using (var response = await client.SendAsync(request))
{
  response.EnsureSuccessStatusCode();
  var body = await response.Content.ReadAsStringAsync();
  Console.WriteLine(body);
}
1dd:["$","div",null,{"className":"ezz1n30","children":[["$","div",null,{"data-header":"$undefined","className":"ezz1n31","children":["$L1e2",["$","$L85",null,{"parameters":[{"name":"Authorization","in":"header","schema":{"type":"string","format":"Bearer ","examples":"$62:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:0:schema:examples"},"required":true,"description":"This parameter accepts the [Merchant API Secret key](https://business.revolut.com/settings/apis?tab=merchant-api) to authorise requests coming from the merchant's backend. \n\nIt ensures that ensures that each request is authenticated and authorised by verifying the secret key. The secret key should be included in all request headers as a `Bearer` token.\n\n:::info\nFor more information, see: [Authentication](https://developer.revolut.com/docs/api/merchant#authentication)\n:::","descriptionNode":"$L1e3"},{"name":"Revolut-Api-Version","in":"header","schema":{"type":"string","format":"date","enum":"$27:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:1:schema:enum","examples":"$27:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:1:schema:examples"},"required":true,"description":"The version of the Merchant API, specified in `YYYY-MM-DD` format.\n\nThis endpoint is available from version `2024-09-01`. If a version earlier than `2024-09-01` is provided, the endpoint returns a `404` response.\n\nIf not specified, you will receive an error.\n\n\n:::info\nFor more information about API versioning, see: [API versions](https://developer.revolut.com/docs/guides/merchant/reference/versioning/api-versions).\n:::","x-config-always-visible-in-example":true,"example":"2025-10-16","descriptionNode":"$L1e4"},{"name":"webhook_id","in":"path","schema":{"type":"string","format":"uuid","description":"A UUID string, typically used to identify resources.","descriptionNode":"$L1e5"},"required":true,"description":"The ID of the webhook.","descriptionNode":"$L1e6"}],"requestBody":"$undefined","heading":"Request","requestBodySchemaTitle":"Request body","headingAs":"h3"}],["$","$L89",null,{"responses":"$59:props:children:0:props:children:props:responses","headingAs":"h3"}]]}],["$","div",null,{"className":"ezz1n32","children":[[["$","$L8a",null,{"itemsByServer":{"https://merchant.revolut.com":[{"id":"curl","label":"cURL","templateCode":"curl -X GET \"https://merchant.revolut.com/api/webhooks/__RP_TOK_0__\" \\\n -H \"Authorization: __RP_TOK_1__\" \\\n -H \"Revolut-Api-Version: __RP_TOK_2__\"","templateHtml":"
curl -X GET \"https://merchant.revolut.com/api/webhooks/__RP_TOK_0__\" \\\n  -H \"Authorization: __RP_TOK_1__\" \\\n  -H \"Revolut-Api-Version: __RP_TOK_2__\"
","tokens":[{"marker":"__RP_TOK_0__","paramName":"webhook_id","paramIn":"path","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["shell-double-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:webhook_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"javascript","label":"JavaScript","templateCode":"fetch(\"https://merchant.revolut.com/api/webhooks/__RP_TOK_0__\", {\n method: \"GET\",\n headers: {\n \"Authorization\": \"__RP_TOK_1__\",\n \"Revolut-Api-Version\": \"__RP_TOK_2__\"\n }\n})\n .then(response => response.json())\n .then(data => console.log(data));","templateHtml":"$1e7","tokens":[{"marker":"__RP_TOK_0__","paramName":"webhook_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:webhook_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"go","label":"Go","templateCode":"package main\n\nimport (\n \"fmt\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://merchant.revolut.com/api/webhooks/__RP_TOK_0__\"\n req, _ := http.NewRequest(\"GET\", url, nil)\n req.Header.Add(\"Authorization\", \"__RP_TOK_1__\")\n req.Header.Add(\"Revolut-Api-Version\", \"__RP_TOK_2__\")\n\n res, _ := http.DefaultClient.Do(req)\n defer res.Body.Close()\n fmt.Println(res)\n}","templateHtml":"$1e8","tokens":[{"marker":"__RP_TOK_0__","paramName":"webhook_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:webhook_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"python","label":"Python","templateCode":"import requests\n\nurl = \"https://merchant.revolut.com/api/webhooks/__RP_TOK_0__\"\nheaders = {\n \"Authorization\": \"__RP_TOK_1__\",\n \"Revolut-Api-Version\": \"__RP_TOK_2__\"\n}\n\nresponse = requests.get(url, headers=headers)\nprint(response.json())","templateHtml":"$1e9","tokens":[{"marker":"__RP_TOK_0__","paramName":"webhook_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:webhook_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"java","label":"Java","templateCode":"import java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\nimport java.net.URI;\n\npublic class Main {\n public static void main(String[] args) {\n HttpClient client = HttpClient.newHttpClient();\n HttpRequest request = HttpRequest.newBuilder()\n .uri(URI.create(\"https://merchant.revolut.com/api/webhooks/__RP_TOK_0__\"))\n .header(\"Authorization\", \"__RP_TOK_1__\")\n .header(\"Revolut-Api-Version\", \"__RP_TOK_2__\")\n .GET(HttpRequest.BodyPublishers.noBody())\n .build();\n\n client.sendAsync(request, HttpResponse.BodyHandlers.ofString())\n .thenApply(HttpResponse::body)\n .thenAccept(System.out::println)\n .join();\n }\n}","templateHtml":"$1ea","tokens":[{"marker":"__RP_TOK_0__","paramName":"webhook_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:webhook_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"csharp","label":"C#","templateCode":"using System.Net.Http;\nusing System.Net.Http.Headers;\n\nvar client = new HttpClient();\nvar request = new HttpRequestMessage\n{\n Method = HttpMethod.Get,\n RequestUri = new Uri(\"https://merchant.revolut.com/api/webhooks/__RP_TOK_0__\"),\n Headers =\n {\n { \"Authorization\", \"__RP_TOK_1__\" },\n { \"Revolut-Api-Version\", \"__RP_TOK_2__\" },\n }\n};\n\nusing (var response = await client.SendAsync(request))\n{\n response.EnsureSuccessStatusCode();\n var body = await response.Content.ReadAsStringAsync();\n Console.WriteLine(body);\n}","templateHtml":"$1eb","tokens":[{"marker":"__RP_TOK_0__","paramName":"webhook_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:webhook_id":"123e4567-e89b-12d3-a456-426614174000"}}],"https://sandbox-merchant.revolut.com":[{"id":"curl","label":"cURL","templateCode":"curl -X GET \"https://sandbox-merchant.revolut.com/api/webhooks/__RP_TOK_0__\" \\\n -H \"Authorization: __RP_TOK_1__\" \\\n -H \"Revolut-Api-Version: __RP_TOK_2__\"","templateHtml":"
curl -X GET \"https://sandbox-merchant.revolut.com/api/webhooks/__RP_TOK_0__\" \\\n  -H \"Authorization: __RP_TOK_1__\" \\\n  -H \"Revolut-Api-Version: __RP_TOK_2__\"
","tokens":[{"marker":"__RP_TOK_0__","paramName":"webhook_id","paramIn":"path","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["shell-double-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:webhook_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"javascript","label":"JavaScript","templateCode":"fetch(\"https://sandbox-merchant.revolut.com/api/webhooks/__RP_TOK_0__\", {\n method: \"GET\",\n headers: {\n \"Authorization\": \"__RP_TOK_1__\",\n \"Revolut-Api-Version\": \"__RP_TOK_2__\"\n }\n})\n .then(response => response.json())\n .then(data => console.log(data));","templateHtml":"$1ec","tokens":[{"marker":"__RP_TOK_0__","paramName":"webhook_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:webhook_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"go","label":"Go","templateCode":"package main\n\nimport (\n \"fmt\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://sandbox-merchant.revolut.com/api/webhooks/__RP_TOK_0__\"\n req, _ := http.NewRequest(\"GET\", url, nil)\n req.Header.Add(\"Authorization\", \"__RP_TOK_1__\")\n req.Header.Add(\"Revolut-Api-Version\", \"__RP_TOK_2__\")\n\n res, _ := http.DefaultClient.Do(req)\n defer res.Body.Close()\n fmt.Println(res)\n}","templateHtml":"$1ed","tokens":[{"marker":"__RP_TOK_0__","paramName":"webhook_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:webhook_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"python","label":"Python","templateCode":"import requests\n\nurl = \"https://sandbox-merchant.revolut.com/api/webhooks/__RP_TOK_0__\"\nheaders = {\n \"Authorization\": \"__RP_TOK_1__\",\n \"Revolut-Api-Version\": \"__RP_TOK_2__\"\n}\n\nresponse = requests.get(url, headers=headers)\nprint(response.json())","templateHtml":"$1ee","tokens":[{"marker":"__RP_TOK_0__","paramName":"webhook_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:webhook_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"java","label":"Java","templateCode":"import java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\nimport java.net.URI;\n\npublic class Main {\n public static void main(String[] args) {\n HttpClient client = HttpClient.newHttpClient();\n HttpRequest request = HttpRequest.newBuilder()\n .uri(URI.create(\"https://sandbox-merchant.revolut.com/api/webhooks/__RP_TOK_0__\"))\n .header(\"Authorization\", \"__RP_TOK_1__\")\n .header(\"Revolut-Api-Version\", \"__RP_TOK_2__\")\n .GET(HttpRequest.BodyPublishers.noBody())\n .build();\n\n client.sendAsync(request, HttpResponse.BodyHandlers.ofString())\n .thenApply(HttpResponse::body)\n .thenAccept(System.out::println)\n .join();\n }\n}","templateHtml":"$1ef","tokens":[{"marker":"__RP_TOK_0__","paramName":"webhook_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:webhook_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"csharp","label":"C#","templateCode":"using System.Net.Http;\nusing System.Net.Http.Headers;\n\nvar client = new HttpClient();\nvar request = new HttpRequestMessage\n{\n Method = HttpMethod.Get,\n RequestUri = new Uri(\"https://sandbox-merchant.revolut.com/api/webhooks/__RP_TOK_0__\"),\n Headers =\n {\n { \"Authorization\", \"__RP_TOK_1__\" },\n { \"Revolut-Api-Version\", \"__RP_TOK_2__\" },\n }\n};\n\nusing (var response = await client.SendAsync(request))\n{\n response.EnsureSuccessStatusCode();\n var body = await response.Content.ReadAsStringAsync();\n Console.WriteLine(body);\n}","templateHtml":"$1f0","tokens":[{"marker":"__RP_TOK_0__","paramName":"webhook_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:webhook_id":"123e4567-e89b-12d3-a456-426614174000"}}]},"method":"get","servers":"$62:props:children:0:props:children:props:children:1:props:children:1:props:children:0:0:props:servers","path":"/api/webhooks/{webhook_id}","parameters":["$1dd:props:children:0:props:children:1:props:parameters:0","$1dd:props:children:0:props:children:1:props:parameters:1","$1dd:props:children:0:props:children:1:props:parameters:2"]}],"$L1f1"],"$L1f2","$L1f3"]}]]}] 42:["$","$7a","retrieve-payout",{"children":[["$","section",null,{"className":"y9a0do0","data-variant":"endpoint","children":["$","$L7b",null,{"responses":{"200":{"description":"Payout retrieved","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Permanent payout ID used for payouts operations.","descriptionNode":"$L1f4"},"state":{"type":"string","enum":["processing","completed","failed"],"description":"The state of the payout.","descriptionNode":"$L1f5"},"created_at":{"type":"string","format":"date-time","description":"The date and time the payout was created.","descriptionNode":"$L1f6"},"destination_type":{"type":"string","enum":["current_pocket","external_beneficiary"],"description":"The destination of the payout funds when a merchant initiates a withdrawal from their merchant account.\n\n| Destination type | Description |\n| ---------------- | ----------- |\n| `current_pocket` | The funds were moved from the merchant account to the business account within the platform. This indicates an **internal transfer**, allowing the merchant to access the funds within their own business account. |\n| `external_beneficiary` | The funds were transferred to an external bank account or beneficiary outside the platform. This indicates a **transfer to an external account**, enabling the merchant to withdraw funds to external financial institutions. |","descriptionNode":"$L1f7"},"amount":{"type":"integer","minimum":1,"description":"The total amount of the payout in minor currency units. For example, `7034` represents €70.34.","descriptionNode":"$L1f8"},"currency":{"type":"string","format":"ISO 4217","minLength":3,"maxLength":3,"description":"[ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) currency code in upper case.\n\n:::info\nFor more information about the supported currencies, see: [Help Center](https://help.revolut.com/business/help/merchant-accounts/payments/in-which-currencies-can-i-accept-payments/).\n:::","descriptionNode":"$L1f9"}},"required":["id","state","created_at","destination_type"]},"examples":{"default":{"value":{"id":"a830020e-090c-4717-836d-37941a27ad12","state":"completed","created_at":"2024-02-27T00:16:39.079285Z","destination_type":"current_pocket","amount":50000,"currency":"GBP"}}}}},"descriptionNode":"$L1fa"},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"code":{"type":"string","description":"An identifier that can be used to determine what went wrong.\n\nError codes are not globally unique, but uniqueness is guaranteed within endpoints.","descriptionNode":"$L1fb"},"message":{"type":"string","description":"Some human readable text describing what went wrong.","descriptionNode":"$L1fc"},"timestamp":{"type":"integer","description":"The [UNIX timestamp](https://www.unixtimestamp.com/) of the date and time the error happened.","descriptionNode":"$L1fd"}}},"examples":{"default":{"value":{"code":"bad_request","message":"Missing Revolut-Api-Version header","timestamp":1721049596461}}}}},"headers":{},"descriptionNode":"$L1fe"},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"code":{"type":"string","description":"An identifier that can be used to determine what went wrong.\n\nError codes are not globally unique, but uniqueness is guaranteed within endpoints.","descriptionNode":"$L1ff"},"message":{"type":"string","description":"Some human readable text describing what went wrong.","descriptionNode":"$L200"},"timestamp":{"type":"integer","description":"The [UNIX timestamp](https://www.unixtimestamp.com/) of the date and time the error happened.","descriptionNode":"$L201"}}},"examples":{"default":{"value":{"code":"unauthenticated","message":"Authentication failed","timestamp":1721049596461}}}}},"descriptionNode":"$L202"},"404":{"description":"Not Found","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"code":{"type":"string","description":"An identifier that can be used to determine what went wrong.\n\nError codes are not globally unique, but uniqueness is guaranteed within endpoints.","descriptionNode":"$L203"},"message":{"type":"string","description":"Some human readable text describing what went wrong.","descriptionNode":"$L204"},"timestamp":{"type":"integer","description":"The [UNIX timestamp](https://www.unixtimestamp.com/) of the date and time the error happened.","descriptionNode":"$L205"}}},"examples":{"default":{"value":{"code":"not_found","message":"The requested resource is not found","timestamp":1721050063886}}}}},"descriptionNode":"$L206"}},"requestBody":"$undefined","variantLabels":[],"children":["$L207","$L208"]}]}],false]}] 18b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Each Merchant API request must contain an authorization header in the following format:"}],"\n","$L209","\n",["$","p","p-1",{"children":"To use this API, you need to generate API keys from your Revolut Business account. The Secret key is used in the authorization header for all server calls, while the Public key is provided with payment methods at checkout."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For detailed instructions on generating your API keys, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/get-started#generate-api-keys","target":"_blank","rel":"noreferrer","children":"Generate API keys"}],"."]}]}]]}]]}] 18e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Each Merchant API request must contain an authorization header in the following format:"}],"\n","$L20a","\n",["$","p","p-1",{"children":"To use this API, you need to generate API keys from your Revolut Business account. The Secret key is used in the authorization header for all server calls, while the Public key is provided with payment methods at checkout."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For detailed instructions on generating your API keys, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/get-started#generate-api-keys","target":"_blank","rel":"noreferrer","children":"Generate API keys"}],"."]}]}]]}]]}] 193:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Each Merchant API request must contain an authorization header in the following format:"}],"\n","$L20b","\n",["$","p","p-1",{"children":"To use this API, you need to generate API keys from your Revolut Business account. The Secret key is used in the authorization header for all server calls, while the Public key is provided with payment methods at checkout."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For detailed instructions on generating your API keys, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/get-started#generate-api-keys","target":"_blank","rel":"noreferrer","children":"Generate API keys"}],"."]}]}]]}]]}] 19a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Marks a specific dispute as accepted."}],"\n",["$","p","p-1",{"children":"After accepting a dispute, you cannot challenge it."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["This endpoint is only available in ",["$","strong","strong-0",{"children":"Production"}]," environment."]}]}]]}]]}] 19b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["This parameter accepts the ",["$","a","a-0",{"href":"https://business.revolut.com/settings/apis?tab=merchant-api","target":"_blank","rel":"noreferrer","children":"Merchant API Secret key"}]," to authorise requests coming from the merchant's backend."]}],"\n",["$","p","p-1",{"children":["It ensures that ensures that each request is authenticated and authorised by verifying the secret key. The secret key should be included in all request headers as a ",["$","code","code-0",{"children":"Bearer"}]," token."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#authentication","target":"_blank","rel":"noreferrer","children":"Authentication"}]]}]}]]}]]}] 19c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The version of the Merchant API, specified in ",["$","code","code-0",{"children":"YYYY-MM-DD"}]," format."]}],"\n",["$","p","p-1",{"children":"If not specified, you will receive an error."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information about API versioning, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/reference/versioning/api-versions","target":"_blank","rel":"noreferrer","children":"API versions"}],"."]}]}]]}]]}] 19d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A UUID string, typically used to identify resources."}]]}] 19e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ID of the ",["$","code","code-0",{"children":"Dispute"}]," object."]}]]}] 16b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://www.unixtimestamp.com/","target":"_blank","rel":"noreferrer","children":"UNIX timestamp"}]," of the date and time the error happened."]}]]}] 16c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Not Found"}]]}] 1ad:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["Retrieve details of a report run, based on the ",["$","code","code-0",{"children":"report_run_id"}],"."]}],"\n",["$","p","p-1",{"children":"Use this method to check the status of a report run."}],"\n",["$","p","p-2",{"children":["If a report run's ",["$","code","code-0",{"children":"status"}]," is ",["$","code","code-1",{"children":"completed"}],", the report file can be downloaded using the ",["$","code","code-2",{"children":"file_url"}]," for 24 hours after report generation finishes."]}],"\n",["$","p","p-3",{"children":["Once that 24-hour window elapses, the report run remains retrievable but transitions to ",["$","code","code-0",{"children":"expired"}],", and the file can no longer be downloaded."]}]]}] 1ae:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["This parameter accepts the ",["$","a","a-0",{"href":"https://business.revolut.com/settings/apis?tab=merchant-api","target":"_blank","rel":"noreferrer","children":"Merchant API Secret key"}]," to authorise requests coming from the merchant's backend."]}],"\n",["$","p","p-1",{"children":["It ensures that ensures that each request is authenticated and authorised by verifying the secret key. The secret key should be included in all request headers as a ",["$","code","code-0",{"children":"Bearer"}]," token."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#authentication","target":"_blank","rel":"noreferrer","children":"Authentication"}]]}]}]]}]]}] 1af:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A UUID string, typically used to identify resources."}]]}] 1b0:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unique ID of the report run."}]]}] 1be:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Each Merchant API request must contain an authorization header in the following format:"}],"\n","$L20c","\n",["$","p","p-1",{"children":"To use this API, you need to generate API keys from your Revolut Business account. The Secret key is used in the authorization header for all server calls, while the Public key is provided with payment methods at checkout."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For detailed instructions on generating your API keys, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/get-started#generate-api-keys","target":"_blank","rel":"noreferrer","children":"Generate API keys"}],"."]}]}]]}]]}] 1f1:["$","$L10d",null,{"security":[{"Api-Key":[]}],"authorization":{"Api-Key":{"type":"apiKey","in":"header","name":"Authorization","description":"Each Merchant API request must contain an authorization header in the following format:\n\n```\n'Authorization: Bearer '\n```\n\nTo use this API, you need to generate API keys from your Revolut Business account. The Secret key is used in the authorization header for all server calls, while the Public key is provided with payment methods at checkout.\n\n:::info\nFor detailed instructions on generating your API keys, see: [Generate API keys](https://developer.revolut.com/docs/guides/merchant/get-started#generate-api-keys).\n:::","descriptionNode":"$L20d"}}}] 1f2:["$","$L10f",null,{"exampleBlocks":{},"title":"Request body samples","headingAs":"h4"}] 1f3:["$","$L110",null,{"exampleBlocks":{"200":{"application/json":{"variants":[{"key":"retrieved_webhook","label":"Webhook","rawValue":"$59:props:children:0:props:children:props:responses:200:content:application/json:examples:retrieved_webhook:value","block":"$L20e"}],"syncedPropertyName":"$undefined"}},"401":{"application/json":{"variants":[{"key":"default","label":"Example","rawValue":{"errorId":"string","timestamp":123},"block":"$L20f"}],"syncedPropertyName":"$undefined"}},"404":{"application/json":{"variants":[{"key":"default","label":"Example","rawValue":{"errorId":"string","timestamp":123},"block":"$L210"}],"syncedPropertyName":"$undefined"}}},"headingAs":"h4"}] 207:["$","div",null,{"className":"ezz1n30","children":[["$","div",null,{"data-header":"$undefined","className":"ezz1n31","children":["$","div",null,{"className":"y9a0do1","children":[["$","h2",null,{"id":"retrieve-payout","children":[["$L211","$undefined"],["$","$L15",null,{"id":"retrieve-payout"}]]}],["$","$L16",null,{"url":"/docs/api/merchant/2025-10-16/operations/retrieve-payout.md"}]]}]}],"$undefined"]}] 217:T9d1,
fetch("https://merchant.revolut.com/api/payouts/__RP_TOK_0__", {
  method: "GET",
  headers: {
    "Authorization": "__RP_TOK_1__",
    "Revolut-Api-Version": "__RP_TOK_2__"
  }
})
  .then(response => response.json())
  .then(data => console.log(data));
218:Tf6e,
package main

import (
  "fmt"
  "net/http"
)

func main() {
  url := "https://merchant.revolut.com/api/payouts/__RP_TOK_0__"
  req, _ := http.NewRequest("GET", url, nil)
  req.Header.Add("Authorization", "__RP_TOK_1__")
  req.Header.Add("Revolut-Api-Version", "__RP_TOK_2__")

  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  fmt.Println(res)
}
219:T7e3,
import requests

url = "https://merchant.revolut.com/api/payouts/__RP_TOK_0__"
headers = {
  "Authorization": "__RP_TOK_1__",
  "Revolut-Api-Version": "__RP_TOK_2__"
}

response = requests.get(url, headers=headers)
print(response.json())
21a:T170f,
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;

public class Main {
  public static void main(String[] args) {
    HttpClient client = HttpClient.newHttpClient();
    HttpRequest request = HttpRequest.newBuilder()
      .uri(URI.create("https://merchant.revolut.com/api/payouts/__RP_TOK_0__"))
      .header("Authorization", "__RP_TOK_1__")
      .header("Revolut-Api-Version", "__RP_TOK_2__")
      .GET(HttpRequest.BodyPublishers.noBody())
      .build();

    client.sendAsync(request, HttpResponse.BodyHandlers.ofString())
      .thenApply(HttpResponse::body)
      .thenAccept(System.out::println)
      .join();
  }
}
21b:T15b9,
using System.Net.Http;
using System.Net.Http.Headers;

var client = new HttpClient();
var request = new HttpRequestMessage
{
  Method = HttpMethod.Get,
  RequestUri = new Uri("https://merchant.revolut.com/api/payouts/__RP_TOK_0__"),
  Headers =
  {
    { "Authorization", "__RP_TOK_1__" },
    { "Revolut-Api-Version", "__RP_TOK_2__" },
  }
};

using (var response = await client.SendAsync(request))
{
  response.EnsureSuccessStatusCode();
  var body = await response.Content.ReadAsStringAsync();
  Console.WriteLine(body);
}
21c:T9d9,
fetch("https://sandbox-merchant.revolut.com/api/payouts/__RP_TOK_0__", {
  method: "GET",
  headers: {
    "Authorization": "__RP_TOK_1__",
    "Revolut-Api-Version": "__RP_TOK_2__"
  }
})
  .then(response => response.json())
  .then(data => console.log(data));
21d:Tf76,
package main

import (
  "fmt"
  "net/http"
)

func main() {
  url := "https://sandbox-merchant.revolut.com/api/payouts/__RP_TOK_0__"
  req, _ := http.NewRequest("GET", url, nil)
  req.Header.Add("Authorization", "__RP_TOK_1__")
  req.Header.Add("Revolut-Api-Version", "__RP_TOK_2__")

  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  fmt.Println(res)
}
21e:T7eb,
import requests

url = "https://sandbox-merchant.revolut.com/api/payouts/__RP_TOK_0__"
headers = {
  "Authorization": "__RP_TOK_1__",
  "Revolut-Api-Version": "__RP_TOK_2__"
}

response = requests.get(url, headers=headers)
print(response.json())
21f:T1717,
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;

public class Main {
  public static void main(String[] args) {
    HttpClient client = HttpClient.newHttpClient();
    HttpRequest request = HttpRequest.newBuilder()
      .uri(URI.create("https://sandbox-merchant.revolut.com/api/payouts/__RP_TOK_0__"))
      .header("Authorization", "__RP_TOK_1__")
      .header("Revolut-Api-Version", "__RP_TOK_2__")
      .GET(HttpRequest.BodyPublishers.noBody())
      .build();

    client.sendAsync(request, HttpResponse.BodyHandlers.ofString())
      .thenApply(HttpResponse::body)
      .thenAccept(System.out::println)
      .join();
  }
}
220:T15c1,
using System.Net.Http;
using System.Net.Http.Headers;

var client = new HttpClient();
var request = new HttpRequestMessage
{
  Method = HttpMethod.Get,
  RequestUri = new Uri("https://sandbox-merchant.revolut.com/api/payouts/__RP_TOK_0__"),
  Headers =
  {
    { "Authorization", "__RP_TOK_1__" },
    { "Revolut-Api-Version", "__RP_TOK_2__" },
  }
};

using (var response = await client.SendAsync(request))
{
  response.EnsureSuccessStatusCode();
  var body = await response.Content.ReadAsStringAsync();
  Console.WriteLine(body);
}
208:["$","div",null,{"className":"ezz1n30","children":[["$","div",null,{"data-header":"$undefined","className":"ezz1n31","children":["$L212",["$","$L85",null,{"parameters":[{"name":"Authorization","in":"header","schema":{"type":"string","format":"Bearer ","examples":"$62:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:0:schema:examples"},"required":true,"description":"This parameter accepts the [Merchant API Secret key](https://business.revolut.com/settings/apis?tab=merchant-api) to authorise requests coming from the merchant's backend. \n\nIt ensures that ensures that each request is authenticated and authorised by verifying the secret key. The secret key should be included in all request headers as a `Bearer` token.\n\n:::info\nFor more information, see: [Authentication](https://developer.revolut.com/docs/api/merchant#authentication)\n:::","descriptionNode":"$L213"},{"name":"Revolut-Api-Version","in":"header","schema":{"type":"string","format":"date","enum":"$36:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:1:schema:enum","examples":"$36:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:1:schema:examples"},"required":true,"description":"The version of the Merchant API, specified in `YYYY-MM-DD` format.\n\nIf not specified, you will receive an error.\n\n\n:::info\nFor more information about API versioning, see: [API versions](https://developer.revolut.com/docs/guides/merchant/reference/versioning/api-versions).\n:::","x-config-always-visible-in-example":true,"example":"2025-10-16","descriptionNode":"$L214"},{"name":"payout_id","in":"path","schema":{"type":"string","format":"uuid","description":"A UUID string, typically used to identify resources.","descriptionNode":"$L215"},"required":true,"description":"The ID of the `Payout` object.","descriptionNode":"$L216"}],"requestBody":"$undefined","heading":"Request","requestBodySchemaTitle":"Request body","headingAs":"h3"}],["$","$L89",null,{"responses":"$42:props:children:0:props:children:props:responses","headingAs":"h3"}]]}],["$","div",null,{"className":"ezz1n32","children":[[["$","$L8a",null,{"itemsByServer":{"https://merchant.revolut.com":[{"id":"curl","label":"cURL","templateCode":"curl -X GET \"https://merchant.revolut.com/api/payouts/__RP_TOK_0__\" \\\n -H \"Authorization: __RP_TOK_1__\" \\\n -H \"Revolut-Api-Version: __RP_TOK_2__\"","templateHtml":"
curl -X GET \"https://merchant.revolut.com/api/payouts/__RP_TOK_0__\" \\\n  -H \"Authorization: __RP_TOK_1__\" \\\n  -H \"Revolut-Api-Version: __RP_TOK_2__\"
","tokens":[{"marker":"__RP_TOK_0__","paramName":"payout_id","paramIn":"path","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["shell-double-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:payout_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"javascript","label":"JavaScript","templateCode":"fetch(\"https://merchant.revolut.com/api/payouts/__RP_TOK_0__\", {\n method: \"GET\",\n headers: {\n \"Authorization\": \"__RP_TOK_1__\",\n \"Revolut-Api-Version\": \"__RP_TOK_2__\"\n }\n})\n .then(response => response.json())\n .then(data => console.log(data));","templateHtml":"$217","tokens":[{"marker":"__RP_TOK_0__","paramName":"payout_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:payout_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"go","label":"Go","templateCode":"package main\n\nimport (\n \"fmt\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://merchant.revolut.com/api/payouts/__RP_TOK_0__\"\n req, _ := http.NewRequest(\"GET\", url, nil)\n req.Header.Add(\"Authorization\", \"__RP_TOK_1__\")\n req.Header.Add(\"Revolut-Api-Version\", \"__RP_TOK_2__\")\n\n res, _ := http.DefaultClient.Do(req)\n defer res.Body.Close()\n fmt.Println(res)\n}","templateHtml":"$218","tokens":[{"marker":"__RP_TOK_0__","paramName":"payout_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:payout_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"python","label":"Python","templateCode":"import requests\n\nurl = \"https://merchant.revolut.com/api/payouts/__RP_TOK_0__\"\nheaders = {\n \"Authorization\": \"__RP_TOK_1__\",\n \"Revolut-Api-Version\": \"__RP_TOK_2__\"\n}\n\nresponse = requests.get(url, headers=headers)\nprint(response.json())","templateHtml":"$219","tokens":[{"marker":"__RP_TOK_0__","paramName":"payout_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:payout_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"java","label":"Java","templateCode":"import java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\nimport java.net.URI;\n\npublic class Main {\n public static void main(String[] args) {\n HttpClient client = HttpClient.newHttpClient();\n HttpRequest request = HttpRequest.newBuilder()\n .uri(URI.create(\"https://merchant.revolut.com/api/payouts/__RP_TOK_0__\"))\n .header(\"Authorization\", \"__RP_TOK_1__\")\n .header(\"Revolut-Api-Version\", \"__RP_TOK_2__\")\n .GET(HttpRequest.BodyPublishers.noBody())\n .build();\n\n client.sendAsync(request, HttpResponse.BodyHandlers.ofString())\n .thenApply(HttpResponse::body)\n .thenAccept(System.out::println)\n .join();\n }\n}","templateHtml":"$21a","tokens":[{"marker":"__RP_TOK_0__","paramName":"payout_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:payout_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"csharp","label":"C#","templateCode":"using System.Net.Http;\nusing System.Net.Http.Headers;\n\nvar client = new HttpClient();\nvar request = new HttpRequestMessage\n{\n Method = HttpMethod.Get,\n RequestUri = new Uri(\"https://merchant.revolut.com/api/payouts/__RP_TOK_0__\"),\n Headers =\n {\n { \"Authorization\", \"__RP_TOK_1__\" },\n { \"Revolut-Api-Version\", \"__RP_TOK_2__\" },\n }\n};\n\nusing (var response = await client.SendAsync(request))\n{\n response.EnsureSuccessStatusCode();\n var body = await response.Content.ReadAsStringAsync();\n Console.WriteLine(body);\n}","templateHtml":"$21b","tokens":[{"marker":"__RP_TOK_0__","paramName":"payout_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:payout_id":"123e4567-e89b-12d3-a456-426614174000"}}],"https://sandbox-merchant.revolut.com":[{"id":"curl","label":"cURL","templateCode":"curl -X GET \"https://sandbox-merchant.revolut.com/api/payouts/__RP_TOK_0__\" \\\n -H \"Authorization: __RP_TOK_1__\" \\\n -H \"Revolut-Api-Version: __RP_TOK_2__\"","templateHtml":"
curl -X GET \"https://sandbox-merchant.revolut.com/api/payouts/__RP_TOK_0__\" \\\n  -H \"Authorization: __RP_TOK_1__\" \\\n  -H \"Revolut-Api-Version: __RP_TOK_2__\"
","tokens":[{"marker":"__RP_TOK_0__","paramName":"payout_id","paramIn":"path","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["shell-double-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:payout_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"javascript","label":"JavaScript","templateCode":"fetch(\"https://sandbox-merchant.revolut.com/api/payouts/__RP_TOK_0__\", {\n method: \"GET\",\n headers: {\n \"Authorization\": \"__RP_TOK_1__\",\n \"Revolut-Api-Version\": \"__RP_TOK_2__\"\n }\n})\n .then(response => response.json())\n .then(data => console.log(data));","templateHtml":"$21c","tokens":[{"marker":"__RP_TOK_0__","paramName":"payout_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:payout_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"go","label":"Go","templateCode":"package main\n\nimport (\n \"fmt\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://sandbox-merchant.revolut.com/api/payouts/__RP_TOK_0__\"\n req, _ := http.NewRequest(\"GET\", url, nil)\n req.Header.Add(\"Authorization\", \"__RP_TOK_1__\")\n req.Header.Add(\"Revolut-Api-Version\", \"__RP_TOK_2__\")\n\n res, _ := http.DefaultClient.Do(req)\n defer res.Body.Close()\n fmt.Println(res)\n}","templateHtml":"$21d","tokens":[{"marker":"__RP_TOK_0__","paramName":"payout_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:payout_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"python","label":"Python","templateCode":"import requests\n\nurl = \"https://sandbox-merchant.revolut.com/api/payouts/__RP_TOK_0__\"\nheaders = {\n \"Authorization\": \"__RP_TOK_1__\",\n \"Revolut-Api-Version\": \"__RP_TOK_2__\"\n}\n\nresponse = requests.get(url, headers=headers)\nprint(response.json())","templateHtml":"$21e","tokens":[{"marker":"__RP_TOK_0__","paramName":"payout_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:payout_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"java","label":"Java","templateCode":"import java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\nimport java.net.URI;\n\npublic class Main {\n public static void main(String[] args) {\n HttpClient client = HttpClient.newHttpClient();\n HttpRequest request = HttpRequest.newBuilder()\n .uri(URI.create(\"https://sandbox-merchant.revolut.com/api/payouts/__RP_TOK_0__\"))\n .header(\"Authorization\", \"__RP_TOK_1__\")\n .header(\"Revolut-Api-Version\", \"__RP_TOK_2__\")\n .GET(HttpRequest.BodyPublishers.noBody())\n .build();\n\n client.sendAsync(request, HttpResponse.BodyHandlers.ofString())\n .thenApply(HttpResponse::body)\n .thenAccept(System.out::println)\n .join();\n }\n}","templateHtml":"$21f","tokens":[{"marker":"__RP_TOK_0__","paramName":"payout_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:payout_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"csharp","label":"C#","templateCode":"using System.Net.Http;\nusing System.Net.Http.Headers;\n\nvar client = new HttpClient();\nvar request = new HttpRequestMessage\n{\n Method = HttpMethod.Get,\n RequestUri = new Uri(\"https://sandbox-merchant.revolut.com/api/payouts/__RP_TOK_0__\"),\n Headers =\n {\n { \"Authorization\", \"__RP_TOK_1__\" },\n { \"Revolut-Api-Version\", \"__RP_TOK_2__\" },\n }\n};\n\nusing (var response = await client.SendAsync(request))\n{\n response.EnsureSuccessStatusCode();\n var body = await response.Content.ReadAsStringAsync();\n Console.WriteLine(body);\n}","templateHtml":"$220","tokens":[{"marker":"__RP_TOK_0__","paramName":"payout_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:payout_id":"123e4567-e89b-12d3-a456-426614174000"}}]},"method":"get","servers":"$62:props:children:0:props:children:props:children:1:props:children:1:props:children:0:0:props:servers","path":"/api/payouts/{payout_id}","parameters":["$208:props:children:0:props:children:1:props:parameters:0","$208:props:children:0:props:children:1:props:parameters:1","$208:props:children:0:props:children:1:props:parameters:2"]}],"$L221"],"$L222","$L223"]}]]}] 1c1:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Each Merchant API request must contain an authorization header in the following format:"}],"\n","$L224","\n",["$","p","p-1",{"children":"To use this API, you need to generate API keys from your Revolut Business account. The Secret key is used in the authorization header for all server calls, while the Public key is provided with payment methods at checkout."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For detailed instructions on generating your API keys, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/get-started#generate-api-keys","target":"_blank","rel":"noreferrer","children":"Generate API keys"}],"."]}]}]]}]]}] 1c7:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Each Merchant API request must contain an authorization header in the following format:"}],"\n","$L225","\n",["$","p","p-1",{"children":"To use this API, you need to generate API keys from your Revolut Business account. The Secret key is used in the authorization header for all server calls, while the Public key is provided with payment methods at checkout."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For detailed instructions on generating your API keys, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/get-started#generate-api-keys","target":"_blank","rel":"noreferrer","children":"Generate API keys"}],"."]}]}]]}]]}] 221:["$","$L10d",null,{"security":[{"Api-Key":[]}],"authorization":{"Api-Key":{"type":"apiKey","in":"header","name":"Authorization","description":"Each Merchant API request must contain an authorization header in the following format:\n\n```\n'Authorization: Bearer '\n```\n\nTo use this API, you need to generate API keys from your Revolut Business account. The Secret key is used in the authorization header for all server calls, while the Public key is provided with payment methods at checkout.\n\n:::info\nFor detailed instructions on generating your API keys, see: [Generate API keys](https://developer.revolut.com/docs/guides/merchant/get-started#generate-api-keys).\n:::","descriptionNode":"$L226"}}}] 222:["$","$L10f",null,{"exampleBlocks":{},"title":"Request body samples","headingAs":"h4"}] 223:["$","$L110",null,{"exampleBlocks":{"200":{"application/json":{"variants":[{"key":"default","label":"default","rawValue":"$42:props:children:0:props:children:props:responses:200:content:application/json:examples:default:value","block":"$L227"}],"syncedPropertyName":"$undefined"}},"400":{"application/json":{"variants":[{"key":"default","label":"default","rawValue":"$42:props:children:0:props:children:props:responses:400:content:application/json:examples:default:value","block":"$L228"}],"syncedPropertyName":"$undefined"}},"401":{"application/json":{"variants":[{"key":"default","label":"default","rawValue":"$42:props:children:0:props:children:props:responses:401:content:application/json:examples:default:value","block":"$L229"}],"syncedPropertyName":"$undefined"}},"404":{"application/json":{"variants":[{"key":"default","label":"default","rawValue":"$42:props:children:0:props:children:props:responses:404:content:application/json:examples:default:value","block":"$L22a"}],"syncedPropertyName":"$undefined"}}},"headingAs":"h4"}] 233:T554,
curl -X POST "https://merchant.revolut.com/api/apple-pay/domains/register" \
  -H "Content-Type: application/json" \
  -H "Authorization: __RP_TOK_0__" \
  -d '{
  "domain": "revolut.com"
}'
234:Td65,
const payload = {
  "domain": "revolut.com"
};
fetch("https://merchant.revolut.com/api/apple-pay/domains/register", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "__RP_TOK_0__"
  },
  body: JSON.stringify(payload)
})
  .then(response => response.json())
  .then(data => console.log(data));
235:T144c,
package main

import (
  "fmt"
  "net/http"
  "bytes"
  "encoding/json"
)

func main() {
  url := "https://merchant.revolut.com/api/apple-pay/domains/register"
  jsonData := []byte(`
{
  "domain": "revolut.com"
}
  `)
  req, _ := http.NewRequest("POST", url, bytes.NewBuffer(jsonData))
  req.Header.Add("Content-Type", "application/json")
  req.Header.Add("Authorization", "__RP_TOK_0__")

  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  fmt.Println(res)
}
236:Ta9b,
import requests

url = "https://merchant.revolut.com/api/apple-pay/domains/register"
headers = {
  "Content-Type": "application/json",
  "Authorization": "__RP_TOK_0__"
}
payload = {
  "domain": "revolut.com"
}

response = requests.post(url, headers=headers, json=payload)
print(response.json())
237:T19b3,
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;

public class Main {
  public static void main(String[] args) {
    HttpClient client = HttpClient.newHttpClient();
    String body = """
{
  "domain": "revolut.com"
}
    """;

    HttpRequest request = HttpRequest.newBuilder()
      .uri(URI.create("https://merchant.revolut.com/api/apple-pay/domains/register"))
      .header("Content-Type", "application/json")
      .header("Authorization", "__RP_TOK_0__")
      .POST(HttpRequest.BodyPublishers.ofString(body))
      .build();

    client.sendAsync(request, HttpResponse.BodyHandlers.ofString())
      .thenApply(HttpResponse::body)
      .thenAccept(System.out::println)
      .join();
  }
}
238:T1c11,
using System.Net.Http;
using System.Net.Http.Headers;

var client = new HttpClient();
var request = new HttpRequestMessage
{
  Method = HttpMethod.Post,
  RequestUri = new Uri("https://merchant.revolut.com/api/apple-pay/domains/register"),
  Headers =
  {
    { "Authorization", "__RP_TOK_0__" },
  },
  Content = new StringContent(@"{
  ""domain"": ""revolut.com""
}")
  {
    Headers =
    {
      ContentType = new MediaTypeHeaderValue("application/json")
    }
  }
};

using (var response = await client.SendAsync(request))
{
  response.EnsureSuccessStatusCode();
  var body = await response.Content.ReadAsStringAsync();
  Console.WriteLine(body);
}
239:T55c,
curl -X POST "https://sandbox-merchant.revolut.com/api/apple-pay/domains/register" \
  -H "Content-Type: application/json" \
  -H "Authorization: __RP_TOK_0__" \
  -d '{
  "domain": "revolut.com"
}'
23a:Td6d,
const payload = {
  "domain": "revolut.com"
};
fetch("https://sandbox-merchant.revolut.com/api/apple-pay/domains/register", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "__RP_TOK_0__"
  },
  body: JSON.stringify(payload)
})
  .then(response => response.json())
  .then(data => console.log(data));
23b:T1454,
package main

import (
  "fmt"
  "net/http"
  "bytes"
  "encoding/json"
)

func main() {
  url := "https://sandbox-merchant.revolut.com/api/apple-pay/domains/register"
  jsonData := []byte(`
{
  "domain": "revolut.com"
}
  `)
  req, _ := http.NewRequest("POST", url, bytes.NewBuffer(jsonData))
  req.Header.Add("Content-Type", "application/json")
  req.Header.Add("Authorization", "__RP_TOK_0__")

  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  fmt.Println(res)
}
23c:Taa3,
import requests

url = "https://sandbox-merchant.revolut.com/api/apple-pay/domains/register"
headers = {
  "Content-Type": "application/json",
  "Authorization": "__RP_TOK_0__"
}
payload = {
  "domain": "revolut.com"
}

response = requests.post(url, headers=headers, json=payload)
print(response.json())
23d:T19bb,
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;

public class Main {
  public static void main(String[] args) {
    HttpClient client = HttpClient.newHttpClient();
    String body = """
{
  "domain": "revolut.com"
}
    """;

    HttpRequest request = HttpRequest.newBuilder()
      .uri(URI.create("https://sandbox-merchant.revolut.com/api/apple-pay/domains/register"))
      .header("Content-Type", "application/json")
      .header("Authorization", "__RP_TOK_0__")
      .POST(HttpRequest.BodyPublishers.ofString(body))
      .build();

    client.sendAsync(request, HttpResponse.BodyHandlers.ofString())
      .thenApply(HttpResponse::body)
      .thenAccept(System.out::println)
      .join();
  }
}
23e:T1c19,
using System.Net.Http;
using System.Net.Http.Headers;

var client = new HttpClient();
var request = new HttpRequestMessage
{
  Method = HttpMethod.Post,
  RequestUri = new Uri("https://sandbox-merchant.revolut.com/api/apple-pay/domains/register"),
  Headers =
  {
    { "Authorization", "__RP_TOK_0__" },
  },
  Content = new StringContent(@"{
  ""domain"": ""revolut.com""
}")
  {
    Headers =
    {
      ContentType = new MediaTypeHeaderValue("application/json")
    }
  }
};

using (var response = await client.SendAsync(request))
{
  response.EnsureSuccessStatusCode();
  var body = await response.Content.ReadAsStringAsync();
  Console.WriteLine(body);
}
6a:["$","$7a","register-domain-apple-pay",{"children":[["$","section",null,{"className":"y9a0do0","data-variant":"endpoint","children":["$","$L7b",null,{"responses":{"204":{"description":"Domain registered successfully","descriptionNode":"$L22b"},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"An identifier that can be used to determine what went wrong.\n\nError codes are not globally unique, but uniqueness is guaranteed within endpoints.","descriptionNode":"$L22c"},"message":{"type":"string","description":"Human readable text describing what went wrong.","descriptionNode":"$L22d"}},"required":["code"]},"examples":{"error_message":{"summary":"Error message","value":{"code":"validation","message":"Exactly one value must be supplied for client_id"}}}}},"descriptionNode":"$L22e"}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"domain":{"type":"string","description":"Domain name of your website without the scheme (i.e. without `http://` or `https://`).","examples":["revolut.com"],"descriptionNode":"$L22f"}},"required":["domain"]},"examples":{"example_request":{"summary":"Example domain registration request for Apple Pay","value":{"domain":"revolut.com"}}}}}},"variantLabels":[],"children":[["$","div",null,{"className":"ezz1n30","children":[["$","div",null,{"data-header":"$undefined","className":"ezz1n31","children":["$","div",null,{"className":"y9a0do1","children":[["$","h2",null,{"id":"register-domain-apple-pay","children":[["$L230","$undefined"],["$","$L15",null,{"id":"register-domain-apple-pay"}]]}],["$","$L16",null,{"url":"/docs/api/merchant/2025-10-16/operations/register-domain-apple-pay.md"}]]}]}],"$undefined"]}],["$","div",null,{"className":"ezz1n30","children":[["$","div",null,{"data-header":"$undefined","className":"ezz1n31","children":["$L231",["$","$L85",null,{"parameters":[{"name":"Authorization","in":"header","schema":{"type":"string","format":"Bearer ","examples":"$62:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:0:schema:examples"},"required":true,"description":"This parameter accepts the [Merchant API Secret key](https://business.revolut.com/settings/apis?tab=merchant-api) to authorise requests coming from the merchant's backend. \n\nIt ensures that ensures that each request is authenticated and authorised by verifying the secret key. The secret key should be included in all request headers as a `Bearer` token.\n\n:::info\nFor more information, see: [Authentication](https://developer.revolut.com/docs/api/merchant#authentication)\n:::","descriptionNode":"$L232"}],"requestBody":"$6a:props:children:0:props:children:props:requestBody","heading":"Request","requestBodySchemaTitle":"Request body","headingAs":"h3"}],["$","$L89",null,{"responses":"$6a:props:children:0:props:children:props:responses","headingAs":"h3"}]]}],["$","div",null,{"className":"ezz1n32","children":[[["$","$L8a",null,{"itemsByServer":{"https://merchant.revolut.com":[{"id":"curl","label":"cURL","templateCode":"curl -X POST \"https://merchant.revolut.com/api/apple-pay/domains/register\" \\\n -H \"Content-Type: application/json\" \\\n -H \"Authorization: __RP_TOK_0__\" \\\n -d '{\n \"domain\": \"revolut.com\"\n}'","templateHtml":"$233","tokens":[{"marker":"__RP_TOK_0__","paramName":"Authorization","paramIn":"header","pipeline":["shell-double-inner"]}],"defaults":{"header:Authorization":"Bearer "}},{"id":"javascript","label":"JavaScript","templateCode":"const payload = {\n \"domain\": \"revolut.com\"\n};\nfetch(\"https://merchant.revolut.com/api/apple-pay/domains/register\", {\n method: \"POST\",\n headers: {\n \"Content-Type\": \"application/json\",\n \"Authorization\": \"__RP_TOK_0__\"\n },\n body: JSON.stringify(payload)\n})\n .then(response => response.json())\n .then(data => console.log(data));","templateHtml":"$234","tokens":[{"marker":"__RP_TOK_0__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer "}},{"id":"go","label":"Go","templateCode":"package main\n\nimport (\n \"fmt\"\n \"net/http\"\n \"bytes\"\n \"encoding/json\"\n)\n\nfunc main() {\n url := \"https://merchant.revolut.com/api/apple-pay/domains/register\"\n jsonData := []byte(`\n{\n \"domain\": \"revolut.com\"\n}\n `)\n req, _ := http.NewRequest(\"POST\", url, bytes.NewBuffer(jsonData))\n req.Header.Add(\"Content-Type\", \"application/json\")\n req.Header.Add(\"Authorization\", \"__RP_TOK_0__\")\n\n res, _ := http.DefaultClient.Do(req)\n defer res.Body.Close()\n fmt.Println(res)\n}","templateHtml":"$235","tokens":[{"marker":"__RP_TOK_0__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer "}},{"id":"python","label":"Python","templateCode":"import requests\n\nurl = \"https://merchant.revolut.com/api/apple-pay/domains/register\"\nheaders = {\n \"Content-Type\": \"application/json\",\n \"Authorization\": \"__RP_TOK_0__\"\n}\npayload = {\n \"domain\": \"revolut.com\"\n}\n\nresponse = requests.post(url, headers=headers, json=payload)\nprint(response.json())","templateHtml":"$236","tokens":[{"marker":"__RP_TOK_0__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer "}},{"id":"java","label":"Java","templateCode":"import java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\nimport java.net.URI;\n\npublic class Main {\n public static void main(String[] args) {\n HttpClient client = HttpClient.newHttpClient();\n String body = \"\"\"\n{\n \"domain\": \"revolut.com\"\n}\n \"\"\";\n\n HttpRequest request = HttpRequest.newBuilder()\n .uri(URI.create(\"https://merchant.revolut.com/api/apple-pay/domains/register\"))\n .header(\"Content-Type\", \"application/json\")\n .header(\"Authorization\", \"__RP_TOK_0__\")\n .POST(HttpRequest.BodyPublishers.ofString(body))\n .build();\n\n client.sendAsync(request, HttpResponse.BodyHandlers.ofString())\n .thenApply(HttpResponse::body)\n .thenAccept(System.out::println)\n .join();\n }\n}","templateHtml":"$237","tokens":[{"marker":"__RP_TOK_0__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer "}},{"id":"csharp","label":"C#","templateCode":"using System.Net.Http;\nusing System.Net.Http.Headers;\n\nvar client = new HttpClient();\nvar request = new HttpRequestMessage\n{\n Method = HttpMethod.Post,\n RequestUri = new Uri(\"https://merchant.revolut.com/api/apple-pay/domains/register\"),\n Headers =\n {\n { \"Authorization\", \"__RP_TOK_0__\" },\n },\n Content = new StringContent(@\"{\n \"\"domain\"\": \"\"revolut.com\"\"\n}\")\n {\n Headers =\n {\n ContentType = new MediaTypeHeaderValue(\"application/json\")\n }\n }\n};\n\nusing (var response = await client.SendAsync(request))\n{\n response.EnsureSuccessStatusCode();\n var body = await response.Content.ReadAsStringAsync();\n Console.WriteLine(body);\n}","templateHtml":"$238","tokens":[{"marker":"__RP_TOK_0__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer "}}],"https://sandbox-merchant.revolut.com":[{"id":"curl","label":"cURL","templateCode":"curl -X POST \"https://sandbox-merchant.revolut.com/api/apple-pay/domains/register\" \\\n -H \"Content-Type: application/json\" \\\n -H \"Authorization: __RP_TOK_0__\" \\\n -d '{\n \"domain\": \"revolut.com\"\n}'","templateHtml":"$239","tokens":[{"marker":"__RP_TOK_0__","paramName":"Authorization","paramIn":"header","pipeline":["shell-double-inner"]}],"defaults":{"header:Authorization":"Bearer "}},{"id":"javascript","label":"JavaScript","templateCode":"const payload = {\n \"domain\": \"revolut.com\"\n};\nfetch(\"https://sandbox-merchant.revolut.com/api/apple-pay/domains/register\", {\n method: \"POST\",\n headers: {\n \"Content-Type\": \"application/json\",\n \"Authorization\": \"__RP_TOK_0__\"\n },\n body: JSON.stringify(payload)\n})\n .then(response => response.json())\n .then(data => console.log(data));","templateHtml":"$23a","tokens":[{"marker":"__RP_TOK_0__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer "}},{"id":"go","label":"Go","templateCode":"package main\n\nimport (\n \"fmt\"\n \"net/http\"\n \"bytes\"\n \"encoding/json\"\n)\n\nfunc main() {\n url := \"https://sandbox-merchant.revolut.com/api/apple-pay/domains/register\"\n jsonData := []byte(`\n{\n \"domain\": \"revolut.com\"\n}\n `)\n req, _ := http.NewRequest(\"POST\", url, bytes.NewBuffer(jsonData))\n req.Header.Add(\"Content-Type\", \"application/json\")\n req.Header.Add(\"Authorization\", \"__RP_TOK_0__\")\n\n res, _ := http.DefaultClient.Do(req)\n defer res.Body.Close()\n fmt.Println(res)\n}","templateHtml":"$23b","tokens":[{"marker":"__RP_TOK_0__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer "}},{"id":"python","label":"Python","templateCode":"import requests\n\nurl = \"https://sandbox-merchant.revolut.com/api/apple-pay/domains/register\"\nheaders = {\n \"Content-Type\": \"application/json\",\n \"Authorization\": \"__RP_TOK_0__\"\n}\npayload = {\n \"domain\": \"revolut.com\"\n}\n\nresponse = requests.post(url, headers=headers, json=payload)\nprint(response.json())","templateHtml":"$23c","tokens":[{"marker":"__RP_TOK_0__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer "}},{"id":"java","label":"Java","templateCode":"import java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\nimport java.net.URI;\n\npublic class Main {\n public static void main(String[] args) {\n HttpClient client = HttpClient.newHttpClient();\n String body = \"\"\"\n{\n \"domain\": \"revolut.com\"\n}\n \"\"\";\n\n HttpRequest request = HttpRequest.newBuilder()\n .uri(URI.create(\"https://sandbox-merchant.revolut.com/api/apple-pay/domains/register\"))\n .header(\"Content-Type\", \"application/json\")\n .header(\"Authorization\", \"__RP_TOK_0__\")\n .POST(HttpRequest.BodyPublishers.ofString(body))\n .build();\n\n client.sendAsync(request, HttpResponse.BodyHandlers.ofString())\n .thenApply(HttpResponse::body)\n .thenAccept(System.out::println)\n .join();\n }\n}","templateHtml":"$23d","tokens":[{"marker":"__RP_TOK_0__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer "}},{"id":"csharp","label":"C#","templateCode":"using System.Net.Http;\nusing System.Net.Http.Headers;\n\nvar client = new HttpClient();\nvar request = new HttpRequestMessage\n{\n Method = HttpMethod.Post,\n RequestUri = new Uri(\"https://sandbox-merchant.revolut.com/api/apple-pay/domains/register\"),\n Headers =\n {\n { \"Authorization\", \"__RP_TOK_0__\" },\n },\n Content = new StringContent(@\"{\n \"\"domain\"\": \"\"revolut.com\"\"\n}\")\n {\n Headers =\n {\n ContentType = new MediaTypeHeaderValue(\"application/json\")\n }\n }\n};\n\nusing (var response = await client.SendAsync(request))\n{\n response.EnsureSuccessStatusCode();\n var body = await response.Content.ReadAsStringAsync();\n Console.WriteLine(body);\n}","templateHtml":"$23e","tokens":[{"marker":"__RP_TOK_0__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer "}}]},"method":"post","servers":"$62:props:children:0:props:children:props:children:1:props:children:1:props:children:0:0:props:servers","path":"/api/apple-pay/domains/register","parameters":["$6a:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:0"]}],"$L23f"],"$L240","$L241"]}]]}]]}]}],false]}] 6e:["$","$7a","retrieve-synchronous-webhook-list",{"children":[["$","section",null,{"className":"y9a0do0","data-variant":"endpoint","children":["$","$L7b",null,{"responses":{"200":{"description":"Synchronous webhook list returned","content":{"application/json":{"schema":{"type":"array","items":{"title":"SynchronousWebhook","type":"object","properties":{"id":{"type":"string","format":"uuid","description":"The ID of the synchronous webhook object.","descriptionNode":"$L242"},"signing_key":{"type":"string","pattern":"^swsk_[a-zA-Z0-9]{32}$","description":"A randomly generated signing key, which can be used by merchants to authenticate requests from Revolut by verifying the signature. For more information, see: [Payload Signature](https://developer.revolut.com/docs/api/merchant#authentication).","descriptionNode":"$L243"},"url":{"type":"string","format":"uri","pattern":"^https:\\/{2}.+/gi","maxLength":2000,"description":"The valid URL of the endpoint, that uses HTTPS URL schema. Revolut sends the shipping address of the customer to this URL for validation.\n\n:::warning\nRestrictions:\n- Must be a valid URI as defined by [RFC 3986](https://datatracker.ietf.org/doc/html/rfc3986)\n- URI scheme is required and must be `https`\n- URI host is required and cannot be `localhost` or an IP address\n- Max length: `2000`\n- Reserved or invalid characters must be percent-encoded (for example, use `%20` instead of a space)\n:::","descriptionNode":"$L244"},"event_type":{"type":"string","enum":["fast_checkout.validate_address"],"description":"Type of event this synchronous webhook is configured for.\n\n:::note\nAt the moment, synchronous webhooks only support address validation events. \n:::","descriptionNode":"$L245"},"location_id":{"type":"string","format":"uuid","description":"Unique ID representing the location where merchants sells products.\n\n:::info\nFor more information, see: [Locations](https://developer.revolut.com/docs/api/merchant#tag-locations).\n::: ","descriptionNode":"$L246"}},"required":["id","signing_key","url","event_type"]}},"examples":{"example_without_location":{"summary":"List of synchronous webhooks","value":[{"id":"f6abc4df-eb48-417c-8e75-f7c6d7ad394f","signing_key":"swsk_y5z3LEHYZ9ndote3qegzWD6uL4t1lfp1","url":"https://example.com/webhooks/validate-address","event_type":"fast_checkout.validate_address"},{"id":"5c08dcc1-cd60-4b7d-a255-e42d24d7365c","signing_key":"swsk_VsuFcq6FIpa9gOWUu0n2WxiCbsDHIJlN","url":"https://groceries.example.com/webhooks/validate-address","event_type":"fast_checkout.validate_address","location_id":"b0ebede4-5cbc-4951-977f-70329faa8769"},{"id":"dbebe6f8-4c47-4176-a94f-576d76e1d0b6","signing_key":"swsk_0TKYlzoakBgGGVvojCiRRqInMD1ufLZn","url":"https://clothes.example.com/webhooks/validate-address","event_type":"fast_checkout.validate_address","location_id":"6ebd3d2b-7a51-42e4-84f4-3c513621edd3"}]}}}},"descriptionNode":"$L247"},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"errorId":{"type":"string","description":"The ID of the error. You can share this ID with Revolut support for troubleshooting.","descriptionNode":"$L248"},"timestamp":{"type":"integer","description":"The date and time the error happened.","descriptionNode":"$L249"}},"required":"$62:props:children:0:props:children:props:responses:401:content:application/json:schema:required"}}},"descriptionNode":"$L24a"},"401":{"description":"Unauthorized","descriptionNode":"$L24b"}},"requestBody":"$undefined","variantLabels":[],"children":[["$","div",null,{"className":"ezz1n30","children":[["$","div",null,{"data-header":"$undefined","className":"ezz1n31","children":["$","div",null,{"className":"y9a0do1","children":[["$","h2",null,{"id":"retrieve-synchronous-webhook-list","children":[["$L24c","$undefined"],["$","$L15",null,{"id":"retrieve-synchronous-webhook-list"}]]}],["$","$L16",null,{"url":"/docs/api/merchant/2025-10-16/operations/retrieve-synchronous-webhook-list.md"}]]}]}],"$undefined"]}],["$","div",null,{"className":"ezz1n30","children":[["$","div",null,{"data-header":"$undefined","className":"ezz1n31","children":"$L24d"}],"$L24e"]}]]}]}],false]}] 38:["$","$7a","update-subscription-renewal-date",{"children":[["$","section",null,{"className":"y9a0do0","data-variant":"endpoint","children":["$","$L7b",null,{"responses":{"204":{"description":"Renewal date updated successfully","descriptionNode":"$L24f"},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"code":{"type":"string","description":"An identifier that can be used to determine what went wrong.\n\nError codes are not globally unique, but uniqueness is guaranteed within endpoints.","descriptionNode":"$L250"},"message":{"type":"string","description":"Some human readable text describing what went wrong.","descriptionNode":"$L251"},"timestamp":{"type":"integer","description":"The [UNIX timestamp](https://www.unixtimestamp.com/) of the date and time the error happened.","descriptionNode":"$L252"}}}}},"descriptionNode":"$L253"},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"code":{"type":"string","description":"An identifier that can be used to determine what went wrong.\n\nError codes are not globally unique, but uniqueness is guaranteed within endpoints.","descriptionNode":"$L254"},"message":{"type":"string","description":"Some human readable text describing what went wrong.","descriptionNode":"$L255"},"timestamp":{"type":"integer","description":"The [UNIX timestamp](https://www.unixtimestamp.com/) of the date and time the error happened.","descriptionNode":"$L256"}}}}},"descriptionNode":"$L257"},"404":{"description":"Subscription not found","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"code":{"type":"string","description":"An identifier that can be used to determine what went wrong.\n\nError codes are not globally unique, but uniqueness is guaranteed within endpoints.","descriptionNode":"$L258"},"message":{"type":"string","description":"Some human readable text describing what went wrong.","descriptionNode":"$L259"},"timestamp":{"type":"integer","description":"The [UNIX timestamp](https://www.unixtimestamp.com/) of the date and time the error happened.","descriptionNode":"$L25a"}}}}},"descriptionNode":"$L25b"},"422":{"description":"Unprocessable entity (business rule violation)","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"code":{"type":"string","description":"An identifier that can be used to determine what went wrong.\n\nError codes are not globally unique, but uniqueness is guaranteed within endpoints.","descriptionNode":"$L25c"},"message":{"type":"string","description":"Some human readable text describing what went wrong.","descriptionNode":"$L25d"},"timestamp":{"type":"integer","description":"The [UNIX timestamp](https://www.unixtimestamp.com/) of the date and time the error happened.","descriptionNode":"$L25e"}}},"examples":{"subscription_finished":{"summary":"Subscription is finished","value":{"code":"subscription_finished","message":"The subscription is finished","timestamp":1601296792533}},"next_cycle_exists":{"summary":"Next cycle already exists","value":{"code":"subscription_cycle_next_cycle_exists","message":"Cannot change cycle end date when next cycle already exists","timestamp":1601296792533}},"end_date_too_early":{"summary":"Renewal date is too early","value":{"code":"subscription_cycle_end_date_too_early","message":"The end date is too early","timestamp":1601296792533}},"end_date_too_far":{"summary":"Renewal date is too far in the future","value":{"code":"subscription_cycle_end_date_too_far","message":"The end date is too far in the future","timestamp":1601296792533}}}}},"descriptionNode":"$L25f"},"default":{"description":"Error response","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"code":{"type":"string","description":"An identifier that can be used to determine what went wrong.\n\nError codes are not globally unique, but uniqueness is guaranteed within endpoints.","descriptionNode":"$L260"},"message":{"type":"string","description":"Some human readable text describing what went wrong.","descriptionNode":"$L261"},"timestamp":{"type":"integer","description":"The [UNIX timestamp](https://www.unixtimestamp.com/) of the date and time the error happened.","descriptionNode":"$L262"}}}}},"descriptionNode":"$L263"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"renewal_date":{"type":"string","format":"date-time","description":"The new renewal date for the subscription, expressed as a UTC date-time value.\n\nMust be set to a date later than the current renewal date; earlier dates are rejected.","examples":["2026-07-01T00:00:00Z"],"descriptionNode":"$L264"}},"required":["renewal_date"]},"examples":{"simple_plan":{"summary":"Update renewal date","value":{"renewal_date":"2026-07-01T00:00:00Z"}}}}}},"variantLabels":[],"children":["$L265","$L266"]}]}],false]}] 1e1:"Retrieve a webhook" 23f:["$","$L10d",null,{"security":[{"Api-Key":[]}],"authorization":{"Api-Key":{"type":"apiKey","in":"header","name":"Authorization","description":"Each Merchant API request must contain an authorization header in the following format:\n\n```\n'Authorization: Bearer '\n```\n\nTo use this API, you need to generate API keys from your Revolut Business account. The Secret key is used in the authorization header for all server calls, while the Public key is provided with payment methods at checkout.\n\n:::info\nFor detailed instructions on generating your API keys, see: [Generate API keys](https://developer.revolut.com/docs/guides/merchant/get-started#generate-api-keys).\n:::","descriptionNode":"$L267"}}}] 240:["$","$L10f",null,{"exampleBlocks":{"application/json":{"variants":[{"key":"example_request","label":"Example domain registration request for Apple Pay","rawValue":"$6a:props:children:0:props:children:props:requestBody:content:application/json:examples:example_request:value","block":"$L268"}],"syncedPropertyName":"$undefined"}},"title":"Request body samples","headingAs":"h4"}] 241:["$","$L110",null,{"exampleBlocks":{"204":{},"400":{"application/json":{"variants":[{"key":"error_message","label":"Error message","rawValue":"$6a:props:children:0:props:children:props:responses:400:content:application/json:examples:error_message:value","block":"$L269"}],"syncedPropertyName":"$undefined"}}},"headingAs":"h4"}] 24d:["$L26a",["$","$L85",null,{"parameters":[{"name":"Authorization","in":"header","schema":{"type":"string","format":"Bearer ","examples":"$62:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:0:schema:examples"},"required":true,"description":"This parameter accepts the [Merchant API Secret key](https://business.revolut.com/settings/apis?tab=merchant-api) to authorise requests coming from the merchant's backend. \n\nIt ensures that ensures that each request is authenticated and authorised by verifying the secret key. The secret key should be included in all request headers as a `Bearer` token.\n\n:::info\nFor more information, see: [Authentication](https://developer.revolut.com/docs/api/merchant#authentication)\n:::","descriptionNode":"$L26b"}],"requestBody":"$undefined","heading":"Request","requestBodySchemaTitle":"Request body","headingAs":"h3"}],["$","$L89",null,{"responses":"$6e:props:children:0:props:children:props:responses","headingAs":"h3"}]] 26c:T8ac,
fetch("https://merchant.revolut.com/api/synchronous-webhooks", {
  method: "GET",
  headers: {
    "Authorization": "__RP_TOK_0__"
  }
})
  .then(response => response.json())
  .then(data => console.log(data));
26d:Td94,
package main

import (
  "fmt"
  "net/http"
)

func main() {
  url := "https://merchant.revolut.com/api/synchronous-webhooks"
  req, _ := http.NewRequest("GET", url, nil)
  req.Header.Add("Authorization", "__RP_TOK_0__")

  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  fmt.Println(res)
}
26e:T6c0,
import requests

url = "https://merchant.revolut.com/api/synchronous-webhooks"
headers = {
  "Authorization": "__RP_TOK_0__"
}

response = requests.get(url, headers=headers)
print(response.json())
26f:T1538,
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;

public class Main {
  public static void main(String[] args) {
    HttpClient client = HttpClient.newHttpClient();
    HttpRequest request = HttpRequest.newBuilder()
      .uri(URI.create("https://merchant.revolut.com/api/synchronous-webhooks"))
      .header("Authorization", "__RP_TOK_0__")
      .GET(HttpRequest.BodyPublishers.noBody())
      .build();

    client.sendAsync(request, HttpResponse.BodyHandlers.ofString())
      .thenApply(HttpResponse::body)
      .thenAccept(System.out::println)
      .join();
  }
}
270:T1458,
using System.Net.Http;
using System.Net.Http.Headers;

var client = new HttpClient();
var request = new HttpRequestMessage
{
  Method = HttpMethod.Get,
  RequestUri = new Uri("https://merchant.revolut.com/api/synchronous-webhooks"),
  Headers =
  {
    { "Authorization", "__RP_TOK_0__" },
  }
};

using (var response = await client.SendAsync(request))
{
  response.EnsureSuccessStatusCode();
  var body = await response.Content.ReadAsStringAsync();
  Console.WriteLine(body);
}
271:T8b4,
fetch("https://sandbox-merchant.revolut.com/api/synchronous-webhooks", {
  method: "GET",
  headers: {
    "Authorization": "__RP_TOK_0__"
  }
})
  .then(response => response.json())
  .then(data => console.log(data));
272:Td9c,
package main

import (
  "fmt"
  "net/http"
)

func main() {
  url := "https://sandbox-merchant.revolut.com/api/synchronous-webhooks"
  req, _ := http.NewRequest("GET", url, nil)
  req.Header.Add("Authorization", "__RP_TOK_0__")

  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  fmt.Println(res)
}
273:T6c8,
import requests

url = "https://sandbox-merchant.revolut.com/api/synchronous-webhooks"
headers = {
  "Authorization": "__RP_TOK_0__"
}

response = requests.get(url, headers=headers)
print(response.json())
274:T1540,
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;

public class Main {
  public static void main(String[] args) {
    HttpClient client = HttpClient.newHttpClient();
    HttpRequest request = HttpRequest.newBuilder()
      .uri(URI.create("https://sandbox-merchant.revolut.com/api/synchronous-webhooks"))
      .header("Authorization", "__RP_TOK_0__")
      .GET(HttpRequest.BodyPublishers.noBody())
      .build();

    client.sendAsync(request, HttpResponse.BodyHandlers.ofString())
      .thenApply(HttpResponse::body)
      .thenAccept(System.out::println)
      .join();
  }
}
275:T1460,
using System.Net.Http;
using System.Net.Http.Headers;

var client = new HttpClient();
var request = new HttpRequestMessage
{
  Method = HttpMethod.Get,
  RequestUri = new Uri("https://sandbox-merchant.revolut.com/api/synchronous-webhooks"),
  Headers =
  {
    { "Authorization", "__RP_TOK_0__" },
  }
};

using (var response = await client.SendAsync(request))
{
  response.EnsureSuccessStatusCode();
  var body = await response.Content.ReadAsStringAsync();
  Console.WriteLine(body);
}
24e:["$","div",null,{"className":"ezz1n32","children":[[["$","$L8a",null,{"itemsByServer":{"https://merchant.revolut.com":[{"id":"curl","label":"cURL","templateCode":"curl -X GET \"https://merchant.revolut.com/api/synchronous-webhooks\" \\\n -H \"Authorization: __RP_TOK_0__\"","templateHtml":"
curl -X GET \"https://merchant.revolut.com/api/synchronous-webhooks\" \\\n  -H \"Authorization: __RP_TOK_0__\"
","tokens":[{"marker":"__RP_TOK_0__","paramName":"Authorization","paramIn":"header","pipeline":["shell-double-inner"]}],"defaults":{"header:Authorization":"Bearer "}},{"id":"javascript","label":"JavaScript","templateCode":"fetch(\"https://merchant.revolut.com/api/synchronous-webhooks\", {\n method: \"GET\",\n headers: {\n \"Authorization\": \"__RP_TOK_0__\"\n }\n})\n .then(response => response.json())\n .then(data => console.log(data));","templateHtml":"$26c","tokens":[{"marker":"__RP_TOK_0__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer "}},{"id":"go","label":"Go","templateCode":"package main\n\nimport (\n \"fmt\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://merchant.revolut.com/api/synchronous-webhooks\"\n req, _ := http.NewRequest(\"GET\", url, nil)\n req.Header.Add(\"Authorization\", \"__RP_TOK_0__\")\n\n res, _ := http.DefaultClient.Do(req)\n defer res.Body.Close()\n fmt.Println(res)\n}","templateHtml":"$26d","tokens":[{"marker":"__RP_TOK_0__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer "}},{"id":"python","label":"Python","templateCode":"import requests\n\nurl = \"https://merchant.revolut.com/api/synchronous-webhooks\"\nheaders = {\n \"Authorization\": \"__RP_TOK_0__\"\n}\n\nresponse = requests.get(url, headers=headers)\nprint(response.json())","templateHtml":"$26e","tokens":[{"marker":"__RP_TOK_0__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer "}},{"id":"java","label":"Java","templateCode":"import java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\nimport java.net.URI;\n\npublic class Main {\n public static void main(String[] args) {\n HttpClient client = HttpClient.newHttpClient();\n HttpRequest request = HttpRequest.newBuilder()\n .uri(URI.create(\"https://merchant.revolut.com/api/synchronous-webhooks\"))\n .header(\"Authorization\", \"__RP_TOK_0__\")\n .GET(HttpRequest.BodyPublishers.noBody())\n .build();\n\n client.sendAsync(request, HttpResponse.BodyHandlers.ofString())\n .thenApply(HttpResponse::body)\n .thenAccept(System.out::println)\n .join();\n }\n}","templateHtml":"$26f","tokens":[{"marker":"__RP_TOK_0__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer "}},{"id":"csharp","label":"C#","templateCode":"using System.Net.Http;\nusing System.Net.Http.Headers;\n\nvar client = new HttpClient();\nvar request = new HttpRequestMessage\n{\n Method = HttpMethod.Get,\n RequestUri = new Uri(\"https://merchant.revolut.com/api/synchronous-webhooks\"),\n Headers =\n {\n { \"Authorization\", \"__RP_TOK_0__\" },\n }\n};\n\nusing (var response = await client.SendAsync(request))\n{\n response.EnsureSuccessStatusCode();\n var body = await response.Content.ReadAsStringAsync();\n Console.WriteLine(body);\n}","templateHtml":"$270","tokens":[{"marker":"__RP_TOK_0__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer "}}],"https://sandbox-merchant.revolut.com":[{"id":"curl","label":"cURL","templateCode":"curl -X GET \"https://sandbox-merchant.revolut.com/api/synchronous-webhooks\" \\\n -H \"Authorization: __RP_TOK_0__\"","templateHtml":"
curl -X GET \"https://sandbox-merchant.revolut.com/api/synchronous-webhooks\" \\\n  -H \"Authorization: __RP_TOK_0__\"
","tokens":[{"marker":"__RP_TOK_0__","paramName":"Authorization","paramIn":"header","pipeline":["shell-double-inner"]}],"defaults":{"header:Authorization":"Bearer "}},{"id":"javascript","label":"JavaScript","templateCode":"fetch(\"https://sandbox-merchant.revolut.com/api/synchronous-webhooks\", {\n method: \"GET\",\n headers: {\n \"Authorization\": \"__RP_TOK_0__\"\n }\n})\n .then(response => response.json())\n .then(data => console.log(data));","templateHtml":"$271","tokens":[{"marker":"__RP_TOK_0__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer "}},{"id":"go","label":"Go","templateCode":"package main\n\nimport (\n \"fmt\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://sandbox-merchant.revolut.com/api/synchronous-webhooks\"\n req, _ := http.NewRequest(\"GET\", url, nil)\n req.Header.Add(\"Authorization\", \"__RP_TOK_0__\")\n\n res, _ := http.DefaultClient.Do(req)\n defer res.Body.Close()\n fmt.Println(res)\n}","templateHtml":"$272","tokens":[{"marker":"__RP_TOK_0__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer "}},{"id":"python","label":"Python","templateCode":"import requests\n\nurl = \"https://sandbox-merchant.revolut.com/api/synchronous-webhooks\"\nheaders = {\n \"Authorization\": \"__RP_TOK_0__\"\n}\n\nresponse = requests.get(url, headers=headers)\nprint(response.json())","templateHtml":"$273","tokens":[{"marker":"__RP_TOK_0__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer "}},{"id":"java","label":"Java","templateCode":"import java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\nimport java.net.URI;\n\npublic class Main {\n public static void main(String[] args) {\n HttpClient client = HttpClient.newHttpClient();\n HttpRequest request = HttpRequest.newBuilder()\n .uri(URI.create(\"https://sandbox-merchant.revolut.com/api/synchronous-webhooks\"))\n .header(\"Authorization\", \"__RP_TOK_0__\")\n .GET(HttpRequest.BodyPublishers.noBody())\n .build();\n\n client.sendAsync(request, HttpResponse.BodyHandlers.ofString())\n .thenApply(HttpResponse::body)\n .thenAccept(System.out::println)\n .join();\n }\n}","templateHtml":"$274","tokens":[{"marker":"__RP_TOK_0__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer "}},{"id":"csharp","label":"C#","templateCode":"using System.Net.Http;\nusing System.Net.Http.Headers;\n\nvar client = new HttpClient();\nvar request = new HttpRequestMessage\n{\n Method = HttpMethod.Get,\n RequestUri = new Uri(\"https://sandbox-merchant.revolut.com/api/synchronous-webhooks\"),\n Headers =\n {\n { \"Authorization\", \"__RP_TOK_0__\" },\n }\n};\n\nusing (var response = await client.SendAsync(request))\n{\n response.EnsureSuccessStatusCode();\n var body = await response.Content.ReadAsStringAsync();\n Console.WriteLine(body);\n}","templateHtml":"$275","tokens":[{"marker":"__RP_TOK_0__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer "}}]},"method":"get","servers":"$62:props:children:0:props:children:props:children:1:props:children:1:props:children:0:0:props:servers","path":"/api/synchronous-webhooks","parameters":["$24d:1:props:parameters:0"]}],"$L276"],"$L277","$L278"]}] 265:["$","div",null,{"className":"ezz1n30","children":[["$","div",null,{"data-header":"$undefined","className":"ezz1n31","children":["$","div",null,{"className":"y9a0do1","children":[["$","h2",null,{"id":"update-subscription-renewal-date","children":[["$L279","$undefined"],["$","$L15",null,{"id":"update-subscription-renewal-date"}]]}],["$","$L16",null,{"url":"/docs/api/merchant/2025-10-16/operations/update-subscription-renewal-date.md"}]]}]}],"$undefined"]}] 27f:T664,
curl -X POST "https://merchant.revolut.com/api/subscriptions/__RP_TOK_0__/change-renewal-date" \
  -H "Content-Type: application/json" \
  -H "Authorization: __RP_TOK_1__" \
  -H "Revolut-Api-Version: __RP_TOK_2__" \
  -d '{
  "renewal_date": "2026-07-01T00:00:00Z"
}'
280:Tead,
const payload = {
  "renewal_date": "2026-07-01T00:00:00Z"
};
fetch("https://merchant.revolut.com/api/subscriptions/__RP_TOK_0__/change-renewal-date", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "__RP_TOK_1__",
    "Revolut-Api-Version": "__RP_TOK_2__"
  },
  body: JSON.stringify(payload)
})
  .then(response => response.json())
  .then(data => console.log(data));
281:T1649,
package main

import (
  "fmt"
  "net/http"
  "bytes"
  "encoding/json"
)

func main() {
  url := "https://merchant.revolut.com/api/subscriptions/__RP_TOK_0__/change-renewal-date"
  jsonData := []byte(`
{
  "renewal_date": "2026-07-01T00:00:00Z"
}
  `)
  req, _ := http.NewRequest("POST", url, bytes.NewBuffer(jsonData))
  req.Header.Add("Content-Type", "application/json")
  req.Header.Add("Authorization", "__RP_TOK_1__")
  req.Header.Add("Revolut-Api-Version", "__RP_TOK_2__")

  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  fmt.Println(res)
}
282:Tbe1,
import requests

url = "https://merchant.revolut.com/api/subscriptions/__RP_TOK_0__/change-renewal-date"
headers = {
  "Content-Type": "application/json",
  "Authorization": "__RP_TOK_1__",
  "Revolut-Api-Version": "__RP_TOK_2__"
}
payload = {
  "renewal_date": "2026-07-01T00:00:00Z"
}

response = requests.post(url, headers=headers, json=payload)
print(response.json())
283:T1bad,
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;

public class Main {
  public static void main(String[] args) {
    HttpClient client = HttpClient.newHttpClient();
    String body = """
{
  "renewal_date": "2026-07-01T00:00:00Z"
}
    """;

    HttpRequest request = HttpRequest.newBuilder()
      .uri(URI.create("https://merchant.revolut.com/api/subscriptions/__RP_TOK_0__/change-renewal-date"))
      .header("Content-Type", "application/json")
      .header("Authorization", "__RP_TOK_1__")
      .header("Revolut-Api-Version", "__RP_TOK_2__")
      .POST(HttpRequest.BodyPublishers.ofString(body))
      .build();

    client.sendAsync(request, HttpResponse.BodyHandlers.ofString())
      .thenApply(HttpResponse::body)
      .thenAccept(System.out::println)
      .join();
  }
}
284:T1d95,
using System.Net.Http;
using System.Net.Http.Headers;

var client = new HttpClient();
var request = new HttpRequestMessage
{
  Method = HttpMethod.Post,
  RequestUri = new Uri("https://merchant.revolut.com/api/subscriptions/__RP_TOK_0__/change-renewal-date"),
  Headers =
  {
    { "Authorization", "__RP_TOK_1__" },
    { "Revolut-Api-Version", "__RP_TOK_2__" },
  },
  Content = new StringContent(@"{
  ""renewal_date"": ""2026-07-01T00:00:00Z""
}")
  {
    Headers =
    {
      ContentType = new MediaTypeHeaderValue("application/json")
    }
  }
};

using (var response = await client.SendAsync(request))
{
  response.EnsureSuccessStatusCode();
  var body = await response.Content.ReadAsStringAsync();
  Console.WriteLine(body);
}
285:T66c,
curl -X POST "https://sandbox-merchant.revolut.com/api/subscriptions/__RP_TOK_0__/change-renewal-date" \
  -H "Content-Type: application/json" \
  -H "Authorization: __RP_TOK_1__" \
  -H "Revolut-Api-Version: __RP_TOK_2__" \
  -d '{
  "renewal_date": "2026-07-01T00:00:00Z"
}'
286:Teb5,
const payload = {
  "renewal_date": "2026-07-01T00:00:00Z"
};
fetch("https://sandbox-merchant.revolut.com/api/subscriptions/__RP_TOK_0__/change-renewal-date", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "__RP_TOK_1__",
    "Revolut-Api-Version": "__RP_TOK_2__"
  },
  body: JSON.stringify(payload)
})
  .then(response => response.json())
  .then(data => console.log(data));
287:T1651,
package main

import (
  "fmt"
  "net/http"
  "bytes"
  "encoding/json"
)

func main() {
  url := "https://sandbox-merchant.revolut.com/api/subscriptions/__RP_TOK_0__/change-renewal-date"
  jsonData := []byte(`
{
  "renewal_date": "2026-07-01T00:00:00Z"
}
  `)
  req, _ := http.NewRequest("POST", url, bytes.NewBuffer(jsonData))
  req.Header.Add("Content-Type", "application/json")
  req.Header.Add("Authorization", "__RP_TOK_1__")
  req.Header.Add("Revolut-Api-Version", "__RP_TOK_2__")

  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  fmt.Println(res)
}
288:Tbe9,
import requests

url = "https://sandbox-merchant.revolut.com/api/subscriptions/__RP_TOK_0__/change-renewal-date"
headers = {
  "Content-Type": "application/json",
  "Authorization": "__RP_TOK_1__",
  "Revolut-Api-Version": "__RP_TOK_2__"
}
payload = {
  "renewal_date": "2026-07-01T00:00:00Z"
}

response = requests.post(url, headers=headers, json=payload)
print(response.json())
289:T1bb5,
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;

public class Main {
  public static void main(String[] args) {
    HttpClient client = HttpClient.newHttpClient();
    String body = """
{
  "renewal_date": "2026-07-01T00:00:00Z"
}
    """;

    HttpRequest request = HttpRequest.newBuilder()
      .uri(URI.create("https://sandbox-merchant.revolut.com/api/subscriptions/__RP_TOK_0__/change-renewal-date"))
      .header("Content-Type", "application/json")
      .header("Authorization", "__RP_TOK_1__")
      .header("Revolut-Api-Version", "__RP_TOK_2__")
      .POST(HttpRequest.BodyPublishers.ofString(body))
      .build();

    client.sendAsync(request, HttpResponse.BodyHandlers.ofString())
      .thenApply(HttpResponse::body)
      .thenAccept(System.out::println)
      .join();
  }
}
28a:T1d9d,
using System.Net.Http;
using System.Net.Http.Headers;

var client = new HttpClient();
var request = new HttpRequestMessage
{
  Method = HttpMethod.Post,
  RequestUri = new Uri("https://sandbox-merchant.revolut.com/api/subscriptions/__RP_TOK_0__/change-renewal-date"),
  Headers =
  {
    { "Authorization", "__RP_TOK_1__" },
    { "Revolut-Api-Version", "__RP_TOK_2__" },
  },
  Content = new StringContent(@"{
  ""renewal_date"": ""2026-07-01T00:00:00Z""
}")
  {
    Headers =
    {
      ContentType = new MediaTypeHeaderValue("application/json")
    }
  }
};

using (var response = await client.SendAsync(request))
{
  response.EnsureSuccessStatusCode();
  var body = await response.Content.ReadAsStringAsync();
  Console.WriteLine(body);
}
266:["$","div",null,{"className":"ezz1n30","children":[["$","div",null,{"data-header":"$undefined","className":"ezz1n31","children":["$L27a",["$","$L85",null,{"parameters":[{"name":"Authorization","in":"header","schema":{"type":"string","format":"Bearer ","examples":"$62:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:0:schema:examples"},"required":true,"description":"This parameter accepts the [Merchant API Secret key](https://business.revolut.com/settings/apis?tab=merchant-api) to authorise requests coming from the merchant's backend. \n\nIt ensures that ensures that each request is authenticated and authorised by verifying the secret key. The secret key should be included in all request headers as a `Bearer` token.\n\n:::info\nFor more information, see: [Authentication](https://developer.revolut.com/docs/api/merchant#authentication)\n:::","descriptionNode":"$L27b"},{"name":"Revolut-Api-Version","in":"header","schema":{"type":"string","format":"date","enum":"$36:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:1:schema:enum","examples":"$36:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:1:schema:examples"},"required":true,"description":"The version of the Merchant API, specified in `YYYY-MM-DD` format.\n\nIf not specified, you will receive an error.\n\n\n:::info\nFor more information about API versioning, see: [API versions](https://developer.revolut.com/docs/guides/merchant/reference/versioning/api-versions).\n:::","x-config-always-visible-in-example":true,"example":"2025-10-16","descriptionNode":"$L27c"},{"name":"subscription_id","in":"path","schema":{"type":"string","format":"uuid","description":"A UUID string, typically used to identify resources.","descriptionNode":"$L27d"},"required":true,"description":"The ID of the subscription.","descriptionNode":"$L27e"}],"requestBody":"$38:props:children:0:props:children:props:requestBody","heading":"Request","requestBodySchemaTitle":"Request body","headingAs":"h3"}],["$","$L89",null,{"responses":"$38:props:children:0:props:children:props:responses","headingAs":"h3"}]]}],["$","div",null,{"className":"ezz1n32","children":[[["$","$L8a",null,{"itemsByServer":{"https://merchant.revolut.com":[{"id":"curl","label":"cURL","templateCode":"curl -X POST \"https://merchant.revolut.com/api/subscriptions/__RP_TOK_0__/change-renewal-date\" \\\n -H \"Content-Type: application/json\" \\\n -H \"Authorization: __RP_TOK_1__\" \\\n -H \"Revolut-Api-Version: __RP_TOK_2__\" \\\n -d '{\n \"renewal_date\": \"2026-07-01T00:00:00Z\"\n}'","templateHtml":"$27f","tokens":[{"marker":"__RP_TOK_0__","paramName":"subscription_id","paramIn":"path","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["shell-double-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:subscription_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"javascript","label":"JavaScript","templateCode":"const payload = {\n \"renewal_date\": \"2026-07-01T00:00:00Z\"\n};\nfetch(\"https://merchant.revolut.com/api/subscriptions/__RP_TOK_0__/change-renewal-date\", {\n method: \"POST\",\n headers: {\n \"Content-Type\": \"application/json\",\n \"Authorization\": \"__RP_TOK_1__\",\n \"Revolut-Api-Version\": \"__RP_TOK_2__\"\n },\n body: JSON.stringify(payload)\n})\n .then(response => response.json())\n .then(data => console.log(data));","templateHtml":"$280","tokens":[{"marker":"__RP_TOK_0__","paramName":"subscription_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:subscription_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"go","label":"Go","templateCode":"package main\n\nimport (\n \"fmt\"\n \"net/http\"\n \"bytes\"\n \"encoding/json\"\n)\n\nfunc main() {\n url := \"https://merchant.revolut.com/api/subscriptions/__RP_TOK_0__/change-renewal-date\"\n jsonData := []byte(`\n{\n \"renewal_date\": \"2026-07-01T00:00:00Z\"\n}\n `)\n req, _ := http.NewRequest(\"POST\", url, bytes.NewBuffer(jsonData))\n req.Header.Add(\"Content-Type\", \"application/json\")\n req.Header.Add(\"Authorization\", \"__RP_TOK_1__\")\n req.Header.Add(\"Revolut-Api-Version\", \"__RP_TOK_2__\")\n\n res, _ := http.DefaultClient.Do(req)\n defer res.Body.Close()\n fmt.Println(res)\n}","templateHtml":"$281","tokens":[{"marker":"__RP_TOK_0__","paramName":"subscription_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:subscription_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"python","label":"Python","templateCode":"import requests\n\nurl = \"https://merchant.revolut.com/api/subscriptions/__RP_TOK_0__/change-renewal-date\"\nheaders = {\n \"Content-Type\": \"application/json\",\n \"Authorization\": \"__RP_TOK_1__\",\n \"Revolut-Api-Version\": \"__RP_TOK_2__\"\n}\npayload = {\n \"renewal_date\": \"2026-07-01T00:00:00Z\"\n}\n\nresponse = requests.post(url, headers=headers, json=payload)\nprint(response.json())","templateHtml":"$282","tokens":[{"marker":"__RP_TOK_0__","paramName":"subscription_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:subscription_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"java","label":"Java","templateCode":"import java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\nimport java.net.URI;\n\npublic class Main {\n public static void main(String[] args) {\n HttpClient client = HttpClient.newHttpClient();\n String body = \"\"\"\n{\n \"renewal_date\": \"2026-07-01T00:00:00Z\"\n}\n \"\"\";\n\n HttpRequest request = HttpRequest.newBuilder()\n .uri(URI.create(\"https://merchant.revolut.com/api/subscriptions/__RP_TOK_0__/change-renewal-date\"))\n .header(\"Content-Type\", \"application/json\")\n .header(\"Authorization\", \"__RP_TOK_1__\")\n .header(\"Revolut-Api-Version\", \"__RP_TOK_2__\")\n .POST(HttpRequest.BodyPublishers.ofString(body))\n .build();\n\n client.sendAsync(request, HttpResponse.BodyHandlers.ofString())\n .thenApply(HttpResponse::body)\n .thenAccept(System.out::println)\n .join();\n }\n}","templateHtml":"$283","tokens":[{"marker":"__RP_TOK_0__","paramName":"subscription_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:subscription_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"csharp","label":"C#","templateCode":"using System.Net.Http;\nusing System.Net.Http.Headers;\n\nvar client = new HttpClient();\nvar request = new HttpRequestMessage\n{\n Method = HttpMethod.Post,\n RequestUri = new Uri(\"https://merchant.revolut.com/api/subscriptions/__RP_TOK_0__/change-renewal-date\"),\n Headers =\n {\n { \"Authorization\", \"__RP_TOK_1__\" },\n { \"Revolut-Api-Version\", \"__RP_TOK_2__\" },\n },\n Content = new StringContent(@\"{\n \"\"renewal_date\"\": \"\"2026-07-01T00:00:00Z\"\"\n}\")\n {\n Headers =\n {\n ContentType = new MediaTypeHeaderValue(\"application/json\")\n }\n }\n};\n\nusing (var response = await client.SendAsync(request))\n{\n response.EnsureSuccessStatusCode();\n var body = await response.Content.ReadAsStringAsync();\n Console.WriteLine(body);\n}","templateHtml":"$284","tokens":[{"marker":"__RP_TOK_0__","paramName":"subscription_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:subscription_id":"123e4567-e89b-12d3-a456-426614174000"}}],"https://sandbox-merchant.revolut.com":[{"id":"curl","label":"cURL","templateCode":"curl -X POST \"https://sandbox-merchant.revolut.com/api/subscriptions/__RP_TOK_0__/change-renewal-date\" \\\n -H \"Content-Type: application/json\" \\\n -H \"Authorization: __RP_TOK_1__\" \\\n -H \"Revolut-Api-Version: __RP_TOK_2__\" \\\n -d '{\n \"renewal_date\": \"2026-07-01T00:00:00Z\"\n}'","templateHtml":"$285","tokens":[{"marker":"__RP_TOK_0__","paramName":"subscription_id","paramIn":"path","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["shell-double-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:subscription_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"javascript","label":"JavaScript","templateCode":"const payload = {\n \"renewal_date\": \"2026-07-01T00:00:00Z\"\n};\nfetch(\"https://sandbox-merchant.revolut.com/api/subscriptions/__RP_TOK_0__/change-renewal-date\", {\n method: \"POST\",\n headers: {\n \"Content-Type\": \"application/json\",\n \"Authorization\": \"__RP_TOK_1__\",\n \"Revolut-Api-Version\": \"__RP_TOK_2__\"\n },\n body: JSON.stringify(payload)\n})\n .then(response => response.json())\n .then(data => console.log(data));","templateHtml":"$286","tokens":[{"marker":"__RP_TOK_0__","paramName":"subscription_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:subscription_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"go","label":"Go","templateCode":"package main\n\nimport (\n \"fmt\"\n \"net/http\"\n \"bytes\"\n \"encoding/json\"\n)\n\nfunc main() {\n url := \"https://sandbox-merchant.revolut.com/api/subscriptions/__RP_TOK_0__/change-renewal-date\"\n jsonData := []byte(`\n{\n \"renewal_date\": \"2026-07-01T00:00:00Z\"\n}\n `)\n req, _ := http.NewRequest(\"POST\", url, bytes.NewBuffer(jsonData))\n req.Header.Add(\"Content-Type\", \"application/json\")\n req.Header.Add(\"Authorization\", \"__RP_TOK_1__\")\n req.Header.Add(\"Revolut-Api-Version\", \"__RP_TOK_2__\")\n\n res, _ := http.DefaultClient.Do(req)\n defer res.Body.Close()\n fmt.Println(res)\n}","templateHtml":"$287","tokens":[{"marker":"__RP_TOK_0__","paramName":"subscription_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:subscription_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"python","label":"Python","templateCode":"import requests\n\nurl = \"https://sandbox-merchant.revolut.com/api/subscriptions/__RP_TOK_0__/change-renewal-date\"\nheaders = {\n \"Content-Type\": \"application/json\",\n \"Authorization\": \"__RP_TOK_1__\",\n \"Revolut-Api-Version\": \"__RP_TOK_2__\"\n}\npayload = {\n \"renewal_date\": \"2026-07-01T00:00:00Z\"\n}\n\nresponse = requests.post(url, headers=headers, json=payload)\nprint(response.json())","templateHtml":"$288","tokens":[{"marker":"__RP_TOK_0__","paramName":"subscription_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:subscription_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"java","label":"Java","templateCode":"import java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\nimport java.net.URI;\n\npublic class Main {\n public static void main(String[] args) {\n HttpClient client = HttpClient.newHttpClient();\n String body = \"\"\"\n{\n \"renewal_date\": \"2026-07-01T00:00:00Z\"\n}\n \"\"\";\n\n HttpRequest request = HttpRequest.newBuilder()\n .uri(URI.create(\"https://sandbox-merchant.revolut.com/api/subscriptions/__RP_TOK_0__/change-renewal-date\"))\n .header(\"Content-Type\", \"application/json\")\n .header(\"Authorization\", \"__RP_TOK_1__\")\n .header(\"Revolut-Api-Version\", \"__RP_TOK_2__\")\n .POST(HttpRequest.BodyPublishers.ofString(body))\n .build();\n\n client.sendAsync(request, HttpResponse.BodyHandlers.ofString())\n .thenApply(HttpResponse::body)\n .thenAccept(System.out::println)\n .join();\n }\n}","templateHtml":"$289","tokens":[{"marker":"__RP_TOK_0__","paramName":"subscription_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:subscription_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"csharp","label":"C#","templateCode":"using System.Net.Http;\nusing System.Net.Http.Headers;\n\nvar client = new HttpClient();\nvar request = new HttpRequestMessage\n{\n Method = HttpMethod.Post,\n RequestUri = new Uri(\"https://sandbox-merchant.revolut.com/api/subscriptions/__RP_TOK_0__/change-renewal-date\"),\n Headers =\n {\n { \"Authorization\", \"__RP_TOK_1__\" },\n { \"Revolut-Api-Version\", \"__RP_TOK_2__\" },\n },\n Content = new StringContent(@\"{\n \"\"renewal_date\"\": \"\"2026-07-01T00:00:00Z\"\"\n}\")\n {\n Headers =\n {\n ContentType = new MediaTypeHeaderValue(\"application/json\")\n }\n }\n};\n\nusing (var response = await client.SendAsync(request))\n{\n response.EnsureSuccessStatusCode();\n var body = await response.Content.ReadAsStringAsync();\n Console.WriteLine(body);\n}","templateHtml":"$28a","tokens":[{"marker":"__RP_TOK_0__","paramName":"subscription_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:subscription_id":"123e4567-e89b-12d3-a456-426614174000"}}]},"method":"post","servers":"$62:props:children:0:props:children:props:children:1:props:children:1:props:children:0:0:props:servers","path":"/api/subscriptions/{subscription_id}/change-renewal-date","parameters":["$266:props:children:0:props:children:1:props:parameters:0","$266:props:children:0:props:children:1:props:parameters:1","$266:props:children:0:props:children:1:props:parameters:2"]}],"$L28b"],"$L28c","$L28d"]}]]}] 47:["$","$7a","upload-dispute-evidence",{"children":[["$","section",null,{"className":"y9a0do0","data-variant":"endpoint","children":["$","$L7b",null,{"responses":{"201":{"description":"Evidence uploaded successfully","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"The ID of the uploaded evidence.","examples":["ad2ca3d0-67e9-4cea-b455-e39dd319113d"],"descriptionNode":"$L28e"}},"required":["id"]},"examples":{"evidence_uploaded":{"summary":"Uploaded evidence","value":{"id":"121ac27c-b00a-44d0-9120-efeeec7c912d"}}}}},"descriptionNode":"$L28f"},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"code":{"type":"string","description":"An identifier that can be used to determine what went wrong.\n\nError codes are not globally unique, but uniqueness is guaranteed within endpoints.","descriptionNode":"$L290"},"message":{"type":"string","description":"Some human readable text describing what went wrong.","descriptionNode":"$L291"},"timestamp":{"type":"integer","description":"The [UNIX timestamp](https://www.unixtimestamp.com/) of the date and time the error happened.","descriptionNode":"$L292"}}},"examples":{"default":{"value":{"code":"bad_request","message":"Missing Revolut-Api-Version header","timestamp":1601296792533}}}}},"descriptionNode":"$L293"},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"code":{"type":"string","description":"An identifier that can be used to determine what went wrong.\n\nError codes are not globally unique, but uniqueness is guaranteed within endpoints.","descriptionNode":"$L294"},"message":{"type":"string","description":"Some human readable text describing what went wrong.","descriptionNode":"$L295"},"timestamp":{"type":"integer","description":"The [UNIX timestamp](https://www.unixtimestamp.com/) of the date and time the error happened.","descriptionNode":"$L296"}}},"examples":{"default":{"value":{"code":"unauthenticated","message":"Authentication failed","timestamp":1721049596461}}}}},"descriptionNode":"$L297"},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"code":{"type":"string","description":"An identifier that can be used to determine what went wrong.\n\nError codes are not globally unique, but uniqueness is guaranteed within endpoints.","descriptionNode":"$L298"},"message":{"type":"string","description":"Some human readable text describing what went wrong.","descriptionNode":"$L299"},"timestamp":{"type":"integer","description":"The [UNIX timestamp](https://www.unixtimestamp.com/) of the date and time the error happened.","descriptionNode":"$L29a"}}},"examples":{"default":{"value":{"code":"not_found","message":"The requested operation is forbidden","timestamp":1721050063886}}}}},"descriptionNode":"$L29b"},"404":{"description":"Not Found","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"code":{"type":"string","description":"An identifier that can be used to determine what went wrong.\n\nError codes are not globally unique, but uniqueness is guaranteed within endpoints.","descriptionNode":"$L29c"},"message":{"type":"string","description":"Some human readable text describing what went wrong.","descriptionNode":"$L29d"},"timestamp":{"type":"integer","description":"The [UNIX timestamp](https://www.unixtimestamp.com/) of the date and time the error happened.","descriptionNode":"$L29e"}}},"examples":{"default":{"value":{"code":"not_found","message":"The requested resource is not found","timestamp":1721050063886}}}}},"descriptionNode":"$L29f"},"422":{"description":"Unprocessable entity","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"code":{"type":"string","description":"An identifier that can be used to determine what went wrong.\n\nError codes are not globally unique, but uniqueness is guaranteed within endpoints.","descriptionNode":"$L2a0"},"message":{"type":"string","description":"Some human readable text describing what went wrong.","descriptionNode":"$L2a1"},"timestamp":{"type":"integer","description":"The [UNIX timestamp](https://www.unixtimestamp.com/) of the date and time the error happened.","descriptionNode":"$L2a2"}}}}},"descriptionNode":"$L2a3"}},"requestBody":{"required":true,"content":{"multipart/form-data":{"encoding":{"file":{"contentType":"application/pdf, image/png, image/jpeg"}},"schema":{"type":"object","properties":{"file":{"type":"string","description":"The single evidence file to upload.\n\nThe client must ensure this part has its own `Content-Type` header specifying the media type of the file (e.g., `application/pdf`, `image/png`, `image/jpeg`).\n\nMust be one of the allowed types: `PDF`, `PNG`, `JPEG`.","contentMediaType":"application/octet-stream","descriptionNode":"$L2a4"}},"required":["file"]}}}},"variantLabels":[],"children":["$L2a5","$L2a6"]}]}],false]}] 2a9:T47c,List of event types that the webhook is configured to listen to. Each event is related to status changes of a specific object in the Merchant API: | Object | Event types | | --------- | ----------- | | `Order` |
  • `ORDER_COMPLETED`
  • `ORDER_AUTHORISED`
  • `ORDER_CANCELLED`
  • `ORDER_FAILED`
  • `ORDER_INCREMENTAL_AUTHORISATION_AUTHORISED`
  • `ORDER_INCREMENTAL_AUTHORISATION_DECLINED`
  • `ORDER_INCREMENTAL_AUTHORISATION_FAILED`
| | `Payment` |
  • `ORDER_PAYMENT_AUTHENTICATION_CHALLENGED`
  • `ORDER_PAYMENT_AUTHENTICATED`
  • `ORDER_PAYMENT_AUTHORISATION_STARTED`
  • `ORDER_PAYMENT_DECLINED`
  • `ORDER_PAYMENT_FAILED`
| | `Subscription` |
  • `SUBSCRIPTION_INITIATED`
  • `SUBSCRIPTION_FINISHED`
  • `SUBSCRIPTION_CANCELLED`
  • `SUBSCRIPTION_OVERDUE`
| | `Payout` |
  • `PAYOUT_INITIATED`
  • `PAYOUT_COMPLETED`
  • `PAYOUT_FAILED`
| | `Dispute` |
  • `DISPUTE_ACTION_REQUIRED`
  • `DISPUTE_UNDER_REVIEW`
  • `DISPUTE_WON`
  • `DISPUTE_LOST`
|58:["$","$7a","retrieve-webhook-list",{"children":[["$","section",null,{"className":"y9a0do0","data-variant":"endpoint","children":["$","$L7b",null,{"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","required":["webhooks"],"properties":{"webhooks":{"type":"array","description":"List of webhooks.","maxItems":10,"items":{"title":"Webhook","type":"object","description":"A webhook object.\n\nUnlike the legacy API, `signing_secret` is included in all webhook responses, not only on creation.","properties":{"id":{"type":"string","format":"uuid","description":"The ID of the webhook.","descriptionNode":"$L2a7"},"url":{"type":"string","format":"uri","pattern":"^https?:\\/{2}.+/gi","maxLength":2000,"description":"Your webhook's URL to which event notifications will be sent. \n\nMust be a valid HTTP or HTTPS URL, capable of receiving `POST` requests.\n\n:::warning\nRestrictions:\n- Must be a valid URI as defined by [RFC 3986](https://datatracker.ietf.org/doc/html/rfc3986)\n- URI scheme is required and must be either `http` or `https`\n- URI host is required and cannot be `localhost` or an IP address\n- Max length: `2000`\n- Reserved or invalid characters must be percent-encoded (for example, use `%20` instead of a space)\n:::","descriptionNode":"$L2a8"},"events":{"type":"array","description":"$2a9","items":{"type":"string","description":"The available event types your can listen to.","enum":"$59:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:events:items:enum","descriptionNode":"$L2aa"},"minItems":1,"descriptionNode":"$L2ab"},"signing_secret":{"type":"string","description":"The signing secret for the webhook. Use it to verify the signature for the webhook request's payload.","descriptionNode":"$L2ac"}},"required":"$59:props:children:0:props:children:props:responses:200:content:application/json:schema:required","descriptionNode":"$L2ad"},"descriptionNode":"$L2ae"}}},"examples":{"list_of_webhooks":{"summary":"List of webhooks","value":{"webhooks":[{"id":"6fc8db62-6489-4470-a9e0-84b462fe3908","url":"https://revolut.com/webhooks","events":["ORDER_COMPLETED"]},{"id":"b466ab77-4932-4850-beb0-113bfc1166f8","url":"https://business.revolut.com/webhooks","events":["ORDER_COMPLETED","ORDER_AUTHORISED"]},{"id":"c6b981f4-53b3-47d5-9b24-4f87af1160eb","url":"https://example.com/webhooks","events":["ORDER_AUTHORISED","ORDER_COMPLETED"]}]}}}}},"descriptionNode":"$L2af"},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"code":{"type":"string","description":"An identifier that can be used to determine what went wrong.\n\nError codes are not globally unique, but uniqueness is guaranteed within endpoints.","descriptionNode":"$L2b0"},"message":{"type":"string","description":"Some human readable text describing what went wrong.","descriptionNode":"$L2b1"},"timestamp":{"type":"integer","description":"The [UNIX timestamp](https://www.unixtimestamp.com/) of the date and time the error happened.","descriptionNode":"$L2b2"}}}}},"descriptionNode":"$L2b3"}},"requestBody":"$undefined","variantLabels":[],"children":["$L2b4","$L2b5"]}]}],false]}] 1ce:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The ID of the webhook."}]]}] 1cf:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Your webhook's URL to which event notifications will be sent."}],"\n",["$","p","p-1",{"children":["Must be a valid HTTP or HTTPS URL, capable of receiving ",["$","code","code-0",{"children":"POST"}]," requests."]}],"\n",["$","div","inlinealert-0",{"data-type":"warning","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMark","color":"var(--rui-color-warning)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"Restrictions:"}],["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["Must be a valid URI as defined by ",["$","a","a-0",{"href":"https://datatracker.ietf.org/doc/html/rfc3986","target":"_blank","rel":"noreferrer","children":"RFC 3986"}]]}],"\n",["$","li","li-1",{"children":["URI scheme is required and must be either ",["$","code","code-0",{"children":"http"}]," or ",["$","code","code-1",{"children":"https"}]]}],"\n",["$","li","li-2",{"children":["URI host is required and cannot be ",["$","code","code-0",{"children":"localhost"}]," or an IP address"]}],"\n",["$","li","li-3",{"children":["Max length: ",["$","code","code-0",{"children":"2000"}]]}],"\n",["$","li","li-4",{"children":["Reserved or invalid characters must be percent-encoded (for example, use ",["$","code","code-0",{"children":"%20"}]," instead of a space)"]}],"\n"]}]]}]]}]]}] 1d1:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The available event types your can listen to."}]]}] 1d2:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"List of event types that the webhook is configured to listen to."}],"\n",["$","p","p-1",{"children":"Each event is related to status changes of a specific object in the Merchant API:"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Object","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Event types","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"Order"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["$","ul","ul-0",{"children":[" ",["$","li","li-0",{"children":["$","code","code-0",{"children":"ORDER_COMPLETED"}]}]," ",["$","li","li-1",{"children":["$","code","code-0",{"children":"ORDER_AUTHORISED"}]}]," ",["$","li","li-2",{"children":["$","code","code-0",{"children":"ORDER_CANCELLED"}]}]," ",["$","li","li-3",{"children":["$","code","code-0",{"children":"ORDER_FAILED"}]}]," ",["$","li","li-4",{"children":["$","code","code-0",{"children":"ORDER_INCREMENTAL_AUTHORISATION_AUTHORISED"}]}]," ",["$","li","li-5",{"children":["$","code","code-0",{"children":"ORDER_INCREMENTAL_AUTHORISATION_DECLINED"}]}]," ",["$","li","li-6",{"children":["$","code","code-0",{"children":"ORDER_INCREMENTAL_AUTHORISATION_FAILED"}]}]," "]}],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"Payment"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["$","ul","ul-0",{"children":[" ",["$","li","li-0",{"children":["$","code","code-0",{"children":"ORDER_PAYMENT_AUTHENTICATION_CHALLENGED"}]}]," ",["$","li","li-1",{"children":["$","code","code-0",{"children":"ORDER_PAYMENT_AUTHENTICATED"}]}]," ",["$","li","li-2",{"children":["$","code","code-0",{"children":"ORDER_PAYMENT_AUTHORISATION_STARTED"}]}]," ",["$","li","li-3",{"children":["$","code","code-0",{"children":"ORDER_PAYMENT_DECLINED"}]}]," ",["$","li","li-4",{"children":["$","code","code-0",{"children":"ORDER_PAYMENT_FAILED"}]}]," "]}],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"Subscription"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["$","ul","ul-0",{"children":[" ",["$","li","li-0",{"children":["$","code","code-0",{"children":"SUBSCRIPTION_INITIATED"}]}]," ",["$","li","li-1",{"children":["$","code","code-0",{"children":"SUBSCRIPTION_FINISHED"}]}]," ",["$","li","li-2",{"children":["$","code","code-0",{"children":"SUBSCRIPTION_CANCELLED"}]}]," ",["$","li","li-3",{"children":["$","code","code-0",{"children":"SUBSCRIPTION_OVERDUE"}]}]]}],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"Payout"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["$","ul","ul-0",{"children":[" ",["$","li","li-0",{"children":["$","code","code-0",{"children":"PAYOUT_INITIATED"}]}]," ",["$","li","li-1",{"children":["$","code","code-0",{"children":"PAYOUT_COMPLETED"}]}]," ",["$","li","li-2",{"children":["$","code","code-0",{"children":"PAYOUT_FAILED"}]}]," "]}],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-4",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"Dispute"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["$","ul","ul-0",{"children":[" ",["$","li","li-0",{"children":["$","code","code-0",{"children":"DISPUTE_ACTION_REQUIRED"}]}]," ",["$","li","li-1",{"children":["$","code","code-0",{"children":"DISPUTE_UNDER_REVIEW"}]}]," ",["$","li","li-2",{"children":["$","code","code-0",{"children":"DISPUTE_WON"}]}]," ",["$","li","li-3",{"children":["$","code","code-0",{"children":"DISPUTE_LOST"}]}]]}],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 1d3:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The signing secret for the webhook. Use it to verify the signature for the webhook request's payload."}]]}] 1d4:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A webhook object."}],"\n",["$","p","p-1",{"children":["Unlike the legacy API, ",["$","code","code-0",{"children":"signing_secret"}]," is included in all webhook responses, not only on creation."]}]]}] 211:"Retrieve a payout" 276:["$","$L10d",null,{"security":[{"Api-Key":[]}],"authorization":{"Api-Key":{"type":"apiKey","in":"header","name":"Authorization","description":"Each Merchant API request must contain an authorization header in the following format:\n\n```\n'Authorization: Bearer '\n```\n\nTo use this API, you need to generate API keys from your Revolut Business account. The Secret key is used in the authorization header for all server calls, while the Public key is provided with payment methods at checkout.\n\n:::info\nFor detailed instructions on generating your API keys, see: [Generate API keys](https://developer.revolut.com/docs/guides/merchant/get-started#generate-api-keys).\n:::","descriptionNode":"$L2b6"}}}] 277:["$","$L10f",null,{"exampleBlocks":{},"title":"Request body samples","headingAs":"h4"}] 278:["$","$L110",null,{"exampleBlocks":{"200":{"application/json":{"variants":[{"key":"example_without_location","label":"List of synchronous webhooks","rawValue":"$6e:props:children:0:props:children:props:responses:200:content:application/json:examples:example_without_location:value","block":"$L2b7"}],"syncedPropertyName":"$undefined"}},"400":{"application/json":{"variants":[{"key":"default","label":"Example","rawValue":{"errorId":"string","timestamp":123},"block":"$L2b8"}],"syncedPropertyName":"$undefined"}},"401":{}},"headingAs":"h4"}] 28b:["$","$L10d",null,{"security":[{"Api-Key":[]}],"authorization":{"Api-Key":{"type":"apiKey","in":"header","name":"Authorization","description":"Each Merchant API request must contain an authorization header in the following format:\n\n```\n'Authorization: Bearer '\n```\n\nTo use this API, you need to generate API keys from your Revolut Business account. The Secret key is used in the authorization header for all server calls, while the Public key is provided with payment methods at checkout.\n\n:::info\nFor detailed instructions on generating your API keys, see: [Generate API keys](https://developer.revolut.com/docs/guides/merchant/get-started#generate-api-keys).\n:::","descriptionNode":"$L2b9"}}}] 28c:["$","$L10f",null,{"exampleBlocks":{"application/json":{"variants":[{"key":"simple_plan","label":"Update renewal date","rawValue":"$38:props:children:0:props:children:props:requestBody:content:application/json:examples:simple_plan:value","block":"$L2ba"}],"syncedPropertyName":"$undefined"}},"title":"Request body samples","headingAs":"h4"}] 28d:["$","$L110",null,{"exampleBlocks":{"204":{},"400":{"application/json":{"variants":[{"key":"default","label":"Example","rawValue":{"code":"string","message":"string","timestamp":123},"block":"$L2bb"}],"syncedPropertyName":"$undefined"}},"401":{"application/json":{"variants":[{"key":"default","label":"Example","rawValue":{"code":"string","message":"string","timestamp":123},"block":"$L2bc"}],"syncedPropertyName":"$undefined"}},"404":{"application/json":{"variants":[{"key":"default","label":"Example","rawValue":{"code":"string","message":"string","timestamp":123},"block":"$L2bd"}],"syncedPropertyName":"$undefined"}},"422":{"application/json":{"variants":[{"key":"subscription_finished","label":"Subscription is finished","rawValue":"$38:props:children:0:props:children:props:responses:422:content:application/json:examples:subscription_finished:value","block":"$L2be"},{"key":"next_cycle_exists","label":"Next cycle already exists","rawValue":"$38:props:children:0:props:children:props:responses:422:content:application/json:examples:next_cycle_exists:value","block":"$L2bf"},{"key":"end_date_too_early","label":"Renewal date is too early","rawValue":"$38:props:children:0:props:children:props:responses:422:content:application/json:examples:end_date_too_early:value","block":"$L2c0"},{"key":"end_date_too_far","label":"Renewal date is too far in the future","rawValue":"$38:props:children:0:props:children:props:responses:422:content:application/json:examples:end_date_too_far:value","block":"$L2c1"}],"syncedPropertyName":"$undefined"}},"default":{"application/json":{"variants":[{"key":"default","label":"Example","rawValue":{"code":"string","message":"string","timestamp":123},"block":"$L2c2"}],"syncedPropertyName":"$undefined"}}},"headingAs":"h4"}] 2a5:["$","div",null,{"className":"ezz1n30","children":[["$","div",null,{"data-header":"$undefined","className":"ezz1n31","children":["$","div",null,{"className":"y9a0do1","children":[["$","h2",null,{"id":"upload-dispute-evidence","children":[["$L2c3","$undefined"],["$","$L15",null,{"id":"upload-dispute-evidence"}]]}],["$","$L16",null,{"url":"/docs/api/merchant/2025-10-16/operations/upload-dispute-evidence.md"}]]}]}],"$undefined"]}] 2ca:T4b5,
curl -X POST "https://merchant.revolut.com/api/disputes/__RP_TOK_0__/evidences" \
  -H "Authorization: __RP_TOK_1__" \
  -H "Revolut-Api-Version: __RP_TOK_2__" \
  -H "Content-Type: __RP_TOK_3__"
2cb:Tafb,
fetch("https://merchant.revolut.com/api/disputes/__RP_TOK_0__/evidences", {
  method: "POST",
  headers: {
    "Authorization": "__RP_TOK_1__",
    "Revolut-Api-Version": "__RP_TOK_2__",
    "Content-Type": "__RP_TOK_3__"
  }
})
  .then(response => response.json())
  .then(data => console.log(data));
2cc:T114d,
package main

import (
  "fmt"
  "net/http"
)

func main() {
  url := "https://merchant.revolut.com/api/disputes/__RP_TOK_0__/evidences"
  req, _ := http.NewRequest("POST", url, nil)
  req.Header.Add("Authorization", "__RP_TOK_1__")
  req.Header.Add("Revolut-Api-Version", "__RP_TOK_2__")
  req.Header.Add("Content-Type", "__RP_TOK_3__")

  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  fmt.Println(res)
}
2cd:T90b,
import requests

url = "https://merchant.revolut.com/api/disputes/__RP_TOK_0__/evidences"
headers = {
  "Authorization": "__RP_TOK_1__",
  "Revolut-Api-Version": "__RP_TOK_2__",
  "Content-Type": "__RP_TOK_3__"
}

response = requests.post(url, headers=headers)
print(response.json())
2ce:T18eb,
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;

public class Main {
  public static void main(String[] args) {
    HttpClient client = HttpClient.newHttpClient();
    HttpRequest request = HttpRequest.newBuilder()
      .uri(URI.create("https://merchant.revolut.com/api/disputes/__RP_TOK_0__/evidences"))
      .header("Authorization", "__RP_TOK_1__")
      .header("Revolut-Api-Version", "__RP_TOK_2__")
      .header("Content-Type", "__RP_TOK_3__")
      .POST(HttpRequest.BodyPublishers.noBody())
      .build();

    client.sendAsync(request, HttpResponse.BodyHandlers.ofString())
      .thenApply(HttpResponse::body)
      .thenAccept(System.out::println)
      .join();
  }
}
2cf:T15c5,
using System.Net.Http;
using System.Net.Http.Headers;

var client = new HttpClient();
var request = new HttpRequestMessage
{
  Method = HttpMethod.Post,
  RequestUri = new Uri("https://merchant.revolut.com/api/disputes/__RP_TOK_0__/evidences"),
  Headers =
  {
    { "Authorization", "__RP_TOK_1__" },
    { "Revolut-Api-Version", "__RP_TOK_2__" },
  }
};

using (var response = await client.SendAsync(request))
{
  response.EnsureSuccessStatusCode();
  var body = await response.Content.ReadAsStringAsync();
  Console.WriteLine(body);
}
2d0:T4bd,
curl -X POST "https://sandbox-merchant.revolut.com/api/disputes/__RP_TOK_0__/evidences" \
  -H "Authorization: __RP_TOK_1__" \
  -H "Revolut-Api-Version: __RP_TOK_2__" \
  -H "Content-Type: __RP_TOK_3__"
2d1:Tb03,
fetch("https://sandbox-merchant.revolut.com/api/disputes/__RP_TOK_0__/evidences", {
  method: "POST",
  headers: {
    "Authorization": "__RP_TOK_1__",
    "Revolut-Api-Version": "__RP_TOK_2__",
    "Content-Type": "__RP_TOK_3__"
  }
})
  .then(response => response.json())
  .then(data => console.log(data));
2d2:T1155,
package main

import (
  "fmt"
  "net/http"
)

func main() {
  url := "https://sandbox-merchant.revolut.com/api/disputes/__RP_TOK_0__/evidences"
  req, _ := http.NewRequest("POST", url, nil)
  req.Header.Add("Authorization", "__RP_TOK_1__")
  req.Header.Add("Revolut-Api-Version", "__RP_TOK_2__")
  req.Header.Add("Content-Type", "__RP_TOK_3__")

  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  fmt.Println(res)
}
2d3:T913,
import requests

url = "https://sandbox-merchant.revolut.com/api/disputes/__RP_TOK_0__/evidences"
headers = {
  "Authorization": "__RP_TOK_1__",
  "Revolut-Api-Version": "__RP_TOK_2__",
  "Content-Type": "__RP_TOK_3__"
}

response = requests.post(url, headers=headers)
print(response.json())
2d4:T18f3,
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;

public class Main {
  public static void main(String[] args) {
    HttpClient client = HttpClient.newHttpClient();
    HttpRequest request = HttpRequest.newBuilder()
      .uri(URI.create("https://sandbox-merchant.revolut.com/api/disputes/__RP_TOK_0__/evidences"))
      .header("Authorization", "__RP_TOK_1__")
      .header("Revolut-Api-Version", "__RP_TOK_2__")
      .header("Content-Type", "__RP_TOK_3__")
      .POST(HttpRequest.BodyPublishers.noBody())
      .build();

    client.sendAsync(request, HttpResponse.BodyHandlers.ofString())
      .thenApply(HttpResponse::body)
      .thenAccept(System.out::println)
      .join();
  }
}
2d5:T15cd,
using System.Net.Http;
using System.Net.Http.Headers;

var client = new HttpClient();
var request = new HttpRequestMessage
{
  Method = HttpMethod.Post,
  RequestUri = new Uri("https://sandbox-merchant.revolut.com/api/disputes/__RP_TOK_0__/evidences"),
  Headers =
  {
    { "Authorization", "__RP_TOK_1__" },
    { "Revolut-Api-Version", "__RP_TOK_2__" },
  }
};

using (var response = await client.SendAsync(request))
{
  response.EnsureSuccessStatusCode();
  var body = await response.Content.ReadAsStringAsync();
  Console.WriteLine(body);
}
2a6:["$","div",null,{"className":"ezz1n30","children":[["$","div",null,{"data-header":"$undefined","className":"ezz1n31","children":["$L2c4",["$","$L85",null,{"parameters":[{"name":"Authorization","in":"header","schema":{"type":"string","format":"Bearer ","examples":"$62:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:0:schema:examples"},"required":true,"description":"This parameter accepts the [Merchant API Secret key](https://business.revolut.com/settings/apis?tab=merchant-api) to authorise requests coming from the merchant's backend. \n\nIt ensures that ensures that each request is authenticated and authorised by verifying the secret key. The secret key should be included in all request headers as a `Bearer` token.\n\n:::info\nFor more information, see: [Authentication](https://developer.revolut.com/docs/api/merchant#authentication)\n:::","descriptionNode":"$L2c5"},{"name":"Revolut-Api-Version","in":"header","schema":{"type":"string","format":"date","enum":"$36:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:1:schema:enum","examples":"$36:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:1:schema:examples"},"required":true,"description":"The version of the Merchant API, specified in `YYYY-MM-DD` format.\n\nIf not specified, you will receive an error.\n\n\n:::info\nFor more information about API versioning, see: [API versions](https://developer.revolut.com/docs/guides/merchant/reference/versioning/api-versions).\n:::","x-config-always-visible-in-example":true,"example":"2025-10-16","descriptionNode":"$L2c6"},{"name":"Content-Type","in":"header","required":true,"schema":{"type":"string"},"description":"The content type sent in the request.","examples":{"default":{"value":"multipart/form-data"}},"descriptionNode":"$L2c7"},{"name":"dispute_id","in":"path","schema":{"type":"string","format":"uuid","description":"A UUID string, typically used to identify resources.","descriptionNode":"$L2c8"},"required":true,"description":"The ID of the `Dispute` object.","descriptionNode":"$L2c9"}],"requestBody":"$47:props:children:0:props:children:props:requestBody","heading":"Request","requestBodySchemaTitle":"Request body","headingAs":"h3"}],["$","$L89",null,{"responses":"$47:props:children:0:props:children:props:responses","headingAs":"h3"}]]}],["$","div",null,{"className":"ezz1n32","children":[[["$","$L8a",null,{"itemsByServer":{"https://merchant.revolut.com":[{"id":"curl","label":"cURL","templateCode":"curl -X POST \"https://merchant.revolut.com/api/disputes/__RP_TOK_0__/evidences\" \\\n -H \"Authorization: __RP_TOK_1__\" \\\n -H \"Revolut-Api-Version: __RP_TOK_2__\" \\\n -H \"Content-Type: __RP_TOK_3__\"","templateHtml":"$2ca","tokens":[{"marker":"__RP_TOK_0__","paramName":"dispute_id","paramIn":"path","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_3__","paramName":"Content-Type","paramIn":"header","pipeline":["shell-double-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","header:Content-Type":"string","path:dispute_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"javascript","label":"JavaScript","templateCode":"fetch(\"https://merchant.revolut.com/api/disputes/__RP_TOK_0__/evidences\", {\n method: \"POST\",\n headers: {\n \"Authorization\": \"__RP_TOK_1__\",\n \"Revolut-Api-Version\": \"__RP_TOK_2__\",\n \"Content-Type\": \"__RP_TOK_3__\"\n }\n})\n .then(response => response.json())\n .then(data => console.log(data));","templateHtml":"$2cb","tokens":[{"marker":"__RP_TOK_0__","paramName":"dispute_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_3__","paramName":"Content-Type","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","header:Content-Type":"string","path:dispute_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"go","label":"Go","templateCode":"package main\n\nimport (\n \"fmt\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://merchant.revolut.com/api/disputes/__RP_TOK_0__/evidences\"\n req, _ := http.NewRequest(\"POST\", url, nil)\n req.Header.Add(\"Authorization\", \"__RP_TOK_1__\")\n req.Header.Add(\"Revolut-Api-Version\", \"__RP_TOK_2__\")\n req.Header.Add(\"Content-Type\", \"__RP_TOK_3__\")\n\n res, _ := http.DefaultClient.Do(req)\n defer res.Body.Close()\n fmt.Println(res)\n}","templateHtml":"$2cc","tokens":[{"marker":"__RP_TOK_0__","paramName":"dispute_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_3__","paramName":"Content-Type","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","header:Content-Type":"string","path:dispute_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"python","label":"Python","templateCode":"import requests\n\nurl = \"https://merchant.revolut.com/api/disputes/__RP_TOK_0__/evidences\"\nheaders = {\n \"Authorization\": \"__RP_TOK_1__\",\n \"Revolut-Api-Version\": \"__RP_TOK_2__\",\n \"Content-Type\": \"__RP_TOK_3__\"\n}\n\nresponse = requests.post(url, headers=headers)\nprint(response.json())","templateHtml":"$2cd","tokens":[{"marker":"__RP_TOK_0__","paramName":"dispute_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_3__","paramName":"Content-Type","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","header:Content-Type":"string","path:dispute_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"java","label":"Java","templateCode":"import java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\nimport java.net.URI;\n\npublic class Main {\n public static void main(String[] args) {\n HttpClient client = HttpClient.newHttpClient();\n HttpRequest request = HttpRequest.newBuilder()\n .uri(URI.create(\"https://merchant.revolut.com/api/disputes/__RP_TOK_0__/evidences\"))\n .header(\"Authorization\", \"__RP_TOK_1__\")\n .header(\"Revolut-Api-Version\", \"__RP_TOK_2__\")\n .header(\"Content-Type\", \"__RP_TOK_3__\")\n .POST(HttpRequest.BodyPublishers.noBody())\n .build();\n\n client.sendAsync(request, HttpResponse.BodyHandlers.ofString())\n .thenApply(HttpResponse::body)\n .thenAccept(System.out::println)\n .join();\n }\n}","templateHtml":"$2ce","tokens":[{"marker":"__RP_TOK_0__","paramName":"dispute_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_3__","paramName":"Content-Type","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","header:Content-Type":"string","path:dispute_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"csharp","label":"C#","templateCode":"using System.Net.Http;\nusing System.Net.Http.Headers;\n\nvar client = new HttpClient();\nvar request = new HttpRequestMessage\n{\n Method = HttpMethod.Post,\n RequestUri = new Uri(\"https://merchant.revolut.com/api/disputes/__RP_TOK_0__/evidences\"),\n Headers =\n {\n { \"Authorization\", \"__RP_TOK_1__\" },\n { \"Revolut-Api-Version\", \"__RP_TOK_2__\" },\n }\n};\n\nusing (var response = await client.SendAsync(request))\n{\n response.EnsureSuccessStatusCode();\n var body = await response.Content.ReadAsStringAsync();\n Console.WriteLine(body);\n}","templateHtml":"$2cf","tokens":[{"marker":"__RP_TOK_0__","paramName":"dispute_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_3__","paramName":"Content-Type","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","header:Content-Type":"string","path:dispute_id":"123e4567-e89b-12d3-a456-426614174000"}}],"https://sandbox-merchant.revolut.com":[{"id":"curl","label":"cURL","templateCode":"curl -X POST \"https://sandbox-merchant.revolut.com/api/disputes/__RP_TOK_0__/evidences\" \\\n -H \"Authorization: __RP_TOK_1__\" \\\n -H \"Revolut-Api-Version: __RP_TOK_2__\" \\\n -H \"Content-Type: __RP_TOK_3__\"","templateHtml":"$2d0","tokens":[{"marker":"__RP_TOK_0__","paramName":"dispute_id","paramIn":"path","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_3__","paramName":"Content-Type","paramIn":"header","pipeline":["shell-double-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","header:Content-Type":"string","path:dispute_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"javascript","label":"JavaScript","templateCode":"fetch(\"https://sandbox-merchant.revolut.com/api/disputes/__RP_TOK_0__/evidences\", {\n method: \"POST\",\n headers: {\n \"Authorization\": \"__RP_TOK_1__\",\n \"Revolut-Api-Version\": \"__RP_TOK_2__\",\n \"Content-Type\": \"__RP_TOK_3__\"\n }\n})\n .then(response => response.json())\n .then(data => console.log(data));","templateHtml":"$2d1","tokens":[{"marker":"__RP_TOK_0__","paramName":"dispute_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_3__","paramName":"Content-Type","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","header:Content-Type":"string","path:dispute_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"go","label":"Go","templateCode":"package main\n\nimport (\n \"fmt\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://sandbox-merchant.revolut.com/api/disputes/__RP_TOK_0__/evidences\"\n req, _ := http.NewRequest(\"POST\", url, nil)\n req.Header.Add(\"Authorization\", \"__RP_TOK_1__\")\n req.Header.Add(\"Revolut-Api-Version\", \"__RP_TOK_2__\")\n req.Header.Add(\"Content-Type\", \"__RP_TOK_3__\")\n\n res, _ := http.DefaultClient.Do(req)\n defer res.Body.Close()\n fmt.Println(res)\n}","templateHtml":"$2d2","tokens":[{"marker":"__RP_TOK_0__","paramName":"dispute_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_3__","paramName":"Content-Type","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","header:Content-Type":"string","path:dispute_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"python","label":"Python","templateCode":"import requests\n\nurl = \"https://sandbox-merchant.revolut.com/api/disputes/__RP_TOK_0__/evidences\"\nheaders = {\n \"Authorization\": \"__RP_TOK_1__\",\n \"Revolut-Api-Version\": \"__RP_TOK_2__\",\n \"Content-Type\": \"__RP_TOK_3__\"\n}\n\nresponse = requests.post(url, headers=headers)\nprint(response.json())","templateHtml":"$2d3","tokens":[{"marker":"__RP_TOK_0__","paramName":"dispute_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_3__","paramName":"Content-Type","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","header:Content-Type":"string","path:dispute_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"java","label":"Java","templateCode":"import java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\nimport java.net.URI;\n\npublic class Main {\n public static void main(String[] args) {\n HttpClient client = HttpClient.newHttpClient();\n HttpRequest request = HttpRequest.newBuilder()\n .uri(URI.create(\"https://sandbox-merchant.revolut.com/api/disputes/__RP_TOK_0__/evidences\"))\n .header(\"Authorization\", \"__RP_TOK_1__\")\n .header(\"Revolut-Api-Version\", \"__RP_TOK_2__\")\n .header(\"Content-Type\", \"__RP_TOK_3__\")\n .POST(HttpRequest.BodyPublishers.noBody())\n .build();\n\n client.sendAsync(request, HttpResponse.BodyHandlers.ofString())\n .thenApply(HttpResponse::body)\n .thenAccept(System.out::println)\n .join();\n }\n}","templateHtml":"$2d4","tokens":[{"marker":"__RP_TOK_0__","paramName":"dispute_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_3__","paramName":"Content-Type","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","header:Content-Type":"string","path:dispute_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"csharp","label":"C#","templateCode":"using System.Net.Http;\nusing System.Net.Http.Headers;\n\nvar client = new HttpClient();\nvar request = new HttpRequestMessage\n{\n Method = HttpMethod.Post,\n RequestUri = new Uri(\"https://sandbox-merchant.revolut.com/api/disputes/__RP_TOK_0__/evidences\"),\n Headers =\n {\n { \"Authorization\", \"__RP_TOK_1__\" },\n { \"Revolut-Api-Version\", \"__RP_TOK_2__\" },\n }\n};\n\nusing (var response = await client.SendAsync(request))\n{\n response.EnsureSuccessStatusCode();\n var body = await response.Content.ReadAsStringAsync();\n Console.WriteLine(body);\n}","templateHtml":"$2d5","tokens":[{"marker":"__RP_TOK_0__","paramName":"dispute_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_3__","paramName":"Content-Type","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","header:Content-Type":"string","path:dispute_id":"123e4567-e89b-12d3-a456-426614174000"}}]},"method":"post","servers":"$62:props:children:0:props:children:props:children:1:props:children:1:props:children:0:0:props:servers","path":"/api/disputes/{dispute_id}/evidences","parameters":["$2a6:props:children:0:props:children:1:props:parameters:0","$2a6:props:children:0:props:children:1:props:parameters:1","$2a6:props:children:0:props:children:1:props:parameters:2","$2a6:props:children:0:props:children:1:props:parameters:3"]}],"$L2d6"],"$L2d7","$L2d8"]}]]}] 2b4:["$","div",null,{"className":"ezz1n30","children":[["$","div",null,{"data-header":"$undefined","className":"ezz1n31","children":["$","div",null,{"className":"y9a0do1","children":[["$","h2",null,{"id":"retrieve-webhook-list","children":[["$L2d9","$undefined"],["$","$L15",null,{"id":"retrieve-webhook-list"}]]}],["$","$L16",null,{"url":"/docs/api/merchant/2025-10-16/operations/retrieve-webhook-list.md"}]]}]}],"$undefined"]}] 2dd:T9c5,
fetch("https://merchant.revolut.com/api/webhooks", {
  method: "GET",
  headers: {
    "Authorization": "__RP_TOK_0__",
    "Revolut-Api-Version": "__RP_TOK_1__"
  }
})
  .then(response => response.json())
  .then(data => console.log(data));
2de:Tf62,
package main

import (
  "fmt"
  "net/http"
)

func main() {
  url := "https://merchant.revolut.com/api/webhooks"
  req, _ := http.NewRequest("GET", url, nil)
  req.Header.Add("Authorization", "__RP_TOK_0__")
  req.Header.Add("Revolut-Api-Version", "__RP_TOK_1__")

  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  fmt.Println(res)
}
2df:T7d7,
import requests

url = "https://merchant.revolut.com/api/webhooks"
headers = {
  "Authorization": "__RP_TOK_0__",
  "Revolut-Api-Version": "__RP_TOK_1__"
}

response = requests.get(url, headers=headers)
print(response.json())
2e0:T1703,
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;

public class Main {
  public static void main(String[] args) {
    HttpClient client = HttpClient.newHttpClient();
    HttpRequest request = HttpRequest.newBuilder()
      .uri(URI.create("https://merchant.revolut.com/api/webhooks"))
      .header("Authorization", "__RP_TOK_0__")
      .header("Revolut-Api-Version", "__RP_TOK_1__")
      .GET(HttpRequest.BodyPublishers.noBody())
      .build();

    client.sendAsync(request, HttpResponse.BodyHandlers.ofString())
      .thenApply(HttpResponse::body)
      .thenAccept(System.out::println)
      .join();
  }
}
2e1:T15ad,
using System.Net.Http;
using System.Net.Http.Headers;

var client = new HttpClient();
var request = new HttpRequestMessage
{
  Method = HttpMethod.Get,
  RequestUri = new Uri("https://merchant.revolut.com/api/webhooks"),
  Headers =
  {
    { "Authorization", "__RP_TOK_0__" },
    { "Revolut-Api-Version", "__RP_TOK_1__" },
  }
};

using (var response = await client.SendAsync(request))
{
  response.EnsureSuccessStatusCode();
  var body = await response.Content.ReadAsStringAsync();
  Console.WriteLine(body);
}
2e2:T9cd,
fetch("https://sandbox-merchant.revolut.com/api/webhooks", {
  method: "GET",
  headers: {
    "Authorization": "__RP_TOK_0__",
    "Revolut-Api-Version": "__RP_TOK_1__"
  }
})
  .then(response => response.json())
  .then(data => console.log(data));
2e3:Tf6a,
package main

import (
  "fmt"
  "net/http"
)

func main() {
  url := "https://sandbox-merchant.revolut.com/api/webhooks"
  req, _ := http.NewRequest("GET", url, nil)
  req.Header.Add("Authorization", "__RP_TOK_0__")
  req.Header.Add("Revolut-Api-Version", "__RP_TOK_1__")

  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  fmt.Println(res)
}
2e4:T7df,
import requests

url = "https://sandbox-merchant.revolut.com/api/webhooks"
headers = {
  "Authorization": "__RP_TOK_0__",
  "Revolut-Api-Version": "__RP_TOK_1__"
}

response = requests.get(url, headers=headers)
print(response.json())
2e5:T170b,
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;

public class Main {
  public static void main(String[] args) {
    HttpClient client = HttpClient.newHttpClient();
    HttpRequest request = HttpRequest.newBuilder()
      .uri(URI.create("https://sandbox-merchant.revolut.com/api/webhooks"))
      .header("Authorization", "__RP_TOK_0__")
      .header("Revolut-Api-Version", "__RP_TOK_1__")
      .GET(HttpRequest.BodyPublishers.noBody())
      .build();

    client.sendAsync(request, HttpResponse.BodyHandlers.ofString())
      .thenApply(HttpResponse::body)
      .thenAccept(System.out::println)
      .join();
  }
}
2e6:T15b5,
using System.Net.Http;
using System.Net.Http.Headers;

var client = new HttpClient();
var request = new HttpRequestMessage
{
  Method = HttpMethod.Get,
  RequestUri = new Uri("https://sandbox-merchant.revolut.com/api/webhooks"),
  Headers =
  {
    { "Authorization", "__RP_TOK_0__" },
    { "Revolut-Api-Version", "__RP_TOK_1__" },
  }
};

using (var response = await client.SendAsync(request))
{
  response.EnsureSuccessStatusCode();
  var body = await response.Content.ReadAsStringAsync();
  Console.WriteLine(body);
}
2b5:["$","div",null,{"className":"ezz1n30","children":[["$","div",null,{"data-header":"$undefined","className":"ezz1n31","children":["$L2da",["$","$L85",null,{"parameters":[{"name":"Authorization","in":"header","schema":{"type":"string","format":"Bearer ","examples":"$62:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:0:schema:examples"},"required":true,"description":"This parameter accepts the [Merchant API Secret key](https://business.revolut.com/settings/apis?tab=merchant-api) to authorise requests coming from the merchant's backend. \n\nIt ensures that ensures that each request is authenticated and authorised by verifying the secret key. The secret key should be included in all request headers as a `Bearer` token.\n\n:::info\nFor more information, see: [Authentication](https://developer.revolut.com/docs/api/merchant#authentication)\n:::","descriptionNode":"$L2db"},{"name":"Revolut-Api-Version","in":"header","schema":{"type":"string","format":"date","enum":"$27:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:1:schema:enum","examples":"$27:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:1:schema:examples"},"required":true,"description":"The version of the Merchant API, specified in `YYYY-MM-DD` format.\n\nThis endpoint is available from version `2024-09-01`. If a version earlier than `2024-09-01` is provided, the endpoint returns a `404` response.\n\nIf not specified, you will receive an error.\n\n\n:::info\nFor more information about API versioning, see: [API versions](https://developer.revolut.com/docs/guides/merchant/reference/versioning/api-versions).\n:::","x-config-always-visible-in-example":true,"example":"2025-10-16","descriptionNode":"$L2dc"}],"requestBody":"$undefined","heading":"Request","requestBodySchemaTitle":"Request body","headingAs":"h3"}],["$","$L89",null,{"responses":"$58:props:children:0:props:children:props:responses","headingAs":"h3"}]]}],["$","div",null,{"className":"ezz1n32","children":[[["$","$L8a",null,{"itemsByServer":{"https://merchant.revolut.com":[{"id":"curl","label":"cURL","templateCode":"curl -X GET \"https://merchant.revolut.com/api/webhooks\" \\\n -H \"Authorization: __RP_TOK_0__\" \\\n -H \"Revolut-Api-Version: __RP_TOK_1__\"","templateHtml":"
curl -X GET \"https://merchant.revolut.com/api/webhooks\" \\\n  -H \"Authorization: __RP_TOK_0__\" \\\n  -H \"Revolut-Api-Version: __RP_TOK_1__\"
","tokens":[{"marker":"__RP_TOK_0__","paramName":"Authorization","paramIn":"header","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_1__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["shell-double-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16"}},{"id":"javascript","label":"JavaScript","templateCode":"fetch(\"https://merchant.revolut.com/api/webhooks\", {\n method: \"GET\",\n headers: {\n \"Authorization\": \"__RP_TOK_0__\",\n \"Revolut-Api-Version\": \"__RP_TOK_1__\"\n }\n})\n .then(response => response.json())\n .then(data => console.log(data));","templateHtml":"$2dd","tokens":[{"marker":"__RP_TOK_0__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16"}},{"id":"go","label":"Go","templateCode":"package main\n\nimport (\n \"fmt\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://merchant.revolut.com/api/webhooks\"\n req, _ := http.NewRequest(\"GET\", url, nil)\n req.Header.Add(\"Authorization\", \"__RP_TOK_0__\")\n req.Header.Add(\"Revolut-Api-Version\", \"__RP_TOK_1__\")\n\n res, _ := http.DefaultClient.Do(req)\n defer res.Body.Close()\n fmt.Println(res)\n}","templateHtml":"$2de","tokens":[{"marker":"__RP_TOK_0__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16"}},{"id":"python","label":"Python","templateCode":"import requests\n\nurl = \"https://merchant.revolut.com/api/webhooks\"\nheaders = {\n \"Authorization\": \"__RP_TOK_0__\",\n \"Revolut-Api-Version\": \"__RP_TOK_1__\"\n}\n\nresponse = requests.get(url, headers=headers)\nprint(response.json())","templateHtml":"$2df","tokens":[{"marker":"__RP_TOK_0__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16"}},{"id":"java","label":"Java","templateCode":"import java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\nimport java.net.URI;\n\npublic class Main {\n public static void main(String[] args) {\n HttpClient client = HttpClient.newHttpClient();\n HttpRequest request = HttpRequest.newBuilder()\n .uri(URI.create(\"https://merchant.revolut.com/api/webhooks\"))\n .header(\"Authorization\", \"__RP_TOK_0__\")\n .header(\"Revolut-Api-Version\", \"__RP_TOK_1__\")\n .GET(HttpRequest.BodyPublishers.noBody())\n .build();\n\n client.sendAsync(request, HttpResponse.BodyHandlers.ofString())\n .thenApply(HttpResponse::body)\n .thenAccept(System.out::println)\n .join();\n }\n}","templateHtml":"$2e0","tokens":[{"marker":"__RP_TOK_0__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16"}},{"id":"csharp","label":"C#","templateCode":"using System.Net.Http;\nusing System.Net.Http.Headers;\n\nvar client = new HttpClient();\nvar request = new HttpRequestMessage\n{\n Method = HttpMethod.Get,\n RequestUri = new Uri(\"https://merchant.revolut.com/api/webhooks\"),\n Headers =\n {\n { \"Authorization\", \"__RP_TOK_0__\" },\n { \"Revolut-Api-Version\", \"__RP_TOK_1__\" },\n }\n};\n\nusing (var response = await client.SendAsync(request))\n{\n response.EnsureSuccessStatusCode();\n var body = await response.Content.ReadAsStringAsync();\n Console.WriteLine(body);\n}","templateHtml":"$2e1","tokens":[{"marker":"__RP_TOK_0__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16"}}],"https://sandbox-merchant.revolut.com":[{"id":"curl","label":"cURL","templateCode":"curl -X GET \"https://sandbox-merchant.revolut.com/api/webhooks\" \\\n -H \"Authorization: __RP_TOK_0__\" \\\n -H \"Revolut-Api-Version: __RP_TOK_1__\"","templateHtml":"
curl -X GET \"https://sandbox-merchant.revolut.com/api/webhooks\" \\\n  -H \"Authorization: __RP_TOK_0__\" \\\n  -H \"Revolut-Api-Version: __RP_TOK_1__\"
","tokens":[{"marker":"__RP_TOK_0__","paramName":"Authorization","paramIn":"header","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_1__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["shell-double-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16"}},{"id":"javascript","label":"JavaScript","templateCode":"fetch(\"https://sandbox-merchant.revolut.com/api/webhooks\", {\n method: \"GET\",\n headers: {\n \"Authorization\": \"__RP_TOK_0__\",\n \"Revolut-Api-Version\": \"__RP_TOK_1__\"\n }\n})\n .then(response => response.json())\n .then(data => console.log(data));","templateHtml":"$2e2","tokens":[{"marker":"__RP_TOK_0__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16"}},{"id":"go","label":"Go","templateCode":"package main\n\nimport (\n \"fmt\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://sandbox-merchant.revolut.com/api/webhooks\"\n req, _ := http.NewRequest(\"GET\", url, nil)\n req.Header.Add(\"Authorization\", \"__RP_TOK_0__\")\n req.Header.Add(\"Revolut-Api-Version\", \"__RP_TOK_1__\")\n\n res, _ := http.DefaultClient.Do(req)\n defer res.Body.Close()\n fmt.Println(res)\n}","templateHtml":"$2e3","tokens":[{"marker":"__RP_TOK_0__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16"}},{"id":"python","label":"Python","templateCode":"import requests\n\nurl = \"https://sandbox-merchant.revolut.com/api/webhooks\"\nheaders = {\n \"Authorization\": \"__RP_TOK_0__\",\n \"Revolut-Api-Version\": \"__RP_TOK_1__\"\n}\n\nresponse = requests.get(url, headers=headers)\nprint(response.json())","templateHtml":"$2e4","tokens":[{"marker":"__RP_TOK_0__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16"}},{"id":"java","label":"Java","templateCode":"import java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\nimport java.net.URI;\n\npublic class Main {\n public static void main(String[] args) {\n HttpClient client = HttpClient.newHttpClient();\n HttpRequest request = HttpRequest.newBuilder()\n .uri(URI.create(\"https://sandbox-merchant.revolut.com/api/webhooks\"))\n .header(\"Authorization\", \"__RP_TOK_0__\")\n .header(\"Revolut-Api-Version\", \"__RP_TOK_1__\")\n .GET(HttpRequest.BodyPublishers.noBody())\n .build();\n\n client.sendAsync(request, HttpResponse.BodyHandlers.ofString())\n .thenApply(HttpResponse::body)\n .thenAccept(System.out::println)\n .join();\n }\n}","templateHtml":"$2e5","tokens":[{"marker":"__RP_TOK_0__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16"}},{"id":"csharp","label":"C#","templateCode":"using System.Net.Http;\nusing System.Net.Http.Headers;\n\nvar client = new HttpClient();\nvar request = new HttpRequestMessage\n{\n Method = HttpMethod.Get,\n RequestUri = new Uri(\"https://sandbox-merchant.revolut.com/api/webhooks\"),\n Headers =\n {\n { \"Authorization\", \"__RP_TOK_0__\" },\n { \"Revolut-Api-Version\", \"__RP_TOK_1__\" },\n }\n};\n\nusing (var response = await client.SendAsync(request))\n{\n response.EnsureSuccessStatusCode();\n var body = await response.Content.ReadAsStringAsync();\n Console.WriteLine(body);\n}","templateHtml":"$2e6","tokens":[{"marker":"__RP_TOK_0__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16"}}]},"method":"get","servers":"$62:props:children:0:props:children:props:children:1:props:children:1:props:children:0:0:props:servers","path":"/api/webhooks","parameters":["$2b5:props:children:0:props:children:1:props:parameters:0","$2b5:props:children:0:props:children:1:props:parameters:1"]}],"$L2e7"],"$L2e8","$L2e9"]}]]}] 2f4:T6c5,
curl -X POST "https://merchant.revolut.com/api/apple-pay/domains/unregister" \
  -H "Content-Type: application/json" \
  -H "Authorization: __RP_TOK_0__" \
  -H "Revolut-Api-Version: __RP_TOK_1__" \
  -d '{
  "domain": "revolut.com",
  "reason": "Unregister due to domain change."
}'
2f5:Tfb6,
const payload = {
  "domain": "revolut.com",
  "reason": "Unregister due to domain change."
};
fetch("https://merchant.revolut.com/api/apple-pay/domains/unregister", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "__RP_TOK_0__",
    "Revolut-Api-Version": "__RP_TOK_1__"
  },
  body: JSON.stringify(payload)
})
  .then(response => response.json())
  .then(data => console.log(data));
2f6:T16aa,
package main

import (
  "fmt"
  "net/http"
  "bytes"
  "encoding/json"
)

func main() {
  url := "https://merchant.revolut.com/api/apple-pay/domains/unregister"
  jsonData := []byte(`
{
  "domain": "revolut.com",
  "reason": "Unregister due to domain change."
}
  `)
  req, _ := http.NewRequest("POST", url, bytes.NewBuffer(jsonData))
  req.Header.Add("Content-Type", "application/json")
  req.Header.Add("Authorization", "__RP_TOK_0__")
  req.Header.Add("Revolut-Api-Version", "__RP_TOK_1__")

  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  fmt.Println(res)
}
2f7:Tcea,
import requests

url = "https://merchant.revolut.com/api/apple-pay/domains/unregister"
headers = {
  "Content-Type": "application/json",
  "Authorization": "__RP_TOK_0__",
  "Revolut-Api-Version": "__RP_TOK_1__"
}
payload = {
  "domain": "revolut.com",
  "reason": "Unregister due to domain change."
}

response = requests.post(url, headers=headers, json=payload)
print(response.json())
2f8:T1c0e,
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;

public class Main {
  public static void main(String[] args) {
    HttpClient client = HttpClient.newHttpClient();
    String body = """
{
  "domain": "revolut.com",
  "reason": "Unregister due to domain change."
}
    """;

    HttpRequest request = HttpRequest.newBuilder()
      .uri(URI.create("https://merchant.revolut.com/api/apple-pay/domains/unregister"))
      .header("Content-Type", "application/json")
      .header("Authorization", "__RP_TOK_0__")
      .header("Revolut-Api-Version", "__RP_TOK_1__")
      .POST(HttpRequest.BodyPublishers.ofString(body))
      .build();

    client.sendAsync(request, HttpResponse.BodyHandlers.ofString())
      .thenApply(HttpResponse::body)
      .thenAccept(System.out::println)
      .join();
  }
}
2f9:T1f82,
using System.Net.Http;
using System.Net.Http.Headers;

var client = new HttpClient();
var request = new HttpRequestMessage
{
  Method = HttpMethod.Post,
  RequestUri = new Uri("https://merchant.revolut.com/api/apple-pay/domains/unregister"),
  Headers =
  {
    { "Authorization", "__RP_TOK_0__" },
    { "Revolut-Api-Version", "__RP_TOK_1__" },
  },
  Content = new StringContent(@"{
  ""domain"": ""revolut.com"",
  ""reason"": ""Unregister due to domain change.""
}")
  {
    Headers =
    {
      ContentType = new MediaTypeHeaderValue("application/json")
    }
  }
};

using (var response = await client.SendAsync(request))
{
  response.EnsureSuccessStatusCode();
  var body = await response.Content.ReadAsStringAsync();
  Console.WriteLine(body);
}
2fa:T6cd,
curl -X POST "https://sandbox-merchant.revolut.com/api/apple-pay/domains/unregister" \
  -H "Content-Type: application/json" \
  -H "Authorization: __RP_TOK_0__" \
  -H "Revolut-Api-Version: __RP_TOK_1__" \
  -d '{
  "domain": "revolut.com",
  "reason": "Unregister due to domain change."
}'
2fb:Tfbe,
const payload = {
  "domain": "revolut.com",
  "reason": "Unregister due to domain change."
};
fetch("https://sandbox-merchant.revolut.com/api/apple-pay/domains/unregister", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "__RP_TOK_0__",
    "Revolut-Api-Version": "__RP_TOK_1__"
  },
  body: JSON.stringify(payload)
})
  .then(response => response.json())
  .then(data => console.log(data));
2fc:T16b2,
package main

import (
  "fmt"
  "net/http"
  "bytes"
  "encoding/json"
)

func main() {
  url := "https://sandbox-merchant.revolut.com/api/apple-pay/domains/unregister"
  jsonData := []byte(`
{
  "domain": "revolut.com",
  "reason": "Unregister due to domain change."
}
  `)
  req, _ := http.NewRequest("POST", url, bytes.NewBuffer(jsonData))
  req.Header.Add("Content-Type", "application/json")
  req.Header.Add("Authorization", "__RP_TOK_0__")
  req.Header.Add("Revolut-Api-Version", "__RP_TOK_1__")

  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  fmt.Println(res)
}
2fd:Tcf2,
import requests

url = "https://sandbox-merchant.revolut.com/api/apple-pay/domains/unregister"
headers = {
  "Content-Type": "application/json",
  "Authorization": "__RP_TOK_0__",
  "Revolut-Api-Version": "__RP_TOK_1__"
}
payload = {
  "domain": "revolut.com",
  "reason": "Unregister due to domain change."
}

response = requests.post(url, headers=headers, json=payload)
print(response.json())
2fe:T1c16,
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;

public class Main {
  public static void main(String[] args) {
    HttpClient client = HttpClient.newHttpClient();
    String body = """
{
  "domain": "revolut.com",
  "reason": "Unregister due to domain change."
}
    """;

    HttpRequest request = HttpRequest.newBuilder()
      .uri(URI.create("https://sandbox-merchant.revolut.com/api/apple-pay/domains/unregister"))
      .header("Content-Type", "application/json")
      .header("Authorization", "__RP_TOK_0__")
      .header("Revolut-Api-Version", "__RP_TOK_1__")
      .POST(HttpRequest.BodyPublishers.ofString(body))
      .build();

    client.sendAsync(request, HttpResponse.BodyHandlers.ofString())
      .thenApply(HttpResponse::body)
      .thenAccept(System.out::println)
      .join();
  }
}
2ff:T1f8a,
using System.Net.Http;
using System.Net.Http.Headers;

var client = new HttpClient();
var request = new HttpRequestMessage
{
  Method = HttpMethod.Post,
  RequestUri = new Uri("https://sandbox-merchant.revolut.com/api/apple-pay/domains/unregister"),
  Headers =
  {
    { "Authorization", "__RP_TOK_0__" },
    { "Revolut-Api-Version", "__RP_TOK_1__" },
  },
  Content = new StringContent(@"{
  ""domain"": ""revolut.com"",
  ""reason"": ""Unregister due to domain change.""
}")
  {
    Headers =
    {
      ContentType = new MediaTypeHeaderValue("application/json")
    }
  }
};

using (var response = await client.SendAsync(request))
{
  response.EnsureSuccessStatusCode();
  var body = await response.Content.ReadAsStringAsync();
  Console.WriteLine(body);
}
6b:["$","$7a","unregister-domain-apple-pay",{"children":[["$","section",null,{"className":"y9a0do0","data-variant":"endpoint","children":["$","$L7b",null,{"responses":{"204":{"description":"Domain ungistered successfully","descriptionNode":"$L2ea"},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"An identifier that can be used to determine what went wrong.\n\nError codes are not globally unique, but uniqueness is guaranteed within endpoints.","descriptionNode":"$L2eb"},"message":{"type":"string","description":"Human readable text describing what went wrong.","descriptionNode":"$L2ec"}},"required":["code"]},"examples":{"error_message":{"summary":"Error message","value":{"code":"validation","message":"Exactly one value must be supplied for client_id"}}}}},"descriptionNode":"$L2ed"}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"domain":{"type":"string","description":"Domain name of your website without the scheme (i.e. without `http://` or `https://`).","examples":["revolut.com"],"descriptionNode":"$L2ee"},"reason":{"type":"string","description":"A short explanation why you remove the domain.","maxLength":1024,"descriptionNode":"$L2ef"}},"required":["domain","reason"]},"examples":{"example_request":{"summary":"Example domain registration request for Apple Pay","value":{"domain":"revolut.com","reason":"Unregister due to domain change."}}}}}},"variantLabels":[],"children":[["$","div",null,{"className":"ezz1n30","children":[["$","div",null,{"data-header":"$undefined","className":"ezz1n31","children":["$","div",null,{"className":"y9a0do1","children":[["$","h2",null,{"id":"unregister-domain-apple-pay","children":[["$L2f0","$undefined"],["$","$L15",null,{"id":"unregister-domain-apple-pay"}]]}],["$","$L16",null,{"url":"/docs/api/merchant/2025-10-16/operations/unregister-domain-apple-pay.md"}]]}]}],"$undefined"]}],["$","div",null,{"className":"ezz1n30","children":[["$","div",null,{"data-header":"$undefined","className":"ezz1n31","children":["$L2f1",["$","$L85",null,{"parameters":[{"name":"Authorization","in":"header","schema":{"type":"string","format":"Bearer ","examples":"$62:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:0:schema:examples"},"required":true,"description":"This parameter accepts the [Merchant API Secret key](https://business.revolut.com/settings/apis?tab=merchant-api) to authorise requests coming from the merchant's backend. \n\nIt ensures that ensures that each request is authenticated and authorised by verifying the secret key. The secret key should be included in all request headers as a `Bearer` token.\n\n:::info\nFor more information, see: [Authentication](https://developer.revolut.com/docs/api/merchant#authentication)\n:::","descriptionNode":"$L2f2"},{"name":"Revolut-Api-Version","in":"header","schema":{"type":"string","format":"date","enum":["2023-09-01","2024-05-01","2024-09-01","2025-10-16","2025-12-04","2026-03-12","2026-04-20"],"examples":["2026-04-20"]},"description":"The version of the Merchant API, specified in `YYYY-MM-DD` format.\n\n:::info\nFor more information about API versioning, see: [API versions](https://developer.revolut.com/docs/guides/merchant/reference/versioning/api-versions).\n:::","x-config-always-visible-in-example":true,"descriptionNode":"$L2f3"}],"requestBody":"$6b:props:children:0:props:children:props:requestBody","heading":"Request","requestBodySchemaTitle":"Request body","headingAs":"h3"}],["$","$L89",null,{"responses":"$6b:props:children:0:props:children:props:responses","headingAs":"h3"}]]}],["$","div",null,{"className":"ezz1n32","children":[[["$","$L8a",null,{"itemsByServer":{"https://merchant.revolut.com":[{"id":"curl","label":"cURL","templateCode":"curl -X POST \"https://merchant.revolut.com/api/apple-pay/domains/unregister\" \\\n -H \"Content-Type: application/json\" \\\n -H \"Authorization: __RP_TOK_0__\" \\\n -H \"Revolut-Api-Version: __RP_TOK_1__\" \\\n -d '{\n \"domain\": \"revolut.com\",\n \"reason\": \"Unregister due to domain change.\"\n}'","templateHtml":"$2f4","tokens":[{"marker":"__RP_TOK_0__","paramName":"Authorization","paramIn":"header","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_1__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["shell-double-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2023-09-01"}},{"id":"javascript","label":"JavaScript","templateCode":"const payload = {\n \"domain\": \"revolut.com\",\n \"reason\": \"Unregister due to domain change.\"\n};\nfetch(\"https://merchant.revolut.com/api/apple-pay/domains/unregister\", {\n method: \"POST\",\n headers: {\n \"Content-Type\": \"application/json\",\n \"Authorization\": \"__RP_TOK_0__\",\n \"Revolut-Api-Version\": \"__RP_TOK_1__\"\n },\n body: JSON.stringify(payload)\n})\n .then(response => response.json())\n .then(data => console.log(data));","templateHtml":"$2f5","tokens":[{"marker":"__RP_TOK_0__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2023-09-01"}},{"id":"go","label":"Go","templateCode":"package main\n\nimport (\n \"fmt\"\n \"net/http\"\n \"bytes\"\n \"encoding/json\"\n)\n\nfunc main() {\n url := \"https://merchant.revolut.com/api/apple-pay/domains/unregister\"\n jsonData := []byte(`\n{\n \"domain\": \"revolut.com\",\n \"reason\": \"Unregister due to domain change.\"\n}\n `)\n req, _ := http.NewRequest(\"POST\", url, bytes.NewBuffer(jsonData))\n req.Header.Add(\"Content-Type\", \"application/json\")\n req.Header.Add(\"Authorization\", \"__RP_TOK_0__\")\n req.Header.Add(\"Revolut-Api-Version\", \"__RP_TOK_1__\")\n\n res, _ := http.DefaultClient.Do(req)\n defer res.Body.Close()\n fmt.Println(res)\n}","templateHtml":"$2f6","tokens":[{"marker":"__RP_TOK_0__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2023-09-01"}},{"id":"python","label":"Python","templateCode":"import requests\n\nurl = \"https://merchant.revolut.com/api/apple-pay/domains/unregister\"\nheaders = {\n \"Content-Type\": \"application/json\",\n \"Authorization\": \"__RP_TOK_0__\",\n \"Revolut-Api-Version\": \"__RP_TOK_1__\"\n}\npayload = {\n \"domain\": \"revolut.com\",\n \"reason\": \"Unregister due to domain change.\"\n}\n\nresponse = requests.post(url, headers=headers, json=payload)\nprint(response.json())","templateHtml":"$2f7","tokens":[{"marker":"__RP_TOK_0__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2023-09-01"}},{"id":"java","label":"Java","templateCode":"import java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\nimport java.net.URI;\n\npublic class Main {\n public static void main(String[] args) {\n HttpClient client = HttpClient.newHttpClient();\n String body = \"\"\"\n{\n \"domain\": \"revolut.com\",\n \"reason\": \"Unregister due to domain change.\"\n}\n \"\"\";\n\n HttpRequest request = HttpRequest.newBuilder()\n .uri(URI.create(\"https://merchant.revolut.com/api/apple-pay/domains/unregister\"))\n .header(\"Content-Type\", \"application/json\")\n .header(\"Authorization\", \"__RP_TOK_0__\")\n .header(\"Revolut-Api-Version\", \"__RP_TOK_1__\")\n .POST(HttpRequest.BodyPublishers.ofString(body))\n .build();\n\n client.sendAsync(request, HttpResponse.BodyHandlers.ofString())\n .thenApply(HttpResponse::body)\n .thenAccept(System.out::println)\n .join();\n }\n}","templateHtml":"$2f8","tokens":[{"marker":"__RP_TOK_0__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2023-09-01"}},{"id":"csharp","label":"C#","templateCode":"using System.Net.Http;\nusing System.Net.Http.Headers;\n\nvar client = new HttpClient();\nvar request = new HttpRequestMessage\n{\n Method = HttpMethod.Post,\n RequestUri = new Uri(\"https://merchant.revolut.com/api/apple-pay/domains/unregister\"),\n Headers =\n {\n { \"Authorization\", \"__RP_TOK_0__\" },\n { \"Revolut-Api-Version\", \"__RP_TOK_1__\" },\n },\n Content = new StringContent(@\"{\n \"\"domain\"\": \"\"revolut.com\"\",\n \"\"reason\"\": \"\"Unregister due to domain change.\"\"\n}\")\n {\n Headers =\n {\n ContentType = new MediaTypeHeaderValue(\"application/json\")\n }\n }\n};\n\nusing (var response = await client.SendAsync(request))\n{\n response.EnsureSuccessStatusCode();\n var body = await response.Content.ReadAsStringAsync();\n Console.WriteLine(body);\n}","templateHtml":"$2f9","tokens":[{"marker":"__RP_TOK_0__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2023-09-01"}}],"https://sandbox-merchant.revolut.com":[{"id":"curl","label":"cURL","templateCode":"curl -X POST \"https://sandbox-merchant.revolut.com/api/apple-pay/domains/unregister\" \\\n -H \"Content-Type: application/json\" \\\n -H \"Authorization: __RP_TOK_0__\" \\\n -H \"Revolut-Api-Version: __RP_TOK_1__\" \\\n -d '{\n \"domain\": \"revolut.com\",\n \"reason\": \"Unregister due to domain change.\"\n}'","templateHtml":"$2fa","tokens":[{"marker":"__RP_TOK_0__","paramName":"Authorization","paramIn":"header","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_1__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["shell-double-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2023-09-01"}},{"id":"javascript","label":"JavaScript","templateCode":"const payload = {\n \"domain\": \"revolut.com\",\n \"reason\": \"Unregister due to domain change.\"\n};\nfetch(\"https://sandbox-merchant.revolut.com/api/apple-pay/domains/unregister\", {\n method: \"POST\",\n headers: {\n \"Content-Type\": \"application/json\",\n \"Authorization\": \"__RP_TOK_0__\",\n \"Revolut-Api-Version\": \"__RP_TOK_1__\"\n },\n body: JSON.stringify(payload)\n})\n .then(response => response.json())\n .then(data => console.log(data));","templateHtml":"$2fb","tokens":[{"marker":"__RP_TOK_0__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2023-09-01"}},{"id":"go","label":"Go","templateCode":"package main\n\nimport (\n \"fmt\"\n \"net/http\"\n \"bytes\"\n \"encoding/json\"\n)\n\nfunc main() {\n url := \"https://sandbox-merchant.revolut.com/api/apple-pay/domains/unregister\"\n jsonData := []byte(`\n{\n \"domain\": \"revolut.com\",\n \"reason\": \"Unregister due to domain change.\"\n}\n `)\n req, _ := http.NewRequest(\"POST\", url, bytes.NewBuffer(jsonData))\n req.Header.Add(\"Content-Type\", \"application/json\")\n req.Header.Add(\"Authorization\", \"__RP_TOK_0__\")\n req.Header.Add(\"Revolut-Api-Version\", \"__RP_TOK_1__\")\n\n res, _ := http.DefaultClient.Do(req)\n defer res.Body.Close()\n fmt.Println(res)\n}","templateHtml":"$2fc","tokens":[{"marker":"__RP_TOK_0__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2023-09-01"}},{"id":"python","label":"Python","templateCode":"import requests\n\nurl = \"https://sandbox-merchant.revolut.com/api/apple-pay/domains/unregister\"\nheaders = {\n \"Content-Type\": \"application/json\",\n \"Authorization\": \"__RP_TOK_0__\",\n \"Revolut-Api-Version\": \"__RP_TOK_1__\"\n}\npayload = {\n \"domain\": \"revolut.com\",\n \"reason\": \"Unregister due to domain change.\"\n}\n\nresponse = requests.post(url, headers=headers, json=payload)\nprint(response.json())","templateHtml":"$2fd","tokens":[{"marker":"__RP_TOK_0__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2023-09-01"}},{"id":"java","label":"Java","templateCode":"import java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\nimport java.net.URI;\n\npublic class Main {\n public static void main(String[] args) {\n HttpClient client = HttpClient.newHttpClient();\n String body = \"\"\"\n{\n \"domain\": \"revolut.com\",\n \"reason\": \"Unregister due to domain change.\"\n}\n \"\"\";\n\n HttpRequest request = HttpRequest.newBuilder()\n .uri(URI.create(\"https://sandbox-merchant.revolut.com/api/apple-pay/domains/unregister\"))\n .header(\"Content-Type\", \"application/json\")\n .header(\"Authorization\", \"__RP_TOK_0__\")\n .header(\"Revolut-Api-Version\", \"__RP_TOK_1__\")\n .POST(HttpRequest.BodyPublishers.ofString(body))\n .build();\n\n client.sendAsync(request, HttpResponse.BodyHandlers.ofString())\n .thenApply(HttpResponse::body)\n .thenAccept(System.out::println)\n .join();\n }\n}","templateHtml":"$2fe","tokens":[{"marker":"__RP_TOK_0__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2023-09-01"}},{"id":"csharp","label":"C#","templateCode":"using System.Net.Http;\nusing System.Net.Http.Headers;\n\nvar client = new HttpClient();\nvar request = new HttpRequestMessage\n{\n Method = HttpMethod.Post,\n RequestUri = new Uri(\"https://sandbox-merchant.revolut.com/api/apple-pay/domains/unregister\"),\n Headers =\n {\n { \"Authorization\", \"__RP_TOK_0__\" },\n { \"Revolut-Api-Version\", \"__RP_TOK_1__\" },\n },\n Content = new StringContent(@\"{\n \"\"domain\"\": \"\"revolut.com\"\",\n \"\"reason\"\": \"\"Unregister due to domain change.\"\"\n}\")\n {\n Headers =\n {\n ContentType = new MediaTypeHeaderValue(\"application/json\")\n }\n }\n};\n\nusing (var response = await client.SendAsync(request))\n{\n response.EnsureSuccessStatusCode();\n var body = await response.Content.ReadAsStringAsync();\n Console.WriteLine(body);\n}","templateHtml":"$2ff","tokens":[{"marker":"__RP_TOK_0__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2023-09-01"}}]},"method":"post","servers":"$62:props:children:0:props:children:props:children:1:props:children:1:props:children:0:0:props:servers","path":"/api/apple-pay/domains/unregister","parameters":["$6b:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:0","$6b:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:1"]}],"$L300"],"$L301","$L302"]}]]}]]}]}],false]}] 41:["$","$7a","retrieve-payout-list",{"children":[["$","section",null,{"className":"y9a0do0","data-variant":"endpoint","children":["$","$L7b",null,{"responses":{"201":{"description":"Payouts retrieved","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Permanent payout ID used for payouts operations.","descriptionNode":"$L303"},"state":{"type":"string","enum":"$42:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:state:enum","description":"The state of the payout.","descriptionNode":"$L304"},"created_at":{"type":"string","format":"date-time","description":"The date and time the payout was created.","descriptionNode":"$L305"},"destination_type":{"type":"string","enum":"$42:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:destination_type:enum","description":"The destination of the payout funds when a merchant initiates a withdrawal from their merchant account.\n\n| Destination type | Description |\n| ---------------- | ----------- |\n| `current_pocket` | The funds were moved from the merchant account to the business account within the platform. This indicates an **internal transfer**, allowing the merchant to access the funds within their own business account. |\n| `external_beneficiary` | The funds were transferred to an external bank account or beneficiary outside the platform. This indicates a **transfer to an external account**, enabling the merchant to withdraw funds to external financial institutions. |","descriptionNode":"$L306"},"amount":{"type":"integer","minimum":1,"description":"The total amount of the payout in minor currency units. For example, `7034` represents €70.34.","descriptionNode":"$L307"},"currency":{"type":"string","format":"ISO 4217","minLength":3,"maxLength":3,"description":"[ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) currency code in upper case.\n\n:::info\nFor more information about the supported currencies, see: [Help Center](https://help.revolut.com/business/help/merchant-accounts/payments/in-which-currencies-can-i-accept-payments/).\n:::","descriptionNode":"$L308"}},"required":"$42:props:children:0:props:children:props:responses:200:content:application/json:schema:required"}},"examples":{"default":{"value":[{"id":"a830020e-090c-4717-836d-37941a27ad12","state":"completed","created_at":"2024-02-27T00:16:39.079285Z","destination_type":"current_pocket","amount":50000,"currency":"GBP"},{"id":"66ffee42-7c4a-a15c-9a47-5dc67150386f","state":"processing","created_at":"2024-02-26T17:16:39.079285Z","destination_type":"external_beneficiary","amount":10000,"currency":"GBP"}]}}}},"descriptionNode":"$L309"},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"code":{"type":"string","description":"An identifier that can be used to determine what went wrong.\n\nError codes are not globally unique, but uniqueness is guaranteed within endpoints.","descriptionNode":"$L30a"},"message":{"type":"string","description":"Some human readable text describing what went wrong.","descriptionNode":"$L30b"},"timestamp":{"type":"integer","description":"The [UNIX timestamp](https://www.unixtimestamp.com/) of the date and time the error happened.","descriptionNode":"$L30c"}}},"examples":{"default":{"value":{"code":"bad_request","message":"Could not parse JSON","timestamp":1721049596461}}}}},"headers":{},"descriptionNode":"$L30d"},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"code":{"type":"string","description":"An identifier that can be used to determine what went wrong.\n\nError codes are not globally unique, but uniqueness is guaranteed within endpoints.","descriptionNode":"$L30e"},"message":{"type":"string","description":"Some human readable text describing what went wrong.","descriptionNode":"$L30f"},"timestamp":{"type":"integer","description":"The [UNIX timestamp](https://www.unixtimestamp.com/) of the date and time the error happened.","descriptionNode":"$L310"}}},"examples":{"default":{"value":{"code":"unauthenticated","message":"Authentication failed","timestamp":1721049596461}}}}},"descriptionNode":"$L311"},"404":{"description":"Not Found","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"code":{"type":"string","description":"An identifier that can be used to determine what went wrong.\n\nError codes are not globally unique, but uniqueness is guaranteed within endpoints.","descriptionNode":"$L312"},"message":{"type":"string","description":"Some human readable text describing what went wrong.","descriptionNode":"$L313"},"timestamp":{"type":"integer","description":"The [UNIX timestamp](https://www.unixtimestamp.com/) of the date and time the error happened.","descriptionNode":"$L314"}}}}},"descriptionNode":"$L315"}},"requestBody":"$undefined","variantLabels":[],"children":["$L316","$L317"]}]}],false]}] 1d5:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"OK"}]]}] 1d6:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The ID of the error. You can share this ID with Revolut support for troubleshooting."}]]}] 1d7:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The date and time the error happened."}]]}] 1d8:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unauthorized"}]]}] 1d9:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The ID of the error. You can share this ID with Revolut support for troubleshooting."}]]}] 1da:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The date and time the error happened."}]]}] 1db:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Not Found"}]]}] 1e2:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["Get the details of a specific webhook, including its ",["$","code","code-0",{"children":"signing_secret"}],"."]}]]}] 1e3:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["This parameter accepts the ",["$","a","a-0",{"href":"https://business.revolut.com/settings/apis?tab=merchant-api","target":"_blank","rel":"noreferrer","children":"Merchant API Secret key"}]," to authorise requests coming from the merchant's backend."]}],"\n",["$","p","p-1",{"children":["It ensures that ensures that each request is authenticated and authorised by verifying the secret key. The secret key should be included in all request headers as a ",["$","code","code-0",{"children":"Bearer"}]," token."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#authentication","target":"_blank","rel":"noreferrer","children":"Authentication"}]]}]}]]}]]}] 1e4:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The version of the Merchant API, specified in ",["$","code","code-0",{"children":"YYYY-MM-DD"}]," format."]}],"\n",["$","p","p-1",{"children":["This endpoint is available from version ",["$","code","code-0",{"children":"2024-09-01"}],". If a version earlier than ",["$","code","code-1",{"children":"2024-09-01"}]," is provided, the endpoint returns a ",["$","code","code-2",{"children":"404"}]," response."]}],"\n",["$","p","p-2",{"children":"If not specified, you will receive an error."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information about API versioning, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/reference/versioning/api-versions","target":"_blank","rel":"noreferrer","children":"API versions"}],"."]}]}]]}]]}] 1e5:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A UUID string, typically used to identify resources."}]]}] 1e6:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The ID of the webhook."}]]}] 230:"Register domain for Apple Pay" 2d6:["$","$L10d",null,{"security":[{"Api-Key":[]}],"authorization":{"Api-Key":{"type":"apiKey","in":"header","name":"Authorization","description":"Each Merchant API request must contain an authorization header in the following format:\n\n```\n'Authorization: Bearer '\n```\n\nTo use this API, you need to generate API keys from your Revolut Business account. The Secret key is used in the authorization header for all server calls, while the Public key is provided with payment methods at checkout.\n\n:::info\nFor detailed instructions on generating your API keys, see: [Generate API keys](https://developer.revolut.com/docs/guides/merchant/get-started#generate-api-keys).\n:::","descriptionNode":"$L318"}}}] 2d7:["$","$L10f",null,{"exampleBlocks":{"multipart/form-data":{"variants":[{"key":"default","label":"Example","rawValue":{"file":"string"},"block":"$L319"}],"syncedPropertyName":"$undefined"}},"title":"Request body samples","headingAs":"h4"}] 2d8:["$","$L110",null,{"exampleBlocks":{"201":{"application/json":{"variants":[{"key":"evidence_uploaded","label":"Uploaded evidence","rawValue":"$47:props:children:0:props:children:props:responses:201:content:application/json:examples:evidence_uploaded:value","block":"$L31a"}],"syncedPropertyName":"$undefined"}},"400":{"application/json":{"variants":[{"key":"default","label":"default","rawValue":"$47:props:children:0:props:children:props:responses:400:content:application/json:examples:default:value","block":"$L31b"}],"syncedPropertyName":"$undefined"}},"401":{"application/json":{"variants":[{"key":"default","label":"default","rawValue":"$47:props:children:0:props:children:props:responses:401:content:application/json:examples:default:value","block":"$L31c"}],"syncedPropertyName":"$undefined"}},"403":{"application/json":{"variants":[{"key":"default","label":"default","rawValue":"$47:props:children:0:props:children:props:responses:403:content:application/json:examples:default:value","block":"$L31d"}],"syncedPropertyName":"$undefined"}},"404":{"application/json":{"variants":[{"key":"default","label":"default","rawValue":"$47:props:children:0:props:children:props:responses:404:content:application/json:examples:default:value","block":"$L31e"}],"syncedPropertyName":"$undefined"}},"422":{"application/json":{"variants":[{"key":"default","label":"Example","rawValue":{"code":"string","message":"string","timestamp":123},"block":"$L31f"}],"syncedPropertyName":"$undefined"}}},"headingAs":"h4"}] 2e7:["$","$L10d",null,{"security":[{"Api-Key":[]}],"authorization":{"Api-Key":{"type":"apiKey","in":"header","name":"Authorization","description":"Each Merchant API request must contain an authorization header in the following format:\n\n```\n'Authorization: Bearer '\n```\n\nTo use this API, you need to generate API keys from your Revolut Business account. The Secret key is used in the authorization header for all server calls, while the Public key is provided with payment methods at checkout.\n\n:::info\nFor detailed instructions on generating your API keys, see: [Generate API keys](https://developer.revolut.com/docs/guides/merchant/get-started#generate-api-keys).\n:::","descriptionNode":"$L320"}}}] 2e8:["$","$L10f",null,{"exampleBlocks":{},"title":"Request body samples","headingAs":"h4"}] 2e9:["$","$L110",null,{"exampleBlocks":{"200":{"application/json":{"variants":[{"key":"list_of_webhooks","label":"List of webhooks","rawValue":"$58:props:children:0:props:children:props:responses:200:content:application/json:examples:list_of_webhooks:value","block":"$L321"}],"syncedPropertyName":"$undefined"}},"401":{"application/json":{"variants":[{"key":"default","label":"Example","rawValue":{"code":"string","message":"string","timestamp":123},"block":"$L322"}],"syncedPropertyName":"$undefined"}}},"headingAs":"h4"}] 300:["$","$L10d",null,{"security":[{"Api-Key":[]}],"authorization":{"Api-Key":{"type":"apiKey","in":"header","name":"Authorization","description":"Each Merchant API request must contain an authorization header in the following format:\n\n```\n'Authorization: Bearer '\n```\n\nTo use this API, you need to generate API keys from your Revolut Business account. The Secret key is used in the authorization header for all server calls, while the Public key is provided with payment methods at checkout.\n\n:::info\nFor detailed instructions on generating your API keys, see: [Generate API keys](https://developer.revolut.com/docs/guides/merchant/get-started#generate-api-keys).\n:::","descriptionNode":"$L323"}}}] 301:["$","$L10f",null,{"exampleBlocks":{"application/json":{"variants":[{"key":"example_request","label":"Example domain registration request for Apple Pay","rawValue":"$6b:props:children:0:props:children:props:requestBody:content:application/json:examples:example_request:value","block":"$L324"}],"syncedPropertyName":"$undefined"}},"title":"Request body samples","headingAs":"h4"}] 302:["$","$L110",null,{"exampleBlocks":{"204":{},"400":{"application/json":{"variants":[{"key":"error_message","label":"Error message","rawValue":"$6b:props:children:0:props:children:props:responses:400:content:application/json:examples:error_message:value","block":"$L325"}],"syncedPropertyName":"$undefined"}}},"headingAs":"h4"}] 316:["$","div",null,{"className":"ezz1n30","children":[["$","div",null,{"data-header":"$undefined","className":"ezz1n31","children":["$","div",null,{"className":"y9a0do1","children":[["$","h2",null,{"id":"retrieve-payout-list","children":[["$L326","$undefined"],["$","$L15",null,{"id":"retrieve-payout-list"}]]}],["$","$L16",null,{"url":"/docs/api/merchant/2025-10-16/operations/retrieve-payout-list.md"}]]}]}],"$undefined"]}] 32f:T442,
curl -X GET "https://merchant.revolut.com/api/payouts?currency=__RP_TOK_0__&limit=__RP_TOK_1__&from_created_date=__RP_TOK_2__&to_created_date=__RP_TOK_3__&state=__RP_TOK_4__" \
  -H "Authorization: __RP_TOK_5__" \
  -H "Revolut-Api-Version: __RP_TOK_6__"
330:Ta50,
fetch("https://merchant.revolut.com/api/payouts?currency=__RP_TOK_0__&limit=__RP_TOK_1__&from_created_date=__RP_TOK_2__&to_created_date=__RP_TOK_3__&state=__RP_TOK_4__", {
  method: "GET",
  headers: {
    "Authorization": "__RP_TOK_5__",
    "Revolut-Api-Version": "__RP_TOK_6__"
  }
})
  .then(response => response.json())
  .then(data => console.log(data));
331:Tfed,
package main

import (
  "fmt"
  "net/http"
)

func main() {
  url := "https://merchant.revolut.com/api/payouts?currency=__RP_TOK_0__&limit=__RP_TOK_1__&from_created_date=__RP_TOK_2__&to_created_date=__RP_TOK_3__&state=__RP_TOK_4__"
  req, _ := http.NewRequest("GET", url, nil)
  req.Header.Add("Authorization", "__RP_TOK_5__")
  req.Header.Add("Revolut-Api-Version", "__RP_TOK_6__")

  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  fmt.Println(res)
}
332:T862,
import requests

url = "https://merchant.revolut.com/api/payouts?currency=__RP_TOK_0__&limit=__RP_TOK_1__&from_created_date=__RP_TOK_2__&to_created_date=__RP_TOK_3__&state=__RP_TOK_4__"
headers = {
  "Authorization": "__RP_TOK_5__",
  "Revolut-Api-Version": "__RP_TOK_6__"
}

response = requests.get(url, headers=headers)
print(response.json())
333:T178e,
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;

public class Main {
  public static void main(String[] args) {
    HttpClient client = HttpClient.newHttpClient();
    HttpRequest request = HttpRequest.newBuilder()
      .uri(URI.create("https://merchant.revolut.com/api/payouts?currency=__RP_TOK_0__&limit=__RP_TOK_1__&from_created_date=__RP_TOK_2__&to_created_date=__RP_TOK_3__&state=__RP_TOK_4__"))
      .header("Authorization", "__RP_TOK_5__")
      .header("Revolut-Api-Version", "__RP_TOK_6__")
      .GET(HttpRequest.BodyPublishers.noBody())
      .build();

    client.sendAsync(request, HttpResponse.BodyHandlers.ofString())
      .thenApply(HttpResponse::body)
      .thenAccept(System.out::println)
      .join();
  }
}
334:T1638,
using System.Net.Http;
using System.Net.Http.Headers;

var client = new HttpClient();
var request = new HttpRequestMessage
{
  Method = HttpMethod.Get,
  RequestUri = new Uri("https://merchant.revolut.com/api/payouts?currency=__RP_TOK_0__&limit=__RP_TOK_1__&from_created_date=__RP_TOK_2__&to_created_date=__RP_TOK_3__&state=__RP_TOK_4__"),
  Headers =
  {
    { "Authorization", "__RP_TOK_5__" },
    { "Revolut-Api-Version", "__RP_TOK_6__" },
  }
};

using (var response = await client.SendAsync(request))
{
  response.EnsureSuccessStatusCode();
  var body = await response.Content.ReadAsStringAsync();
  Console.WriteLine(body);
}
335:T44a,
curl -X GET "https://sandbox-merchant.revolut.com/api/payouts?currency=__RP_TOK_0__&limit=__RP_TOK_1__&from_created_date=__RP_TOK_2__&to_created_date=__RP_TOK_3__&state=__RP_TOK_4__" \
  -H "Authorization: __RP_TOK_5__" \
  -H "Revolut-Api-Version: __RP_TOK_6__"
336:Ta58,
fetch("https://sandbox-merchant.revolut.com/api/payouts?currency=__RP_TOK_0__&limit=__RP_TOK_1__&from_created_date=__RP_TOK_2__&to_created_date=__RP_TOK_3__&state=__RP_TOK_4__", {
  method: "GET",
  headers: {
    "Authorization": "__RP_TOK_5__",
    "Revolut-Api-Version": "__RP_TOK_6__"
  }
})
  .then(response => response.json())
  .then(data => console.log(data));
337:Tff5,
package main

import (
  "fmt"
  "net/http"
)

func main() {
  url := "https://sandbox-merchant.revolut.com/api/payouts?currency=__RP_TOK_0__&limit=__RP_TOK_1__&from_created_date=__RP_TOK_2__&to_created_date=__RP_TOK_3__&state=__RP_TOK_4__"
  req, _ := http.NewRequest("GET", url, nil)
  req.Header.Add("Authorization", "__RP_TOK_5__")
  req.Header.Add("Revolut-Api-Version", "__RP_TOK_6__")

  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  fmt.Println(res)
}
338:T86a,
import requests

url = "https://sandbox-merchant.revolut.com/api/payouts?currency=__RP_TOK_0__&limit=__RP_TOK_1__&from_created_date=__RP_TOK_2__&to_created_date=__RP_TOK_3__&state=__RP_TOK_4__"
headers = {
  "Authorization": "__RP_TOK_5__",
  "Revolut-Api-Version": "__RP_TOK_6__"
}

response = requests.get(url, headers=headers)
print(response.json())
339:T1796,
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;

public class Main {
  public static void main(String[] args) {
    HttpClient client = HttpClient.newHttpClient();
    HttpRequest request = HttpRequest.newBuilder()
      .uri(URI.create("https://sandbox-merchant.revolut.com/api/payouts?currency=__RP_TOK_0__&limit=__RP_TOK_1__&from_created_date=__RP_TOK_2__&to_created_date=__RP_TOK_3__&state=__RP_TOK_4__"))
      .header("Authorization", "__RP_TOK_5__")
      .header("Revolut-Api-Version", "__RP_TOK_6__")
      .GET(HttpRequest.BodyPublishers.noBody())
      .build();

    client.sendAsync(request, HttpResponse.BodyHandlers.ofString())
      .thenApply(HttpResponse::body)
      .thenAccept(System.out::println)
      .join();
  }
}
33a:T1640,
using System.Net.Http;
using System.Net.Http.Headers;

var client = new HttpClient();
var request = new HttpRequestMessage
{
  Method = HttpMethod.Get,
  RequestUri = new Uri("https://sandbox-merchant.revolut.com/api/payouts?currency=__RP_TOK_0__&limit=__RP_TOK_1__&from_created_date=__RP_TOK_2__&to_created_date=__RP_TOK_3__&state=__RP_TOK_4__"),
  Headers =
  {
    { "Authorization", "__RP_TOK_5__" },
    { "Revolut-Api-Version", "__RP_TOK_6__" },
  }
};

using (var response = await client.SendAsync(request))
{
  response.EnsureSuccessStatusCode();
  var body = await response.Content.ReadAsStringAsync();
  Console.WriteLine(body);
}
317:["$","div",null,{"className":"ezz1n30","children":[["$","div",null,{"data-header":"$undefined","className":"ezz1n31","children":["$L327",["$","$L85",null,{"parameters":[{"name":"Authorization","in":"header","schema":{"type":"string","format":"Bearer ","examples":"$62:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:0:schema:examples"},"required":true,"description":"This parameter accepts the [Merchant API Secret key](https://business.revolut.com/settings/apis?tab=merchant-api) to authorise requests coming from the merchant's backend. \n\nIt ensures that ensures that each request is authenticated and authorised by verifying the secret key. The secret key should be included in all request headers as a `Bearer` token.\n\n:::info\nFor more information, see: [Authentication](https://developer.revolut.com/docs/api/merchant#authentication)\n:::","descriptionNode":"$L328"},{"name":"Revolut-Api-Version","in":"header","schema":{"type":"string","format":"date","enum":"$36:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:1:schema:enum","examples":"$36:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:1:schema:examples"},"required":true,"description":"The version of the Merchant API, specified in `YYYY-MM-DD` format.\n\nIf not specified, you will receive an error.\n\n\n:::info\nFor more information about API versioning, see: [API versions](https://developer.revolut.com/docs/guides/merchant/reference/versioning/api-versions).\n:::","x-config-always-visible-in-example":true,"example":"2025-10-16","descriptionNode":"$L329"},{"name":"currency","in":"query","schema":{"type":"string","minLength":3,"maxLength":3},"description":"[ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) currency code in upper case.\n\n:::info\nFor more information about the supported currencies, see: [Help Center](https://help.revolut.com/business/help/merchant-accounts/payments/in-which-currencies-can-i-accept-payments/).\n:::","descriptionNode":"$L32a"},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":500},"description":"The maximum number of payouts returned per page. Used for **pagination**.","descriptionNode":"$L32b"},{"name":"from_created_date","in":"query","schema":{"type":"string","format":"date-time"},"description":"Retrieve all payouts with a `created_date` ≥ `from_created_date`. Used for **filtering**.\n\nUse the [ISO date format](https://en.wikipedia.org/wiki/ISO_8601): `yyyy-MM-ddTHH:mm:ss[.SSSSSS]Z`. For example, `2021-02-10T16:59:50.886826Z`.","descriptionNode":"$L32c"},{"name":"to_created_date","in":"query","schema":{"type":"string","format":"date-time"},"description":"Retrieve all payouts with a `created_date` ≤ `to_created_date`. Used for **filtering**.\n\nUse the [ISO date format](https://en.wikipedia.org/wiki/ISO_8601): `yyyy-MM-ddTHH:mm:ss[.SSSSSS]Z`. For example, `2021-02-10T16:59:50.886826Z`.","descriptionNode":"$L32d"},{"name":"state","in":"query","schema":{"type":"array","items":{"type":"string","enum":["processing","completed","failed"]}},"style":"form","explode":true,"description":"Retrieve all payouts with specific states. You can pass several states. Used for **filtering**.\n\nIf multiple states are selected, for example `completed` and `processing`, payouts with either of the selected values are returned. See this example of such a request URL: \n\n```curl\nhttps://merchant.revolut.com/api/payouts?state=completed&state=processing\n```\n\nThe parameter is case sensitive.","descriptionNode":"$L32e"}],"requestBody":"$undefined","heading":"Request","requestBodySchemaTitle":"Request body","headingAs":"h3"}],["$","$L89",null,{"responses":"$41:props:children:0:props:children:props:responses","headingAs":"h3"}]]}],["$","div",null,{"className":"ezz1n32","children":[[["$","$L8a",null,{"itemsByServer":{"https://merchant.revolut.com":[{"id":"curl","label":"cURL","templateCode":"curl -X GET \"https://merchant.revolut.com/api/payouts?currency=__RP_TOK_0__&limit=__RP_TOK_1__&from_created_date=__RP_TOK_2__&to_created_date=__RP_TOK_3__&state=__RP_TOK_4__\" \\\n -H \"Authorization: __RP_TOK_5__\" \\\n -H \"Revolut-Api-Version: __RP_TOK_6__\"","templateHtml":"$32f","tokens":[{"marker":"__RP_TOK_0__","paramName":"currency","paramIn":"query","pipeline":["url-component","shell-double-inner"]},{"marker":"__RP_TOK_1__","paramName":"limit","paramIn":"query","pipeline":["url-component","shell-double-inner"]},{"marker":"__RP_TOK_2__","paramName":"from_created_date","paramIn":"query","pipeline":["url-component","shell-double-inner"]},{"marker":"__RP_TOK_3__","paramName":"to_created_date","paramIn":"query","pipeline":["url-component","shell-double-inner"]},{"marker":"__RP_TOK_4__","paramName":"state","paramIn":"query","pipeline":["url-component","shell-double-inner"]},{"marker":"__RP_TOK_5__","paramName":"Authorization","paramIn":"header","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_6__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["shell-double-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","query:currency":"aaa","query:limit":"1","query:from_created_date":"2024-01-01T00:00:00Z","query:to_created_date":"2024-01-01T00:00:00Z","query:state":"[]"}},{"id":"javascript","label":"JavaScript","templateCode":"fetch(\"https://merchant.revolut.com/api/payouts?currency=__RP_TOK_0__&limit=__RP_TOK_1__&from_created_date=__RP_TOK_2__&to_created_date=__RP_TOK_3__&state=__RP_TOK_4__\", {\n method: \"GET\",\n headers: {\n \"Authorization\": \"__RP_TOK_5__\",\n \"Revolut-Api-Version\": \"__RP_TOK_6__\"\n }\n})\n .then(response => response.json())\n .then(data => console.log(data));","templateHtml":"$330","tokens":[{"marker":"__RP_TOK_0__","paramName":"currency","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"limit","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"from_created_date","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_3__","paramName":"to_created_date","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_4__","paramName":"state","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_5__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_6__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","query:currency":"aaa","query:limit":"1","query:from_created_date":"2024-01-01T00:00:00Z","query:to_created_date":"2024-01-01T00:00:00Z","query:state":"[]"}},{"id":"go","label":"Go","templateCode":"package main\n\nimport (\n \"fmt\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://merchant.revolut.com/api/payouts?currency=__RP_TOK_0__&limit=__RP_TOK_1__&from_created_date=__RP_TOK_2__&to_created_date=__RP_TOK_3__&state=__RP_TOK_4__\"\n req, _ := http.NewRequest(\"GET\", url, nil)\n req.Header.Add(\"Authorization\", \"__RP_TOK_5__\")\n req.Header.Add(\"Revolut-Api-Version\", \"__RP_TOK_6__\")\n\n res, _ := http.DefaultClient.Do(req)\n defer res.Body.Close()\n fmt.Println(res)\n}","templateHtml":"$331","tokens":[{"marker":"__RP_TOK_0__","paramName":"currency","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"limit","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"from_created_date","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_3__","paramName":"to_created_date","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_4__","paramName":"state","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_5__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_6__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","query:currency":"aaa","query:limit":"1","query:from_created_date":"2024-01-01T00:00:00Z","query:to_created_date":"2024-01-01T00:00:00Z","query:state":"[]"}},{"id":"python","label":"Python","templateCode":"import requests\n\nurl = \"https://merchant.revolut.com/api/payouts?currency=__RP_TOK_0__&limit=__RP_TOK_1__&from_created_date=__RP_TOK_2__&to_created_date=__RP_TOK_3__&state=__RP_TOK_4__\"\nheaders = {\n \"Authorization\": \"__RP_TOK_5__\",\n \"Revolut-Api-Version\": \"__RP_TOK_6__\"\n}\n\nresponse = requests.get(url, headers=headers)\nprint(response.json())","templateHtml":"$332","tokens":[{"marker":"__RP_TOK_0__","paramName":"currency","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"limit","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"from_created_date","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_3__","paramName":"to_created_date","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_4__","paramName":"state","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_5__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_6__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","query:currency":"aaa","query:limit":"1","query:from_created_date":"2024-01-01T00:00:00Z","query:to_created_date":"2024-01-01T00:00:00Z","query:state":"[]"}},{"id":"java","label":"Java","templateCode":"import java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\nimport java.net.URI;\n\npublic class Main {\n public static void main(String[] args) {\n HttpClient client = HttpClient.newHttpClient();\n HttpRequest request = HttpRequest.newBuilder()\n .uri(URI.create(\"https://merchant.revolut.com/api/payouts?currency=__RP_TOK_0__&limit=__RP_TOK_1__&from_created_date=__RP_TOK_2__&to_created_date=__RP_TOK_3__&state=__RP_TOK_4__\"))\n .header(\"Authorization\", \"__RP_TOK_5__\")\n .header(\"Revolut-Api-Version\", \"__RP_TOK_6__\")\n .GET(HttpRequest.BodyPublishers.noBody())\n .build();\n\n client.sendAsync(request, HttpResponse.BodyHandlers.ofString())\n .thenApply(HttpResponse::body)\n .thenAccept(System.out::println)\n .join();\n }\n}","templateHtml":"$333","tokens":[{"marker":"__RP_TOK_0__","paramName":"currency","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"limit","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"from_created_date","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_3__","paramName":"to_created_date","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_4__","paramName":"state","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_5__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_6__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","query:currency":"aaa","query:limit":"1","query:from_created_date":"2024-01-01T00:00:00Z","query:to_created_date":"2024-01-01T00:00:00Z","query:state":"[]"}},{"id":"csharp","label":"C#","templateCode":"using System.Net.Http;\nusing System.Net.Http.Headers;\n\nvar client = new HttpClient();\nvar request = new HttpRequestMessage\n{\n Method = HttpMethod.Get,\n RequestUri = new Uri(\"https://merchant.revolut.com/api/payouts?currency=__RP_TOK_0__&limit=__RP_TOK_1__&from_created_date=__RP_TOK_2__&to_created_date=__RP_TOK_3__&state=__RP_TOK_4__\"),\n Headers =\n {\n { \"Authorization\", \"__RP_TOK_5__\" },\n { \"Revolut-Api-Version\", \"__RP_TOK_6__\" },\n }\n};\n\nusing (var response = await client.SendAsync(request))\n{\n response.EnsureSuccessStatusCode();\n var body = await response.Content.ReadAsStringAsync();\n Console.WriteLine(body);\n}","templateHtml":"$334","tokens":[{"marker":"__RP_TOK_0__","paramName":"currency","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"limit","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"from_created_date","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_3__","paramName":"to_created_date","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_4__","paramName":"state","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_5__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_6__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","query:currency":"aaa","query:limit":"1","query:from_created_date":"2024-01-01T00:00:00Z","query:to_created_date":"2024-01-01T00:00:00Z","query:state":"[]"}}],"https://sandbox-merchant.revolut.com":[{"id":"curl","label":"cURL","templateCode":"curl -X GET \"https://sandbox-merchant.revolut.com/api/payouts?currency=__RP_TOK_0__&limit=__RP_TOK_1__&from_created_date=__RP_TOK_2__&to_created_date=__RP_TOK_3__&state=__RP_TOK_4__\" \\\n -H \"Authorization: __RP_TOK_5__\" \\\n -H \"Revolut-Api-Version: __RP_TOK_6__\"","templateHtml":"$335","tokens":[{"marker":"__RP_TOK_0__","paramName":"currency","paramIn":"query","pipeline":["url-component","shell-double-inner"]},{"marker":"__RP_TOK_1__","paramName":"limit","paramIn":"query","pipeline":["url-component","shell-double-inner"]},{"marker":"__RP_TOK_2__","paramName":"from_created_date","paramIn":"query","pipeline":["url-component","shell-double-inner"]},{"marker":"__RP_TOK_3__","paramName":"to_created_date","paramIn":"query","pipeline":["url-component","shell-double-inner"]},{"marker":"__RP_TOK_4__","paramName":"state","paramIn":"query","pipeline":["url-component","shell-double-inner"]},{"marker":"__RP_TOK_5__","paramName":"Authorization","paramIn":"header","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_6__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["shell-double-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","query:currency":"aaa","query:limit":"1","query:from_created_date":"2024-01-01T00:00:00Z","query:to_created_date":"2024-01-01T00:00:00Z","query:state":"[]"}},{"id":"javascript","label":"JavaScript","templateCode":"fetch(\"https://sandbox-merchant.revolut.com/api/payouts?currency=__RP_TOK_0__&limit=__RP_TOK_1__&from_created_date=__RP_TOK_2__&to_created_date=__RP_TOK_3__&state=__RP_TOK_4__\", {\n method: \"GET\",\n headers: {\n \"Authorization\": \"__RP_TOK_5__\",\n \"Revolut-Api-Version\": \"__RP_TOK_6__\"\n }\n})\n .then(response => response.json())\n .then(data => console.log(data));","templateHtml":"$336","tokens":[{"marker":"__RP_TOK_0__","paramName":"currency","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"limit","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"from_created_date","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_3__","paramName":"to_created_date","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_4__","paramName":"state","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_5__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_6__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","query:currency":"aaa","query:limit":"1","query:from_created_date":"2024-01-01T00:00:00Z","query:to_created_date":"2024-01-01T00:00:00Z","query:state":"[]"}},{"id":"go","label":"Go","templateCode":"package main\n\nimport (\n \"fmt\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://sandbox-merchant.revolut.com/api/payouts?currency=__RP_TOK_0__&limit=__RP_TOK_1__&from_created_date=__RP_TOK_2__&to_created_date=__RP_TOK_3__&state=__RP_TOK_4__\"\n req, _ := http.NewRequest(\"GET\", url, nil)\n req.Header.Add(\"Authorization\", \"__RP_TOK_5__\")\n req.Header.Add(\"Revolut-Api-Version\", \"__RP_TOK_6__\")\n\n res, _ := http.DefaultClient.Do(req)\n defer res.Body.Close()\n fmt.Println(res)\n}","templateHtml":"$337","tokens":[{"marker":"__RP_TOK_0__","paramName":"currency","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"limit","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"from_created_date","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_3__","paramName":"to_created_date","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_4__","paramName":"state","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_5__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_6__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","query:currency":"aaa","query:limit":"1","query:from_created_date":"2024-01-01T00:00:00Z","query:to_created_date":"2024-01-01T00:00:00Z","query:state":"[]"}},{"id":"python","label":"Python","templateCode":"import requests\n\nurl = \"https://sandbox-merchant.revolut.com/api/payouts?currency=__RP_TOK_0__&limit=__RP_TOK_1__&from_created_date=__RP_TOK_2__&to_created_date=__RP_TOK_3__&state=__RP_TOK_4__\"\nheaders = {\n \"Authorization\": \"__RP_TOK_5__\",\n \"Revolut-Api-Version\": \"__RP_TOK_6__\"\n}\n\nresponse = requests.get(url, headers=headers)\nprint(response.json())","templateHtml":"$338","tokens":[{"marker":"__RP_TOK_0__","paramName":"currency","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"limit","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"from_created_date","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_3__","paramName":"to_created_date","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_4__","paramName":"state","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_5__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_6__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","query:currency":"aaa","query:limit":"1","query:from_created_date":"2024-01-01T00:00:00Z","query:to_created_date":"2024-01-01T00:00:00Z","query:state":"[]"}},{"id":"java","label":"Java","templateCode":"import java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\nimport java.net.URI;\n\npublic class Main {\n public static void main(String[] args) {\n HttpClient client = HttpClient.newHttpClient();\n HttpRequest request = HttpRequest.newBuilder()\n .uri(URI.create(\"https://sandbox-merchant.revolut.com/api/payouts?currency=__RP_TOK_0__&limit=__RP_TOK_1__&from_created_date=__RP_TOK_2__&to_created_date=__RP_TOK_3__&state=__RP_TOK_4__\"))\n .header(\"Authorization\", \"__RP_TOK_5__\")\n .header(\"Revolut-Api-Version\", \"__RP_TOK_6__\")\n .GET(HttpRequest.BodyPublishers.noBody())\n .build();\n\n client.sendAsync(request, HttpResponse.BodyHandlers.ofString())\n .thenApply(HttpResponse::body)\n .thenAccept(System.out::println)\n .join();\n }\n}","templateHtml":"$339","tokens":[{"marker":"__RP_TOK_0__","paramName":"currency","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"limit","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"from_created_date","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_3__","paramName":"to_created_date","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_4__","paramName":"state","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_5__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_6__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","query:currency":"aaa","query:limit":"1","query:from_created_date":"2024-01-01T00:00:00Z","query:to_created_date":"2024-01-01T00:00:00Z","query:state":"[]"}},{"id":"csharp","label":"C#","templateCode":"using System.Net.Http;\nusing System.Net.Http.Headers;\n\nvar client = new HttpClient();\nvar request = new HttpRequestMessage\n{\n Method = HttpMethod.Get,\n RequestUri = new Uri(\"https://sandbox-merchant.revolut.com/api/payouts?currency=__RP_TOK_0__&limit=__RP_TOK_1__&from_created_date=__RP_TOK_2__&to_created_date=__RP_TOK_3__&state=__RP_TOK_4__\"),\n Headers =\n {\n { \"Authorization\", \"__RP_TOK_5__\" },\n { \"Revolut-Api-Version\", \"__RP_TOK_6__\" },\n }\n};\n\nusing (var response = await client.SendAsync(request))\n{\n response.EnsureSuccessStatusCode();\n var body = await response.Content.ReadAsStringAsync();\n Console.WriteLine(body);\n}","templateHtml":"$33a","tokens":[{"marker":"__RP_TOK_0__","paramName":"currency","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"limit","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"from_created_date","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_3__","paramName":"to_created_date","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_4__","paramName":"state","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_5__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_6__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","query:currency":"aaa","query:limit":"1","query:from_created_date":"2024-01-01T00:00:00Z","query:to_created_date":"2024-01-01T00:00:00Z","query:state":"[]"}}]},"method":"get","servers":"$62:props:children:0:props:children:props:children:1:props:children:1:props:children:0:0:props:servers","path":"/api/payouts","parameters":["$317:props:children:0:props:children:1:props:parameters:0","$317:props:children:0:props:children:1:props:parameters:1","$317:props:children:0:props:children:1:props:parameters:2","$317:props:children:0:props:children:1:props:parameters:3","$317:props:children:0:props:children:1:props:parameters:4","$317:props:children:0:props:children:1:props:parameters:5","$317:props:children:0:props:children:1:props:parameters:6"]}],"$L33b"],"$L33c","$L33d"]}]]}] 24c:"Retrieve a synchronous webhook list" 1f4:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Permanent payout ID used for payouts operations."}]]}] 1f5:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The state of the payout."}]]}] 1f6:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The date and time the payout was created."}]]}] 1f7:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The destination of the payout funds when a merchant initiates a withdrawal from their merchant account."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Destination type","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"current_pocket"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["The funds were moved from the merchant account to the business account within the platform. This indicates an ",["$","strong","strong-0",{"children":"internal transfer"}],", allowing the merchant to access the funds within their own business account."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"external_beneficiary"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["The funds were transferred to an external bank account or beneficiary outside the platform. This indicates a ",["$","strong","strong-0",{"children":"transfer to an external account"}],", enabling the merchant to withdraw funds to external financial institutions."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 1f8:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The total amount of the payout in minor currency units. For example, ",["$","code","code-0",{"children":"7034"}]," represents €70.34."]}]]}] 1f9:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":[["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_4217","target":"_blank","rel":"noreferrer","children":"ISO 4217"}]," currency code in upper case."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information about the supported currencies, see: ",["$","a","a-0",{"href":"https://help.revolut.com/business/help/merchant-accounts/payments/in-which-currencies-can-i-accept-payments/","target":"_blank","rel":"noreferrer","children":"Help Center"}],"."]}]}]]}]]}] 1fa:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Payout retrieved"}]]}] 1fb:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An identifier that can be used to determine what went wrong."}],"\n",["$","p","p-1",{"children":"Error codes are not globally unique, but uniqueness is guaranteed within endpoints."}]]}] 1fc:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Some human readable text describing what went wrong."}]]}] 1fd:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://www.unixtimestamp.com/","target":"_blank","rel":"noreferrer","children":"UNIX timestamp"}]," of the date and time the error happened."]}]]}] 1fe:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Bad Request"}]]}] 1ff:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An identifier that can be used to determine what went wrong."}],"\n",["$","p","p-1",{"children":"Error codes are not globally unique, but uniqueness is guaranteed within endpoints."}]]}] 200:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Some human readable text describing what went wrong."}]]}] 201:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://www.unixtimestamp.com/","target":"_blank","rel":"noreferrer","children":"UNIX timestamp"}]," of the date and time the error happened."]}]]}] 202:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unauthorized"}]]}] 20d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Each Merchant API request must contain an authorization header in the following format:"}],"\n","$L33e","\n",["$","p","p-1",{"children":"To use this API, you need to generate API keys from your Revolut Business account. The Secret key is used in the authorization header for all server calls, while the Public key is provided with payment methods at checkout."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For detailed instructions on generating your API keys, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/get-started#generate-api-keys","target":"_blank","rel":"noreferrer","children":"Generate API keys"}],"."]}]}]]}]]}] 203:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An identifier that can be used to determine what went wrong."}],"\n",["$","p","p-1",{"children":"Error codes are not globally unique, but uniqueness is guaranteed within endpoints."}]]}] 204:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Some human readable text describing what went wrong."}]]}] 205:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://www.unixtimestamp.com/","target":"_blank","rel":"noreferrer","children":"UNIX timestamp"}]," of the date and time the error happened."]}]]}] 206:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Not Found"}]]}] 212:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Retrieve the details of a payout. Provide the unique payout ID, and the corresponding payout information is returned."}]]}] 213:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["This parameter accepts the ",["$","a","a-0",{"href":"https://business.revolut.com/settings/apis?tab=merchant-api","target":"_blank","rel":"noreferrer","children":"Merchant API Secret key"}]," to authorise requests coming from the merchant's backend."]}],"\n",["$","p","p-1",{"children":["It ensures that ensures that each request is authenticated and authorised by verifying the secret key. The secret key should be included in all request headers as a ",["$","code","code-0",{"children":"Bearer"}]," token."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#authentication","target":"_blank","rel":"noreferrer","children":"Authentication"}]]}]}]]}]]}] 214:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The version of the Merchant API, specified in ",["$","code","code-0",{"children":"YYYY-MM-DD"}]," format."]}],"\n",["$","p","p-1",{"children":"If not specified, you will receive an error."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information about API versioning, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/reference/versioning/api-versions","target":"_blank","rel":"noreferrer","children":"API versions"}],"."]}]}]]}]]}] 215:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A UUID string, typically used to identify resources."}]]}] 216:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ID of the ",["$","code","code-0",{"children":"Payout"}]," object."]}]]}] 33b:["$","$L10d",null,{"security":[{"Api-Key":[]}],"authorization":{"Api-Key":{"type":"apiKey","in":"header","name":"Authorization","description":"Each Merchant API request must contain an authorization header in the following format:\n\n```\n'Authorization: Bearer '\n```\n\nTo use this API, you need to generate API keys from your Revolut Business account. The Secret key is used in the authorization header for all server calls, while the Public key is provided with payment methods at checkout.\n\n:::info\nFor detailed instructions on generating your API keys, see: [Generate API keys](https://developer.revolut.com/docs/guides/merchant/get-started#generate-api-keys).\n:::","descriptionNode":"$L33f"}}}] 33c:["$","$L10f",null,{"exampleBlocks":{},"title":"Request body samples","headingAs":"h4"}] 33d:["$","$L110",null,{"exampleBlocks":{"201":{"application/json":{"variants":[{"key":"default","label":"default","rawValue":"$41:props:children:0:props:children:props:responses:201:content:application/json:examples:default:value","block":"$L340"}],"syncedPropertyName":"$undefined"}},"400":{"application/json":{"variants":[{"key":"default","label":"default","rawValue":"$41:props:children:0:props:children:props:responses:400:content:application/json:examples:default:value","block":"$L341"}],"syncedPropertyName":"$undefined"}},"401":{"application/json":{"variants":[{"key":"default","label":"default","rawValue":"$41:props:children:0:props:children:props:responses:401:content:application/json:examples:default:value","block":"$L342"}],"syncedPropertyName":"$undefined"}},"404":{"application/json":{"variants":[{"key":"default","label":"Example","rawValue":{"code":"string","message":"string","timestamp":123},"block":"$L343"}],"syncedPropertyName":"$undefined"}}},"headingAs":"h4"}] 279:"Update a subscription renewal date" 24:["$","$7a","retrieve-customer-list",{"children":[["$","section",null,{"className":"y9a0do0","data-variant":"endpoint","children":["$","$L7b",null,{"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","required":["customers"],"properties":{"next_page_token":{"type":["string","null"],"description":"Token for retrieving the next page of results. Use this token as the value of the `page_token` query parameter in your next request to retrieve the next page.\n\nIf not present, there are no more results to retrieve.","descriptionNode":"$L344"},"customers":{"type":"array","description":"List of customers.","items":{"title":"Customer","type":"object","description":"A customer object.","properties":{"id":{"type":"string","format":"uuid","description":"Unique identifier for the customer.","descriptionNode":"$L345"},"full_name":{"type":"string","description":"The full name of the customer.","descriptionNode":"$L346"},"email":{"type":"string","format":"email","description":"The email address of the customer.","descriptionNode":"$L347"},"phone":{"type":"string","description":"The phone number of the customer in [E.164 format](https://en.wikipedia.org/wiki/E.164).","descriptionNode":"$L348"},"created_at":{"type":"string","format":"date-time","description":"The date and time the customer was created.","descriptionNode":"$L349"},"updated_at":{"type":"string","format":"date-time","description":"The date and time the customer was last updated.","descriptionNode":"$L34a"}},"required":["id","created_at","updated_at","email"],"descriptionNode":"$L34b"},"descriptionNode":"$L34c"}}},"examples":{"list_of_customers":{"summary":"List of customers","value":{"next_page_token":"9e5d2caa-bb60-4b5b-b7cf-6345bbdff67e","customers":[{"id":"9dfb8491-bfb0-4420-ad63-0fa7bdd3dffb","full_name":"First Customer","email":"first.customer@example.com","created_at":"2020-06-24T12:12:56.596703Z","updated_at":"2020-06-24T12:12:56.737082Z"},{"id":"6c7c97a8-cfc1-4cf3-8b38-26a74fdf1fae","full_name":"Second Customer","email":"second.customer@example.com","phone":"+441234567890","created_at":"2020-06-24T12:03:39.979397Z","updated_at":"2020-06-25T10:03:39.134417Z"}]}}}}},"descriptionNode":"$L34d"},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"code":{"type":"string","description":"An identifier that can be used to determine what went wrong.\n\nError codes are not globally unique, but uniqueness is guaranteed within endpoints.","descriptionNode":"$L34e"},"message":{"type":"string","description":"Some human readable text describing what went wrong.","descriptionNode":"$L34f"},"timestamp":{"type":"integer","description":"The [UNIX timestamp](https://www.unixtimestamp.com/) of the date and time the error happened.","descriptionNode":"$L350"}}}}},"descriptionNode":"$L351"}},"requestBody":"$undefined","variantLabels":[],"children":[["$","div",null,{"className":"ezz1n30","children":[["$","div",null,{"data-header":"$undefined","className":"ezz1n31","children":["$","div",null,{"className":"y9a0do1","children":[["$","h2",null,{"id":"retrieve-customer-list","children":[["$L352","$undefined"],["$","$L15",null,{"id":"retrieve-customer-list"}]]}],["$","$L16",null,{"url":"/docs/api/merchant/2025-10-16/operations/retrieve-customer-list.md"}]]}]}],"$undefined"]}],["$","div",null,{"className":"ezz1n30","children":[["$","div",null,{"data-header":"$undefined","className":"ezz1n31","children":["$L353",["$","$L85",null,{"parameters":[{"name":"Authorization","in":"header","schema":{"type":"string","format":"Bearer ","examples":"$62:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:0:schema:examples"},"required":true,"description":"This parameter accepts the [Merchant API Secret key](https://business.revolut.com/settings/apis?tab=merchant-api) to authorise requests coming from the merchant's backend. \n\nIt ensures that ensures that each request is authenticated and authorised by verifying the secret key. The secret key should be included in all request headers as a `Bearer` token.\n\n:::info\nFor more information, see: [Authentication](https://developer.revolut.com/docs/api/merchant#authentication)\n:::","descriptionNode":"$L354"},{"name":"Revolut-Api-Version","in":"header","schema":{"type":"string","format":"date","enum":"$27:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:1:schema:enum","examples":"$27:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:1:schema:examples"},"required":true,"description":"The version of the Merchant API, specified in `YYYY-MM-DD` format.\n\nThis endpoint is available from version `2024-09-01`. If a version earlier than `2024-09-01` is provided, the endpoint returns a `404` response.\n\nIf not specified, you will receive an error.\n\n\n:::info\nFor more information about API versioning, see: [API versions](https://developer.revolut.com/docs/guides/merchant/reference/versioning/api-versions).\n:::","x-config-always-visible-in-example":true,"example":"2025-10-16","descriptionNode":"$L355"},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":500,"default":100},"description":"Maximum number of records to return. Used for **pagination**.","required":false,"descriptionNode":"$L356"},{"name":"page_token","in":"query","schema":{"type":"string"},"description":"Token for retrieving the next page of results. Used for **pagination**.\n\nTo paginate through results:\n\n 1. Make an initial request with the desired `limit`.\n 1. The response will include a `next_page_token` if more results are available.\n 1. Use that token in the `page_token` parameter of your next request.\n 1. Repeat until `next_page_token` is not present.\n\n:::note\nWhen using `page_token`, you must include all query parameters from the initial request (such as `from`, `to`, or other filter parameters) to maintain consistent filtering across pages.\n:::","required":false,"descriptionNode":"$L357"},{"name":"from","in":"query","schema":{"type":"string","format":"date-time"},"description":"Filter records created from this date/time. Used for **filtering**.","required":false,"descriptionNode":"$L358"},{"name":"to","in":"query","schema":{"type":"string","format":"date-time"},"description":"Filter records created until this date/time. Used for **filtering**.","required":false,"descriptionNode":"$L359"}],"requestBody":"$undefined","heading":"Request","requestBodySchemaTitle":"Request body","headingAs":"h3"}],"$L35a"]}],"$L35b"]}]]}]}],false]}] 226:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Each Merchant API request must contain an authorization header in the following format:"}],"\n","$L35c","\n",["$","p","p-1",{"children":"To use this API, you need to generate API keys from your Revolut Business account. The Secret key is used in the authorization header for all server calls, while the Public key is provided with payment methods at checkout."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For detailed instructions on generating your API keys, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/get-started#generate-api-keys","target":"_blank","rel":"noreferrer","children":"Generate API keys"}],"."]}]}]]}]]}] 22b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Domain registered successfully"}]]}] 22c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An identifier that can be used to determine what went wrong."}],"\n",["$","p","p-1",{"children":"Error codes are not globally unique, but uniqueness is guaranteed within endpoints."}]]}] 22d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Human readable text describing what went wrong."}]]}] 22e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Bad Request"}]]}] 22f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["Domain name of your website without the scheme (i.e. without ",["$","code","code-0",{"children":"http://"}]," or ",["$","code","code-1",{"children":"https://"}],")."]}]]}] 231:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Register your website's domain to accept payments via Apple Pay."}],"\n",["$","p","p-1",{"children":"Before you call this endpoint, make sure that you have completed the following steps:"}],"\n",["$","ol","ol-0",{"children":["\n",["$","li","li-0",{"children":["Download the latest ",["$","a","a-0",{"href":"https://assets.revolut.com/api-docs/merchant-api/files/apple-developer-merchantid-domain-association","target":"_blank","rel":"noreferrer","children":"domain validation file"}],"."]}],"\n",["$","li","li-1",{"children":["Upload the domain validation file to your website in the following folder ",["$","code","code-0",{"children":"/.well-known/"}],". For example, if your website is ",["$","code","code-1",{"children":"example.com"}],", the file should be available on ",["$","code","code-2",{"children":"example.com/.well-known/apple-developer-merchantid-domain-association"}],", where ",["$","code","code-3",{"children":"apple-developer-merchantid-domain-association"}]," indicates the name of the file."]}],"\n"]}]]}] 232:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["This parameter accepts the ",["$","a","a-0",{"href":"https://business.revolut.com/settings/apis?tab=merchant-api","target":"_blank","rel":"noreferrer","children":"Merchant API Secret key"}]," to authorise requests coming from the merchant's backend."]}],"\n",["$","p","p-1",{"children":["It ensures that ensures that each request is authenticated and authorised by verifying the secret key. The secret key should be included in all request headers as a ",["$","code","code-0",{"children":"Bearer"}]," token."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#authentication","target":"_blank","rel":"noreferrer","children":"Authentication"}]]}]}]]}]]}] 2c3:"Upload evidence for a dispute" 35a:["$","$L89",null,{"responses":"$24:props:children:0:props:children:props:responses","headingAs":"h3"}] 35d:T414,
curl -X GET "https://merchant.revolut.com/api/customers?limit=__RP_TOK_0__&page_token=__RP_TOK_1__&from=__RP_TOK_2__&to=__RP_TOK_3__" \
  -H "Authorization: __RP_TOK_4__" \
  -H "Revolut-Api-Version: __RP_TOK_5__"
35e:Ta22,
fetch("https://merchant.revolut.com/api/customers?limit=__RP_TOK_0__&page_token=__RP_TOK_1__&from=__RP_TOK_2__&to=__RP_TOK_3__", {
  method: "GET",
  headers: {
    "Authorization": "__RP_TOK_4__",
    "Revolut-Api-Version": "__RP_TOK_5__"
  }
})
  .then(response => response.json())
  .then(data => console.log(data));
35f:Tfbf,
package main

import (
  "fmt"
  "net/http"
)

func main() {
  url := "https://merchant.revolut.com/api/customers?limit=__RP_TOK_0__&page_token=__RP_TOK_1__&from=__RP_TOK_2__&to=__RP_TOK_3__"
  req, _ := http.NewRequest("GET", url, nil)
  req.Header.Add("Authorization", "__RP_TOK_4__")
  req.Header.Add("Revolut-Api-Version", "__RP_TOK_5__")

  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  fmt.Println(res)
}
360:T834,
import requests

url = "https://merchant.revolut.com/api/customers?limit=__RP_TOK_0__&page_token=__RP_TOK_1__&from=__RP_TOK_2__&to=__RP_TOK_3__"
headers = {
  "Authorization": "__RP_TOK_4__",
  "Revolut-Api-Version": "__RP_TOK_5__"
}

response = requests.get(url, headers=headers)
print(response.json())
361:T1760,
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;

public class Main {
  public static void main(String[] args) {
    HttpClient client = HttpClient.newHttpClient();
    HttpRequest request = HttpRequest.newBuilder()
      .uri(URI.create("https://merchant.revolut.com/api/customers?limit=__RP_TOK_0__&page_token=__RP_TOK_1__&from=__RP_TOK_2__&to=__RP_TOK_3__"))
      .header("Authorization", "__RP_TOK_4__")
      .header("Revolut-Api-Version", "__RP_TOK_5__")
      .GET(HttpRequest.BodyPublishers.noBody())
      .build();

    client.sendAsync(request, HttpResponse.BodyHandlers.ofString())
      .thenApply(HttpResponse::body)
      .thenAccept(System.out::println)
      .join();
  }
}
362:T160a,
using System.Net.Http;
using System.Net.Http.Headers;

var client = new HttpClient();
var request = new HttpRequestMessage
{
  Method = HttpMethod.Get,
  RequestUri = new Uri("https://merchant.revolut.com/api/customers?limit=__RP_TOK_0__&page_token=__RP_TOK_1__&from=__RP_TOK_2__&to=__RP_TOK_3__"),
  Headers =
  {
    { "Authorization", "__RP_TOK_4__" },
    { "Revolut-Api-Version", "__RP_TOK_5__" },
  }
};

using (var response = await client.SendAsync(request))
{
  response.EnsureSuccessStatusCode();
  var body = await response.Content.ReadAsStringAsync();
  Console.WriteLine(body);
}
363:T41c,
curl -X GET "https://sandbox-merchant.revolut.com/api/customers?limit=__RP_TOK_0__&page_token=__RP_TOK_1__&from=__RP_TOK_2__&to=__RP_TOK_3__" \
  -H "Authorization: __RP_TOK_4__" \
  -H "Revolut-Api-Version: __RP_TOK_5__"
364:Ta2a,
fetch("https://sandbox-merchant.revolut.com/api/customers?limit=__RP_TOK_0__&page_token=__RP_TOK_1__&from=__RP_TOK_2__&to=__RP_TOK_3__", {
  method: "GET",
  headers: {
    "Authorization": "__RP_TOK_4__",
    "Revolut-Api-Version": "__RP_TOK_5__"
  }
})
  .then(response => response.json())
  .then(data => console.log(data));
365:Tfc7,
package main

import (
  "fmt"
  "net/http"
)

func main() {
  url := "https://sandbox-merchant.revolut.com/api/customers?limit=__RP_TOK_0__&page_token=__RP_TOK_1__&from=__RP_TOK_2__&to=__RP_TOK_3__"
  req, _ := http.NewRequest("GET", url, nil)
  req.Header.Add("Authorization", "__RP_TOK_4__")
  req.Header.Add("Revolut-Api-Version", "__RP_TOK_5__")

  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  fmt.Println(res)
}
366:T83c,
import requests

url = "https://sandbox-merchant.revolut.com/api/customers?limit=__RP_TOK_0__&page_token=__RP_TOK_1__&from=__RP_TOK_2__&to=__RP_TOK_3__"
headers = {
  "Authorization": "__RP_TOK_4__",
  "Revolut-Api-Version": "__RP_TOK_5__"
}

response = requests.get(url, headers=headers)
print(response.json())
367:T1768,
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;

public class Main {
  public static void main(String[] args) {
    HttpClient client = HttpClient.newHttpClient();
    HttpRequest request = HttpRequest.newBuilder()
      .uri(URI.create("https://sandbox-merchant.revolut.com/api/customers?limit=__RP_TOK_0__&page_token=__RP_TOK_1__&from=__RP_TOK_2__&to=__RP_TOK_3__"))
      .header("Authorization", "__RP_TOK_4__")
      .header("Revolut-Api-Version", "__RP_TOK_5__")
      .GET(HttpRequest.BodyPublishers.noBody())
      .build();

    client.sendAsync(request, HttpResponse.BodyHandlers.ofString())
      .thenApply(HttpResponse::body)
      .thenAccept(System.out::println)
      .join();
  }
}
368:T1612,
using System.Net.Http;
using System.Net.Http.Headers;

var client = new HttpClient();
var request = new HttpRequestMessage
{
  Method = HttpMethod.Get,
  RequestUri = new Uri("https://sandbox-merchant.revolut.com/api/customers?limit=__RP_TOK_0__&page_token=__RP_TOK_1__&from=__RP_TOK_2__&to=__RP_TOK_3__"),
  Headers =
  {
    { "Authorization", "__RP_TOK_4__" },
    { "Revolut-Api-Version", "__RP_TOK_5__" },
  }
};

using (var response = await client.SendAsync(request))
{
  response.EnsureSuccessStatusCode();
  var body = await response.Content.ReadAsStringAsync();
  Console.WriteLine(body);
}
35b:["$","div",null,{"className":"ezz1n32","children":[[["$","$L8a",null,{"itemsByServer":{"https://merchant.revolut.com":[{"id":"curl","label":"cURL","templateCode":"curl -X GET \"https://merchant.revolut.com/api/customers?limit=__RP_TOK_0__&page_token=__RP_TOK_1__&from=__RP_TOK_2__&to=__RP_TOK_3__\" \\\n -H \"Authorization: __RP_TOK_4__\" \\\n -H \"Revolut-Api-Version: __RP_TOK_5__\"","templateHtml":"$35d","tokens":[{"marker":"__RP_TOK_0__","paramName":"limit","paramIn":"query","pipeline":["url-component","shell-double-inner"]},{"marker":"__RP_TOK_1__","paramName":"page_token","paramIn":"query","pipeline":["url-component","shell-double-inner"]},{"marker":"__RP_TOK_2__","paramName":"from","paramIn":"query","pipeline":["url-component","shell-double-inner"]},{"marker":"__RP_TOK_3__","paramName":"to","paramIn":"query","pipeline":["url-component","shell-double-inner"]},{"marker":"__RP_TOK_4__","paramName":"Authorization","paramIn":"header","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_5__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["shell-double-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","query:limit":"100","query:page_token":"string","query:from":"2024-01-01T00:00:00Z","query:to":"2024-01-01T00:00:00Z"}},{"id":"javascript","label":"JavaScript","templateCode":"fetch(\"https://merchant.revolut.com/api/customers?limit=__RP_TOK_0__&page_token=__RP_TOK_1__&from=__RP_TOK_2__&to=__RP_TOK_3__\", {\n method: \"GET\",\n headers: {\n \"Authorization\": \"__RP_TOK_4__\",\n \"Revolut-Api-Version\": \"__RP_TOK_5__\"\n }\n})\n .then(response => response.json())\n .then(data => console.log(data));","templateHtml":"$35e","tokens":[{"marker":"__RP_TOK_0__","paramName":"limit","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"page_token","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"from","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_3__","paramName":"to","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_4__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_5__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","query:limit":"100","query:page_token":"string","query:from":"2024-01-01T00:00:00Z","query:to":"2024-01-01T00:00:00Z"}},{"id":"go","label":"Go","templateCode":"package main\n\nimport (\n \"fmt\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://merchant.revolut.com/api/customers?limit=__RP_TOK_0__&page_token=__RP_TOK_1__&from=__RP_TOK_2__&to=__RP_TOK_3__\"\n req, _ := http.NewRequest(\"GET\", url, nil)\n req.Header.Add(\"Authorization\", \"__RP_TOK_4__\")\n req.Header.Add(\"Revolut-Api-Version\", \"__RP_TOK_5__\")\n\n res, _ := http.DefaultClient.Do(req)\n defer res.Body.Close()\n fmt.Println(res)\n}","templateHtml":"$35f","tokens":[{"marker":"__RP_TOK_0__","paramName":"limit","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"page_token","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"from","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_3__","paramName":"to","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_4__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_5__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","query:limit":"100","query:page_token":"string","query:from":"2024-01-01T00:00:00Z","query:to":"2024-01-01T00:00:00Z"}},{"id":"python","label":"Python","templateCode":"import requests\n\nurl = \"https://merchant.revolut.com/api/customers?limit=__RP_TOK_0__&page_token=__RP_TOK_1__&from=__RP_TOK_2__&to=__RP_TOK_3__\"\nheaders = {\n \"Authorization\": \"__RP_TOK_4__\",\n \"Revolut-Api-Version\": \"__RP_TOK_5__\"\n}\n\nresponse = requests.get(url, headers=headers)\nprint(response.json())","templateHtml":"$360","tokens":[{"marker":"__RP_TOK_0__","paramName":"limit","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"page_token","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"from","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_3__","paramName":"to","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_4__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_5__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","query:limit":"100","query:page_token":"string","query:from":"2024-01-01T00:00:00Z","query:to":"2024-01-01T00:00:00Z"}},{"id":"java","label":"Java","templateCode":"import java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\nimport java.net.URI;\n\npublic class Main {\n public static void main(String[] args) {\n HttpClient client = HttpClient.newHttpClient();\n HttpRequest request = HttpRequest.newBuilder()\n .uri(URI.create(\"https://merchant.revolut.com/api/customers?limit=__RP_TOK_0__&page_token=__RP_TOK_1__&from=__RP_TOK_2__&to=__RP_TOK_3__\"))\n .header(\"Authorization\", \"__RP_TOK_4__\")\n .header(\"Revolut-Api-Version\", \"__RP_TOK_5__\")\n .GET(HttpRequest.BodyPublishers.noBody())\n .build();\n\n client.sendAsync(request, HttpResponse.BodyHandlers.ofString())\n .thenApply(HttpResponse::body)\n .thenAccept(System.out::println)\n .join();\n }\n}","templateHtml":"$361","tokens":[{"marker":"__RP_TOK_0__","paramName":"limit","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"page_token","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"from","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_3__","paramName":"to","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_4__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_5__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","query:limit":"100","query:page_token":"string","query:from":"2024-01-01T00:00:00Z","query:to":"2024-01-01T00:00:00Z"}},{"id":"csharp","label":"C#","templateCode":"using System.Net.Http;\nusing System.Net.Http.Headers;\n\nvar client = new HttpClient();\nvar request = new HttpRequestMessage\n{\n Method = HttpMethod.Get,\n RequestUri = new Uri(\"https://merchant.revolut.com/api/customers?limit=__RP_TOK_0__&page_token=__RP_TOK_1__&from=__RP_TOK_2__&to=__RP_TOK_3__\"),\n Headers =\n {\n { \"Authorization\", \"__RP_TOK_4__\" },\n { \"Revolut-Api-Version\", \"__RP_TOK_5__\" },\n }\n};\n\nusing (var response = await client.SendAsync(request))\n{\n response.EnsureSuccessStatusCode();\n var body = await response.Content.ReadAsStringAsync();\n Console.WriteLine(body);\n}","templateHtml":"$362","tokens":[{"marker":"__RP_TOK_0__","paramName":"limit","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"page_token","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"from","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_3__","paramName":"to","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_4__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_5__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","query:limit":"100","query:page_token":"string","query:from":"2024-01-01T00:00:00Z","query:to":"2024-01-01T00:00:00Z"}}],"https://sandbox-merchant.revolut.com":[{"id":"curl","label":"cURL","templateCode":"curl -X GET \"https://sandbox-merchant.revolut.com/api/customers?limit=__RP_TOK_0__&page_token=__RP_TOK_1__&from=__RP_TOK_2__&to=__RP_TOK_3__\" \\\n -H \"Authorization: __RP_TOK_4__\" \\\n -H \"Revolut-Api-Version: __RP_TOK_5__\"","templateHtml":"$363","tokens":[{"marker":"__RP_TOK_0__","paramName":"limit","paramIn":"query","pipeline":["url-component","shell-double-inner"]},{"marker":"__RP_TOK_1__","paramName":"page_token","paramIn":"query","pipeline":["url-component","shell-double-inner"]},{"marker":"__RP_TOK_2__","paramName":"from","paramIn":"query","pipeline":["url-component","shell-double-inner"]},{"marker":"__RP_TOK_3__","paramName":"to","paramIn":"query","pipeline":["url-component","shell-double-inner"]},{"marker":"__RP_TOK_4__","paramName":"Authorization","paramIn":"header","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_5__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["shell-double-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","query:limit":"100","query:page_token":"string","query:from":"2024-01-01T00:00:00Z","query:to":"2024-01-01T00:00:00Z"}},{"id":"javascript","label":"JavaScript","templateCode":"fetch(\"https://sandbox-merchant.revolut.com/api/customers?limit=__RP_TOK_0__&page_token=__RP_TOK_1__&from=__RP_TOK_2__&to=__RP_TOK_3__\", {\n method: \"GET\",\n headers: {\n \"Authorization\": \"__RP_TOK_4__\",\n \"Revolut-Api-Version\": \"__RP_TOK_5__\"\n }\n})\n .then(response => response.json())\n .then(data => console.log(data));","templateHtml":"$364","tokens":[{"marker":"__RP_TOK_0__","paramName":"limit","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"page_token","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"from","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_3__","paramName":"to","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_4__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_5__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","query:limit":"100","query:page_token":"string","query:from":"2024-01-01T00:00:00Z","query:to":"2024-01-01T00:00:00Z"}},{"id":"go","label":"Go","templateCode":"package main\n\nimport (\n \"fmt\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://sandbox-merchant.revolut.com/api/customers?limit=__RP_TOK_0__&page_token=__RP_TOK_1__&from=__RP_TOK_2__&to=__RP_TOK_3__\"\n req, _ := http.NewRequest(\"GET\", url, nil)\n req.Header.Add(\"Authorization\", \"__RP_TOK_4__\")\n req.Header.Add(\"Revolut-Api-Version\", \"__RP_TOK_5__\")\n\n res, _ := http.DefaultClient.Do(req)\n defer res.Body.Close()\n fmt.Println(res)\n}","templateHtml":"$365","tokens":[{"marker":"__RP_TOK_0__","paramName":"limit","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"page_token","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"from","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_3__","paramName":"to","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_4__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_5__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","query:limit":"100","query:page_token":"string","query:from":"2024-01-01T00:00:00Z","query:to":"2024-01-01T00:00:00Z"}},{"id":"python","label":"Python","templateCode":"import requests\n\nurl = \"https://sandbox-merchant.revolut.com/api/customers?limit=__RP_TOK_0__&page_token=__RP_TOK_1__&from=__RP_TOK_2__&to=__RP_TOK_3__\"\nheaders = {\n \"Authorization\": \"__RP_TOK_4__\",\n \"Revolut-Api-Version\": \"__RP_TOK_5__\"\n}\n\nresponse = requests.get(url, headers=headers)\nprint(response.json())","templateHtml":"$366","tokens":[{"marker":"__RP_TOK_0__","paramName":"limit","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"page_token","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"from","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_3__","paramName":"to","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_4__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_5__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","query:limit":"100","query:page_token":"string","query:from":"2024-01-01T00:00:00Z","query:to":"2024-01-01T00:00:00Z"}},{"id":"java","label":"Java","templateCode":"import java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\nimport java.net.URI;\n\npublic class Main {\n public static void main(String[] args) {\n HttpClient client = HttpClient.newHttpClient();\n HttpRequest request = HttpRequest.newBuilder()\n .uri(URI.create(\"https://sandbox-merchant.revolut.com/api/customers?limit=__RP_TOK_0__&page_token=__RP_TOK_1__&from=__RP_TOK_2__&to=__RP_TOK_3__\"))\n .header(\"Authorization\", \"__RP_TOK_4__\")\n .header(\"Revolut-Api-Version\", \"__RP_TOK_5__\")\n .GET(HttpRequest.BodyPublishers.noBody())\n .build();\n\n client.sendAsync(request, HttpResponse.BodyHandlers.ofString())\n .thenApply(HttpResponse::body)\n .thenAccept(System.out::println)\n .join();\n }\n}","templateHtml":"$367","tokens":[{"marker":"__RP_TOK_0__","paramName":"limit","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"page_token","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"from","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_3__","paramName":"to","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_4__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_5__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","query:limit":"100","query:page_token":"string","query:from":"2024-01-01T00:00:00Z","query:to":"2024-01-01T00:00:00Z"}},{"id":"csharp","label":"C#","templateCode":"using System.Net.Http;\nusing System.Net.Http.Headers;\n\nvar client = new HttpClient();\nvar request = new HttpRequestMessage\n{\n Method = HttpMethod.Get,\n RequestUri = new Uri(\"https://sandbox-merchant.revolut.com/api/customers?limit=__RP_TOK_0__&page_token=__RP_TOK_1__&from=__RP_TOK_2__&to=__RP_TOK_3__\"),\n Headers =\n {\n { \"Authorization\", \"__RP_TOK_4__\" },\n { \"Revolut-Api-Version\", \"__RP_TOK_5__\" },\n }\n};\n\nusing (var response = await client.SendAsync(request))\n{\n response.EnsureSuccessStatusCode();\n var body = await response.Content.ReadAsStringAsync();\n Console.WriteLine(body);\n}","templateHtml":"$368","tokens":[{"marker":"__RP_TOK_0__","paramName":"limit","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"page_token","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"from","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_3__","paramName":"to","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_4__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_5__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","query:limit":"100","query:page_token":"string","query:from":"2024-01-01T00:00:00Z","query:to":"2024-01-01T00:00:00Z"}}]},"method":"get","servers":"$62:props:children:0:props:children:props:children:1:props:children:1:props:children:0:0:props:servers","path":"/api/customers","parameters":["$24:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:0","$24:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:1","$24:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:2","$24:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:3","$24:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:4","$24:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:5"]}],"$L369"],"$L36a","$L36b"]}] 2d9:"Retrieve a webhook list" 2f0:"Unregister domain for Apple Pay" 242:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The ID of the synchronous webhook object."}]]}] 243:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["A randomly generated signing key, which can be used by merchants to authenticate requests from Revolut by verifying the signature. For more information, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#authentication","target":"_blank","rel":"noreferrer","children":"Payload Signature"}],"."]}]]}] 244:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The valid URL of the endpoint, that uses HTTPS URL schema. Revolut sends the shipping address of the customer to this URL for validation."}],"\n",["$","div","inlinealert-0",{"data-type":"warning","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMark","color":"var(--rui-color-warning)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"Restrictions:"}],["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["Must be a valid URI as defined by ",["$","a","a-0",{"href":"https://datatracker.ietf.org/doc/html/rfc3986","target":"_blank","rel":"noreferrer","children":"RFC 3986"}]]}],"\n",["$","li","li-1",{"children":["URI scheme is required and must be ",["$","code","code-0",{"children":"https"}]]}],"\n",["$","li","li-2",{"children":["URI host is required and cannot be ",["$","code","code-0",{"children":"localhost"}]," or an IP address"]}],"\n",["$","li","li-3",{"children":["Max length: ",["$","code","code-0",{"children":"2000"}]]}],"\n",["$","li","li-4",{"children":["Reserved or invalid characters must be percent-encoded (for example, use ",["$","code","code-0",{"children":"%20"}]," instead of a space)"]}],"\n"]}]]}]]}]]}] 245:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Type of event this synchronous webhook is configured for."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":"At the moment, synchronous webhooks only support address validation events."}]}]]}]]}] 246:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unique ID representing the location where merchants sells products."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#tag-locations","target":"_blank","rel":"noreferrer","children":"Locations"}],"."]}]}]]}]]}] 247:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Synchronous webhook list returned"}]]}] 248:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The ID of the error. You can share this ID with Revolut support for troubleshooting."}]]}] 249:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The date and time the error happened."}]]}] 24a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Bad Request"}]]}] 24b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unauthorized"}]]}] 24f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Renewal date updated successfully"}]]}] 250:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An identifier that can be used to determine what went wrong."}],"\n",["$","p","p-1",{"children":"Error codes are not globally unique, but uniqueness is guaranteed within endpoints."}]]}] 251:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Some human readable text describing what went wrong."}]]}] 252:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://www.unixtimestamp.com/","target":"_blank","rel":"noreferrer","children":"UNIX timestamp"}]," of the date and time the error happened."]}]]}] 253:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Bad Request"}]]}] 254:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An identifier that can be used to determine what went wrong."}],"\n",["$","p","p-1",{"children":"Error codes are not globally unique, but uniqueness is guaranteed within endpoints."}]]}] 255:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Some human readable text describing what went wrong."}]]}] 256:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://www.unixtimestamp.com/","target":"_blank","rel":"noreferrer","children":"UNIX timestamp"}]," of the date and time the error happened."]}]]}] 257:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unauthorized"}]]}] 258:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An identifier that can be used to determine what went wrong."}],"\n",["$","p","p-1",{"children":"Error codes are not globally unique, but uniqueness is guaranteed within endpoints."}]]}] 259:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Some human readable text describing what went wrong."}]]}] 25a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://www.unixtimestamp.com/","target":"_blank","rel":"noreferrer","children":"UNIX timestamp"}]," of the date and time the error happened."]}]]}] 25b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Subscription not found"}]]}] 25c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An identifier that can be used to determine what went wrong."}],"\n",["$","p","p-1",{"children":"Error codes are not globally unique, but uniqueness is guaranteed within endpoints."}]]}] 25d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Some human readable text describing what went wrong."}]]}] 25e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://www.unixtimestamp.com/","target":"_blank","rel":"noreferrer","children":"UNIX timestamp"}]," of the date and time the error happened."]}]]}] 25f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unprocessable entity (business rule violation)"}]]}] 260:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An identifier that can be used to determine what went wrong."}],"\n",["$","p","p-1",{"children":"Error codes are not globally unique, but uniqueness is guaranteed within endpoints."}]]}] 36e:T47c,List of event types that the webhook is configured to listen to. Each event is related to status changes of a specific object in the Merchant API: | Object | Event types | | --------- | ----------- | | `Order` |
  • `ORDER_COMPLETED`
  • `ORDER_AUTHORISED`
  • `ORDER_CANCELLED`
  • `ORDER_FAILED`
  • `ORDER_INCREMENTAL_AUTHORISATION_AUTHORISED`
  • `ORDER_INCREMENTAL_AUTHORISATION_DECLINED`
  • `ORDER_INCREMENTAL_AUTHORISATION_FAILED`
| | `Payment` |
  • `ORDER_PAYMENT_AUTHENTICATION_CHALLENGED`
  • `ORDER_PAYMENT_AUTHENTICATED`
  • `ORDER_PAYMENT_AUTHORISATION_STARTED`
  • `ORDER_PAYMENT_DECLINED`
  • `ORDER_PAYMENT_FAILED`
| | `Subscription` |
  • `SUBSCRIPTION_INITIATED`
  • `SUBSCRIPTION_FINISHED`
  • `SUBSCRIPTION_CANCELLED`
  • `SUBSCRIPTION_OVERDUE`
| | `Payout` |
  • `PAYOUT_INITIATED`
  • `PAYOUT_COMPLETED`
  • `PAYOUT_FAILED`
| | `Dispute` |
  • `DISPUTE_ACTION_REQUIRED`
  • `DISPUTE_UNDER_REVIEW`
  • `DISPUTE_WON`
  • `DISPUTE_LOST`
|5c:["$","$7a","rotate-webhook-signing-secret",{"children":[["$","section",null,{"className":"y9a0do0","data-variant":"endpoint","children":["$","$L7b",null,{"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"title":"Webhook","type":"object","description":"A webhook object.\n\nUnlike the legacy API, `signing_secret` is included in all webhook responses, not only on creation.","properties":{"id":{"type":"string","format":"uuid","description":"The ID of the webhook.","descriptionNode":"$L36c"},"url":{"type":"string","format":"uri","pattern":"^https?:\\/{2}.+/gi","maxLength":2000,"description":"Your webhook's URL to which event notifications will be sent. \n\nMust be a valid HTTP or HTTPS URL, capable of receiving `POST` requests.\n\n:::warning\nRestrictions:\n- Must be a valid URI as defined by [RFC 3986](https://datatracker.ietf.org/doc/html/rfc3986)\n- URI scheme is required and must be either `http` or `https`\n- URI host is required and cannot be `localhost` or an IP address\n- Max length: `2000`\n- Reserved or invalid characters must be percent-encoded (for example, use `%20` instead of a space)\n:::","descriptionNode":"$L36d"},"events":{"type":"array","description":"$36e","items":{"type":"string","description":"The available event types your can listen to.","enum":"$59:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:events:items:enum","descriptionNode":"$L36f"},"minItems":1,"descriptionNode":"$L370"},"signing_secret":{"type":"string","description":"The signing secret for the webhook. Use it to verify the signature for the webhook request's payload.","descriptionNode":"$L371"}},"required":"$59:props:children:0:props:children:props:responses:200:content:application/json:schema:required","descriptionNode":"$L372"},"examples":{"updated_webhook":{"summary":"Webhook","value":"$59:props:children:0:props:children:props:responses:200:content:application/json:examples:retrieved_webhook:value"}}}},"descriptionNode":"$L373"},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"code":{"type":"string","description":"An identifier that can be used to determine what went wrong.\n\nError codes are not globally unique, but uniqueness is guaranteed within endpoints.","descriptionNode":"$L374"},"message":{"type":"string","description":"Some human readable text describing what went wrong.","descriptionNode":"$L375"},"timestamp":{"type":"integer","description":"The [UNIX timestamp](https://www.unixtimestamp.com/) of the date and time the error happened.","descriptionNode":"$L376"}}}}},"descriptionNode":"$L377"},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"code":{"type":"string","description":"An identifier that can be used to determine what went wrong.\n\nError codes are not globally unique, but uniqueness is guaranteed within endpoints.","descriptionNode":"$L378"},"message":{"type":"string","description":"Some human readable text describing what went wrong.","descriptionNode":"$L379"},"timestamp":{"type":"integer","description":"The [UNIX timestamp](https://www.unixtimestamp.com/) of the date and time the error happened.","descriptionNode":"$L37a"}}}}},"descriptionNode":"$L37b"},"404":{"description":"Not Found","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"code":{"type":"string","description":"An identifier that can be used to determine what went wrong.\n\nError codes are not globally unique, but uniqueness is guaranteed within endpoints.","descriptionNode":"$L37c"},"message":{"type":"string","description":"Some human readable text describing what went wrong.","descriptionNode":"$L37d"},"timestamp":{"type":"integer","description":"The [UNIX timestamp](https://www.unixtimestamp.com/) of the date and time the error happened.","descriptionNode":"$L37e"}}}}},"descriptionNode":"$L37f"}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"expiration_period":{"type":"string","format":"duration","description":"The expiration period of the signing secret in the [ISO 8601 format](https://en.wikipedia.org/wiki/ISO_8601#Durations).\n\nIf defined, when the signing secret is rotated, it continues to be valid until the expiration period passes.\n\nOtherwise, it is invalidated immediately.\n\nMaximum expiration period is 7 days.","examples":["PT5H30M"],"descriptionNode":"$L380"}}},"examples":{"webhook_signing_secret_rotate_request":{"summary":"Webhook signing secret rotation request","value":{"expiration_period":"PT5H30M"}}}}}},"variantLabels":[],"children":["$L381","$L382"]}]}],false]}] 111:["$","div","401-application/json-default",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"
{\n  \"errorId\": \"string\",\n  \"timestamp\": 123\n}
"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"errorId\": \"string\",\n \"timestamp\": 123\n}"}]}]]}] 112:["$","div","404-application/json-default",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"
{\n  \"errorId\": \"string\",\n  \"timestamp\": 123\n}
"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"errorId\": \"string\",\n \"timestamp\": 123\n}"}]}]]}] 114:["$","div","404-application/json-default",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"
{\n  \"errorId\": \"string\",\n  \"timestamp\": 123\n}
"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"errorId\": \"string\",\n \"timestamp\": 123\n}"}]}]]}] 383:T44d,
{
  "code": "string",
  "message": "string",
  "timestamp": 123
}
116:["$","div","401-application/json-default",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$383"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"code\": \"string\",\n \"message\": \"string\",\n \"timestamp\": 123\n}"}]}]]}] 384:T44d,
{
  "code": "string",
  "message": "string",
  "timestamp": 123
}
117:["$","div","404-application/json-default",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$384"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"code\": \"string\",\n \"message\": \"string\",\n \"timestamp\": 123\n}"}]}]]}] 267:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Each Merchant API request must contain an authorization header in the following format:"}],"\n","$L385","\n",["$","p","p-1",{"children":"To use this API, you need to generate API keys from your Revolut Business account. The Secret key is used in the authorization header for all server calls, while the Public key is provided with payment methods at checkout."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For detailed instructions on generating your API keys, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/get-started#generate-api-keys","target":"_blank","rel":"noreferrer","children":"Generate API keys"}],"."]}]}]]}]]}] 26a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Retrieve a list of synchronous webhook objects."}],"\n",["$","p","p-1",{"children":"You can use this endpoint to see your different address validation endpoints registered to different locations."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information about locations, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#tag-locations","target":"_blank","rel":"noreferrer","children":"Merchant API: Locations"}],"."]}]}]]}]]}] 26b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["This parameter accepts the ",["$","a","a-0",{"href":"https://business.revolut.com/settings/apis?tab=merchant-api","target":"_blank","rel":"noreferrer","children":"Merchant API Secret key"}]," to authorise requests coming from the merchant's backend."]}],"\n",["$","p","p-1",{"children":["It ensures that ensures that each request is authenticated and authorised by verifying the secret key. The secret key should be included in all request headers as a ",["$","code","code-0",{"children":"Bearer"}]," token."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#authentication","target":"_blank","rel":"noreferrer","children":"Authentication"}]]}]}]]}]]}] 326:"Retrieve a payout list" 369:["$","$L10d",null,{"security":[{"Api-Key":[]}],"authorization":{"Api-Key":{"type":"apiKey","in":"header","name":"Authorization","description":"Each Merchant API request must contain an authorization header in the following format:\n\n```\n'Authorization: Bearer '\n```\n\nTo use this API, you need to generate API keys from your Revolut Business account. The Secret key is used in the authorization header for all server calls, while the Public key is provided with payment methods at checkout.\n\n:::info\nFor detailed instructions on generating your API keys, see: [Generate API keys](https://developer.revolut.com/docs/guides/merchant/get-started#generate-api-keys).\n:::","descriptionNode":"$L386"}}}] 36a:["$","$L10f",null,{"exampleBlocks":{},"title":"Request body samples","headingAs":"h4"}] 36b:["$","$L110",null,{"exampleBlocks":{"200":{"application/json":{"variants":[{"key":"list_of_customers","label":"List of customers","rawValue":"$24:props:children:0:props:children:props:responses:200:content:application/json:examples:list_of_customers:value","block":"$L387"}],"syncedPropertyName":"$undefined"}},"401":{"application/json":{"variants":[{"key":"default","label":"Example","rawValue":{"code":"string","message":"string","timestamp":123},"block":"$L388"}],"syncedPropertyName":"$undefined"}}},"headingAs":"h4"}] 381:["$","div",null,{"className":"ezz1n30","children":[["$","div",null,{"data-header":"$undefined","className":"ezz1n31","children":["$","div",null,{"className":"y9a0do1","children":[["$","h2",null,{"id":"rotate-webhook-signing-secret","children":[["$L389","$undefined"],["$","$L15",null,{"id":"rotate-webhook-signing-secret"}]]}],["$","$L16",null,{"url":"/docs/api/merchant/2025-10-16/operations/rotate-webhook-signing-secret.md"}]]}]}],"$undefined"]}] 38f:T659,
curl -X POST "https://merchant.revolut.com/api/webhooks/__RP_TOK_0__/rotate-signing-secret" \
  -H "Content-Type: application/json" \
  -H "Authorization: __RP_TOK_1__" \
  -H "Revolut-Api-Version: __RP_TOK_2__" \
  -d '{
  "expiration_period": "PT5H30M"
}'
390:Tea2,
const payload = {
  "expiration_period": "PT5H30M"
};
fetch("https://merchant.revolut.com/api/webhooks/__RP_TOK_0__/rotate-signing-secret", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "__RP_TOK_1__",
    "Revolut-Api-Version": "__RP_TOK_2__"
  },
  body: JSON.stringify(payload)
})
  .then(response => response.json())
  .then(data => console.log(data));
391:T163e,
package main

import (
  "fmt"
  "net/http"
  "bytes"
  "encoding/json"
)

func main() {
  url := "https://merchant.revolut.com/api/webhooks/__RP_TOK_0__/rotate-signing-secret"
  jsonData := []byte(`
{
  "expiration_period": "PT5H30M"
}
  `)
  req, _ := http.NewRequest("POST", url, bytes.NewBuffer(jsonData))
  req.Header.Add("Content-Type", "application/json")
  req.Header.Add("Authorization", "__RP_TOK_1__")
  req.Header.Add("Revolut-Api-Version", "__RP_TOK_2__")

  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  fmt.Println(res)
}
392:Tbd6,
import requests

url = "https://merchant.revolut.com/api/webhooks/__RP_TOK_0__/rotate-signing-secret"
headers = {
  "Content-Type": "application/json",
  "Authorization": "__RP_TOK_1__",
  "Revolut-Api-Version": "__RP_TOK_2__"
}
payload = {
  "expiration_period": "PT5H30M"
}

response = requests.post(url, headers=headers, json=payload)
print(response.json())
393:T1ba2,
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;

public class Main {
  public static void main(String[] args) {
    HttpClient client = HttpClient.newHttpClient();
    String body = """
{
  "expiration_period": "PT5H30M"
}
    """;

    HttpRequest request = HttpRequest.newBuilder()
      .uri(URI.create("https://merchant.revolut.com/api/webhooks/__RP_TOK_0__/rotate-signing-secret"))
      .header("Content-Type", "application/json")
      .header("Authorization", "__RP_TOK_1__")
      .header("Revolut-Api-Version", "__RP_TOK_2__")
      .POST(HttpRequest.BodyPublishers.ofString(body))
      .build();

    client.sendAsync(request, HttpResponse.BodyHandlers.ofString())
      .thenApply(HttpResponse::body)
      .thenAccept(System.out::println)
      .join();
  }
}
394:T1d8a,
using System.Net.Http;
using System.Net.Http.Headers;

var client = new HttpClient();
var request = new HttpRequestMessage
{
  Method = HttpMethod.Post,
  RequestUri = new Uri("https://merchant.revolut.com/api/webhooks/__RP_TOK_0__/rotate-signing-secret"),
  Headers =
  {
    { "Authorization", "__RP_TOK_1__" },
    { "Revolut-Api-Version", "__RP_TOK_2__" },
  },
  Content = new StringContent(@"{
  ""expiration_period"": ""PT5H30M""
}")
  {
    Headers =
    {
      ContentType = new MediaTypeHeaderValue("application/json")
    }
  }
};

using (var response = await client.SendAsync(request))
{
  response.EnsureSuccessStatusCode();
  var body = await response.Content.ReadAsStringAsync();
  Console.WriteLine(body);
}
395:T661,
curl -X POST "https://sandbox-merchant.revolut.com/api/webhooks/__RP_TOK_0__/rotate-signing-secret" \
  -H "Content-Type: application/json" \
  -H "Authorization: __RP_TOK_1__" \
  -H "Revolut-Api-Version: __RP_TOK_2__" \
  -d '{
  "expiration_period": "PT5H30M"
}'
396:Teaa,
const payload = {
  "expiration_period": "PT5H30M"
};
fetch("https://sandbox-merchant.revolut.com/api/webhooks/__RP_TOK_0__/rotate-signing-secret", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "__RP_TOK_1__",
    "Revolut-Api-Version": "__RP_TOK_2__"
  },
  body: JSON.stringify(payload)
})
  .then(response => response.json())
  .then(data => console.log(data));
397:T1646,
package main

import (
  "fmt"
  "net/http"
  "bytes"
  "encoding/json"
)

func main() {
  url := "https://sandbox-merchant.revolut.com/api/webhooks/__RP_TOK_0__/rotate-signing-secret"
  jsonData := []byte(`
{
  "expiration_period": "PT5H30M"
}
  `)
  req, _ := http.NewRequest("POST", url, bytes.NewBuffer(jsonData))
  req.Header.Add("Content-Type", "application/json")
  req.Header.Add("Authorization", "__RP_TOK_1__")
  req.Header.Add("Revolut-Api-Version", "__RP_TOK_2__")

  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  fmt.Println(res)
}
398:Tbde,
import requests

url = "https://sandbox-merchant.revolut.com/api/webhooks/__RP_TOK_0__/rotate-signing-secret"
headers = {
  "Content-Type": "application/json",
  "Authorization": "__RP_TOK_1__",
  "Revolut-Api-Version": "__RP_TOK_2__"
}
payload = {
  "expiration_period": "PT5H30M"
}

response = requests.post(url, headers=headers, json=payload)
print(response.json())
399:T1baa,
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;

public class Main {
  public static void main(String[] args) {
    HttpClient client = HttpClient.newHttpClient();
    String body = """
{
  "expiration_period": "PT5H30M"
}
    """;

    HttpRequest request = HttpRequest.newBuilder()
      .uri(URI.create("https://sandbox-merchant.revolut.com/api/webhooks/__RP_TOK_0__/rotate-signing-secret"))
      .header("Content-Type", "application/json")
      .header("Authorization", "__RP_TOK_1__")
      .header("Revolut-Api-Version", "__RP_TOK_2__")
      .POST(HttpRequest.BodyPublishers.ofString(body))
      .build();

    client.sendAsync(request, HttpResponse.BodyHandlers.ofString())
      .thenApply(HttpResponse::body)
      .thenAccept(System.out::println)
      .join();
  }
}
39a:T1d92,
using System.Net.Http;
using System.Net.Http.Headers;

var client = new HttpClient();
var request = new HttpRequestMessage
{
  Method = HttpMethod.Post,
  RequestUri = new Uri("https://sandbox-merchant.revolut.com/api/webhooks/__RP_TOK_0__/rotate-signing-secret"),
  Headers =
  {
    { "Authorization", "__RP_TOK_1__" },
    { "Revolut-Api-Version", "__RP_TOK_2__" },
  },
  Content = new StringContent(@"{
  ""expiration_period"": ""PT5H30M""
}")
  {
    Headers =
    {
      ContentType = new MediaTypeHeaderValue("application/json")
    }
  }
};

using (var response = await client.SendAsync(request))
{
  response.EnsureSuccessStatusCode();
  var body = await response.Content.ReadAsStringAsync();
  Console.WriteLine(body);
}
382:["$","div",null,{"className":"ezz1n30","children":[["$","div",null,{"data-header":"$undefined","className":"ezz1n31","children":["$L38a",["$","$L85",null,{"parameters":[{"name":"Authorization","in":"header","schema":{"type":"string","format":"Bearer ","examples":"$62:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:0:schema:examples"},"required":true,"description":"This parameter accepts the [Merchant API Secret key](https://business.revolut.com/settings/apis?tab=merchant-api) to authorise requests coming from the merchant's backend. \n\nIt ensures that ensures that each request is authenticated and authorised by verifying the secret key. The secret key should be included in all request headers as a `Bearer` token.\n\n:::info\nFor more information, see: [Authentication](https://developer.revolut.com/docs/api/merchant#authentication)\n:::","descriptionNode":"$L38b"},{"name":"Revolut-Api-Version","in":"header","schema":{"type":"string","format":"date","enum":"$27:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:1:schema:enum","examples":"$27:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:1:schema:examples"},"required":true,"description":"The version of the Merchant API, specified in `YYYY-MM-DD` format.\n\nThis endpoint is available from version `2024-09-01`. If a version earlier than `2024-09-01` is provided, the endpoint returns a `404` response.\n\nIf not specified, you will receive an error.\n\n\n:::info\nFor more information about API versioning, see: [API versions](https://developer.revolut.com/docs/guides/merchant/reference/versioning/api-versions).\n:::","x-config-always-visible-in-example":true,"example":"2025-10-16","descriptionNode":"$L38c"},{"name":"webhook_id","in":"path","schema":{"type":"string","format":"uuid","description":"A UUID string, typically used to identify resources.","descriptionNode":"$L38d"},"required":true,"description":"The ID of the webhook.","descriptionNode":"$L38e"}],"requestBody":"$5c:props:children:0:props:children:props:requestBody","heading":"Request","requestBodySchemaTitle":"Request body","headingAs":"h3"}],["$","$L89",null,{"responses":"$5c:props:children:0:props:children:props:responses","headingAs":"h3"}]]}],["$","div",null,{"className":"ezz1n32","children":[[["$","$L8a",null,{"itemsByServer":{"https://merchant.revolut.com":[{"id":"curl","label":"cURL","templateCode":"curl -X POST \"https://merchant.revolut.com/api/webhooks/__RP_TOK_0__/rotate-signing-secret\" \\\n -H \"Content-Type: application/json\" \\\n -H \"Authorization: __RP_TOK_1__\" \\\n -H \"Revolut-Api-Version: __RP_TOK_2__\" \\\n -d '{\n \"expiration_period\": \"PT5H30M\"\n}'","templateHtml":"$38f","tokens":[{"marker":"__RP_TOK_0__","paramName":"webhook_id","paramIn":"path","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["shell-double-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:webhook_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"javascript","label":"JavaScript","templateCode":"const payload = {\n \"expiration_period\": \"PT5H30M\"\n};\nfetch(\"https://merchant.revolut.com/api/webhooks/__RP_TOK_0__/rotate-signing-secret\", {\n method: \"POST\",\n headers: {\n \"Content-Type\": \"application/json\",\n \"Authorization\": \"__RP_TOK_1__\",\n \"Revolut-Api-Version\": \"__RP_TOK_2__\"\n },\n body: JSON.stringify(payload)\n})\n .then(response => response.json())\n .then(data => console.log(data));","templateHtml":"$390","tokens":[{"marker":"__RP_TOK_0__","paramName":"webhook_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:webhook_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"go","label":"Go","templateCode":"package main\n\nimport (\n \"fmt\"\n \"net/http\"\n \"bytes\"\n \"encoding/json\"\n)\n\nfunc main() {\n url := \"https://merchant.revolut.com/api/webhooks/__RP_TOK_0__/rotate-signing-secret\"\n jsonData := []byte(`\n{\n \"expiration_period\": \"PT5H30M\"\n}\n `)\n req, _ := http.NewRequest(\"POST\", url, bytes.NewBuffer(jsonData))\n req.Header.Add(\"Content-Type\", \"application/json\")\n req.Header.Add(\"Authorization\", \"__RP_TOK_1__\")\n req.Header.Add(\"Revolut-Api-Version\", \"__RP_TOK_2__\")\n\n res, _ := http.DefaultClient.Do(req)\n defer res.Body.Close()\n fmt.Println(res)\n}","templateHtml":"$391","tokens":[{"marker":"__RP_TOK_0__","paramName":"webhook_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:webhook_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"python","label":"Python","templateCode":"import requests\n\nurl = \"https://merchant.revolut.com/api/webhooks/__RP_TOK_0__/rotate-signing-secret\"\nheaders = {\n \"Content-Type\": \"application/json\",\n \"Authorization\": \"__RP_TOK_1__\",\n \"Revolut-Api-Version\": \"__RP_TOK_2__\"\n}\npayload = {\n \"expiration_period\": \"PT5H30M\"\n}\n\nresponse = requests.post(url, headers=headers, json=payload)\nprint(response.json())","templateHtml":"$392","tokens":[{"marker":"__RP_TOK_0__","paramName":"webhook_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:webhook_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"java","label":"Java","templateCode":"import java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\nimport java.net.URI;\n\npublic class Main {\n public static void main(String[] args) {\n HttpClient client = HttpClient.newHttpClient();\n String body = \"\"\"\n{\n \"expiration_period\": \"PT5H30M\"\n}\n \"\"\";\n\n HttpRequest request = HttpRequest.newBuilder()\n .uri(URI.create(\"https://merchant.revolut.com/api/webhooks/__RP_TOK_0__/rotate-signing-secret\"))\n .header(\"Content-Type\", \"application/json\")\n .header(\"Authorization\", \"__RP_TOK_1__\")\n .header(\"Revolut-Api-Version\", \"__RP_TOK_2__\")\n .POST(HttpRequest.BodyPublishers.ofString(body))\n .build();\n\n client.sendAsync(request, HttpResponse.BodyHandlers.ofString())\n .thenApply(HttpResponse::body)\n .thenAccept(System.out::println)\n .join();\n }\n}","templateHtml":"$393","tokens":[{"marker":"__RP_TOK_0__","paramName":"webhook_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:webhook_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"csharp","label":"C#","templateCode":"using System.Net.Http;\nusing System.Net.Http.Headers;\n\nvar client = new HttpClient();\nvar request = new HttpRequestMessage\n{\n Method = HttpMethod.Post,\n RequestUri = new Uri(\"https://merchant.revolut.com/api/webhooks/__RP_TOK_0__/rotate-signing-secret\"),\n Headers =\n {\n { \"Authorization\", \"__RP_TOK_1__\" },\n { \"Revolut-Api-Version\", \"__RP_TOK_2__\" },\n },\n Content = new StringContent(@\"{\n \"\"expiration_period\"\": \"\"PT5H30M\"\"\n}\")\n {\n Headers =\n {\n ContentType = new MediaTypeHeaderValue(\"application/json\")\n }\n }\n};\n\nusing (var response = await client.SendAsync(request))\n{\n response.EnsureSuccessStatusCode();\n var body = await response.Content.ReadAsStringAsync();\n Console.WriteLine(body);\n}","templateHtml":"$394","tokens":[{"marker":"__RP_TOK_0__","paramName":"webhook_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:webhook_id":"123e4567-e89b-12d3-a456-426614174000"}}],"https://sandbox-merchant.revolut.com":[{"id":"curl","label":"cURL","templateCode":"curl -X POST \"https://sandbox-merchant.revolut.com/api/webhooks/__RP_TOK_0__/rotate-signing-secret\" \\\n -H \"Content-Type: application/json\" \\\n -H \"Authorization: __RP_TOK_1__\" \\\n -H \"Revolut-Api-Version: __RP_TOK_2__\" \\\n -d '{\n \"expiration_period\": \"PT5H30M\"\n}'","templateHtml":"$395","tokens":[{"marker":"__RP_TOK_0__","paramName":"webhook_id","paramIn":"path","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["shell-double-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:webhook_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"javascript","label":"JavaScript","templateCode":"const payload = {\n \"expiration_period\": \"PT5H30M\"\n};\nfetch(\"https://sandbox-merchant.revolut.com/api/webhooks/__RP_TOK_0__/rotate-signing-secret\", {\n method: \"POST\",\n headers: {\n \"Content-Type\": \"application/json\",\n \"Authorization\": \"__RP_TOK_1__\",\n \"Revolut-Api-Version\": \"__RP_TOK_2__\"\n },\n body: JSON.stringify(payload)\n})\n .then(response => response.json())\n .then(data => console.log(data));","templateHtml":"$396","tokens":[{"marker":"__RP_TOK_0__","paramName":"webhook_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:webhook_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"go","label":"Go","templateCode":"package main\n\nimport (\n \"fmt\"\n \"net/http\"\n \"bytes\"\n \"encoding/json\"\n)\n\nfunc main() {\n url := \"https://sandbox-merchant.revolut.com/api/webhooks/__RP_TOK_0__/rotate-signing-secret\"\n jsonData := []byte(`\n{\n \"expiration_period\": \"PT5H30M\"\n}\n `)\n req, _ := http.NewRequest(\"POST\", url, bytes.NewBuffer(jsonData))\n req.Header.Add(\"Content-Type\", \"application/json\")\n req.Header.Add(\"Authorization\", \"__RP_TOK_1__\")\n req.Header.Add(\"Revolut-Api-Version\", \"__RP_TOK_2__\")\n\n res, _ := http.DefaultClient.Do(req)\n defer res.Body.Close()\n fmt.Println(res)\n}","templateHtml":"$397","tokens":[{"marker":"__RP_TOK_0__","paramName":"webhook_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:webhook_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"python","label":"Python","templateCode":"import requests\n\nurl = \"https://sandbox-merchant.revolut.com/api/webhooks/__RP_TOK_0__/rotate-signing-secret\"\nheaders = {\n \"Content-Type\": \"application/json\",\n \"Authorization\": \"__RP_TOK_1__\",\n \"Revolut-Api-Version\": \"__RP_TOK_2__\"\n}\npayload = {\n \"expiration_period\": \"PT5H30M\"\n}\n\nresponse = requests.post(url, headers=headers, json=payload)\nprint(response.json())","templateHtml":"$398","tokens":[{"marker":"__RP_TOK_0__","paramName":"webhook_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:webhook_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"java","label":"Java","templateCode":"import java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\nimport java.net.URI;\n\npublic class Main {\n public static void main(String[] args) {\n HttpClient client = HttpClient.newHttpClient();\n String body = \"\"\"\n{\n \"expiration_period\": \"PT5H30M\"\n}\n \"\"\";\n\n HttpRequest request = HttpRequest.newBuilder()\n .uri(URI.create(\"https://sandbox-merchant.revolut.com/api/webhooks/__RP_TOK_0__/rotate-signing-secret\"))\n .header(\"Content-Type\", \"application/json\")\n .header(\"Authorization\", \"__RP_TOK_1__\")\n .header(\"Revolut-Api-Version\", \"__RP_TOK_2__\")\n .POST(HttpRequest.BodyPublishers.ofString(body))\n .build();\n\n client.sendAsync(request, HttpResponse.BodyHandlers.ofString())\n .thenApply(HttpResponse::body)\n .thenAccept(System.out::println)\n .join();\n }\n}","templateHtml":"$399","tokens":[{"marker":"__RP_TOK_0__","paramName":"webhook_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:webhook_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"csharp","label":"C#","templateCode":"using System.Net.Http;\nusing System.Net.Http.Headers;\n\nvar client = new HttpClient();\nvar request = new HttpRequestMessage\n{\n Method = HttpMethod.Post,\n RequestUri = new Uri(\"https://sandbox-merchant.revolut.com/api/webhooks/__RP_TOK_0__/rotate-signing-secret\"),\n Headers =\n {\n { \"Authorization\", \"__RP_TOK_1__\" },\n { \"Revolut-Api-Version\", \"__RP_TOK_2__\" },\n },\n Content = new StringContent(@\"{\n \"\"expiration_period\"\": \"\"PT5H30M\"\"\n}\")\n {\n Headers =\n {\n ContentType = new MediaTypeHeaderValue(\"application/json\")\n }\n }\n};\n\nusing (var response = await client.SendAsync(request))\n{\n response.EnsureSuccessStatusCode();\n var body = await response.Content.ReadAsStringAsync();\n Console.WriteLine(body);\n}","templateHtml":"$39a","tokens":[{"marker":"__RP_TOK_0__","paramName":"webhook_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:webhook_id":"123e4567-e89b-12d3-a456-426614174000"}}]},"method":"post","servers":"$62:props:children:0:props:children:props:children:1:props:children:1:props:children:0:0:props:servers","path":"/api/webhooks/{webhook_id}/rotate-signing-secret","parameters":["$382:props:children:0:props:children:1:props:parameters:0","$382:props:children:0:props:children:1:props:parameters:1","$382:props:children:0:props:children:1:props:parameters:2"]}],"$L39b"],"$L39c","$L39d"]}]]}] 261:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Some human readable text describing what went wrong."}]]}] 262:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://www.unixtimestamp.com/","target":"_blank","rel":"noreferrer","children":"UNIX timestamp"}]," of the date and time the error happened."]}]]}] 263:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Error response"}]]}] 264:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The new renewal date for the subscription, expressed as a UTC date-time value."}],"\n",["$","p","p-1",{"children":"Must be set to a date later than the current renewal date; earlier dates are rejected."}]]}] 27a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["Reschedule the upcoming payment date for an active subscription cycle. This is a command endpoint — the renewal date is not a direct field on the Subscription resource, but is derived from the current active cycle's ",["$","code","code-0",{"children":"end_date"}],"."]}],"\n",["$","h3","h3-0",{"children":"Use cases"}],"\n",["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":[["$","strong","strong-0",{"children":"Payment extensions:"}]," Granting a customer more time to pay."]}],"\n",["$","li","li-1",{"children":[["$","strong","strong-0",{"children":"Service delays:"}]," Adjusting the billing date if service delivery is delayed."]}],"\n",["$","li","li-2",{"children":[["$","strong","strong-0",{"children":"Billing alignment:"}]," Moving a payment date to better suit a customer's financial schedule."]}],"\n"]}],"\n",["$","h5","h5-0",{"children":"How it works"}],"\n",["$","p","p-1",{"children":["Extending the current cycle's ",["$","code","code-0",{"children":"end_date"}]," naturally postpones the start of the next cycle and its associated payment trigger, providing flexibility for both the merchant and the customer."]}],"\n",["$","p","p-2",{"children":"The relationship between the cycle end and the billing execution depends on the plan type:"}],"\n",["$","ul","ul-1",{"children":["\n",["$","li","li-0",{"children":[["$","strong","strong-0",{"children":"Non-usage plans:"}]," The next cycle's start date is the same as the billing date. The moment the current cycle ends, the next cycle begins and the payment is attempted."]}],"\n",["$","li","li-1",{"children":[["$","strong","strong-0",{"children":"Usage-based plans (buffer & overlap):"}]," To allow merchants time to finalize usage data, the billing date is scheduled after the cycle ",["$","code","code-0",{"children":"end_date"}],".\n",["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["Usage continues to be aggregated until the updated ",["$","code","code-0",{"children":"end_date"}],"."]}],"\n",["$","li","li-1",{"children":["When the current cycle (Cycle 1) reaches its updated ",["$","code","code-0",{"children":"end_date"}],", ",["$","strong","strong-0",{"children":"Cycle 2 starts immediately"}]," to ensure no service interruption."]}],"\n",["$","li","li-2",{"children":"The billing for Cycle 1 occurs a few hours later (12-hour buffer). This window allows you to upload or edit usages for the period that just ended while the customer is already technically in their next cycle."}],"\n",["$","li","li-3",{"children":["Rescheduling the ",["$","code","code-0",{"children":"renewal_date"}]," pushes this entire sequence—the end of Cycle 1, the start of Cycle 2, and the delayed billing trigger—further into the future."]}],"\n"]}],"\n"]}],"\n"]}],"\n",["$","p","p-3",{"children":"Subsequent cycles resume the original plan cadence (e.g., monthly) from the new date."}]]}] 27b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["This parameter accepts the ",["$","a","a-0",{"href":"https://business.revolut.com/settings/apis?tab=merchant-api","target":"_blank","rel":"noreferrer","children":"Merchant API Secret key"}]," to authorise requests coming from the merchant's backend."]}],"\n",["$","p","p-1",{"children":["It ensures that ensures that each request is authenticated and authorised by verifying the secret key. The secret key should be included in all request headers as a ",["$","code","code-0",{"children":"Bearer"}]," token."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#authentication","target":"_blank","rel":"noreferrer","children":"Authentication"}]]}]}]]}]]}] 27c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The version of the Merchant API, specified in ",["$","code","code-0",{"children":"YYYY-MM-DD"}]," format."]}],"\n",["$","p","p-1",{"children":"If not specified, you will receive an error."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information about API versioning, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/reference/versioning/api-versions","target":"_blank","rel":"noreferrer","children":"API versions"}],"."]}]}]]}]]}] 27d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A UUID string, typically used to identify resources."}]]}] 27e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The ID of the subscription."}]]}] 28e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The ID of the uploaded evidence."}]]}] 28f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Evidence uploaded successfully"}]]}] 290:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An identifier that can be used to determine what went wrong."}],"\n",["$","p","p-1",{"children":"Error codes are not globally unique, but uniqueness is guaranteed within endpoints."}]]}] 291:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Some human readable text describing what went wrong."}]]}] 292:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://www.unixtimestamp.com/","target":"_blank","rel":"noreferrer","children":"UNIX timestamp"}]," of the date and time the error happened."]}]]}] 293:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Bad Request"}]]}] 294:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An identifier that can be used to determine what went wrong."}],"\n",["$","p","p-1",{"children":"Error codes are not globally unique, but uniqueness is guaranteed within endpoints."}]]}] 295:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Some human readable text describing what went wrong."}]]}] 296:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://www.unixtimestamp.com/","target":"_blank","rel":"noreferrer","children":"UNIX timestamp"}]," of the date and time the error happened."]}]]}] 297:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unauthorized"}]]}] 298:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An identifier that can be used to determine what went wrong."}],"\n",["$","p","p-1",{"children":"Error codes are not globally unique, but uniqueness is guaranteed within endpoints."}]]}] 299:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Some human readable text describing what went wrong."}]]}] 29a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://www.unixtimestamp.com/","target":"_blank","rel":"noreferrer","children":"UNIX timestamp"}]," of the date and time the error happened."]}]]}] 29b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Forbidden"}]]}] 29c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An identifier that can be used to determine what went wrong."}],"\n",["$","p","p-1",{"children":"Error codes are not globally unique, but uniqueness is guaranteed within endpoints."}]]}] 29d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Some human readable text describing what went wrong."}]]}] 29e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://www.unixtimestamp.com/","target":"_blank","rel":"noreferrer","children":"UNIX timestamp"}]," of the date and time the error happened."]}]]}] 29f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Not Found"}]]}] 2a0:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An identifier that can be used to determine what went wrong."}],"\n",["$","p","p-1",{"children":"Error codes are not globally unique, but uniqueness is guaranteed within endpoints."}]]}] 2a7:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The ID of the webhook."}]]}] 2a8:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Your webhook's URL to which event notifications will be sent."}],"\n",["$","p","p-1",{"children":["Must be a valid HTTP or HTTPS URL, capable of receiving ",["$","code","code-0",{"children":"POST"}]," requests."]}],"\n",["$","div","inlinealert-0",{"data-type":"warning","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMark","color":"var(--rui-color-warning)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"Restrictions:"}],["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["Must be a valid URI as defined by ",["$","a","a-0",{"href":"https://datatracker.ietf.org/doc/html/rfc3986","target":"_blank","rel":"noreferrer","children":"RFC 3986"}]]}],"\n",["$","li","li-1",{"children":["URI scheme is required and must be either ",["$","code","code-0",{"children":"http"}]," or ",["$","code","code-1",{"children":"https"}]]}],"\n",["$","li","li-2",{"children":["URI host is required and cannot be ",["$","code","code-0",{"children":"localhost"}]," or an IP address"]}],"\n",["$","li","li-3",{"children":["Max length: ",["$","code","code-0",{"children":"2000"}]]}],"\n",["$","li","li-4",{"children":["Reserved or invalid characters must be percent-encoded (for example, use ",["$","code","code-0",{"children":"%20"}]," instead of a space)"]}],"\n"]}]]}]]}]]}] 2aa:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The available event types your can listen to."}]]}] 2ab:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"List of event types that the webhook is configured to listen to."}],"\n",["$","p","p-1",{"children":"Each event is related to status changes of a specific object in the Merchant API:"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Object","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Event types","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"Order"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["$","ul","ul-0",{"children":[" ",["$","li","li-0",{"children":["$","code","code-0",{"children":"ORDER_COMPLETED"}]}]," ",["$","li","li-1",{"children":["$","code","code-0",{"children":"ORDER_AUTHORISED"}]}]," ",["$","li","li-2",{"children":["$","code","code-0",{"children":"ORDER_CANCELLED"}]}]," ",["$","li","li-3",{"children":["$","code","code-0",{"children":"ORDER_FAILED"}]}]," ",["$","li","li-4",{"children":["$","code","code-0",{"children":"ORDER_INCREMENTAL_AUTHORISATION_AUTHORISED"}]}]," ",["$","li","li-5",{"children":["$","code","code-0",{"children":"ORDER_INCREMENTAL_AUTHORISATION_DECLINED"}]}]," ",["$","li","li-6",{"children":["$","code","code-0",{"children":"ORDER_INCREMENTAL_AUTHORISATION_FAILED"}]}]," "]}],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"Payment"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["$","ul","ul-0",{"children":[" ",["$","li","li-0",{"children":["$","code","code-0",{"children":"ORDER_PAYMENT_AUTHENTICATION_CHALLENGED"}]}]," ",["$","li","li-1",{"children":["$","code","code-0",{"children":"ORDER_PAYMENT_AUTHENTICATED"}]}]," ",["$","li","li-2",{"children":["$","code","code-0",{"children":"ORDER_PAYMENT_AUTHORISATION_STARTED"}]}]," ",["$","li","li-3",{"children":["$","code","code-0",{"children":"ORDER_PAYMENT_DECLINED"}]}]," ",["$","li","li-4",{"children":["$","code","code-0",{"children":"ORDER_PAYMENT_FAILED"}]}]," "]}],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"Subscription"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["$","ul","ul-0",{"children":[" ",["$","li","li-0",{"children":["$","code","code-0",{"children":"SUBSCRIPTION_INITIATED"}]}]," ",["$","li","li-1",{"children":["$","code","code-0",{"children":"SUBSCRIPTION_FINISHED"}]}]," ",["$","li","li-2",{"children":["$","code","code-0",{"children":"SUBSCRIPTION_CANCELLED"}]}]," ",["$","li","li-3",{"children":["$","code","code-0",{"children":"SUBSCRIPTION_OVERDUE"}]}]]}],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"Payout"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["$","ul","ul-0",{"children":[" ",["$","li","li-0",{"children":["$","code","code-0",{"children":"PAYOUT_INITIATED"}]}]," ",["$","li","li-1",{"children":["$","code","code-0",{"children":"PAYOUT_COMPLETED"}]}]," ",["$","li","li-2",{"children":["$","code","code-0",{"children":"PAYOUT_FAILED"}]}]," "]}],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-4",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"Dispute"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["$","ul","ul-0",{"children":[" ",["$","li","li-0",{"children":["$","code","code-0",{"children":"DISPUTE_ACTION_REQUIRED"}]}]," ",["$","li","li-1",{"children":["$","code","code-0",{"children":"DISPUTE_UNDER_REVIEW"}]}]," ",["$","li","li-2",{"children":["$","code","code-0",{"children":"DISPUTE_WON"}]}]," ",["$","li","li-3",{"children":["$","code","code-0",{"children":"DISPUTE_LOST"}]}]]}],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 2ac:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The signing secret for the webhook. Use it to verify the signature for the webhook request's payload."}]]}] 2ad:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A webhook object."}],"\n",["$","p","p-1",{"children":["Unlike the legacy API, ",["$","code","code-0",{"children":"signing_secret"}]," is included in all webhook responses, not only on creation."]}]]}] 2ae:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"List of webhooks."}]]}] 2af:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"OK"}]]}] 64:["$","$7a","retrieve-terminal-list",{"children":[["$","section",null,{"className":"y9a0do0","data-variant":"endpoint","children":["$","$L7b",null,{"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"title":"Terminals response","type":"object","description":"Response containing a list of terminals.","properties":{"terminals":{"type":"array","description":"List of terminal devices.","items":{"title":"Terminal","type":"object","description":"Represents a Revolut Terminal device.","properties":{"id":{"title":"Terminal ID","type":"string","format":"uuid","description":"The unique identifier of the terminal.","descriptionNode":"$L39e"},"name":{"title":"Terminal name","type":"string","description":"The name of the terminal device.","descriptionNode":"$L39f"},"type":{"title":"Terminal type","type":"string","description":"The hardware type/model of the terminal device.","enum":["youtransactor_ucube_touch","newland_n950","newland_n750","newland_r25p"],"descriptionNode":"$L3a0"},"serial_number":{"title":"Terminal serial number","type":"string","description":"The serial number of the terminal device.","examples":["RT-00123456"],"descriptionNode":"$L3a1"},"battery_level":{"title":"Terminal battery level","type":"integer","description":"The current battery level of the terminal as a percentage (0-100).","minimum":0,"maximum":100,"descriptionNode":"$L3a2"},"online":{"title":"Terminal online status","type":"boolean","description":"Indicates whether the terminal is currently online and connected.\n\n| Value | Description |\n|-------|-------------|\n| `true` | Terminal is online and available |\n| `false` | Terminal is offline |","descriptionNode":"$L3a3"},"last_online_at":{"title":"Terminal last online timestamp","type":"string","format":"date-time","description":"The date and time when the terminal was last seen online.","descriptionNode":"$L3a4"}},"required":["id","name","type","serial_number","battery_level","online","last_online_at"],"descriptionNode":"$L3a5"},"descriptionNode":"$L3a6"}},"required":["terminals"],"descriptionNode":"$L3a7"},"examples":{"terminals_list":{"summary":"List of terminals at a location","value":{"terminals":[{"id":"0e53f673-7705-473a-a263-89a3e7647c3d","name":"Terminal 1","type":"newland_n950","serial_number":"RT-00123456","battery_level":85,"online":true,"last_online_at":"2025-01-15T14:30:00Z"},{"id":"a7b2c8d1-4e5f-6a7b-8c9d-0e1f2a3b4c5d","name":"Terminal 2","type":"newland_n950","serial_number":"RT-00123457","battery_level":92,"online":true,"last_online_at":"2025-01-15T14:32:00Z"}]}}}}},"descriptionNode":"$L3a8"},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"code":{"type":"string","description":"An identifier that can be used to determine what went wrong.\n\nError codes are not globally unique, but uniqueness is guaranteed within endpoints.","descriptionNode":"$L3a9"},"message":{"type":"string","description":"Some human readable text describing what went wrong.","descriptionNode":"$L3aa"},"timestamp":{"type":"integer","description":"The [UNIX timestamp](https://www.unixtimestamp.com/) of the date and time the error happened.","descriptionNode":"$L3ab"}}}}},"descriptionNode":"$L3ac"},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"code":{"type":"string","description":"An identifier that can be used to determine what went wrong.\n\nError codes are not globally unique, but uniqueness is guaranteed within endpoints.","descriptionNode":"$L3ad"},"message":{"type":"string","description":"Some human readable text describing what went wrong.","descriptionNode":"$L3ae"},"timestamp":{"type":"integer","description":"The [UNIX timestamp](https://www.unixtimestamp.com/) of the date and time the error happened.","descriptionNode":"$L3af"}}}}},"descriptionNode":"$L3b0"}},"requestBody":"$undefined","variantLabels":[],"children":[["$","div",null,{"className":"ezz1n30","children":[["$","div",null,{"data-header":"$undefined","className":"ezz1n31","children":["$","div",null,{"className":"y9a0do1","children":[["$","h2",null,{"id":"retrieve-terminal-list","children":[["$L3b1","$undefined"],["$","$L15",null,{"id":"retrieve-terminal-list"}]]}],"$L3b2"]}]}],"$undefined"]}],"$L3b3"]}]}],false]}] 67:["$","$7a","retrieve-payment-intent",{"children":[["$","section",null,{"className":"y9a0do0","data-variant":"endpoint","children":["$","$L7b",null,{"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"title":"Payment Intent","type":"object","description":"Represents a payment intent that has been pushed to a Revolut Terminal device.\n\nWhen the payment intent reaches `completed` state, it includes a `payment_id` that can be used to [retrieve the final payment status](https://developer.revolut.com/docs/api/merchant#retrieve-payment-details).","properties":{"id":{"title":"Payment Intent ID","type":"string","format":"uuid","description":"The unique identifier of the payment intent.","descriptionNode":"$L3b4"},"state":{"type":"string","description":"The current state of the payment intent.\n\n| State | Description |\n|-------|-------------|\n| `pending` | Payment intent created and sent to terminal, customer has not yet started interacting |\n| `processing` | Customer is actively interacting with the terminal (e.g., inserting card, entering PIN) |\n| `completed` | Payment authorization is complete, includes a `payment_id` in the response |\n| `cancelled` | Payment intent was cancelled (by system or customer) |\n| `failed` | Payment intent failed due to technical issues (timeout, terminal unavailable, network error) |","enum":["pending","processing","completed","cancelled","failed"],"descriptionNode":"$L3b5"},"terminal_id":{"title":"Terminal ID","type":"string","format":"uuid","description":"The unique identifier of the terminal.","descriptionNode":"$L3b6"},"order_id":{"type":"string","format":"uuid","description":"Permanent order ID used to retrieve, capture, cancel, or refund an order after authorization.","descriptionNode":"$L3b7"},"payment_id":{"type":"string","format":"uuid","description":"The ID of the payment.","descriptionNode":"$L3b8"},"amount":{"title":"Payment Intent amount","type":"integer","description":"The payment amount expressed in minor currency units, according to the [ISO 4217 standard](https://en.wikipedia.org/wiki/ISO_4217). For example, `7034` in `EUR` corresponds to €70.34.\n\n:::info\nConversion between major and minor units varies by currency. For instance, `100` minor units equal £1.00 in `GBP`, whereas in `ISK` they represent 100 units. For more details, see the [ISO 4217 standard](https://en.wikipedia.org/wiki/ISO_4217).\n:::","descriptionNode":"$L3b9"},"currency":{"type":"string","format":"ISO 4217","minLength":3,"maxLength":3,"description":"[ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) currency code in upper case.\n\n:::info\nFor more information about the supported currencies, see: [Help Center](https://help.revolut.com/business/help/merchant-accounts/payments/in-which-currencies-can-i-accept-payments/).\n:::","descriptionNode":"$L3ba"},"created_at":{"type":"string","format":"date-time","description":"The date and time the payment intent was created.","descriptionNode":"$L3bb"},"updated_at":{"type":"string","format":"date-time","description":"The date and time the payment intent was last updated.","descriptionNode":"$L3bc"}},"required":["id","order_id","state","amount","currency","terminal_id","created_at","updated_at"],"descriptionNode":"$L3bd"},"examples":{"payment_intent_pending":{"summary":"Payment intent pending","value":{"id":"b4d58add-b3fe-40e4-a70a-8c78df977888","state":"pending","order_id":"5c9fc54e-11b4-4f7f-8686-4a64d4d20db4","amount":2500,"currency":"GBP"}},"payment_intent_processing":{"summary":"Payment intent processing","value":{"id":"b4d58add-b3fe-40e4-a70a-8c78df977888","order_id":"5c9fc54e-11b4-4f7f-8686-4a64d4d20db4","state":"processing","amount":2500,"currency":"GBP","terminal_id":"0e53f673-7705-473a-a263-89a3e7647c3d","created_at":"2025-01-15T11:01:00Z","updated_at":"2025-01-15T11:02:15Z"}},"payment_intent_completed":{"summary":"Payment intent completed","value":{"id":"b4d58add-b3fe-40e4-a70a-8c78df977888","state":"completed","terminal_id":"0e53f673-7705-473a-a263-89a3e7647c3d","order_id":"5c9fc54e-11b4-4f7f-8686-4a64d4d20db4","payment_id":"7a8b9c0d-1e2f-3a4b-5c6d-7e8f9a0b1c2d","amount":2500,"currency":"GBP","created_at":"2025-01-15T11:01:00Z","updated_at":"2025-01-15T11:02:30Z"}},"payment_intent_cancelled":{"summary":"Payment intent cancelled","value":{"id":"b4d58add-b3fe-40e4-a70a-8c78df977888","state":"cancelled","terminal_id":"0e53f673-7705-473a-a263-89a3e7647c3d","order_id":"5c9fc54e-11b4-4f7f-8686-4a64d4d20db4","amount":2500,"currency":"GBP","created_at":"2025-01-15T11:01:00Z","updated_at":"2025-01-15T11:01:45Z"}},"payment_intent_failed":{"summary":"Payment intent failed","value":{"id":"b4d58add-b3fe-40e4-a70a-8c78df977888","state":"failed","terminal_id":"0e53f673-7705-473a-a263-89a3e7647c3d","order_id":"5c9fc54e-11b4-4f7f-8686-4a64d4d20db4","amount":2500,"currency":"GBP","created_at":"2025-01-15T11:01:00Z","updated_at":"2025-01-15T11:03:00Z"}}}}},"descriptionNode":"$L3be"},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"errorId":{"type":"string","description":"The ID of the error. You can share this ID with Revolut support for troubleshooting.","descriptionNode":"$L3bf"},"timestamp":{"type":"integer","description":"The date and time the error happened.","descriptionNode":"$L3c0"}},"required":"$62:props:children:0:props:children:props:responses:401:content:application/json:schema:required"}}},"descriptionNode":"$L3c1"},"404":{"description":"Not Found","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"errorId":{"type":"string","description":"The ID of the error. You can share this ID with Revolut support for troubleshooting.","descriptionNode":"$L3c2"},"timestamp":{"type":"integer","description":"The date and time the error happened.","descriptionNode":"$L3c3"}},"required":"$62:props:children:0:props:children:props:responses:401:content:application/json:schema:required"}}},"descriptionNode":"$L3c4"}},"requestBody":"$undefined","variantLabels":["Payment intent pending","Payment intent processing","Payment intent completed","Payment intent cancelled","Payment intent failed"],"children":["$L3c5","$L3c6"]}]}],false]}] 68:["$","$7a","cancel-payment-intent",{"children":[["$","section",null,{"className":"y9a0do0","data-variant":"endpoint","children":["$","$L7b",null,{"responses":{"200":{"description":"Payment intent cancelled","content":{"application/json":{"schema":{"title":"Payment Intent","type":"object","description":"Represents a payment intent that has been pushed to a Revolut Terminal device.\n\nWhen the payment intent reaches `completed` state, it includes a `payment_id` that can be used to [retrieve the final payment status](https://developer.revolut.com/docs/api/merchant#retrieve-payment-details).","properties":{"id":{"title":"Payment Intent ID","type":"string","format":"uuid","description":"The unique identifier of the payment intent.","descriptionNode":"$L3c7"},"state":{"type":"string","description":"The current state of the payment intent.\n\n| State | Description |\n|-------|-------------|\n| `pending` | Payment intent created and sent to terminal, customer has not yet started interacting |\n| `processing` | Customer is actively interacting with the terminal (e.g., inserting card, entering PIN) |\n| `completed` | Payment authorization is complete, includes a `payment_id` in the response |\n| `cancelled` | Payment intent was cancelled (by system or customer) |\n| `failed` | Payment intent failed due to technical issues (timeout, terminal unavailable, network error) |","enum":"$67:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:state:enum","descriptionNode":"$L3c8"},"terminal_id":{"title":"Terminal ID","type":"string","format":"uuid","description":"The unique identifier of the terminal.","descriptionNode":"$L3c9"},"order_id":{"type":"string","format":"uuid","description":"Permanent order ID used to retrieve, capture, cancel, or refund an order after authorization.","descriptionNode":"$L3ca"},"payment_id":{"type":"string","format":"uuid","description":"The ID of the payment.","descriptionNode":"$L3cb"},"amount":{"title":"Payment Intent amount","type":"integer","description":"The payment amount expressed in minor currency units, according to the [ISO 4217 standard](https://en.wikipedia.org/wiki/ISO_4217). For example, `7034` in `EUR` corresponds to €70.34.\n\n:::info\nConversion between major and minor units varies by currency. For instance, `100` minor units equal £1.00 in `GBP`, whereas in `ISK` they represent 100 units. For more details, see the [ISO 4217 standard](https://en.wikipedia.org/wiki/ISO_4217).\n:::","descriptionNode":"$L3cc"},"currency":{"type":"string","format":"ISO 4217","minLength":3,"maxLength":3,"description":"[ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) currency code in upper case.\n\n:::info\nFor more information about the supported currencies, see: [Help Center](https://help.revolut.com/business/help/merchant-accounts/payments/in-which-currencies-can-i-accept-payments/).\n:::","descriptionNode":"$L3cd"},"created_at":{"type":"string","format":"date-time","description":"The date and time the payment intent was created.","descriptionNode":"$L3ce"},"updated_at":{"type":"string","format":"date-time","description":"The date and time the payment intent was last updated.","descriptionNode":"$L3cf"}},"required":"$67:props:children:0:props:children:props:responses:200:content:application/json:schema:required","descriptionNode":"$L3d0"},"examples":{"payment_intent_cancelled":{"summary":"Payment intent cancelled","value":"$67:props:children:0:props:children:props:responses:200:content:application/json:examples:payment_intent_cancelled:value"}}}},"descriptionNode":"$L3d1"},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"errorId":{"type":"string","description":"The ID of the error. You can share this ID with Revolut support for troubleshooting.","descriptionNode":"$L3d2"},"timestamp":{"type":"integer","description":"The date and time the error happened.","descriptionNode":"$L3d3"}},"required":"$62:props:children:0:props:children:props:responses:401:content:application/json:schema:required"}}},"descriptionNode":"$L3d4"},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"errorId":{"type":"string","description":"The ID of the error. You can share this ID with Revolut support for troubleshooting.","descriptionNode":"$L3d5"},"timestamp":{"type":"integer","description":"The date and time the error happened.","descriptionNode":"$L3d6"}},"required":"$62:props:children:0:props:children:props:responses:401:content:application/json:schema:required"}}},"descriptionNode":"$L3d7"},"404":{"description":"Not Found","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"errorId":{"type":"string","description":"The ID of the error. You can share this ID with Revolut support for troubleshooting.","descriptionNode":"$L3d8"},"timestamp":{"type":"integer","description":"The date and time the error happened.","descriptionNode":"$L3d9"}},"required":"$62:props:children:0:props:children:props:responses:401:content:application/json:schema:required"}}},"descriptionNode":"$L3da"}},"requestBody":"$undefined","variantLabels":[],"children":["$L3db","$L3dc"]}]}],false]}] 37:["$","$7a","change-subscription-plan",{"children":[["$","section",null,{"className":"y9a0do0","data-variant":"endpoint","children":["$","$L7b",null,{"responses":{"204":{"description":"Plan change scheduled successfully","descriptionNode":"$L3dd"},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"code":{"type":"string","description":"An identifier that can be used to determine what went wrong.\n\nError codes are not globally unique, but uniqueness is guaranteed within endpoints.","descriptionNode":"$L3de"},"message":{"type":"string","description":"Some human readable text describing what went wrong.","descriptionNode":"$L3df"},"timestamp":{"type":"integer","description":"The [UNIX timestamp](https://www.unixtimestamp.com/) of the date and time the error happened.","descriptionNode":"$L3e0"}}},"examples":{"immediate_not_supported":{"summary":"Immediate plan change not supported","value":{"code":"bad_request","message":"Immediate plan change is not supported. Please provide 'scheduled' field (e.g. 'at_cycle_end')","timestamp":1601296792533}}}}},"descriptionNode":"$L3e1"},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"code":{"type":"string","description":"An identifier that can be used to determine what went wrong.\n\nError codes are not globally unique, but uniqueness is guaranteed within endpoints.","descriptionNode":"$L3e2"},"message":{"type":"string","description":"Some human readable text describing what went wrong.","descriptionNode":"$L3e3"},"timestamp":{"type":"integer","description":"The [UNIX timestamp](https://www.unixtimestamp.com/) of the date and time the error happened.","descriptionNode":"$L3e4"}}}}},"descriptionNode":"$L3e5"},"404":{"description":"Subscription not found","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"code":{"type":"string","description":"An identifier that can be used to determine what went wrong.\n\nError codes are not globally unique, but uniqueness is guaranteed within endpoints.","descriptionNode":"$L3e6"},"message":{"type":"string","description":"Some human readable text describing what went wrong.","descriptionNode":"$L3e7"},"timestamp":{"type":"integer","description":"The [UNIX timestamp](https://www.unixtimestamp.com/) of the date and time the error happened.","descriptionNode":"$L3e8"}}}}},"descriptionNode":"$L3e9"},"422":{"description":"Unprocessable entity","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"code":{"type":"string","description":"An identifier that can be used to determine what went wrong.\n\nError codes are not globally unique, but uniqueness is guaranteed within endpoints.","descriptionNode":"$L3ea"},"message":{"type":"string","description":"Some human readable text describing what went wrong.","descriptionNode":"$L3eb"},"timestamp":{"type":"integer","description":"The [UNIX timestamp](https://www.unixtimestamp.com/) of the date and time the error happened.","descriptionNode":"$L3ec"}}},"examples":{"subscription_finished":{"summary":"Subscription is finished","value":{"code":"subscription_finished","message":"The subscription is finished","timestamp":1601296792533}},"next_cycle_exists":{"summary":"Next cycle already exists with a different plan variation","value":{"code":"subscription_cycle_next_cycle_exists","message":"Next cycle already exists with a different plan variation","timestamp":1601296792533}}}}},"descriptionNode":"$L3ed"},"default":{"description":"Error response","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"code":{"type":"string","description":"An identifier that can be used to determine what went wrong.\n\nError codes are not globally unique, but uniqueness is guaranteed within endpoints.","descriptionNode":"$L3ee"},"message":{"type":"string","description":"Some human readable text describing what went wrong.","descriptionNode":"$L3ef"},"timestamp":{"type":"integer","description":"The [UNIX timestamp](https://www.unixtimestamp.com/) of the date and time the error happened.","descriptionNode":"$L3f0"}}}}},"descriptionNode":"$L3f1"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"plan_variation_id":{"type":"string","format":"uuid","description":"Unique identifier for the subscription plan variation.","descriptionNode":"$L3f2"},"plan_variation_phase_id":{"type":"string","format":"uuid","description":"Unique identifier for the subscription plan phase.","descriptionNode":"$L3f3"},"scheduled":{"type":"string","description":"When the plan change should take effect.\n\n| Value | Description |\n| ----- | ----------- |\n| `at_cycle_end` | The change is applied at the end of the current billing cycle. |","enum":["at_cycle_end"],"examples":["at_cycle_end"],"descriptionNode":"$L3f4"},"reason":{"type":"string","description":"The reason for the scheduled action. This field is informational and does not affect how the action is processed.\n\n| Value | Description |\n| ----- | ----------- |\n| `customer_request` | The action was requested by the customer. |\n| `merchant_request` | The action was initiated by the merchant. |","enum":["customer_request","merchant_request"],"default":"merchant_request","examples":["customer_request"],"descriptionNode":"$L3f5"}},"required":["plan_variation_id","scheduled"]},"examples":{"change_plan":{"summary":"Schedule plan change at cycle end","value":{"plan_variation_id":"850e8400-e29b-41d4-a716-446655440003","scheduled":"at_cycle_end"}},"change_plan_with_reason":{"summary":"Schedule plan change with reason","value":{"plan_variation_id":"850e8400-e29b-41d4-a716-446655440003","scheduled":"at_cycle_end","reason":"customer_request"}},"change_plan_with_phase":{"summary":"Schedule plan change to a specific phase","value":{"plan_variation_id":"850e8400-e29b-41d4-a716-446655440003","plan_variation_phase_id":"950e8400-e29b-41d4-a716-446655440004","scheduled":"at_cycle_end"}}}}}},"variantLabels":["Schedule plan change at cycle end","Schedule plan change with reason","Schedule plan change to a specific phase"],"children":["$L3f6","$L3f7"]}]}],false]}] 3f8:T44d,
{
  "code": "string",
  "message": "string",
  "timestamp": 123
}
18c:["$","div","401-application/json-default",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$3f8"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"code\": \"string\",\n \"message\": \"string\",\n \"timestamp\": 123\n}"}]}]]}] 3f9:T44d,
{
  "code": "string",
  "message": "string",
  "timestamp": 123
}
18d:["$","div","404-application/json-default",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$3f9"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"code\": \"string\",\n \"message\": \"string\",\n \"timestamp\": 123\n}"}]}]]}] 3fa:T44d,
{
  "code": "string",
  "message": "string",
  "timestamp": 123
}
18f:["$","div","400-application/json-default",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$3fa"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"code\": \"string\",\n \"message\": \"string\",\n \"timestamp\": 123\n}"}]}]]}] 3fb:T44d,
{
  "code": "string",
  "message": "string",
  "timestamp": 123
}
190:["$","div","401-application/json-default",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$3fb"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"code\": \"string\",\n \"message\": \"string\",\n \"timestamp\": 123\n}"}]}]]}] 3fc:T44d,
{
  "code": "string",
  "message": "string",
  "timestamp": 123
}
191:["$","div","404-application/json-default",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$3fc"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"code\": \"string\",\n \"message\": \"string\",\n \"timestamp\": 123\n}"}]}]]}] 3fd:T44d,
{
  "code": "string",
  "message": "string",
  "timestamp": 123
}
192:["$","div","default-application/json-default",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$3fd"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"code\": \"string\",\n \"message\": \"string\",\n \"timestamp\": 123\n}"}]}]]}] 3fe:T44d,
{
  "code": "string",
  "message": "string",
  "timestamp": 123
}
194:["$","div","400-application/json-default",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$3fe"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"code\": \"string\",\n \"message\": \"string\",\n \"timestamp\": 123\n}"}]}]]}] 3ff:T44d,
{
  "code": "string",
  "message": "string",
  "timestamp": 123
}
195:["$","div","401-application/json-default",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$3ff"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"code\": \"string\",\n \"message\": \"string\",\n \"timestamp\": 123\n}"}]}]]}] 400:T44d,
{
  "code": "string",
  "message": "string",
  "timestamp": 123
}
196:["$","div","404-application/json-default",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$400"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"code\": \"string\",\n \"message\": \"string\",\n \"timestamp\": 123\n}"}]}]]}] 401:T487,
{
  "code": "subscription_usage_locked",
  "message": "Cannot modify usage for a locked cycle",
  "timestamp": 1743465600
}
197:["$","div","422-application/json-usage_locked",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$401"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"code\": \"subscription_usage_locked\",\n \"message\": \"Cannot modify usage for a locked cycle\",\n \"timestamp\": 1743465600\n}"}]}]]}] 402:T44d,
{
  "code": "string",
  "message": "string",
  "timestamp": 123
}
198:["$","div","default-application/json-default",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$402"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"code\": \"string\",\n \"message\": \"string\",\n \"timestamp\": 123\n}"}]}]]}] 403:T44d,
{
  "code": "string",
  "message": "string",
  "timestamp": 123
}
1bf:["$","div","401-application/json-default",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$403"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"code\": \"string\",\n \"message\": \"string\",\n \"timestamp\": 123\n}"}]}]]}] 404:T44d,
{
  "code": "string",
  "message": "string",
  "timestamp": 123
}
1c0:["$","div","404-application/json-default",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$404"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"code\": \"string\",\n \"message\": \"string\",\n \"timestamp\": 123\n}"}]}]]}] 2b6:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Each Merchant API request must contain an authorization header in the following format:"}],"\n","$L405","\n",["$","p","p-1",{"children":"To use this API, you need to generate API keys from your Revolut Business account. The Secret key is used in the authorization header for all server calls, while the Public key is provided with payment methods at checkout."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For detailed instructions on generating your API keys, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/get-started#generate-api-keys","target":"_blank","rel":"noreferrer","children":"Generate API keys"}],"."]}]}]]}]]}] 2b9:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Each Merchant API request must contain an authorization header in the following format:"}],"\n","$L406","\n",["$","p","p-1",{"children":"To use this API, you need to generate API keys from your Revolut Business account. The Secret key is used in the authorization header for all server calls, while the Public key is provided with payment methods at checkout."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For detailed instructions on generating your API keys, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/get-started#generate-api-keys","target":"_blank","rel":"noreferrer","children":"Generate API keys"}],"."]}]}]]}]]}] 2a1:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Some human readable text describing what went wrong."}]]}] 2a2:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://www.unixtimestamp.com/","target":"_blank","rel":"noreferrer","children":"UNIX timestamp"}]," of the date and time the error happened."]}]]}] 2a3:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unprocessable entity"}]]}] 2a4:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The single evidence file to upload."}],"\n",["$","p","p-1",{"children":["The client must ensure this part has its own ",["$","code","code-0",{"children":"Content-Type"}]," header specifying the media type of the file (e.g., ",["$","code","code-1",{"children":"application/pdf"}],", ",["$","code","code-2",{"children":"image/png"}],", ",["$","code","code-3",{"children":"image/jpeg"}],")."]}],"\n",["$","p","p-2",{"children":["Must be one of the allowed types: ",["$","code","code-0",{"children":"PDF"}],", ",["$","code","code-1",{"children":"PNG"}],", ",["$","code","code-2",{"children":"JPEG"}],"."]}]]}] 2c4:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Allows uploading a single evidence file for a specific dispute."}],"\n",["$","p","p-1",{"children":"Use these evidences to provide proof for claims when challenging a dispute."}],"\n",["$","div","inlinealert-0",{"data-type":"warning","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMark","color":"var(--rui-color-warning)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":["$","strong","strong-0",{"children":"Limitations:"}]}],["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["Maximum ",["$","code","code-0",{"children":"100"}]," uploaded files are allowed per dispute."]}],"\n",["$","li","li-1",{"children":["Maximum file size: ",["$","code","code-0",{"children":"10MB"}],"."]}],"\n",["$","li","li-2",{"children":["Allowed file types: ",["$","code","code-0",{"children":"PDF"}],", ",["$","code","code-1",{"children":"PNG"}],", ",["$","code","code-2",{"children":"JPEG"}],"."]}],"\n"]}]]}]]}],"\n",["$","div","inlinealert-1",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["This endpoint is only available in ",["$","strong","strong-0",{"children":"Production"}]," environment."]}]}]]}]]}] 2c5:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["This parameter accepts the ",["$","a","a-0",{"href":"https://business.revolut.com/settings/apis?tab=merchant-api","target":"_blank","rel":"noreferrer","children":"Merchant API Secret key"}]," to authorise requests coming from the merchant's backend."]}],"\n",["$","p","p-1",{"children":["It ensures that ensures that each request is authenticated and authorised by verifying the secret key. The secret key should be included in all request headers as a ",["$","code","code-0",{"children":"Bearer"}]," token."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#authentication","target":"_blank","rel":"noreferrer","children":"Authentication"}]]}]}]]}]]}] 2c6:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The version of the Merchant API, specified in ",["$","code","code-0",{"children":"YYYY-MM-DD"}]," format."]}],"\n",["$","p","p-1",{"children":"If not specified, you will receive an error."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information about API versioning, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/reference/versioning/api-versions","target":"_blank","rel":"noreferrer","children":"API versions"}],"."]}]}]]}]]}] 2c7:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The content type sent in the request."}]]}] 2c8:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A UUID string, typically used to identify resources."}]]}] 2c9:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ID of the ",["$","code","code-0",{"children":"Dispute"}]," object."]}]]}] 352:"Retrieve a customer list" 39b:["$","$L10d",null,{"security":[{"Api-Key":[]}],"authorization":{"Api-Key":{"type":"apiKey","in":"header","name":"Authorization","description":"Each Merchant API request must contain an authorization header in the following format:\n\n```\n'Authorization: Bearer '\n```\n\nTo use this API, you need to generate API keys from your Revolut Business account. The Secret key is used in the authorization header for all server calls, while the Public key is provided with payment methods at checkout.\n\n:::info\nFor detailed instructions on generating your API keys, see: [Generate API keys](https://developer.revolut.com/docs/guides/merchant/get-started#generate-api-keys).\n:::","descriptionNode":"$L407"}}}] 39c:["$","$L10f",null,{"exampleBlocks":{"application/json":{"variants":[{"key":"webhook_signing_secret_rotate_request","label":"Webhook signing secret rotation request","rawValue":"$5c:props:children:0:props:children:props:requestBody:content:application/json:examples:webhook_signing_secret_rotate_request:value","block":"$L408"}],"syncedPropertyName":"$undefined"}},"title":"Request body samples","headingAs":"h4"}] 39d:["$","$L110",null,{"exampleBlocks":{"200":{"application/json":{"variants":[{"key":"updated_webhook","label":"Webhook","rawValue":"$59:props:children:0:props:children:props:responses:200:content:application/json:examples:retrieved_webhook:value","block":"$L409"}],"syncedPropertyName":"$undefined"}},"400":{"application/json":{"variants":[{"key":"default","label":"Example","rawValue":{"code":"string","message":"string","timestamp":123},"block":"$L40a"}],"syncedPropertyName":"$undefined"}},"401":{"application/json":{"variants":[{"key":"default","label":"Example","rawValue":{"code":"string","message":"string","timestamp":123},"block":"$L40b"}],"syncedPropertyName":"$undefined"}},"404":{"application/json":{"variants":[{"key":"default","label":"Example","rawValue":{"code":"string","message":"string","timestamp":123},"block":"$L40c"}],"syncedPropertyName":"$undefined"}}},"headingAs":"h4"}] 3b2:["$","$L16",null,{"url":"/docs/api/merchant/2025-10-16/operations/retrieve-terminal-list.md"}] 414:Ta00,
fetch("https://merchant.revolut.com/api/terminals?operation_mode=__RP_TOK_0__&location_id=__RP_TOK_1__", {
  method: "GET",
  headers: {
    "Authorization": "__RP_TOK_2__",
    "Revolut-Api-Version": "__RP_TOK_3__"
  }
})
  .then(response => response.json())
  .then(data => console.log(data));
415:Tf9d,
package main

import (
  "fmt"
  "net/http"
)

func main() {
  url := "https://merchant.revolut.com/api/terminals?operation_mode=__RP_TOK_0__&location_id=__RP_TOK_1__"
  req, _ := http.NewRequest("GET", url, nil)
  req.Header.Add("Authorization", "__RP_TOK_2__")
  req.Header.Add("Revolut-Api-Version", "__RP_TOK_3__")

  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  fmt.Println(res)
}
416:T812,
import requests

url = "https://merchant.revolut.com/api/terminals?operation_mode=__RP_TOK_0__&location_id=__RP_TOK_1__"
headers = {
  "Authorization": "__RP_TOK_2__",
  "Revolut-Api-Version": "__RP_TOK_3__"
}

response = requests.get(url, headers=headers)
print(response.json())
417:T173e,
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;

public class Main {
  public static void main(String[] args) {
    HttpClient client = HttpClient.newHttpClient();
    HttpRequest request = HttpRequest.newBuilder()
      .uri(URI.create("https://merchant.revolut.com/api/terminals?operation_mode=__RP_TOK_0__&location_id=__RP_TOK_1__"))
      .header("Authorization", "__RP_TOK_2__")
      .header("Revolut-Api-Version", "__RP_TOK_3__")
      .GET(HttpRequest.BodyPublishers.noBody())
      .build();

    client.sendAsync(request, HttpResponse.BodyHandlers.ofString())
      .thenApply(HttpResponse::body)
      .thenAccept(System.out::println)
      .join();
  }
}
418:T15e8,
using System.Net.Http;
using System.Net.Http.Headers;

var client = new HttpClient();
var request = new HttpRequestMessage
{
  Method = HttpMethod.Get,
  RequestUri = new Uri("https://merchant.revolut.com/api/terminals?operation_mode=__RP_TOK_0__&location_id=__RP_TOK_1__"),
  Headers =
  {
    { "Authorization", "__RP_TOK_2__" },
    { "Revolut-Api-Version", "__RP_TOK_3__" },
  }
};

using (var response = await client.SendAsync(request))
{
  response.EnsureSuccessStatusCode();
  var body = await response.Content.ReadAsStringAsync();
  Console.WriteLine(body);
}
419:Ta08,
fetch("https://sandbox-merchant.revolut.com/api/terminals?operation_mode=__RP_TOK_0__&location_id=__RP_TOK_1__", {
  method: "GET",
  headers: {
    "Authorization": "__RP_TOK_2__",
    "Revolut-Api-Version": "__RP_TOK_3__"
  }
})
  .then(response => response.json())
  .then(data => console.log(data));
41a:Tfa5,
package main

import (
  "fmt"
  "net/http"
)

func main() {
  url := "https://sandbox-merchant.revolut.com/api/terminals?operation_mode=__RP_TOK_0__&location_id=__RP_TOK_1__"
  req, _ := http.NewRequest("GET", url, nil)
  req.Header.Add("Authorization", "__RP_TOK_2__")
  req.Header.Add("Revolut-Api-Version", "__RP_TOK_3__")

  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  fmt.Println(res)
}
41b:T81a,
import requests

url = "https://sandbox-merchant.revolut.com/api/terminals?operation_mode=__RP_TOK_0__&location_id=__RP_TOK_1__"
headers = {
  "Authorization": "__RP_TOK_2__",
  "Revolut-Api-Version": "__RP_TOK_3__"
}

response = requests.get(url, headers=headers)
print(response.json())
41c:T1746,
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;

public class Main {
  public static void main(String[] args) {
    HttpClient client = HttpClient.newHttpClient();
    HttpRequest request = HttpRequest.newBuilder()
      .uri(URI.create("https://sandbox-merchant.revolut.com/api/terminals?operation_mode=__RP_TOK_0__&location_id=__RP_TOK_1__"))
      .header("Authorization", "__RP_TOK_2__")
      .header("Revolut-Api-Version", "__RP_TOK_3__")
      .GET(HttpRequest.BodyPublishers.noBody())
      .build();

    client.sendAsync(request, HttpResponse.BodyHandlers.ofString())
      .thenApply(HttpResponse::body)
      .thenAccept(System.out::println)
      .join();
  }
}
41d:T15f0,
using System.Net.Http;
using System.Net.Http.Headers;

var client = new HttpClient();
var request = new HttpRequestMessage
{
  Method = HttpMethod.Get,
  RequestUri = new Uri("https://sandbox-merchant.revolut.com/api/terminals?operation_mode=__RP_TOK_0__&location_id=__RP_TOK_1__"),
  Headers =
  {
    { "Authorization", "__RP_TOK_2__" },
    { "Revolut-Api-Version", "__RP_TOK_3__" },
  }
};

using (var response = await client.SendAsync(request))
{
  response.EnsureSuccessStatusCode();
  var body = await response.Content.ReadAsStringAsync();
  Console.WriteLine(body);
}
3b3:["$","div",null,{"className":"ezz1n30","children":[["$","div",null,{"data-header":"$undefined","className":"ezz1n31","children":["$L40d",["$","$L85",null,{"parameters":[{"name":"Authorization","in":"header","schema":{"type":"string","format":"Bearer ","examples":"$62:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:0:schema:examples"},"required":true,"description":"This parameter accepts the [Merchant API Secret key](https://business.revolut.com/settings/apis?tab=merchant-api) to authorise requests coming from the merchant's backend. \n\nIt ensures that ensures that each request is authenticated and authorised by verifying the secret key. The secret key should be included in all request headers as a `Bearer` token.\n\n:::info\nFor more information, see: [Authentication](https://developer.revolut.com/docs/api/merchant#authentication)\n:::","descriptionNode":"$L40e"},{"name":"Revolut-Api-Version","in":"header","schema":{"type":"string","format":"date","enum":"$6b:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:1:schema:enum","examples":"$6b:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:1:schema:examples"},"description":"The version of the Merchant API, specified in `YYYY-MM-DD` format.\n\n:::info\nFor more information about API versioning, see: [API versions](https://developer.revolut.com/docs/guides/merchant/reference/versioning/api-versions).\n:::","x-config-always-visible-in-example":true,"descriptionNode":"$L40f"},{"name":"operation_mode","in":"query","required":false,"explode":true,"description":"Filter terminals by operation mode.\n\n| Value | Description |\n|-------|-------------|\n| `pos` | Returns only terminals in Pay at Counter mode |\n| `payment_acceptance` | Returns only terminals in standard checkout mode |","schema":{"title":"Terminal operation mode","type":"string","description":"The operation mode of the terminal.\n\n | Value | Description |\n|-------|-------------|\n| `pos` | Returns only terminals in Pay at Counter mode |\n| `payment_acceptance` | Returns only terminals in standard checkout mode |","enum":["pos","payment_acceptance"],"descriptionNode":"$L410"},"descriptionNode":"$L411"},{"name":"location_id","schema":{"type":"string","format":"uuid","description":"A UUID string, typically used to identify resources.","descriptionNode":"$L412"},"in":"query","required":false,"description":"Filter results by location ID.","descriptionNode":"$L413"}],"requestBody":"$undefined","heading":"Request","requestBodySchemaTitle":"Request body","headingAs":"h3"}],["$","$L89",null,{"responses":"$64:props:children:0:props:children:props:responses","headingAs":"h3"}]]}],["$","div",null,{"className":"ezz1n32","children":[[["$","$L8a",null,{"itemsByServer":{"https://merchant.revolut.com":[{"id":"curl","label":"cURL","templateCode":"curl -X GET \"https://merchant.revolut.com/api/terminals?operation_mode=__RP_TOK_0__&location_id=__RP_TOK_1__\" \\\n -H \"Authorization: __RP_TOK_2__\" \\\n -H \"Revolut-Api-Version: __RP_TOK_3__\"","templateHtml":"
curl -X GET \"https://merchant.revolut.com/api/terminals?operation_mode=__RP_TOK_0__&location_id=__RP_TOK_1__\" \\\n  -H \"Authorization: __RP_TOK_2__\" \\\n  -H \"Revolut-Api-Version: __RP_TOK_3__\"
","tokens":[{"marker":"__RP_TOK_0__","paramName":"operation_mode","paramIn":"query","pipeline":["url-component","shell-double-inner"]},{"marker":"__RP_TOK_1__","paramName":"location_id","paramIn":"query","pipeline":["url-component","shell-double-inner"]},{"marker":"__RP_TOK_2__","paramName":"Authorization","paramIn":"header","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_3__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["shell-double-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2023-09-01","query:operation_mode":"pos","query:location_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"javascript","label":"JavaScript","templateCode":"fetch(\"https://merchant.revolut.com/api/terminals?operation_mode=__RP_TOK_0__&location_id=__RP_TOK_1__\", {\n method: \"GET\",\n headers: {\n \"Authorization\": \"__RP_TOK_2__\",\n \"Revolut-Api-Version\": \"__RP_TOK_3__\"\n }\n})\n .then(response => response.json())\n .then(data => console.log(data));","templateHtml":"$414","tokens":[{"marker":"__RP_TOK_0__","paramName":"operation_mode","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"location_id","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_3__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2023-09-01","query:operation_mode":"pos","query:location_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"go","label":"Go","templateCode":"package main\n\nimport (\n \"fmt\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://merchant.revolut.com/api/terminals?operation_mode=__RP_TOK_0__&location_id=__RP_TOK_1__\"\n req, _ := http.NewRequest(\"GET\", url, nil)\n req.Header.Add(\"Authorization\", \"__RP_TOK_2__\")\n req.Header.Add(\"Revolut-Api-Version\", \"__RP_TOK_3__\")\n\n res, _ := http.DefaultClient.Do(req)\n defer res.Body.Close()\n fmt.Println(res)\n}","templateHtml":"$415","tokens":[{"marker":"__RP_TOK_0__","paramName":"operation_mode","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"location_id","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_3__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2023-09-01","query:operation_mode":"pos","query:location_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"python","label":"Python","templateCode":"import requests\n\nurl = \"https://merchant.revolut.com/api/terminals?operation_mode=__RP_TOK_0__&location_id=__RP_TOK_1__\"\nheaders = {\n \"Authorization\": \"__RP_TOK_2__\",\n \"Revolut-Api-Version\": \"__RP_TOK_3__\"\n}\n\nresponse = requests.get(url, headers=headers)\nprint(response.json())","templateHtml":"$416","tokens":[{"marker":"__RP_TOK_0__","paramName":"operation_mode","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"location_id","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_3__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2023-09-01","query:operation_mode":"pos","query:location_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"java","label":"Java","templateCode":"import java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\nimport java.net.URI;\n\npublic class Main {\n public static void main(String[] args) {\n HttpClient client = HttpClient.newHttpClient();\n HttpRequest request = HttpRequest.newBuilder()\n .uri(URI.create(\"https://merchant.revolut.com/api/terminals?operation_mode=__RP_TOK_0__&location_id=__RP_TOK_1__\"))\n .header(\"Authorization\", \"__RP_TOK_2__\")\n .header(\"Revolut-Api-Version\", \"__RP_TOK_3__\")\n .GET(HttpRequest.BodyPublishers.noBody())\n .build();\n\n client.sendAsync(request, HttpResponse.BodyHandlers.ofString())\n .thenApply(HttpResponse::body)\n .thenAccept(System.out::println)\n .join();\n }\n}","templateHtml":"$417","tokens":[{"marker":"__RP_TOK_0__","paramName":"operation_mode","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"location_id","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_3__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2023-09-01","query:operation_mode":"pos","query:location_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"csharp","label":"C#","templateCode":"using System.Net.Http;\nusing System.Net.Http.Headers;\n\nvar client = new HttpClient();\nvar request = new HttpRequestMessage\n{\n Method = HttpMethod.Get,\n RequestUri = new Uri(\"https://merchant.revolut.com/api/terminals?operation_mode=__RP_TOK_0__&location_id=__RP_TOK_1__\"),\n Headers =\n {\n { \"Authorization\", \"__RP_TOK_2__\" },\n { \"Revolut-Api-Version\", \"__RP_TOK_3__\" },\n }\n};\n\nusing (var response = await client.SendAsync(request))\n{\n response.EnsureSuccessStatusCode();\n var body = await response.Content.ReadAsStringAsync();\n Console.WriteLine(body);\n}","templateHtml":"$418","tokens":[{"marker":"__RP_TOK_0__","paramName":"operation_mode","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"location_id","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_3__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2023-09-01","query:operation_mode":"pos","query:location_id":"123e4567-e89b-12d3-a456-426614174000"}}],"https://sandbox-merchant.revolut.com":[{"id":"curl","label":"cURL","templateCode":"curl -X GET \"https://sandbox-merchant.revolut.com/api/terminals?operation_mode=__RP_TOK_0__&location_id=__RP_TOK_1__\" \\\n -H \"Authorization: __RP_TOK_2__\" \\\n -H \"Revolut-Api-Version: __RP_TOK_3__\"","templateHtml":"
curl -X GET \"https://sandbox-merchant.revolut.com/api/terminals?operation_mode=__RP_TOK_0__&location_id=__RP_TOK_1__\" \\\n  -H \"Authorization: __RP_TOK_2__\" \\\n  -H \"Revolut-Api-Version: __RP_TOK_3__\"
","tokens":[{"marker":"__RP_TOK_0__","paramName":"operation_mode","paramIn":"query","pipeline":["url-component","shell-double-inner"]},{"marker":"__RP_TOK_1__","paramName":"location_id","paramIn":"query","pipeline":["url-component","shell-double-inner"]},{"marker":"__RP_TOK_2__","paramName":"Authorization","paramIn":"header","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_3__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["shell-double-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2023-09-01","query:operation_mode":"pos","query:location_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"javascript","label":"JavaScript","templateCode":"fetch(\"https://sandbox-merchant.revolut.com/api/terminals?operation_mode=__RP_TOK_0__&location_id=__RP_TOK_1__\", {\n method: \"GET\",\n headers: {\n \"Authorization\": \"__RP_TOK_2__\",\n \"Revolut-Api-Version\": \"__RP_TOK_3__\"\n }\n})\n .then(response => response.json())\n .then(data => console.log(data));","templateHtml":"$419","tokens":[{"marker":"__RP_TOK_0__","paramName":"operation_mode","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"location_id","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_3__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2023-09-01","query:operation_mode":"pos","query:location_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"go","label":"Go","templateCode":"package main\n\nimport (\n \"fmt\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://sandbox-merchant.revolut.com/api/terminals?operation_mode=__RP_TOK_0__&location_id=__RP_TOK_1__\"\n req, _ := http.NewRequest(\"GET\", url, nil)\n req.Header.Add(\"Authorization\", \"__RP_TOK_2__\")\n req.Header.Add(\"Revolut-Api-Version\", \"__RP_TOK_3__\")\n\n res, _ := http.DefaultClient.Do(req)\n defer res.Body.Close()\n fmt.Println(res)\n}","templateHtml":"$41a","tokens":[{"marker":"__RP_TOK_0__","paramName":"operation_mode","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"location_id","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_3__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2023-09-01","query:operation_mode":"pos","query:location_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"python","label":"Python","templateCode":"import requests\n\nurl = \"https://sandbox-merchant.revolut.com/api/terminals?operation_mode=__RP_TOK_0__&location_id=__RP_TOK_1__\"\nheaders = {\n \"Authorization\": \"__RP_TOK_2__\",\n \"Revolut-Api-Version\": \"__RP_TOK_3__\"\n}\n\nresponse = requests.get(url, headers=headers)\nprint(response.json())","templateHtml":"$41b","tokens":[{"marker":"__RP_TOK_0__","paramName":"operation_mode","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"location_id","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_3__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2023-09-01","query:operation_mode":"pos","query:location_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"java","label":"Java","templateCode":"import java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\nimport java.net.URI;\n\npublic class Main {\n public static void main(String[] args) {\n HttpClient client = HttpClient.newHttpClient();\n HttpRequest request = HttpRequest.newBuilder()\n .uri(URI.create(\"https://sandbox-merchant.revolut.com/api/terminals?operation_mode=__RP_TOK_0__&location_id=__RP_TOK_1__\"))\n .header(\"Authorization\", \"__RP_TOK_2__\")\n .header(\"Revolut-Api-Version\", \"__RP_TOK_3__\")\n .GET(HttpRequest.BodyPublishers.noBody())\n .build();\n\n client.sendAsync(request, HttpResponse.BodyHandlers.ofString())\n .thenApply(HttpResponse::body)\n .thenAccept(System.out::println)\n .join();\n }\n}","templateHtml":"$41c","tokens":[{"marker":"__RP_TOK_0__","paramName":"operation_mode","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"location_id","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_3__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2023-09-01","query:operation_mode":"pos","query:location_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"csharp","label":"C#","templateCode":"using System.Net.Http;\nusing System.Net.Http.Headers;\n\nvar client = new HttpClient();\nvar request = new HttpRequestMessage\n{\n Method = HttpMethod.Get,\n RequestUri = new Uri(\"https://sandbox-merchant.revolut.com/api/terminals?operation_mode=__RP_TOK_0__&location_id=__RP_TOK_1__\"),\n Headers =\n {\n { \"Authorization\", \"__RP_TOK_2__\" },\n { \"Revolut-Api-Version\", \"__RP_TOK_3__\" },\n }\n};\n\nusing (var response = await client.SendAsync(request))\n{\n response.EnsureSuccessStatusCode();\n var body = await response.Content.ReadAsStringAsync();\n Console.WriteLine(body);\n}","templateHtml":"$41d","tokens":[{"marker":"__RP_TOK_0__","paramName":"operation_mode","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"location_id","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_3__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2023-09-01","query:operation_mode":"pos","query:location_id":"123e4567-e89b-12d3-a456-426614174000"}}]},"method":"get","servers":"$62:props:children:0:props:children:props:children:1:props:children:1:props:children:0:0:props:servers","path":"/api/terminals","parameters":["$3b3:props:children:0:props:children:1:props:parameters:0","$3b3:props:children:0:props:children:1:props:parameters:1","$3b3:props:children:0:props:children:1:props:parameters:2","$3b3:props:children:0:props:children:1:props:parameters:3"]}],"$L41e"],"$L41f","$L420"]}]]}] 3c5:["$","div",null,{"className":"ezz1n30","children":[["$","div",null,{"data-header":"$undefined","className":"ezz1n31","children":["$","div",null,{"className":"y9a0do1","children":[["$","h2",null,{"id":"retrieve-payment-intent","children":[["$L421","$undefined"],["$","$L15",null,{"id":"retrieve-payment-intent"}]]}],["$","$L16",null,{"url":"/docs/api/merchant/2025-10-16/operations/retrieve-payment-intent.md"}]]}]}],"$undefined"]}] 427:T9d9,
fetch("https://merchant.revolut.com/api/payment-intents/__RP_TOK_0__", {
  method: "GET",
  headers: {
    "Authorization": "__RP_TOK_1__",
    "Revolut-Api-Version": "__RP_TOK_2__"
  }
})
  .then(response => response.json())
  .then(data => console.log(data));
428:Tf76,
package main

import (
  "fmt"
  "net/http"
)

func main() {
  url := "https://merchant.revolut.com/api/payment-intents/__RP_TOK_0__"
  req, _ := http.NewRequest("GET", url, nil)
  req.Header.Add("Authorization", "__RP_TOK_1__")
  req.Header.Add("Revolut-Api-Version", "__RP_TOK_2__")

  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  fmt.Println(res)
}
429:T7eb,
import requests

url = "https://merchant.revolut.com/api/payment-intents/__RP_TOK_0__"
headers = {
  "Authorization": "__RP_TOK_1__",
  "Revolut-Api-Version": "__RP_TOK_2__"
}

response = requests.get(url, headers=headers)
print(response.json())
42a:T1717,
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;

public class Main {
  public static void main(String[] args) {
    HttpClient client = HttpClient.newHttpClient();
    HttpRequest request = HttpRequest.newBuilder()
      .uri(URI.create("https://merchant.revolut.com/api/payment-intents/__RP_TOK_0__"))
      .header("Authorization", "__RP_TOK_1__")
      .header("Revolut-Api-Version", "__RP_TOK_2__")
      .GET(HttpRequest.BodyPublishers.noBody())
      .build();

    client.sendAsync(request, HttpResponse.BodyHandlers.ofString())
      .thenApply(HttpResponse::body)
      .thenAccept(System.out::println)
      .join();
  }
}
42b:T15c1,
using System.Net.Http;
using System.Net.Http.Headers;

var client = new HttpClient();
var request = new HttpRequestMessage
{
  Method = HttpMethod.Get,
  RequestUri = new Uri("https://merchant.revolut.com/api/payment-intents/__RP_TOK_0__"),
  Headers =
  {
    { "Authorization", "__RP_TOK_1__" },
    { "Revolut-Api-Version", "__RP_TOK_2__" },
  }
};

using (var response = await client.SendAsync(request))
{
  response.EnsureSuccessStatusCode();
  var body = await response.Content.ReadAsStringAsync();
  Console.WriteLine(body);
}
42c:T9e1,
fetch("https://sandbox-merchant.revolut.com/api/payment-intents/__RP_TOK_0__", {
  method: "GET",
  headers: {
    "Authorization": "__RP_TOK_1__",
    "Revolut-Api-Version": "__RP_TOK_2__"
  }
})
  .then(response => response.json())
  .then(data => console.log(data));
42d:Tf7e,
package main

import (
  "fmt"
  "net/http"
)

func main() {
  url := "https://sandbox-merchant.revolut.com/api/payment-intents/__RP_TOK_0__"
  req, _ := http.NewRequest("GET", url, nil)
  req.Header.Add("Authorization", "__RP_TOK_1__")
  req.Header.Add("Revolut-Api-Version", "__RP_TOK_2__")

  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  fmt.Println(res)
}
42e:T7f3,
import requests

url = "https://sandbox-merchant.revolut.com/api/payment-intents/__RP_TOK_0__"
headers = {
  "Authorization": "__RP_TOK_1__",
  "Revolut-Api-Version": "__RP_TOK_2__"
}

response = requests.get(url, headers=headers)
print(response.json())
42f:T171f,
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;

public class Main {
  public static void main(String[] args) {
    HttpClient client = HttpClient.newHttpClient();
    HttpRequest request = HttpRequest.newBuilder()
      .uri(URI.create("https://sandbox-merchant.revolut.com/api/payment-intents/__RP_TOK_0__"))
      .header("Authorization", "__RP_TOK_1__")
      .header("Revolut-Api-Version", "__RP_TOK_2__")
      .GET(HttpRequest.BodyPublishers.noBody())
      .build();

    client.sendAsync(request, HttpResponse.BodyHandlers.ofString())
      .thenApply(HttpResponse::body)
      .thenAccept(System.out::println)
      .join();
  }
}
430:T15c9,
using System.Net.Http;
using System.Net.Http.Headers;

var client = new HttpClient();
var request = new HttpRequestMessage
{
  Method = HttpMethod.Get,
  RequestUri = new Uri("https://sandbox-merchant.revolut.com/api/payment-intents/__RP_TOK_0__"),
  Headers =
  {
    { "Authorization", "__RP_TOK_1__" },
    { "Revolut-Api-Version", "__RP_TOK_2__" },
  }
};

using (var response = await client.SendAsync(request))
{
  response.EnsureSuccessStatusCode();
  var body = await response.Content.ReadAsStringAsync();
  Console.WriteLine(body);
}
3c6:["$","div",null,{"className":"ezz1n30","children":[["$","div",null,{"data-header":"$undefined","className":"ezz1n31","children":["$L422",["$","$L85",null,{"parameters":[{"name":"Authorization","in":"header","schema":{"type":"string","format":"Bearer ","examples":"$62:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:0:schema:examples"},"required":true,"description":"This parameter accepts the [Merchant API Secret key](https://business.revolut.com/settings/apis?tab=merchant-api) to authorise requests coming from the merchant's backend. \n\nIt ensures that ensures that each request is authenticated and authorised by verifying the secret key. The secret key should be included in all request headers as a `Bearer` token.\n\n:::info\nFor more information, see: [Authentication](https://developer.revolut.com/docs/api/merchant#authentication)\n:::","descriptionNode":"$L423"},{"name":"Revolut-Api-Version","in":"header","schema":{"type":"string","format":"date","enum":"$6b:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:1:schema:enum","examples":"$6b:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:1:schema:examples"},"description":"The version of the Merchant API, specified in `YYYY-MM-DD` format.\n\n:::info\nFor more information about API versioning, see: [API versions](https://developer.revolut.com/docs/guides/merchant/reference/versioning/api-versions).\n:::","x-config-always-visible-in-example":true,"descriptionNode":"$L424"},{"name":"payment_intent_id","in":"path","required":true,"description":"The unique identifier of the payment intent.","schema":{"title":"Payment Intent ID","type":"string","format":"uuid","description":"The unique identifier of the payment intent.","descriptionNode":"$L425"},"descriptionNode":"$L426"}],"requestBody":"$undefined","heading":"Request","requestBodySchemaTitle":"Request body","headingAs":"h3"}],["$","$L89",null,{"responses":"$67:props:children:0:props:children:props:responses","headingAs":"h3"}]]}],["$","div",null,{"className":"ezz1n32","children":[[["$","$L8a",null,{"itemsByServer":{"https://merchant.revolut.com":[{"id":"curl","label":"cURL","templateCode":"curl -X GET \"https://merchant.revolut.com/api/payment-intents/__RP_TOK_0__\" \\\n -H \"Authorization: __RP_TOK_1__\" \\\n -H \"Revolut-Api-Version: __RP_TOK_2__\"","templateHtml":"
curl -X GET \"https://merchant.revolut.com/api/payment-intents/__RP_TOK_0__\" \\\n  -H \"Authorization: __RP_TOK_1__\" \\\n  -H \"Revolut-Api-Version: __RP_TOK_2__\"
","tokens":[{"marker":"__RP_TOK_0__","paramName":"payment_intent_id","paramIn":"path","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["shell-double-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2023-09-01","path:payment_intent_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"javascript","label":"JavaScript","templateCode":"fetch(\"https://merchant.revolut.com/api/payment-intents/__RP_TOK_0__\", {\n method: \"GET\",\n headers: {\n \"Authorization\": \"__RP_TOK_1__\",\n \"Revolut-Api-Version\": \"__RP_TOK_2__\"\n }\n})\n .then(response => response.json())\n .then(data => console.log(data));","templateHtml":"$427","tokens":[{"marker":"__RP_TOK_0__","paramName":"payment_intent_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2023-09-01","path:payment_intent_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"go","label":"Go","templateCode":"package main\n\nimport (\n \"fmt\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://merchant.revolut.com/api/payment-intents/__RP_TOK_0__\"\n req, _ := http.NewRequest(\"GET\", url, nil)\n req.Header.Add(\"Authorization\", \"__RP_TOK_1__\")\n req.Header.Add(\"Revolut-Api-Version\", \"__RP_TOK_2__\")\n\n res, _ := http.DefaultClient.Do(req)\n defer res.Body.Close()\n fmt.Println(res)\n}","templateHtml":"$428","tokens":[{"marker":"__RP_TOK_0__","paramName":"payment_intent_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2023-09-01","path:payment_intent_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"python","label":"Python","templateCode":"import requests\n\nurl = \"https://merchant.revolut.com/api/payment-intents/__RP_TOK_0__\"\nheaders = {\n \"Authorization\": \"__RP_TOK_1__\",\n \"Revolut-Api-Version\": \"__RP_TOK_2__\"\n}\n\nresponse = requests.get(url, headers=headers)\nprint(response.json())","templateHtml":"$429","tokens":[{"marker":"__RP_TOK_0__","paramName":"payment_intent_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2023-09-01","path:payment_intent_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"java","label":"Java","templateCode":"import java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\nimport java.net.URI;\n\npublic class Main {\n public static void main(String[] args) {\n HttpClient client = HttpClient.newHttpClient();\n HttpRequest request = HttpRequest.newBuilder()\n .uri(URI.create(\"https://merchant.revolut.com/api/payment-intents/__RP_TOK_0__\"))\n .header(\"Authorization\", \"__RP_TOK_1__\")\n .header(\"Revolut-Api-Version\", \"__RP_TOK_2__\")\n .GET(HttpRequest.BodyPublishers.noBody())\n .build();\n\n client.sendAsync(request, HttpResponse.BodyHandlers.ofString())\n .thenApply(HttpResponse::body)\n .thenAccept(System.out::println)\n .join();\n }\n}","templateHtml":"$42a","tokens":[{"marker":"__RP_TOK_0__","paramName":"payment_intent_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2023-09-01","path:payment_intent_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"csharp","label":"C#","templateCode":"using System.Net.Http;\nusing System.Net.Http.Headers;\n\nvar client = new HttpClient();\nvar request = new HttpRequestMessage\n{\n Method = HttpMethod.Get,\n RequestUri = new Uri(\"https://merchant.revolut.com/api/payment-intents/__RP_TOK_0__\"),\n Headers =\n {\n { \"Authorization\", \"__RP_TOK_1__\" },\n { \"Revolut-Api-Version\", \"__RP_TOK_2__\" },\n }\n};\n\nusing (var response = await client.SendAsync(request))\n{\n response.EnsureSuccessStatusCode();\n var body = await response.Content.ReadAsStringAsync();\n Console.WriteLine(body);\n}","templateHtml":"$42b","tokens":[{"marker":"__RP_TOK_0__","paramName":"payment_intent_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2023-09-01","path:payment_intent_id":"123e4567-e89b-12d3-a456-426614174000"}}],"https://sandbox-merchant.revolut.com":[{"id":"curl","label":"cURL","templateCode":"curl -X GET \"https://sandbox-merchant.revolut.com/api/payment-intents/__RP_TOK_0__\" \\\n -H \"Authorization: __RP_TOK_1__\" \\\n -H \"Revolut-Api-Version: __RP_TOK_2__\"","templateHtml":"
curl -X GET \"https://sandbox-merchant.revolut.com/api/payment-intents/__RP_TOK_0__\" \\\n  -H \"Authorization: __RP_TOK_1__\" \\\n  -H \"Revolut-Api-Version: __RP_TOK_2__\"
","tokens":[{"marker":"__RP_TOK_0__","paramName":"payment_intent_id","paramIn":"path","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["shell-double-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2023-09-01","path:payment_intent_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"javascript","label":"JavaScript","templateCode":"fetch(\"https://sandbox-merchant.revolut.com/api/payment-intents/__RP_TOK_0__\", {\n method: \"GET\",\n headers: {\n \"Authorization\": \"__RP_TOK_1__\",\n \"Revolut-Api-Version\": \"__RP_TOK_2__\"\n }\n})\n .then(response => response.json())\n .then(data => console.log(data));","templateHtml":"$42c","tokens":[{"marker":"__RP_TOK_0__","paramName":"payment_intent_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2023-09-01","path:payment_intent_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"go","label":"Go","templateCode":"package main\n\nimport (\n \"fmt\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://sandbox-merchant.revolut.com/api/payment-intents/__RP_TOK_0__\"\n req, _ := http.NewRequest(\"GET\", url, nil)\n req.Header.Add(\"Authorization\", \"__RP_TOK_1__\")\n req.Header.Add(\"Revolut-Api-Version\", \"__RP_TOK_2__\")\n\n res, _ := http.DefaultClient.Do(req)\n defer res.Body.Close()\n fmt.Println(res)\n}","templateHtml":"$42d","tokens":[{"marker":"__RP_TOK_0__","paramName":"payment_intent_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2023-09-01","path:payment_intent_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"python","label":"Python","templateCode":"import requests\n\nurl = \"https://sandbox-merchant.revolut.com/api/payment-intents/__RP_TOK_0__\"\nheaders = {\n \"Authorization\": \"__RP_TOK_1__\",\n \"Revolut-Api-Version\": \"__RP_TOK_2__\"\n}\n\nresponse = requests.get(url, headers=headers)\nprint(response.json())","templateHtml":"$42e","tokens":[{"marker":"__RP_TOK_0__","paramName":"payment_intent_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2023-09-01","path:payment_intent_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"java","label":"Java","templateCode":"import java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\nimport java.net.URI;\n\npublic class Main {\n public static void main(String[] args) {\n HttpClient client = HttpClient.newHttpClient();\n HttpRequest request = HttpRequest.newBuilder()\n .uri(URI.create(\"https://sandbox-merchant.revolut.com/api/payment-intents/__RP_TOK_0__\"))\n .header(\"Authorization\", \"__RP_TOK_1__\")\n .header(\"Revolut-Api-Version\", \"__RP_TOK_2__\")\n .GET(HttpRequest.BodyPublishers.noBody())\n .build();\n\n client.sendAsync(request, HttpResponse.BodyHandlers.ofString())\n .thenApply(HttpResponse::body)\n .thenAccept(System.out::println)\n .join();\n }\n}","templateHtml":"$42f","tokens":[{"marker":"__RP_TOK_0__","paramName":"payment_intent_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2023-09-01","path:payment_intent_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"csharp","label":"C#","templateCode":"using System.Net.Http;\nusing System.Net.Http.Headers;\n\nvar client = new HttpClient();\nvar request = new HttpRequestMessage\n{\n Method = HttpMethod.Get,\n RequestUri = new Uri(\"https://sandbox-merchant.revolut.com/api/payment-intents/__RP_TOK_0__\"),\n Headers =\n {\n { \"Authorization\", \"__RP_TOK_1__\" },\n { \"Revolut-Api-Version\", \"__RP_TOK_2__\" },\n }\n};\n\nusing (var response = await client.SendAsync(request))\n{\n response.EnsureSuccessStatusCode();\n var body = await response.Content.ReadAsStringAsync();\n Console.WriteLine(body);\n}","templateHtml":"$430","tokens":[{"marker":"__RP_TOK_0__","paramName":"payment_intent_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2023-09-01","path:payment_intent_id":"123e4567-e89b-12d3-a456-426614174000"}}]},"method":"get","servers":"$62:props:children:0:props:children:props:children:1:props:children:1:props:children:0:0:props:servers","path":"/api/payment-intents/{payment_intent_id}","parameters":["$3c6:props:children:0:props:children:1:props:parameters:0","$3c6:props:children:0:props:children:1:props:parameters:1","$3c6:props:children:0:props:children:1:props:parameters:2"]}],"$L431"],"$L432","$L433"]}]]}] 3db:["$","div",null,{"className":"ezz1n30","children":[["$","div",null,{"data-header":"$undefined","className":"ezz1n31","children":["$","div",null,{"className":"y9a0do1","children":[["$","h2",null,{"id":"cancel-payment-intent","children":[["$L434","$undefined"],["$","$L15",null,{"id":"cancel-payment-intent"}]]}],["$","$L16",null,{"url":"/docs/api/merchant/2025-10-16/operations/cancel-payment-intent.md"}]]}]}],"$undefined"]}] 43a:T9e1,
fetch("https://merchant.revolut.com/api/payment-intents/__RP_TOK_0__/cancel", {
  method: "POST",
  headers: {
    "Authorization": "__RP_TOK_1__",
    "Revolut-Api-Version": "__RP_TOK_2__"
  }
})
  .then(response => response.json())
  .then(data => console.log(data));
43b:Tf7e,
package main

import (
  "fmt"
  "net/http"
)

func main() {
  url := "https://merchant.revolut.com/api/payment-intents/__RP_TOK_0__/cancel"
  req, _ := http.NewRequest("POST", url, nil)
  req.Header.Add("Authorization", "__RP_TOK_1__")
  req.Header.Add("Revolut-Api-Version", "__RP_TOK_2__")

  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  fmt.Println(res)
}
43c:T7f3,
import requests

url = "https://merchant.revolut.com/api/payment-intents/__RP_TOK_0__/cancel"
headers = {
  "Authorization": "__RP_TOK_1__",
  "Revolut-Api-Version": "__RP_TOK_2__"
}

response = requests.post(url, headers=headers)
print(response.json())
43d:T171f,
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;

public class Main {
  public static void main(String[] args) {
    HttpClient client = HttpClient.newHttpClient();
    HttpRequest request = HttpRequest.newBuilder()
      .uri(URI.create("https://merchant.revolut.com/api/payment-intents/__RP_TOK_0__/cancel"))
      .header("Authorization", "__RP_TOK_1__")
      .header("Revolut-Api-Version", "__RP_TOK_2__")
      .POST(HttpRequest.BodyPublishers.noBody())
      .build();

    client.sendAsync(request, HttpResponse.BodyHandlers.ofString())
      .thenApply(HttpResponse::body)
      .thenAccept(System.out::println)
      .join();
  }
}
43e:T15c9,
using System.Net.Http;
using System.Net.Http.Headers;

var client = new HttpClient();
var request = new HttpRequestMessage
{
  Method = HttpMethod.Post,
  RequestUri = new Uri("https://merchant.revolut.com/api/payment-intents/__RP_TOK_0__/cancel"),
  Headers =
  {
    { "Authorization", "__RP_TOK_1__" },
    { "Revolut-Api-Version", "__RP_TOK_2__" },
  }
};

using (var response = await client.SendAsync(request))
{
  response.EnsureSuccessStatusCode();
  var body = await response.Content.ReadAsStringAsync();
  Console.WriteLine(body);
}
43f:T9e9,
fetch("https://sandbox-merchant.revolut.com/api/payment-intents/__RP_TOK_0__/cancel", {
  method: "POST",
  headers: {
    "Authorization": "__RP_TOK_1__",
    "Revolut-Api-Version": "__RP_TOK_2__"
  }
})
  .then(response => response.json())
  .then(data => console.log(data));
440:Tf86,
package main

import (
  "fmt"
  "net/http"
)

func main() {
  url := "https://sandbox-merchant.revolut.com/api/payment-intents/__RP_TOK_0__/cancel"
  req, _ := http.NewRequest("POST", url, nil)
  req.Header.Add("Authorization", "__RP_TOK_1__")
  req.Header.Add("Revolut-Api-Version", "__RP_TOK_2__")

  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  fmt.Println(res)
}
441:T7fb,
import requests

url = "https://sandbox-merchant.revolut.com/api/payment-intents/__RP_TOK_0__/cancel"
headers = {
  "Authorization": "__RP_TOK_1__",
  "Revolut-Api-Version": "__RP_TOK_2__"
}

response = requests.post(url, headers=headers)
print(response.json())
442:T1727,
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;

public class Main {
  public static void main(String[] args) {
    HttpClient client = HttpClient.newHttpClient();
    HttpRequest request = HttpRequest.newBuilder()
      .uri(URI.create("https://sandbox-merchant.revolut.com/api/payment-intents/__RP_TOK_0__/cancel"))
      .header("Authorization", "__RP_TOK_1__")
      .header("Revolut-Api-Version", "__RP_TOK_2__")
      .POST(HttpRequest.BodyPublishers.noBody())
      .build();

    client.sendAsync(request, HttpResponse.BodyHandlers.ofString())
      .thenApply(HttpResponse::body)
      .thenAccept(System.out::println)
      .join();
  }
}
443:T15d1,
using System.Net.Http;
using System.Net.Http.Headers;

var client = new HttpClient();
var request = new HttpRequestMessage
{
  Method = HttpMethod.Post,
  RequestUri = new Uri("https://sandbox-merchant.revolut.com/api/payment-intents/__RP_TOK_0__/cancel"),
  Headers =
  {
    { "Authorization", "__RP_TOK_1__" },
    { "Revolut-Api-Version", "__RP_TOK_2__" },
  }
};

using (var response = await client.SendAsync(request))
{
  response.EnsureSuccessStatusCode();
  var body = await response.Content.ReadAsStringAsync();
  Console.WriteLine(body);
}
3dc:["$","div",null,{"className":"ezz1n30","children":[["$","div",null,{"data-header":"$undefined","className":"ezz1n31","children":["$L435",["$","$L85",null,{"parameters":[{"name":"Authorization","in":"header","schema":{"type":"string","format":"Bearer ","examples":"$62:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:0:schema:examples"},"required":true,"description":"This parameter accepts the [Merchant API Secret key](https://business.revolut.com/settings/apis?tab=merchant-api) to authorise requests coming from the merchant's backend. \n\nIt ensures that ensures that each request is authenticated and authorised by verifying the secret key. The secret key should be included in all request headers as a `Bearer` token.\n\n:::info\nFor more information, see: [Authentication](https://developer.revolut.com/docs/api/merchant#authentication)\n:::","descriptionNode":"$L436"},{"name":"Revolut-Api-Version","in":"header","schema":{"type":"string","format":"date","enum":"$6b:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:1:schema:enum","examples":"$6b:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:1:schema:examples"},"description":"The version of the Merchant API, specified in `YYYY-MM-DD` format.\n\n:::info\nFor more information about API versioning, see: [API versions](https://developer.revolut.com/docs/guides/merchant/reference/versioning/api-versions).\n:::","x-config-always-visible-in-example":true,"descriptionNode":"$L437"},{"name":"payment_intent_id","in":"path","required":true,"description":"The unique identifier of the payment intent.","schema":{"title":"Payment Intent ID","type":"string","format":"uuid","description":"The unique identifier of the payment intent.","descriptionNode":"$L438"},"descriptionNode":"$L439"}],"requestBody":"$undefined","heading":"Request","requestBodySchemaTitle":"Request body","headingAs":"h3"}],["$","$L89",null,{"responses":"$68:props:children:0:props:children:props:responses","headingAs":"h3"}]]}],["$","div",null,{"className":"ezz1n32","children":[[["$","$L8a",null,{"itemsByServer":{"https://merchant.revolut.com":[{"id":"curl","label":"cURL","templateCode":"curl -X POST \"https://merchant.revolut.com/api/payment-intents/__RP_TOK_0__/cancel\" \\\n -H \"Authorization: __RP_TOK_1__\" \\\n -H \"Revolut-Api-Version: __RP_TOK_2__\"","templateHtml":"
curl -X POST \"https://merchant.revolut.com/api/payment-intents/__RP_TOK_0__/cancel\" \\\n  -H \"Authorization: __RP_TOK_1__\" \\\n  -H \"Revolut-Api-Version: __RP_TOK_2__\"
","tokens":[{"marker":"__RP_TOK_0__","paramName":"payment_intent_id","paramIn":"path","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["shell-double-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2023-09-01","path:payment_intent_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"javascript","label":"JavaScript","templateCode":"fetch(\"https://merchant.revolut.com/api/payment-intents/__RP_TOK_0__/cancel\", {\n method: \"POST\",\n headers: {\n \"Authorization\": \"__RP_TOK_1__\",\n \"Revolut-Api-Version\": \"__RP_TOK_2__\"\n }\n})\n .then(response => response.json())\n .then(data => console.log(data));","templateHtml":"$43a","tokens":[{"marker":"__RP_TOK_0__","paramName":"payment_intent_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2023-09-01","path:payment_intent_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"go","label":"Go","templateCode":"package main\n\nimport (\n \"fmt\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://merchant.revolut.com/api/payment-intents/__RP_TOK_0__/cancel\"\n req, _ := http.NewRequest(\"POST\", url, nil)\n req.Header.Add(\"Authorization\", \"__RP_TOK_1__\")\n req.Header.Add(\"Revolut-Api-Version\", \"__RP_TOK_2__\")\n\n res, _ := http.DefaultClient.Do(req)\n defer res.Body.Close()\n fmt.Println(res)\n}","templateHtml":"$43b","tokens":[{"marker":"__RP_TOK_0__","paramName":"payment_intent_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2023-09-01","path:payment_intent_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"python","label":"Python","templateCode":"import requests\n\nurl = \"https://merchant.revolut.com/api/payment-intents/__RP_TOK_0__/cancel\"\nheaders = {\n \"Authorization\": \"__RP_TOK_1__\",\n \"Revolut-Api-Version\": \"__RP_TOK_2__\"\n}\n\nresponse = requests.post(url, headers=headers)\nprint(response.json())","templateHtml":"$43c","tokens":[{"marker":"__RP_TOK_0__","paramName":"payment_intent_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2023-09-01","path:payment_intent_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"java","label":"Java","templateCode":"import java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\nimport java.net.URI;\n\npublic class Main {\n public static void main(String[] args) {\n HttpClient client = HttpClient.newHttpClient();\n HttpRequest request = HttpRequest.newBuilder()\n .uri(URI.create(\"https://merchant.revolut.com/api/payment-intents/__RP_TOK_0__/cancel\"))\n .header(\"Authorization\", \"__RP_TOK_1__\")\n .header(\"Revolut-Api-Version\", \"__RP_TOK_2__\")\n .POST(HttpRequest.BodyPublishers.noBody())\n .build();\n\n client.sendAsync(request, HttpResponse.BodyHandlers.ofString())\n .thenApply(HttpResponse::body)\n .thenAccept(System.out::println)\n .join();\n }\n}","templateHtml":"$43d","tokens":[{"marker":"__RP_TOK_0__","paramName":"payment_intent_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2023-09-01","path:payment_intent_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"csharp","label":"C#","templateCode":"using System.Net.Http;\nusing System.Net.Http.Headers;\n\nvar client = new HttpClient();\nvar request = new HttpRequestMessage\n{\n Method = HttpMethod.Post,\n RequestUri = new Uri(\"https://merchant.revolut.com/api/payment-intents/__RP_TOK_0__/cancel\"),\n Headers =\n {\n { \"Authorization\", \"__RP_TOK_1__\" },\n { \"Revolut-Api-Version\", \"__RP_TOK_2__\" },\n }\n};\n\nusing (var response = await client.SendAsync(request))\n{\n response.EnsureSuccessStatusCode();\n var body = await response.Content.ReadAsStringAsync();\n Console.WriteLine(body);\n}","templateHtml":"$43e","tokens":[{"marker":"__RP_TOK_0__","paramName":"payment_intent_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2023-09-01","path:payment_intent_id":"123e4567-e89b-12d3-a456-426614174000"}}],"https://sandbox-merchant.revolut.com":[{"id":"curl","label":"cURL","templateCode":"curl -X POST \"https://sandbox-merchant.revolut.com/api/payment-intents/__RP_TOK_0__/cancel\" \\\n -H \"Authorization: __RP_TOK_1__\" \\\n -H \"Revolut-Api-Version: __RP_TOK_2__\"","templateHtml":"
curl -X POST \"https://sandbox-merchant.revolut.com/api/payment-intents/__RP_TOK_0__/cancel\" \\\n  -H \"Authorization: __RP_TOK_1__\" \\\n  -H \"Revolut-Api-Version: __RP_TOK_2__\"
","tokens":[{"marker":"__RP_TOK_0__","paramName":"payment_intent_id","paramIn":"path","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["shell-double-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2023-09-01","path:payment_intent_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"javascript","label":"JavaScript","templateCode":"fetch(\"https://sandbox-merchant.revolut.com/api/payment-intents/__RP_TOK_0__/cancel\", {\n method: \"POST\",\n headers: {\n \"Authorization\": \"__RP_TOK_1__\",\n \"Revolut-Api-Version\": \"__RP_TOK_2__\"\n }\n})\n .then(response => response.json())\n .then(data => console.log(data));","templateHtml":"$43f","tokens":[{"marker":"__RP_TOK_0__","paramName":"payment_intent_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2023-09-01","path:payment_intent_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"go","label":"Go","templateCode":"package main\n\nimport (\n \"fmt\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://sandbox-merchant.revolut.com/api/payment-intents/__RP_TOK_0__/cancel\"\n req, _ := http.NewRequest(\"POST\", url, nil)\n req.Header.Add(\"Authorization\", \"__RP_TOK_1__\")\n req.Header.Add(\"Revolut-Api-Version\", \"__RP_TOK_2__\")\n\n res, _ := http.DefaultClient.Do(req)\n defer res.Body.Close()\n fmt.Println(res)\n}","templateHtml":"$440","tokens":[{"marker":"__RP_TOK_0__","paramName":"payment_intent_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2023-09-01","path:payment_intent_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"python","label":"Python","templateCode":"import requests\n\nurl = \"https://sandbox-merchant.revolut.com/api/payment-intents/__RP_TOK_0__/cancel\"\nheaders = {\n \"Authorization\": \"__RP_TOK_1__\",\n \"Revolut-Api-Version\": \"__RP_TOK_2__\"\n}\n\nresponse = requests.post(url, headers=headers)\nprint(response.json())","templateHtml":"$441","tokens":[{"marker":"__RP_TOK_0__","paramName":"payment_intent_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2023-09-01","path:payment_intent_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"java","label":"Java","templateCode":"import java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\nimport java.net.URI;\n\npublic class Main {\n public static void main(String[] args) {\n HttpClient client = HttpClient.newHttpClient();\n HttpRequest request = HttpRequest.newBuilder()\n .uri(URI.create(\"https://sandbox-merchant.revolut.com/api/payment-intents/__RP_TOK_0__/cancel\"))\n .header(\"Authorization\", \"__RP_TOK_1__\")\n .header(\"Revolut-Api-Version\", \"__RP_TOK_2__\")\n .POST(HttpRequest.BodyPublishers.noBody())\n .build();\n\n client.sendAsync(request, HttpResponse.BodyHandlers.ofString())\n .thenApply(HttpResponse::body)\n .thenAccept(System.out::println)\n .join();\n }\n}","templateHtml":"$442","tokens":[{"marker":"__RP_TOK_0__","paramName":"payment_intent_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2023-09-01","path:payment_intent_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"csharp","label":"C#","templateCode":"using System.Net.Http;\nusing System.Net.Http.Headers;\n\nvar client = new HttpClient();\nvar request = new HttpRequestMessage\n{\n Method = HttpMethod.Post,\n RequestUri = new Uri(\"https://sandbox-merchant.revolut.com/api/payment-intents/__RP_TOK_0__/cancel\"),\n Headers =\n {\n { \"Authorization\", \"__RP_TOK_1__\" },\n { \"Revolut-Api-Version\", \"__RP_TOK_2__\" },\n }\n};\n\nusing (var response = await client.SendAsync(request))\n{\n response.EnsureSuccessStatusCode();\n var body = await response.Content.ReadAsStringAsync();\n Console.WriteLine(body);\n}","templateHtml":"$443","tokens":[{"marker":"__RP_TOK_0__","paramName":"payment_intent_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2023-09-01","path:payment_intent_id":"123e4567-e89b-12d3-a456-426614174000"}}]},"method":"post","servers":"$62:props:children:0:props:children:props:children:1:props:children:1:props:children:0:0:props:servers","path":"/api/payment-intents/{payment_intent_id}/cancel","parameters":["$3dc:props:children:0:props:children:1:props:parameters:0","$3dc:props:children:0:props:children:1:props:parameters:1","$3dc:props:children:0:props:children:1:props:parameters:2"]}],"$L444"],"$L445","$L446"]}]]}] 3f6:["$","div",null,{"className":"ezz1n30","children":[["$","div",null,{"data-header":"$undefined","className":"ezz1n31","children":["$","div",null,{"className":"y9a0do1","children":[["$","h2",null,{"id":"change-subscription-plan","children":[["$L447","$undefined"],["$","$L15",null,{"id":"change-subscription-plan"}]]}],["$","$L16",null,{"url":"/docs/api/merchant/2025-10-16/operations/change-subscription-plan.md"}]]}]}],"$undefined"]}] 44d:T6e2,
curl -X POST "https://merchant.revolut.com/api/subscriptions/__RP_TOK_0__/change-plan" \
  -H "Content-Type: application/json" \
  -H "Authorization: __RP_TOK_1__" \
  -H "Revolut-Api-Version: __RP_TOK_2__" \
  -d '{
  "plan_variation_id": "850e8400-e29b-41d4-a716-446655440003",
  "scheduled": "at_cycle_end"
}'
44e:Tfd3,
const payload = {
  "plan_variation_id": "850e8400-e29b-41d4-a716-446655440003",
  "scheduled": "at_cycle_end"
};
fetch("https://merchant.revolut.com/api/subscriptions/__RP_TOK_0__/change-plan", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "__RP_TOK_1__",
    "Revolut-Api-Version": "__RP_TOK_2__"
  },
  body: JSON.stringify(payload)
})
  .then(response => response.json())
  .then(data => console.log(data));
44f:T16c7,
package main

import (
  "fmt"
  "net/http"
  "bytes"
  "encoding/json"
)

func main() {
  url := "https://merchant.revolut.com/api/subscriptions/__RP_TOK_0__/change-plan"
  jsonData := []byte(`
{
  "plan_variation_id": "850e8400-e29b-41d4-a716-446655440003",
  "scheduled": "at_cycle_end"
}
  `)
  req, _ := http.NewRequest("POST", url, bytes.NewBuffer(jsonData))
  req.Header.Add("Content-Type", "application/json")
  req.Header.Add("Authorization", "__RP_TOK_1__")
  req.Header.Add("Revolut-Api-Version", "__RP_TOK_2__")

  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  fmt.Println(res)
}
450:Td07,
import requests

url = "https://merchant.revolut.com/api/subscriptions/__RP_TOK_0__/change-plan"
headers = {
  "Content-Type": "application/json",
  "Authorization": "__RP_TOK_1__",
  "Revolut-Api-Version": "__RP_TOK_2__"
}
payload = {
  "plan_variation_id": "850e8400-e29b-41d4-a716-446655440003",
  "scheduled": "at_cycle_end"
}

response = requests.post(url, headers=headers, json=payload)
print(response.json())
451:T1c2b,
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;

public class Main {
  public static void main(String[] args) {
    HttpClient client = HttpClient.newHttpClient();
    String body = """
{
  "plan_variation_id": "850e8400-e29b-41d4-a716-446655440003",
  "scheduled": "at_cycle_end"
}
    """;

    HttpRequest request = HttpRequest.newBuilder()
      .uri(URI.create("https://merchant.revolut.com/api/subscriptions/__RP_TOK_0__/change-plan"))
      .header("Content-Type", "application/json")
      .header("Authorization", "__RP_TOK_1__")
      .header("Revolut-Api-Version", "__RP_TOK_2__")
      .POST(HttpRequest.BodyPublishers.ofString(body))
      .build();

    client.sendAsync(request, HttpResponse.BodyHandlers.ofString())
      .thenApply(HttpResponse::body)
      .thenAccept(System.out::println)
      .join();
  }
}
452:T1f9f,
using System.Net.Http;
using System.Net.Http.Headers;

var client = new HttpClient();
var request = new HttpRequestMessage
{
  Method = HttpMethod.Post,
  RequestUri = new Uri("https://merchant.revolut.com/api/subscriptions/__RP_TOK_0__/change-plan"),
  Headers =
  {
    { "Authorization", "__RP_TOK_1__" },
    { "Revolut-Api-Version", "__RP_TOK_2__" },
  },
  Content = new StringContent(@"{
  ""plan_variation_id"": ""850e8400-e29b-41d4-a716-446655440003"",
  ""scheduled"": ""at_cycle_end""
}")
  {
    Headers =
    {
      ContentType = new MediaTypeHeaderValue("application/json")
    }
  }
};

using (var response = await client.SendAsync(request))
{
  response.EnsureSuccessStatusCode();
  var body = await response.Content.ReadAsStringAsync();
  Console.WriteLine(body);
}
453:T6ea,
curl -X POST "https://sandbox-merchant.revolut.com/api/subscriptions/__RP_TOK_0__/change-plan" \
  -H "Content-Type: application/json" \
  -H "Authorization: __RP_TOK_1__" \
  -H "Revolut-Api-Version: __RP_TOK_2__" \
  -d '{
  "plan_variation_id": "850e8400-e29b-41d4-a716-446655440003",
  "scheduled": "at_cycle_end"
}'
454:Tfdb,
const payload = {
  "plan_variation_id": "850e8400-e29b-41d4-a716-446655440003",
  "scheduled": "at_cycle_end"
};
fetch("https://sandbox-merchant.revolut.com/api/subscriptions/__RP_TOK_0__/change-plan", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "__RP_TOK_1__",
    "Revolut-Api-Version": "__RP_TOK_2__"
  },
  body: JSON.stringify(payload)
})
  .then(response => response.json())
  .then(data => console.log(data));
455:T16cf,
package main

import (
  "fmt"
  "net/http"
  "bytes"
  "encoding/json"
)

func main() {
  url := "https://sandbox-merchant.revolut.com/api/subscriptions/__RP_TOK_0__/change-plan"
  jsonData := []byte(`
{
  "plan_variation_id": "850e8400-e29b-41d4-a716-446655440003",
  "scheduled": "at_cycle_end"
}
  `)
  req, _ := http.NewRequest("POST", url, bytes.NewBuffer(jsonData))
  req.Header.Add("Content-Type", "application/json")
  req.Header.Add("Authorization", "__RP_TOK_1__")
  req.Header.Add("Revolut-Api-Version", "__RP_TOK_2__")

  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  fmt.Println(res)
}
456:Td0f,
import requests

url = "https://sandbox-merchant.revolut.com/api/subscriptions/__RP_TOK_0__/change-plan"
headers = {
  "Content-Type": "application/json",
  "Authorization": "__RP_TOK_1__",
  "Revolut-Api-Version": "__RP_TOK_2__"
}
payload = {
  "plan_variation_id": "850e8400-e29b-41d4-a716-446655440003",
  "scheduled": "at_cycle_end"
}

response = requests.post(url, headers=headers, json=payload)
print(response.json())
457:T1c33,
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;

public class Main {
  public static void main(String[] args) {
    HttpClient client = HttpClient.newHttpClient();
    String body = """
{
  "plan_variation_id": "850e8400-e29b-41d4-a716-446655440003",
  "scheduled": "at_cycle_end"
}
    """;

    HttpRequest request = HttpRequest.newBuilder()
      .uri(URI.create("https://sandbox-merchant.revolut.com/api/subscriptions/__RP_TOK_0__/change-plan"))
      .header("Content-Type", "application/json")
      .header("Authorization", "__RP_TOK_1__")
      .header("Revolut-Api-Version", "__RP_TOK_2__")
      .POST(HttpRequest.BodyPublishers.ofString(body))
      .build();

    client.sendAsync(request, HttpResponse.BodyHandlers.ofString())
      .thenApply(HttpResponse::body)
      .thenAccept(System.out::println)
      .join();
  }
}
458:T1fa7,
using System.Net.Http;
using System.Net.Http.Headers;

var client = new HttpClient();
var request = new HttpRequestMessage
{
  Method = HttpMethod.Post,
  RequestUri = new Uri("https://sandbox-merchant.revolut.com/api/subscriptions/__RP_TOK_0__/change-plan"),
  Headers =
  {
    { "Authorization", "__RP_TOK_1__" },
    { "Revolut-Api-Version", "__RP_TOK_2__" },
  },
  Content = new StringContent(@"{
  ""plan_variation_id"": ""850e8400-e29b-41d4-a716-446655440003"",
  ""scheduled"": ""at_cycle_end""
}")
  {
    Headers =
    {
      ContentType = new MediaTypeHeaderValue("application/json")
    }
  }
};

using (var response = await client.SendAsync(request))
{
  response.EnsureSuccessStatusCode();
  var body = await response.Content.ReadAsStringAsync();
  Console.WriteLine(body);
}
3f7:["$","div",null,{"className":"ezz1n30","children":[["$","div",null,{"data-header":"$undefined","className":"ezz1n31","children":["$L448",["$","$L85",null,{"parameters":[{"name":"Authorization","in":"header","schema":{"type":"string","format":"Bearer ","examples":"$62:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:0:schema:examples"},"required":true,"description":"This parameter accepts the [Merchant API Secret key](https://business.revolut.com/settings/apis?tab=merchant-api) to authorise requests coming from the merchant's backend. \n\nIt ensures that ensures that each request is authenticated and authorised by verifying the secret key. The secret key should be included in all request headers as a `Bearer` token.\n\n:::info\nFor more information, see: [Authentication](https://developer.revolut.com/docs/api/merchant#authentication)\n:::","descriptionNode":"$L449"},{"name":"Revolut-Api-Version","in":"header","schema":{"type":"string","format":"date","enum":"$36:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:1:schema:enum","examples":"$36:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:1:schema:examples"},"required":true,"description":"The version of the Merchant API, specified in `YYYY-MM-DD` format.\n\nIf not specified, you will receive an error.\n\n\n:::info\nFor more information about API versioning, see: [API versions](https://developer.revolut.com/docs/guides/merchant/reference/versioning/api-versions).\n:::","x-config-always-visible-in-example":true,"example":"2025-10-16","descriptionNode":"$L44a"},{"name":"subscription_id","in":"path","schema":{"type":"string","format":"uuid","description":"A UUID string, typically used to identify resources.","descriptionNode":"$L44b"},"required":true,"description":"The ID of the subscription.","descriptionNode":"$L44c"}],"requestBody":"$37:props:children:0:props:children:props:requestBody","heading":"Request","requestBodySchemaTitle":"Request body","headingAs":"h3"}],["$","$L89",null,{"responses":"$37:props:children:0:props:children:props:responses","headingAs":"h3"}]]}],["$","div",null,{"className":"ezz1n32","children":[[["$","$L8a",null,{"itemsByServer":{"https://merchant.revolut.com":[{"id":"curl","label":"cURL","templateCode":"curl -X POST \"https://merchant.revolut.com/api/subscriptions/__RP_TOK_0__/change-plan\" \\\n -H \"Content-Type: application/json\" \\\n -H \"Authorization: __RP_TOK_1__\" \\\n -H \"Revolut-Api-Version: __RP_TOK_2__\" \\\n -d '{\n \"plan_variation_id\": \"850e8400-e29b-41d4-a716-446655440003\",\n \"scheduled\": \"at_cycle_end\"\n}'","templateHtml":"$44d","tokens":[{"marker":"__RP_TOK_0__","paramName":"subscription_id","paramIn":"path","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["shell-double-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:subscription_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"javascript","label":"JavaScript","templateCode":"const payload = {\n \"plan_variation_id\": \"850e8400-e29b-41d4-a716-446655440003\",\n \"scheduled\": \"at_cycle_end\"\n};\nfetch(\"https://merchant.revolut.com/api/subscriptions/__RP_TOK_0__/change-plan\", {\n method: \"POST\",\n headers: {\n \"Content-Type\": \"application/json\",\n \"Authorization\": \"__RP_TOK_1__\",\n \"Revolut-Api-Version\": \"__RP_TOK_2__\"\n },\n body: JSON.stringify(payload)\n})\n .then(response => response.json())\n .then(data => console.log(data));","templateHtml":"$44e","tokens":[{"marker":"__RP_TOK_0__","paramName":"subscription_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:subscription_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"go","label":"Go","templateCode":"package main\n\nimport (\n \"fmt\"\n \"net/http\"\n \"bytes\"\n \"encoding/json\"\n)\n\nfunc main() {\n url := \"https://merchant.revolut.com/api/subscriptions/__RP_TOK_0__/change-plan\"\n jsonData := []byte(`\n{\n \"plan_variation_id\": \"850e8400-e29b-41d4-a716-446655440003\",\n \"scheduled\": \"at_cycle_end\"\n}\n `)\n req, _ := http.NewRequest(\"POST\", url, bytes.NewBuffer(jsonData))\n req.Header.Add(\"Content-Type\", \"application/json\")\n req.Header.Add(\"Authorization\", \"__RP_TOK_1__\")\n req.Header.Add(\"Revolut-Api-Version\", \"__RP_TOK_2__\")\n\n res, _ := http.DefaultClient.Do(req)\n defer res.Body.Close()\n fmt.Println(res)\n}","templateHtml":"$44f","tokens":[{"marker":"__RP_TOK_0__","paramName":"subscription_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:subscription_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"python","label":"Python","templateCode":"import requests\n\nurl = \"https://merchant.revolut.com/api/subscriptions/__RP_TOK_0__/change-plan\"\nheaders = {\n \"Content-Type\": \"application/json\",\n \"Authorization\": \"__RP_TOK_1__\",\n \"Revolut-Api-Version\": \"__RP_TOK_2__\"\n}\npayload = {\n \"plan_variation_id\": \"850e8400-e29b-41d4-a716-446655440003\",\n \"scheduled\": \"at_cycle_end\"\n}\n\nresponse = requests.post(url, headers=headers, json=payload)\nprint(response.json())","templateHtml":"$450","tokens":[{"marker":"__RP_TOK_0__","paramName":"subscription_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:subscription_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"java","label":"Java","templateCode":"import java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\nimport java.net.URI;\n\npublic class Main {\n public static void main(String[] args) {\n HttpClient client = HttpClient.newHttpClient();\n String body = \"\"\"\n{\n \"plan_variation_id\": \"850e8400-e29b-41d4-a716-446655440003\",\n \"scheduled\": \"at_cycle_end\"\n}\n \"\"\";\n\n HttpRequest request = HttpRequest.newBuilder()\n .uri(URI.create(\"https://merchant.revolut.com/api/subscriptions/__RP_TOK_0__/change-plan\"))\n .header(\"Content-Type\", \"application/json\")\n .header(\"Authorization\", \"__RP_TOK_1__\")\n .header(\"Revolut-Api-Version\", \"__RP_TOK_2__\")\n .POST(HttpRequest.BodyPublishers.ofString(body))\n .build();\n\n client.sendAsync(request, HttpResponse.BodyHandlers.ofString())\n .thenApply(HttpResponse::body)\n .thenAccept(System.out::println)\n .join();\n }\n}","templateHtml":"$451","tokens":[{"marker":"__RP_TOK_0__","paramName":"subscription_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:subscription_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"csharp","label":"C#","templateCode":"using System.Net.Http;\nusing System.Net.Http.Headers;\n\nvar client = new HttpClient();\nvar request = new HttpRequestMessage\n{\n Method = HttpMethod.Post,\n RequestUri = new Uri(\"https://merchant.revolut.com/api/subscriptions/__RP_TOK_0__/change-plan\"),\n Headers =\n {\n { \"Authorization\", \"__RP_TOK_1__\" },\n { \"Revolut-Api-Version\", \"__RP_TOK_2__\" },\n },\n Content = new StringContent(@\"{\n \"\"plan_variation_id\"\": \"\"850e8400-e29b-41d4-a716-446655440003\"\",\n \"\"scheduled\"\": \"\"at_cycle_end\"\"\n}\")\n {\n Headers =\n {\n ContentType = new MediaTypeHeaderValue(\"application/json\")\n }\n }\n};\n\nusing (var response = await client.SendAsync(request))\n{\n response.EnsureSuccessStatusCode();\n var body = await response.Content.ReadAsStringAsync();\n Console.WriteLine(body);\n}","templateHtml":"$452","tokens":[{"marker":"__RP_TOK_0__","paramName":"subscription_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:subscription_id":"123e4567-e89b-12d3-a456-426614174000"}}],"https://sandbox-merchant.revolut.com":[{"id":"curl","label":"cURL","templateCode":"curl -X POST \"https://sandbox-merchant.revolut.com/api/subscriptions/__RP_TOK_0__/change-plan\" \\\n -H \"Content-Type: application/json\" \\\n -H \"Authorization: __RP_TOK_1__\" \\\n -H \"Revolut-Api-Version: __RP_TOK_2__\" \\\n -d '{\n \"plan_variation_id\": \"850e8400-e29b-41d4-a716-446655440003\",\n \"scheduled\": \"at_cycle_end\"\n}'","templateHtml":"$453","tokens":[{"marker":"__RP_TOK_0__","paramName":"subscription_id","paramIn":"path","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["shell-double-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:subscription_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"javascript","label":"JavaScript","templateCode":"const payload = {\n \"plan_variation_id\": \"850e8400-e29b-41d4-a716-446655440003\",\n \"scheduled\": \"at_cycle_end\"\n};\nfetch(\"https://sandbox-merchant.revolut.com/api/subscriptions/__RP_TOK_0__/change-plan\", {\n method: \"POST\",\n headers: {\n \"Content-Type\": \"application/json\",\n \"Authorization\": \"__RP_TOK_1__\",\n \"Revolut-Api-Version\": \"__RP_TOK_2__\"\n },\n body: JSON.stringify(payload)\n})\n .then(response => response.json())\n .then(data => console.log(data));","templateHtml":"$454","tokens":[{"marker":"__RP_TOK_0__","paramName":"subscription_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:subscription_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"go","label":"Go","templateCode":"package main\n\nimport (\n \"fmt\"\n \"net/http\"\n \"bytes\"\n \"encoding/json\"\n)\n\nfunc main() {\n url := \"https://sandbox-merchant.revolut.com/api/subscriptions/__RP_TOK_0__/change-plan\"\n jsonData := []byte(`\n{\n \"plan_variation_id\": \"850e8400-e29b-41d4-a716-446655440003\",\n \"scheduled\": \"at_cycle_end\"\n}\n `)\n req, _ := http.NewRequest(\"POST\", url, bytes.NewBuffer(jsonData))\n req.Header.Add(\"Content-Type\", \"application/json\")\n req.Header.Add(\"Authorization\", \"__RP_TOK_1__\")\n req.Header.Add(\"Revolut-Api-Version\", \"__RP_TOK_2__\")\n\n res, _ := http.DefaultClient.Do(req)\n defer res.Body.Close()\n fmt.Println(res)\n}","templateHtml":"$455","tokens":[{"marker":"__RP_TOK_0__","paramName":"subscription_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:subscription_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"python","label":"Python","templateCode":"import requests\n\nurl = \"https://sandbox-merchant.revolut.com/api/subscriptions/__RP_TOK_0__/change-plan\"\nheaders = {\n \"Content-Type\": \"application/json\",\n \"Authorization\": \"__RP_TOK_1__\",\n \"Revolut-Api-Version\": \"__RP_TOK_2__\"\n}\npayload = {\n \"plan_variation_id\": \"850e8400-e29b-41d4-a716-446655440003\",\n \"scheduled\": \"at_cycle_end\"\n}\n\nresponse = requests.post(url, headers=headers, json=payload)\nprint(response.json())","templateHtml":"$456","tokens":[{"marker":"__RP_TOK_0__","paramName":"subscription_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:subscription_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"java","label":"Java","templateCode":"import java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\nimport java.net.URI;\n\npublic class Main {\n public static void main(String[] args) {\n HttpClient client = HttpClient.newHttpClient();\n String body = \"\"\"\n{\n \"plan_variation_id\": \"850e8400-e29b-41d4-a716-446655440003\",\n \"scheduled\": \"at_cycle_end\"\n}\n \"\"\";\n\n HttpRequest request = HttpRequest.newBuilder()\n .uri(URI.create(\"https://sandbox-merchant.revolut.com/api/subscriptions/__RP_TOK_0__/change-plan\"))\n .header(\"Content-Type\", \"application/json\")\n .header(\"Authorization\", \"__RP_TOK_1__\")\n .header(\"Revolut-Api-Version\", \"__RP_TOK_2__\")\n .POST(HttpRequest.BodyPublishers.ofString(body))\n .build();\n\n client.sendAsync(request, HttpResponse.BodyHandlers.ofString())\n .thenApply(HttpResponse::body)\n .thenAccept(System.out::println)\n .join();\n }\n}","templateHtml":"$457","tokens":[{"marker":"__RP_TOK_0__","paramName":"subscription_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:subscription_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"csharp","label":"C#","templateCode":"using System.Net.Http;\nusing System.Net.Http.Headers;\n\nvar client = new HttpClient();\nvar request = new HttpRequestMessage\n{\n Method = HttpMethod.Post,\n RequestUri = new Uri(\"https://sandbox-merchant.revolut.com/api/subscriptions/__RP_TOK_0__/change-plan\"),\n Headers =\n {\n { \"Authorization\", \"__RP_TOK_1__\" },\n { \"Revolut-Api-Version\", \"__RP_TOK_2__\" },\n },\n Content = new StringContent(@\"{\n \"\"plan_variation_id\"\": \"\"850e8400-e29b-41d4-a716-446655440003\"\",\n \"\"scheduled\"\": \"\"at_cycle_end\"\"\n}\")\n {\n Headers =\n {\n ContentType = new MediaTypeHeaderValue(\"application/json\")\n }\n }\n};\n\nusing (var response = await client.SendAsync(request))\n{\n response.EnsureSuccessStatusCode();\n var body = await response.Content.ReadAsStringAsync();\n Console.WriteLine(body);\n}","templateHtml":"$458","tokens":[{"marker":"__RP_TOK_0__","paramName":"subscription_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:subscription_id":"123e4567-e89b-12d3-a456-426614174000"}}]},"method":"post","servers":"$62:props:children:0:props:children:props:children:1:props:children:1:props:children:0:0:props:servers","path":"/api/subscriptions/{subscription_id}/change-plan","parameters":["$3f7:props:children:0:props:children:1:props:parameters:0","$3f7:props:children:0:props:children:1:props:parameters:1","$3f7:props:children:0:props:children:1:props:parameters:2"]}],"$L459"],"$L45a","$L45b"]}]]}] 2b0:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An identifier that can be used to determine what went wrong."}],"\n",["$","p","p-1",{"children":"Error codes are not globally unique, but uniqueness is guaranteed within endpoints."}]]}] 2b1:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Some human readable text describing what went wrong."}]]}] 2b2:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://www.unixtimestamp.com/","target":"_blank","rel":"noreferrer","children":"UNIX timestamp"}]," of the date and time the error happened."]}]]}] 2b3:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unauthorized"}]]}] 2da:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Get a list of webhooks that you are currently subscribed to."}]]}] 2db:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["This parameter accepts the ",["$","a","a-0",{"href":"https://business.revolut.com/settings/apis?tab=merchant-api","target":"_blank","rel":"noreferrer","children":"Merchant API Secret key"}]," to authorise requests coming from the merchant's backend."]}],"\n",["$","p","p-1",{"children":["It ensures that ensures that each request is authenticated and authorised by verifying the secret key. The secret key should be included in all request headers as a ",["$","code","code-0",{"children":"Bearer"}]," token."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#authentication","target":"_blank","rel":"noreferrer","children":"Authentication"}]]}]}]]}]]}] 2dc:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The version of the Merchant API, specified in ",["$","code","code-0",{"children":"YYYY-MM-DD"}]," format."]}],"\n",["$","p","p-1",{"children":["This endpoint is available from version ",["$","code","code-0",{"children":"2024-09-01"}],". If a version earlier than ",["$","code","code-1",{"children":"2024-09-01"}]," is provided, the endpoint returns a ",["$","code","code-2",{"children":"404"}]," response."]}],"\n",["$","p","p-2",{"children":"If not specified, you will receive an error."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information about API versioning, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/reference/versioning/api-versions","target":"_blank","rel":"noreferrer","children":"API versions"}],"."]}]}]]}]]}] 2ea:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Domain ungistered successfully"}]]}] 2eb:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An identifier that can be used to determine what went wrong."}],"\n",["$","p","p-1",{"children":"Error codes are not globally unique, but uniqueness is guaranteed within endpoints."}]]}] 2ec:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Human readable text describing what went wrong."}]]}] 2ed:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Bad Request"}]]}] 2ee:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["Domain name of your website without the scheme (i.e. without ",["$","code","code-0",{"children":"http://"}]," or ",["$","code","code-1",{"children":"https://"}],")."]}]]}] 2ef:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A short explanation why you remove the domain."}]]}] 2f1:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unregister your website from Apple Pay's registered domains."}]]}] 2f2:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["This parameter accepts the ",["$","a","a-0",{"href":"https://business.revolut.com/settings/apis?tab=merchant-api","target":"_blank","rel":"noreferrer","children":"Merchant API Secret key"}]," to authorise requests coming from the merchant's backend."]}],"\n",["$","p","p-1",{"children":["It ensures that ensures that each request is authenticated and authorised by verifying the secret key. The secret key should be included in all request headers as a ",["$","code","code-0",{"children":"Bearer"}]," token."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#authentication","target":"_blank","rel":"noreferrer","children":"Authentication"}]]}]}]]}]]}] 2f3:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The version of the Merchant API, specified in ",["$","code","code-0",{"children":"YYYY-MM-DD"}]," format."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information about API versioning, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/reference/versioning/api-versions","target":"_blank","rel":"noreferrer","children":"API versions"}],"."]}]}]]}]]}] 303:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Permanent payout ID used for payouts operations."}]]}] 304:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The state of the payout."}]]}] 305:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The date and time the payout was created."}]]}] 306:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The destination of the payout funds when a merchant initiates a withdrawal from their merchant account."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Destination type","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"current_pocket"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["The funds were moved from the merchant account to the business account within the platform. This indicates an ",["$","strong","strong-0",{"children":"internal transfer"}],", allowing the merchant to access the funds within their own business account."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"external_beneficiary"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["The funds were transferred to an external bank account or beneficiary outside the platform. This indicates a ",["$","strong","strong-0",{"children":"transfer to an external account"}],", enabling the merchant to withdraw funds to external financial institutions."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 307:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The total amount of the payout in minor currency units. For example, ",["$","code","code-0",{"children":"7034"}]," represents €70.34."]}]]}] 308:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":[["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_4217","target":"_blank","rel":"noreferrer","children":"ISO 4217"}]," currency code in upper case."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information about the supported currencies, see: ",["$","a","a-0",{"href":"https://help.revolut.com/business/help/merchant-accounts/payments/in-which-currencies-can-i-accept-payments/","target":"_blank","rel":"noreferrer","children":"Help Center"}],"."]}]}]]}]]}] 309:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Payouts retrieved"}]]}] 30a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An identifier that can be used to determine what went wrong."}],"\n",["$","p","p-1",{"children":"Error codes are not globally unique, but uniqueness is guaranteed within endpoints."}]]}] 30b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Some human readable text describing what went wrong."}]]}] 30c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://www.unixtimestamp.com/","target":"_blank","rel":"noreferrer","children":"UNIX timestamp"}]," of the date and time the error happened."]}]]}] 30d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Bad Request"}]]}] 30e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An identifier that can be used to determine what went wrong."}],"\n",["$","p","p-1",{"children":"Error codes are not globally unique, but uniqueness is guaranteed within endpoints."}]]}] 30f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Some human readable text describing what went wrong."}]]}] 310:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://www.unixtimestamp.com/","target":"_blank","rel":"noreferrer","children":"UNIX timestamp"}]," of the date and time the error happened."]}]]}] 311:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unauthorized"}]]}] 48:["$","$7a","challenge-dispute",{"children":[["$","section",null,{"className":"y9a0do0","data-variant":"endpoint","children":["$","$L7b",null,{"responses":{"204":{"description":"Dispute challenged successfully","descriptionNode":"$L45c"},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"code":{"type":"string","description":"An identifier that can be used to determine what went wrong.\n\nError codes are not globally unique, but uniqueness is guaranteed within endpoints.","descriptionNode":"$L45d"},"message":{"type":"string","description":"Some human readable text describing what went wrong.","descriptionNode":"$L45e"},"timestamp":{"type":"integer","description":"The [UNIX timestamp](https://www.unixtimestamp.com/) of the date and time the error happened.","descriptionNode":"$L45f"}}},"examples":{"default":{"value":{"code":"bad_request","message":"Missing Revolut-Api-Version header","timestamp":1601296792533}}}}},"descriptionNode":"$L460"},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"code":{"type":"string","description":"An identifier that can be used to determine what went wrong.\n\nError codes are not globally unique, but uniqueness is guaranteed within endpoints.","descriptionNode":"$L461"},"message":{"type":"string","description":"Some human readable text describing what went wrong.","descriptionNode":"$L462"},"timestamp":{"type":"integer","description":"The [UNIX timestamp](https://www.unixtimestamp.com/) of the date and time the error happened.","descriptionNode":"$L463"}}},"examples":{"default":{"value":{"code":"unauthenticated","message":"Authentication failed","timestamp":1721049596461}}}}},"descriptionNode":"$L464"},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"code":{"type":"string","description":"An identifier that can be used to determine what went wrong.\n\nError codes are not globally unique, but uniqueness is guaranteed within endpoints.","descriptionNode":"$L465"},"message":{"type":"string","description":"Some human readable text describing what went wrong.","descriptionNode":"$L466"},"timestamp":{"type":"integer","description":"The [UNIX timestamp](https://www.unixtimestamp.com/) of the date and time the error happened.","descriptionNode":"$L467"}}},"examples":{"default":{"value":{"code":"not_found","message":"The requested operation is forbidden","timestamp":1721050063886}}}}},"descriptionNode":"$L468"},"404":{"description":"Not Found","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"code":{"type":"string","description":"An identifier that can be used to determine what went wrong.\n\nError codes are not globally unique, but uniqueness is guaranteed within endpoints.","descriptionNode":"$L469"},"message":{"type":"string","description":"Some human readable text describing what went wrong.","descriptionNode":"$L46a"},"timestamp":{"type":"integer","description":"The [UNIX timestamp](https://www.unixtimestamp.com/) of the date and time the error happened.","descriptionNode":"$L46b"}}},"examples":{"default":{"value":{"code":"not_found","message":"The requested resource is not found","timestamp":1721050063886}}}}},"descriptionNode":"$L46c"},"422":{"description":"Unprocessable entity","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"code":{"type":"string","description":"An identifier that can be used to determine what went wrong.\n\nError codes are not globally unique, but uniqueness is guaranteed within endpoints.","descriptionNode":"$L46d"},"message":{"type":"string","description":"Some human readable text describing what went wrong.","descriptionNode":"$L46e"},"timestamp":{"type":"integer","description":"The [UNIX timestamp](https://www.unixtimestamp.com/) of the date and time the error happened.","descriptionNode":"$L46f"}}}}},"descriptionNode":"$L470"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["reason","evidences"],"properties":{"reason":{"type":"string","description":"The reason for challenging the dispute.","enum":["product_already_delivered","refund_already_issued","disagree_with_customers_claim"],"examples":["refund_already_issued"],"descriptionNode":"$L471"},"comment":{"type":"string","description":"Additional explanation or comment for the challenge, if needed.","maxLength":250,"examples":["Refund PDF attached as evidence."],"descriptionNode":"$L472"},"evidences":{"type":"array","description":"A list of IDs of previously uploaded evidence files to associate with this challenge.\n\n:::warning\nEach evidence ID can only be used for **a single challenge**. This means, that evidences already assigned to a challenge **cannot be reused** for other challenges.\n:::","items":{"type":"string","format":"uuid","description":"ID of a previously uploaded evidence file.","descriptionNode":"$L473"},"minItems":1,"maxItems":10,"uniqueItems":true,"examples":[["121ac27c-b00a-44d0-9120-efeeec7c912d","0010e98d-0653-4dbe-8a4f-70cd5e9491f2"]],"descriptionNode":"$L474"}}},"examples":{"challenge_min":{"summary":"Minimal dispute challenge with reason and evidence","value":{"reason":"refund_already_issued","evidences":["121ac27c-b00a-44d0-9120-efeeec7c912d"]}},"challenge_with_evidence":{"summary":"Dispute challenge with reason, multiple evidences, and comment","value":{"reason":"product_already_delivered","comment":"The customer received the product on 2026-05-10 as confirmed by our delivery records.","evidences":["121ac27c-b00a-44d0-9120-efeeec7c912d","0010e98d-0653-4dbe-8a4f-70cd5e9491f2"]}}}}}},"variantLabels":["Minimal dispute challenge with reason and evidence","Dispute challenge with reason, multiple evidences, and comment"],"children":["$L475","$L476"]}]}],false]}] 477:T478,
{
  "code": "bad_request",
  "message": "Missing Revolut-Api-Version header",
  "timestamp": 1601296792533
}
1c2:["$","div","400-application/json-default",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$477"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"code\": \"bad_request\",\n \"message\": \"Missing Revolut-Api-Version header\",\n \"timestamp\": 1601296792533\n}"}]}]]}] 478:T46f,
{
  "code": "unauthenticated",
  "message": "Authentication failed",
  "timestamp": 1721049596461
}
1c3:["$","div","401-application/json-default",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$478"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"code\": \"unauthenticated\",\n \"message\": \"Authentication failed\",\n \"timestamp\": 1721049596461\n}"}]}]]}] 479:T478,
{
  "code": "not_found",
  "message": "The requested operation is forbidden",
  "timestamp": 1721050063886
}
1c4:["$","div","403-application/json-default",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$479"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"code\": \"not_found\",\n \"message\": \"The requested operation is forbidden\",\n \"timestamp\": 1721050063886\n}"}]}]]}] 47a:T477,
{
  "code": "not_found",
  "message": "The requested resource is not found",
  "timestamp": 1721050063886
}
1c5:["$","div","404-application/json-default",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$47a"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"code\": \"not_found\",\n \"message\": \"The requested resource is not found\",\n \"timestamp\": 1721050063886\n}"}]}]]}] 47b:T44d,
{
  "code": "string",
  "message": "string",
  "timestamp": 123
}
1c6:["$","div","422-application/json-default",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$47b"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"code\": \"string\",\n \"message\": \"string\",\n \"timestamp\": 123\n}"}]}]]}] 1c8:["$","div","200-application/json-report_run_processing",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"
{\n  \"report_run_id\": \"d6f6ef64-f668-4e64-8967-1cdf8afb2561\",\n  \"status\": \"processing\"\n}
"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"report_run_id\": \"d6f6ef64-f668-4e64-8967-1cdf8afb2561\",\n \"status\": \"processing\"\n}"}]}]]}] 47c:T4ca,
{
  "report_run_id": "d6f6ef64-f668-4e64-8967-1cdf8afb2561",
  "status": "completed",
  "file_url": "https://merchant.revolut.com/api/report-runs/d6f6ef64-f668-4e64-8967-1cdf8afb2561/file"
}
1c9:["$","div","200-application/json-report_run_completed",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$47c"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"report_run_id\": \"d6f6ef64-f668-4e64-8967-1cdf8afb2561\",\n \"status\": \"completed\",\n \"file_url\": \"https://merchant.revolut.com/api/report-runs/d6f6ef64-f668-4e64-8967-1cdf8afb2561/file\"\n}"}]}]]}] 1ca:["$","div","200-application/json-report_run_expired",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"
{\n  \"report_run_id\": \"d6f6ef64-f668-4e64-8967-1cdf8afb2561\",\n  \"status\": \"expired\"\n}
"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"report_run_id\": \"d6f6ef64-f668-4e64-8967-1cdf8afb2561\",\n \"status\": \"expired\"\n}"}]}]]}] 47d:T44d,
{
  "code": "string",
  "message": "string",
  "timestamp": 123
}
1cb:["$","div","400-application/json-default",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$47d"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"code\": \"string\",\n \"message\": \"string\",\n \"timestamp\": 123\n}"}]}]]}] 47e:T44d,
{
  "code": "string",
  "message": "string",
  "timestamp": 123
}
1cc:["$","div","401-application/json-default",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$47e"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"code\": \"string\",\n \"message\": \"string\",\n \"timestamp\": 123\n}"}]}]]}] 47f:T44d,
{
  "code": "string",
  "message": "string",
  "timestamp": 123
}
1cd:["$","div","404-application/json-default",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$47f"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"code\": \"string\",\n \"message\": \"string\",\n \"timestamp\": 123\n}"}]}]]}] 318:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Each Merchant API request must contain an authorization header in the following format:"}],"\n","$L480","\n",["$","p","p-1",{"children":"To use this API, you need to generate API keys from your Revolut Business account. The Secret key is used in the authorization header for all server calls, while the Public key is provided with payment methods at checkout."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For detailed instructions on generating your API keys, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/get-started#generate-api-keys","target":"_blank","rel":"noreferrer","children":"Generate API keys"}],"."]}]}]]}]]}] 320:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Each Merchant API request must contain an authorization header in the following format:"}],"\n","$L481","\n",["$","p","p-1",{"children":"To use this API, you need to generate API keys from your Revolut Business account. The Secret key is used in the authorization header for all server calls, while the Public key is provided with payment methods at checkout."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For detailed instructions on generating your API keys, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/get-started#generate-api-keys","target":"_blank","rel":"noreferrer","children":"Generate API keys"}],"."]}]}]]}]]}] 323:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Each Merchant API request must contain an authorization header in the following format:"}],"\n","$L482","\n",["$","p","p-1",{"children":"To use this API, you need to generate API keys from your Revolut Business account. The Secret key is used in the authorization header for all server calls, while the Public key is provided with payment methods at checkout."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For detailed instructions on generating your API keys, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/get-started#generate-api-keys","target":"_blank","rel":"noreferrer","children":"Generate API keys"}],"."]}]}]]}]]}] 312:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An identifier that can be used to determine what went wrong."}],"\n",["$","p","p-1",{"children":"Error codes are not globally unique, but uniqueness is guaranteed within endpoints."}]]}] 313:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Some human readable text describing what went wrong."}]]}] 314:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://www.unixtimestamp.com/","target":"_blank","rel":"noreferrer","children":"UNIX timestamp"}]," of the date and time the error happened."]}]]}] 315:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Not Found"}]]}] 327:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Retrieve all the payouts you made from your Merchant account. You can also use the query parameters for:"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Filtering","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Pagination","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["Filter the orders that you want to retrieve, for example, only retrieve the orders that have a specific email. ",["$","br","br-0",{}],["$","br","br-1",{}],"Parameters used for filtering:",["$","br","br-2",{}],["$","ul","ul-0",{"children":[["$","li","li-0",{"children":["$","code","code-0",{"children":"from_created_date"}]}],["$","li","li-1",{"children":["$","code","code-0",{"children":"to_created_date"}]}],["$","li","li-2",{"children":["$","code","code-0",{"children":"currency"}]}],["$","li","li-3",{"children":["$","code","code-0",{"children":"state"}]}]]}]],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["View the orders without loading all of them at once, for example, return a specified number of orders per page. ",["$","br","br-0",{}],["$","br","br-1",{}],"Parameters used for pagination: ",["$","br","br-2",{}],["$","ul","ul-0",{"children":["$","li","li-0",{"children":["$","code","code-0",{"children":"limit"}]}]}]],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 328:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["This parameter accepts the ",["$","a","a-0",{"href":"https://business.revolut.com/settings/apis?tab=merchant-api","target":"_blank","rel":"noreferrer","children":"Merchant API Secret key"}]," to authorise requests coming from the merchant's backend."]}],"\n",["$","p","p-1",{"children":["It ensures that ensures that each request is authenticated and authorised by verifying the secret key. The secret key should be included in all request headers as a ",["$","code","code-0",{"children":"Bearer"}]," token."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#authentication","target":"_blank","rel":"noreferrer","children":"Authentication"}]]}]}]]}]]}] 329:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The version of the Merchant API, specified in ",["$","code","code-0",{"children":"YYYY-MM-DD"}]," format."]}],"\n",["$","p","p-1",{"children":"If not specified, you will receive an error."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information about API versioning, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/reference/versioning/api-versions","target":"_blank","rel":"noreferrer","children":"API versions"}],"."]}]}]]}]]}] 32a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":[["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_4217","target":"_blank","rel":"noreferrer","children":"ISO 4217"}]," currency code in upper case."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information about the supported currencies, see: ",["$","a","a-0",{"href":"https://help.revolut.com/business/help/merchant-accounts/payments/in-which-currencies-can-i-accept-payments/","target":"_blank","rel":"noreferrer","children":"Help Center"}],"."]}]}]]}]]}] 32b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The maximum number of payouts returned per page. Used for ",["$","strong","strong-0",{"children":"pagination"}],"."]}]]}] 32c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["Retrieve all payouts with a ",["$","code","code-0",{"children":"created_date"}]," ≥ ",["$","code","code-1",{"children":"from_created_date"}],". Used for ",["$","strong","strong-0",{"children":"filtering"}],"."]}],"\n",["$","p","p-1",{"children":["Use the ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_8601","target":"_blank","rel":"noreferrer","children":"ISO date format"}],": ",["$","code","code-0",{"children":"yyyy-MM-ddTHH:mm:ss[.SSSSSS]Z"}],". For example, ",["$","code","code-1",{"children":"2021-02-10T16:59:50.886826Z"}],"."]}]]}] 32d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["Retrieve all payouts with a ",["$","code","code-0",{"children":"created_date"}]," ≤ ",["$","code","code-1",{"children":"to_created_date"}],". Used for ",["$","strong","strong-0",{"children":"filtering"}],"."]}],"\n",["$","p","p-1",{"children":["Use the ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_8601","target":"_blank","rel":"noreferrer","children":"ISO date format"}],": ",["$","code","code-0",{"children":"yyyy-MM-ddTHH:mm:ss[.SSSSSS]Z"}],". For example, ",["$","code","code-1",{"children":"2021-02-10T16:59:50.886826Z"}],"."]}]]}] 32e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["Retrieve all payouts with specific states. You can pass several states. Used for ",["$","strong","strong-0",{"children":"filtering"}],"."]}],"\n",["$","p","p-1",{"children":["If multiple states are selected, for example ",["$","code","code-0",{"children":"completed"}]," and ",["$","code","code-1",{"children":"processing"}],", payouts with either of the selected values are returned. See this example of such a request URL:"]}],"\n","$L483","\n",["$","p","p-2",{"children":"The parameter is case sensitive."}]]}] 41e:["$","$L10d",null,{"security":[{"Api-Key":[]}],"authorization":{"Api-Key":{"type":"apiKey","in":"header","name":"Authorization","description":"Each Merchant API request must contain an authorization header in the following format:\n\n```\n'Authorization: Bearer '\n```\n\nTo use this API, you need to generate API keys from your Revolut Business account. The Secret key is used in the authorization header for all server calls, while the Public key is provided with payment methods at checkout.\n\n:::info\nFor detailed instructions on generating your API keys, see: [Generate API keys](https://developer.revolut.com/docs/guides/merchant/get-started#generate-api-keys).\n:::","descriptionNode":"$L484"}}}] 41f:["$","$L10f",null,{"exampleBlocks":{},"title":"Request body samples","headingAs":"h4"}] 420:["$","$L110",null,{"exampleBlocks":{"200":{"application/json":{"variants":[{"key":"terminals_list","label":"List of terminals at a location","rawValue":"$64:props:children:0:props:children:props:responses:200:content:application/json:examples:terminals_list:value","block":"$L485"}],"syncedPropertyName":"$undefined"}},"400":{"application/json":{"variants":[{"key":"default","label":"Example","rawValue":{"code":"string","message":"string","timestamp":123},"block":"$L486"}],"syncedPropertyName":"$undefined"}},"401":{"application/json":{"variants":[{"key":"default","label":"Example","rawValue":{"code":"string","message":"string","timestamp":123},"block":"$L487"}],"syncedPropertyName":"$undefined"}}},"headingAs":"h4"}] 431:["$","$L10d",null,{"security":[{"Api-Key":[]}],"authorization":{"Api-Key":{"type":"apiKey","in":"header","name":"Authorization","description":"Each Merchant API request must contain an authorization header in the following format:\n\n```\n'Authorization: Bearer '\n```\n\nTo use this API, you need to generate API keys from your Revolut Business account. The Secret key is used in the authorization header for all server calls, while the Public key is provided with payment methods at checkout.\n\n:::info\nFor detailed instructions on generating your API keys, see: [Generate API keys](https://developer.revolut.com/docs/guides/merchant/get-started#generate-api-keys).\n:::","descriptionNode":"$L488"}}}] 432:["$","$L10f",null,{"exampleBlocks":{},"title":"Request body samples","headingAs":"h4"}] 433:["$","$L110",null,{"exampleBlocks":{"200":{"application/json":{"variants":[{"key":"payment_intent_pending","label":"Payment intent pending","rawValue":"$67:props:children:0:props:children:props:responses:200:content:application/json:examples:payment_intent_pending:value","block":"$L489"},{"key":"payment_intent_processing","label":"Payment intent processing","rawValue":"$67:props:children:0:props:children:props:responses:200:content:application/json:examples:payment_intent_processing:value","block":"$L48a"},{"key":"payment_intent_completed","label":"Payment intent completed","rawValue":"$67:props:children:0:props:children:props:responses:200:content:application/json:examples:payment_intent_completed:value","block":"$L48b"},{"key":"payment_intent_cancelled","label":"Payment intent cancelled","rawValue":"$67:props:children:0:props:children:props:responses:200:content:application/json:examples:payment_intent_cancelled:value","block":"$L48c"},{"key":"payment_intent_failed","label":"Payment intent failed","rawValue":"$67:props:children:0:props:children:props:responses:200:content:application/json:examples:payment_intent_failed:value","block":"$L48d"}],"syncedPropertyName":"$undefined"}},"401":{"application/json":{"variants":[{"key":"default","label":"Example","rawValue":{"errorId":"string","timestamp":123},"block":"$L48e"}],"syncedPropertyName":"$undefined"}},"404":{"application/json":{"variants":[{"key":"default","label":"Example","rawValue":{"errorId":"string","timestamp":123},"block":"$L48f"}],"syncedPropertyName":"$undefined"}}},"headingAs":"h4"}] 444:["$","$L10d",null,{"security":[{"Api-Key":[]}],"authorization":{"Api-Key":{"type":"apiKey","in":"header","name":"Authorization","description":"Each Merchant API request must contain an authorization header in the following format:\n\n```\n'Authorization: Bearer '\n```\n\nTo use this API, you need to generate API keys from your Revolut Business account. The Secret key is used in the authorization header for all server calls, while the Public key is provided with payment methods at checkout.\n\n:::info\nFor detailed instructions on generating your API keys, see: [Generate API keys](https://developer.revolut.com/docs/guides/merchant/get-started#generate-api-keys).\n:::","descriptionNode":"$L490"}}}] 445:["$","$L10f",null,{"exampleBlocks":{},"title":"Request body samples","headingAs":"h4"}] 446:["$","$L110",null,{"exampleBlocks":{"200":{"application/json":{"variants":[{"key":"payment_intent_cancelled","label":"Payment intent cancelled","rawValue":"$67:props:children:0:props:children:props:responses:200:content:application/json:examples:payment_intent_cancelled:value","block":"$L491"}],"syncedPropertyName":"$undefined"}},"400":{"application/json":{"variants":[{"key":"default","label":"Example","rawValue":{"errorId":"string","timestamp":123},"block":"$L492"}],"syncedPropertyName":"$undefined"}},"401":{"application/json":{"variants":[{"key":"default","label":"Example","rawValue":{"errorId":"string","timestamp":123},"block":"$L493"}],"syncedPropertyName":"$undefined"}},"404":{"application/json":{"variants":[{"key":"default","label":"Example","rawValue":{"errorId":"string","timestamp":123},"block":"$L494"}],"syncedPropertyName":"$undefined"}}},"headingAs":"h4"}] 459:["$","$L10d",null,{"security":[{"Api-Key":[]}],"authorization":{"Api-Key":{"type":"apiKey","in":"header","name":"Authorization","description":"Each Merchant API request must contain an authorization header in the following format:\n\n```\n'Authorization: Bearer '\n```\n\nTo use this API, you need to generate API keys from your Revolut Business account. The Secret key is used in the authorization header for all server calls, while the Public key is provided with payment methods at checkout.\n\n:::info\nFor detailed instructions on generating your API keys, see: [Generate API keys](https://developer.revolut.com/docs/guides/merchant/get-started#generate-api-keys).\n:::","descriptionNode":"$L495"}}}] 45a:["$","$L10f",null,{"exampleBlocks":{"application/json":{"variants":[{"key":"change_plan","label":"Schedule plan change at cycle end","rawValue":"$37:props:children:0:props:children:props:requestBody:content:application/json:examples:change_plan:value","block":"$L496"},{"key":"change_plan_with_reason","label":"Schedule plan change with reason","rawValue":"$37:props:children:0:props:children:props:requestBody:content:application/json:examples:change_plan_with_reason:value","block":"$L497"},{"key":"change_plan_with_phase","label":"Schedule plan change to a specific phase","rawValue":"$37:props:children:0:props:children:props:requestBody:content:application/json:examples:change_plan_with_phase:value","block":"$L498"}],"syncedPropertyName":"$undefined"}},"title":"Request body samples","headingAs":"h4"}] 45b:["$","$L110",null,{"exampleBlocks":{"204":{},"400":{"application/json":{"variants":[{"key":"immediate_not_supported","label":"Immediate plan change not supported","rawValue":"$37:props:children:0:props:children:props:responses:400:content:application/json:examples:immediate_not_supported:value","block":"$L499"}],"syncedPropertyName":"$undefined"}},"401":{"application/json":{"variants":[{"key":"default","label":"Example","rawValue":{"code":"string","message":"string","timestamp":123},"block":"$L49a"}],"syncedPropertyName":"$undefined"}},"404":{"application/json":{"variants":[{"key":"default","label":"Example","rawValue":{"code":"string","message":"string","timestamp":123},"block":"$L49b"}],"syncedPropertyName":"$undefined"}},"422":{"application/json":{"variants":[{"key":"subscription_finished","label":"Subscription is finished","rawValue":"$37:props:children:0:props:children:props:responses:422:content:application/json:examples:subscription_finished:value","block":"$L49c"},{"key":"next_cycle_exists","label":"Next cycle already exists with a different plan variation","rawValue":"$37:props:children:0:props:children:props:responses:422:content:application/json:examples:next_cycle_exists:value","block":"$L49d"}],"syncedPropertyName":"$undefined"}},"default":{"application/json":{"variants":[{"key":"default","label":"Example","rawValue":{"code":"string","message":"string","timestamp":123},"block":"$L49e"}],"syncedPropertyName":"$undefined"}}},"headingAs":"h4"}] 475:["$","div",null,{"className":"ezz1n30","children":[["$","div",null,{"data-header":"$undefined","className":"ezz1n31","children":["$","div",null,{"className":"y9a0do1","children":[["$","h2",null,{"id":"challenge-dispute","children":[["$L49f","$undefined"],["$","$L15",null,{"id":"challenge-dispute"}]]}],["$","$L16",null,{"url":"/docs/api/merchant/2025-10-16/operations/challenge-dispute.md"}]]}]}],"$undefined"]}] 4a5:T787,
curl -X POST "https://merchant.revolut.com/api/disputes/__RP_TOK_0__/challenge" \
  -H "Content-Type: application/json" \
  -H "Authorization: __RP_TOK_1__" \
  -H "Revolut-Api-Version: __RP_TOK_2__" \
  -d '{
  "reason": "refund_already_issued",
  "evidences": [
    "121ac27c-b00a-44d0-9120-efeeec7c912d"
  ]
}'
4a6:T1040,
const payload = {
  "reason": "refund_already_issued",
  "evidences": [
    "121ac27c-b00a-44d0-9120-efeeec7c912d"
  ]
};
fetch("https://merchant.revolut.com/api/disputes/__RP_TOK_0__/challenge", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "__RP_TOK_1__",
    "Revolut-Api-Version": "__RP_TOK_2__"
  },
  body: JSON.stringify(payload)
})
  .then(response => response.json())
  .then(data => console.log(data));
4a7:T176c,
package main

import (
  "fmt"
  "net/http"
  "bytes"
  "encoding/json"
)

func main() {
  url := "https://merchant.revolut.com/api/disputes/__RP_TOK_0__/challenge"
  jsonData := []byte(`
{
  "reason": "refund_already_issued",
  "evidences": [
    "121ac27c-b00a-44d0-9120-efeeec7c912d"
  ]
}
  `)
  req, _ := http.NewRequest("POST", url, bytes.NewBuffer(jsonData))
  req.Header.Add("Content-Type", "application/json")
  req.Header.Add("Authorization", "__RP_TOK_1__")
  req.Header.Add("Revolut-Api-Version", "__RP_TOK_2__")

  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  fmt.Println(res)
}
4a8:Td74,
import requests

url = "https://merchant.revolut.com/api/disputes/__RP_TOK_0__/challenge"
headers = {
  "Content-Type": "application/json",
  "Authorization": "__RP_TOK_1__",
  "Revolut-Api-Version": "__RP_TOK_2__"
}
payload = {
  "reason": "refund_already_issued",
  "evidences": [
    "121ac27c-b00a-44d0-9120-efeeec7c912d"
  ]
}

response = requests.post(url, headers=headers, json=payload)
print(response.json())
4a9:T1cd0,
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;

public class Main {
  public static void main(String[] args) {
    HttpClient client = HttpClient.newHttpClient();
    String body = """
{
  "reason": "refund_already_issued",
  "evidences": [
    "121ac27c-b00a-44d0-9120-efeeec7c912d"
  ]
}
    """;

    HttpRequest request = HttpRequest.newBuilder()
      .uri(URI.create("https://merchant.revolut.com/api/disputes/__RP_TOK_0__/challenge"))
      .header("Content-Type", "application/json")
      .header("Authorization", "__RP_TOK_1__")
      .header("Revolut-Api-Version", "__RP_TOK_2__")
      .POST(HttpRequest.BodyPublishers.ofString(body))
      .build();

    client.sendAsync(request, HttpResponse.BodyHandlers.ofString())
      .thenApply(HttpResponse::body)
      .thenAccept(System.out::println)
      .join();
  }
}
4aa:T200c,
using System.Net.Http;
using System.Net.Http.Headers;

var client = new HttpClient();
var request = new HttpRequestMessage
{
  Method = HttpMethod.Post,
  RequestUri = new Uri("https://merchant.revolut.com/api/disputes/__RP_TOK_0__/challenge"),
  Headers =
  {
    { "Authorization", "__RP_TOK_1__" },
    { "Revolut-Api-Version", "__RP_TOK_2__" },
  },
  Content = new StringContent(@"{
  ""reason"": ""refund_already_issued"",
  ""evidences"": [
    ""121ac27c-b00a-44d0-9120-efeeec7c912d""
  ]
}")
  {
    Headers =
    {
      ContentType = new MediaTypeHeaderValue("application/json")
    }
  }
};

using (var response = await client.SendAsync(request))
{
  response.EnsureSuccessStatusCode();
  var body = await response.Content.ReadAsStringAsync();
  Console.WriteLine(body);
}
4ab:T78f,
curl -X POST "https://sandbox-merchant.revolut.com/api/disputes/__RP_TOK_0__/challenge" \
  -H "Content-Type: application/json" \
  -H "Authorization: __RP_TOK_1__" \
  -H "Revolut-Api-Version: __RP_TOK_2__" \
  -d '{
  "reason": "refund_already_issued",
  "evidences": [
    "121ac27c-b00a-44d0-9120-efeeec7c912d"
  ]
}'
4ac:T1048,
const payload = {
  "reason": "refund_already_issued",
  "evidences": [
    "121ac27c-b00a-44d0-9120-efeeec7c912d"
  ]
};
fetch("https://sandbox-merchant.revolut.com/api/disputes/__RP_TOK_0__/challenge", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "__RP_TOK_1__",
    "Revolut-Api-Version": "__RP_TOK_2__"
  },
  body: JSON.stringify(payload)
})
  .then(response => response.json())
  .then(data => console.log(data));
4ad:T1774,
package main

import (
  "fmt"
  "net/http"
  "bytes"
  "encoding/json"
)

func main() {
  url := "https://sandbox-merchant.revolut.com/api/disputes/__RP_TOK_0__/challenge"
  jsonData := []byte(`
{
  "reason": "refund_already_issued",
  "evidences": [
    "121ac27c-b00a-44d0-9120-efeeec7c912d"
  ]
}
  `)
  req, _ := http.NewRequest("POST", url, bytes.NewBuffer(jsonData))
  req.Header.Add("Content-Type", "application/json")
  req.Header.Add("Authorization", "__RP_TOK_1__")
  req.Header.Add("Revolut-Api-Version", "__RP_TOK_2__")

  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  fmt.Println(res)
}
4ae:Td7c,
import requests

url = "https://sandbox-merchant.revolut.com/api/disputes/__RP_TOK_0__/challenge"
headers = {
  "Content-Type": "application/json",
  "Authorization": "__RP_TOK_1__",
  "Revolut-Api-Version": "__RP_TOK_2__"
}
payload = {
  "reason": "refund_already_issued",
  "evidences": [
    "121ac27c-b00a-44d0-9120-efeeec7c912d"
  ]
}

response = requests.post(url, headers=headers, json=payload)
print(response.json())
4af:T1cd8,
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;

public class Main {
  public static void main(String[] args) {
    HttpClient client = HttpClient.newHttpClient();
    String body = """
{
  "reason": "refund_already_issued",
  "evidences": [
    "121ac27c-b00a-44d0-9120-efeeec7c912d"
  ]
}
    """;

    HttpRequest request = HttpRequest.newBuilder()
      .uri(URI.create("https://sandbox-merchant.revolut.com/api/disputes/__RP_TOK_0__/challenge"))
      .header("Content-Type", "application/json")
      .header("Authorization", "__RP_TOK_1__")
      .header("Revolut-Api-Version", "__RP_TOK_2__")
      .POST(HttpRequest.BodyPublishers.ofString(body))
      .build();

    client.sendAsync(request, HttpResponse.BodyHandlers.ofString())
      .thenApply(HttpResponse::body)
      .thenAccept(System.out::println)
      .join();
  }
}
4b0:T2014,
using System.Net.Http;
using System.Net.Http.Headers;

var client = new HttpClient();
var request = new HttpRequestMessage
{
  Method = HttpMethod.Post,
  RequestUri = new Uri("https://sandbox-merchant.revolut.com/api/disputes/__RP_TOK_0__/challenge"),
  Headers =
  {
    { "Authorization", "__RP_TOK_1__" },
    { "Revolut-Api-Version", "__RP_TOK_2__" },
  },
  Content = new StringContent(@"{
  ""reason"": ""refund_already_issued"",
  ""evidences"": [
    ""121ac27c-b00a-44d0-9120-efeeec7c912d""
  ]
}")
  {
    Headers =
    {
      ContentType = new MediaTypeHeaderValue("application/json")
    }
  }
};

using (var response = await client.SendAsync(request))
{
  response.EnsureSuccessStatusCode();
  var body = await response.Content.ReadAsStringAsync();
  Console.WriteLine(body);
}
476:["$","div",null,{"className":"ezz1n30","children":[["$","div",null,{"data-header":"$undefined","className":"ezz1n31","children":["$L4a0",["$","$L85",null,{"parameters":[{"name":"Authorization","in":"header","schema":{"type":"string","format":"Bearer ","examples":"$62:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:0:schema:examples"},"required":true,"description":"This parameter accepts the [Merchant API Secret key](https://business.revolut.com/settings/apis?tab=merchant-api) to authorise requests coming from the merchant's backend. \n\nIt ensures that ensures that each request is authenticated and authorised by verifying the secret key. The secret key should be included in all request headers as a `Bearer` token.\n\n:::info\nFor more information, see: [Authentication](https://developer.revolut.com/docs/api/merchant#authentication)\n:::","descriptionNode":"$L4a1"},{"name":"Revolut-Api-Version","in":"header","schema":{"type":"string","format":"date","enum":"$36:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:1:schema:enum","examples":"$36:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:1:schema:examples"},"required":true,"description":"The version of the Merchant API, specified in `YYYY-MM-DD` format.\n\nIf not specified, you will receive an error.\n\n\n:::info\nFor more information about API versioning, see: [API versions](https://developer.revolut.com/docs/guides/merchant/reference/versioning/api-versions).\n:::","x-config-always-visible-in-example":true,"example":"2025-10-16","descriptionNode":"$L4a2"},{"name":"dispute_id","in":"path","schema":{"type":"string","format":"uuid","description":"A UUID string, typically used to identify resources.","descriptionNode":"$L4a3"},"required":true,"description":"The ID of the `Dispute` object.","descriptionNode":"$L4a4"}],"requestBody":"$48:props:children:0:props:children:props:requestBody","heading":"Request","requestBodySchemaTitle":"Request body","headingAs":"h3"}],["$","$L89",null,{"responses":"$48:props:children:0:props:children:props:responses","headingAs":"h3"}]]}],["$","div",null,{"className":"ezz1n32","children":[[["$","$L8a",null,{"itemsByServer":{"https://merchant.revolut.com":[{"id":"curl","label":"cURL","templateCode":"curl -X POST \"https://merchant.revolut.com/api/disputes/__RP_TOK_0__/challenge\" \\\n -H \"Content-Type: application/json\" \\\n -H \"Authorization: __RP_TOK_1__\" \\\n -H \"Revolut-Api-Version: __RP_TOK_2__\" \\\n -d '{\n \"reason\": \"refund_already_issued\",\n \"evidences\": [\n \"121ac27c-b00a-44d0-9120-efeeec7c912d\"\n ]\n}'","templateHtml":"$4a5","tokens":[{"marker":"__RP_TOK_0__","paramName":"dispute_id","paramIn":"path","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["shell-double-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:dispute_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"javascript","label":"JavaScript","templateCode":"const payload = {\n \"reason\": \"refund_already_issued\",\n \"evidences\": [\n \"121ac27c-b00a-44d0-9120-efeeec7c912d\"\n ]\n};\nfetch(\"https://merchant.revolut.com/api/disputes/__RP_TOK_0__/challenge\", {\n method: \"POST\",\n headers: {\n \"Content-Type\": \"application/json\",\n \"Authorization\": \"__RP_TOK_1__\",\n \"Revolut-Api-Version\": \"__RP_TOK_2__\"\n },\n body: JSON.stringify(payload)\n})\n .then(response => response.json())\n .then(data => console.log(data));","templateHtml":"$4a6","tokens":[{"marker":"__RP_TOK_0__","paramName":"dispute_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:dispute_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"go","label":"Go","templateCode":"package main\n\nimport (\n \"fmt\"\n \"net/http\"\n \"bytes\"\n \"encoding/json\"\n)\n\nfunc main() {\n url := \"https://merchant.revolut.com/api/disputes/__RP_TOK_0__/challenge\"\n jsonData := []byte(`\n{\n \"reason\": \"refund_already_issued\",\n \"evidences\": [\n \"121ac27c-b00a-44d0-9120-efeeec7c912d\"\n ]\n}\n `)\n req, _ := http.NewRequest(\"POST\", url, bytes.NewBuffer(jsonData))\n req.Header.Add(\"Content-Type\", \"application/json\")\n req.Header.Add(\"Authorization\", \"__RP_TOK_1__\")\n req.Header.Add(\"Revolut-Api-Version\", \"__RP_TOK_2__\")\n\n res, _ := http.DefaultClient.Do(req)\n defer res.Body.Close()\n fmt.Println(res)\n}","templateHtml":"$4a7","tokens":[{"marker":"__RP_TOK_0__","paramName":"dispute_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:dispute_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"python","label":"Python","templateCode":"import requests\n\nurl = \"https://merchant.revolut.com/api/disputes/__RP_TOK_0__/challenge\"\nheaders = {\n \"Content-Type\": \"application/json\",\n \"Authorization\": \"__RP_TOK_1__\",\n \"Revolut-Api-Version\": \"__RP_TOK_2__\"\n}\npayload = {\n \"reason\": \"refund_already_issued\",\n \"evidences\": [\n \"121ac27c-b00a-44d0-9120-efeeec7c912d\"\n ]\n}\n\nresponse = requests.post(url, headers=headers, json=payload)\nprint(response.json())","templateHtml":"$4a8","tokens":[{"marker":"__RP_TOK_0__","paramName":"dispute_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:dispute_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"java","label":"Java","templateCode":"import java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\nimport java.net.URI;\n\npublic class Main {\n public static void main(String[] args) {\n HttpClient client = HttpClient.newHttpClient();\n String body = \"\"\"\n{\n \"reason\": \"refund_already_issued\",\n \"evidences\": [\n \"121ac27c-b00a-44d0-9120-efeeec7c912d\"\n ]\n}\n \"\"\";\n\n HttpRequest request = HttpRequest.newBuilder()\n .uri(URI.create(\"https://merchant.revolut.com/api/disputes/__RP_TOK_0__/challenge\"))\n .header(\"Content-Type\", \"application/json\")\n .header(\"Authorization\", \"__RP_TOK_1__\")\n .header(\"Revolut-Api-Version\", \"__RP_TOK_2__\")\n .POST(HttpRequest.BodyPublishers.ofString(body))\n .build();\n\n client.sendAsync(request, HttpResponse.BodyHandlers.ofString())\n .thenApply(HttpResponse::body)\n .thenAccept(System.out::println)\n .join();\n }\n}","templateHtml":"$4a9","tokens":[{"marker":"__RP_TOK_0__","paramName":"dispute_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:dispute_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"csharp","label":"C#","templateCode":"using System.Net.Http;\nusing System.Net.Http.Headers;\n\nvar client = new HttpClient();\nvar request = new HttpRequestMessage\n{\n Method = HttpMethod.Post,\n RequestUri = new Uri(\"https://merchant.revolut.com/api/disputes/__RP_TOK_0__/challenge\"),\n Headers =\n {\n { \"Authorization\", \"__RP_TOK_1__\" },\n { \"Revolut-Api-Version\", \"__RP_TOK_2__\" },\n },\n Content = new StringContent(@\"{\n \"\"reason\"\": \"\"refund_already_issued\"\",\n \"\"evidences\"\": [\n \"\"121ac27c-b00a-44d0-9120-efeeec7c912d\"\"\n ]\n}\")\n {\n Headers =\n {\n ContentType = new MediaTypeHeaderValue(\"application/json\")\n }\n }\n};\n\nusing (var response = await client.SendAsync(request))\n{\n response.EnsureSuccessStatusCode();\n var body = await response.Content.ReadAsStringAsync();\n Console.WriteLine(body);\n}","templateHtml":"$4aa","tokens":[{"marker":"__RP_TOK_0__","paramName":"dispute_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:dispute_id":"123e4567-e89b-12d3-a456-426614174000"}}],"https://sandbox-merchant.revolut.com":[{"id":"curl","label":"cURL","templateCode":"curl -X POST \"https://sandbox-merchant.revolut.com/api/disputes/__RP_TOK_0__/challenge\" \\\n -H \"Content-Type: application/json\" \\\n -H \"Authorization: __RP_TOK_1__\" \\\n -H \"Revolut-Api-Version: __RP_TOK_2__\" \\\n -d '{\n \"reason\": \"refund_already_issued\",\n \"evidences\": [\n \"121ac27c-b00a-44d0-9120-efeeec7c912d\"\n ]\n}'","templateHtml":"$4ab","tokens":[{"marker":"__RP_TOK_0__","paramName":"dispute_id","paramIn":"path","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["shell-double-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:dispute_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"javascript","label":"JavaScript","templateCode":"const payload = {\n \"reason\": \"refund_already_issued\",\n \"evidences\": [\n \"121ac27c-b00a-44d0-9120-efeeec7c912d\"\n ]\n};\nfetch(\"https://sandbox-merchant.revolut.com/api/disputes/__RP_TOK_0__/challenge\", {\n method: \"POST\",\n headers: {\n \"Content-Type\": \"application/json\",\n \"Authorization\": \"__RP_TOK_1__\",\n \"Revolut-Api-Version\": \"__RP_TOK_2__\"\n },\n body: JSON.stringify(payload)\n})\n .then(response => response.json())\n .then(data => console.log(data));","templateHtml":"$4ac","tokens":[{"marker":"__RP_TOK_0__","paramName":"dispute_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:dispute_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"go","label":"Go","templateCode":"package main\n\nimport (\n \"fmt\"\n \"net/http\"\n \"bytes\"\n \"encoding/json\"\n)\n\nfunc main() {\n url := \"https://sandbox-merchant.revolut.com/api/disputes/__RP_TOK_0__/challenge\"\n jsonData := []byte(`\n{\n \"reason\": \"refund_already_issued\",\n \"evidences\": [\n \"121ac27c-b00a-44d0-9120-efeeec7c912d\"\n ]\n}\n `)\n req, _ := http.NewRequest(\"POST\", url, bytes.NewBuffer(jsonData))\n req.Header.Add(\"Content-Type\", \"application/json\")\n req.Header.Add(\"Authorization\", \"__RP_TOK_1__\")\n req.Header.Add(\"Revolut-Api-Version\", \"__RP_TOK_2__\")\n\n res, _ := http.DefaultClient.Do(req)\n defer res.Body.Close()\n fmt.Println(res)\n}","templateHtml":"$4ad","tokens":[{"marker":"__RP_TOK_0__","paramName":"dispute_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:dispute_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"python","label":"Python","templateCode":"import requests\n\nurl = \"https://sandbox-merchant.revolut.com/api/disputes/__RP_TOK_0__/challenge\"\nheaders = {\n \"Content-Type\": \"application/json\",\n \"Authorization\": \"__RP_TOK_1__\",\n \"Revolut-Api-Version\": \"__RP_TOK_2__\"\n}\npayload = {\n \"reason\": \"refund_already_issued\",\n \"evidences\": [\n \"121ac27c-b00a-44d0-9120-efeeec7c912d\"\n ]\n}\n\nresponse = requests.post(url, headers=headers, json=payload)\nprint(response.json())","templateHtml":"$4ae","tokens":[{"marker":"__RP_TOK_0__","paramName":"dispute_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:dispute_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"java","label":"Java","templateCode":"import java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\nimport java.net.URI;\n\npublic class Main {\n public static void main(String[] args) {\n HttpClient client = HttpClient.newHttpClient();\n String body = \"\"\"\n{\n \"reason\": \"refund_already_issued\",\n \"evidences\": [\n \"121ac27c-b00a-44d0-9120-efeeec7c912d\"\n ]\n}\n \"\"\";\n\n HttpRequest request = HttpRequest.newBuilder()\n .uri(URI.create(\"https://sandbox-merchant.revolut.com/api/disputes/__RP_TOK_0__/challenge\"))\n .header(\"Content-Type\", \"application/json\")\n .header(\"Authorization\", \"__RP_TOK_1__\")\n .header(\"Revolut-Api-Version\", \"__RP_TOK_2__\")\n .POST(HttpRequest.BodyPublishers.ofString(body))\n .build();\n\n client.sendAsync(request, HttpResponse.BodyHandlers.ofString())\n .thenApply(HttpResponse::body)\n .thenAccept(System.out::println)\n .join();\n }\n}","templateHtml":"$4af","tokens":[{"marker":"__RP_TOK_0__","paramName":"dispute_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:dispute_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"csharp","label":"C#","templateCode":"using System.Net.Http;\nusing System.Net.Http.Headers;\n\nvar client = new HttpClient();\nvar request = new HttpRequestMessage\n{\n Method = HttpMethod.Post,\n RequestUri = new Uri(\"https://sandbox-merchant.revolut.com/api/disputes/__RP_TOK_0__/challenge\"),\n Headers =\n {\n { \"Authorization\", \"__RP_TOK_1__\" },\n { \"Revolut-Api-Version\", \"__RP_TOK_2__\" },\n },\n Content = new StringContent(@\"{\n \"\"reason\"\": \"\"refund_already_issued\"\",\n \"\"evidences\"\": [\n \"\"121ac27c-b00a-44d0-9120-efeeec7c912d\"\"\n ]\n}\")\n {\n Headers =\n {\n ContentType = new MediaTypeHeaderValue(\"application/json\")\n }\n }\n};\n\nusing (var response = await client.SendAsync(request))\n{\n response.EnsureSuccessStatusCode();\n var body = await response.Content.ReadAsStringAsync();\n Console.WriteLine(body);\n}","templateHtml":"$4b0","tokens":[{"marker":"__RP_TOK_0__","paramName":"dispute_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:dispute_id":"123e4567-e89b-12d3-a456-426614174000"}}]},"method":"post","servers":"$62:props:children:0:props:children:props:children:1:props:children:1:props:children:0:0:props:servers","path":"/api/disputes/{dispute_id}/challenge","parameters":["$476:props:children:0:props:children:1:props:parameters:0","$476:props:children:0:props:children:1:props:parameters:1","$476:props:children:0:props:children:1:props:parameters:2"]}],"$L4b1"],"$L4b2","$L4b3"]}]]}] 33f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Each Merchant API request must contain an authorization header in the following format:"}],"\n","$L4b4","\n",["$","p","p-1",{"children":"To use this API, you need to generate API keys from your Revolut Business account. The Secret key is used in the authorization header for all server calls, while the Public key is provided with payment methods at checkout."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For detailed instructions on generating your API keys, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/get-started#generate-api-keys","target":"_blank","rel":"noreferrer","children":"Generate API keys"}],"."]}]}]]}]]}] 344:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["Token for retrieving the next page of results. Use this token as the value of the ",["$","code","code-0",{"children":"page_token"}]," query parameter in your next request to retrieve the next page."]}],"\n",["$","p","p-1",{"children":"If not present, there are no more results to retrieve."}]]}] 345:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unique identifier for the customer."}]]}] 346:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The full name of the customer."}]]}] 347:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The email address of the customer."}]]}] 348:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The phone number of the customer in ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/E.164","target":"_blank","rel":"noreferrer","children":"E.164 format"}],"."]}]]}] 349:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The date and time the customer was created."}]]}] 34a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The date and time the customer was last updated."}]]}] 34b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A customer object."}]]}] 34c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"List of customers."}]]}] 34d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"OK"}]]}] 34e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An identifier that can be used to determine what went wrong."}],"\n",["$","p","p-1",{"children":"Error codes are not globally unique, but uniqueness is guaranteed within endpoints."}]]}] 34f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Some human readable text describing what went wrong."}]]}] 350:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://www.unixtimestamp.com/","target":"_blank","rel":"noreferrer","children":"UNIX timestamp"}]," of the date and time the error happened."]}]]}] 351:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unauthorized"}]]}] 353:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Get a paginated list of your customer profiles."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Filtering","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Pagination","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["Filter the customers that you want to retrieve, for example, only retrieve customers created within a specific date range. ",["$","br","br-0",{}],["$","br","br-1",{}],"Parameters used for filtering:",["$","br","br-2",{}],["$","ul","ul-0",{"children":[["$","li","li-0",{"children":["$","code","code-0",{"children":"from"}]}],["$","li","li-1",{"children":["$","code","code-0",{"children":"to"}]}]]}]],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["View customers without loading all of them at once, for example, return a specified number of customers per page. ",["$","br","br-0",{}],["$","br","br-1",{}],"Parameters used for pagination:",["$","br","br-2",{}],["$","ul","ul-0",{"children":[["$","li","li-0",{"children":["$","code","code-0",{"children":"limit"}]}],["$","li","li-1",{"children":["$","code","code-0",{"children":"page_token"}]}]]}]],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt3","ref":"$undefined"}]]}]}],"\n",["$","p","p-1",{"children":"To paginate through all results:"}],"\n",["$","ol","ol-0",{"children":["\n",["$","li","li-0",{"children":["Make an initial request with the desired ",["$","code","code-0",{"children":"limit"}]," and any filter parameters."]}],"\n",["$","li","li-1",{"children":["If more results are available, the response includes a ",["$","code","code-0",{"children":"next_page_token"}],"."]}],"\n",["$","li","li-2",{"children":["Pass ",["$","code","code-0",{"children":"next_page_token"}]," as ",["$","code","code-1",{"children":"page_token"}]," in your next request, keeping all other parameters unchanged."]}],"\n",["$","li","li-3",{"children":["Repeat until ",["$","code","code-0",{"children":"next_page_token"}]," is no longer present in the response."]}],"\n"]}]]}] 354:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["This parameter accepts the ",["$","a","a-0",{"href":"https://business.revolut.com/settings/apis?tab=merchant-api","target":"_blank","rel":"noreferrer","children":"Merchant API Secret key"}]," to authorise requests coming from the merchant's backend."]}],"\n",["$","p","p-1",{"children":["It ensures that ensures that each request is authenticated and authorised by verifying the secret key. The secret key should be included in all request headers as a ",["$","code","code-0",{"children":"Bearer"}]," token."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#authentication","target":"_blank","rel":"noreferrer","children":"Authentication"}]]}]}]]}]]}] 389:"Rotate a webhook signing secret" 4b1:["$","$L10d",null,{"security":[{"Api-Key":[]}],"authorization":{"Api-Key":{"type":"apiKey","in":"header","name":"Authorization","description":"Each Merchant API request must contain an authorization header in the following format:\n\n```\n'Authorization: Bearer '\n```\n\nTo use this API, you need to generate API keys from your Revolut Business account. The Secret key is used in the authorization header for all server calls, while the Public key is provided with payment methods at checkout.\n\n:::info\nFor detailed instructions on generating your API keys, see: [Generate API keys](https://developer.revolut.com/docs/guides/merchant/get-started#generate-api-keys).\n:::","descriptionNode":"$L4b5"}}}] 4b2:["$","$L10f",null,{"exampleBlocks":{"application/json":{"variants":[{"key":"challenge_min","label":"Minimal dispute challenge with reason and evidence","rawValue":"$48:props:children:0:props:children:props:requestBody:content:application/json:examples:challenge_min:value","block":"$L4b6"},{"key":"challenge_with_evidence","label":"Dispute challenge with reason, multiple evidences, and comment","rawValue":"$48:props:children:0:props:children:props:requestBody:content:application/json:examples:challenge_with_evidence:value","block":"$L4b7"}],"syncedPropertyName":"$undefined"}},"title":"Request body samples","headingAs":"h4"}] 4b3:["$","$L110",null,{"exampleBlocks":{"204":{},"400":{"application/json":{"variants":[{"key":"default","label":"default","rawValue":"$48:props:children:0:props:children:props:responses:400:content:application/json:examples:default:value","block":"$L4b8"}],"syncedPropertyName":"$undefined"}},"401":{"application/json":{"variants":[{"key":"default","label":"default","rawValue":"$48:props:children:0:props:children:props:responses:401:content:application/json:examples:default:value","block":"$L4b9"}],"syncedPropertyName":"$undefined"}},"403":{"application/json":{"variants":[{"key":"default","label":"default","rawValue":"$48:props:children:0:props:children:props:responses:403:content:application/json:examples:default:value","block":"$L4ba"}],"syncedPropertyName":"$undefined"}},"404":{"application/json":{"variants":[{"key":"default","label":"default","rawValue":"$48:props:children:0:props:children:props:responses:404:content:application/json:examples:default:value","block":"$L4bb"}],"syncedPropertyName":"$undefined"}},"422":{"application/json":{"variants":[{"key":"default","label":"Example","rawValue":{"code":"string","message":"string","timestamp":123},"block":"$L4bc"}],"syncedPropertyName":"$undefined"}}},"headingAs":"h4"}] 3b1:"Retrieve terminal list" 4bf:T47c,List of event types that the webhook is configured to listen to. Each event is related to status changes of a specific object in the Merchant API: | Object | Event types | | --------- | ----------- | | `Order` |
  • `ORDER_COMPLETED`
  • `ORDER_AUTHORISED`
  • `ORDER_CANCELLED`
  • `ORDER_FAILED`
  • `ORDER_INCREMENTAL_AUTHORISATION_AUTHORISED`
  • `ORDER_INCREMENTAL_AUTHORISATION_DECLINED`
  • `ORDER_INCREMENTAL_AUTHORISATION_FAILED`
| | `Payment` |
  • `ORDER_PAYMENT_AUTHENTICATION_CHALLENGED`
  • `ORDER_PAYMENT_AUTHENTICATED`
  • `ORDER_PAYMENT_AUTHORISATION_STARTED`
  • `ORDER_PAYMENT_DECLINED`
  • `ORDER_PAYMENT_FAILED`
| | `Subscription` |
  • `SUBSCRIPTION_INITIATED`
  • `SUBSCRIPTION_FINISHED`
  • `SUBSCRIPTION_CANCELLED`
  • `SUBSCRIPTION_OVERDUE`
| | `Payout` |
  • `PAYOUT_INITIATED`
  • `PAYOUT_COMPLETED`
  • `PAYOUT_FAILED`
| | `Dispute` |
  • `DISPUTE_ACTION_REQUIRED`
  • `DISPUTE_UNDER_REVIEW`
  • `DISPUTE_WON`
  • `DISPUTE_LOST`
|4d2:T47c,List of event types that the webhook is configured to listen to. Each event is related to status changes of a specific object in the Merchant API: | Object | Event types | | --------- | ----------- | | `Order` |
  • `ORDER_COMPLETED`
  • `ORDER_AUTHORISED`
  • `ORDER_CANCELLED`
  • `ORDER_FAILED`
  • `ORDER_INCREMENTAL_AUTHORISATION_AUTHORISED`
  • `ORDER_INCREMENTAL_AUTHORISATION_DECLINED`
  • `ORDER_INCREMENTAL_AUTHORISATION_FAILED`
| | `Payment` |
  • `ORDER_PAYMENT_AUTHENTICATION_CHALLENGED`
  • `ORDER_PAYMENT_AUTHENTICATED`
  • `ORDER_PAYMENT_AUTHORISATION_STARTED`
  • `ORDER_PAYMENT_DECLINED`
  • `ORDER_PAYMENT_FAILED`
| | `Subscription` |
  • `SUBSCRIPTION_INITIATED`
  • `SUBSCRIPTION_FINISHED`
  • `SUBSCRIPTION_CANCELLED`
  • `SUBSCRIPTION_OVERDUE`
| | `Payout` |
  • `PAYOUT_INITIATED`
  • `PAYOUT_COMPLETED`
  • `PAYOUT_FAILED`
| | `Dispute` |
  • `DISPUTE_ACTION_REQUIRED`
  • `DISPUTE_UNDER_REVIEW`
  • `DISPUTE_WON`
  • `DISPUTE_LOST`
|5a:["$","$7a","update-webhook",{"children":[["$","section",null,{"className":"y9a0do0","data-variant":"endpoint","children":["$","$L7b",null,{"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"title":"Webhook","type":"object","description":"A webhook object.\n\nUnlike the legacy API, `signing_secret` is included in all webhook responses, not only on creation.","properties":{"id":{"type":"string","format":"uuid","description":"The ID of the webhook.","descriptionNode":"$L4bd"},"url":{"type":"string","format":"uri","pattern":"^https?:\\/{2}.+/gi","maxLength":2000,"description":"Your webhook's URL to which event notifications will be sent. \n\nMust be a valid HTTP or HTTPS URL, capable of receiving `POST` requests.\n\n:::warning\nRestrictions:\n- Must be a valid URI as defined by [RFC 3986](https://datatracker.ietf.org/doc/html/rfc3986)\n- URI scheme is required and must be either `http` or `https`\n- URI host is required and cannot be `localhost` or an IP address\n- Max length: `2000`\n- Reserved or invalid characters must be percent-encoded (for example, use `%20` instead of a space)\n:::","descriptionNode":"$L4be"},"events":{"type":"array","description":"$4bf","items":{"type":"string","description":"The available event types your can listen to.","enum":"$59:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:events:items:enum","descriptionNode":"$L4c0"},"minItems":1,"descriptionNode":"$L4c1"},"signing_secret":{"type":"string","description":"The signing secret for the webhook. Use it to verify the signature for the webhook request's payload.","descriptionNode":"$L4c2"}},"required":"$59:props:children:0:props:children:props:responses:200:content:application/json:schema:required","descriptionNode":"$L4c3"},"examples":{"updated_webhook":{"summary":"Webhook","value":"$59:props:children:0:props:children:props:responses:200:content:application/json:examples:retrieved_webhook:value"}}}},"descriptionNode":"$L4c4"},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"code":{"type":"string","description":"An identifier that can be used to determine what went wrong.\n\nError codes are not globally unique, but uniqueness is guaranteed within endpoints.","descriptionNode":"$L4c5"},"message":{"type":"string","description":"Some human readable text describing what went wrong.","descriptionNode":"$L4c6"},"timestamp":{"type":"integer","description":"The [UNIX timestamp](https://www.unixtimestamp.com/) of the date and time the error happened.","descriptionNode":"$L4c7"}}}}},"descriptionNode":"$L4c8"},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"code":{"type":"string","description":"An identifier that can be used to determine what went wrong.\n\nError codes are not globally unique, but uniqueness is guaranteed within endpoints.","descriptionNode":"$L4c9"},"message":{"type":"string","description":"Some human readable text describing what went wrong.","descriptionNode":"$L4ca"},"timestamp":{"type":"integer","description":"The [UNIX timestamp](https://www.unixtimestamp.com/) of the date and time the error happened.","descriptionNode":"$L4cb"}}}}},"descriptionNode":"$L4cc"},"404":{"description":"Not Found","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"code":{"type":"string","description":"An identifier that can be used to determine what went wrong.\n\nError codes are not globally unique, but uniqueness is guaranteed within endpoints.","descriptionNode":"$L4cd"},"message":{"type":"string","description":"Some human readable text describing what went wrong.","descriptionNode":"$L4ce"},"timestamp":{"type":"integer","description":"The [UNIX timestamp](https://www.unixtimestamp.com/) of the date and time the error happened.","descriptionNode":"$L4cf"}}}}},"descriptionNode":"$L4d0"}},"requestBody":{"content":{"application/json":{"schema":{"title":"Webhook update","type":"object","description":"The request body for updating a webhook.\n\nAll fields are optional. Only the fields provided in the request will be updated.","properties":{"url":{"type":"string","format":"uri","pattern":"^https?:\\/{2}.+/gi","maxLength":2000,"description":"Your webhook's URL to which event notifications will be sent. \n\nMust be a valid HTTP or HTTPS URL, capable of receiving `POST` requests.\n\n:::warning\nRestrictions:\n- Must be a valid URI as defined by [RFC 3986](https://datatracker.ietf.org/doc/html/rfc3986)\n- URI scheme is required and must be either `http` or `https`\n- URI host is required and cannot be `localhost` or an IP address\n- Max length: `2000`\n- Reserved or invalid characters must be percent-encoded (for example, use `%20` instead of a space)\n:::","descriptionNode":"$L4d1"},"events":{"type":"array","description":"$4d2","items":{"type":"string","description":"The available event types your can listen to.","enum":"$59:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:events:items:enum","descriptionNode":"$L4d3"},"minItems":1,"descriptionNode":"$L4d4"}},"descriptionNode":"$L4d5"},"examples":{"webhook_update_request":{"summary":"Update a webhook","value":{"url":"https://example.com/webhooks/updated","events":["ORDER_COMPLETED","ORDER_AUTHORISED","ORDER_CANCELLED"]}}}}}},"variantLabels":[],"children":["$L4d6","$L4d7"]}]}],false]}] 355:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The version of the Merchant API, specified in ",["$","code","code-0",{"children":"YYYY-MM-DD"}]," format."]}],"\n",["$","p","p-1",{"children":["This endpoint is available from version ",["$","code","code-0",{"children":"2024-09-01"}],". If a version earlier than ",["$","code","code-1",{"children":"2024-09-01"}]," is provided, the endpoint returns a ",["$","code","code-2",{"children":"404"}]," response."]}],"\n",["$","p","p-2",{"children":"If not specified, you will receive an error."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information about API versioning, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/reference/versioning/api-versions","target":"_blank","rel":"noreferrer","children":"API versions"}],"."]}]}]]}]]}] 356:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["Maximum number of records to return. Used for ",["$","strong","strong-0",{"children":"pagination"}],"."]}]]}] 357:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["Token for retrieving the next page of results. Used for ",["$","strong","strong-0",{"children":"pagination"}],"."]}],"\n",["$","p","p-1",{"children":"To paginate through results:"}],"\n",["$","ol","ol-0",{"children":["\n",["$","li","li-0",{"children":["Make an initial request with the desired ",["$","code","code-0",{"children":"limit"}],"."]}],"\n",["$","li","li-1",{"children":["The response will include a ",["$","code","code-0",{"children":"next_page_token"}]," if more results are available."]}],"\n",["$","li","li-2",{"children":["Use that token in the ",["$","code","code-0",{"children":"page_token"}]," parameter of your next request."]}],"\n",["$","li","li-3",{"children":["Repeat until ",["$","code","code-0",{"children":"next_page_token"}]," is not present."]}],"\n"]}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["When using ",["$","code","code-0",{"children":"page_token"}],", you must include all query parameters from the initial request (such as ",["$","code","code-1",{"children":"from"}],", ",["$","code","code-2",{"children":"to"}],", or other filter parameters) to maintain consistent filtering across pages."]}]}]]}]]}] 358:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["Filter records created from this date/time. Used for ",["$","strong","strong-0",{"children":"filtering"}],"."]}]]}] 359:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["Filter records created until this date/time. Used for ",["$","strong","strong-0",{"children":"filtering"}],"."]}]]}] 4d6:["$","div",null,{"className":"ezz1n30","children":[["$","div",null,{"data-header":"$undefined","className":"ezz1n31","children":["$","div",null,{"className":"y9a0do1","children":[["$","h2",null,{"id":"update-webhook","children":[["$L4d8","$undefined"],["$","$L15",null,{"id":"update-webhook"}]]}],["$","$L16",null,{"url":"/docs/api/merchant/2025-10-16/operations/update-webhook.md"}]]}]}],"$undefined"]}] 4de:T845,
curl -X PATCH "https://merchant.revolut.com/api/webhooks/__RP_TOK_0__" \
  -H "Content-Type: application/json" \
  -H "Authorization: __RP_TOK_1__" \
  -H "Revolut-Api-Version: __RP_TOK_2__" \
  -d '{
  "url": "https://example.com/webhooks/updated",
  "events": [
    "ORDER_COMPLETED",
    "ORDER_AUTHORISED",
    "ORDER_CANCELLED"
  ]
}'
4df:T116e,
const payload = {
  "url": "https://example.com/webhooks/updated",
  "events": [
    "ORDER_COMPLETED",
    "ORDER_AUTHORISED",
    "ORDER_CANCELLED"
  ]
};
fetch("https://merchant.revolut.com/api/webhooks/__RP_TOK_0__", {
  method: "PATCH",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "__RP_TOK_1__",
    "Revolut-Api-Version": "__RP_TOK_2__"
  },
  body: JSON.stringify(payload)
})
  .then(response => response.json())
  .then(data => console.log(data));
4e0:T182a,
package main

import (
  "fmt"
  "net/http"
  "bytes"
  "encoding/json"
)

func main() {
  url := "https://merchant.revolut.com/api/webhooks/__RP_TOK_0__"
  jsonData := []byte(`
{
  "url": "https://example.com/webhooks/updated",
  "events": [
    "ORDER_COMPLETED",
    "ORDER_AUTHORISED",
    "ORDER_CANCELLED"
  ]
}
  `)
  req, _ := http.NewRequest("PATCH", url, bytes.NewBuffer(jsonData))
  req.Header.Add("Content-Type", "application/json")
  req.Header.Add("Authorization", "__RP_TOK_1__")
  req.Header.Add("Revolut-Api-Version", "__RP_TOK_2__")

  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  fmt.Println(res)
}
4e1:Tea2,
import requests

url = "https://merchant.revolut.com/api/webhooks/__RP_TOK_0__"
headers = {
  "Content-Type": "application/json",
  "Authorization": "__RP_TOK_1__",
  "Revolut-Api-Version": "__RP_TOK_2__"
}
payload = {
  "url": "https://example.com/webhooks/updated",
  "events": [
    "ORDER_COMPLETED",
    "ORDER_AUTHORISED",
    "ORDER_CANCELLED"
  ]
}

response = requests.patch(url, headers=headers, json=payload)
print(response.json())
4e2:T1d8e,
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;

public class Main {
  public static void main(String[] args) {
    HttpClient client = HttpClient.newHttpClient();
    String body = """
{
  "url": "https://example.com/webhooks/updated",
  "events": [
    "ORDER_COMPLETED",
    "ORDER_AUTHORISED",
    "ORDER_CANCELLED"
  ]
}
    """;

    HttpRequest request = HttpRequest.newBuilder()
      .uri(URI.create("https://merchant.revolut.com/api/webhooks/__RP_TOK_0__"))
      .header("Content-Type", "application/json")
      .header("Authorization", "__RP_TOK_1__")
      .header("Revolut-Api-Version", "__RP_TOK_2__")
      .PATCH(HttpRequest.BodyPublishers.ofString(body))
      .build();

    client.sendAsync(request, HttpResponse.BodyHandlers.ofString())
      .thenApply(HttpResponse::body)
      .thenAccept(System.out::println)
      .join();
  }
}
4e3:T221e,
using System.Net.Http;
using System.Net.Http.Headers;

var client = new HttpClient();
var request = new HttpRequestMessage
{
  Method = HttpMethod.Patch,
  RequestUri = new Uri("https://merchant.revolut.com/api/webhooks/__RP_TOK_0__"),
  Headers =
  {
    { "Authorization", "__RP_TOK_1__" },
    { "Revolut-Api-Version", "__RP_TOK_2__" },
  },
  Content = new StringContent(@"{
  ""url"": ""https://example.com/webhooks/updated"",
  ""events"": [
    ""ORDER_COMPLETED"",
    ""ORDER_AUTHORISED"",
    ""ORDER_CANCELLED""
  ]
}")
  {
    Headers =
    {
      ContentType = new MediaTypeHeaderValue("application/json")
    }
  }
};

using (var response = await client.SendAsync(request))
{
  response.EnsureSuccessStatusCode();
  var body = await response.Content.ReadAsStringAsync();
  Console.WriteLine(body);
}
4e4:T84d,
curl -X PATCH "https://sandbox-merchant.revolut.com/api/webhooks/__RP_TOK_0__" \
  -H "Content-Type: application/json" \
  -H "Authorization: __RP_TOK_1__" \
  -H "Revolut-Api-Version: __RP_TOK_2__" \
  -d '{
  "url": "https://example.com/webhooks/updated",
  "events": [
    "ORDER_COMPLETED",
    "ORDER_AUTHORISED",
    "ORDER_CANCELLED"
  ]
}'
4e5:T1176,
const payload = {
  "url": "https://example.com/webhooks/updated",
  "events": [
    "ORDER_COMPLETED",
    "ORDER_AUTHORISED",
    "ORDER_CANCELLED"
  ]
};
fetch("https://sandbox-merchant.revolut.com/api/webhooks/__RP_TOK_0__", {
  method: "PATCH",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "__RP_TOK_1__",
    "Revolut-Api-Version": "__RP_TOK_2__"
  },
  body: JSON.stringify(payload)
})
  .then(response => response.json())
  .then(data => console.log(data));
4e6:T1832,
package main

import (
  "fmt"
  "net/http"
  "bytes"
  "encoding/json"
)

func main() {
  url := "https://sandbox-merchant.revolut.com/api/webhooks/__RP_TOK_0__"
  jsonData := []byte(`
{
  "url": "https://example.com/webhooks/updated",
  "events": [
    "ORDER_COMPLETED",
    "ORDER_AUTHORISED",
    "ORDER_CANCELLED"
  ]
}
  `)
  req, _ := http.NewRequest("PATCH", url, bytes.NewBuffer(jsonData))
  req.Header.Add("Content-Type", "application/json")
  req.Header.Add("Authorization", "__RP_TOK_1__")
  req.Header.Add("Revolut-Api-Version", "__RP_TOK_2__")

  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  fmt.Println(res)
}
4e7:Teaa,
import requests

url = "https://sandbox-merchant.revolut.com/api/webhooks/__RP_TOK_0__"
headers = {
  "Content-Type": "application/json",
  "Authorization": "__RP_TOK_1__",
  "Revolut-Api-Version": "__RP_TOK_2__"
}
payload = {
  "url": "https://example.com/webhooks/updated",
  "events": [
    "ORDER_COMPLETED",
    "ORDER_AUTHORISED",
    "ORDER_CANCELLED"
  ]
}

response = requests.patch(url, headers=headers, json=payload)
print(response.json())
4e8:T1d96,
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;

public class Main {
  public static void main(String[] args) {
    HttpClient client = HttpClient.newHttpClient();
    String body = """
{
  "url": "https://example.com/webhooks/updated",
  "events": [
    "ORDER_COMPLETED",
    "ORDER_AUTHORISED",
    "ORDER_CANCELLED"
  ]
}
    """;

    HttpRequest request = HttpRequest.newBuilder()
      .uri(URI.create("https://sandbox-merchant.revolut.com/api/webhooks/__RP_TOK_0__"))
      .header("Content-Type", "application/json")
      .header("Authorization", "__RP_TOK_1__")
      .header("Revolut-Api-Version", "__RP_TOK_2__")
      .PATCH(HttpRequest.BodyPublishers.ofString(body))
      .build();

    client.sendAsync(request, HttpResponse.BodyHandlers.ofString())
      .thenApply(HttpResponse::body)
      .thenAccept(System.out::println)
      .join();
  }
}
4e9:T2226,
using System.Net.Http;
using System.Net.Http.Headers;

var client = new HttpClient();
var request = new HttpRequestMessage
{
  Method = HttpMethod.Patch,
  RequestUri = new Uri("https://sandbox-merchant.revolut.com/api/webhooks/__RP_TOK_0__"),
  Headers =
  {
    { "Authorization", "__RP_TOK_1__" },
    { "Revolut-Api-Version", "__RP_TOK_2__" },
  },
  Content = new StringContent(@"{
  ""url"": ""https://example.com/webhooks/updated"",
  ""events"": [
    ""ORDER_COMPLETED"",
    ""ORDER_AUTHORISED"",
    ""ORDER_CANCELLED""
  ]
}")
  {
    Headers =
    {
      ContentType = new MediaTypeHeaderValue("application/json")
    }
  }
};

using (var response = await client.SendAsync(request))
{
  response.EnsureSuccessStatusCode();
  var body = await response.Content.ReadAsStringAsync();
  Console.WriteLine(body);
}
4d7:["$","div",null,{"className":"ezz1n30","children":[["$","div",null,{"data-header":"$undefined","className":"ezz1n31","children":["$L4d9",["$","$L85",null,{"parameters":[{"name":"Authorization","in":"header","schema":{"type":"string","format":"Bearer ","examples":"$62:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:0:schema:examples"},"required":true,"description":"This parameter accepts the [Merchant API Secret key](https://business.revolut.com/settings/apis?tab=merchant-api) to authorise requests coming from the merchant's backend. \n\nIt ensures that ensures that each request is authenticated and authorised by verifying the secret key. The secret key should be included in all request headers as a `Bearer` token.\n\n:::info\nFor more information, see: [Authentication](https://developer.revolut.com/docs/api/merchant#authentication)\n:::","descriptionNode":"$L4da"},{"name":"Revolut-Api-Version","in":"header","schema":{"type":"string","format":"date","enum":"$27:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:1:schema:enum","examples":"$27:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:1:schema:examples"},"required":true,"description":"The version of the Merchant API, specified in `YYYY-MM-DD` format.\n\nThis endpoint is available from version `2024-09-01`. If a version earlier than `2024-09-01` is provided, the endpoint returns a `404` response.\n\nIf not specified, you will receive an error.\n\n\n:::info\nFor more information about API versioning, see: [API versions](https://developer.revolut.com/docs/guides/merchant/reference/versioning/api-versions).\n:::","x-config-always-visible-in-example":true,"example":"2025-10-16","descriptionNode":"$L4db"},{"name":"webhook_id","in":"path","schema":{"type":"string","format":"uuid","description":"A UUID string, typically used to identify resources.","descriptionNode":"$L4dc"},"required":true,"description":"The ID of the webhook.","descriptionNode":"$L4dd"}],"requestBody":"$5a:props:children:0:props:children:props:requestBody","heading":"Request","requestBodySchemaTitle":"Request body","headingAs":"h3"}],["$","$L89",null,{"responses":"$5a:props:children:0:props:children:props:responses","headingAs":"h3"}]]}],["$","div",null,{"className":"ezz1n32","children":[[["$","$L8a",null,{"itemsByServer":{"https://merchant.revolut.com":[{"id":"curl","label":"cURL","templateCode":"curl -X PATCH \"https://merchant.revolut.com/api/webhooks/__RP_TOK_0__\" \\\n -H \"Content-Type: application/json\" \\\n -H \"Authorization: __RP_TOK_1__\" \\\n -H \"Revolut-Api-Version: __RP_TOK_2__\" \\\n -d '{\n \"url\": \"https://example.com/webhooks/updated\",\n \"events\": [\n \"ORDER_COMPLETED\",\n \"ORDER_AUTHORISED\",\n \"ORDER_CANCELLED\"\n ]\n}'","templateHtml":"$4de","tokens":[{"marker":"__RP_TOK_0__","paramName":"webhook_id","paramIn":"path","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["shell-double-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:webhook_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"javascript","label":"JavaScript","templateCode":"const payload = {\n \"url\": \"https://example.com/webhooks/updated\",\n \"events\": [\n \"ORDER_COMPLETED\",\n \"ORDER_AUTHORISED\",\n \"ORDER_CANCELLED\"\n ]\n};\nfetch(\"https://merchant.revolut.com/api/webhooks/__RP_TOK_0__\", {\n method: \"PATCH\",\n headers: {\n \"Content-Type\": \"application/json\",\n \"Authorization\": \"__RP_TOK_1__\",\n \"Revolut-Api-Version\": \"__RP_TOK_2__\"\n },\n body: JSON.stringify(payload)\n})\n .then(response => response.json())\n .then(data => console.log(data));","templateHtml":"$4df","tokens":[{"marker":"__RP_TOK_0__","paramName":"webhook_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:webhook_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"go","label":"Go","templateCode":"package main\n\nimport (\n \"fmt\"\n \"net/http\"\n \"bytes\"\n \"encoding/json\"\n)\n\nfunc main() {\n url := \"https://merchant.revolut.com/api/webhooks/__RP_TOK_0__\"\n jsonData := []byte(`\n{\n \"url\": \"https://example.com/webhooks/updated\",\n \"events\": [\n \"ORDER_COMPLETED\",\n \"ORDER_AUTHORISED\",\n \"ORDER_CANCELLED\"\n ]\n}\n `)\n req, _ := http.NewRequest(\"PATCH\", url, bytes.NewBuffer(jsonData))\n req.Header.Add(\"Content-Type\", \"application/json\")\n req.Header.Add(\"Authorization\", \"__RP_TOK_1__\")\n req.Header.Add(\"Revolut-Api-Version\", \"__RP_TOK_2__\")\n\n res, _ := http.DefaultClient.Do(req)\n defer res.Body.Close()\n fmt.Println(res)\n}","templateHtml":"$4e0","tokens":[{"marker":"__RP_TOK_0__","paramName":"webhook_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:webhook_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"python","label":"Python","templateCode":"import requests\n\nurl = \"https://merchant.revolut.com/api/webhooks/__RP_TOK_0__\"\nheaders = {\n \"Content-Type\": \"application/json\",\n \"Authorization\": \"__RP_TOK_1__\",\n \"Revolut-Api-Version\": \"__RP_TOK_2__\"\n}\npayload = {\n \"url\": \"https://example.com/webhooks/updated\",\n \"events\": [\n \"ORDER_COMPLETED\",\n \"ORDER_AUTHORISED\",\n \"ORDER_CANCELLED\"\n ]\n}\n\nresponse = requests.patch(url, headers=headers, json=payload)\nprint(response.json())","templateHtml":"$4e1","tokens":[{"marker":"__RP_TOK_0__","paramName":"webhook_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:webhook_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"java","label":"Java","templateCode":"import java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\nimport java.net.URI;\n\npublic class Main {\n public static void main(String[] args) {\n HttpClient client = HttpClient.newHttpClient();\n String body = \"\"\"\n{\n \"url\": \"https://example.com/webhooks/updated\",\n \"events\": [\n \"ORDER_COMPLETED\",\n \"ORDER_AUTHORISED\",\n \"ORDER_CANCELLED\"\n ]\n}\n \"\"\";\n\n HttpRequest request = HttpRequest.newBuilder()\n .uri(URI.create(\"https://merchant.revolut.com/api/webhooks/__RP_TOK_0__\"))\n .header(\"Content-Type\", \"application/json\")\n .header(\"Authorization\", \"__RP_TOK_1__\")\n .header(\"Revolut-Api-Version\", \"__RP_TOK_2__\")\n .PATCH(HttpRequest.BodyPublishers.ofString(body))\n .build();\n\n client.sendAsync(request, HttpResponse.BodyHandlers.ofString())\n .thenApply(HttpResponse::body)\n .thenAccept(System.out::println)\n .join();\n }\n}","templateHtml":"$4e2","tokens":[{"marker":"__RP_TOK_0__","paramName":"webhook_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:webhook_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"csharp","label":"C#","templateCode":"using System.Net.Http;\nusing System.Net.Http.Headers;\n\nvar client = new HttpClient();\nvar request = new HttpRequestMessage\n{\n Method = HttpMethod.Patch,\n RequestUri = new Uri(\"https://merchant.revolut.com/api/webhooks/__RP_TOK_0__\"),\n Headers =\n {\n { \"Authorization\", \"__RP_TOK_1__\" },\n { \"Revolut-Api-Version\", \"__RP_TOK_2__\" },\n },\n Content = new StringContent(@\"{\n \"\"url\"\": \"\"https://example.com/webhooks/updated\"\",\n \"\"events\"\": [\n \"\"ORDER_COMPLETED\"\",\n \"\"ORDER_AUTHORISED\"\",\n \"\"ORDER_CANCELLED\"\"\n ]\n}\")\n {\n Headers =\n {\n ContentType = new MediaTypeHeaderValue(\"application/json\")\n }\n }\n};\n\nusing (var response = await client.SendAsync(request))\n{\n response.EnsureSuccessStatusCode();\n var body = await response.Content.ReadAsStringAsync();\n Console.WriteLine(body);\n}","templateHtml":"$4e3","tokens":[{"marker":"__RP_TOK_0__","paramName":"webhook_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:webhook_id":"123e4567-e89b-12d3-a456-426614174000"}}],"https://sandbox-merchant.revolut.com":[{"id":"curl","label":"cURL","templateCode":"curl -X PATCH \"https://sandbox-merchant.revolut.com/api/webhooks/__RP_TOK_0__\" \\\n -H \"Content-Type: application/json\" \\\n -H \"Authorization: __RP_TOK_1__\" \\\n -H \"Revolut-Api-Version: __RP_TOK_2__\" \\\n -d '{\n \"url\": \"https://example.com/webhooks/updated\",\n \"events\": [\n \"ORDER_COMPLETED\",\n \"ORDER_AUTHORISED\",\n \"ORDER_CANCELLED\"\n ]\n}'","templateHtml":"$4e4","tokens":[{"marker":"__RP_TOK_0__","paramName":"webhook_id","paramIn":"path","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["shell-double-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:webhook_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"javascript","label":"JavaScript","templateCode":"const payload = {\n \"url\": \"https://example.com/webhooks/updated\",\n \"events\": [\n \"ORDER_COMPLETED\",\n \"ORDER_AUTHORISED\",\n \"ORDER_CANCELLED\"\n ]\n};\nfetch(\"https://sandbox-merchant.revolut.com/api/webhooks/__RP_TOK_0__\", {\n method: \"PATCH\",\n headers: {\n \"Content-Type\": \"application/json\",\n \"Authorization\": \"__RP_TOK_1__\",\n \"Revolut-Api-Version\": \"__RP_TOK_2__\"\n },\n body: JSON.stringify(payload)\n})\n .then(response => response.json())\n .then(data => console.log(data));","templateHtml":"$4e5","tokens":[{"marker":"__RP_TOK_0__","paramName":"webhook_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:webhook_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"go","label":"Go","templateCode":"package main\n\nimport (\n \"fmt\"\n \"net/http\"\n \"bytes\"\n \"encoding/json\"\n)\n\nfunc main() {\n url := \"https://sandbox-merchant.revolut.com/api/webhooks/__RP_TOK_0__\"\n jsonData := []byte(`\n{\n \"url\": \"https://example.com/webhooks/updated\",\n \"events\": [\n \"ORDER_COMPLETED\",\n \"ORDER_AUTHORISED\",\n \"ORDER_CANCELLED\"\n ]\n}\n `)\n req, _ := http.NewRequest(\"PATCH\", url, bytes.NewBuffer(jsonData))\n req.Header.Add(\"Content-Type\", \"application/json\")\n req.Header.Add(\"Authorization\", \"__RP_TOK_1__\")\n req.Header.Add(\"Revolut-Api-Version\", \"__RP_TOK_2__\")\n\n res, _ := http.DefaultClient.Do(req)\n defer res.Body.Close()\n fmt.Println(res)\n}","templateHtml":"$4e6","tokens":[{"marker":"__RP_TOK_0__","paramName":"webhook_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:webhook_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"python","label":"Python","templateCode":"import requests\n\nurl = \"https://sandbox-merchant.revolut.com/api/webhooks/__RP_TOK_0__\"\nheaders = {\n \"Content-Type\": \"application/json\",\n \"Authorization\": \"__RP_TOK_1__\",\n \"Revolut-Api-Version\": \"__RP_TOK_2__\"\n}\npayload = {\n \"url\": \"https://example.com/webhooks/updated\",\n \"events\": [\n \"ORDER_COMPLETED\",\n \"ORDER_AUTHORISED\",\n \"ORDER_CANCELLED\"\n ]\n}\n\nresponse = requests.patch(url, headers=headers, json=payload)\nprint(response.json())","templateHtml":"$4e7","tokens":[{"marker":"__RP_TOK_0__","paramName":"webhook_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:webhook_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"java","label":"Java","templateCode":"import java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\nimport java.net.URI;\n\npublic class Main {\n public static void main(String[] args) {\n HttpClient client = HttpClient.newHttpClient();\n String body = \"\"\"\n{\n \"url\": \"https://example.com/webhooks/updated\",\n \"events\": [\n \"ORDER_COMPLETED\",\n \"ORDER_AUTHORISED\",\n \"ORDER_CANCELLED\"\n ]\n}\n \"\"\";\n\n HttpRequest request = HttpRequest.newBuilder()\n .uri(URI.create(\"https://sandbox-merchant.revolut.com/api/webhooks/__RP_TOK_0__\"))\n .header(\"Content-Type\", \"application/json\")\n .header(\"Authorization\", \"__RP_TOK_1__\")\n .header(\"Revolut-Api-Version\", \"__RP_TOK_2__\")\n .PATCH(HttpRequest.BodyPublishers.ofString(body))\n .build();\n\n client.sendAsync(request, HttpResponse.BodyHandlers.ofString())\n .thenApply(HttpResponse::body)\n .thenAccept(System.out::println)\n .join();\n }\n}","templateHtml":"$4e8","tokens":[{"marker":"__RP_TOK_0__","paramName":"webhook_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:webhook_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"csharp","label":"C#","templateCode":"using System.Net.Http;\nusing System.Net.Http.Headers;\n\nvar client = new HttpClient();\nvar request = new HttpRequestMessage\n{\n Method = HttpMethod.Patch,\n RequestUri = new Uri(\"https://sandbox-merchant.revolut.com/api/webhooks/__RP_TOK_0__\"),\n Headers =\n {\n { \"Authorization\", \"__RP_TOK_1__\" },\n { \"Revolut-Api-Version\", \"__RP_TOK_2__\" },\n },\n Content = new StringContent(@\"{\n \"\"url\"\": \"\"https://example.com/webhooks/updated\"\",\n \"\"events\"\": [\n \"\"ORDER_COMPLETED\"\",\n \"\"ORDER_AUTHORISED\"\",\n \"\"ORDER_CANCELLED\"\"\n ]\n}\")\n {\n Headers =\n {\n ContentType = new MediaTypeHeaderValue(\"application/json\")\n }\n }\n};\n\nusing (var response = await client.SendAsync(request))\n{\n response.EnsureSuccessStatusCode();\n var body = await response.Content.ReadAsStringAsync();\n Console.WriteLine(body);\n}","templateHtml":"$4e9","tokens":[{"marker":"__RP_TOK_0__","paramName":"webhook_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:webhook_id":"123e4567-e89b-12d3-a456-426614174000"}}]},"method":"patch","servers":"$62:props:children:0:props:children:props:children:1:props:children:1:props:children:0:0:props:servers","path":"/api/webhooks/{webhook_id}","parameters":["$4d7:props:children:0:props:children:1:props:parameters:0","$4d7:props:children:0:props:children:1:props:parameters:1","$4d7:props:children:0:props:children:1:props:parameters:2"]}],"$L4ea"],"$L4eb","$L4ec"]}]]}] 421:"Retrieve a payment intent" 434:"Cancel a payment intent" 447:"Change a subscription plan" 36c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The ID of the webhook."}]]}] 36d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Your webhook's URL to which event notifications will be sent."}],"\n",["$","p","p-1",{"children":["Must be a valid HTTP or HTTPS URL, capable of receiving ",["$","code","code-0",{"children":"POST"}]," requests."]}],"\n",["$","div","inlinealert-0",{"data-type":"warning","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMark","color":"var(--rui-color-warning)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"Restrictions:"}],["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["Must be a valid URI as defined by ",["$","a","a-0",{"href":"https://datatracker.ietf.org/doc/html/rfc3986","target":"_blank","rel":"noreferrer","children":"RFC 3986"}]]}],"\n",["$","li","li-1",{"children":["URI scheme is required and must be either ",["$","code","code-0",{"children":"http"}]," or ",["$","code","code-1",{"children":"https"}]]}],"\n",["$","li","li-2",{"children":["URI host is required and cannot be ",["$","code","code-0",{"children":"localhost"}]," or an IP address"]}],"\n",["$","li","li-3",{"children":["Max length: ",["$","code","code-0",{"children":"2000"}]]}],"\n",["$","li","li-4",{"children":["Reserved or invalid characters must be percent-encoded (for example, use ",["$","code","code-0",{"children":"%20"}]," instead of a space)"]}],"\n"]}]]}]]}]]}] 36f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The available event types your can listen to."}]]}] 370:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"List of event types that the webhook is configured to listen to."}],"\n",["$","p","p-1",{"children":"Each event is related to status changes of a specific object in the Merchant API:"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Object","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Event types","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"Order"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["$","ul","ul-0",{"children":[" ",["$","li","li-0",{"children":["$","code","code-0",{"children":"ORDER_COMPLETED"}]}]," ",["$","li","li-1",{"children":["$","code","code-0",{"children":"ORDER_AUTHORISED"}]}]," ",["$","li","li-2",{"children":["$","code","code-0",{"children":"ORDER_CANCELLED"}]}]," ",["$","li","li-3",{"children":["$","code","code-0",{"children":"ORDER_FAILED"}]}]," ",["$","li","li-4",{"children":["$","code","code-0",{"children":"ORDER_INCREMENTAL_AUTHORISATION_AUTHORISED"}]}]," ",["$","li","li-5",{"children":["$","code","code-0",{"children":"ORDER_INCREMENTAL_AUTHORISATION_DECLINED"}]}]," ",["$","li","li-6",{"children":["$","code","code-0",{"children":"ORDER_INCREMENTAL_AUTHORISATION_FAILED"}]}]," "]}],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"Payment"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["$","ul","ul-0",{"children":[" ",["$","li","li-0",{"children":["$","code","code-0",{"children":"ORDER_PAYMENT_AUTHENTICATION_CHALLENGED"}]}]," ",["$","li","li-1",{"children":["$","code","code-0",{"children":"ORDER_PAYMENT_AUTHENTICATED"}]}]," ",["$","li","li-2",{"children":["$","code","code-0",{"children":"ORDER_PAYMENT_AUTHORISATION_STARTED"}]}]," ",["$","li","li-3",{"children":["$","code","code-0",{"children":"ORDER_PAYMENT_DECLINED"}]}]," ",["$","li","li-4",{"children":["$","code","code-0",{"children":"ORDER_PAYMENT_FAILED"}]}]," "]}],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"Subscription"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["$","ul","ul-0",{"children":[" ",["$","li","li-0",{"children":["$","code","code-0",{"children":"SUBSCRIPTION_INITIATED"}]}]," ",["$","li","li-1",{"children":["$","code","code-0",{"children":"SUBSCRIPTION_FINISHED"}]}]," ",["$","li","li-2",{"children":["$","code","code-0",{"children":"SUBSCRIPTION_CANCELLED"}]}]," ",["$","li","li-3",{"children":["$","code","code-0",{"children":"SUBSCRIPTION_OVERDUE"}]}]]}],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"Payout"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["$","ul","ul-0",{"children":[" ",["$","li","li-0",{"children":["$","code","code-0",{"children":"PAYOUT_INITIATED"}]}]," ",["$","li","li-1",{"children":["$","code","code-0",{"children":"PAYOUT_COMPLETED"}]}]," ",["$","li","li-2",{"children":["$","code","code-0",{"children":"PAYOUT_FAILED"}]}]," "]}],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-4",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"Dispute"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["$","ul","ul-0",{"children":[" ",["$","li","li-0",{"children":["$","code","code-0",{"children":"DISPUTE_ACTION_REQUIRED"}]}]," ",["$","li","li-1",{"children":["$","code","code-0",{"children":"DISPUTE_UNDER_REVIEW"}]}]," ",["$","li","li-2",{"children":["$","code","code-0",{"children":"DISPUTE_WON"}]}]," ",["$","li","li-3",{"children":["$","code","code-0",{"children":"DISPUTE_LOST"}]}]]}],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 371:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The signing secret for the webhook. Use it to verify the signature for the webhook request's payload."}]]}] 372:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A webhook object."}],"\n",["$","p","p-1",{"children":["Unlike the legacy API, ",["$","code","code-0",{"children":"signing_secret"}]," is included in all webhook responses, not only on creation."]}]]}] 373:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"OK"}]]}] 374:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An identifier that can be used to determine what went wrong."}],"\n",["$","p","p-1",{"children":"Error codes are not globally unique, but uniqueness is guaranteed within endpoints."}]]}] 375:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Some human readable text describing what went wrong."}]]}] 376:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://www.unixtimestamp.com/","target":"_blank","rel":"noreferrer","children":"UNIX timestamp"}]," of the date and time the error happened."]}]]}] 377:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Bad Request"}]]}] 1de:["$","div","CodeBlock-0",{"className":"wzy01m0 _18b50nc0","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"
'Authorization: Bearer <yourSecretApiKey>'
"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"'Authorization: Bearer '\n"}]}]]}] 1df:["$","div","CodeBlock-0",{"className":"wzy01m0 _18b50nc0","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"
'Authorization: Bearer <yourSecretApiKey>'
"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"'Authorization: Bearer '\n"}]}]]}] 1e0:["$","div","CodeBlock-0",{"className":"wzy01m0 _18b50nc0","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"
'Authorization: Bearer <yourSecretApiKey>'
"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"'Authorization: Bearer '\n"}]}]]}] 6d:["$","$7a","register-address-validation-endpoint",{"children":[["$","section",null,{"className":"y9a0do0","data-variant":"endpoint","children":["$","$L7b",null,{"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"title":"SynchronousWebhook","type":"object","properties":{"id":{"type":"string","format":"uuid","description":"The ID of the synchronous webhook object.","descriptionNode":"$L4ed"},"signing_key":{"type":"string","pattern":"^swsk_[a-zA-Z0-9]{32}$","description":"A randomly generated signing key, which can be used by merchants to authenticate requests from Revolut by verifying the signature. For more information, see: [Payload Signature](https://developer.revolut.com/docs/api/merchant#authentication).","descriptionNode":"$L4ee"},"url":{"type":"string","format":"uri","pattern":"^https:\\/{2}.+/gi","maxLength":2000,"description":"The valid URL of the endpoint, that uses HTTPS URL schema. Revolut sends the shipping address of the customer to this URL for validation.\n\n:::warning\nRestrictions:\n- Must be a valid URI as defined by [RFC 3986](https://datatracker.ietf.org/doc/html/rfc3986)\n- URI scheme is required and must be `https`\n- URI host is required and cannot be `localhost` or an IP address\n- Max length: `2000`\n- Reserved or invalid characters must be percent-encoded (for example, use `%20` instead of a space)\n:::","descriptionNode":"$L4ef"},"event_type":{"type":"string","enum":"$6e:props:children:0:props:children:props:responses:200:content:application/json:schema:items:properties:event_type:enum","description":"Type of event this synchronous webhook is configured for.\n\n:::note\nAt the moment, synchronous webhooks only support address validation events. \n:::","descriptionNode":"$L4f0"},"location_id":{"type":"string","format":"uuid","description":"Unique ID representing the location where merchants sells products.\n\n:::info\nFor more information, see: [Locations](https://developer.revolut.com/docs/api/merchant#tag-locations).\n::: ","descriptionNode":"$L4f1"}},"required":"$6e:props:children:0:props:children:props:responses:200:content:application/json:schema:items:required"},"examples":{"example_without_location":{"summary":"Synchronous webhook response","value":{"id":"f6abc4df-eb48-417c-8e75-f7c6d7ad394f","signing_key":"swsk_y5z3LEHYZ9ndote3qegzWD6uL4t1lfp1","url":"https://backend.example.com/webhooks/validate-address","event_type":"fast_checkout.validate_address"}},"example_with_location":{"summary":"Synchronous webhook response with location ID","value":{"id":"f6abc4df-eb48-417c-8e75-f7c6d7ad394f","signing_key":"swsk_y5z3LEHYZ9ndote3qegzWD6uL4t1lfp1","url":"https://backend.example.com/webhooks/validate-address","event_type":"fast_checkout.validate_address","location_id":"b0ebede4-5cbc-4951-977f-70329faa8769"}}}}},"descriptionNode":"$L4f2"},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"errorId":{"type":"string","description":"The ID of the error. You can share this ID with Revolut support for troubleshooting.","descriptionNode":"$L4f3"},"timestamp":{"type":"integer","description":"The date and time the error happened.","descriptionNode":"$L4f4"}},"required":"$62:props:children:0:props:children:props:responses:401:content:application/json:schema:required"}}},"descriptionNode":"$L4f5"},"401":{"description":"Unauthorized","descriptionNode":"$L4f6"}},"requestBody":{"content":{"application/json":{"schema":{"title":"SynchronousWebhookCreation","type":"object","description":"The `SynchronousWebhook` object allows merchants to register endpoints on their backend for receiving predefined event types. Currently, only address validation events are available.\n\nIn addition, merchants can specify locations representing their online stores, enabling them to set up different webhooks for different stores.","properties":{"event_type":{"type":"string","enum":["fast_checkout.validate_address"],"description":"Type of event this synchronous webhook is configured for.\n\n:::note\nAt the moment, synchronous webhooks only support address validation events. \n:::","descriptionNode":"$L4f7"},"url":{"type":"string","format":"uri","pattern":"^https:\\/{2}.+/gi","maxLength":2000,"description":"The valid URL of the endpoint, that uses HTTPS URL schema. Revolut sends the shipping address of the customer to this URL for validation.\n\n:::warning\nRestrictions:\n- Must be a valid URI as defined by [RFC 3986](https://datatracker.ietf.org/doc/html/rfc3986)\n- URI scheme is required and must be `https`\n- URI host is required and cannot be `localhost` or an IP address\n- Max length: `2000`\n- Reserved or invalid characters must be percent-encoded (for example, use `%20` instead of a space)\n:::","descriptionNode":"$L4f8"},"location_id":{"type":"string","format":"uuid","description":"Unique ID representing the location where merchants sells products.\n\n:::info\nFor more information, see: [Locations](https://developer.revolut.com/docs/api/merchant#tag-locations).\n::: ","descriptionNode":"$L4f9"}},"required":["event_type","url"],"descriptionNode":"$L4fa"},"examples":{"create_webhook":{"summary":"Create synchronous webhook","value":{"event_type":"fast_checkout.validate_address","url":"https://backend.example.com/webhooks/validate-address"}},"create_webhook_with_location_id":{"summary":"Create synchronous webhook with location ID","value":{"event_type":"fast_checkout.validate_address","url":"https://backend.example.com/webhooks/validate-address","location_id":"8d9a7125-805f-40f3-a405-bc89765db996"}}}}}},"variantLabels":["Synchronous webhook response","Synchronous webhook response with location ID"],"children":["$L4fb","$L4fc"]}]}],false]}] 386:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Each Merchant API request must contain an authorization header in the following format:"}],"\n","$L4fd","\n",["$","p","p-1",{"children":"To use this API, you need to generate API keys from your Revolut Business account. The Secret key is used in the authorization header for all server calls, while the Public key is provided with payment methods at checkout."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For detailed instructions on generating your API keys, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/get-started#generate-api-keys","target":"_blank","rel":"noreferrer","children":"Generate API keys"}],"."]}]}]]}]]}] 378:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An identifier that can be used to determine what went wrong."}],"\n",["$","p","p-1",{"children":"Error codes are not globally unique, but uniqueness is guaranteed within endpoints."}]]}] 379:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Some human readable text describing what went wrong."}]]}] 37a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://www.unixtimestamp.com/","target":"_blank","rel":"noreferrer","children":"UNIX timestamp"}]," of the date and time the error happened."]}]]}] 37b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unauthorized"}]]}] 37c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An identifier that can be used to determine what went wrong."}],"\n",["$","p","p-1",{"children":"Error codes are not globally unique, but uniqueness is guaranteed within endpoints."}]]}] 37d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Some human readable text describing what went wrong."}]]}] 37e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://www.unixtimestamp.com/","target":"_blank","rel":"noreferrer","children":"UNIX timestamp"}]," of the date and time the error happened."]}]]}] 37f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Not Found"}]]}] 380:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The expiration period of the signing secret in the ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_8601#Durations","target":"_blank","rel":"noreferrer","children":"ISO 8601 format"}],"."]}],"\n",["$","p","p-1",{"children":"If defined, when the signing secret is rotated, it continues to be valid until the expiration period passes."}],"\n",["$","p","p-2",{"children":"Otherwise, it is invalidated immediately."}],"\n",["$","p","p-3",{"children":"Maximum expiration period is 7 days."}]]}] 38a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["Rotate the ",["$","code","code-0",{"children":"signing_secret"}]," for a specific webhook."]}],"\n",["$","p","p-1",{"children":"The updated signing secret is returned in the response as part of the full webhook object."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information, see ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/monitor-and-observe/webhooks/verify-the-payload-signature","target":"_blank","rel":"noreferrer","children":"Tutorials: Verify the payload signature"}],"."]}]}]]}]]}] 38b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["This parameter accepts the ",["$","a","a-0",{"href":"https://business.revolut.com/settings/apis?tab=merchant-api","target":"_blank","rel":"noreferrer","children":"Merchant API Secret key"}]," to authorise requests coming from the merchant's backend."]}],"\n",["$","p","p-1",{"children":["It ensures that ensures that each request is authenticated and authorised by verifying the secret key. The secret key should be included in all request headers as a ",["$","code","code-0",{"children":"Bearer"}]," token."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#authentication","target":"_blank","rel":"noreferrer","children":"Authentication"}]]}]}]]}]]}] 38c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The version of the Merchant API, specified in ",["$","code","code-0",{"children":"YYYY-MM-DD"}]," format."]}],"\n",["$","p","p-1",{"children":["This endpoint is available from version ",["$","code","code-0",{"children":"2024-09-01"}],". If a version earlier than ",["$","code","code-1",{"children":"2024-09-01"}]," is provided, the endpoint returns a ",["$","code","code-2",{"children":"404"}]," response."]}],"\n",["$","p","p-2",{"children":"If not specified, you will receive an error."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information about API versioning, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/reference/versioning/api-versions","target":"_blank","rel":"noreferrer","children":"API versions"}],"."]}]}]]}]]}] 38d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A UUID string, typically used to identify resources."}]]}] 38e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The ID of the webhook."}]]}] 49f:"Challenge a dispute" 4ea:["$","$L10d",null,{"security":[{"Api-Key":[]}],"authorization":{"Api-Key":{"type":"apiKey","in":"header","name":"Authorization","description":"Each Merchant API request must contain an authorization header in the following format:\n\n```\n'Authorization: Bearer '\n```\n\nTo use this API, you need to generate API keys from your Revolut Business account. The Secret key is used in the authorization header for all server calls, while the Public key is provided with payment methods at checkout.\n\n:::info\nFor detailed instructions on generating your API keys, see: [Generate API keys](https://developer.revolut.com/docs/guides/merchant/get-started#generate-api-keys).\n:::","descriptionNode":"$L4fe"}}}] 4eb:["$","$L10f",null,{"exampleBlocks":{"application/json":{"variants":[{"key":"webhook_update_request","label":"Update a webhook","rawValue":"$5a:props:children:0:props:children:props:requestBody:content:application/json:examples:webhook_update_request:value","block":"$L4ff"}],"syncedPropertyName":"$undefined"}},"title":"Request body samples","headingAs":"h4"}] 4ec:["$","$L110",null,{"exampleBlocks":{"200":{"application/json":{"variants":[{"key":"updated_webhook","label":"Webhook","rawValue":"$59:props:children:0:props:children:props:responses:200:content:application/json:examples:retrieved_webhook:value","block":"$L500"}],"syncedPropertyName":"$undefined"}},"400":{"application/json":{"variants":[{"key":"default","label":"Example","rawValue":{"code":"string","message":"string","timestamp":123},"block":"$L501"}],"syncedPropertyName":"$undefined"}},"401":{"application/json":{"variants":[{"key":"default","label":"Example","rawValue":{"code":"string","message":"string","timestamp":123},"block":"$L502"}],"syncedPropertyName":"$undefined"}},"404":{"application/json":{"variants":[{"key":"default","label":"Example","rawValue":{"code":"string","message":"string","timestamp":123},"block":"$L503"}],"syncedPropertyName":"$undefined"}}},"headingAs":"h4"}] 4fb:["$","div",null,{"className":"ezz1n30","children":[["$","div",null,{"data-header":"$undefined","className":"ezz1n31","children":["$","div",null,{"className":"y9a0do1","children":[["$","h2",null,{"id":"register-address-validation-endpoint","children":[["$L504","$undefined"],["$","$L15",null,{"id":"register-address-validation-endpoint"}]]}],["$","$L16",null,{"url":"/docs/api/merchant/2025-10-16/operations/register-address-validation-endpoint.md"}]]}]}],"$undefined"]}] 507:T5f9,
curl -X POST "https://merchant.revolut.com/api/synchronous-webhooks" \
  -H "Content-Type: application/json" \
  -H "Authorization: __RP_TOK_0__" \
  -d '{
  "event_type": "fast_checkout.validate_address",
  "url": "https://backend.example.com/webhooks/validate-address"
}'
508:Teb2,
const payload = {
  "event_type": "fast_checkout.validate_address",
  "url": "https://backend.example.com/webhooks/validate-address"
};
fetch("https://merchant.revolut.com/api/synchronous-webhooks", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "__RP_TOK_0__"
  },
  body: JSON.stringify(payload)
})
  .then(response => response.json())
  .then(data => console.log(data));
509:T14f1,
package main

import (
  "fmt"
  "net/http"
  "bytes"
  "encoding/json"
)

func main() {
  url := "https://merchant.revolut.com/api/synchronous-webhooks"
  jsonData := []byte(`
{
  "event_type": "fast_checkout.validate_address",
  "url": "https://backend.example.com/webhooks/validate-address"
}
  `)
  req, _ := http.NewRequest("POST", url, bytes.NewBuffer(jsonData))
  req.Header.Add("Content-Type", "application/json")
  req.Header.Add("Authorization", "__RP_TOK_0__")

  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  fmt.Println(res)
}
50a:Tbe8,
import requests

url = "https://merchant.revolut.com/api/synchronous-webhooks"
headers = {
  "Content-Type": "application/json",
  "Authorization": "__RP_TOK_0__"
}
payload = {
  "event_type": "fast_checkout.validate_address",
  "url": "https://backend.example.com/webhooks/validate-address"
}

response = requests.post(url, headers=headers, json=payload)
print(response.json())
50b:T1a58,
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;

public class Main {
  public static void main(String[] args) {
    HttpClient client = HttpClient.newHttpClient();
    String body = """
{
  "event_type": "fast_checkout.validate_address",
  "url": "https://backend.example.com/webhooks/validate-address"
}
    """;

    HttpRequest request = HttpRequest.newBuilder()
      .uri(URI.create("https://merchant.revolut.com/api/synchronous-webhooks"))
      .header("Content-Type", "application/json")
      .header("Authorization", "__RP_TOK_0__")
      .POST(HttpRequest.BodyPublishers.ofString(body))
      .build();

    client.sendAsync(request, HttpResponse.BodyHandlers.ofString())
      .thenApply(HttpResponse::body)
      .thenAccept(System.out::println)
      .join();
  }
}
50c:T1e42,
using System.Net.Http;
using System.Net.Http.Headers;

var client = new HttpClient();
var request = new HttpRequestMessage
{
  Method = HttpMethod.Post,
  RequestUri = new Uri("https://merchant.revolut.com/api/synchronous-webhooks"),
  Headers =
  {
    { "Authorization", "__RP_TOK_0__" },
  },
  Content = new StringContent(@"{
  ""event_type"": ""fast_checkout.validate_address"",
  ""url"": ""https://backend.example.com/webhooks/validate-address""
}")
  {
    Headers =
    {
      ContentType = new MediaTypeHeaderValue("application/json")
    }
  }
};

using (var response = await client.SendAsync(request))
{
  response.EnsureSuccessStatusCode();
  var body = await response.Content.ReadAsStringAsync();
  Console.WriteLine(body);
}
50d:T601,
curl -X POST "https://sandbox-merchant.revolut.com/api/synchronous-webhooks" \
  -H "Content-Type: application/json" \
  -H "Authorization: __RP_TOK_0__" \
  -d '{
  "event_type": "fast_checkout.validate_address",
  "url": "https://backend.example.com/webhooks/validate-address"
}'
50e:Teba,
const payload = {
  "event_type": "fast_checkout.validate_address",
  "url": "https://backend.example.com/webhooks/validate-address"
};
fetch("https://sandbox-merchant.revolut.com/api/synchronous-webhooks", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "__RP_TOK_0__"
  },
  body: JSON.stringify(payload)
})
  .then(response => response.json())
  .then(data => console.log(data));
50f:T14f9,
package main

import (
  "fmt"
  "net/http"
  "bytes"
  "encoding/json"
)

func main() {
  url := "https://sandbox-merchant.revolut.com/api/synchronous-webhooks"
  jsonData := []byte(`
{
  "event_type": "fast_checkout.validate_address",
  "url": "https://backend.example.com/webhooks/validate-address"
}
  `)
  req, _ := http.NewRequest("POST", url, bytes.NewBuffer(jsonData))
  req.Header.Add("Content-Type", "application/json")
  req.Header.Add("Authorization", "__RP_TOK_0__")

  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  fmt.Println(res)
}
510:Tbf0,
import requests

url = "https://sandbox-merchant.revolut.com/api/synchronous-webhooks"
headers = {
  "Content-Type": "application/json",
  "Authorization": "__RP_TOK_0__"
}
payload = {
  "event_type": "fast_checkout.validate_address",
  "url": "https://backend.example.com/webhooks/validate-address"
}

response = requests.post(url, headers=headers, json=payload)
print(response.json())
511:T1a60,
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;

public class Main {
  public static void main(String[] args) {
    HttpClient client = HttpClient.newHttpClient();
    String body = """
{
  "event_type": "fast_checkout.validate_address",
  "url": "https://backend.example.com/webhooks/validate-address"
}
    """;

    HttpRequest request = HttpRequest.newBuilder()
      .uri(URI.create("https://sandbox-merchant.revolut.com/api/synchronous-webhooks"))
      .header("Content-Type", "application/json")
      .header("Authorization", "__RP_TOK_0__")
      .POST(HttpRequest.BodyPublishers.ofString(body))
      .build();

    client.sendAsync(request, HttpResponse.BodyHandlers.ofString())
      .thenApply(HttpResponse::body)
      .thenAccept(System.out::println)
      .join();
  }
}
512:T1e4a,
using System.Net.Http;
using System.Net.Http.Headers;

var client = new HttpClient();
var request = new HttpRequestMessage
{
  Method = HttpMethod.Post,
  RequestUri = new Uri("https://sandbox-merchant.revolut.com/api/synchronous-webhooks"),
  Headers =
  {
    { "Authorization", "__RP_TOK_0__" },
  },
  Content = new StringContent(@"{
  ""event_type"": ""fast_checkout.validate_address"",
  ""url"": ""https://backend.example.com/webhooks/validate-address""
}")
  {
    Headers =
    {
      ContentType = new MediaTypeHeaderValue("application/json")
    }
  }
};

using (var response = await client.SendAsync(request))
{
  response.EnsureSuccessStatusCode();
  var body = await response.Content.ReadAsStringAsync();
  Console.WriteLine(body);
}
4fc:["$","div",null,{"className":"ezz1n30","children":[["$","div",null,{"data-header":"$undefined","className":"ezz1n31","children":["$L505",["$","$L85",null,{"parameters":[{"name":"Authorization","in":"header","schema":{"type":"string","format":"Bearer ","examples":"$62:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:0:schema:examples"},"required":true,"description":"This parameter accepts the [Merchant API Secret key](https://business.revolut.com/settings/apis?tab=merchant-api) to authorise requests coming from the merchant's backend. \n\nIt ensures that ensures that each request is authenticated and authorised by verifying the secret key. The secret key should be included in all request headers as a `Bearer` token.\n\n:::info\nFor more information, see: [Authentication](https://developer.revolut.com/docs/api/merchant#authentication)\n:::","descriptionNode":"$L506"}],"requestBody":"$6d:props:children:0:props:children:props:requestBody","heading":"Request","requestBodySchemaTitle":"Request body","headingAs":"h3"}],["$","$L89",null,{"responses":"$6d:props:children:0:props:children:props:responses","headingAs":"h3"}]]}],["$","div",null,{"className":"ezz1n32","children":[[["$","$L8a",null,{"itemsByServer":{"https://merchant.revolut.com":[{"id":"curl","label":"cURL","templateCode":"curl -X POST \"https://merchant.revolut.com/api/synchronous-webhooks\" \\\n -H \"Content-Type: application/json\" \\\n -H \"Authorization: __RP_TOK_0__\" \\\n -d '{\n \"event_type\": \"fast_checkout.validate_address\",\n \"url\": \"https://backend.example.com/webhooks/validate-address\"\n}'","templateHtml":"$507","tokens":[{"marker":"__RP_TOK_0__","paramName":"Authorization","paramIn":"header","pipeline":["shell-double-inner"]}],"defaults":{"header:Authorization":"Bearer "}},{"id":"javascript","label":"JavaScript","templateCode":"const payload = {\n \"event_type\": \"fast_checkout.validate_address\",\n \"url\": \"https://backend.example.com/webhooks/validate-address\"\n};\nfetch(\"https://merchant.revolut.com/api/synchronous-webhooks\", {\n method: \"POST\",\n headers: {\n \"Content-Type\": \"application/json\",\n \"Authorization\": \"__RP_TOK_0__\"\n },\n body: JSON.stringify(payload)\n})\n .then(response => response.json())\n .then(data => console.log(data));","templateHtml":"$508","tokens":[{"marker":"__RP_TOK_0__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer "}},{"id":"go","label":"Go","templateCode":"package main\n\nimport (\n \"fmt\"\n \"net/http\"\n \"bytes\"\n \"encoding/json\"\n)\n\nfunc main() {\n url := \"https://merchant.revolut.com/api/synchronous-webhooks\"\n jsonData := []byte(`\n{\n \"event_type\": \"fast_checkout.validate_address\",\n \"url\": \"https://backend.example.com/webhooks/validate-address\"\n}\n `)\n req, _ := http.NewRequest(\"POST\", url, bytes.NewBuffer(jsonData))\n req.Header.Add(\"Content-Type\", \"application/json\")\n req.Header.Add(\"Authorization\", \"__RP_TOK_0__\")\n\n res, _ := http.DefaultClient.Do(req)\n defer res.Body.Close()\n fmt.Println(res)\n}","templateHtml":"$509","tokens":[{"marker":"__RP_TOK_0__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer "}},{"id":"python","label":"Python","templateCode":"import requests\n\nurl = \"https://merchant.revolut.com/api/synchronous-webhooks\"\nheaders = {\n \"Content-Type\": \"application/json\",\n \"Authorization\": \"__RP_TOK_0__\"\n}\npayload = {\n \"event_type\": \"fast_checkout.validate_address\",\n \"url\": \"https://backend.example.com/webhooks/validate-address\"\n}\n\nresponse = requests.post(url, headers=headers, json=payload)\nprint(response.json())","templateHtml":"$50a","tokens":[{"marker":"__RP_TOK_0__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer "}},{"id":"java","label":"Java","templateCode":"import java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\nimport java.net.URI;\n\npublic class Main {\n public static void main(String[] args) {\n HttpClient client = HttpClient.newHttpClient();\n String body = \"\"\"\n{\n \"event_type\": \"fast_checkout.validate_address\",\n \"url\": \"https://backend.example.com/webhooks/validate-address\"\n}\n \"\"\";\n\n HttpRequest request = HttpRequest.newBuilder()\n .uri(URI.create(\"https://merchant.revolut.com/api/synchronous-webhooks\"))\n .header(\"Content-Type\", \"application/json\")\n .header(\"Authorization\", \"__RP_TOK_0__\")\n .POST(HttpRequest.BodyPublishers.ofString(body))\n .build();\n\n client.sendAsync(request, HttpResponse.BodyHandlers.ofString())\n .thenApply(HttpResponse::body)\n .thenAccept(System.out::println)\n .join();\n }\n}","templateHtml":"$50b","tokens":[{"marker":"__RP_TOK_0__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer "}},{"id":"csharp","label":"C#","templateCode":"using System.Net.Http;\nusing System.Net.Http.Headers;\n\nvar client = new HttpClient();\nvar request = new HttpRequestMessage\n{\n Method = HttpMethod.Post,\n RequestUri = new Uri(\"https://merchant.revolut.com/api/synchronous-webhooks\"),\n Headers =\n {\n { \"Authorization\", \"__RP_TOK_0__\" },\n },\n Content = new StringContent(@\"{\n \"\"event_type\"\": \"\"fast_checkout.validate_address\"\",\n \"\"url\"\": \"\"https://backend.example.com/webhooks/validate-address\"\"\n}\")\n {\n Headers =\n {\n ContentType = new MediaTypeHeaderValue(\"application/json\")\n }\n }\n};\n\nusing (var response = await client.SendAsync(request))\n{\n response.EnsureSuccessStatusCode();\n var body = await response.Content.ReadAsStringAsync();\n Console.WriteLine(body);\n}","templateHtml":"$50c","tokens":[{"marker":"__RP_TOK_0__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer "}}],"https://sandbox-merchant.revolut.com":[{"id":"curl","label":"cURL","templateCode":"curl -X POST \"https://sandbox-merchant.revolut.com/api/synchronous-webhooks\" \\\n -H \"Content-Type: application/json\" \\\n -H \"Authorization: __RP_TOK_0__\" \\\n -d '{\n \"event_type\": \"fast_checkout.validate_address\",\n \"url\": \"https://backend.example.com/webhooks/validate-address\"\n}'","templateHtml":"$50d","tokens":[{"marker":"__RP_TOK_0__","paramName":"Authorization","paramIn":"header","pipeline":["shell-double-inner"]}],"defaults":{"header:Authorization":"Bearer "}},{"id":"javascript","label":"JavaScript","templateCode":"const payload = {\n \"event_type\": \"fast_checkout.validate_address\",\n \"url\": \"https://backend.example.com/webhooks/validate-address\"\n};\nfetch(\"https://sandbox-merchant.revolut.com/api/synchronous-webhooks\", {\n method: \"POST\",\n headers: {\n \"Content-Type\": \"application/json\",\n \"Authorization\": \"__RP_TOK_0__\"\n },\n body: JSON.stringify(payload)\n})\n .then(response => response.json())\n .then(data => console.log(data));","templateHtml":"$50e","tokens":[{"marker":"__RP_TOK_0__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer "}},{"id":"go","label":"Go","templateCode":"package main\n\nimport (\n \"fmt\"\n \"net/http\"\n \"bytes\"\n \"encoding/json\"\n)\n\nfunc main() {\n url := \"https://sandbox-merchant.revolut.com/api/synchronous-webhooks\"\n jsonData := []byte(`\n{\n \"event_type\": \"fast_checkout.validate_address\",\n \"url\": \"https://backend.example.com/webhooks/validate-address\"\n}\n `)\n req, _ := http.NewRequest(\"POST\", url, bytes.NewBuffer(jsonData))\n req.Header.Add(\"Content-Type\", \"application/json\")\n req.Header.Add(\"Authorization\", \"__RP_TOK_0__\")\n\n res, _ := http.DefaultClient.Do(req)\n defer res.Body.Close()\n fmt.Println(res)\n}","templateHtml":"$50f","tokens":[{"marker":"__RP_TOK_0__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer "}},{"id":"python","label":"Python","templateCode":"import requests\n\nurl = \"https://sandbox-merchant.revolut.com/api/synchronous-webhooks\"\nheaders = {\n \"Content-Type\": \"application/json\",\n \"Authorization\": \"__RP_TOK_0__\"\n}\npayload = {\n \"event_type\": \"fast_checkout.validate_address\",\n \"url\": \"https://backend.example.com/webhooks/validate-address\"\n}\n\nresponse = requests.post(url, headers=headers, json=payload)\nprint(response.json())","templateHtml":"$510","tokens":[{"marker":"__RP_TOK_0__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer "}},{"id":"java","label":"Java","templateCode":"import java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\nimport java.net.URI;\n\npublic class Main {\n public static void main(String[] args) {\n HttpClient client = HttpClient.newHttpClient();\n String body = \"\"\"\n{\n \"event_type\": \"fast_checkout.validate_address\",\n \"url\": \"https://backend.example.com/webhooks/validate-address\"\n}\n \"\"\";\n\n HttpRequest request = HttpRequest.newBuilder()\n .uri(URI.create(\"https://sandbox-merchant.revolut.com/api/synchronous-webhooks\"))\n .header(\"Content-Type\", \"application/json\")\n .header(\"Authorization\", \"__RP_TOK_0__\")\n .POST(HttpRequest.BodyPublishers.ofString(body))\n .build();\n\n client.sendAsync(request, HttpResponse.BodyHandlers.ofString())\n .thenApply(HttpResponse::body)\n .thenAccept(System.out::println)\n .join();\n }\n}","templateHtml":"$511","tokens":[{"marker":"__RP_TOK_0__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer "}},{"id":"csharp","label":"C#","templateCode":"using System.Net.Http;\nusing System.Net.Http.Headers;\n\nvar client = new HttpClient();\nvar request = new HttpRequestMessage\n{\n Method = HttpMethod.Post,\n RequestUri = new Uri(\"https://sandbox-merchant.revolut.com/api/synchronous-webhooks\"),\n Headers =\n {\n { \"Authorization\", \"__RP_TOK_0__\" },\n },\n Content = new StringContent(@\"{\n \"\"event_type\"\": \"\"fast_checkout.validate_address\"\",\n \"\"url\"\": \"\"https://backend.example.com/webhooks/validate-address\"\"\n}\")\n {\n Headers =\n {\n ContentType = new MediaTypeHeaderValue(\"application/json\")\n }\n }\n};\n\nusing (var response = await client.SendAsync(request))\n{\n response.EnsureSuccessStatusCode();\n var body = await response.Content.ReadAsStringAsync();\n Console.WriteLine(body);\n}","templateHtml":"$512","tokens":[{"marker":"__RP_TOK_0__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer "}}]},"method":"post","servers":"$62:props:children:0:props:children:props:children:1:props:children:1:props:children:0:0:props:servers","path":"/api/synchronous-webhooks","parameters":["$4fc:props:children:0:props:children:1:props:parameters:0"]}],"$L513"],"$L514","$L515"]}]]}] 39e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The unique identifier of the terminal."}]]}] 39f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The name of the terminal device."}]]}] 3a0:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The hardware type/model of the terminal device."}]]}] 3a1:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The serial number of the terminal device."}]]}] 3a2:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The current battery level of the terminal as a percentage (0-100)."}]]}] 3a3:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Indicates whether the terminal is currently online and connected."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Value","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"true"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Terminal is online and available","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"false"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Terminal is offline","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 3a4:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The date and time when the terminal was last seen online."}]]}] 3a5:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Represents a Revolut Terminal device."}]]}] 3a6:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"List of terminal devices."}]]}] 3a7:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Response containing a list of terminals."}]]}] 3a8:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"OK"}]]}] 3a9:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An identifier that can be used to determine what went wrong."}],"\n",["$","p","p-1",{"children":"Error codes are not globally unique, but uniqueness is guaranteed within endpoints."}]]}] 3aa:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Some human readable text describing what went wrong."}]]}] 3ab:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://www.unixtimestamp.com/","target":"_blank","rel":"noreferrer","children":"UNIX timestamp"}]," of the date and time the error happened."]}]]}] 3ac:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Bad Request"}]]}] 3ad:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An identifier that can be used to determine what went wrong."}],"\n",["$","p","p-1",{"children":"Error codes are not globally unique, but uniqueness is guaranteed within endpoints."}]]}] 3ae:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Some human readable text describing what went wrong."}]]}] 3af:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://www.unixtimestamp.com/","target":"_blank","rel":"noreferrer","children":"UNIX timestamp"}]," of the date and time the error happened."]}]]}] 3b0:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unauthorized"}]]}] 3b4:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The unique identifier of the payment intent."}]]}] 3b5:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The current state of the payment intent."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"State","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"pending"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Payment intent created and sent to terminal, customer has not yet started interacting","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"processing"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Customer is actively interacting with the terminal (e.g., inserting card, entering PIN)","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"completed"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["Payment authorization is complete, includes a ",["$","code","code-0",{"children":"payment_id"}]," in the response"],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"cancelled"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Payment intent was cancelled (by system or customer)","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-4",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"failed"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Payment intent failed due to technical issues (timeout, terminal unavailable, network error)","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 3b6:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The unique identifier of the terminal."}]]}] 3b7:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Permanent order ID used to retrieve, capture, cancel, or refund an order after authorization."}]]}] 3b8:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The ID of the payment."}]]}] 3b9:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The payment amount expressed in minor currency units, according to the ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_4217","target":"_blank","rel":"noreferrer","children":"ISO 4217 standard"}],". For example, ",["$","code","code-0",{"children":"7034"}]," in ",["$","code","code-1",{"children":"EUR"}]," corresponds to €70.34."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["Conversion between major and minor units varies by currency. For instance, ",["$","code","code-0",{"children":"100"}]," minor units equal £1.00 in ",["$","code","code-1",{"children":"GBP"}],", whereas in ",["$","code","code-2",{"children":"ISK"}]," they represent 100 units. For more details, see the ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_4217","target":"_blank","rel":"noreferrer","children":"ISO 4217 standard"}],"."]}]}]]}]]}] 3ba:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":[["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_4217","target":"_blank","rel":"noreferrer","children":"ISO 4217"}]," currency code in upper case."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information about the supported currencies, see: ",["$","a","a-0",{"href":"https://help.revolut.com/business/help/merchant-accounts/payments/in-which-currencies-can-i-accept-payments/","target":"_blank","rel":"noreferrer","children":"Help Center"}],"."]}]}]]}]]}] 3bb:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The date and time the payment intent was created."}]]}] 3bc:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The date and time the payment intent was last updated."}]]}] 3bd:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Represents a payment intent that has been pushed to a Revolut Terminal device."}],"\n",["$","p","p-1",{"children":["When the payment intent reaches ",["$","code","code-0",{"children":"completed"}]," state, it includes a ",["$","code","code-1",{"children":"payment_id"}]," that can be used to ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#retrieve-payment-details","target":"_blank","rel":"noreferrer","children":"retrieve the final payment status"}],"."]}]]}] 3c7:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The unique identifier of the payment intent."}]]}] 3c8:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The current state of the payment intent."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"State","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"pending"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Payment intent created and sent to terminal, customer has not yet started interacting","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"processing"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Customer is actively interacting with the terminal (e.g., inserting card, entering PIN)","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"completed"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["Payment authorization is complete, includes a ",["$","code","code-0",{"children":"payment_id"}]," in the response"],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"cancelled"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Payment intent was cancelled (by system or customer)","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-4",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"failed"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Payment intent failed due to technical issues (timeout, terminal unavailable, network error)","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 3c9:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The unique identifier of the terminal."}]]}] 3ca:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Permanent order ID used to retrieve, capture, cancel, or refund an order after authorization."}]]}] 3cb:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The ID of the payment."}]]}] 3cc:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The payment amount expressed in minor currency units, according to the ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_4217","target":"_blank","rel":"noreferrer","children":"ISO 4217 standard"}],". For example, ",["$","code","code-0",{"children":"7034"}]," in ",["$","code","code-1",{"children":"EUR"}]," corresponds to €70.34."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["Conversion between major and minor units varies by currency. For instance, ",["$","code","code-0",{"children":"100"}]," minor units equal £1.00 in ",["$","code","code-1",{"children":"GBP"}],", whereas in ",["$","code","code-2",{"children":"ISK"}]," they represent 100 units. For more details, see the ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_4217","target":"_blank","rel":"noreferrer","children":"ISO 4217 standard"}],"."]}]}]]}]]}] 3cd:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":[["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_4217","target":"_blank","rel":"noreferrer","children":"ISO 4217"}]," currency code in upper case."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information about the supported currencies, see: ",["$","a","a-0",{"href":"https://help.revolut.com/business/help/merchant-accounts/payments/in-which-currencies-can-i-accept-payments/","target":"_blank","rel":"noreferrer","children":"Help Center"}],"."]}]}]]}]]}] 3ce:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The date and time the payment intent was created."}]]}] 3cf:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The date and time the payment intent was last updated."}]]}] 3d0:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Represents a payment intent that has been pushed to a Revolut Terminal device."}],"\n",["$","p","p-1",{"children":["When the payment intent reaches ",["$","code","code-0",{"children":"completed"}]," state, it includes a ",["$","code","code-1",{"children":"payment_id"}]," that can be used to ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#retrieve-payment-details","target":"_blank","rel":"noreferrer","children":"retrieve the final payment status"}],"."]}]]}] 3d1:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Payment intent cancelled"}]]}] 3d2:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The ID of the error. You can share this ID with Revolut support for troubleshooting."}]]}] 3d3:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The date and time the error happened."}]]}] 3d4:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Bad Request"}]]}] 3dd:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Plan change scheduled successfully"}]]}] 3de:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An identifier that can be used to determine what went wrong."}],"\n",["$","p","p-1",{"children":"Error codes are not globally unique, but uniqueness is guaranteed within endpoints."}]]}] 3df:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Some human readable text describing what went wrong."}]]}] 3e0:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://www.unixtimestamp.com/","target":"_blank","rel":"noreferrer","children":"UNIX timestamp"}]," of the date and time the error happened."]}]]}] 3e1:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Bad Request"}]]}] 3e2:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An identifier that can be used to determine what went wrong."}],"\n",["$","p","p-1",{"children":"Error codes are not globally unique, but uniqueness is guaranteed within endpoints."}]]}] 3e3:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Some human readable text describing what went wrong."}]]}] 3e4:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://www.unixtimestamp.com/","target":"_blank","rel":"noreferrer","children":"UNIX timestamp"}]," of the date and time the error happened."]}]]}] 3e5:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unauthorized"}]]}] 3e6:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An identifier that can be used to determine what went wrong."}],"\n",["$","p","p-1",{"children":"Error codes are not globally unique, but uniqueness is guaranteed within endpoints."}]]}] 3e7:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Some human readable text describing what went wrong."}]]}] 3e8:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://www.unixtimestamp.com/","target":"_blank","rel":"noreferrer","children":"UNIX timestamp"}]," of the date and time the error happened."]}]]}] 3e9:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Subscription not found"}]]}] 3ea:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An identifier that can be used to determine what went wrong."}],"\n",["$","p","p-1",{"children":"Error codes are not globally unique, but uniqueness is guaranteed within endpoints."}]]}] 3eb:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Some human readable text describing what went wrong."}]]}] 3ec:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://www.unixtimestamp.com/","target":"_blank","rel":"noreferrer","children":"UNIX timestamp"}]," of the date and time the error happened."]}]]}] 3ed:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unprocessable entity"}]]}] 3ee:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An identifier that can be used to determine what went wrong."}],"\n",["$","p","p-1",{"children":"Error codes are not globally unique, but uniqueness is guaranteed within endpoints."}]]}] 3ef:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Some human readable text describing what went wrong."}]]}] 209:["$","div","CodeBlock-0",{"className":"wzy01m0 _18b50nc0","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"
'Authorization: Bearer <yourSecretApiKey>'
"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"'Authorization: Bearer '\n"}]}]]}] 20a:["$","div","CodeBlock-0",{"className":"wzy01m0 _18b50nc0","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"
'Authorization: Bearer <yourSecretApiKey>'
"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"'Authorization: Bearer '\n"}]}]]}] 20b:["$","div","CodeBlock-0",{"className":"wzy01m0 _18b50nc0","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"
'Authorization: Bearer <yourSecretApiKey>'
"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"'Authorization: Bearer '\n"}]}]]}] 20c:["$","div","CodeBlock-0",{"className":"wzy01m0 _18b50nc0","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"
'Authorization: Bearer <yourSecretApiKey>'
"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"'Authorization: Bearer '\n"}]}]]}] 516:T69c,
{
  "id": "c6b981f4-53b3-47d5-9b24-4f87af1160eb",
  "url": "https://example.com/webhooks",
  "events": [
    "ORDER_AUTHORISED",
    "ORDER_COMPLETED"
  ],
  "signing_secret": "wsk_4jETWMz1g1b37gCONjNp84t2KSSIT7dK"
}
20e:["$","div","200-application/json-retrieved_webhook",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$516"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"id\": \"c6b981f4-53b3-47d5-9b24-4f87af1160eb\",\n \"url\": \"https://example.com/webhooks\",\n \"events\": [\n \"ORDER_AUTHORISED\",\n \"ORDER_COMPLETED\"\n ],\n \"signing_secret\": \"wsk_4jETWMz1g1b37gCONjNp84t2KSSIT7dK\"\n}"}]}]]}] 20f:["$","div","401-application/json-default",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"
{\n  \"errorId\": \"string\",\n  \"timestamp\": 123\n}
"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"errorId\": \"string\",\n \"timestamp\": 123\n}"}]}]]}] 210:["$","div","404-application/json-default",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"
{\n  \"errorId\": \"string\",\n  \"timestamp\": 123\n}
"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"errorId\": \"string\",\n \"timestamp\": 123\n}"}]}]]}] 407:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Each Merchant API request must contain an authorization header in the following format:"}],"\n","$L517","\n",["$","p","p-1",{"children":"To use this API, you need to generate API keys from your Revolut Business account. The Secret key is used in the authorization header for all server calls, while the Public key is provided with payment methods at checkout."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For detailed instructions on generating your API keys, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/get-started#generate-api-keys","target":"_blank","rel":"noreferrer","children":"Generate API keys"}],"."]}]}]]}]]}] 40d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Retrieve a list of Revolut Terminal devices available to the merchant."}],"\n",["$","p","p-1",{"children":"This endpoint is primarily used for push payments to Revolut Terminal integration, allowing POS systems to discover available terminals at a specific location and in the correct operation mode."}],"\n",["$","div","inlinealert-0",{"data-type":"tip","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"Lightbulb","color":"var(--rui-color-success)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For push payments integration, use the ",["$","code","code-0",{"children":"operation_mode=pos"}]," query parameter to filter only terminals in ",["$","strong","strong-0",{"children":"Pay at Counter"}]," mode that are ready to receive payment intents."]}]}]]}],"\n",["$","div","inlinealert-1",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information about integration, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/accept-payments/in-person-payments/terminal/push-payments","target":"_blank","rel":"noreferrer","children":"Push payments to Revolut Terminal"}],"."]}]}]]}]]}] 40e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["This parameter accepts the ",["$","a","a-0",{"href":"https://business.revolut.com/settings/apis?tab=merchant-api","target":"_blank","rel":"noreferrer","children":"Merchant API Secret key"}]," to authorise requests coming from the merchant's backend."]}],"\n",["$","p","p-1",{"children":["It ensures that ensures that each request is authenticated and authorised by verifying the secret key. The secret key should be included in all request headers as a ",["$","code","code-0",{"children":"Bearer"}]," token."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#authentication","target":"_blank","rel":"noreferrer","children":"Authentication"}]]}]}]]}]]}] 40f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The version of the Merchant API, specified in ",["$","code","code-0",{"children":"YYYY-MM-DD"}]," format."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information about API versioning, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/reference/versioning/api-versions","target":"_blank","rel":"noreferrer","children":"API versions"}],"."]}]}]]}]]}] 410:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The operation mode of the terminal."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Value","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"pos"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Returns only terminals in Pay at Counter mode","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"payment_acceptance"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Returns only terminals in standard checkout mode","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 411:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Filter terminals by operation mode."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Value","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"pos"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Returns only terminals in Pay at Counter mode","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"payment_acceptance"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Returns only terminals in standard checkout mode","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 412:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A UUID string, typically used to identify resources."}]]}] 413:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Filter results by location ID."}]]}] 513:["$","$L10d",null,{"security":[{"Api-Key":[]}],"authorization":{"Api-Key":{"type":"apiKey","in":"header","name":"Authorization","description":"Each Merchant API request must contain an authorization header in the following format:\n\n```\n'Authorization: Bearer '\n```\n\nTo use this API, you need to generate API keys from your Revolut Business account. The Secret key is used in the authorization header for all server calls, while the Public key is provided with payment methods at checkout.\n\n:::info\nFor detailed instructions on generating your API keys, see: [Generate API keys](https://developer.revolut.com/docs/guides/merchant/get-started#generate-api-keys).\n:::","descriptionNode":"$L518"}}}] 514:["$","$L10f",null,{"exampleBlocks":{"application/json":{"variants":[{"key":"create_webhook","label":"Create synchronous webhook","rawValue":"$6d:props:children:0:props:children:props:requestBody:content:application/json:examples:create_webhook:value","block":"$L519"},{"key":"create_webhook_with_location_id","label":"Create synchronous webhook with location ID","rawValue":"$6d:props:children:0:props:children:props:requestBody:content:application/json:examples:create_webhook_with_location_id:value","block":"$L51a"}],"syncedPropertyName":"$undefined"}},"title":"Request body samples","headingAs":"h4"}] 515:["$","$L110",null,{"exampleBlocks":{"200":{"application/json":{"variants":[{"key":"example_without_location","label":"Synchronous webhook response","rawValue":"$6d:props:children:0:props:children:props:responses:200:content:application/json:examples:example_without_location:value","block":"$L51b"},{"key":"example_with_location","label":"Synchronous webhook response with location ID","rawValue":"$6d:props:children:0:props:children:props:responses:200:content:application/json:examples:example_with_location:value","block":"$L51c"}],"syncedPropertyName":"$undefined"}},"400":{"application/json":{"variants":[{"key":"default","label":"Example","rawValue":{"errorId":"string","timestamp":123},"block":"$L51d"}],"syncedPropertyName":"$undefined"}},"401":{}},"headingAs":"h4"}] 3be:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"OK"}]]}] 3bf:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The ID of the error. You can share this ID with Revolut support for troubleshooting."}]]}] 3c0:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The date and time the error happened."}]]}] 3c1:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unauthorized"}]]}] 3c2:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The ID of the error. You can share this ID with Revolut support for troubleshooting."}]]}] 3c3:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The date and time the error happened."}]]}] 3c4:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Not Found"}]]}] 422:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Retrieve the current state and details of a payment intent."}],"\n",["$","p","p-1",{"children":"This endpoint is used to poll the payment intent status after pushing a payment request to a Revolut Terminal. You should poll this endpoint repeatedly until the payment intent reaches a final state."}],"\n",["$","p","p-2",{"children":["$","strong","strong-0",{"children":"Payment intent states:"}]}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"State","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"pending"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Payment intent created and sent to terminal, customer has not yet started interacting","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"processing"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Customer is actively interacting with the terminal (e.g., inserting card, entering PIN)","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"completed"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["Payment authorisation is complete, response includes a ",["$","code","code-0",{"children":"payment_id"}]," that you should use to ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#retrieve-payment-details","target":"_blank","rel":"noreferrer","children":"retrieve the final payment status"}]],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"cancelled"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Payment intent was cancelled (by your system or by the customer on the terminal)","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-4",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"failed"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Payment intent failed due to technical issues (e.g., timeout, terminal became unavailable)","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}],"\n",["$","div","inlinealert-0",{"data-type":"tip","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"Lightbulb","color":"var(--rui-color-success)","inline":true}]}],["$","div",null,{"className":"_25vm6y2","children":"Polling strategy"}],["$","div",null,{"className":"_25vm6y3","children":["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["Poll every second while the state is ",["$","code","code-0",{"children":"pending"}]," or ",["$","code","code-1",{"children":"processing"}]]}],"\n",["$","li","li-1",{"children":"Set a reasonable timeout (e.g., 60 seconds) to handle cases where the customer abandons the payment"}],"\n"]}]}]]}],"\n",["$","div","inlinealert-1",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For the complete push payments flow, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/accept-payments/in-person-payments/terminal/push-payments","target":"_blank","rel":"noreferrer","children":"Push payments to Revolut Terminal"}],"."]}]}]]}]]}] 423:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["This parameter accepts the ",["$","a","a-0",{"href":"https://business.revolut.com/settings/apis?tab=merchant-api","target":"_blank","rel":"noreferrer","children":"Merchant API Secret key"}]," to authorise requests coming from the merchant's backend."]}],"\n",["$","p","p-1",{"children":["It ensures that ensures that each request is authenticated and authorised by verifying the secret key. The secret key should be included in all request headers as a ",["$","code","code-0",{"children":"Bearer"}]," token."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#authentication","target":"_blank","rel":"noreferrer","children":"Authentication"}]]}]}]]}]]}] 424:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The version of the Merchant API, specified in ",["$","code","code-0",{"children":"YYYY-MM-DD"}]," format."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information about API versioning, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/reference/versioning/api-versions","target":"_blank","rel":"noreferrer","children":"API versions"}],"."]}]}]]}]]}] 425:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The unique identifier of the payment intent."}]]}] 426:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The unique identifier of the payment intent."}]]}] 3d5:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The ID of the error. You can share this ID with Revolut support for troubleshooting."}]]}] 3d6:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The date and time the error happened."}]]}] 3d7:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unauthorized"}]]}] 3d8:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The ID of the error. You can share this ID with Revolut support for troubleshooting."}]]}] 3d9:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The date and time the error happened."}]]}] 3da:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Not Found"}]]}] 435:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["Cancel a payment intent while it's still in ",["$","code","code-0",{"children":"pending"}]," state, before the customer has completed the payment."]}],"\n",["$","p","p-1",{"children":"This is useful if the customer changes their mind or if there's an issue with the order before payment is completed."}],"\n",["$","div","inlinealert-0",{"data-type":"warning","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMark","color":"var(--rui-color-warning)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":["$","strong","strong-0",{"children":"Requirements:"}]}],["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["Payment intent must be in ",["$","code","code-0",{"children":"pending"}]," state"]}],"\n",["$","li","li-1",{"children":["Cannot cancel payment intents that are already ",["$","code","code-0",{"children":"completed"}],", ",["$","code","code-1",{"children":"cancelled"}],", or ",["$","code","code-2",{"children":"failed"}]]}],"\n"]}]]}]]}],"\n",["$","div","inlinealert-1",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For the complete push payments flow, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/accept-payments/in-person-payments/terminal/push-payments","target":"_blank","rel":"noreferrer","children":"Push payments to Revolut Terminal"}],"."]}]}]]}]]}] 436:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["This parameter accepts the ",["$","a","a-0",{"href":"https://business.revolut.com/settings/apis?tab=merchant-api","target":"_blank","rel":"noreferrer","children":"Merchant API Secret key"}]," to authorise requests coming from the merchant's backend."]}],"\n",["$","p","p-1",{"children":["It ensures that ensures that each request is authenticated and authorised by verifying the secret key. The secret key should be included in all request headers as a ",["$","code","code-0",{"children":"Bearer"}]," token."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#authentication","target":"_blank","rel":"noreferrer","children":"Authentication"}]]}]}]]}]]}] 437:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The version of the Merchant API, specified in ",["$","code","code-0",{"children":"YYYY-MM-DD"}]," format."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information about API versioning, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/reference/versioning/api-versions","target":"_blank","rel":"noreferrer","children":"API versions"}],"."]}]}]]}]]}] 438:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The unique identifier of the payment intent."}]]}] 439:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The unique identifier of the payment intent."}]]}] 3f0:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://www.unixtimestamp.com/","target":"_blank","rel":"noreferrer","children":"UNIX timestamp"}]," of the date and time the error happened."]}]]}] 3f1:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Error response"}]]}] 3f2:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unique identifier for the subscription plan variation."}]]}] 3f3:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unique identifier for the subscription plan phase."}]]}] 3f4:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"When the plan change should take effect."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Value","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"at_cycle_end"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The change is applied at the end of the current billing cycle.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 3f5:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The reason for the scheduled action. This field is informational and does not affect how the action is processed."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Value","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"customer_request"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The action was requested by the customer.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"merchant_request"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The action was initiated by the merchant.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 448:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Schedule a plan change for a subscription. The change is applied at the end of the current billing cycle."}],"\n",["$","h3","h3-0",{"children":"Use cases"}],"\n",["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":[["$","strong","strong-0",{"children":"Plan upgrades:"}]," Moving a customer to a higher-tier plan with more features or capacity."]}],"\n",["$","li","li-1",{"children":[["$","strong","strong-0",{"children":"Plan downgrades:"}]," Moving a customer to a lower-tier plan that better fits their usage and budget."]}],"\n",["$","li","li-2",{"children":[["$","strong","strong-0",{"children":"Customer requests:"}]," Accommodating a customer's request to switch to a different plan variation."]}],"\n"]}],"\n",["$","h5","h5-0",{"children":"How it works"}],"\n",["$","p","p-1",{"children":"When you schedule a plan change, the subscription continues operating under its current plan variation until the current billing cycle ends. At that point, the next cycle is created under the new plan variation."}],"\n",["$","ul","ul-1",{"children":["\n",["$","li","li-0",{"children":[["$","strong","strong-0",{"children":"Scheduled change:"}]," The plan change is scheduled to take effect ",["$","code","code-0",{"children":"at_cycle_end"}],". The current cycle completes normally, and the new plan variation applies starting from the next cycle."]}],"\n",["$","li","li-1",{"children":[["$","strong","strong-0",{"children":"Plan variation phases:"}]," Some plan variations are divided into phases - distinct pricing or duration periods within a single variation. If the target plan variation has multiple phases, use ",["$","code","code-0",{"children":"plan_variation_phase_id"}]," to specify which phase to start from. If omitted, the change starts from the first phase."]}],"\n",["$","li","li-2",{"children":[["$","strong","strong-0",{"children":"Trial periods:"}]," If the target plan variation includes a trial period, it is skipped when changing plans. Trial periods only apply when a subscription is first created."]}],"\n",["$","li","li-3",{"children":[["$","strong","strong-0",{"children":"Subsequent cycles:"}]," After the transition, future cycles follow the cadence and pricing defined by the new plan variation."]}],"\n"]}]]}] 449:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["This parameter accepts the ",["$","a","a-0",{"href":"https://business.revolut.com/settings/apis?tab=merchant-api","target":"_blank","rel":"noreferrer","children":"Merchant API Secret key"}]," to authorise requests coming from the merchant's backend."]}],"\n",["$","p","p-1",{"children":["It ensures that ensures that each request is authenticated and authorised by verifying the secret key. The secret key should be included in all request headers as a ",["$","code","code-0",{"children":"Bearer"}]," token."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#authentication","target":"_blank","rel":"noreferrer","children":"Authentication"}]]}]}]]}]]}] 44a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The version of the Merchant API, specified in ",["$","code","code-0",{"children":"YYYY-MM-DD"}]," format."]}],"\n",["$","p","p-1",{"children":"If not specified, you will receive an error."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information about API versioning, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/reference/versioning/api-versions","target":"_blank","rel":"noreferrer","children":"API versions"}],"."]}]}]]}]]}] 44b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A UUID string, typically used to identify resources."}]]}] 44c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The ID of the subscription."}]]}] 45c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Dispute challenged successfully"}]]}] 45d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An identifier that can be used to determine what went wrong."}],"\n",["$","p","p-1",{"children":"Error codes are not globally unique, but uniqueness is guaranteed within endpoints."}]]}] 45e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Some human readable text describing what went wrong."}]]}] 45f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://www.unixtimestamp.com/","target":"_blank","rel":"noreferrer","children":"UNIX timestamp"}]," of the date and time the error happened."]}]]}] 460:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Bad Request"}]]}] 461:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An identifier that can be used to determine what went wrong."}],"\n",["$","p","p-1",{"children":"Error codes are not globally unique, but uniqueness is guaranteed within endpoints."}]]}] 462:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Some human readable text describing what went wrong."}]]}] 463:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://www.unixtimestamp.com/","target":"_blank","rel":"noreferrer","children":"UNIX timestamp"}]," of the date and time the error happened."]}]]}] 464:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unauthorized"}]]}] 465:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An identifier that can be used to determine what went wrong."}],"\n",["$","p","p-1",{"children":"Error codes are not globally unique, but uniqueness is guaranteed within endpoints."}]]}] 466:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Some human readable text describing what went wrong."}]]}] 467:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://www.unixtimestamp.com/","target":"_blank","rel":"noreferrer","children":"UNIX timestamp"}]," of the date and time the error happened."]}]]}] 468:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Forbidden"}]]}] 469:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An identifier that can be used to determine what went wrong."}],"\n",["$","p","p-1",{"children":"Error codes are not globally unique, but uniqueness is guaranteed within endpoints."}]]}] 46a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Some human readable text describing what went wrong."}]]}] 46b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://www.unixtimestamp.com/","target":"_blank","rel":"noreferrer","children":"UNIX timestamp"}]," of the date and time the error happened."]}]]}] 46c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Not Found"}]]}] 46d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An identifier that can be used to determine what went wrong."}],"\n",["$","p","p-1",{"children":"Error codes are not globally unique, but uniqueness is guaranteed within endpoints."}]]}] 46e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Some human readable text describing what went wrong."}]]}] 46f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://www.unixtimestamp.com/","target":"_blank","rel":"noreferrer","children":"UNIX timestamp"}]," of the date and time the error happened."]}]]}] 470:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unprocessable entity"}]]}] 224:["$","div","CodeBlock-0",{"className":"wzy01m0 _18b50nc0","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"
'Authorization: Bearer <yourSecretApiKey>'
"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"'Authorization: Bearer '\n"}]}]]}] 225:["$","div","CodeBlock-0",{"className":"wzy01m0 _18b50nc0","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"
'Authorization: Bearer <yourSecretApiKey>'
"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"'Authorization: Bearer '\n"}]}]]}] 23:["$","$7a","create-customer",{"children":[["$","section",null,{"className":"y9a0do0","data-variant":"endpoint","children":["$","$L7b",null,{"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"title":"Customer","type":"object","description":"A customer object.","properties":{"id":{"type":"string","format":"uuid","description":"Unique identifier for the customer.","descriptionNode":"$L51e"},"full_name":{"type":"string","description":"The full name of the customer.","descriptionNode":"$L51f"},"email":{"type":"string","format":"email","description":"The email address of the customer.","descriptionNode":"$L520"},"phone":{"type":"string","description":"The phone number of the customer in [E.164 format](https://en.wikipedia.org/wiki/E.164).","descriptionNode":"$L521"},"created_at":{"type":"string","format":"date-time","description":"The date and time the customer was created.","descriptionNode":"$L522"},"updated_at":{"type":"string","format":"date-time","description":"The date and time the customer was last updated.","descriptionNode":"$L523"}},"required":["id","created_at","updated_at","email"],"descriptionNode":"$L524"},"examples":{"created_customer":{"summary":"Customer","value":{"id":"6c7c97a8-cfc1-4cf3-8b38-26a74fdf1fae","full_name":"Example Customer","email":"example.customer@example.com","phone":"+441234567890","created_at":"2020-06-24T12:03:39.979397Z","updated_at":"2020-06-24T12:03:39.979397Z"}}}}},"descriptionNode":"$L525"},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"code":{"type":"string","description":"An identifier that can be used to determine what went wrong.\n\nError codes are not globally unique, but uniqueness is guaranteed within endpoints.","descriptionNode":"$L526"},"message":{"type":"string","description":"Some human readable text describing what went wrong.","descriptionNode":"$L527"},"timestamp":{"type":"integer","description":"The [UNIX timestamp](https://www.unixtimestamp.com/) of the date and time the error happened.","descriptionNode":"$L528"}}}}},"descriptionNode":"$L529"},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"code":{"type":"string","description":"An identifier that can be used to determine what went wrong.\n\nError codes are not globally unique, but uniqueness is guaranteed within endpoints.","descriptionNode":"$L52a"},"message":{"type":"string","description":"Some human readable text describing what went wrong.","descriptionNode":"$L52b"},"timestamp":{"type":"integer","description":"The [UNIX timestamp](https://www.unixtimestamp.com/) of the date and time the error happened.","descriptionNode":"$L52c"}}}}},"descriptionNode":"$L52d"}},"requestBody":{"content":{"application/json":{"schema":{"title":"Customer creation","type":"object","description":"The request body for creating a customer.","properties":{"full_name":{"type":"string","description":"The full name of the customer.","descriptionNode":"$L52e"},"email":{"type":"string","format":"email","description":"The email address of the customer.","descriptionNode":"$L52f"},"phone":{"type":"string","description":"The phone number of the customer in [E.164 format](https://en.wikipedia.org/wiki/E.164).","descriptionNode":"$L530"},"date_of_birth":{"type":"string","format":"date","description":"The birth date of the customer.","descriptionNode":"$L531"}},"required":["email"],"descriptionNode":"$L532"},"examples":{"example_customer_creation":{"summary":"Create a customer","value":{"full_name":"Example Customer","email":"example.customer@example.com","phone":"+441234567890","date_of_birth":"1990-01-01"}}}}}},"variantLabels":[],"children":[["$","div",null,{"className":"ezz1n30","children":[["$","div",null,{"data-header":"$undefined","className":"ezz1n31","children":["$","div",null,{"className":"y9a0do1","children":[["$","h2",null,{"id":"create-customer","children":[["$L533","$undefined"],["$","$L15",null,{"id":"create-customer"}]]}],["$","$L16",null,{"url":"/docs/api/merchant/2025-10-16/operations/create-customer.md"}]]}]}],"$undefined"]}],["$","div",null,{"className":"ezz1n30","children":[["$","div",null,{"data-header":"$undefined","className":"ezz1n31","children":["$L534",["$","$L85",null,{"parameters":[{"name":"Authorization","in":"header","schema":{"type":"string","format":"Bearer ","examples":"$62:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:0:schema:examples"},"required":true,"description":"This parameter accepts the [Merchant API Secret key](https://business.revolut.com/settings/apis?tab=merchant-api) to authorise requests coming from the merchant's backend. \n\nIt ensures that ensures that each request is authenticated and authorised by verifying the secret key. The secret key should be included in all request headers as a `Bearer` token.\n\n:::info\nFor more information, see: [Authentication](https://developer.revolut.com/docs/api/merchant#authentication)\n:::","descriptionNode":"$L535"},{"name":"Revolut-Api-Version","in":"header","schema":{"type":"string","format":"date","enum":"$27:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:1:schema:enum","examples":"$27:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:1:schema:examples"},"required":true,"description":"The version of the Merchant API, specified in `YYYY-MM-DD` format.\n\nThis endpoint is available from version `2024-09-01`. If a version earlier than `2024-09-01` is provided, the endpoint returns a `404` response.\n\nIf not specified, you will receive an error.\n\n\n:::info\nFor more information about API versioning, see: [API versions](https://developer.revolut.com/docs/guides/merchant/reference/versioning/api-versions).\n:::","x-config-always-visible-in-example":true,"example":"2025-10-16","descriptionNode":"$L536"}],"requestBody":"$23:props:children:0:props:children:props:requestBody","heading":"Request","requestBodySchemaTitle":"Request body","headingAs":"h3"}],"$L537"]}],"$L538"]}]]}]}],false]}] 3a:["$","$7a","retrieve-subscription-cycle",{"children":[["$","section",null,{"className":"y9a0do0","data-variant":"endpoint","children":["$","$L7b",null,{"responses":{"200":{"description":"Subscription cycle retrieved successfully","content":{"application/json":{"schema":{"type":"object","required":["id","subscription_id","plan_variation_id","number","state"],"properties":{"id":{"type":"string","format":"uuid","description":"Unique identifier for the subscription cycle.","descriptionNode":"$L539"},"subscription_id":{"type":"string","format":"uuid","description":"Unique identifier for the subscription.","descriptionNode":"$L53a"},"plan_variation_id":{"type":"string","format":"uuid","description":"Unique identifier for the subscription plan variation.","descriptionNode":"$L53b"},"plan_variation_phase_id":{"type":"string","format":"uuid","description":"Unique identifier for the subscription plan phase.","descriptionNode":"$L53c"},"number":{"type":"integer","minimum":1,"description":"The sequential cycle number within the subscription.\n\nStarts at `1` for the first cycle and increments with each new billing cycle.","descriptionNode":"$L53d"},"previous_cycle_id":{"type":["string","null"],"format":"uuid","description":"The unique identifier of the previous billing cycle.\n\nThis field is `null` for the first cycle in a subscription.","descriptionNode":"$L53e"},"state":{"type":"string","enum":["pending","active","finished"],"description":"The state of the subscription cycle.\n\n| State | Description |\n| ----- | ----------- |\n| `pending` | The cycle has been created but has not yet started. A cycle can enter this state automatically when usage is reported for a future cycle via `POST /api/subscription-usages`. |\n| `active` | The cycle is currently active and in progress. |\n| `finished` | The cycle has completed. |","descriptionNode":"$L53f"},"start_date":{"type":"string","format":"date-time","description":"The date and time the subscription cycle starts in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format.","descriptionNode":"$L540"},"end_date":{"type":"string","format":"date-time","description":"The date and time the subscription cycle ends in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format.","descriptionNode":"$L541"},"usage_cutoff_date":{"type":"string","format":"date-time","description":"The deadline for submitting or correcting usage records for this cycle, in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format.\n\nSet to 12 hours after the cycle's `end_date` by default. After this time, Revolut aggregates all reported usage records and creates the `post_billing_order_id` to initiate the charge.\n\n:::note\nOnly present for cycles that include usage-based subscription items.\n:::","descriptionNode":"$L542"},"order_id":{"type":"string","format":"uuid","description":"Permanent order ID used to retrieve, capture, cancel, or refund an order after authorization.","descriptionNode":"$L543"},"post_billing_order_id":{"type":"string","format":"uuid","description":"The ID of the order created after the cycle's `usage_cutoff_date` to charge usage-based items accumulated during the cycle.\n\n| Scenario | Detail |\n| -------- | ------ |\n| Ongoing subscription | This order also acts as the next cycle's `order_id`, combining usage post-billing for the current cycle with pre-billing for the next. |\n| Last cycle | A standalone finishing order is created to charge all usage from this cycle. |\n| Subscription ended with unpaid cycles | The finishing order consolidates all outstanding usage charges, including any from previous cycles where payment failed. |\n\n:::note\nOnly present for cycles that include usage-based subscription items.\n:::","descriptionNode":"$L544"},"trial":{"type":"boolean","description":"Indicates whether this billing cycle occurs during the subscription's trial period.\n\nThis value is automatically calculated by the system based on the cycle's timing relative to the subscription's trial period. Returns `true` if the cycle is within the trial period (before `trial_end_date`), otherwise `false`. \n\nTrial cycles typically have different billing behavior, such as reduced or zero charges.","default":false,"examples":[false],"descriptionNode":"$L545"}}},"examples":{"finished_cycle":{"summary":"Finished subscription cycle","value":{"id":"950e8400-e29b-41d4-a716-446655440004","subscription_id":"650e8400-e29b-41d4-a716-446655440001","plan_variation_id":"750e8400-e29b-41d4-a716-446655440002","plan_variation_phase_id":"850e8400-e29b-41d4-a716-446655440003","number":1,"state":"finished","start_date":"2025-06-05T21:00:00.036001Z","end_date":"2025-07-05T21:00:00.036001Z","order_id":"b50e8400-e29b-41d4-a716-446655440006","trial":true}}}}},"descriptionNode":"$L546"},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"code":{"type":"string","description":"An identifier that can be used to determine what went wrong.\n\nError codes are not globally unique, but uniqueness is guaranteed within endpoints.","descriptionNode":"$L547"},"message":{"type":"string","description":"Some human readable text describing what went wrong.","descriptionNode":"$L548"},"timestamp":{"type":"integer","description":"The [UNIX timestamp](https://www.unixtimestamp.com/) of the date and time the error happened.","descriptionNode":"$L549"}}}}},"descriptionNode":"$L54a"},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"code":{"type":"string","description":"An identifier that can be used to determine what went wrong.\n\nError codes are not globally unique, but uniqueness is guaranteed within endpoints.","descriptionNode":"$L54b"},"message":{"type":"string","description":"Some human readable text describing what went wrong.","descriptionNode":"$L54c"},"timestamp":{"type":"integer","description":"The [UNIX timestamp](https://www.unixtimestamp.com/) of the date and time the error happened.","descriptionNode":"$L54d"}}}}},"descriptionNode":"$L54e"},"404":{"description":"Subscription cycle not found","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"code":{"type":"string","description":"An identifier that can be used to determine what went wrong.\n\nError codes are not globally unique, but uniqueness is guaranteed within endpoints.","descriptionNode":"$L54f"},"message":{"type":"string","description":"Some human readable text describing what went wrong.","descriptionNode":"$L550"},"timestamp":{"type":"integer","description":"The [UNIX timestamp](https://www.unixtimestamp.com/) of the date and time the error happened.","descriptionNode":"$L551"}}}}},"descriptionNode":"$L552"},"default":{"description":"Error response","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"code":{"type":"string","description":"An identifier that can be used to determine what went wrong.\n\nError codes are not globally unique, but uniqueness is guaranteed within endpoints.","descriptionNode":"$L553"},"message":{"type":"string","description":"Some human readable text describing what went wrong.","descriptionNode":"$L554"},"timestamp":{"type":"integer","description":"The [UNIX timestamp](https://www.unixtimestamp.com/) of the date and time the error happened.","descriptionNode":"$L555"}}}}},"descriptionNode":"$L556"}},"requestBody":"$undefined","variantLabels":[],"children":["$L557","$L558"]}]}],false]}] 3d:["$","$7a","retrieve-subscription-usage",{"children":[["$","section",null,{"className":"y9a0do0","data-variant":"endpoint","children":["$","$L7b",null,{"responses":{"200":{"description":"Usage record retrieved successfully","content":{"application/json":{"schema":{"type":"object","required":["id","subscription_id","subscription_cycle_id","subscription_item_code","usage_date","quantity","created_at","updated_at"],"properties":{"id":{"type":"string","format":"uuid","description":"The unique identifier of the usage record.","descriptionNode":"$L559"},"subscription_id":{"type":"string","format":"uuid","description":"Unique identifier for the subscription.","descriptionNode":"$L55a"},"subscription_cycle_id":{"type":"string","format":"uuid","description":"Unique identifier for the subscription cycle.","descriptionNode":"$L55b"},"subscription_item_code":{"type":"string","description":"A merchant-defined identifier for a usage-based subscription item. You set this code on each usage item when creating a subscription plan, and supply it when reporting consumption on [Create a subscription usage endpoint](https://developer.revolut.com/docs/api/merchant#create-subscription-usage) to target the correct metered item.\n\nThis allows a subscription with multiple usage items (e.g., `api_calls` and `storage_gb`) to receive consumption reports against the right item without relying on internal IDs.\n\nThe code must be unique within a plan phase.","maxLength":250,"examples":["api_calls"],"descriptionNode":"$L55c"},"usage_date":{"type":"string","format":"date-time","description":"The timestamp indicating when the consumption actually occurred.\n\n| Constraint | Detail |\n| ---------- | ------ |\n| Format | [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date-time string (e.g., `YYYY-MM-DDTHH:mm:ssZ`). |\n| Timezone | Must be UTC. |\n| Validation | Revolut uses this to identify the applicable billing cycle. Accepted for the active cycle (`start_date ≤ usage_date < end_date`), for a recently ended cycle before its `usage_cutoff_date`, and for the one next upcoming cycle. Other dates are rejected. |","examples":["2026-03-01T21:00:00Z"],"descriptionNode":"$L55d"},"quantity":{"type":"number","exclusiveMinimum":0,"description":"The quantity of consumption to record for this usage report. \n\nSupports up to 20 digits before and 20 digits after the decimal point.","examples":[100.5],"descriptionNode":"$L55e"},"metadata":{"type":"object","description":"Key-value pairs you can attach to a usage record for your own tracking and reporting purposes.\n\n| Constraint | Detail |\n| ---------- | ------ |\n| Keys | Maximum 50 keys per record. |\n| Value types | String, number, or boolean only. |\n| Number precision | Up to 20 digits before and 20 digits after the decimal point. |","additionalProperties":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]},"maxProperties":50,"examples":[{"user_id":"12345","api_version":"v2","usage_rate":1.5,"is_trial":true}],"descriptionNode":"$L55f"},"created_at":{"type":"string","format":"date-time","description":"The date and time the usage record was created in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format.","examples":["2026-03-01T21:05:00Z"],"descriptionNode":"$L560"},"updated_at":{"type":"string","format":"date-time","description":"The date and time the usage record was last updated in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format.","examples":["2026-03-01T21:05:00Z"],"descriptionNode":"$L561"}}},"examples":{"usage_record":{"summary":"Successful usage record creation","description":"Returns the reported usages","value":{"id":"750e8400-e29b-41d4-a716-446655440000","subscription_id":"550e8400-e29b-41d4-a716-446655440000","subscription_cycle_id":"850e8400-e29b-41d4-a716-446655440000","subscription_item_code":"api_calls","usage_date":"2026-03-01T21:00:00Z","quantity":100,"metadata":{"user_id":"12345","api_version":"v2"},"created_at":"2026-03-01T21:05:00Z","updated_at":"2026-03-01T21:05:00Z"}}}}},"descriptionNode":"$L562"},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"code":{"type":"string","description":"An identifier that can be used to determine what went wrong.\n\nError codes are not globally unique, but uniqueness is guaranteed within endpoints.","descriptionNode":"$L563"},"message":{"type":"string","description":"Some human readable text describing what went wrong.","descriptionNode":"$L564"},"timestamp":{"type":"integer","description":"The [UNIX timestamp](https://www.unixtimestamp.com/) of the date and time the error happened.","descriptionNode":"$L565"}}}}},"descriptionNode":"$L566"},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"code":{"type":"string","description":"An identifier that can be used to determine what went wrong.\n\nError codes are not globally unique, but uniqueness is guaranteed within endpoints.","descriptionNode":"$L567"},"message":{"type":"string","description":"Some human readable text describing what went wrong.","descriptionNode":"$L568"},"timestamp":{"type":"integer","description":"The [UNIX timestamp](https://www.unixtimestamp.com/) of the date and time the error happened.","descriptionNode":"$L569"}}}}},"descriptionNode":"$L56a"},"404":{"description":"Usage not found","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"code":{"type":"string","description":"An identifier that can be used to determine what went wrong.\n\nError codes are not globally unique, but uniqueness is guaranteed within endpoints.","descriptionNode":"$L56b"},"message":{"type":"string","description":"Some human readable text describing what went wrong.","descriptionNode":"$L56c"},"timestamp":{"type":"integer","description":"The [UNIX timestamp](https://www.unixtimestamp.com/) of the date and time the error happened.","descriptionNode":"$L56d"}}}}},"descriptionNode":"$L56e"},"default":{"description":"Error response","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"code":{"type":"string","description":"An identifier that can be used to determine what went wrong.\n\nError codes are not globally unique, but uniqueness is guaranteed within endpoints.","descriptionNode":"$L56f"},"message":{"type":"string","description":"Some human readable text describing what went wrong.","descriptionNode":"$L570"},"timestamp":{"type":"integer","description":"The [UNIX timestamp](https://www.unixtimestamp.com/) of the date and time the error happened.","descriptionNode":"$L571"}}}}},"descriptionNode":"$L572"}},"requestBody":"$undefined","variantLabels":[],"children":["$L573","$L574"]}]}],false]}] 575:T7c3,
{
  "id": "a830020e-090c-4717-836d-37941a27ad12",
  "state": "completed",
  "created_at": "2024-02-27T00:16:39.079285Z",
  "destination_type": "current_pocket",
  "amount": 50000,
  "currency": "GBP"
}
227:["$","div","200-application/json-default",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$575"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"id\": \"a830020e-090c-4717-836d-37941a27ad12\",\n \"state\": \"completed\",\n \"created_at\": \"2024-02-27T00:16:39.079285Z\",\n \"destination_type\": \"current_pocket\",\n \"amount\": 50000,\n \"currency\": \"GBP\"\n}"}]}]]}] 576:T478,
{
  "code": "bad_request",
  "message": "Missing Revolut-Api-Version header",
  "timestamp": 1721049596461
}
228:["$","div","400-application/json-default",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$576"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"code\": \"bad_request\",\n \"message\": \"Missing Revolut-Api-Version header\",\n \"timestamp\": 1721049596461\n}"}]}]]}] 577:T46f,
{
  "code": "unauthenticated",
  "message": "Authentication failed",
  "timestamp": 1721049596461
}
229:["$","div","401-application/json-default",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$577"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"code\": \"unauthenticated\",\n \"message\": \"Authentication failed\",\n \"timestamp\": 1721049596461\n}"}]}]]}] 578:T477,
{
  "code": "not_found",
  "message": "The requested resource is not found",
  "timestamp": 1721050063886
}
22a:["$","div","404-application/json-default",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$578"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"code\": \"not_found\",\n \"message\": \"The requested resource is not found\",\n \"timestamp\": 1721050063886\n}"}]}]]}] 484:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Each Merchant API request must contain an authorization header in the following format:"}],"\n","$L579","\n",["$","p","p-1",{"children":"To use this API, you need to generate API keys from your Revolut Business account. The Secret key is used in the authorization header for all server calls, while the Public key is provided with payment methods at checkout."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For detailed instructions on generating your API keys, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/get-started#generate-api-keys","target":"_blank","rel":"noreferrer","children":"Generate API keys"}],"."]}]}]]}]]}] 488:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Each Merchant API request must contain an authorization header in the following format:"}],"\n","$L57a","\n",["$","p","p-1",{"children":"To use this API, you need to generate API keys from your Revolut Business account. The Secret key is used in the authorization header for all server calls, while the Public key is provided with payment methods at checkout."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For detailed instructions on generating your API keys, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/get-started#generate-api-keys","target":"_blank","rel":"noreferrer","children":"Generate API keys"}],"."]}]}]]}]]}] 490:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Each Merchant API request must contain an authorization header in the following format:"}],"\n","$L57b","\n",["$","p","p-1",{"children":"To use this API, you need to generate API keys from your Revolut Business account. The Secret key is used in the authorization header for all server calls, while the Public key is provided with payment methods at checkout."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For detailed instructions on generating your API keys, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/get-started#generate-api-keys","target":"_blank","rel":"noreferrer","children":"Generate API keys"}],"."]}]}]]}]]}] 495:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Each Merchant API request must contain an authorization header in the following format:"}],"\n","$L57c","\n",["$","p","p-1",{"children":"To use this API, you need to generate API keys from your Revolut Business account. The Secret key is used in the authorization header for all server calls, while the Public key is provided with payment methods at checkout."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For detailed instructions on generating your API keys, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/get-started#generate-api-keys","target":"_blank","rel":"noreferrer","children":"Generate API keys"}],"."]}]}]]}]]}] 471:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The reason for challenging the dispute."}]]}] 472:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Additional explanation or comment for the challenge, if needed."}]]}] 473:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"ID of a previously uploaded evidence file."}]]}] 474:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A list of IDs of previously uploaded evidence files to associate with this challenge."}],"\n",["$","div","inlinealert-0",{"data-type":"warning","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMark","color":"var(--rui-color-warning)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["Each evidence ID can only be used for ",["$","strong","strong-0",{"children":"a single challenge"}],". This means, that evidences already assigned to a challenge ",["$","strong","strong-1",{"children":"cannot be reused"}]," for other challenges."]}]}]]}]]}] 4a0:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Allows challenging a dispute with a reason, comment and associated evidences."}],"\n",["$","p","p-1",{"children":"Use the uploaded evidences to provide proof for the challenge."}],"\n",["$","p","p-2",{"children":"A dispute previously accepted, cannot be challenged."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["This endpoint is only available in ",["$","strong","strong-0",{"children":"Production"}]," environment."]}]}]]}]]}] 4a1:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["This parameter accepts the ",["$","a","a-0",{"href":"https://business.revolut.com/settings/apis?tab=merchant-api","target":"_blank","rel":"noreferrer","children":"Merchant API Secret key"}]," to authorise requests coming from the merchant's backend."]}],"\n",["$","p","p-1",{"children":["It ensures that ensures that each request is authenticated and authorised by verifying the secret key. The secret key should be included in all request headers as a ",["$","code","code-0",{"children":"Bearer"}]," token."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#authentication","target":"_blank","rel":"noreferrer","children":"Authentication"}]]}]}]]}]]}] 4a2:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The version of the Merchant API, specified in ",["$","code","code-0",{"children":"YYYY-MM-DD"}]," format."]}],"\n",["$","p","p-1",{"children":"If not specified, you will receive an error."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information about API versioning, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/reference/versioning/api-versions","target":"_blank","rel":"noreferrer","children":"API versions"}],"."]}]}]]}]]}] 4a3:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A UUID string, typically used to identify resources."}]]}] 4a4:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ID of the ",["$","code","code-0",{"children":"Dispute"}]," object."]}]]}] 4d8:"Update a webhook" 537:["$","$L89",null,{"responses":"$23:props:children:0:props:children:props:responses","headingAs":"h3"}] 57d:T796,
curl -X POST "https://merchant.revolut.com/api/customers" \
  -H "Content-Type: application/json" \
  -H "Authorization: __RP_TOK_0__" \
  -H "Revolut-Api-Version: __RP_TOK_1__" \
  -d '{
  "full_name": "Example Customer",
  "email": "example.customer@example.com",
  "phone": "+441234567890",
  "date_of_birth": "1990-01-01"
}'
57e:T11d7,
const payload = {
  "full_name": "Example Customer",
  "email": "example.customer@example.com",
  "phone": "+441234567890",
  "date_of_birth": "1990-01-01"
};
fetch("https://merchant.revolut.com/api/customers", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "__RP_TOK_0__",
    "Revolut-Api-Version": "__RP_TOK_1__"
  },
  body: JSON.stringify(payload)
})
  .then(response => response.json())
  .then(data => console.log(data));
57f:T177b,
package main

import (
  "fmt"
  "net/http"
  "bytes"
  "encoding/json"
)

func main() {
  url := "https://merchant.revolut.com/api/customers"
  jsonData := []byte(`
{
  "full_name": "Example Customer",
  "email": "example.customer@example.com",
  "phone": "+441234567890",
  "date_of_birth": "1990-01-01"
}
  `)
  req, _ := http.NewRequest("POST", url, bytes.NewBuffer(jsonData))
  req.Header.Add("Content-Type", "application/json")
  req.Header.Add("Authorization", "__RP_TOK_0__")
  req.Header.Add("Revolut-Api-Version", "__RP_TOK_1__")

  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  fmt.Println(res)
}
580:Tf0b,
import requests

url = "https://merchant.revolut.com/api/customers"
headers = {
  "Content-Type": "application/json",
  "Authorization": "__RP_TOK_0__",
  "Revolut-Api-Version": "__RP_TOK_1__"
}
payload = {
  "full_name": "Example Customer",
  "email": "example.customer@example.com",
  "phone": "+441234567890",
  "date_of_birth": "1990-01-01"
}

response = requests.post(url, headers=headers, json=payload)
print(response.json())
581:T1cdf,
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;

public class Main {
  public static void main(String[] args) {
    HttpClient client = HttpClient.newHttpClient();
    String body = """
{
  "full_name": "Example Customer",
  "email": "example.customer@example.com",
  "phone": "+441234567890",
  "date_of_birth": "1990-01-01"
}
    """;

    HttpRequest request = HttpRequest.newBuilder()
      .uri(URI.create("https://merchant.revolut.com/api/customers"))
      .header("Content-Type", "application/json")
      .header("Authorization", "__RP_TOK_0__")
      .header("Revolut-Api-Version", "__RP_TOK_1__")
      .POST(HttpRequest.BodyPublishers.ofString(body))
      .build();

    client.sendAsync(request, HttpResponse.BodyHandlers.ofString())
      .thenApply(HttpResponse::body)
      .thenAccept(System.out::println)
      .join();
  }
}
582:T236b,
using System.Net.Http;
using System.Net.Http.Headers;

var client = new HttpClient();
var request = new HttpRequestMessage
{
  Method = HttpMethod.Post,
  RequestUri = new Uri("https://merchant.revolut.com/api/customers"),
  Headers =
  {
    { "Authorization", "__RP_TOK_0__" },
    { "Revolut-Api-Version", "__RP_TOK_1__" },
  },
  Content = new StringContent(@"{
  ""full_name"": ""Example Customer"",
  ""email"": ""example.customer@example.com"",
  ""phone"": ""+441234567890"",
  ""date_of_birth"": ""1990-01-01""
}")
  {
    Headers =
    {
      ContentType = new MediaTypeHeaderValue("application/json")
    }
  }
};

using (var response = await client.SendAsync(request))
{
  response.EnsureSuccessStatusCode();
  var body = await response.Content.ReadAsStringAsync();
  Console.WriteLine(body);
}
583:T79e,
curl -X POST "https://sandbox-merchant.revolut.com/api/customers" \
  -H "Content-Type: application/json" \
  -H "Authorization: __RP_TOK_0__" \
  -H "Revolut-Api-Version: __RP_TOK_1__" \
  -d '{
  "full_name": "Example Customer",
  "email": "example.customer@example.com",
  "phone": "+441234567890",
  "date_of_birth": "1990-01-01"
}'
584:T11df,
const payload = {
  "full_name": "Example Customer",
  "email": "example.customer@example.com",
  "phone": "+441234567890",
  "date_of_birth": "1990-01-01"
};
fetch("https://sandbox-merchant.revolut.com/api/customers", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "__RP_TOK_0__",
    "Revolut-Api-Version": "__RP_TOK_1__"
  },
  body: JSON.stringify(payload)
})
  .then(response => response.json())
  .then(data => console.log(data));
585:T1783,
package main

import (
  "fmt"
  "net/http"
  "bytes"
  "encoding/json"
)

func main() {
  url := "https://sandbox-merchant.revolut.com/api/customers"
  jsonData := []byte(`
{
  "full_name": "Example Customer",
  "email": "example.customer@example.com",
  "phone": "+441234567890",
  "date_of_birth": "1990-01-01"
}
  `)
  req, _ := http.NewRequest("POST", url, bytes.NewBuffer(jsonData))
  req.Header.Add("Content-Type", "application/json")
  req.Header.Add("Authorization", "__RP_TOK_0__")
  req.Header.Add("Revolut-Api-Version", "__RP_TOK_1__")

  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  fmt.Println(res)
}
586:Tf13,
import requests

url = "https://sandbox-merchant.revolut.com/api/customers"
headers = {
  "Content-Type": "application/json",
  "Authorization": "__RP_TOK_0__",
  "Revolut-Api-Version": "__RP_TOK_1__"
}
payload = {
  "full_name": "Example Customer",
  "email": "example.customer@example.com",
  "phone": "+441234567890",
  "date_of_birth": "1990-01-01"
}

response = requests.post(url, headers=headers, json=payload)
print(response.json())
587:T1ce7,
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;

public class Main {
  public static void main(String[] args) {
    HttpClient client = HttpClient.newHttpClient();
    String body = """
{
  "full_name": "Example Customer",
  "email": "example.customer@example.com",
  "phone": "+441234567890",
  "date_of_birth": "1990-01-01"
}
    """;

    HttpRequest request = HttpRequest.newBuilder()
      .uri(URI.create("https://sandbox-merchant.revolut.com/api/customers"))
      .header("Content-Type", "application/json")
      .header("Authorization", "__RP_TOK_0__")
      .header("Revolut-Api-Version", "__RP_TOK_1__")
      .POST(HttpRequest.BodyPublishers.ofString(body))
      .build();

    client.sendAsync(request, HttpResponse.BodyHandlers.ofString())
      .thenApply(HttpResponse::body)
      .thenAccept(System.out::println)
      .join();
  }
}
588:T2373,
using System.Net.Http;
using System.Net.Http.Headers;

var client = new HttpClient();
var request = new HttpRequestMessage
{
  Method = HttpMethod.Post,
  RequestUri = new Uri("https://sandbox-merchant.revolut.com/api/customers"),
  Headers =
  {
    { "Authorization", "__RP_TOK_0__" },
    { "Revolut-Api-Version", "__RP_TOK_1__" },
  },
  Content = new StringContent(@"{
  ""full_name"": ""Example Customer"",
  ""email"": ""example.customer@example.com"",
  ""phone"": ""+441234567890"",
  ""date_of_birth"": ""1990-01-01""
}")
  {
    Headers =
    {
      ContentType = new MediaTypeHeaderValue("application/json")
    }
  }
};

using (var response = await client.SendAsync(request))
{
  response.EnsureSuccessStatusCode();
  var body = await response.Content.ReadAsStringAsync();
  Console.WriteLine(body);
}
538:["$","div",null,{"className":"ezz1n32","children":[[["$","$L8a",null,{"itemsByServer":{"https://merchant.revolut.com":[{"id":"curl","label":"cURL","templateCode":"curl -X POST \"https://merchant.revolut.com/api/customers\" \\\n -H \"Content-Type: application/json\" \\\n -H \"Authorization: __RP_TOK_0__\" \\\n -H \"Revolut-Api-Version: __RP_TOK_1__\" \\\n -d '{\n \"full_name\": \"Example Customer\",\n \"email\": \"example.customer@example.com\",\n \"phone\": \"+441234567890\",\n \"date_of_birth\": \"1990-01-01\"\n}'","templateHtml":"$57d","tokens":[{"marker":"__RP_TOK_0__","paramName":"Authorization","paramIn":"header","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_1__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["shell-double-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16"}},{"id":"javascript","label":"JavaScript","templateCode":"const payload = {\n \"full_name\": \"Example Customer\",\n \"email\": \"example.customer@example.com\",\n \"phone\": \"+441234567890\",\n \"date_of_birth\": \"1990-01-01\"\n};\nfetch(\"https://merchant.revolut.com/api/customers\", {\n method: \"POST\",\n headers: {\n \"Content-Type\": \"application/json\",\n \"Authorization\": \"__RP_TOK_0__\",\n \"Revolut-Api-Version\": \"__RP_TOK_1__\"\n },\n body: JSON.stringify(payload)\n})\n .then(response => response.json())\n .then(data => console.log(data));","templateHtml":"$57e","tokens":[{"marker":"__RP_TOK_0__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16"}},{"id":"go","label":"Go","templateCode":"package main\n\nimport (\n \"fmt\"\n \"net/http\"\n \"bytes\"\n \"encoding/json\"\n)\n\nfunc main() {\n url := \"https://merchant.revolut.com/api/customers\"\n jsonData := []byte(`\n{\n \"full_name\": \"Example Customer\",\n \"email\": \"example.customer@example.com\",\n \"phone\": \"+441234567890\",\n \"date_of_birth\": \"1990-01-01\"\n}\n `)\n req, _ := http.NewRequest(\"POST\", url, bytes.NewBuffer(jsonData))\n req.Header.Add(\"Content-Type\", \"application/json\")\n req.Header.Add(\"Authorization\", \"__RP_TOK_0__\")\n req.Header.Add(\"Revolut-Api-Version\", \"__RP_TOK_1__\")\n\n res, _ := http.DefaultClient.Do(req)\n defer res.Body.Close()\n fmt.Println(res)\n}","templateHtml":"$57f","tokens":[{"marker":"__RP_TOK_0__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16"}},{"id":"python","label":"Python","templateCode":"import requests\n\nurl = \"https://merchant.revolut.com/api/customers\"\nheaders = {\n \"Content-Type\": \"application/json\",\n \"Authorization\": \"__RP_TOK_0__\",\n \"Revolut-Api-Version\": \"__RP_TOK_1__\"\n}\npayload = {\n \"full_name\": \"Example Customer\",\n \"email\": \"example.customer@example.com\",\n \"phone\": \"+441234567890\",\n \"date_of_birth\": \"1990-01-01\"\n}\n\nresponse = requests.post(url, headers=headers, json=payload)\nprint(response.json())","templateHtml":"$580","tokens":[{"marker":"__RP_TOK_0__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16"}},{"id":"java","label":"Java","templateCode":"import java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\nimport java.net.URI;\n\npublic class Main {\n public static void main(String[] args) {\n HttpClient client = HttpClient.newHttpClient();\n String body = \"\"\"\n{\n \"full_name\": \"Example Customer\",\n \"email\": \"example.customer@example.com\",\n \"phone\": \"+441234567890\",\n \"date_of_birth\": \"1990-01-01\"\n}\n \"\"\";\n\n HttpRequest request = HttpRequest.newBuilder()\n .uri(URI.create(\"https://merchant.revolut.com/api/customers\"))\n .header(\"Content-Type\", \"application/json\")\n .header(\"Authorization\", \"__RP_TOK_0__\")\n .header(\"Revolut-Api-Version\", \"__RP_TOK_1__\")\n .POST(HttpRequest.BodyPublishers.ofString(body))\n .build();\n\n client.sendAsync(request, HttpResponse.BodyHandlers.ofString())\n .thenApply(HttpResponse::body)\n .thenAccept(System.out::println)\n .join();\n }\n}","templateHtml":"$581","tokens":[{"marker":"__RP_TOK_0__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16"}},{"id":"csharp","label":"C#","templateCode":"using System.Net.Http;\nusing System.Net.Http.Headers;\n\nvar client = new HttpClient();\nvar request = new HttpRequestMessage\n{\n Method = HttpMethod.Post,\n RequestUri = new Uri(\"https://merchant.revolut.com/api/customers\"),\n Headers =\n {\n { \"Authorization\", \"__RP_TOK_0__\" },\n { \"Revolut-Api-Version\", \"__RP_TOK_1__\" },\n },\n Content = new StringContent(@\"{\n \"\"full_name\"\": \"\"Example Customer\"\",\n \"\"email\"\": \"\"example.customer@example.com\"\",\n \"\"phone\"\": \"\"+441234567890\"\",\n \"\"date_of_birth\"\": \"\"1990-01-01\"\"\n}\")\n {\n Headers =\n {\n ContentType = new MediaTypeHeaderValue(\"application/json\")\n }\n }\n};\n\nusing (var response = await client.SendAsync(request))\n{\n response.EnsureSuccessStatusCode();\n var body = await response.Content.ReadAsStringAsync();\n Console.WriteLine(body);\n}","templateHtml":"$582","tokens":[{"marker":"__RP_TOK_0__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16"}}],"https://sandbox-merchant.revolut.com":[{"id":"curl","label":"cURL","templateCode":"curl -X POST \"https://sandbox-merchant.revolut.com/api/customers\" \\\n -H \"Content-Type: application/json\" \\\n -H \"Authorization: __RP_TOK_0__\" \\\n -H \"Revolut-Api-Version: __RP_TOK_1__\" \\\n -d '{\n \"full_name\": \"Example Customer\",\n \"email\": \"example.customer@example.com\",\n \"phone\": \"+441234567890\",\n \"date_of_birth\": \"1990-01-01\"\n}'","templateHtml":"$583","tokens":[{"marker":"__RP_TOK_0__","paramName":"Authorization","paramIn":"header","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_1__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["shell-double-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16"}},{"id":"javascript","label":"JavaScript","templateCode":"const payload = {\n \"full_name\": \"Example Customer\",\n \"email\": \"example.customer@example.com\",\n \"phone\": \"+441234567890\",\n \"date_of_birth\": \"1990-01-01\"\n};\nfetch(\"https://sandbox-merchant.revolut.com/api/customers\", {\n method: \"POST\",\n headers: {\n \"Content-Type\": \"application/json\",\n \"Authorization\": \"__RP_TOK_0__\",\n \"Revolut-Api-Version\": \"__RP_TOK_1__\"\n },\n body: JSON.stringify(payload)\n})\n .then(response => response.json())\n .then(data => console.log(data));","templateHtml":"$584","tokens":[{"marker":"__RP_TOK_0__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16"}},{"id":"go","label":"Go","templateCode":"package main\n\nimport (\n \"fmt\"\n \"net/http\"\n \"bytes\"\n \"encoding/json\"\n)\n\nfunc main() {\n url := \"https://sandbox-merchant.revolut.com/api/customers\"\n jsonData := []byte(`\n{\n \"full_name\": \"Example Customer\",\n \"email\": \"example.customer@example.com\",\n \"phone\": \"+441234567890\",\n \"date_of_birth\": \"1990-01-01\"\n}\n `)\n req, _ := http.NewRequest(\"POST\", url, bytes.NewBuffer(jsonData))\n req.Header.Add(\"Content-Type\", \"application/json\")\n req.Header.Add(\"Authorization\", \"__RP_TOK_0__\")\n req.Header.Add(\"Revolut-Api-Version\", \"__RP_TOK_1__\")\n\n res, _ := http.DefaultClient.Do(req)\n defer res.Body.Close()\n fmt.Println(res)\n}","templateHtml":"$585","tokens":[{"marker":"__RP_TOK_0__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16"}},{"id":"python","label":"Python","templateCode":"import requests\n\nurl = \"https://sandbox-merchant.revolut.com/api/customers\"\nheaders = {\n \"Content-Type\": \"application/json\",\n \"Authorization\": \"__RP_TOK_0__\",\n \"Revolut-Api-Version\": \"__RP_TOK_1__\"\n}\npayload = {\n \"full_name\": \"Example Customer\",\n \"email\": \"example.customer@example.com\",\n \"phone\": \"+441234567890\",\n \"date_of_birth\": \"1990-01-01\"\n}\n\nresponse = requests.post(url, headers=headers, json=payload)\nprint(response.json())","templateHtml":"$586","tokens":[{"marker":"__RP_TOK_0__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16"}},{"id":"java","label":"Java","templateCode":"import java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\nimport java.net.URI;\n\npublic class Main {\n public static void main(String[] args) {\n HttpClient client = HttpClient.newHttpClient();\n String body = \"\"\"\n{\n \"full_name\": \"Example Customer\",\n \"email\": \"example.customer@example.com\",\n \"phone\": \"+441234567890\",\n \"date_of_birth\": \"1990-01-01\"\n}\n \"\"\";\n\n HttpRequest request = HttpRequest.newBuilder()\n .uri(URI.create(\"https://sandbox-merchant.revolut.com/api/customers\"))\n .header(\"Content-Type\", \"application/json\")\n .header(\"Authorization\", \"__RP_TOK_0__\")\n .header(\"Revolut-Api-Version\", \"__RP_TOK_1__\")\n .POST(HttpRequest.BodyPublishers.ofString(body))\n .build();\n\n client.sendAsync(request, HttpResponse.BodyHandlers.ofString())\n .thenApply(HttpResponse::body)\n .thenAccept(System.out::println)\n .join();\n }\n}","templateHtml":"$587","tokens":[{"marker":"__RP_TOK_0__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16"}},{"id":"csharp","label":"C#","templateCode":"using System.Net.Http;\nusing System.Net.Http.Headers;\n\nvar client = new HttpClient();\nvar request = new HttpRequestMessage\n{\n Method = HttpMethod.Post,\n RequestUri = new Uri(\"https://sandbox-merchant.revolut.com/api/customers\"),\n Headers =\n {\n { \"Authorization\", \"__RP_TOK_0__\" },\n { \"Revolut-Api-Version\", \"__RP_TOK_1__\" },\n },\n Content = new StringContent(@\"{\n \"\"full_name\"\": \"\"Example Customer\"\",\n \"\"email\"\": \"\"example.customer@example.com\"\",\n \"\"phone\"\": \"\"+441234567890\"\",\n \"\"date_of_birth\"\": \"\"1990-01-01\"\"\n}\")\n {\n Headers =\n {\n ContentType = new MediaTypeHeaderValue(\"application/json\")\n }\n }\n};\n\nusing (var response = await client.SendAsync(request))\n{\n response.EnsureSuccessStatusCode();\n var body = await response.Content.ReadAsStringAsync();\n Console.WriteLine(body);\n}","templateHtml":"$588","tokens":[{"marker":"__RP_TOK_0__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16"}}]},"method":"post","servers":"$62:props:children:0:props:children:props:children:1:props:children:1:props:children:0:0:props:servers","path":"/api/customers","parameters":["$23:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:0","$23:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:1"]}],"$L589"],"$L58a","$L58b"]}] 557:["$","div",null,{"className":"ezz1n30","children":[["$","div",null,{"data-header":"$undefined","className":"ezz1n31","children":["$","div",null,{"className":"y9a0do1","children":[["$","h2",null,{"id":"retrieve-subscription-cycle","children":[["$L58c","$undefined"],["$","$L15",null,{"id":"retrieve-subscription-cycle"}]]}],["$","$L16",null,{"url":"/docs/api/merchant/2025-10-16/operations/retrieve-subscription-cycle.md"}]]}]}],"$undefined"]}] 594:T9eb,
fetch("https://merchant.revolut.com/api/subscriptions/__RP_TOK_0__/cycles/__RP_TOK_1__", {
  method: "GET",
  headers: {
    "Authorization": "__RP_TOK_2__",
    "Revolut-Api-Version": "__RP_TOK_3__"
  }
})
  .then(response => response.json())
  .then(data => console.log(data));
595:Tf88,
package main

import (
  "fmt"
  "net/http"
)

func main() {
  url := "https://merchant.revolut.com/api/subscriptions/__RP_TOK_0__/cycles/__RP_TOK_1__"
  req, _ := http.NewRequest("GET", url, nil)
  req.Header.Add("Authorization", "__RP_TOK_2__")
  req.Header.Add("Revolut-Api-Version", "__RP_TOK_3__")

  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  fmt.Println(res)
}
596:T7fd,
import requests

url = "https://merchant.revolut.com/api/subscriptions/__RP_TOK_0__/cycles/__RP_TOK_1__"
headers = {
  "Authorization": "__RP_TOK_2__",
  "Revolut-Api-Version": "__RP_TOK_3__"
}

response = requests.get(url, headers=headers)
print(response.json())
597:T1729,
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;

public class Main {
  public static void main(String[] args) {
    HttpClient client = HttpClient.newHttpClient();
    HttpRequest request = HttpRequest.newBuilder()
      .uri(URI.create("https://merchant.revolut.com/api/subscriptions/__RP_TOK_0__/cycles/__RP_TOK_1__"))
      .header("Authorization", "__RP_TOK_2__")
      .header("Revolut-Api-Version", "__RP_TOK_3__")
      .GET(HttpRequest.BodyPublishers.noBody())
      .build();

    client.sendAsync(request, HttpResponse.BodyHandlers.ofString())
      .thenApply(HttpResponse::body)
      .thenAccept(System.out::println)
      .join();
  }
}
598:T15d3,
using System.Net.Http;
using System.Net.Http.Headers;

var client = new HttpClient();
var request = new HttpRequestMessage
{
  Method = HttpMethod.Get,
  RequestUri = new Uri("https://merchant.revolut.com/api/subscriptions/__RP_TOK_0__/cycles/__RP_TOK_1__"),
  Headers =
  {
    { "Authorization", "__RP_TOK_2__" },
    { "Revolut-Api-Version", "__RP_TOK_3__" },
  }
};

using (var response = await client.SendAsync(request))
{
  response.EnsureSuccessStatusCode();
  var body = await response.Content.ReadAsStringAsync();
  Console.WriteLine(body);
}
599:T9f3,
fetch("https://sandbox-merchant.revolut.com/api/subscriptions/__RP_TOK_0__/cycles/__RP_TOK_1__", {
  method: "GET",
  headers: {
    "Authorization": "__RP_TOK_2__",
    "Revolut-Api-Version": "__RP_TOK_3__"
  }
})
  .then(response => response.json())
  .then(data => console.log(data));
59a:Tf90,
package main

import (
  "fmt"
  "net/http"
)

func main() {
  url := "https://sandbox-merchant.revolut.com/api/subscriptions/__RP_TOK_0__/cycles/__RP_TOK_1__"
  req, _ := http.NewRequest("GET", url, nil)
  req.Header.Add("Authorization", "__RP_TOK_2__")
  req.Header.Add("Revolut-Api-Version", "__RP_TOK_3__")

  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  fmt.Println(res)
}
59b:T805,
import requests

url = "https://sandbox-merchant.revolut.com/api/subscriptions/__RP_TOK_0__/cycles/__RP_TOK_1__"
headers = {
  "Authorization": "__RP_TOK_2__",
  "Revolut-Api-Version": "__RP_TOK_3__"
}

response = requests.get(url, headers=headers)
print(response.json())
59c:T1731,
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;

public class Main {
  public static void main(String[] args) {
    HttpClient client = HttpClient.newHttpClient();
    HttpRequest request = HttpRequest.newBuilder()
      .uri(URI.create("https://sandbox-merchant.revolut.com/api/subscriptions/__RP_TOK_0__/cycles/__RP_TOK_1__"))
      .header("Authorization", "__RP_TOK_2__")
      .header("Revolut-Api-Version", "__RP_TOK_3__")
      .GET(HttpRequest.BodyPublishers.noBody())
      .build();

    client.sendAsync(request, HttpResponse.BodyHandlers.ofString())
      .thenApply(HttpResponse::body)
      .thenAccept(System.out::println)
      .join();
  }
}
59d:T15db,
using System.Net.Http;
using System.Net.Http.Headers;

var client = new HttpClient();
var request = new HttpRequestMessage
{
  Method = HttpMethod.Get,
  RequestUri = new Uri("https://sandbox-merchant.revolut.com/api/subscriptions/__RP_TOK_0__/cycles/__RP_TOK_1__"),
  Headers =
  {
    { "Authorization", "__RP_TOK_2__" },
    { "Revolut-Api-Version", "__RP_TOK_3__" },
  }
};

using (var response = await client.SendAsync(request))
{
  response.EnsureSuccessStatusCode();
  var body = await response.Content.ReadAsStringAsync();
  Console.WriteLine(body);
}
558:["$","div",null,{"className":"ezz1n30","children":[["$","div",null,{"data-header":"$undefined","className":"ezz1n31","children":["$L58d",["$","$L85",null,{"parameters":[{"name":"Authorization","in":"header","schema":{"type":"string","format":"Bearer ","examples":"$62:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:0:schema:examples"},"required":true,"description":"This parameter accepts the [Merchant API Secret key](https://business.revolut.com/settings/apis?tab=merchant-api) to authorise requests coming from the merchant's backend. \n\nIt ensures that ensures that each request is authenticated and authorised by verifying the secret key. The secret key should be included in all request headers as a `Bearer` token.\n\n:::info\nFor more information, see: [Authentication](https://developer.revolut.com/docs/api/merchant#authentication)\n:::","descriptionNode":"$L58e"},{"name":"Revolut-Api-Version","in":"header","schema":{"type":"string","format":"date","enum":"$36:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:1:schema:enum","examples":"$36:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:1:schema:examples"},"required":true,"description":"The version of the Merchant API, specified in `YYYY-MM-DD` format.\n\nIf not specified, you will receive an error.\n\n\n:::info\nFor more information about API versioning, see: [API versions](https://developer.revolut.com/docs/guides/merchant/reference/versioning/api-versions).\n:::","x-config-always-visible-in-example":true,"example":"2025-10-16","descriptionNode":"$L58f"},{"name":"subscription_id","in":"path","schema":{"type":"string","format":"uuid","description":"A UUID string, typically used to identify resources.","descriptionNode":"$L590"},"required":true,"description":"The ID of the subscription.","descriptionNode":"$L591"},{"name":"cycle_id","in":"path","schema":{"type":"string","format":"uuid","description":"A UUID string, typically used to identify resources.","descriptionNode":"$L592"},"required":true,"description":"The ID of the subscription cycle.","descriptionNode":"$L593"}],"requestBody":"$undefined","heading":"Request","requestBodySchemaTitle":"Request body","headingAs":"h3"}],["$","$L89",null,{"responses":"$3a:props:children:0:props:children:props:responses","headingAs":"h3"}]]}],["$","div",null,{"className":"ezz1n32","children":[[["$","$L8a",null,{"itemsByServer":{"https://merchant.revolut.com":[{"id":"curl","label":"cURL","templateCode":"curl -X GET \"https://merchant.revolut.com/api/subscriptions/__RP_TOK_0__/cycles/__RP_TOK_1__\" \\\n -H \"Authorization: __RP_TOK_2__\" \\\n -H \"Revolut-Api-Version: __RP_TOK_3__\"","templateHtml":"
curl -X GET \"https://merchant.revolut.com/api/subscriptions/__RP_TOK_0__/cycles/__RP_TOK_1__\" \\\n  -H \"Authorization: __RP_TOK_2__\" \\\n  -H \"Revolut-Api-Version: __RP_TOK_3__\"
","tokens":[{"marker":"__RP_TOK_0__","paramName":"subscription_id","paramIn":"path","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_1__","paramName":"cycle_id","paramIn":"path","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_2__","paramName":"Authorization","paramIn":"header","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_3__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["shell-double-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:subscription_id":"123e4567-e89b-12d3-a456-426614174000","path:cycle_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"javascript","label":"JavaScript","templateCode":"fetch(\"https://merchant.revolut.com/api/subscriptions/__RP_TOK_0__/cycles/__RP_TOK_1__\", {\n method: \"GET\",\n headers: {\n \"Authorization\": \"__RP_TOK_2__\",\n \"Revolut-Api-Version\": \"__RP_TOK_3__\"\n }\n})\n .then(response => response.json())\n .then(data => console.log(data));","templateHtml":"$594","tokens":[{"marker":"__RP_TOK_0__","paramName":"subscription_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"cycle_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_3__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:subscription_id":"123e4567-e89b-12d3-a456-426614174000","path:cycle_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"go","label":"Go","templateCode":"package main\n\nimport (\n \"fmt\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://merchant.revolut.com/api/subscriptions/__RP_TOK_0__/cycles/__RP_TOK_1__\"\n req, _ := http.NewRequest(\"GET\", url, nil)\n req.Header.Add(\"Authorization\", \"__RP_TOK_2__\")\n req.Header.Add(\"Revolut-Api-Version\", \"__RP_TOK_3__\")\n\n res, _ := http.DefaultClient.Do(req)\n defer res.Body.Close()\n fmt.Println(res)\n}","templateHtml":"$595","tokens":[{"marker":"__RP_TOK_0__","paramName":"subscription_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"cycle_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_3__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:subscription_id":"123e4567-e89b-12d3-a456-426614174000","path:cycle_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"python","label":"Python","templateCode":"import requests\n\nurl = \"https://merchant.revolut.com/api/subscriptions/__RP_TOK_0__/cycles/__RP_TOK_1__\"\nheaders = {\n \"Authorization\": \"__RP_TOK_2__\",\n \"Revolut-Api-Version\": \"__RP_TOK_3__\"\n}\n\nresponse = requests.get(url, headers=headers)\nprint(response.json())","templateHtml":"$596","tokens":[{"marker":"__RP_TOK_0__","paramName":"subscription_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"cycle_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_3__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:subscription_id":"123e4567-e89b-12d3-a456-426614174000","path:cycle_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"java","label":"Java","templateCode":"import java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\nimport java.net.URI;\n\npublic class Main {\n public static void main(String[] args) {\n HttpClient client = HttpClient.newHttpClient();\n HttpRequest request = HttpRequest.newBuilder()\n .uri(URI.create(\"https://merchant.revolut.com/api/subscriptions/__RP_TOK_0__/cycles/__RP_TOK_1__\"))\n .header(\"Authorization\", \"__RP_TOK_2__\")\n .header(\"Revolut-Api-Version\", \"__RP_TOK_3__\")\n .GET(HttpRequest.BodyPublishers.noBody())\n .build();\n\n client.sendAsync(request, HttpResponse.BodyHandlers.ofString())\n .thenApply(HttpResponse::body)\n .thenAccept(System.out::println)\n .join();\n }\n}","templateHtml":"$597","tokens":[{"marker":"__RP_TOK_0__","paramName":"subscription_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"cycle_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_3__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:subscription_id":"123e4567-e89b-12d3-a456-426614174000","path:cycle_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"csharp","label":"C#","templateCode":"using System.Net.Http;\nusing System.Net.Http.Headers;\n\nvar client = new HttpClient();\nvar request = new HttpRequestMessage\n{\n Method = HttpMethod.Get,\n RequestUri = new Uri(\"https://merchant.revolut.com/api/subscriptions/__RP_TOK_0__/cycles/__RP_TOK_1__\"),\n Headers =\n {\n { \"Authorization\", \"__RP_TOK_2__\" },\n { \"Revolut-Api-Version\", \"__RP_TOK_3__\" },\n }\n};\n\nusing (var response = await client.SendAsync(request))\n{\n response.EnsureSuccessStatusCode();\n var body = await response.Content.ReadAsStringAsync();\n Console.WriteLine(body);\n}","templateHtml":"$598","tokens":[{"marker":"__RP_TOK_0__","paramName":"subscription_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"cycle_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_3__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:subscription_id":"123e4567-e89b-12d3-a456-426614174000","path:cycle_id":"123e4567-e89b-12d3-a456-426614174000"}}],"https://sandbox-merchant.revolut.com":[{"id":"curl","label":"cURL","templateCode":"curl -X GET \"https://sandbox-merchant.revolut.com/api/subscriptions/__RP_TOK_0__/cycles/__RP_TOK_1__\" \\\n -H \"Authorization: __RP_TOK_2__\" \\\n -H \"Revolut-Api-Version: __RP_TOK_3__\"","templateHtml":"
curl -X GET \"https://sandbox-merchant.revolut.com/api/subscriptions/__RP_TOK_0__/cycles/__RP_TOK_1__\" \\\n  -H \"Authorization: __RP_TOK_2__\" \\\n  -H \"Revolut-Api-Version: __RP_TOK_3__\"
","tokens":[{"marker":"__RP_TOK_0__","paramName":"subscription_id","paramIn":"path","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_1__","paramName":"cycle_id","paramIn":"path","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_2__","paramName":"Authorization","paramIn":"header","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_3__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["shell-double-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:subscription_id":"123e4567-e89b-12d3-a456-426614174000","path:cycle_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"javascript","label":"JavaScript","templateCode":"fetch(\"https://sandbox-merchant.revolut.com/api/subscriptions/__RP_TOK_0__/cycles/__RP_TOK_1__\", {\n method: \"GET\",\n headers: {\n \"Authorization\": \"__RP_TOK_2__\",\n \"Revolut-Api-Version\": \"__RP_TOK_3__\"\n }\n})\n .then(response => response.json())\n .then(data => console.log(data));","templateHtml":"$599","tokens":[{"marker":"__RP_TOK_0__","paramName":"subscription_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"cycle_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_3__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:subscription_id":"123e4567-e89b-12d3-a456-426614174000","path:cycle_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"go","label":"Go","templateCode":"package main\n\nimport (\n \"fmt\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://sandbox-merchant.revolut.com/api/subscriptions/__RP_TOK_0__/cycles/__RP_TOK_1__\"\n req, _ := http.NewRequest(\"GET\", url, nil)\n req.Header.Add(\"Authorization\", \"__RP_TOK_2__\")\n req.Header.Add(\"Revolut-Api-Version\", \"__RP_TOK_3__\")\n\n res, _ := http.DefaultClient.Do(req)\n defer res.Body.Close()\n fmt.Println(res)\n}","templateHtml":"$59a","tokens":[{"marker":"__RP_TOK_0__","paramName":"subscription_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"cycle_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_3__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:subscription_id":"123e4567-e89b-12d3-a456-426614174000","path:cycle_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"python","label":"Python","templateCode":"import requests\n\nurl = \"https://sandbox-merchant.revolut.com/api/subscriptions/__RP_TOK_0__/cycles/__RP_TOK_1__\"\nheaders = {\n \"Authorization\": \"__RP_TOK_2__\",\n \"Revolut-Api-Version\": \"__RP_TOK_3__\"\n}\n\nresponse = requests.get(url, headers=headers)\nprint(response.json())","templateHtml":"$59b","tokens":[{"marker":"__RP_TOK_0__","paramName":"subscription_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"cycle_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_3__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:subscription_id":"123e4567-e89b-12d3-a456-426614174000","path:cycle_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"java","label":"Java","templateCode":"import java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\nimport java.net.URI;\n\npublic class Main {\n public static void main(String[] args) {\n HttpClient client = HttpClient.newHttpClient();\n HttpRequest request = HttpRequest.newBuilder()\n .uri(URI.create(\"https://sandbox-merchant.revolut.com/api/subscriptions/__RP_TOK_0__/cycles/__RP_TOK_1__\"))\n .header(\"Authorization\", \"__RP_TOK_2__\")\n .header(\"Revolut-Api-Version\", \"__RP_TOK_3__\")\n .GET(HttpRequest.BodyPublishers.noBody())\n .build();\n\n client.sendAsync(request, HttpResponse.BodyHandlers.ofString())\n .thenApply(HttpResponse::body)\n .thenAccept(System.out::println)\n .join();\n }\n}","templateHtml":"$59c","tokens":[{"marker":"__RP_TOK_0__","paramName":"subscription_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"cycle_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_3__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:subscription_id":"123e4567-e89b-12d3-a456-426614174000","path:cycle_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"csharp","label":"C#","templateCode":"using System.Net.Http;\nusing System.Net.Http.Headers;\n\nvar client = new HttpClient();\nvar request = new HttpRequestMessage\n{\n Method = HttpMethod.Get,\n RequestUri = new Uri(\"https://sandbox-merchant.revolut.com/api/subscriptions/__RP_TOK_0__/cycles/__RP_TOK_1__\"),\n Headers =\n {\n { \"Authorization\", \"__RP_TOK_2__\" },\n { \"Revolut-Api-Version\", \"__RP_TOK_3__\" },\n }\n};\n\nusing (var response = await client.SendAsync(request))\n{\n response.EnsureSuccessStatusCode();\n var body = await response.Content.ReadAsStringAsync();\n Console.WriteLine(body);\n}","templateHtml":"$59d","tokens":[{"marker":"__RP_TOK_0__","paramName":"subscription_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"cycle_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_3__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:subscription_id":"123e4567-e89b-12d3-a456-426614174000","path:cycle_id":"123e4567-e89b-12d3-a456-426614174000"}}]},"method":"get","servers":"$62:props:children:0:props:children:props:children:1:props:children:1:props:children:0:0:props:servers","path":"/api/subscriptions/{subscription_id}/cycles/{cycle_id}","parameters":["$558:props:children:0:props:children:1:props:parameters:0","$558:props:children:0:props:children:1:props:parameters:1","$558:props:children:0:props:children:1:props:parameters:2","$558:props:children:0:props:children:1:props:parameters:3"]}],"$L59e"],"$L59f","$L5a0"]}]]}] 573:["$","div",null,{"className":"ezz1n30","children":[["$","div",null,{"data-header":"$undefined","className":"ezz1n31","children":["$","div",null,{"className":"y9a0do1","children":[["$","h2",null,{"id":"retrieve-subscription-usage","children":[["$L5a1","$undefined"],["$","$L15",null,{"id":"retrieve-subscription-usage"}]]}],["$","$L16",null,{"url":"/docs/api/merchant/2025-10-16/operations/retrieve-subscription-usage.md"}]]}]}],"$undefined"]}] 5a7:T9dd,
fetch("https://merchant.revolut.com/api/subscription-usages/__RP_TOK_0__", {
  method: "GET",
  headers: {
    "Authorization": "__RP_TOK_1__",
    "Revolut-Api-Version": "__RP_TOK_2__"
  }
})
  .then(response => response.json())
  .then(data => console.log(data));
5a8:Tf7a,
package main

import (
  "fmt"
  "net/http"
)

func main() {
  url := "https://merchant.revolut.com/api/subscription-usages/__RP_TOK_0__"
  req, _ := http.NewRequest("GET", url, nil)
  req.Header.Add("Authorization", "__RP_TOK_1__")
  req.Header.Add("Revolut-Api-Version", "__RP_TOK_2__")

  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  fmt.Println(res)
}
5a9:T7ef,
import requests

url = "https://merchant.revolut.com/api/subscription-usages/__RP_TOK_0__"
headers = {
  "Authorization": "__RP_TOK_1__",
  "Revolut-Api-Version": "__RP_TOK_2__"
}

response = requests.get(url, headers=headers)
print(response.json())
5aa:T171b,
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;

public class Main {
  public static void main(String[] args) {
    HttpClient client = HttpClient.newHttpClient();
    HttpRequest request = HttpRequest.newBuilder()
      .uri(URI.create("https://merchant.revolut.com/api/subscription-usages/__RP_TOK_0__"))
      .header("Authorization", "__RP_TOK_1__")
      .header("Revolut-Api-Version", "__RP_TOK_2__")
      .GET(HttpRequest.BodyPublishers.noBody())
      .build();

    client.sendAsync(request, HttpResponse.BodyHandlers.ofString())
      .thenApply(HttpResponse::body)
      .thenAccept(System.out::println)
      .join();
  }
}
5ab:T15c5,
using System.Net.Http;
using System.Net.Http.Headers;

var client = new HttpClient();
var request = new HttpRequestMessage
{
  Method = HttpMethod.Get,
  RequestUri = new Uri("https://merchant.revolut.com/api/subscription-usages/__RP_TOK_0__"),
  Headers =
  {
    { "Authorization", "__RP_TOK_1__" },
    { "Revolut-Api-Version", "__RP_TOK_2__" },
  }
};

using (var response = await client.SendAsync(request))
{
  response.EnsureSuccessStatusCode();
  var body = await response.Content.ReadAsStringAsync();
  Console.WriteLine(body);
}
5ac:T9e5,
fetch("https://sandbox-merchant.revolut.com/api/subscription-usages/__RP_TOK_0__", {
  method: "GET",
  headers: {
    "Authorization": "__RP_TOK_1__",
    "Revolut-Api-Version": "__RP_TOK_2__"
  }
})
  .then(response => response.json())
  .then(data => console.log(data));
5ad:Tf82,
package main

import (
  "fmt"
  "net/http"
)

func main() {
  url := "https://sandbox-merchant.revolut.com/api/subscription-usages/__RP_TOK_0__"
  req, _ := http.NewRequest("GET", url, nil)
  req.Header.Add("Authorization", "__RP_TOK_1__")
  req.Header.Add("Revolut-Api-Version", "__RP_TOK_2__")

  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  fmt.Println(res)
}
5ae:T7f7,
import requests

url = "https://sandbox-merchant.revolut.com/api/subscription-usages/__RP_TOK_0__"
headers = {
  "Authorization": "__RP_TOK_1__",
  "Revolut-Api-Version": "__RP_TOK_2__"
}

response = requests.get(url, headers=headers)
print(response.json())
5af:T1723,
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;

public class Main {
  public static void main(String[] args) {
    HttpClient client = HttpClient.newHttpClient();
    HttpRequest request = HttpRequest.newBuilder()
      .uri(URI.create("https://sandbox-merchant.revolut.com/api/subscription-usages/__RP_TOK_0__"))
      .header("Authorization", "__RP_TOK_1__")
      .header("Revolut-Api-Version", "__RP_TOK_2__")
      .GET(HttpRequest.BodyPublishers.noBody())
      .build();

    client.sendAsync(request, HttpResponse.BodyHandlers.ofString())
      .thenApply(HttpResponse::body)
      .thenAccept(System.out::println)
      .join();
  }
}
5b0:T15cd,
using System.Net.Http;
using System.Net.Http.Headers;

var client = new HttpClient();
var request = new HttpRequestMessage
{
  Method = HttpMethod.Get,
  RequestUri = new Uri("https://sandbox-merchant.revolut.com/api/subscription-usages/__RP_TOK_0__"),
  Headers =
  {
    { "Authorization", "__RP_TOK_1__" },
    { "Revolut-Api-Version", "__RP_TOK_2__" },
  }
};

using (var response = await client.SendAsync(request))
{
  response.EnsureSuccessStatusCode();
  var body = await response.Content.ReadAsStringAsync();
  Console.WriteLine(body);
}
574:["$","div",null,{"className":"ezz1n30","children":[["$","div",null,{"data-header":"$undefined","className":"ezz1n31","children":["$L5a2",["$","$L85",null,{"parameters":[{"name":"Authorization","in":"header","schema":{"type":"string","format":"Bearer ","examples":"$62:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:0:schema:examples"},"required":true,"description":"This parameter accepts the [Merchant API Secret key](https://business.revolut.com/settings/apis?tab=merchant-api) to authorise requests coming from the merchant's backend. \n\nIt ensures that ensures that each request is authenticated and authorised by verifying the secret key. The secret key should be included in all request headers as a `Bearer` token.\n\n:::info\nFor more information, see: [Authentication](https://developer.revolut.com/docs/api/merchant#authentication)\n:::","descriptionNode":"$L5a3"},{"name":"Revolut-Api-Version","in":"header","schema":{"type":"string","format":"date","enum":"$36:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:1:schema:enum","examples":"$36:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:1:schema:examples"},"required":true,"description":"The version of the Merchant API, specified in `YYYY-MM-DD` format.\n\nIf not specified, you will receive an error.\n\n\n:::info\nFor more information about API versioning, see: [API versions](https://developer.revolut.com/docs/guides/merchant/reference/versioning/api-versions).\n:::","x-config-always-visible-in-example":true,"example":"2025-10-16","descriptionNode":"$L5a4"},{"name":"usage_id","in":"path","schema":{"type":"string","format":"uuid","description":"A UUID string, typically used to identify resources.","descriptionNode":"$L5a5"},"required":true,"description":"The ID of the usage record.","descriptionNode":"$L5a6"}],"requestBody":"$undefined","heading":"Request","requestBodySchemaTitle":"Request body","headingAs":"h3"}],["$","$L89",null,{"responses":"$3d:props:children:0:props:children:props:responses","headingAs":"h3"}]]}],["$","div",null,{"className":"ezz1n32","children":[[["$","$L8a",null,{"itemsByServer":{"https://merchant.revolut.com":[{"id":"curl","label":"cURL","templateCode":"curl -X GET \"https://merchant.revolut.com/api/subscription-usages/__RP_TOK_0__\" \\\n -H \"Authorization: __RP_TOK_1__\" \\\n -H \"Revolut-Api-Version: __RP_TOK_2__\"","templateHtml":"
curl -X GET \"https://merchant.revolut.com/api/subscription-usages/__RP_TOK_0__\" \\\n  -H \"Authorization: __RP_TOK_1__\" \\\n  -H \"Revolut-Api-Version: __RP_TOK_2__\"
","tokens":[{"marker":"__RP_TOK_0__","paramName":"usage_id","paramIn":"path","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["shell-double-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:usage_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"javascript","label":"JavaScript","templateCode":"fetch(\"https://merchant.revolut.com/api/subscription-usages/__RP_TOK_0__\", {\n method: \"GET\",\n headers: {\n \"Authorization\": \"__RP_TOK_1__\",\n \"Revolut-Api-Version\": \"__RP_TOK_2__\"\n }\n})\n .then(response => response.json())\n .then(data => console.log(data));","templateHtml":"$5a7","tokens":[{"marker":"__RP_TOK_0__","paramName":"usage_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:usage_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"go","label":"Go","templateCode":"package main\n\nimport (\n \"fmt\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://merchant.revolut.com/api/subscription-usages/__RP_TOK_0__\"\n req, _ := http.NewRequest(\"GET\", url, nil)\n req.Header.Add(\"Authorization\", \"__RP_TOK_1__\")\n req.Header.Add(\"Revolut-Api-Version\", \"__RP_TOK_2__\")\n\n res, _ := http.DefaultClient.Do(req)\n defer res.Body.Close()\n fmt.Println(res)\n}","templateHtml":"$5a8","tokens":[{"marker":"__RP_TOK_0__","paramName":"usage_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:usage_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"python","label":"Python","templateCode":"import requests\n\nurl = \"https://merchant.revolut.com/api/subscription-usages/__RP_TOK_0__\"\nheaders = {\n \"Authorization\": \"__RP_TOK_1__\",\n \"Revolut-Api-Version\": \"__RP_TOK_2__\"\n}\n\nresponse = requests.get(url, headers=headers)\nprint(response.json())","templateHtml":"$5a9","tokens":[{"marker":"__RP_TOK_0__","paramName":"usage_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:usage_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"java","label":"Java","templateCode":"import java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\nimport java.net.URI;\n\npublic class Main {\n public static void main(String[] args) {\n HttpClient client = HttpClient.newHttpClient();\n HttpRequest request = HttpRequest.newBuilder()\n .uri(URI.create(\"https://merchant.revolut.com/api/subscription-usages/__RP_TOK_0__\"))\n .header(\"Authorization\", \"__RP_TOK_1__\")\n .header(\"Revolut-Api-Version\", \"__RP_TOK_2__\")\n .GET(HttpRequest.BodyPublishers.noBody())\n .build();\n\n client.sendAsync(request, HttpResponse.BodyHandlers.ofString())\n .thenApply(HttpResponse::body)\n .thenAccept(System.out::println)\n .join();\n }\n}","templateHtml":"$5aa","tokens":[{"marker":"__RP_TOK_0__","paramName":"usage_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:usage_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"csharp","label":"C#","templateCode":"using System.Net.Http;\nusing System.Net.Http.Headers;\n\nvar client = new HttpClient();\nvar request = new HttpRequestMessage\n{\n Method = HttpMethod.Get,\n RequestUri = new Uri(\"https://merchant.revolut.com/api/subscription-usages/__RP_TOK_0__\"),\n Headers =\n {\n { \"Authorization\", \"__RP_TOK_1__\" },\n { \"Revolut-Api-Version\", \"__RP_TOK_2__\" },\n }\n};\n\nusing (var response = await client.SendAsync(request))\n{\n response.EnsureSuccessStatusCode();\n var body = await response.Content.ReadAsStringAsync();\n Console.WriteLine(body);\n}","templateHtml":"$5ab","tokens":[{"marker":"__RP_TOK_0__","paramName":"usage_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:usage_id":"123e4567-e89b-12d3-a456-426614174000"}}],"https://sandbox-merchant.revolut.com":[{"id":"curl","label":"cURL","templateCode":"curl -X GET \"https://sandbox-merchant.revolut.com/api/subscription-usages/__RP_TOK_0__\" \\\n -H \"Authorization: __RP_TOK_1__\" \\\n -H \"Revolut-Api-Version: __RP_TOK_2__\"","templateHtml":"
curl -X GET \"https://sandbox-merchant.revolut.com/api/subscription-usages/__RP_TOK_0__\" \\\n  -H \"Authorization: __RP_TOK_1__\" \\\n  -H \"Revolut-Api-Version: __RP_TOK_2__\"
","tokens":[{"marker":"__RP_TOK_0__","paramName":"usage_id","paramIn":"path","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["shell-double-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:usage_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"javascript","label":"JavaScript","templateCode":"fetch(\"https://sandbox-merchant.revolut.com/api/subscription-usages/__RP_TOK_0__\", {\n method: \"GET\",\n headers: {\n \"Authorization\": \"__RP_TOK_1__\",\n \"Revolut-Api-Version\": \"__RP_TOK_2__\"\n }\n})\n .then(response => response.json())\n .then(data => console.log(data));","templateHtml":"$5ac","tokens":[{"marker":"__RP_TOK_0__","paramName":"usage_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:usage_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"go","label":"Go","templateCode":"package main\n\nimport (\n \"fmt\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://sandbox-merchant.revolut.com/api/subscription-usages/__RP_TOK_0__\"\n req, _ := http.NewRequest(\"GET\", url, nil)\n req.Header.Add(\"Authorization\", \"__RP_TOK_1__\")\n req.Header.Add(\"Revolut-Api-Version\", \"__RP_TOK_2__\")\n\n res, _ := http.DefaultClient.Do(req)\n defer res.Body.Close()\n fmt.Println(res)\n}","templateHtml":"$5ad","tokens":[{"marker":"__RP_TOK_0__","paramName":"usage_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:usage_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"python","label":"Python","templateCode":"import requests\n\nurl = \"https://sandbox-merchant.revolut.com/api/subscription-usages/__RP_TOK_0__\"\nheaders = {\n \"Authorization\": \"__RP_TOK_1__\",\n \"Revolut-Api-Version\": \"__RP_TOK_2__\"\n}\n\nresponse = requests.get(url, headers=headers)\nprint(response.json())","templateHtml":"$5ae","tokens":[{"marker":"__RP_TOK_0__","paramName":"usage_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:usage_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"java","label":"Java","templateCode":"import java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\nimport java.net.URI;\n\npublic class Main {\n public static void main(String[] args) {\n HttpClient client = HttpClient.newHttpClient();\n HttpRequest request = HttpRequest.newBuilder()\n .uri(URI.create(\"https://sandbox-merchant.revolut.com/api/subscription-usages/__RP_TOK_0__\"))\n .header(\"Authorization\", \"__RP_TOK_1__\")\n .header(\"Revolut-Api-Version\", \"__RP_TOK_2__\")\n .GET(HttpRequest.BodyPublishers.noBody())\n .build();\n\n client.sendAsync(request, HttpResponse.BodyHandlers.ofString())\n .thenApply(HttpResponse::body)\n .thenAccept(System.out::println)\n .join();\n }\n}","templateHtml":"$5af","tokens":[{"marker":"__RP_TOK_0__","paramName":"usage_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:usage_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"csharp","label":"C#","templateCode":"using System.Net.Http;\nusing System.Net.Http.Headers;\n\nvar client = new HttpClient();\nvar request = new HttpRequestMessage\n{\n Method = HttpMethod.Get,\n RequestUri = new Uri(\"https://sandbox-merchant.revolut.com/api/subscription-usages/__RP_TOK_0__\"),\n Headers =\n {\n { \"Authorization\", \"__RP_TOK_1__\" },\n { \"Revolut-Api-Version\", \"__RP_TOK_2__\" },\n }\n};\n\nusing (var response = await client.SendAsync(request))\n{\n response.EnsureSuccessStatusCode();\n var body = await response.Content.ReadAsStringAsync();\n Console.WriteLine(body);\n}","templateHtml":"$5b0","tokens":[{"marker":"__RP_TOK_0__","paramName":"usage_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:usage_id":"123e4567-e89b-12d3-a456-426614174000"}}]},"method":"get","servers":"$62:props:children:0:props:children:props:children:1:props:children:1:props:children:0:0:props:servers","path":"/api/subscription-usages/{usage_id}","parameters":["$574:props:children:0:props:children:1:props:parameters:0","$574:props:children:0:props:children:1:props:parameters:1","$574:props:children:0:props:children:1:props:parameters:2"]}],"$L5b1"],"$L5b2","$L5b3"]}]]}] 268:["$","div","request-application/json-example_request",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"
{\n  \"domain\": \"revolut.com\"\n}
"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"domain\": \"revolut.com\"\n}"}]}]]}] 269:["$","div","400-application/json-error_message",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"
{\n  \"code\": \"validation\",\n  \"message\": \"Exactly one value must be supplied for client_id\"\n}
"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"code\": \"validation\",\n \"message\": \"Exactly one value must be supplied for client_id\"\n}"}]}]]}] 4b5:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Each Merchant API request must contain an authorization header in the following format:"}],"\n","$L5b4","\n",["$","p","p-1",{"children":"To use this API, you need to generate API keys from your Revolut Business account. The Secret key is used in the authorization header for all server calls, while the Public key is provided with payment methods at checkout."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For detailed instructions on generating your API keys, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/get-started#generate-api-keys","target":"_blank","rel":"noreferrer","children":"Generate API keys"}],"."]}]}]]}]]}] 4bd:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The ID of the webhook."}]]}] 4be:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Your webhook's URL to which event notifications will be sent."}],"\n",["$","p","p-1",{"children":["Must be a valid HTTP or HTTPS URL, capable of receiving ",["$","code","code-0",{"children":"POST"}]," requests."]}],"\n",["$","div","inlinealert-0",{"data-type":"warning","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMark","color":"var(--rui-color-warning)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"Restrictions:"}],["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["Must be a valid URI as defined by ",["$","a","a-0",{"href":"https://datatracker.ietf.org/doc/html/rfc3986","target":"_blank","rel":"noreferrer","children":"RFC 3986"}]]}],"\n",["$","li","li-1",{"children":["URI scheme is required and must be either ",["$","code","code-0",{"children":"http"}]," or ",["$","code","code-1",{"children":"https"}]]}],"\n",["$","li","li-2",{"children":["URI host is required and cannot be ",["$","code","code-0",{"children":"localhost"}]," or an IP address"]}],"\n",["$","li","li-3",{"children":["Max length: ",["$","code","code-0",{"children":"2000"}]]}],"\n",["$","li","li-4",{"children":["Reserved or invalid characters must be percent-encoded (for example, use ",["$","code","code-0",{"children":"%20"}]," instead of a space)"]}],"\n"]}]]}]]}]]}] 4c0:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The available event types your can listen to."}]]}] 4c1:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"List of event types that the webhook is configured to listen to."}],"\n",["$","p","p-1",{"children":"Each event is related to status changes of a specific object in the Merchant API:"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Object","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Event types","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"Order"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["$","ul","ul-0",{"children":[" ",["$","li","li-0",{"children":["$","code","code-0",{"children":"ORDER_COMPLETED"}]}]," ",["$","li","li-1",{"children":["$","code","code-0",{"children":"ORDER_AUTHORISED"}]}]," ",["$","li","li-2",{"children":["$","code","code-0",{"children":"ORDER_CANCELLED"}]}]," ",["$","li","li-3",{"children":["$","code","code-0",{"children":"ORDER_FAILED"}]}]," ",["$","li","li-4",{"children":["$","code","code-0",{"children":"ORDER_INCREMENTAL_AUTHORISATION_AUTHORISED"}]}]," ",["$","li","li-5",{"children":["$","code","code-0",{"children":"ORDER_INCREMENTAL_AUTHORISATION_DECLINED"}]}]," ",["$","li","li-6",{"children":["$","code","code-0",{"children":"ORDER_INCREMENTAL_AUTHORISATION_FAILED"}]}]," "]}],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"Payment"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["$","ul","ul-0",{"children":[" ",["$","li","li-0",{"children":["$","code","code-0",{"children":"ORDER_PAYMENT_AUTHENTICATION_CHALLENGED"}]}]," ",["$","li","li-1",{"children":["$","code","code-0",{"children":"ORDER_PAYMENT_AUTHENTICATED"}]}]," ",["$","li","li-2",{"children":["$","code","code-0",{"children":"ORDER_PAYMENT_AUTHORISATION_STARTED"}]}]," ",["$","li","li-3",{"children":["$","code","code-0",{"children":"ORDER_PAYMENT_DECLINED"}]}]," ",["$","li","li-4",{"children":["$","code","code-0",{"children":"ORDER_PAYMENT_FAILED"}]}]," "]}],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"Subscription"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["$","ul","ul-0",{"children":[" ",["$","li","li-0",{"children":["$","code","code-0",{"children":"SUBSCRIPTION_INITIATED"}]}]," ",["$","li","li-1",{"children":["$","code","code-0",{"children":"SUBSCRIPTION_FINISHED"}]}]," ",["$","li","li-2",{"children":["$","code","code-0",{"children":"SUBSCRIPTION_CANCELLED"}]}]," ",["$","li","li-3",{"children":["$","code","code-0",{"children":"SUBSCRIPTION_OVERDUE"}]}]]}],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"Payout"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["$","ul","ul-0",{"children":[" ",["$","li","li-0",{"children":["$","code","code-0",{"children":"PAYOUT_INITIATED"}]}]," ",["$","li","li-1",{"children":["$","code","code-0",{"children":"PAYOUT_COMPLETED"}]}]," ",["$","li","li-2",{"children":["$","code","code-0",{"children":"PAYOUT_FAILED"}]}]," "]}],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-4",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"Dispute"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["$","ul","ul-0",{"children":[" ",["$","li","li-0",{"children":["$","code","code-0",{"children":"DISPUTE_ACTION_REQUIRED"}]}]," ",["$","li","li-1",{"children":["$","code","code-0",{"children":"DISPUTE_UNDER_REVIEW"}]}]," ",["$","li","li-2",{"children":["$","code","code-0",{"children":"DISPUTE_WON"}]}]," ",["$","li","li-3",{"children":["$","code","code-0",{"children":"DISPUTE_LOST"}]}]]}],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 4c2:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The signing secret for the webhook. Use it to verify the signature for the webhook request's payload."}]]}] 4c3:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A webhook object."}],"\n",["$","p","p-1",{"children":["Unlike the legacy API, ",["$","code","code-0",{"children":"signing_secret"}]," is included in all webhook responses, not only on creation."]}]]}] 4c4:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"OK"}]]}] 4c5:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An identifier that can be used to determine what went wrong."}],"\n",["$","p","p-1",{"children":"Error codes are not globally unique, but uniqueness is guaranteed within endpoints."}]]}] 4c6:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Some human readable text describing what went wrong."}]]}] 4c7:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://www.unixtimestamp.com/","target":"_blank","rel":"noreferrer","children":"UNIX timestamp"}]," of the date and time the error happened."]}]]}] 4c8:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Bad Request"}]]}] 504:"Register address validation endpoint for Fast checkout" 589:["$","$L10d",null,{"security":[{"Api-Key":[]}],"authorization":{"Api-Key":{"type":"apiKey","in":"header","name":"Authorization","description":"Each Merchant API request must contain an authorization header in the following format:\n\n```\n'Authorization: Bearer '\n```\n\nTo use this API, you need to generate API keys from your Revolut Business account. The Secret key is used in the authorization header for all server calls, while the Public key is provided with payment methods at checkout.\n\n:::info\nFor detailed instructions on generating your API keys, see: [Generate API keys](https://developer.revolut.com/docs/guides/merchant/get-started#generate-api-keys).\n:::","descriptionNode":"$L5b5"}}}] 58a:["$","$L10f",null,{"exampleBlocks":{"application/json":{"variants":[{"key":"example_customer_creation","label":"Create a customer","rawValue":"$23:props:children:0:props:children:props:requestBody:content:application/json:examples:example_customer_creation:value","block":"$L5b6"}],"syncedPropertyName":"$undefined"}},"title":"Request body samples","headingAs":"h4"}] 58b:["$","$L110",null,{"exampleBlocks":{"201":{"application/json":{"variants":[{"key":"created_customer","label":"Customer","rawValue":"$23:props:children:0:props:children:props:responses:201:content:application/json:examples:created_customer:value","block":"$L5b7"}],"syncedPropertyName":"$undefined"}},"400":{"application/json":{"variants":[{"key":"default","label":"Example","rawValue":{"code":"string","message":"string","timestamp":123},"block":"$L5b8"}],"syncedPropertyName":"$undefined"}},"401":{"application/json":{"variants":[{"key":"default","label":"Example","rawValue":{"code":"string","message":"string","timestamp":123},"block":"$L5b9"}],"syncedPropertyName":"$undefined"}}},"headingAs":"h4"}] 59e:["$","$L10d",null,{"security":[{"Api-Key":[]}],"authorization":{"Api-Key":{"type":"apiKey","in":"header","name":"Authorization","description":"Each Merchant API request must contain an authorization header in the following format:\n\n```\n'Authorization: Bearer '\n```\n\nTo use this API, you need to generate API keys from your Revolut Business account. The Secret key is used in the authorization header for all server calls, while the Public key is provided with payment methods at checkout.\n\n:::info\nFor detailed instructions on generating your API keys, see: [Generate API keys](https://developer.revolut.com/docs/guides/merchant/get-started#generate-api-keys).\n:::","descriptionNode":"$L5ba"}}}] 59f:["$","$L10f",null,{"exampleBlocks":{},"title":"Request body samples","headingAs":"h4"}] 5a0:["$","$L110",null,{"exampleBlocks":{"200":{"application/json":{"variants":[{"key":"finished_cycle","label":"Finished subscription cycle","rawValue":"$3a:props:children:0:props:children:props:responses:200:content:application/json:examples:finished_cycle:value","block":"$L5bb"}],"syncedPropertyName":"$undefined"}},"400":{"application/json":{"variants":[{"key":"default","label":"Example","rawValue":{"code":"string","message":"string","timestamp":123},"block":"$L5bc"}],"syncedPropertyName":"$undefined"}},"401":{"application/json":{"variants":[{"key":"default","label":"Example","rawValue":{"code":"string","message":"string","timestamp":123},"block":"$L5bd"}],"syncedPropertyName":"$undefined"}},"404":{"application/json":{"variants":[{"key":"default","label":"Example","rawValue":{"code":"string","message":"string","timestamp":123},"block":"$L5be"}],"syncedPropertyName":"$undefined"}},"default":{"application/json":{"variants":[{"key":"default","label":"Example","rawValue":{"code":"string","message":"string","timestamp":123},"block":"$L5bf"}],"syncedPropertyName":"$undefined"}}},"headingAs":"h4"}] 5b1:["$","$L10d",null,{"security":[{"Api-Key":[]}],"authorization":{"Api-Key":{"type":"apiKey","in":"header","name":"Authorization","description":"Each Merchant API request must contain an authorization header in the following format:\n\n```\n'Authorization: Bearer '\n```\n\nTo use this API, you need to generate API keys from your Revolut Business account. The Secret key is used in the authorization header for all server calls, while the Public key is provided with payment methods at checkout.\n\n:::info\nFor detailed instructions on generating your API keys, see: [Generate API keys](https://developer.revolut.com/docs/guides/merchant/get-started#generate-api-keys).\n:::","descriptionNode":"$L5c0"}}}] 5b2:["$","$L10f",null,{"exampleBlocks":{},"title":"Request body samples","headingAs":"h4"}] 5b3:["$","$L110",null,{"exampleBlocks":{"200":{"application/json":{"variants":[{"key":"usage_record","label":"Successful usage record creation","rawValue":"$3d:props:children:0:props:children:props:responses:200:content:application/json:examples:usage_record:value","block":"$L5c1"}],"syncedPropertyName":"$undefined"}},"400":{"application/json":{"variants":[{"key":"default","label":"Example","rawValue":{"code":"string","message":"string","timestamp":123},"block":"$L5c2"}],"syncedPropertyName":"$undefined"}},"401":{"application/json":{"variants":[{"key":"default","label":"Example","rawValue":{"code":"string","message":"string","timestamp":123},"block":"$L5c3"}],"syncedPropertyName":"$undefined"}},"404":{"application/json":{"variants":[{"key":"default","label":"Example","rawValue":{"code":"string","message":"string","timestamp":123},"block":"$L5c4"}],"syncedPropertyName":"$undefined"}},"default":{"application/json":{"variants":[{"key":"default","label":"Example","rawValue":{"code":"string","message":"string","timestamp":123},"block":"$L5c5"}],"syncedPropertyName":"$undefined"}}},"headingAs":"h4"}] 5c6:T1382,
[
  {
    "id": "f6abc4df-eb48-417c-8e75-f7c6d7ad394f",
    "signing_key": "swsk_y5z3LEHYZ9ndote3qegzWD6uL4t1lfp1",
    "url": "https://example.com/webhooks/validate-address",
    "event_type": "fast_checkout.validate_address"
  },
  {
    "id": "5c08dcc1-cd60-4b7d-a255-e42d24d7365c",
    "signing_key": "swsk_VsuFcq6FIpa9gOWUu0n2WxiCbsDHIJlN",
    "url": "https://groceries.example.com/webhooks/validate-address",
    "event_type": "fast_checkout.validate_address",
    "location_id": "b0ebede4-5cbc-4951-977f-70329faa8769"
  },
  {
    "id": "dbebe6f8-4c47-4176-a94f-576d76e1d0b6",
    "signing_key": "swsk_0TKYlzoakBgGGVvojCiRRqInMD1ufLZn",
    "url": "https://clothes.example.com/webhooks/validate-address",
    "event_type": "fast_checkout.validate_address",
    "location_id": "6ebd3d2b-7a51-42e4-84f4-3c513621edd3"
  }
]
2b7:["$","div","200-application/json-example_without_location",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$5c6"}}]}]],"$L5c7"]}] 2b8:["$","div","400-application/json-default",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"
{\n  \"errorId\": \"string\",\n  \"timestamp\": 123\n}
"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"errorId\": \"string\",\n \"timestamp\": 123\n}"}]}]]}] 2ba:["$","div","request-application/json-simple_plan",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"
{\n  \"renewal_date\": \"2026-07-01T00:00:00Z\"\n}
"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"renewal_date\": \"2026-07-01T00:00:00Z\"\n}"}]}]]}] 5c8:T44d,
{
  "code": "string",
  "message": "string",
  "timestamp": 123
}
2bb:["$","div","400-application/json-default",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$5c8"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"code\": \"string\",\n \"message\": \"string\",\n \"timestamp\": 123\n}"}]}]]}] 5c9:T44d,
{
  "code": "string",
  "message": "string",
  "timestamp": 123
}
2bc:["$","div","401-application/json-default",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$5c9"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"code\": \"string\",\n \"message\": \"string\",\n \"timestamp\": 123\n}"}]}]]}] 5ca:T44d,
{
  "code": "string",
  "message": "string",
  "timestamp": 123
}
2bd:["$","div","404-application/json-default",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$5ca"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"code\": \"string\",\n \"message\": \"string\",\n \"timestamp\": 123\n}"}]}]]}] 5cb:T47c,
{
  "code": "subscription_finished",
  "message": "The subscription is finished",
  "timestamp": 1601296792533
}
2be:["$","div","422-application/json-subscription_finished",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$5cb"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"code\": \"subscription_finished\",\n \"message\": \"The subscription is finished\",\n \"timestamp\": 1601296792533\n}"}]}]]}] 5cc:T4aa,
{
  "code": "subscription_cycle_next_cycle_exists",
  "message": "Cannot change cycle end date when next cycle already exists",
  "timestamp": 1601296792533
}
2bf:["$","div","422-application/json-next_cycle_exists",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$5cc"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"code\": \"subscription_cycle_next_cycle_exists\",\n \"message\": \"Cannot change cycle end date when next cycle already exists\",\n \"timestamp\": 1601296792533\n}"}]}]]}] 5cd:T489,
{
  "code": "subscription_cycle_end_date_too_early",
  "message": "The end date is too early",
  "timestamp": 1601296792533
}
2c0:["$","div","422-application/json-end_date_too_early",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$5cd"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"code\": \"subscription_cycle_end_date_too_early\",\n \"message\": \"The end date is too early\",\n \"timestamp\": 1601296792533\n}"}]}]]}] 5ce:T493,
{
  "code": "subscription_cycle_end_date_too_far",
  "message": "The end date is too far in the future",
  "timestamp": 1601296792533
}
2c1:["$","div","422-application/json-end_date_too_far",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$5ce"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"code\": \"subscription_cycle_end_date_too_far\",\n \"message\": \"The end date is too far in the future\",\n \"timestamp\": 1601296792533\n}"}]}]]}] 5cf:T44d,
{
  "code": "string",
  "message": "string",
  "timestamp": 123
}
2c2:["$","div","default-application/json-default",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$5cf"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"code\": \"string\",\n \"message\": \"string\",\n \"timestamp\": 123\n}"}]}]]}] 4c9:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An identifier that can be used to determine what went wrong."}],"\n",["$","p","p-1",{"children":"Error codes are not globally unique, but uniqueness is guaranteed within endpoints."}]]}] 4ca:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Some human readable text describing what went wrong."}]]}] 4cb:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://www.unixtimestamp.com/","target":"_blank","rel":"noreferrer","children":"UNIX timestamp"}]," of the date and time the error happened."]}]]}] 4cc:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unauthorized"}]]}] 4cd:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An identifier that can be used to determine what went wrong."}],"\n",["$","p","p-1",{"children":"Error codes are not globally unique, but uniqueness is guaranteed within endpoints."}]]}] 4ce:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Some human readable text describing what went wrong."}]]}] 4cf:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://www.unixtimestamp.com/","target":"_blank","rel":"noreferrer","children":"UNIX timestamp"}]," of the date and time the error happened."]}]]}] 4d0:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Not Found"}]]}] 4d1:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Your webhook's URL to which event notifications will be sent."}],"\n",["$","p","p-1",{"children":["Must be a valid HTTP or HTTPS URL, capable of receiving ",["$","code","code-0",{"children":"POST"}]," requests."]}],"\n",["$","div","inlinealert-0",{"data-type":"warning","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMark","color":"var(--rui-color-warning)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"Restrictions:"}],["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["Must be a valid URI as defined by ",["$","a","a-0",{"href":"https://datatracker.ietf.org/doc/html/rfc3986","target":"_blank","rel":"noreferrer","children":"RFC 3986"}]]}],"\n",["$","li","li-1",{"children":["URI scheme is required and must be either ",["$","code","code-0",{"children":"http"}]," or ",["$","code","code-1",{"children":"https"}]]}],"\n",["$","li","li-2",{"children":["URI host is required and cannot be ",["$","code","code-0",{"children":"localhost"}]," or an IP address"]}],"\n",["$","li","li-3",{"children":["Max length: ",["$","code","code-0",{"children":"2000"}]]}],"\n",["$","li","li-4",{"children":["Reserved or invalid characters must be percent-encoded (for example, use ",["$","code","code-0",{"children":"%20"}]," instead of a space)"]}],"\n"]}]]}]]}]]}] 4d3:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The available event types your can listen to."}]]}] 4d4:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"List of event types that the webhook is configured to listen to."}],"\n",["$","p","p-1",{"children":"Each event is related to status changes of a specific object in the Merchant API:"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Object","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Event types","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"Order"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["$","ul","ul-0",{"children":[" ",["$","li","li-0",{"children":["$","code","code-0",{"children":"ORDER_COMPLETED"}]}]," ",["$","li","li-1",{"children":["$","code","code-0",{"children":"ORDER_AUTHORISED"}]}]," ",["$","li","li-2",{"children":["$","code","code-0",{"children":"ORDER_CANCELLED"}]}]," ",["$","li","li-3",{"children":["$","code","code-0",{"children":"ORDER_FAILED"}]}]," ",["$","li","li-4",{"children":["$","code","code-0",{"children":"ORDER_INCREMENTAL_AUTHORISATION_AUTHORISED"}]}]," ",["$","li","li-5",{"children":["$","code","code-0",{"children":"ORDER_INCREMENTAL_AUTHORISATION_DECLINED"}]}]," ",["$","li","li-6",{"children":["$","code","code-0",{"children":"ORDER_INCREMENTAL_AUTHORISATION_FAILED"}]}]," "]}],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"Payment"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["$","ul","ul-0",{"children":[" ",["$","li","li-0",{"children":["$","code","code-0",{"children":"ORDER_PAYMENT_AUTHENTICATION_CHALLENGED"}]}]," ",["$","li","li-1",{"children":["$","code","code-0",{"children":"ORDER_PAYMENT_AUTHENTICATED"}]}]," ",["$","li","li-2",{"children":["$","code","code-0",{"children":"ORDER_PAYMENT_AUTHORISATION_STARTED"}]}]," ",["$","li","li-3",{"children":["$","code","code-0",{"children":"ORDER_PAYMENT_DECLINED"}]}]," ",["$","li","li-4",{"children":["$","code","code-0",{"children":"ORDER_PAYMENT_FAILED"}]}]," "]}],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"Subscription"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["$","ul","ul-0",{"children":[" ",["$","li","li-0",{"children":["$","code","code-0",{"children":"SUBSCRIPTION_INITIATED"}]}]," ",["$","li","li-1",{"children":["$","code","code-0",{"children":"SUBSCRIPTION_FINISHED"}]}]," ",["$","li","li-2",{"children":["$","code","code-0",{"children":"SUBSCRIPTION_CANCELLED"}]}]," ",["$","li","li-3",{"children":["$","code","code-0",{"children":"SUBSCRIPTION_OVERDUE"}]}]]}],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"Payout"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["$","ul","ul-0",{"children":[" ",["$","li","li-0",{"children":["$","code","code-0",{"children":"PAYOUT_INITIATED"}]}]," ",["$","li","li-1",{"children":["$","code","code-0",{"children":"PAYOUT_COMPLETED"}]}]," ",["$","li","li-2",{"children":["$","code","code-0",{"children":"PAYOUT_FAILED"}]}]," "]}],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-4",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"Dispute"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["$","ul","ul-0",{"children":[" ",["$","li","li-0",{"children":["$","code","code-0",{"children":"DISPUTE_ACTION_REQUIRED"}]}]," ",["$","li","li-1",{"children":["$","code","code-0",{"children":"DISPUTE_UNDER_REVIEW"}]}]," ",["$","li","li-2",{"children":["$","code","code-0",{"children":"DISPUTE_WON"}]}]," ",["$","li","li-3",{"children":["$","code","code-0",{"children":"DISPUTE_LOST"}]}]]}],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 4d5:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The request body for updating a webhook."}],"\n",["$","p","p-1",{"children":"All fields are optional. Only the fields provided in the request will be updated."}]]}] 4d9:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Update the URL or events for a specific webhook."}],"\n",["$","p","p-1",{"children":"All request body fields are optional. Only the fields provided will be updated."}]]}] 4da:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["This parameter accepts the ",["$","a","a-0",{"href":"https://business.revolut.com/settings/apis?tab=merchant-api","target":"_blank","rel":"noreferrer","children":"Merchant API Secret key"}]," to authorise requests coming from the merchant's backend."]}],"\n",["$","p","p-1",{"children":["It ensures that ensures that each request is authenticated and authorised by verifying the secret key. The secret key should be included in all request headers as a ",["$","code","code-0",{"children":"Bearer"}]," token."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#authentication","target":"_blank","rel":"noreferrer","children":"Authentication"}]]}]}]]}]]}] 4db:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The version of the Merchant API, specified in ",["$","code","code-0",{"children":"YYYY-MM-DD"}]," format."]}],"\n",["$","p","p-1",{"children":["This endpoint is available from version ",["$","code","code-0",{"children":"2024-09-01"}],". If a version earlier than ",["$","code","code-1",{"children":"2024-09-01"}]," is provided, the endpoint returns a ",["$","code","code-2",{"children":"404"}]," response."]}],"\n",["$","p","p-2",{"children":"If not specified, you will receive an error."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information about API versioning, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/reference/versioning/api-versions","target":"_blank","rel":"noreferrer","children":"API versions"}],"."]}]}]]}]]}] 4dc:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A UUID string, typically used to identify resources."}]]}] 4dd:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The ID of the webhook."}]]}] 533:"Create a customer" 5c7:["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"[\n {\n \"id\": \"f6abc4df-eb48-417c-8e75-f7c6d7ad394f\",\n \"signing_key\": \"swsk_y5z3LEHYZ9ndote3qegzWD6uL4t1lfp1\",\n \"url\": \"https://example.com/webhooks/validate-address\",\n \"event_type\": \"fast_checkout.validate_address\"\n },\n {\n \"id\": \"5c08dcc1-cd60-4b7d-a255-e42d24d7365c\",\n \"signing_key\": \"swsk_VsuFcq6FIpa9gOWUu0n2WxiCbsDHIJlN\",\n \"url\": \"https://groceries.example.com/webhooks/validate-address\",\n \"event_type\": \"fast_checkout.validate_address\",\n \"location_id\": \"b0ebede4-5cbc-4951-977f-70329faa8769\"\n },\n {\n \"id\": \"dbebe6f8-4c47-4176-a94f-576d76e1d0b6\",\n \"signing_key\": \"swsk_0TKYlzoakBgGGVvojCiRRqInMD1ufLZn\",\n \"url\": \"https://clothes.example.com/webhooks/validate-address\",\n \"event_type\": \"fast_checkout.validate_address\",\n \"location_id\": \"6ebd3d2b-7a51-42e4-84f4-3c513621edd3\"\n }\n]"}]}] 4ed:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The ID of the synchronous webhook object."}]]}] 4ee:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["A randomly generated signing key, which can be used by merchants to authenticate requests from Revolut by verifying the signature. For more information, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#authentication","target":"_blank","rel":"noreferrer","children":"Payload Signature"}],"."]}]]}] 4ef:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The valid URL of the endpoint, that uses HTTPS URL schema. Revolut sends the shipping address of the customer to this URL for validation."}],"\n",["$","div","inlinealert-0",{"data-type":"warning","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMark","color":"var(--rui-color-warning)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"Restrictions:"}],["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["Must be a valid URI as defined by ",["$","a","a-0",{"href":"https://datatracker.ietf.org/doc/html/rfc3986","target":"_blank","rel":"noreferrer","children":"RFC 3986"}]]}],"\n",["$","li","li-1",{"children":["URI scheme is required and must be ",["$","code","code-0",{"children":"https"}]]}],"\n",["$","li","li-2",{"children":["URI host is required and cannot be ",["$","code","code-0",{"children":"localhost"}]," or an IP address"]}],"\n",["$","li","li-3",{"children":["Max length: ",["$","code","code-0",{"children":"2000"}]]}],"\n",["$","li","li-4",{"children":["Reserved or invalid characters must be percent-encoded (for example, use ",["$","code","code-0",{"children":"%20"}]," instead of a space)"]}],"\n"]}]]}]]}]]}] 4f0:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Type of event this synchronous webhook is configured for."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":"At the moment, synchronous webhooks only support address validation events."}]}]]}]]}] 4f1:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unique ID representing the location where merchants sells products."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#tag-locations","target":"_blank","rel":"noreferrer","children":"Locations"}],"."]}]}]]}]]}] 4f2:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"OK"}]]}] 4f3:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The ID of the error. You can share this ID with Revolut support for troubleshooting."}]]}] 4f4:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The date and time the error happened."}]]}] 4f5:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Bad Request"}]]}] 4f6:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unauthorized"}]]}] 31a:["$","div","201-application/json-evidence_uploaded",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"
{\n  \"id\": \"121ac27c-b00a-44d0-9120-efeeec7c912d\"\n}
"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"id\": \"121ac27c-b00a-44d0-9120-efeeec7c912d\"\n}"}]}]]}] 5d0:T478,
{
  "code": "bad_request",
  "message": "Missing Revolut-Api-Version header",
  "timestamp": 1601296792533
}
31b:["$","div","400-application/json-default",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$5d0"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"code\": \"bad_request\",\n \"message\": \"Missing Revolut-Api-Version header\",\n \"timestamp\": 1601296792533\n}"}]}]]}] 5d1:T46f,
{
  "code": "unauthenticated",
  "message": "Authentication failed",
  "timestamp": 1721049596461
}
31c:["$","div","401-application/json-default",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$5d1"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"code\": \"unauthenticated\",\n \"message\": \"Authentication failed\",\n \"timestamp\": 1721049596461\n}"}]}]]}] 5d2:T478,
{
  "code": "not_found",
  "message": "The requested operation is forbidden",
  "timestamp": 1721050063886
}
31d:["$","div","403-application/json-default",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$5d2"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"code\": \"not_found\",\n \"message\": \"The requested operation is forbidden\",\n \"timestamp\": 1721050063886\n}"}]}]]}] 5d3:T477,
{
  "code": "not_found",
  "message": "The requested resource is not found",
  "timestamp": 1721050063886
}
31e:["$","div","404-application/json-default",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$5d3"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"code\": \"not_found\",\n \"message\": \"The requested resource is not found\",\n \"timestamp\": 1721050063886\n}"}]}]]}] 5d4:T44d,
{
  "code": "string",
  "message": "string",
  "timestamp": 123
}
31f:["$","div","422-application/json-default",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$5d4"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"code\": \"string\",\n \"message\": \"string\",\n \"timestamp\": 123\n}"}]}]]}] 5d5:T10d5,
{
  "webhooks": [
    {
      "id": "6fc8db62-6489-4470-a9e0-84b462fe3908",
      "url": "https://revolut.com/webhooks",
      "events": [
        "ORDER_COMPLETED"
      ]
    },
    {
      "id": "b466ab77-4932-4850-beb0-113bfc1166f8",
      "url": "https://business.revolut.com/webhooks",
      "events": [
        "ORDER_COMPLETED",
        "ORDER_AUTHORISED"
      ]
    },
    {
      "id": "c6b981f4-53b3-47d5-9b24-4f87af1160eb",
      "url": "https://example.com/webhooks",
      "events": [
        "ORDER_AUTHORISED",
        "ORDER_COMPLETED"
      ]
    }
  ]
}
321:["$","div","200-application/json-list_of_webhooks",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$5d5"}}]}]],"$L5d6"]}] 5d7:T44d,
{
  "code": "string",
  "message": "string",
  "timestamp": 123
}
322:["$","div","401-application/json-default",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$5d7"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"code\": \"string\",\n \"message\": \"string\",\n \"timestamp\": 123\n}"}]}]]}] 324:["$","div","request-application/json-example_request",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"
{\n  \"domain\": \"revolut.com\",\n  \"reason\": \"Unregister due to domain change.\"\n}
"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"domain\": \"revolut.com\",\n \"reason\": \"Unregister due to domain change.\"\n}"}]}]]}] 325:["$","div","400-application/json-error_message",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"
{\n  \"code\": \"validation\",\n  \"message\": \"Exactly one value must be supplied for client_id\"\n}
"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"code\": \"validation\",\n \"message\": \"Exactly one value must be supplied for client_id\"\n}"}]}]]}] 4fe:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Each Merchant API request must contain an authorization header in the following format:"}],"\n","$L5d8","\n",["$","p","p-1",{"children":"To use this API, you need to generate API keys from your Revolut Business account. The Secret key is used in the authorization header for all server calls, while the Public key is provided with payment methods at checkout."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For detailed instructions on generating your API keys, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/get-started#generate-api-keys","target":"_blank","rel":"noreferrer","children":"Generate API keys"}],"."]}]}]]}]]}] 4f7:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Type of event this synchronous webhook is configured for."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":"At the moment, synchronous webhooks only support address validation events."}]}]]}]]}] 4f8:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The valid URL of the endpoint, that uses HTTPS URL schema. Revolut sends the shipping address of the customer to this URL for validation."}],"\n",["$","div","inlinealert-0",{"data-type":"warning","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMark","color":"var(--rui-color-warning)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"Restrictions:"}],["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["Must be a valid URI as defined by ",["$","a","a-0",{"href":"https://datatracker.ietf.org/doc/html/rfc3986","target":"_blank","rel":"noreferrer","children":"RFC 3986"}]]}],"\n",["$","li","li-1",{"children":["URI scheme is required and must be ",["$","code","code-0",{"children":"https"}]]}],"\n",["$","li","li-2",{"children":["URI host is required and cannot be ",["$","code","code-0",{"children":"localhost"}]," or an IP address"]}],"\n",["$","li","li-3",{"children":["Max length: ",["$","code","code-0",{"children":"2000"}]]}],"\n",["$","li","li-4",{"children":["Reserved or invalid characters must be percent-encoded (for example, use ",["$","code","code-0",{"children":"%20"}]," instead of a space)"]}],"\n"]}]]}]]}]]}] 4f9:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unique ID representing the location where merchants sells products."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#tag-locations","target":"_blank","rel":"noreferrer","children":"Locations"}],"."]}]}]]}]]}] 4fa:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","code","code-0",{"children":"SynchronousWebhook"}]," object allows merchants to register endpoints on their backend for receiving predefined event types. Currently, only address validation events are available."]}],"\n",["$","p","p-1",{"children":"In addition, merchants can specify locations representing their online stores, enabling them to set up different webhooks for different stores."}]]}] 505:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["Use this endpoint to register a URL where Revolut can send shipping address(es) from a Revolut Pay customer for validation during the ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/optimise-checkout/fast-checkout","target":"_blank","rel":"noreferrer","children":"Fast checkout\nprocess"}],"."]}],"\n",["$","p","p-1",{"children":"Revolut Pay can support Fast checkout for delivering goods. Once your customer selects a shipping address, Revolut needs to validate if the merchant (or their shipping partner) delivers to the address provided. This is done by contacting the merchant's backend and asking for such validation and information."}],"\n",["$","p","p-2",{"children":"In order for your backend to support Fast checkout, you need to:"}],"\n",["$","ol","ol-0",{"children":["\n",["$","li","li-0",{"children":"Register an URL to handle address validation"}],"\n",["$","li","li-1",{"children":"Validate the shipping address sent to your backend"}],"\n",["$","li","li-2",{"children":"Respond with a JSON object containing the result of the validation"}],"\n"]}],"\n",["$","p","p-3",{"children":"Additionally, Revolut Pay can support multiple webhooks if you have multiple stores. For more information, see:"}],"\n",["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/optimise-checkout/fast-checkout#manage-multiple-stores-with-fast-checkout","target":"_blank","rel":"noreferrer","children":"Manage multiple stores with Fast checkout"}]}],"\n",["$","li","li-1",{"children":["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#tag-locations","target":"_blank","rel":"noreferrer","children":"Merchant API: Locations"}]}],"\n"]}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["To set up a webhook for tracking order completion, failure, error, etc. events, use the ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#tag-webhooks","target":"_blank","rel":"noreferrer","children":"Webhooks endpoints"}],"."]}]}]]}]]}] 506:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["This parameter accepts the ",["$","a","a-0",{"href":"https://business.revolut.com/settings/apis?tab=merchant-api","target":"_blank","rel":"noreferrer","children":"Merchant API Secret key"}]," to authorise requests coming from the merchant's backend."]}],"\n",["$","p","p-1",{"children":["It ensures that ensures that each request is authenticated and authorised by verifying the secret key. The secret key should be included in all request headers as a ",["$","code","code-0",{"children":"Bearer"}]," token."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#authentication","target":"_blank","rel":"noreferrer","children":"Authentication"}]]}]}]]}]]}] 5f8:I["98d563c3c055",[],"Checkbox",1] 5f9:I["8537fdff809d",[],"Expandable",1] 5d6:["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"webhooks\": [\n {\n \"id\": \"6fc8db62-6489-4470-a9e0-84b462fe3908\",\n \"url\": \"https://revolut.com/webhooks\",\n \"events\": [\n \"ORDER_COMPLETED\"\n ]\n },\n {\n \"id\": \"b466ab77-4932-4850-beb0-113bfc1166f8\",\n \"url\": \"https://business.revolut.com/webhooks\",\n \"events\": [\n \"ORDER_COMPLETED\",\n \"ORDER_AUTHORISED\"\n ]\n },\n {\n \"id\": \"c6b981f4-53b3-47d5-9b24-4f87af1160eb\",\n \"url\": \"https://example.com/webhooks\",\n \"events\": [\n \"ORDER_AUTHORISED\",\n \"ORDER_COMPLETED\"\n ]\n }\n ]\n}"}]}] 58c:"Retrieve a subscription cycle" 5a1:"Retrieve a subscription usage" 33e:["$","div","CodeBlock-0",{"className":"wzy01m0 _18b50nc0","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"
'Authorization: Bearer <yourSecretApiKey>'
"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"'Authorization: Bearer '\n"}]}]]}] 66:["$","$7a","create-payment-intent",{"children":[["$","section",null,{"className":"y9a0do0","data-variant":"endpoint","children":["$","$L7b",null,{"responses":{"201":{"description":"Payment intent created","content":{"application/json":{"schema":{"title":"Payment Intent","type":"object","description":"Represents a payment intent that has been pushed to a Revolut Terminal device.\n\nWhen the payment intent reaches `completed` state, it includes a `payment_id` that can be used to [retrieve the final payment status](https://developer.revolut.com/docs/api/merchant#retrieve-payment-details).","properties":{"id":{"title":"Payment Intent ID","type":"string","format":"uuid","description":"The unique identifier of the payment intent.","descriptionNode":"$L5d9"},"state":{"type":"string","description":"The current state of the payment intent.\n\n| State | Description |\n|-------|-------------|\n| `pending` | Payment intent created and sent to terminal, customer has not yet started interacting |\n| `processing` | Customer is actively interacting with the terminal (e.g., inserting card, entering PIN) |\n| `completed` | Payment authorization is complete, includes a `payment_id` in the response |\n| `cancelled` | Payment intent was cancelled (by system or customer) |\n| `failed` | Payment intent failed due to technical issues (timeout, terminal unavailable, network error) |","enum":"$67:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:state:enum","descriptionNode":"$L5da"},"terminal_id":{"title":"Terminal ID","type":"string","format":"uuid","description":"The unique identifier of the terminal.","descriptionNode":"$L5db"},"order_id":{"type":"string","format":"uuid","description":"Permanent order ID used to retrieve, capture, cancel, or refund an order after authorization.","descriptionNode":"$L5dc"},"payment_id":{"type":"string","format":"uuid","description":"The ID of the payment.","descriptionNode":"$L5dd"},"amount":{"title":"Payment Intent amount","type":"integer","description":"The payment amount expressed in minor currency units, according to the [ISO 4217 standard](https://en.wikipedia.org/wiki/ISO_4217). For example, `7034` in `EUR` corresponds to €70.34.\n\n:::info\nConversion between major and minor units varies by currency. For instance, `100` minor units equal £1.00 in `GBP`, whereas in `ISK` they represent 100 units. For more details, see the [ISO 4217 standard](https://en.wikipedia.org/wiki/ISO_4217).\n:::","descriptionNode":"$L5de"},"currency":{"type":"string","format":"ISO 4217","minLength":3,"maxLength":3,"description":"[ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) currency code in upper case.\n\n:::info\nFor more information about the supported currencies, see: [Help Center](https://help.revolut.com/business/help/merchant-accounts/payments/in-which-currencies-can-i-accept-payments/).\n:::","descriptionNode":"$L5df"},"created_at":{"type":"string","format":"date-time","description":"The date and time the payment intent was created.","descriptionNode":"$L5e0"},"updated_at":{"type":"string","format":"date-time","description":"The date and time the payment intent was last updated.","descriptionNode":"$L5e1"}},"required":"$67:props:children:0:props:children:props:responses:200:content:application/json:schema:required","descriptionNode":"$L5e2"},"examples":{"payment_intent_pending":{"summary":"Payment intent pending","value":"$67:props:children:0:props:children:props:responses:200:content:application/json:examples:payment_intent_pending:value"}}}},"descriptionNode":"$L5e3"},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"errorId":{"type":"string","description":"The ID of the error. You can share this ID with Revolut support for troubleshooting.","descriptionNode":"$L5e4"},"timestamp":{"type":"integer","description":"The date and time the error happened.","descriptionNode":"$L5e5"}},"required":"$62:props:children:0:props:children:props:responses:401:content:application/json:schema:required"}}},"descriptionNode":"$L5e6"},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"errorId":{"type":"string","description":"The ID of the error. You can share this ID with Revolut support for troubleshooting.","descriptionNode":"$L5e7"},"timestamp":{"type":"integer","description":"The date and time the error happened.","descriptionNode":"$L5e8"}},"required":"$62:props:children:0:props:children:props:responses:401:content:application/json:schema:required"}}},"descriptionNode":"$L5e9"},"404":{"description":"Not Found","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"errorId":{"type":"string","description":"The ID of the error. You can share this ID with Revolut support for troubleshooting.","descriptionNode":"$L5ea"},"timestamp":{"type":"integer","description":"The date and time the error happened.","descriptionNode":"$L5eb"}},"required":"$62:props:children:0:props:children:props:responses:401:content:application/json:schema:required"}}},"descriptionNode":"$L5ec"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"title":"Payment Intent creation","type":"object","description":"Request body for creating a payment intent to push to a terminal.","properties":{"amount":{"title":"Payment Intent amount","type":"integer","description":"The payment amount expressed in minor currency units, according to the [ISO 4217 standard](https://en.wikipedia.org/wiki/ISO_4217). For example, `7034` in `EUR` corresponds to €70.34.\n\n:::info\nConversion between major and minor units varies by currency. For instance, `100` minor units equal £1.00 in `GBP`, whereas in `ISK` they represent 100 units. For more details, see the [ISO 4217 standard](https://en.wikipedia.org/wiki/ISO_4217).\n:::","descriptionNode":"$L5ed"},"terminal_id":{"title":"Terminal ID","type":"string","format":"uuid","description":"The unique identifier of the terminal.","descriptionNode":"$L5ee"}},"required":["amount","terminal_id"],"descriptionNode":"$L5ef"},"examples":{"create_payment_intent":{"summary":"Create payment intent request example","value":{"amount":2500,"terminal_id":"0e53f673-7705-473a-a263-89a3e7647c3d"}}}}}},"variantLabels":[],"children":["$L5f0","$L5f1"]}]}],false]}] 319:["$","div","request-multipart/form-data-default",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"
{\n  \"file\": \"string\"\n}
"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"file\": \"string\"\n}"}]}]]}] 5f2:Tfa5,
[
  {
    "id": "a830020e-090c-4717-836d-37941a27ad12",
    "state": "completed",
    "created_at": "2024-02-27T00:16:39.079285Z",
    "destination_type": "current_pocket",
    "amount": 50000,
    "currency": "GBP"
  },
  {
    "id": "66ffee42-7c4a-a15c-9a47-5dc67150386f",
    "state": "processing",
    "created_at": "2024-02-26T17:16:39.079285Z",
    "destination_type": "external_beneficiary",
    "amount": 10000,
    "currency": "GBP"
  }
]
340:["$","div","201-application/json-default",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$5f2"}}]}]],"$L5f3"]}] 5f4:T46a,
{
  "code": "bad_request",
  "message": "Could not parse JSON",
  "timestamp": 1721049596461
}
341:["$","div","400-application/json-default",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$5f4"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"code\": \"bad_request\",\n \"message\": \"Could not parse JSON\",\n \"timestamp\": 1721049596461\n}"}]}]]}] 5f5:T46f,
{
  "code": "unauthenticated",
  "message": "Authentication failed",
  "timestamp": 1721049596461
}
342:["$","div","401-application/json-default",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$5f5"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"code\": \"unauthenticated\",\n \"message\": \"Authentication failed\",\n \"timestamp\": 1721049596461\n}"}]}]]}] 5f6:T44d,
{
  "code": "string",
  "message": "string",
  "timestamp": 123
}
343:["$","div","404-application/json-default",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$5f6"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"code\": \"string\",\n \"message\": \"string\",\n \"timestamp\": 123\n}"}]}]]}] 518:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Each Merchant API request must contain an authorization header in the following format:"}],"\n","$L5f7","\n",["$","p","p-1",{"children":"To use this API, you need to generate API keys from your Revolut Business account. The Secret key is used in the authorization header for all server calls, while the Public key is provided with payment methods at checkout."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For detailed instructions on generating your API keys, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/get-started#generate-api-keys","target":"_blank","rel":"noreferrer","children":"Generate API keys"}],"."]}]}]]}]]}] 51e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unique identifier for the customer."}]]}] 51f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The full name of the customer."}]]}] 520:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The email address of the customer."}]]}] 521:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The phone number of the customer in ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/E.164","target":"_blank","rel":"noreferrer","children":"E.164 format"}],"."]}]]}] 522:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The date and time the customer was created."}]]}] 523:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The date and time the customer was last updated."}]]}] 524:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A customer object."}]]}] 525:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Created"}]]}] 526:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An identifier that can be used to determine what went wrong."}],"\n",["$","p","p-1",{"children":"Error codes are not globally unique, but uniqueness is guaranteed within endpoints."}]]}] 527:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Some human readable text describing what went wrong."}]]}] 528:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://www.unixtimestamp.com/","target":"_blank","rel":"noreferrer","children":"UNIX timestamp"}]," of the date and time the error happened."]}]]}] 529:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Bad Request"}]]}] 52a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An identifier that can be used to determine what went wrong."}],"\n",["$","p","p-1",{"children":"Error codes are not globally unique, but uniqueness is guaranteed within endpoints."}]]}] 52b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Some human readable text describing what went wrong."}]]}] 52c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://www.unixtimestamp.com/","target":"_blank","rel":"noreferrer","children":"UNIX timestamp"}]," of the date and time the error happened."]}]]}] 52d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unauthorized"}]]}] 52e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The full name of the customer."}]]}] 52f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The email address of the customer."}]]}] 530:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The phone number of the customer in ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/E.164","target":"_blank","rel":"noreferrer","children":"E.164 format"}],"."]}]]}] 531:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The birth date of the customer."}]]}] 532:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The request body for creating a customer."}]]}] 534:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["Create a ",["$","code","code-0",{"children":"customer"}]," object."]}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],["$","div",null,{"className":"_25vm6y2","children":"No automatic deduplication"}],["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"The API does not prevent creating multiple customers with the same email address or phone number."}],["$","p","p-1",{"children":"This can be intentional, for example, to maintain separate customer records per storefront or brand under the same account."}],["$","p","p-2",{"children":["To avoid unintentional duplicates, search for existing customers by email or phone using the ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant/2024-09-01#retrieve-customer-list","target":"_blank","rel":"noreferrer","children":"List customers"}]," endpoint before creating a new one."]}]]}]]}],"\n",["$","h3","h3-0",{"children":"Save payment methods"}],"\n",["$","p","p-1",{"children":["If you wish to save a customer's payment details using any of the available payment methods on the Revolut Checkout Widget (",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/accept-payments/online-payments/revolut-pay/introduction","target":"_blank","rel":"noreferrer","children":"Revolut Pay"}],", ",["$","a","a-1",{"href":"https://developer.revolut.com/docs/guides/merchant/accept-payments/online-payments/card-payments/introduction","target":"_blank","rel":"noreferrer","children":"Card payments"}],"), you need to meet one of the following requirements:"]}],"\n",["$","ul","ul-0",{"className":"contains-task-list","children":["\n",["$","li","li-0",{"className":"task-list-item","children":[["$","$L5f8","input-0",{"wrapper":{"use":"span"},"type":"checkbox"}]," Have a customer object with ",["$","code","code-0",{"children":"email"}]," and assign it to the order by providing ",["$","code","code-1",{"children":"customer.id"}]]}],"\n",["$","li","li-1",{"className":"task-list-item","children":[["$","$L5f8","input-0",{"wrapper":{"use":"span"},"type":"checkbox"}]," Create a new customer with, at least, ",["$","code","code-0",{"children":"customer.email"}]," during ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant/2024-09-01#create-order","target":"_blank","rel":"noreferrer","children":"order creation"}]]}],"\n"]}],"\n",["$","p","p-2",{"children":["For more information, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/optimise-checkout/save-payment-methods/charge-saved-payment-method","target":"_blank","rel":"noreferrer","children":"Charge a customer's saved payment method"}],"."]}],"\n",["$","$L5f9","Expandable-0",{"title":"AFT processing requirements","children":["\n","\n",["$","p","p-0",{"children":["For merchants in the following industries, ",["$","code","code-0",{"children":"full_name"}]," and ",["$","code","code-1",{"children":"date_of_birth"}]," are required for Account Funding Transaction (AFT) processing:"]}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Industry","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Required fields","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":"Crypto","className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":[["$","code","code-0",{"children":"full_name"}],", ",["$","code","code-1",{"children":"date_of_birth"}]],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":"Financial Institutions","className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":[["$","code","code-0",{"children":"full_name"}],", ",["$","code","code-1",{"children":"date_of_birth"}]],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"$L5fa"],"className":"eowryt3","ref":"$undefined"}]]}]}],"\n"]}]]}] 5f0:["$","div",null,{"className":"ezz1n30","children":[["$","div",null,{"data-header":"$undefined","className":"ezz1n31","children":["$","div",null,{"className":"y9a0do1","children":[["$","h2",null,{"id":"create-payment-intent","children":[["$L5fb","$undefined"],["$","$L15",null,{"id":"create-payment-intent"}]]}],["$","$L16",null,{"url":"/docs/api/merchant/2025-10-16/operations/create-payment-intent.md"}]]}]}],"$undefined"]}] 601:T6cc,
curl -X POST "https://merchant.revolut.com/api/orders/__RP_TOK_0__/payment-intents" \
  -H "Content-Type: application/json" \
  -H "Authorization: __RP_TOK_1__" \
  -H "Revolut-Api-Version: __RP_TOK_2__" \
  -d '{
  "amount": 2500,
  "terminal_id": "0e53f673-7705-473a-a263-89a3e7647c3d"
}'
602:Tfbd,
const payload = {
  "amount": 2500,
  "terminal_id": "0e53f673-7705-473a-a263-89a3e7647c3d"
};
fetch("https://merchant.revolut.com/api/orders/__RP_TOK_0__/payment-intents", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "__RP_TOK_1__",
    "Revolut-Api-Version": "__RP_TOK_2__"
  },
  body: JSON.stringify(payload)
})
  .then(response => response.json())
  .then(data => console.log(data));
603:T16b1,
package main

import (
  "fmt"
  "net/http"
  "bytes"
  "encoding/json"
)

func main() {
  url := "https://merchant.revolut.com/api/orders/__RP_TOK_0__/payment-intents"
  jsonData := []byte(`
{
  "amount": 2500,
  "terminal_id": "0e53f673-7705-473a-a263-89a3e7647c3d"
}
  `)
  req, _ := http.NewRequest("POST", url, bytes.NewBuffer(jsonData))
  req.Header.Add("Content-Type", "application/json")
  req.Header.Add("Authorization", "__RP_TOK_1__")
  req.Header.Add("Revolut-Api-Version", "__RP_TOK_2__")

  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  fmt.Println(res)
}
604:Tcf1,
import requests

url = "https://merchant.revolut.com/api/orders/__RP_TOK_0__/payment-intents"
headers = {
  "Content-Type": "application/json",
  "Authorization": "__RP_TOK_1__",
  "Revolut-Api-Version": "__RP_TOK_2__"
}
payload = {
  "amount": 2500,
  "terminal_id": "0e53f673-7705-473a-a263-89a3e7647c3d"
}

response = requests.post(url, headers=headers, json=payload)
print(response.json())
605:T1c15,
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;

public class Main {
  public static void main(String[] args) {
    HttpClient client = HttpClient.newHttpClient();
    String body = """
{
  "amount": 2500,
  "terminal_id": "0e53f673-7705-473a-a263-89a3e7647c3d"
}
    """;

    HttpRequest request = HttpRequest.newBuilder()
      .uri(URI.create("https://merchant.revolut.com/api/orders/__RP_TOK_0__/payment-intents"))
      .header("Content-Type", "application/json")
      .header("Authorization", "__RP_TOK_1__")
      .header("Revolut-Api-Version", "__RP_TOK_2__")
      .POST(HttpRequest.BodyPublishers.ofString(body))
      .build();

    client.sendAsync(request, HttpResponse.BodyHandlers.ofString())
      .thenApply(HttpResponse::body)
      .thenAccept(System.out::println)
      .join();
  }
}
606:T1ea7,
using System.Net.Http;
using System.Net.Http.Headers;

var client = new HttpClient();
var request = new HttpRequestMessage
{
  Method = HttpMethod.Post,
  RequestUri = new Uri("https://merchant.revolut.com/api/orders/__RP_TOK_0__/payment-intents"),
  Headers =
  {
    { "Authorization", "__RP_TOK_1__" },
    { "Revolut-Api-Version", "__RP_TOK_2__" },
  },
  Content = new StringContent(@"{
  ""amount"": 2500,
  ""terminal_id"": ""0e53f673-7705-473a-a263-89a3e7647c3d""
}")
  {
    Headers =
    {
      ContentType = new MediaTypeHeaderValue("application/json")
    }
  }
};

using (var response = await client.SendAsync(request))
{
  response.EnsureSuccessStatusCode();
  var body = await response.Content.ReadAsStringAsync();
  Console.WriteLine(body);
}
607:T6d4,
curl -X POST "https://sandbox-merchant.revolut.com/api/orders/__RP_TOK_0__/payment-intents" \
  -H "Content-Type: application/json" \
  -H "Authorization: __RP_TOK_1__" \
  -H "Revolut-Api-Version: __RP_TOK_2__" \
  -d '{
  "amount": 2500,
  "terminal_id": "0e53f673-7705-473a-a263-89a3e7647c3d"
}'
608:Tfc5,
const payload = {
  "amount": 2500,
  "terminal_id": "0e53f673-7705-473a-a263-89a3e7647c3d"
};
fetch("https://sandbox-merchant.revolut.com/api/orders/__RP_TOK_0__/payment-intents", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "__RP_TOK_1__",
    "Revolut-Api-Version": "__RP_TOK_2__"
  },
  body: JSON.stringify(payload)
})
  .then(response => response.json())
  .then(data => console.log(data));
609:T16b9,
package main

import (
  "fmt"
  "net/http"
  "bytes"
  "encoding/json"
)

func main() {
  url := "https://sandbox-merchant.revolut.com/api/orders/__RP_TOK_0__/payment-intents"
  jsonData := []byte(`
{
  "amount": 2500,
  "terminal_id": "0e53f673-7705-473a-a263-89a3e7647c3d"
}
  `)
  req, _ := http.NewRequest("POST", url, bytes.NewBuffer(jsonData))
  req.Header.Add("Content-Type", "application/json")
  req.Header.Add("Authorization", "__RP_TOK_1__")
  req.Header.Add("Revolut-Api-Version", "__RP_TOK_2__")

  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  fmt.Println(res)
}
60a:Tcf9,
import requests

url = "https://sandbox-merchant.revolut.com/api/orders/__RP_TOK_0__/payment-intents"
headers = {
  "Content-Type": "application/json",
  "Authorization": "__RP_TOK_1__",
  "Revolut-Api-Version": "__RP_TOK_2__"
}
payload = {
  "amount": 2500,
  "terminal_id": "0e53f673-7705-473a-a263-89a3e7647c3d"
}

response = requests.post(url, headers=headers, json=payload)
print(response.json())
60b:T1c1d,
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;

public class Main {
  public static void main(String[] args) {
    HttpClient client = HttpClient.newHttpClient();
    String body = """
{
  "amount": 2500,
  "terminal_id": "0e53f673-7705-473a-a263-89a3e7647c3d"
}
    """;

    HttpRequest request = HttpRequest.newBuilder()
      .uri(URI.create("https://sandbox-merchant.revolut.com/api/orders/__RP_TOK_0__/payment-intents"))
      .header("Content-Type", "application/json")
      .header("Authorization", "__RP_TOK_1__")
      .header("Revolut-Api-Version", "__RP_TOK_2__")
      .POST(HttpRequest.BodyPublishers.ofString(body))
      .build();

    client.sendAsync(request, HttpResponse.BodyHandlers.ofString())
      .thenApply(HttpResponse::body)
      .thenAccept(System.out::println)
      .join();
  }
}
60c:T1eaf,
using System.Net.Http;
using System.Net.Http.Headers;

var client = new HttpClient();
var request = new HttpRequestMessage
{
  Method = HttpMethod.Post,
  RequestUri = new Uri("https://sandbox-merchant.revolut.com/api/orders/__RP_TOK_0__/payment-intents"),
  Headers =
  {
    { "Authorization", "__RP_TOK_1__" },
    { "Revolut-Api-Version", "__RP_TOK_2__" },
  },
  Content = new StringContent(@"{
  ""amount"": 2500,
  ""terminal_id"": ""0e53f673-7705-473a-a263-89a3e7647c3d""
}")
  {
    Headers =
    {
      ContentType = new MediaTypeHeaderValue("application/json")
    }
  }
};

using (var response = await client.SendAsync(request))
{
  response.EnsureSuccessStatusCode();
  var body = await response.Content.ReadAsStringAsync();
  Console.WriteLine(body);
}
5f1:["$","div",null,{"className":"ezz1n30","children":[["$","div",null,{"data-header":"$undefined","className":"ezz1n31","children":["$L5fc",["$","$L85",null,{"parameters":[{"name":"Authorization","in":"header","schema":{"type":"string","format":"Bearer ","examples":"$62:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:0:schema:examples"},"required":true,"description":"This parameter accepts the [Merchant API Secret key](https://business.revolut.com/settings/apis?tab=merchant-api) to authorise requests coming from the merchant's backend. \n\nIt ensures that ensures that each request is authenticated and authorised by verifying the secret key. The secret key should be included in all request headers as a `Bearer` token.\n\n:::info\nFor more information, see: [Authentication](https://developer.revolut.com/docs/api/merchant#authentication)\n:::","descriptionNode":"$L5fd"},{"name":"Revolut-Api-Version","in":"header","schema":{"type":"string","format":"date","enum":"$6b:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:1:schema:enum","examples":"$6b:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:1:schema:examples"},"description":"The version of the Merchant API, specified in `YYYY-MM-DD` format.\n\n:::info\nFor more information about API versioning, see: [API versions](https://developer.revolut.com/docs/guides/merchant/reference/versioning/api-versions).\n:::","x-config-always-visible-in-example":true,"descriptionNode":"$L5fe"},{"name":"order_id","in":"path","schema":{"type":"string","format":"uuid","description":"A UUID string, typically used to identify resources.","descriptionNode":"$L5ff"},"required":true,"description":"The ID of the `Order` object.","descriptionNode":"$L600"}],"requestBody":"$66:props:children:0:props:children:props:requestBody","heading":"Request","requestBodySchemaTitle":"Request body","headingAs":"h3"}],["$","$L89",null,{"responses":"$66:props:children:0:props:children:props:responses","headingAs":"h3"}]]}],["$","div",null,{"className":"ezz1n32","children":[[["$","$L8a",null,{"itemsByServer":{"https://merchant.revolut.com":[{"id":"curl","label":"cURL","templateCode":"curl -X POST \"https://merchant.revolut.com/api/orders/__RP_TOK_0__/payment-intents\" \\\n -H \"Content-Type: application/json\" \\\n -H \"Authorization: __RP_TOK_1__\" \\\n -H \"Revolut-Api-Version: __RP_TOK_2__\" \\\n -d '{\n \"amount\": 2500,\n \"terminal_id\": \"0e53f673-7705-473a-a263-89a3e7647c3d\"\n}'","templateHtml":"$601","tokens":[{"marker":"__RP_TOK_0__","paramName":"order_id","paramIn":"path","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["shell-double-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2023-09-01","path:order_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"javascript","label":"JavaScript","templateCode":"const payload = {\n \"amount\": 2500,\n \"terminal_id\": \"0e53f673-7705-473a-a263-89a3e7647c3d\"\n};\nfetch(\"https://merchant.revolut.com/api/orders/__RP_TOK_0__/payment-intents\", {\n method: \"POST\",\n headers: {\n \"Content-Type\": \"application/json\",\n \"Authorization\": \"__RP_TOK_1__\",\n \"Revolut-Api-Version\": \"__RP_TOK_2__\"\n },\n body: JSON.stringify(payload)\n})\n .then(response => response.json())\n .then(data => console.log(data));","templateHtml":"$602","tokens":[{"marker":"__RP_TOK_0__","paramName":"order_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2023-09-01","path:order_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"go","label":"Go","templateCode":"package main\n\nimport (\n \"fmt\"\n \"net/http\"\n \"bytes\"\n \"encoding/json\"\n)\n\nfunc main() {\n url := \"https://merchant.revolut.com/api/orders/__RP_TOK_0__/payment-intents\"\n jsonData := []byte(`\n{\n \"amount\": 2500,\n \"terminal_id\": \"0e53f673-7705-473a-a263-89a3e7647c3d\"\n}\n `)\n req, _ := http.NewRequest(\"POST\", url, bytes.NewBuffer(jsonData))\n req.Header.Add(\"Content-Type\", \"application/json\")\n req.Header.Add(\"Authorization\", \"__RP_TOK_1__\")\n req.Header.Add(\"Revolut-Api-Version\", \"__RP_TOK_2__\")\n\n res, _ := http.DefaultClient.Do(req)\n defer res.Body.Close()\n fmt.Println(res)\n}","templateHtml":"$603","tokens":[{"marker":"__RP_TOK_0__","paramName":"order_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2023-09-01","path:order_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"python","label":"Python","templateCode":"import requests\n\nurl = \"https://merchant.revolut.com/api/orders/__RP_TOK_0__/payment-intents\"\nheaders = {\n \"Content-Type\": \"application/json\",\n \"Authorization\": \"__RP_TOK_1__\",\n \"Revolut-Api-Version\": \"__RP_TOK_2__\"\n}\npayload = {\n \"amount\": 2500,\n \"terminal_id\": \"0e53f673-7705-473a-a263-89a3e7647c3d\"\n}\n\nresponse = requests.post(url, headers=headers, json=payload)\nprint(response.json())","templateHtml":"$604","tokens":[{"marker":"__RP_TOK_0__","paramName":"order_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2023-09-01","path:order_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"java","label":"Java","templateCode":"import java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\nimport java.net.URI;\n\npublic class Main {\n public static void main(String[] args) {\n HttpClient client = HttpClient.newHttpClient();\n String body = \"\"\"\n{\n \"amount\": 2500,\n \"terminal_id\": \"0e53f673-7705-473a-a263-89a3e7647c3d\"\n}\n \"\"\";\n\n HttpRequest request = HttpRequest.newBuilder()\n .uri(URI.create(\"https://merchant.revolut.com/api/orders/__RP_TOK_0__/payment-intents\"))\n .header(\"Content-Type\", \"application/json\")\n .header(\"Authorization\", \"__RP_TOK_1__\")\n .header(\"Revolut-Api-Version\", \"__RP_TOK_2__\")\n .POST(HttpRequest.BodyPublishers.ofString(body))\n .build();\n\n client.sendAsync(request, HttpResponse.BodyHandlers.ofString())\n .thenApply(HttpResponse::body)\n .thenAccept(System.out::println)\n .join();\n }\n}","templateHtml":"$605","tokens":[{"marker":"__RP_TOK_0__","paramName":"order_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2023-09-01","path:order_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"csharp","label":"C#","templateCode":"using System.Net.Http;\nusing System.Net.Http.Headers;\n\nvar client = new HttpClient();\nvar request = new HttpRequestMessage\n{\n Method = HttpMethod.Post,\n RequestUri = new Uri(\"https://merchant.revolut.com/api/orders/__RP_TOK_0__/payment-intents\"),\n Headers =\n {\n { \"Authorization\", \"__RP_TOK_1__\" },\n { \"Revolut-Api-Version\", \"__RP_TOK_2__\" },\n },\n Content = new StringContent(@\"{\n \"\"amount\"\": 2500,\n \"\"terminal_id\"\": \"\"0e53f673-7705-473a-a263-89a3e7647c3d\"\"\n}\")\n {\n Headers =\n {\n ContentType = new MediaTypeHeaderValue(\"application/json\")\n }\n }\n};\n\nusing (var response = await client.SendAsync(request))\n{\n response.EnsureSuccessStatusCode();\n var body = await response.Content.ReadAsStringAsync();\n Console.WriteLine(body);\n}","templateHtml":"$606","tokens":[{"marker":"__RP_TOK_0__","paramName":"order_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2023-09-01","path:order_id":"123e4567-e89b-12d3-a456-426614174000"}}],"https://sandbox-merchant.revolut.com":[{"id":"curl","label":"cURL","templateCode":"curl -X POST \"https://sandbox-merchant.revolut.com/api/orders/__RP_TOK_0__/payment-intents\" \\\n -H \"Content-Type: application/json\" \\\n -H \"Authorization: __RP_TOK_1__\" \\\n -H \"Revolut-Api-Version: __RP_TOK_2__\" \\\n -d '{\n \"amount\": 2500,\n \"terminal_id\": \"0e53f673-7705-473a-a263-89a3e7647c3d\"\n}'","templateHtml":"$607","tokens":[{"marker":"__RP_TOK_0__","paramName":"order_id","paramIn":"path","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["shell-double-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2023-09-01","path:order_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"javascript","label":"JavaScript","templateCode":"const payload = {\n \"amount\": 2500,\n \"terminal_id\": \"0e53f673-7705-473a-a263-89a3e7647c3d\"\n};\nfetch(\"https://sandbox-merchant.revolut.com/api/orders/__RP_TOK_0__/payment-intents\", {\n method: \"POST\",\n headers: {\n \"Content-Type\": \"application/json\",\n \"Authorization\": \"__RP_TOK_1__\",\n \"Revolut-Api-Version\": \"__RP_TOK_2__\"\n },\n body: JSON.stringify(payload)\n})\n .then(response => response.json())\n .then(data => console.log(data));","templateHtml":"$608","tokens":[{"marker":"__RP_TOK_0__","paramName":"order_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2023-09-01","path:order_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"go","label":"Go","templateCode":"package main\n\nimport (\n \"fmt\"\n \"net/http\"\n \"bytes\"\n \"encoding/json\"\n)\n\nfunc main() {\n url := \"https://sandbox-merchant.revolut.com/api/orders/__RP_TOK_0__/payment-intents\"\n jsonData := []byte(`\n{\n \"amount\": 2500,\n \"terminal_id\": \"0e53f673-7705-473a-a263-89a3e7647c3d\"\n}\n `)\n req, _ := http.NewRequest(\"POST\", url, bytes.NewBuffer(jsonData))\n req.Header.Add(\"Content-Type\", \"application/json\")\n req.Header.Add(\"Authorization\", \"__RP_TOK_1__\")\n req.Header.Add(\"Revolut-Api-Version\", \"__RP_TOK_2__\")\n\n res, _ := http.DefaultClient.Do(req)\n defer res.Body.Close()\n fmt.Println(res)\n}","templateHtml":"$609","tokens":[{"marker":"__RP_TOK_0__","paramName":"order_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2023-09-01","path:order_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"python","label":"Python","templateCode":"import requests\n\nurl = \"https://sandbox-merchant.revolut.com/api/orders/__RP_TOK_0__/payment-intents\"\nheaders = {\n \"Content-Type\": \"application/json\",\n \"Authorization\": \"__RP_TOK_1__\",\n \"Revolut-Api-Version\": \"__RP_TOK_2__\"\n}\npayload = {\n \"amount\": 2500,\n \"terminal_id\": \"0e53f673-7705-473a-a263-89a3e7647c3d\"\n}\n\nresponse = requests.post(url, headers=headers, json=payload)\nprint(response.json())","templateHtml":"$60a","tokens":[{"marker":"__RP_TOK_0__","paramName":"order_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2023-09-01","path:order_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"java","label":"Java","templateCode":"import java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\nimport java.net.URI;\n\npublic class Main {\n public static void main(String[] args) {\n HttpClient client = HttpClient.newHttpClient();\n String body = \"\"\"\n{\n \"amount\": 2500,\n \"terminal_id\": \"0e53f673-7705-473a-a263-89a3e7647c3d\"\n}\n \"\"\";\n\n HttpRequest request = HttpRequest.newBuilder()\n .uri(URI.create(\"https://sandbox-merchant.revolut.com/api/orders/__RP_TOK_0__/payment-intents\"))\n .header(\"Content-Type\", \"application/json\")\n .header(\"Authorization\", \"__RP_TOK_1__\")\n .header(\"Revolut-Api-Version\", \"__RP_TOK_2__\")\n .POST(HttpRequest.BodyPublishers.ofString(body))\n .build();\n\n client.sendAsync(request, HttpResponse.BodyHandlers.ofString())\n .thenApply(HttpResponse::body)\n .thenAccept(System.out::println)\n .join();\n }\n}","templateHtml":"$60b","tokens":[{"marker":"__RP_TOK_0__","paramName":"order_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2023-09-01","path:order_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"csharp","label":"C#","templateCode":"using System.Net.Http;\nusing System.Net.Http.Headers;\n\nvar client = new HttpClient();\nvar request = new HttpRequestMessage\n{\n Method = HttpMethod.Post,\n RequestUri = new Uri(\"https://sandbox-merchant.revolut.com/api/orders/__RP_TOK_0__/payment-intents\"),\n Headers =\n {\n { \"Authorization\", \"__RP_TOK_1__\" },\n { \"Revolut-Api-Version\", \"__RP_TOK_2__\" },\n },\n Content = new StringContent(@\"{\n \"\"amount\"\": 2500,\n \"\"terminal_id\"\": \"\"0e53f673-7705-473a-a263-89a3e7647c3d\"\"\n}\")\n {\n Headers =\n {\n ContentType = new MediaTypeHeaderValue(\"application/json\")\n }\n }\n};\n\nusing (var response = await client.SendAsync(request))\n{\n response.EnsureSuccessStatusCode();\n var body = await response.Content.ReadAsStringAsync();\n Console.WriteLine(body);\n}","templateHtml":"$60c","tokens":[{"marker":"__RP_TOK_0__","paramName":"order_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2023-09-01","path:order_id":"123e4567-e89b-12d3-a456-426614174000"}}]},"method":"post","servers":"$62:props:children:0:props:children:props:children:1:props:children:1:props:children:0:0:props:servers","path":"/api/orders/{order_id}/payment-intents","parameters":["$5f1:props:children:0:props:children:1:props:parameters:0","$5f1:props:children:0:props:children:1:props:parameters:1","$5f1:props:children:0:props:children:1:props:parameters:2"]}],"$L60d"],"$L60e","$L60f"]}]]}] 5f3:["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"[\n {\n \"id\": \"a830020e-090c-4717-836d-37941a27ad12\",\n \"state\": \"completed\",\n \"created_at\": \"2024-02-27T00:16:39.079285Z\",\n \"destination_type\": \"current_pocket\",\n \"amount\": 50000,\n \"currency\": \"GBP\"\n },\n {\n \"id\": \"66ffee42-7c4a-a15c-9a47-5dc67150386f\",\n \"state\": \"processing\",\n \"created_at\": \"2024-02-26T17:16:39.079285Z\",\n \"destination_type\": \"external_beneficiary\",\n \"amount\": 10000,\n \"currency\": \"GBP\"\n }\n]"}]}] 5fa:["$","tr","tr-2",{"children":[["$","td","td-0",{"children":"Stored Value / Wallets","className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":[["$","code","code-0",{"children":"full_name"}],", ",["$","code","code-1",{"children":"date_of_birth"}]],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}] 539:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unique identifier for the subscription cycle."}]]}] 53a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unique identifier for the subscription."}]]}] 53b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unique identifier for the subscription plan variation."}]]}] 53c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unique identifier for the subscription plan phase."}]]}] 53d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The sequential cycle number within the subscription."}],"\n",["$","p","p-1",{"children":["Starts at ",["$","code","code-0",{"children":"1"}]," for the first cycle and increments with each new billing cycle."]}]]}] 53e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The unique identifier of the previous billing cycle."}],"\n",["$","p","p-1",{"children":["This field is ",["$","code","code-0",{"children":"null"}]," for the first cycle in a subscription."]}]]}] 53f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The state of the subscription cycle."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"State","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"pending"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["The cycle has been created but has not yet started. A cycle can enter this state automatically when usage is reported for a future cycle via ",["$","code","code-0",{"children":"POST /api/subscription-usages"}],"."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"active"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The cycle is currently active and in progress.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"finished"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The cycle has completed.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 540:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The date and time the subscription cycle starts in ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_8601","target":"_blank","rel":"noreferrer","children":"ISO 8601"}]," format."]}]]}] 541:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The date and time the subscription cycle ends in ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_8601","target":"_blank","rel":"noreferrer","children":"ISO 8601"}]," format."]}]]}] 542:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The deadline for submitting or correcting usage records for this cycle, in ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_8601","target":"_blank","rel":"noreferrer","children":"ISO 8601"}]," format."]}],"\n",["$","p","p-1",{"children":["Set to 12 hours after the cycle's ",["$","code","code-0",{"children":"end_date"}]," by default. After this time, Revolut aggregates all reported usage records and creates the ",["$","code","code-1",{"children":"post_billing_order_id"}]," to initiate the charge."]}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":"Only present for cycles that include usage-based subscription items."}]}]]}]]}] 543:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Permanent order ID used to retrieve, capture, cancel, or refund an order after authorization."}]]}] 544:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ID of the order created after the cycle's ",["$","code","code-0",{"children":"usage_cutoff_date"}]," to charge usage-based items accumulated during the cycle."]}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Scenario","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Detail","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":"Ongoing subscription","className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["This order also acts as the next cycle's ",["$","code","code-0",{"children":"order_id"}],", combining usage post-billing for the current cycle with pre-billing for the next."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":"Last cycle","className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"A standalone finishing order is created to charge all usage from this cycle.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":"Subscription ended with unpaid cycles","className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The finishing order consolidates all outstanding usage charges, including any from previous cycles where payment failed.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":"Only present for cycles that include usage-based subscription items."}]}]]}]]}] 559:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The unique identifier of the usage record."}]]}] 55a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unique identifier for the subscription."}]]}] 55b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unique identifier for the subscription cycle."}]]}] 55c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["A merchant-defined identifier for a usage-based subscription item. You set this code on each usage item when creating a subscription plan, and supply it when reporting consumption on ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#create-subscription-usage","target":"_blank","rel":"noreferrer","children":"Create a subscription usage endpoint"}]," to target the correct metered item."]}],"\n",["$","p","p-1",{"children":["This allows a subscription with multiple usage items (e.g., ",["$","code","code-0",{"children":"api_calls"}]," and ",["$","code","code-1",{"children":"storage_gb"}],") to receive consumption reports against the right item without relying on internal IDs."]}],"\n",["$","p","p-2",{"children":"The code must be unique within a plan phase."}]]}] 55d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The timestamp indicating when the consumption actually occurred."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Constraint","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Detail","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":"Format","className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":[["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_8601","target":"_blank","rel":"noreferrer","children":"ISO 8601"}]," date-time string (e.g., ",["$","code","code-0",{"children":"YYYY-MM-DDTHH:mm:ssZ"}],")."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":"Timezone","className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Must be UTC.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":"Validation","className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["Revolut uses this to identify the applicable billing cycle. Accepted for the active cycle (",["$","code","code-0",{"children":"start_date ≤ usage_date < end_date"}],"), for a recently ended cycle before its ",["$","code","code-1",{"children":"usage_cutoff_date"}],", and for the one next upcoming cycle. Other dates are rejected."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 55e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The quantity of consumption to record for this usage report."}],"\n",["$","p","p-1",{"children":"Supports up to 20 digits before and 20 digits after the decimal point."}]]}] 55f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Key-value pairs you can attach to a usage record for your own tracking and reporting purposes."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Constraint","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Detail","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":"Keys","className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Maximum 50 keys per record.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":"Value types","className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"String, number, or boolean only.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":"Number precision","className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Up to 20 digits before and 20 digits after the decimal point.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 560:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The date and time the usage record was created in ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_8601","target":"_blank","rel":"noreferrer","children":"ISO 8601"}]," format."]}]]}] 561:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The date and time the usage record was last updated in ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_8601","target":"_blank","rel":"noreferrer","children":"ISO 8601"}]," format."]}]]}] 35c:["$","div","CodeBlock-0",{"className":"wzy01m0 _18b50nc0","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"
'Authorization: Bearer <yourSecretApiKey>'
"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"'Authorization: Bearer '\n"}]}]]}] 535:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["This parameter accepts the ",["$","a","a-0",{"href":"https://business.revolut.com/settings/apis?tab=merchant-api","target":"_blank","rel":"noreferrer","children":"Merchant API Secret key"}]," to authorise requests coming from the merchant's backend."]}],"\n",["$","p","p-1",{"children":["It ensures that ensures that each request is authenticated and authorised by verifying the secret key. The secret key should be included in all request headers as a ",["$","code","code-0",{"children":"Bearer"}]," token."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#authentication","target":"_blank","rel":"noreferrer","children":"Authentication"}]]}]}]]}]]}] 536:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The version of the Merchant API, specified in ",["$","code","code-0",{"children":"YYYY-MM-DD"}]," format."]}],"\n",["$","p","p-1",{"children":["This endpoint is available from version ",["$","code","code-0",{"children":"2024-09-01"}],". If a version earlier than ",["$","code","code-1",{"children":"2024-09-01"}]," is provided, the endpoint returns a ",["$","code","code-2",{"children":"404"}]," response."]}],"\n",["$","p","p-2",{"children":"If not specified, you will receive an error."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information about API versioning, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/reference/versioning/api-versions","target":"_blank","rel":"noreferrer","children":"API versions"}],"."]}]}]]}]]}] 60d:["$","$L10d",null,{"security":[{"Api-Key":[]}],"authorization":{"Api-Key":{"type":"apiKey","in":"header","name":"Authorization","description":"Each Merchant API request must contain an authorization header in the following format:\n\n```\n'Authorization: Bearer '\n```\n\nTo use this API, you need to generate API keys from your Revolut Business account. The Secret key is used in the authorization header for all server calls, while the Public key is provided with payment methods at checkout.\n\n:::info\nFor detailed instructions on generating your API keys, see: [Generate API keys](https://developer.revolut.com/docs/guides/merchant/get-started#generate-api-keys).\n:::","descriptionNode":"$L610"}}}] 60e:["$","$L10f",null,{"exampleBlocks":{"application/json":{"variants":[{"key":"create_payment_intent","label":"Create payment intent request example","rawValue":"$66:props:children:0:props:children:props:requestBody:content:application/json:examples:create_payment_intent:value","block":"$L611"}],"syncedPropertyName":"$undefined"}},"title":"Request body samples","headingAs":"h4"}] 60f:["$","$L110",null,{"exampleBlocks":{"201":{"application/json":{"variants":[{"key":"payment_intent_pending","label":"Payment intent pending","rawValue":"$67:props:children:0:props:children:props:responses:200:content:application/json:examples:payment_intent_pending:value","block":"$L612"}],"syncedPropertyName":"$undefined"}},"400":{"application/json":{"variants":[{"key":"default","label":"Example","rawValue":{"errorId":"string","timestamp":123},"block":"$L613"}],"syncedPropertyName":"$undefined"}},"401":{"application/json":{"variants":[{"key":"default","label":"Example","rawValue":{"errorId":"string","timestamp":123},"block":"$L614"}],"syncedPropertyName":"$undefined"}},"404":{"application/json":{"variants":[{"key":"default","label":"Example","rawValue":{"errorId":"string","timestamp":123},"block":"$L615"}],"syncedPropertyName":"$undefined"}}},"headingAs":"h4"}] 545:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Indicates whether this billing cycle occurs during the subscription's trial period."}],"\n",["$","p","p-1",{"children":["This value is automatically calculated by the system based on the cycle's timing relative to the subscription's trial period. Returns ",["$","code","code-0",{"children":"true"}]," if the cycle is within the trial period (before ",["$","code","code-1",{"children":"trial_end_date"}],"), otherwise ",["$","code","code-2",{"children":"false"}],"."]}],"\n",["$","p","p-2",{"children":"Trial cycles typically have different billing behavior, such as reduced or zero charges."}]]}] 546:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Subscription cycle retrieved successfully"}]]}] 547:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An identifier that can be used to determine what went wrong."}],"\n",["$","p","p-1",{"children":"Error codes are not globally unique, but uniqueness is guaranteed within endpoints."}]]}] 548:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Some human readable text describing what went wrong."}]]}] 549:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://www.unixtimestamp.com/","target":"_blank","rel":"noreferrer","children":"UNIX timestamp"}]," of the date and time the error happened."]}]]}] 54a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Bad Request"}]]}] 54b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An identifier that can be used to determine what went wrong."}],"\n",["$","p","p-1",{"children":"Error codes are not globally unique, but uniqueness is guaranteed within endpoints."}]]}] 54c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Some human readable text describing what went wrong."}]]}] 54d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://www.unixtimestamp.com/","target":"_blank","rel":"noreferrer","children":"UNIX timestamp"}]," of the date and time the error happened."]}]]}] 54e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unauthorized"}]]}] 54f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An identifier that can be used to determine what went wrong."}],"\n",["$","p","p-1",{"children":"Error codes are not globally unique, but uniqueness is guaranteed within endpoints."}]]}] 550:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Some human readable text describing what went wrong."}]]}] 551:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://www.unixtimestamp.com/","target":"_blank","rel":"noreferrer","children":"UNIX timestamp"}]," of the date and time the error happened."]}]]}] 552:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Subscription cycle not found"}]]}] 553:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An identifier that can be used to determine what went wrong."}],"\n",["$","p","p-1",{"children":"Error codes are not globally unique, but uniqueness is guaranteed within endpoints."}]]}] 554:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Some human readable text describing what went wrong."}]]}] 555:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://www.unixtimestamp.com/","target":"_blank","rel":"noreferrer","children":"UNIX timestamp"}]," of the date and time the error happened."]}]]}] 556:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Error response"}]]}] 58d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Retrieve a specific billing cycle for a subscription by its unique identifier."}],"\n",["$","p","p-1",{"children":"Use this endpoint to get the details and current state of a particular billing cycle."}]]}] 58e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["This parameter accepts the ",["$","a","a-0",{"href":"https://business.revolut.com/settings/apis?tab=merchant-api","target":"_blank","rel":"noreferrer","children":"Merchant API Secret key"}]," to authorise requests coming from the merchant's backend."]}],"\n",["$","p","p-1",{"children":["It ensures that ensures that each request is authenticated and authorised by verifying the secret key. The secret key should be included in all request headers as a ",["$","code","code-0",{"children":"Bearer"}]," token."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#authentication","target":"_blank","rel":"noreferrer","children":"Authentication"}]]}]}]]}]]}] 58f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The version of the Merchant API, specified in ",["$","code","code-0",{"children":"YYYY-MM-DD"}]," format."]}],"\n",["$","p","p-1",{"children":"If not specified, you will receive an error."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information about API versioning, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/reference/versioning/api-versions","target":"_blank","rel":"noreferrer","children":"API versions"}],"."]}]}]]}]]}] 590:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A UUID string, typically used to identify resources."}]]}] 591:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The ID of the subscription."}]]}] 592:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A UUID string, typically used to identify resources."}]]}] 593:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The ID of the subscription cycle."}]]}] 562:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Usage record retrieved successfully"}]]}] 563:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An identifier that can be used to determine what went wrong."}],"\n",["$","p","p-1",{"children":"Error codes are not globally unique, but uniqueness is guaranteed within endpoints."}]]}] 564:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Some human readable text describing what went wrong."}]]}] 565:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://www.unixtimestamp.com/","target":"_blank","rel":"noreferrer","children":"UNIX timestamp"}]," of the date and time the error happened."]}]]}] 566:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Bad Request"}]]}] 567:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An identifier that can be used to determine what went wrong."}],"\n",["$","p","p-1",{"children":"Error codes are not globally unique, but uniqueness is guaranteed within endpoints."}]]}] 568:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Some human readable text describing what went wrong."}]]}] 569:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://www.unixtimestamp.com/","target":"_blank","rel":"noreferrer","children":"UNIX timestamp"}]," of the date and time the error happened."]}]]}] 56a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unauthorized"}]]}] 56b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An identifier that can be used to determine what went wrong."}],"\n",["$","p","p-1",{"children":"Error codes are not globally unique, but uniqueness is guaranteed within endpoints."}]]}] 56c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Some human readable text describing what went wrong."}]]}] 56d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://www.unixtimestamp.com/","target":"_blank","rel":"noreferrer","children":"UNIX timestamp"}]," of the date and time the error happened."]}]]}] 56e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Usage not found"}]]}] 56f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An identifier that can be used to determine what went wrong."}],"\n",["$","p","p-1",{"children":"Error codes are not globally unique, but uniqueness is guaranteed within endpoints."}]]}] 570:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Some human readable text describing what went wrong."}]]}] 571:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://www.unixtimestamp.com/","target":"_blank","rel":"noreferrer","children":"UNIX timestamp"}]," of the date and time the error happened."]}]]}] 572:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Error response"}]]}] 5a2:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Retrieve a usage record by its unique identifier."}],"\n",["$","p","p-1",{"children":"Use this endpoint to get the details of a specific usage that was reported or updated."}]]}] 5a3:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["This parameter accepts the ",["$","a","a-0",{"href":"https://business.revolut.com/settings/apis?tab=merchant-api","target":"_blank","rel":"noreferrer","children":"Merchant API Secret key"}]," to authorise requests coming from the merchant's backend."]}],"\n",["$","p","p-1",{"children":["It ensures that ensures that each request is authenticated and authorised by verifying the secret key. The secret key should be included in all request headers as a ",["$","code","code-0",{"children":"Bearer"}]," token."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#authentication","target":"_blank","rel":"noreferrer","children":"Authentication"}]]}]}]]}]]}] 5a4:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The version of the Merchant API, specified in ",["$","code","code-0",{"children":"YYYY-MM-DD"}]," format."]}],"\n",["$","p","p-1",{"children":"If not specified, you will receive an error."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information about API versioning, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/reference/versioning/api-versions","target":"_blank","rel":"noreferrer","children":"API versions"}],"."]}]}]]}]]}] 5a5:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A UUID string, typically used to identify resources."}]]}] 5a6:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The ID of the usage record."}]]}] 385:["$","div","CodeBlock-0",{"className":"wzy01m0 _18b50nc0","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"
'Authorization: Bearer <yourSecretApiKey>'
"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"'Authorization: Bearer '\n"}]}]]}] 39:["$","$7a","retrieve-subscription-cycle-list",{"children":[["$","section",null,{"className":"y9a0do0","data-variant":"endpoint","children":["$","$L7b",null,{"responses":{"200":{"description":"List of subscription cycles retrieved successfully","content":{"application/json":{"schema":{"type":"object","required":["cycles"],"properties":{"next_page_token":{"type":["string","null"],"description":"Token for retrieving the next page of results.\n\nIf not present, there are no more results to retrieve.","descriptionNode":"$L616"},"cycles":{"type":"array","description":"List of subscription cycles.","items":{"type":"object","required":"$3a:props:children:0:props:children:props:responses:200:content:application/json:schema:required","properties":{"id":{"type":"string","format":"uuid","description":"Unique identifier for the subscription cycle.","descriptionNode":"$L617"},"subscription_id":{"type":"string","format":"uuid","description":"Unique identifier for the subscription.","descriptionNode":"$L618"},"plan_variation_id":{"type":"string","format":"uuid","description":"Unique identifier for the subscription plan variation.","descriptionNode":"$L619"},"plan_variation_phase_id":{"type":"string","format":"uuid","description":"Unique identifier for the subscription plan phase.","descriptionNode":"$L61a"},"number":{"type":"integer","minimum":1,"description":"The sequential cycle number within the subscription.\n\nStarts at `1` for the first cycle and increments with each new billing cycle.","descriptionNode":"$L61b"},"previous_cycle_id":{"type":"$3a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:previous_cycle_id:type","format":"uuid","description":"The unique identifier of the previous billing cycle.\n\nThis field is `null` for the first cycle in a subscription.","descriptionNode":"$L61c"},"state":{"type":"string","enum":"$3a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:state:enum","description":"The state of the subscription cycle.\n\n| State | Description |\n| ----- | ----------- |\n| `pending` | The cycle has been created but has not yet started. A cycle can enter this state automatically when usage is reported for a future cycle via `POST /api/subscription-usages`. |\n| `active` | The cycle is currently active and in progress. |\n| `finished` | The cycle has completed. |","descriptionNode":"$L61d"},"start_date":{"type":"string","format":"date-time","description":"The date and time the subscription cycle starts in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format.","descriptionNode":"$L61e"},"end_date":{"type":"string","format":"date-time","description":"The date and time the subscription cycle ends in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format.","descriptionNode":"$L61f"},"usage_cutoff_date":{"type":"string","format":"date-time","description":"The deadline for submitting or correcting usage records for this cycle, in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format.\n\nSet to 12 hours after the cycle's `end_date` by default. After this time, Revolut aggregates all reported usage records and creates the `post_billing_order_id` to initiate the charge.\n\n:::note\nOnly present for cycles that include usage-based subscription items.\n:::","descriptionNode":"$L620"},"order_id":{"type":"string","format":"uuid","description":"Permanent order ID used to retrieve, capture, cancel, or refund an order after authorization.","descriptionNode":"$L621"},"post_billing_order_id":{"type":"string","format":"uuid","description":"The ID of the order created after the cycle's `usage_cutoff_date` to charge usage-based items accumulated during the cycle.\n\n| Scenario | Detail |\n| -------- | ------ |\n| Ongoing subscription | This order also acts as the next cycle's `order_id`, combining usage post-billing for the current cycle with pre-billing for the next. |\n| Last cycle | A standalone finishing order is created to charge all usage from this cycle. |\n| Subscription ended with unpaid cycles | The finishing order consolidates all outstanding usage charges, including any from previous cycles where payment failed. |\n\n:::note\nOnly present for cycles that include usage-based subscription items.\n:::","descriptionNode":"$L622"},"trial":{"type":"boolean","description":"Indicates whether this billing cycle occurs during the subscription's trial period.\n\nThis value is automatically calculated by the system based on the cycle's timing relative to the subscription's trial period. Returns `true` if the cycle is within the trial period (before `trial_end_date`), otherwise `false`. \n\nTrial cycles typically have different billing behavior, such as reduced or zero charges.","default":false,"examples":"$3a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:trial:examples","descriptionNode":"$L623"}}},"descriptionNode":"$L624"}}},"examples":{"cycles_list":{"summary":"List of subscription cycles","value":{"next_page_token":"9e5d2caa-bb60-4b5b-b7cf-6345bbdff67e","cycles":[{"id":"550e8400-e29b-41d4-a716-446655440010","subscription_id":"650e8400-e29b-41d4-a716-446655440001","plan_variation_id":"750e8400-e29b-41d4-a716-446655440002","plan_variation_phase_id":"850e8400-e29b-41d4-a716-446655440003","number":2,"previous_cycle_id":"550e8400-e29b-41d4-a716-446655440000","state":"active","start_date":"2025-07-05T21:00:00.036001Z","end_date":"2025-08-05T21:00:00.036001Z","order_id":"a50e8400-e29b-41d4-a716-446655440015","trial":false},{"id":"550e8400-e29b-41d4-a716-446655440000","subscription_id":"650e8400-e29b-41d4-a716-446655440001","plan_variation_id":"750e8400-e29b-41d4-a716-446655440002","number":1,"state":"finished","start_date":"2025-06-05T21:00:00.036001Z","end_date":"2025-07-05T21:00:00.036001Z","order_id":"a50e8400-e29b-41d4-a716-446655440005","trial":true}]}}}}},"descriptionNode":"$L625"},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"code":{"type":"string","description":"An identifier that can be used to determine what went wrong.\n\nError codes are not globally unique, but uniqueness is guaranteed within endpoints.","descriptionNode":"$L626"},"message":{"type":"string","description":"Some human readable text describing what went wrong.","descriptionNode":"$L627"},"timestamp":{"type":"integer","description":"The [UNIX timestamp](https://www.unixtimestamp.com/) of the date and time the error happened.","descriptionNode":"$L628"}}}}},"descriptionNode":"$L629"},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"code":{"type":"string","description":"An identifier that can be used to determine what went wrong.\n\nError codes are not globally unique, but uniqueness is guaranteed within endpoints.","descriptionNode":"$L62a"},"message":{"type":"string","description":"Some human readable text describing what went wrong.","descriptionNode":"$L62b"},"timestamp":{"type":"integer","description":"The [UNIX timestamp](https://www.unixtimestamp.com/) of the date and time the error happened.","descriptionNode":"$L62c"}}}}},"descriptionNode":"$L62d"},"404":{"description":"Subscription not found","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"code":{"type":"string","description":"An identifier that can be used to determine what went wrong.\n\nError codes are not globally unique, but uniqueness is guaranteed within endpoints.","descriptionNode":"$L62e"},"message":{"type":"string","description":"Some human readable text describing what went wrong.","descriptionNode":"$L62f"},"timestamp":{"type":"integer","description":"The [UNIX timestamp](https://www.unixtimestamp.com/) of the date and time the error happened.","descriptionNode":"$L630"}}}}},"descriptionNode":"$L631"},"default":{"description":"Error response","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"code":{"type":"string","description":"An identifier that can be used to determine what went wrong.\n\nError codes are not globally unique, but uniqueness is guaranteed within endpoints.","descriptionNode":"$L632"},"message":{"type":"string","description":"Some human readable text describing what went wrong.","descriptionNode":"$L633"},"timestamp":{"type":"integer","description":"The [UNIX timestamp](https://www.unixtimestamp.com/) of the date and time the error happened.","descriptionNode":"$L634"}}}}},"descriptionNode":"$L635"}},"requestBody":"$undefined","variantLabels":[],"children":["$L636","$L637"]}]}],false]}] 3c:["$","$7a","retrieve-subscription-usage-list",{"children":[["$","section",null,{"className":"y9a0do0","data-variant":"endpoint","children":["$","$L7b",null,{"responses":{"200":{"description":"List of subscription usages retrieved successfully","content":{"application/json":{"schema":{"type":"object","properties":{"next_page_token":{"type":"$24:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:next_page_token:type","description":"Token for retrieving the next page of results. Use this token as the value of the `page_token` query parameter in your next request to retrieve the next page.\n\nIf not present, there are no more results to retrieve.","descriptionNode":"$L638"},"subscription_usages":{"type":"array","description":"List of subscription usages.","items":{"type":"object","required":"$3d:props:children:0:props:children:props:responses:200:content:application/json:schema:required","properties":{"id":{"type":"string","format":"uuid","description":"The unique identifier of the usage record.","descriptionNode":"$L639"},"subscription_id":{"type":"string","format":"uuid","description":"Unique identifier for the subscription.","descriptionNode":"$L63a"},"subscription_cycle_id":{"type":"string","format":"uuid","description":"Unique identifier for the subscription cycle.","descriptionNode":"$L63b"},"subscription_item_code":{"type":"string","description":"A merchant-defined identifier for a usage-based subscription item. You set this code on each usage item when creating a subscription plan, and supply it when reporting consumption on [Create a subscription usage endpoint](https://developer.revolut.com/docs/api/merchant#create-subscription-usage) to target the correct metered item.\n\nThis allows a subscription with multiple usage items (e.g., `api_calls` and `storage_gb`) to receive consumption reports against the right item without relying on internal IDs.\n\nThe code must be unique within a plan phase.","maxLength":250,"examples":"$3d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:subscription_item_code:examples","descriptionNode":"$L63c"},"usage_date":{"type":"string","format":"date-time","description":"The timestamp indicating when the consumption actually occurred.\n\n| Constraint | Detail |\n| ---------- | ------ |\n| Format | [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date-time string (e.g., `YYYY-MM-DDTHH:mm:ssZ`). |\n| Timezone | Must be UTC. |\n| Validation | Revolut uses this to identify the applicable billing cycle. Accepted for the active cycle (`start_date ≤ usage_date < end_date`), for a recently ended cycle before its `usage_cutoff_date`, and for the one next upcoming cycle. Other dates are rejected. |","examples":"$3d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:usage_date:examples","descriptionNode":"$L63d"},"quantity":{"type":"number","exclusiveMinimum":0,"description":"The quantity of consumption to record for this usage report. \n\nSupports up to 20 digits before and 20 digits after the decimal point.","examples":"$3d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:quantity:examples","descriptionNode":"$L63e"},"metadata":{"type":"object","description":"Key-value pairs you can attach to a usage record for your own tracking and reporting purposes.\n\n| Constraint | Detail |\n| ---------- | ------ |\n| Keys | Maximum 50 keys per record. |\n| Value types | String, number, or boolean only. |\n| Number precision | Up to 20 digits before and 20 digits after the decimal point. |","additionalProperties":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]},"maxProperties":50,"examples":"$3d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:metadata:examples","descriptionNode":"$L63f"},"created_at":{"type":"string","format":"date-time","description":"The date and time the usage record was created in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format.","examples":"$3d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:created_at:examples","descriptionNode":"$L640"},"updated_at":{"type":"string","format":"date-time","description":"The date and time the usage record was last updated in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format.","examples":"$3d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:updated_at:examples","descriptionNode":"$L641"}}},"descriptionNode":"$L642"}}},"examples":{"usage_list":{"summary":"Retrieve a list of usage records","value":{"next_page_token":"9e5d2caa-bb60-4b5b-b7cf-6345bbdff67e","subscription_usages":[{"id":"750e8400-e29b-41d4-a716-446655440000","subscription_id":"550e8400-e29b-41d4-a716-446655440000","subscription_cycle_id":"850e8400-e29b-41d4-a716-446655440000","subscription_item_code":"api_calls","usage_date":"2026-03-01T21:00:00Z","quantity":100,"metadata":{"user_id":"12345","api_version":"v2"},"created_at":"2026-03-01T21:05:00Z","updated_at":"2026-03-01T21:05:00Z"},{"id":"bc903328-9f37-4d7a-8f56-02e5b7c76891","subscription_id":"550e8400-e29b-41d4-a716-446655440000","subscription_cycle_id":"850e8400-e29b-41d4-a716-446655440000","subscription_item_code":"api_calls","usage_date":"2026-03-01T22:15:00Z","quantity":50,"metadata":{"user_id":"12345","api_version":"v2"},"created_at":"2026-03-01T22:20:00Z","updated_at":"2026-03-01T22:20:00Z"}]}}}}},"descriptionNode":"$L643"},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"code":{"type":"string","description":"An identifier that can be used to determine what went wrong.\n\nError codes are not globally unique, but uniqueness is guaranteed within endpoints.","descriptionNode":"$L644"},"message":{"type":"string","description":"Some human readable text describing what went wrong.","descriptionNode":"$L645"},"timestamp":{"type":"integer","description":"The [UNIX timestamp](https://www.unixtimestamp.com/) of the date and time the error happened.","descriptionNode":"$L646"}}}}},"descriptionNode":"$L647"},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"code":{"type":"string","description":"An identifier that can be used to determine what went wrong.\n\nError codes are not globally unique, but uniqueness is guaranteed within endpoints.","descriptionNode":"$L648"},"message":{"type":"string","description":"Some human readable text describing what went wrong.","descriptionNode":"$L649"},"timestamp":{"type":"integer","description":"The [UNIX timestamp](https://www.unixtimestamp.com/) of the date and time the error happened.","descriptionNode":"$L64a"}}}}},"descriptionNode":"$L64b"},"default":{"description":"Error response","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"code":{"type":"string","description":"An identifier that can be used to determine what went wrong.\n\nError codes are not globally unique, but uniqueness is guaranteed within endpoints.","descriptionNode":"$L64c"},"message":{"type":"string","description":"Some human readable text describing what went wrong.","descriptionNode":"$L64d"},"timestamp":{"type":"integer","description":"The [UNIX timestamp](https://www.unixtimestamp.com/) of the date and time the error happened.","descriptionNode":"$L64e"}}}}},"descriptionNode":"$L64f"}},"requestBody":"$undefined","variantLabels":[],"children":["$L650","$L651"]}]}],false]}] 652:T1128,
{
  "next_page_token": "9e5d2caa-bb60-4b5b-b7cf-6345bbdff67e",
  "customers": [
    {
      "id": "9dfb8491-bfb0-4420-ad63-0fa7bdd3dffb",
      "full_name": "First Customer",
      "email": "first.customer@example.com",
      "created_at": "2020-06-24T12:12:56.596703Z",
      "updated_at": "2020-06-24T12:12:56.737082Z"
    },
    {
      "id": "6c7c97a8-cfc1-4cf3-8b38-26a74fdf1fae",
      "full_name": "Second Customer",
      "email": "second.customer@example.com",
      "phone": "+441234567890",
      "created_at": "2020-06-24T12:03:39.979397Z",
      "updated_at": "2020-06-25T10:03:39.134417Z"
    }
  ]
}
387:["$","div","200-application/json-list_of_customers",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$652"}}]}]],"$L653"]}] 654:T44d,
{
  "code": "string",
  "message": "string",
  "timestamp": 123
}
388:["$","div","401-application/json-default",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$654"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"code\": \"string\",\n \"message\": \"string\",\n \"timestamp\": 123\n}"}]}]]}] 5b5:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Each Merchant API request must contain an authorization header in the following format:"}],"\n","$L655","\n",["$","p","p-1",{"children":"To use this API, you need to generate API keys from your Revolut Business account. The Secret key is used in the authorization header for all server calls, while the Public key is provided with payment methods at checkout."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For detailed instructions on generating your API keys, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/get-started#generate-api-keys","target":"_blank","rel":"noreferrer","children":"Generate API keys"}],"."]}]}]]}]]}] 5ba:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Each Merchant API request must contain an authorization header in the following format:"}],"\n","$L656","\n",["$","p","p-1",{"children":"To use this API, you need to generate API keys from your Revolut Business account. The Secret key is used in the authorization header for all server calls, while the Public key is provided with payment methods at checkout."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For detailed instructions on generating your API keys, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/get-started#generate-api-keys","target":"_blank","rel":"noreferrer","children":"Generate API keys"}],"."]}]}]]}]]}] 5c0:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Each Merchant API request must contain an authorization header in the following format:"}],"\n","$L657","\n",["$","p","p-1",{"children":"To use this API, you need to generate API keys from your Revolut Business account. The Secret key is used in the authorization header for all server calls, while the Public key is provided with payment methods at checkout."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For detailed instructions on generating your API keys, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/get-started#generate-api-keys","target":"_blank","rel":"noreferrer","children":"Generate API keys"}],"."]}]}]]}]]}] 636:["$","div",null,{"className":"ezz1n30","children":[["$","div",null,{"data-header":"$undefined","className":"ezz1n31","children":["$","div",null,{"className":"y9a0do1","children":[["$","h2",null,{"id":"retrieve-subscription-cycle-list","children":[["$L658","$undefined"],["$","$L15",null,{"id":"retrieve-subscription-cycle-list"}]]}],["$","$L16",null,{"url":"/docs/api/merchant/2025-10-16/operations/retrieve-subscription-cycle-list.md"}]]}]}],"$undefined"]}] 662:T42c,
curl -X GET "https://merchant.revolut.com/api/subscriptions/__RP_TOK_0__/cycles?limit=__RP_TOK_1__&from=__RP_TOK_2__&to=__RP_TOK_3__&page_token=__RP_TOK_4__" \
  -H "Authorization: __RP_TOK_5__" \
  -H "Revolut-Api-Version: __RP_TOK_6__"
663:Ta3a,
fetch("https://merchant.revolut.com/api/subscriptions/__RP_TOK_0__/cycles?limit=__RP_TOK_1__&from=__RP_TOK_2__&to=__RP_TOK_3__&page_token=__RP_TOK_4__", {
  method: "GET",
  headers: {
    "Authorization": "__RP_TOK_5__",
    "Revolut-Api-Version": "__RP_TOK_6__"
  }
})
  .then(response => response.json())
  .then(data => console.log(data));
664:Tfd7,
package main

import (
  "fmt"
  "net/http"
)

func main() {
  url := "https://merchant.revolut.com/api/subscriptions/__RP_TOK_0__/cycles?limit=__RP_TOK_1__&from=__RP_TOK_2__&to=__RP_TOK_3__&page_token=__RP_TOK_4__"
  req, _ := http.NewRequest("GET", url, nil)
  req.Header.Add("Authorization", "__RP_TOK_5__")
  req.Header.Add("Revolut-Api-Version", "__RP_TOK_6__")

  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  fmt.Println(res)
}
665:T84c,
import requests

url = "https://merchant.revolut.com/api/subscriptions/__RP_TOK_0__/cycles?limit=__RP_TOK_1__&from=__RP_TOK_2__&to=__RP_TOK_3__&page_token=__RP_TOK_4__"
headers = {
  "Authorization": "__RP_TOK_5__",
  "Revolut-Api-Version": "__RP_TOK_6__"
}

response = requests.get(url, headers=headers)
print(response.json())
666:T1778,
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;

public class Main {
  public static void main(String[] args) {
    HttpClient client = HttpClient.newHttpClient();
    HttpRequest request = HttpRequest.newBuilder()
      .uri(URI.create("https://merchant.revolut.com/api/subscriptions/__RP_TOK_0__/cycles?limit=__RP_TOK_1__&from=__RP_TOK_2__&to=__RP_TOK_3__&page_token=__RP_TOK_4__"))
      .header("Authorization", "__RP_TOK_5__")
      .header("Revolut-Api-Version", "__RP_TOK_6__")
      .GET(HttpRequest.BodyPublishers.noBody())
      .build();

    client.sendAsync(request, HttpResponse.BodyHandlers.ofString())
      .thenApply(HttpResponse::body)
      .thenAccept(System.out::println)
      .join();
  }
}
667:T1622,
using System.Net.Http;
using System.Net.Http.Headers;

var client = new HttpClient();
var request = new HttpRequestMessage
{
  Method = HttpMethod.Get,
  RequestUri = new Uri("https://merchant.revolut.com/api/subscriptions/__RP_TOK_0__/cycles?limit=__RP_TOK_1__&from=__RP_TOK_2__&to=__RP_TOK_3__&page_token=__RP_TOK_4__"),
  Headers =
  {
    { "Authorization", "__RP_TOK_5__" },
    { "Revolut-Api-Version", "__RP_TOK_6__" },
  }
};

using (var response = await client.SendAsync(request))
{
  response.EnsureSuccessStatusCode();
  var body = await response.Content.ReadAsStringAsync();
  Console.WriteLine(body);
}
668:T434,
curl -X GET "https://sandbox-merchant.revolut.com/api/subscriptions/__RP_TOK_0__/cycles?limit=__RP_TOK_1__&from=__RP_TOK_2__&to=__RP_TOK_3__&page_token=__RP_TOK_4__" \
  -H "Authorization: __RP_TOK_5__" \
  -H "Revolut-Api-Version: __RP_TOK_6__"
669:Ta42,
fetch("https://sandbox-merchant.revolut.com/api/subscriptions/__RP_TOK_0__/cycles?limit=__RP_TOK_1__&from=__RP_TOK_2__&to=__RP_TOK_3__&page_token=__RP_TOK_4__", {
  method: "GET",
  headers: {
    "Authorization": "__RP_TOK_5__",
    "Revolut-Api-Version": "__RP_TOK_6__"
  }
})
  .then(response => response.json())
  .then(data => console.log(data));
66a:Tfdf,
package main

import (
  "fmt"
  "net/http"
)

func main() {
  url := "https://sandbox-merchant.revolut.com/api/subscriptions/__RP_TOK_0__/cycles?limit=__RP_TOK_1__&from=__RP_TOK_2__&to=__RP_TOK_3__&page_token=__RP_TOK_4__"
  req, _ := http.NewRequest("GET", url, nil)
  req.Header.Add("Authorization", "__RP_TOK_5__")
  req.Header.Add("Revolut-Api-Version", "__RP_TOK_6__")

  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  fmt.Println(res)
}
66b:T854,
import requests

url = "https://sandbox-merchant.revolut.com/api/subscriptions/__RP_TOK_0__/cycles?limit=__RP_TOK_1__&from=__RP_TOK_2__&to=__RP_TOK_3__&page_token=__RP_TOK_4__"
headers = {
  "Authorization": "__RP_TOK_5__",
  "Revolut-Api-Version": "__RP_TOK_6__"
}

response = requests.get(url, headers=headers)
print(response.json())
66c:T1780,
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;

public class Main {
  public static void main(String[] args) {
    HttpClient client = HttpClient.newHttpClient();
    HttpRequest request = HttpRequest.newBuilder()
      .uri(URI.create("https://sandbox-merchant.revolut.com/api/subscriptions/__RP_TOK_0__/cycles?limit=__RP_TOK_1__&from=__RP_TOK_2__&to=__RP_TOK_3__&page_token=__RP_TOK_4__"))
      .header("Authorization", "__RP_TOK_5__")
      .header("Revolut-Api-Version", "__RP_TOK_6__")
      .GET(HttpRequest.BodyPublishers.noBody())
      .build();

    client.sendAsync(request, HttpResponse.BodyHandlers.ofString())
      .thenApply(HttpResponse::body)
      .thenAccept(System.out::println)
      .join();
  }
}
66d:T162a,
using System.Net.Http;
using System.Net.Http.Headers;

var client = new HttpClient();
var request = new HttpRequestMessage
{
  Method = HttpMethod.Get,
  RequestUri = new Uri("https://sandbox-merchant.revolut.com/api/subscriptions/__RP_TOK_0__/cycles?limit=__RP_TOK_1__&from=__RP_TOK_2__&to=__RP_TOK_3__&page_token=__RP_TOK_4__"),
  Headers =
  {
    { "Authorization", "__RP_TOK_5__" },
    { "Revolut-Api-Version", "__RP_TOK_6__" },
  }
};

using (var response = await client.SendAsync(request))
{
  response.EnsureSuccessStatusCode();
  var body = await response.Content.ReadAsStringAsync();
  Console.WriteLine(body);
}
637:["$","div",null,{"className":"ezz1n30","children":[["$","div",null,{"data-header":"$undefined","className":"ezz1n31","children":["$L659",["$","$L85",null,{"parameters":[{"name":"Authorization","in":"header","schema":{"type":"string","format":"Bearer ","examples":"$62:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:0:schema:examples"},"required":true,"description":"This parameter accepts the [Merchant API Secret key](https://business.revolut.com/settings/apis?tab=merchant-api) to authorise requests coming from the merchant's backend. \n\nIt ensures that ensures that each request is authenticated and authorised by verifying the secret key. The secret key should be included in all request headers as a `Bearer` token.\n\n:::info\nFor more information, see: [Authentication](https://developer.revolut.com/docs/api/merchant#authentication)\n:::","descriptionNode":"$L65a"},{"name":"Revolut-Api-Version","in":"header","schema":{"type":"string","format":"date","enum":"$36:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:1:schema:enum","examples":"$36:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:1:schema:examples"},"required":true,"description":"The version of the Merchant API, specified in `YYYY-MM-DD` format.\n\nIf not specified, you will receive an error.\n\n\n:::info\nFor more information about API versioning, see: [API versions](https://developer.revolut.com/docs/guides/merchant/reference/versioning/api-versions).\n:::","x-config-always-visible-in-example":true,"example":"2025-10-16","descriptionNode":"$L65b"},{"name":"subscription_id","in":"path","schema":{"type":"string","format":"uuid","description":"A UUID string, typically used to identify resources.","descriptionNode":"$L65c"},"required":true,"description":"The ID of the subscription.","descriptionNode":"$L65d"},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":500,"default":100},"description":"Maximum number of records to return. Used for **pagination**.","required":false,"descriptionNode":"$L65e"},{"name":"from","in":"query","schema":{"type":"string","format":"date-time"},"description":"Filter records created from this date/time. Used for **filtering**.","required":false,"descriptionNode":"$L65f"},{"name":"to","in":"query","schema":{"type":"string","format":"date-time"},"description":"Filter records created until this date/time. Used for **filtering**.","required":false,"descriptionNode":"$L660"},{"name":"page_token","in":"query","schema":{"type":"string"},"description":"Token for retrieving the next page of results. Used for **pagination**.\n\nTo paginate through results:\n\n 1. Make an initial request with the desired `limit`.\n 1. The response will include a `next_page_token` if more results are available.\n 1. Use that token in the `page_token` parameter of your next request.\n 1. Repeat until `next_page_token` is not present.\n\n:::note\nWhen using `page_token`, you must include all query parameters from the initial request (such as `from`, `to`, or other filter parameters) to maintain consistent filtering across pages.\n:::","required":false,"descriptionNode":"$L661"}],"requestBody":"$undefined","heading":"Request","requestBodySchemaTitle":"Request body","headingAs":"h3"}],["$","$L89",null,{"responses":"$39:props:children:0:props:children:props:responses","headingAs":"h3"}]]}],["$","div",null,{"className":"ezz1n32","children":[[["$","$L8a",null,{"itemsByServer":{"https://merchant.revolut.com":[{"id":"curl","label":"cURL","templateCode":"curl -X GET \"https://merchant.revolut.com/api/subscriptions/__RP_TOK_0__/cycles?limit=__RP_TOK_1__&from=__RP_TOK_2__&to=__RP_TOK_3__&page_token=__RP_TOK_4__\" \\\n -H \"Authorization: __RP_TOK_5__\" \\\n -H \"Revolut-Api-Version: __RP_TOK_6__\"","templateHtml":"$662","tokens":[{"marker":"__RP_TOK_0__","paramName":"subscription_id","paramIn":"path","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_1__","paramName":"limit","paramIn":"query","pipeline":["url-component","shell-double-inner"]},{"marker":"__RP_TOK_2__","paramName":"from","paramIn":"query","pipeline":["url-component","shell-double-inner"]},{"marker":"__RP_TOK_3__","paramName":"to","paramIn":"query","pipeline":["url-component","shell-double-inner"]},{"marker":"__RP_TOK_4__","paramName":"page_token","paramIn":"query","pipeline":["url-component","shell-double-inner"]},{"marker":"__RP_TOK_5__","paramName":"Authorization","paramIn":"header","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_6__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["shell-double-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:subscription_id":"123e4567-e89b-12d3-a456-426614174000","query:limit":"100","query:from":"2024-01-01T00:00:00Z","query:to":"2024-01-01T00:00:00Z","query:page_token":"string"}},{"id":"javascript","label":"JavaScript","templateCode":"fetch(\"https://merchant.revolut.com/api/subscriptions/__RP_TOK_0__/cycles?limit=__RP_TOK_1__&from=__RP_TOK_2__&to=__RP_TOK_3__&page_token=__RP_TOK_4__\", {\n method: \"GET\",\n headers: {\n \"Authorization\": \"__RP_TOK_5__\",\n \"Revolut-Api-Version\": \"__RP_TOK_6__\"\n }\n})\n .then(response => response.json())\n .then(data => console.log(data));","templateHtml":"$663","tokens":[{"marker":"__RP_TOK_0__","paramName":"subscription_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"limit","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"from","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_3__","paramName":"to","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_4__","paramName":"page_token","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_5__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_6__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:subscription_id":"123e4567-e89b-12d3-a456-426614174000","query:limit":"100","query:from":"2024-01-01T00:00:00Z","query:to":"2024-01-01T00:00:00Z","query:page_token":"string"}},{"id":"go","label":"Go","templateCode":"package main\n\nimport (\n \"fmt\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://merchant.revolut.com/api/subscriptions/__RP_TOK_0__/cycles?limit=__RP_TOK_1__&from=__RP_TOK_2__&to=__RP_TOK_3__&page_token=__RP_TOK_4__\"\n req, _ := http.NewRequest(\"GET\", url, nil)\n req.Header.Add(\"Authorization\", \"__RP_TOK_5__\")\n req.Header.Add(\"Revolut-Api-Version\", \"__RP_TOK_6__\")\n\n res, _ := http.DefaultClient.Do(req)\n defer res.Body.Close()\n fmt.Println(res)\n}","templateHtml":"$664","tokens":[{"marker":"__RP_TOK_0__","paramName":"subscription_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"limit","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"from","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_3__","paramName":"to","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_4__","paramName":"page_token","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_5__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_6__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:subscription_id":"123e4567-e89b-12d3-a456-426614174000","query:limit":"100","query:from":"2024-01-01T00:00:00Z","query:to":"2024-01-01T00:00:00Z","query:page_token":"string"}},{"id":"python","label":"Python","templateCode":"import requests\n\nurl = \"https://merchant.revolut.com/api/subscriptions/__RP_TOK_0__/cycles?limit=__RP_TOK_1__&from=__RP_TOK_2__&to=__RP_TOK_3__&page_token=__RP_TOK_4__\"\nheaders = {\n \"Authorization\": \"__RP_TOK_5__\",\n \"Revolut-Api-Version\": \"__RP_TOK_6__\"\n}\n\nresponse = requests.get(url, headers=headers)\nprint(response.json())","templateHtml":"$665","tokens":[{"marker":"__RP_TOK_0__","paramName":"subscription_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"limit","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"from","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_3__","paramName":"to","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_4__","paramName":"page_token","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_5__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_6__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:subscription_id":"123e4567-e89b-12d3-a456-426614174000","query:limit":"100","query:from":"2024-01-01T00:00:00Z","query:to":"2024-01-01T00:00:00Z","query:page_token":"string"}},{"id":"java","label":"Java","templateCode":"import java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\nimport java.net.URI;\n\npublic class Main {\n public static void main(String[] args) {\n HttpClient client = HttpClient.newHttpClient();\n HttpRequest request = HttpRequest.newBuilder()\n .uri(URI.create(\"https://merchant.revolut.com/api/subscriptions/__RP_TOK_0__/cycles?limit=__RP_TOK_1__&from=__RP_TOK_2__&to=__RP_TOK_3__&page_token=__RP_TOK_4__\"))\n .header(\"Authorization\", \"__RP_TOK_5__\")\n .header(\"Revolut-Api-Version\", \"__RP_TOK_6__\")\n .GET(HttpRequest.BodyPublishers.noBody())\n .build();\n\n client.sendAsync(request, HttpResponse.BodyHandlers.ofString())\n .thenApply(HttpResponse::body)\n .thenAccept(System.out::println)\n .join();\n }\n}","templateHtml":"$666","tokens":[{"marker":"__RP_TOK_0__","paramName":"subscription_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"limit","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"from","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_3__","paramName":"to","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_4__","paramName":"page_token","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_5__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_6__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:subscription_id":"123e4567-e89b-12d3-a456-426614174000","query:limit":"100","query:from":"2024-01-01T00:00:00Z","query:to":"2024-01-01T00:00:00Z","query:page_token":"string"}},{"id":"csharp","label":"C#","templateCode":"using System.Net.Http;\nusing System.Net.Http.Headers;\n\nvar client = new HttpClient();\nvar request = new HttpRequestMessage\n{\n Method = HttpMethod.Get,\n RequestUri = new Uri(\"https://merchant.revolut.com/api/subscriptions/__RP_TOK_0__/cycles?limit=__RP_TOK_1__&from=__RP_TOK_2__&to=__RP_TOK_3__&page_token=__RP_TOK_4__\"),\n Headers =\n {\n { \"Authorization\", \"__RP_TOK_5__\" },\n { \"Revolut-Api-Version\", \"__RP_TOK_6__\" },\n }\n};\n\nusing (var response = await client.SendAsync(request))\n{\n response.EnsureSuccessStatusCode();\n var body = await response.Content.ReadAsStringAsync();\n Console.WriteLine(body);\n}","templateHtml":"$667","tokens":[{"marker":"__RP_TOK_0__","paramName":"subscription_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"limit","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"from","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_3__","paramName":"to","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_4__","paramName":"page_token","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_5__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_6__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:subscription_id":"123e4567-e89b-12d3-a456-426614174000","query:limit":"100","query:from":"2024-01-01T00:00:00Z","query:to":"2024-01-01T00:00:00Z","query:page_token":"string"}}],"https://sandbox-merchant.revolut.com":[{"id":"curl","label":"cURL","templateCode":"curl -X GET \"https://sandbox-merchant.revolut.com/api/subscriptions/__RP_TOK_0__/cycles?limit=__RP_TOK_1__&from=__RP_TOK_2__&to=__RP_TOK_3__&page_token=__RP_TOK_4__\" \\\n -H \"Authorization: __RP_TOK_5__\" \\\n -H \"Revolut-Api-Version: __RP_TOK_6__\"","templateHtml":"$668","tokens":[{"marker":"__RP_TOK_0__","paramName":"subscription_id","paramIn":"path","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_1__","paramName":"limit","paramIn":"query","pipeline":["url-component","shell-double-inner"]},{"marker":"__RP_TOK_2__","paramName":"from","paramIn":"query","pipeline":["url-component","shell-double-inner"]},{"marker":"__RP_TOK_3__","paramName":"to","paramIn":"query","pipeline":["url-component","shell-double-inner"]},{"marker":"__RP_TOK_4__","paramName":"page_token","paramIn":"query","pipeline":["url-component","shell-double-inner"]},{"marker":"__RP_TOK_5__","paramName":"Authorization","paramIn":"header","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_6__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["shell-double-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:subscription_id":"123e4567-e89b-12d3-a456-426614174000","query:limit":"100","query:from":"2024-01-01T00:00:00Z","query:to":"2024-01-01T00:00:00Z","query:page_token":"string"}},{"id":"javascript","label":"JavaScript","templateCode":"fetch(\"https://sandbox-merchant.revolut.com/api/subscriptions/__RP_TOK_0__/cycles?limit=__RP_TOK_1__&from=__RP_TOK_2__&to=__RP_TOK_3__&page_token=__RP_TOK_4__\", {\n method: \"GET\",\n headers: {\n \"Authorization\": \"__RP_TOK_5__\",\n \"Revolut-Api-Version\": \"__RP_TOK_6__\"\n }\n})\n .then(response => response.json())\n .then(data => console.log(data));","templateHtml":"$669","tokens":[{"marker":"__RP_TOK_0__","paramName":"subscription_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"limit","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"from","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_3__","paramName":"to","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_4__","paramName":"page_token","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_5__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_6__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:subscription_id":"123e4567-e89b-12d3-a456-426614174000","query:limit":"100","query:from":"2024-01-01T00:00:00Z","query:to":"2024-01-01T00:00:00Z","query:page_token":"string"}},{"id":"go","label":"Go","templateCode":"package main\n\nimport (\n \"fmt\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://sandbox-merchant.revolut.com/api/subscriptions/__RP_TOK_0__/cycles?limit=__RP_TOK_1__&from=__RP_TOK_2__&to=__RP_TOK_3__&page_token=__RP_TOK_4__\"\n req, _ := http.NewRequest(\"GET\", url, nil)\n req.Header.Add(\"Authorization\", \"__RP_TOK_5__\")\n req.Header.Add(\"Revolut-Api-Version\", \"__RP_TOK_6__\")\n\n res, _ := http.DefaultClient.Do(req)\n defer res.Body.Close()\n fmt.Println(res)\n}","templateHtml":"$66a","tokens":[{"marker":"__RP_TOK_0__","paramName":"subscription_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"limit","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"from","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_3__","paramName":"to","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_4__","paramName":"page_token","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_5__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_6__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:subscription_id":"123e4567-e89b-12d3-a456-426614174000","query:limit":"100","query:from":"2024-01-01T00:00:00Z","query:to":"2024-01-01T00:00:00Z","query:page_token":"string"}},{"id":"python","label":"Python","templateCode":"import requests\n\nurl = \"https://sandbox-merchant.revolut.com/api/subscriptions/__RP_TOK_0__/cycles?limit=__RP_TOK_1__&from=__RP_TOK_2__&to=__RP_TOK_3__&page_token=__RP_TOK_4__\"\nheaders = {\n \"Authorization\": \"__RP_TOK_5__\",\n \"Revolut-Api-Version\": \"__RP_TOK_6__\"\n}\n\nresponse = requests.get(url, headers=headers)\nprint(response.json())","templateHtml":"$66b","tokens":[{"marker":"__RP_TOK_0__","paramName":"subscription_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"limit","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"from","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_3__","paramName":"to","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_4__","paramName":"page_token","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_5__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_6__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:subscription_id":"123e4567-e89b-12d3-a456-426614174000","query:limit":"100","query:from":"2024-01-01T00:00:00Z","query:to":"2024-01-01T00:00:00Z","query:page_token":"string"}},{"id":"java","label":"Java","templateCode":"import java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\nimport java.net.URI;\n\npublic class Main {\n public static void main(String[] args) {\n HttpClient client = HttpClient.newHttpClient();\n HttpRequest request = HttpRequest.newBuilder()\n .uri(URI.create(\"https://sandbox-merchant.revolut.com/api/subscriptions/__RP_TOK_0__/cycles?limit=__RP_TOK_1__&from=__RP_TOK_2__&to=__RP_TOK_3__&page_token=__RP_TOK_4__\"))\n .header(\"Authorization\", \"__RP_TOK_5__\")\n .header(\"Revolut-Api-Version\", \"__RP_TOK_6__\")\n .GET(HttpRequest.BodyPublishers.noBody())\n .build();\n\n client.sendAsync(request, HttpResponse.BodyHandlers.ofString())\n .thenApply(HttpResponse::body)\n .thenAccept(System.out::println)\n .join();\n }\n}","templateHtml":"$66c","tokens":[{"marker":"__RP_TOK_0__","paramName":"subscription_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"limit","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"from","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_3__","paramName":"to","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_4__","paramName":"page_token","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_5__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_6__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:subscription_id":"123e4567-e89b-12d3-a456-426614174000","query:limit":"100","query:from":"2024-01-01T00:00:00Z","query:to":"2024-01-01T00:00:00Z","query:page_token":"string"}},{"id":"csharp","label":"C#","templateCode":"using System.Net.Http;\nusing System.Net.Http.Headers;\n\nvar client = new HttpClient();\nvar request = new HttpRequestMessage\n{\n Method = HttpMethod.Get,\n RequestUri = new Uri(\"https://sandbox-merchant.revolut.com/api/subscriptions/__RP_TOK_0__/cycles?limit=__RP_TOK_1__&from=__RP_TOK_2__&to=__RP_TOK_3__&page_token=__RP_TOK_4__\"),\n Headers =\n {\n { \"Authorization\", \"__RP_TOK_5__\" },\n { \"Revolut-Api-Version\", \"__RP_TOK_6__\" },\n }\n};\n\nusing (var response = await client.SendAsync(request))\n{\n response.EnsureSuccessStatusCode();\n var body = await response.Content.ReadAsStringAsync();\n Console.WriteLine(body);\n}","templateHtml":"$66d","tokens":[{"marker":"__RP_TOK_0__","paramName":"subscription_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"limit","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"from","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_3__","paramName":"to","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_4__","paramName":"page_token","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_5__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_6__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:subscription_id":"123e4567-e89b-12d3-a456-426614174000","query:limit":"100","query:from":"2024-01-01T00:00:00Z","query:to":"2024-01-01T00:00:00Z","query:page_token":"string"}}]},"method":"get","servers":"$62:props:children:0:props:children:props:children:1:props:children:1:props:children:0:0:props:servers","path":"/api/subscriptions/{subscription_id}/cycles","parameters":["$637:props:children:0:props:children:1:props:parameters:0","$637:props:children:0:props:children:1:props:parameters:1","$637:props:children:0:props:children:1:props:parameters:2","$637:props:children:0:props:children:1:props:parameters:3","$637:props:children:0:props:children:1:props:parameters:4","$637:props:children:0:props:children:1:props:parameters:5","$637:props:children:0:props:children:1:props:parameters:6"]}],"$L66e"],"$L66f","$L670"]}]]}] 650:["$","div",null,{"className":"ezz1n30","children":[["$","div",null,{"data-header":"$undefined","className":"ezz1n31","children":["$","div",null,{"className":"y9a0do1","children":[["$","h2",null,{"id":"retrieve-subscription-usage-list","children":[["$L671","$undefined"],["$","$L15",null,{"id":"retrieve-subscription-usage-list"}]]}],["$","$L16",null,{"url":"/docs/api/merchant/2025-10-16/operations/retrieve-subscription-usage-list.md"}]]}]}],"$undefined"]}] 67b:T47e,
curl -X GET "https://merchant.revolut.com/api/subscription-usages?limit=__RP_TOK_0__&from_usage_date=__RP_TOK_1__&to_usage_date=__RP_TOK_2__&subscription_id=__RP_TOK_3__&subscription_cycle_id=__RP_TOK_4__&page_token=__RP_TOK_5__" \
  -H "Authorization: __RP_TOK_6__" \
  -H "Revolut-Api-Version: __RP_TOK_7__"
67c:Ta8c,
fetch("https://merchant.revolut.com/api/subscription-usages?limit=__RP_TOK_0__&from_usage_date=__RP_TOK_1__&to_usage_date=__RP_TOK_2__&subscription_id=__RP_TOK_3__&subscription_cycle_id=__RP_TOK_4__&page_token=__RP_TOK_5__", {
  method: "GET",
  headers: {
    "Authorization": "__RP_TOK_6__",
    "Revolut-Api-Version": "__RP_TOK_7__"
  }
})
  .then(response => response.json())
  .then(data => console.log(data));
67d:T1029,
package main

import (
  "fmt"
  "net/http"
)

func main() {
  url := "https://merchant.revolut.com/api/subscription-usages?limit=__RP_TOK_0__&from_usage_date=__RP_TOK_1__&to_usage_date=__RP_TOK_2__&subscription_id=__RP_TOK_3__&subscription_cycle_id=__RP_TOK_4__&page_token=__RP_TOK_5__"
  req, _ := http.NewRequest("GET", url, nil)
  req.Header.Add("Authorization", "__RP_TOK_6__")
  req.Header.Add("Revolut-Api-Version", "__RP_TOK_7__")

  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  fmt.Println(res)
}
67e:T89e,
import requests

url = "https://merchant.revolut.com/api/subscription-usages?limit=__RP_TOK_0__&from_usage_date=__RP_TOK_1__&to_usage_date=__RP_TOK_2__&subscription_id=__RP_TOK_3__&subscription_cycle_id=__RP_TOK_4__&page_token=__RP_TOK_5__"
headers = {
  "Authorization": "__RP_TOK_6__",
  "Revolut-Api-Version": "__RP_TOK_7__"
}

response = requests.get(url, headers=headers)
print(response.json())
67f:T17ca,
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;

public class Main {
  public static void main(String[] args) {
    HttpClient client = HttpClient.newHttpClient();
    HttpRequest request = HttpRequest.newBuilder()
      .uri(URI.create("https://merchant.revolut.com/api/subscription-usages?limit=__RP_TOK_0__&from_usage_date=__RP_TOK_1__&to_usage_date=__RP_TOK_2__&subscription_id=__RP_TOK_3__&subscription_cycle_id=__RP_TOK_4__&page_token=__RP_TOK_5__"))
      .header("Authorization", "__RP_TOK_6__")
      .header("Revolut-Api-Version", "__RP_TOK_7__")
      .GET(HttpRequest.BodyPublishers.noBody())
      .build();

    client.sendAsync(request, HttpResponse.BodyHandlers.ofString())
      .thenApply(HttpResponse::body)
      .thenAccept(System.out::println)
      .join();
  }
}
680:T1674,
using System.Net.Http;
using System.Net.Http.Headers;

var client = new HttpClient();
var request = new HttpRequestMessage
{
  Method = HttpMethod.Get,
  RequestUri = new Uri("https://merchant.revolut.com/api/subscription-usages?limit=__RP_TOK_0__&from_usage_date=__RP_TOK_1__&to_usage_date=__RP_TOK_2__&subscription_id=__RP_TOK_3__&subscription_cycle_id=__RP_TOK_4__&page_token=__RP_TOK_5__"),
  Headers =
  {
    { "Authorization", "__RP_TOK_6__" },
    { "Revolut-Api-Version", "__RP_TOK_7__" },
  }
};

using (var response = await client.SendAsync(request))
{
  response.EnsureSuccessStatusCode();
  var body = await response.Content.ReadAsStringAsync();
  Console.WriteLine(body);
}
681:T486,
curl -X GET "https://sandbox-merchant.revolut.com/api/subscription-usages?limit=__RP_TOK_0__&from_usage_date=__RP_TOK_1__&to_usage_date=__RP_TOK_2__&subscription_id=__RP_TOK_3__&subscription_cycle_id=__RP_TOK_4__&page_token=__RP_TOK_5__" \
  -H "Authorization: __RP_TOK_6__" \
  -H "Revolut-Api-Version: __RP_TOK_7__"
682:Ta94,
fetch("https://sandbox-merchant.revolut.com/api/subscription-usages?limit=__RP_TOK_0__&from_usage_date=__RP_TOK_1__&to_usage_date=__RP_TOK_2__&subscription_id=__RP_TOK_3__&subscription_cycle_id=__RP_TOK_4__&page_token=__RP_TOK_5__", {
  method: "GET",
  headers: {
    "Authorization": "__RP_TOK_6__",
    "Revolut-Api-Version": "__RP_TOK_7__"
  }
})
  .then(response => response.json())
  .then(data => console.log(data));
683:T1031,
package main

import (
  "fmt"
  "net/http"
)

func main() {
  url := "https://sandbox-merchant.revolut.com/api/subscription-usages?limit=__RP_TOK_0__&from_usage_date=__RP_TOK_1__&to_usage_date=__RP_TOK_2__&subscription_id=__RP_TOK_3__&subscription_cycle_id=__RP_TOK_4__&page_token=__RP_TOK_5__"
  req, _ := http.NewRequest("GET", url, nil)
  req.Header.Add("Authorization", "__RP_TOK_6__")
  req.Header.Add("Revolut-Api-Version", "__RP_TOK_7__")

  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  fmt.Println(res)
}
684:T8a6,
import requests

url = "https://sandbox-merchant.revolut.com/api/subscription-usages?limit=__RP_TOK_0__&from_usage_date=__RP_TOK_1__&to_usage_date=__RP_TOK_2__&subscription_id=__RP_TOK_3__&subscription_cycle_id=__RP_TOK_4__&page_token=__RP_TOK_5__"
headers = {
  "Authorization": "__RP_TOK_6__",
  "Revolut-Api-Version": "__RP_TOK_7__"
}

response = requests.get(url, headers=headers)
print(response.json())
685:T17d2,
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;

public class Main {
  public static void main(String[] args) {
    HttpClient client = HttpClient.newHttpClient();
    HttpRequest request = HttpRequest.newBuilder()
      .uri(URI.create("https://sandbox-merchant.revolut.com/api/subscription-usages?limit=__RP_TOK_0__&from_usage_date=__RP_TOK_1__&to_usage_date=__RP_TOK_2__&subscription_id=__RP_TOK_3__&subscription_cycle_id=__RP_TOK_4__&page_token=__RP_TOK_5__"))
      .header("Authorization", "__RP_TOK_6__")
      .header("Revolut-Api-Version", "__RP_TOK_7__")
      .GET(HttpRequest.BodyPublishers.noBody())
      .build();

    client.sendAsync(request, HttpResponse.BodyHandlers.ofString())
      .thenApply(HttpResponse::body)
      .thenAccept(System.out::println)
      .join();
  }
}
686:T167c,
using System.Net.Http;
using System.Net.Http.Headers;

var client = new HttpClient();
var request = new HttpRequestMessage
{
  Method = HttpMethod.Get,
  RequestUri = new Uri("https://sandbox-merchant.revolut.com/api/subscription-usages?limit=__RP_TOK_0__&from_usage_date=__RP_TOK_1__&to_usage_date=__RP_TOK_2__&subscription_id=__RP_TOK_3__&subscription_cycle_id=__RP_TOK_4__&page_token=__RP_TOK_5__"),
  Headers =
  {
    { "Authorization", "__RP_TOK_6__" },
    { "Revolut-Api-Version", "__RP_TOK_7__" },
  }
};

using (var response = await client.SendAsync(request))
{
  response.EnsureSuccessStatusCode();
  var body = await response.Content.ReadAsStringAsync();
  Console.WriteLine(body);
}
651:["$","div",null,{"className":"ezz1n30","children":[["$","div",null,{"data-header":"$undefined","className":"ezz1n31","children":["$L672",["$","$L85",null,{"parameters":[{"name":"Authorization","in":"header","schema":{"type":"string","format":"Bearer ","examples":"$62:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:0:schema:examples"},"required":true,"description":"This parameter accepts the [Merchant API Secret key](https://business.revolut.com/settings/apis?tab=merchant-api) to authorise requests coming from the merchant's backend. \n\nIt ensures that ensures that each request is authenticated and authorised by verifying the secret key. The secret key should be included in all request headers as a `Bearer` token.\n\n:::info\nFor more information, see: [Authentication](https://developer.revolut.com/docs/api/merchant#authentication)\n:::","descriptionNode":"$L673"},{"name":"Revolut-Api-Version","in":"header","schema":{"type":"string","format":"date","enum":"$36:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:1:schema:enum","examples":"$36:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:1:schema:examples"},"required":true,"description":"The version of the Merchant API, specified in `YYYY-MM-DD` format.\n\nIf not specified, you will receive an error.\n\n\n:::info\nFor more information about API versioning, see: [API versions](https://developer.revolut.com/docs/guides/merchant/reference/versioning/api-versions).\n:::","x-config-always-visible-in-example":true,"example":"2025-10-16","descriptionNode":"$L674"},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":500,"default":100},"description":"Maximum number of records to return. Used for **pagination**.","required":false,"descriptionNode":"$L675"},{"name":"from_usage_date","in":"query","schema":{"type":"string","format":"date-time"},"description":"Filter usage records with a `usage_date` on or after this date and time.","required":false,"descriptionNode":"$L676"},{"name":"to_usage_date","in":"query","schema":{"type":"string","format":"date-time"},"description":"Filter usage records with a `usage_date` before this date and time.","required":false,"descriptionNode":"$L677"},{"name":"subscription_id","in":"query","schema":{"type":"string","format":"uuid"},"description":"Filter usages by the ID of the subscription.","required":false,"descriptionNode":"$L678"},{"name":"subscription_cycle_id","in":"query","schema":{"type":"string","format":"uuid"},"description":"Filter usages by the ID of the subscription cycle.","required":false,"descriptionNode":"$L679"},{"name":"page_token","in":"query","schema":{"type":"string"},"description":"Token for retrieving the next page of results. Used for **pagination**.\n\nTo paginate through results:\n\n 1. Make an initial request with the desired `limit`.\n 1. The response will include a `next_page_token` if more results are available.\n 1. Use that token in the `page_token` parameter of your next request.\n 1. Repeat until `next_page_token` is not present.\n\n:::note\nWhen using `page_token`, you must include all query parameters from the initial request (such as `from`, `to`, or other filter parameters) to maintain consistent filtering across pages.\n:::","required":false,"descriptionNode":"$L67a"}],"requestBody":"$undefined","heading":"Request","requestBodySchemaTitle":"Request body","headingAs":"h3"}],["$","$L89",null,{"responses":"$3c:props:children:0:props:children:props:responses","headingAs":"h3"}]]}],["$","div",null,{"className":"ezz1n32","children":[[["$","$L8a",null,{"itemsByServer":{"https://merchant.revolut.com":[{"id":"curl","label":"cURL","templateCode":"curl -X GET \"https://merchant.revolut.com/api/subscription-usages?limit=__RP_TOK_0__&from_usage_date=__RP_TOK_1__&to_usage_date=__RP_TOK_2__&subscription_id=__RP_TOK_3__&subscription_cycle_id=__RP_TOK_4__&page_token=__RP_TOK_5__\" \\\n -H \"Authorization: __RP_TOK_6__\" \\\n -H \"Revolut-Api-Version: __RP_TOK_7__\"","templateHtml":"$67b","tokens":[{"marker":"__RP_TOK_0__","paramName":"limit","paramIn":"query","pipeline":["url-component","shell-double-inner"]},{"marker":"__RP_TOK_1__","paramName":"from_usage_date","paramIn":"query","pipeline":["url-component","shell-double-inner"]},{"marker":"__RP_TOK_2__","paramName":"to_usage_date","paramIn":"query","pipeline":["url-component","shell-double-inner"]},{"marker":"__RP_TOK_3__","paramName":"subscription_id","paramIn":"query","pipeline":["url-component","shell-double-inner"]},{"marker":"__RP_TOK_4__","paramName":"subscription_cycle_id","paramIn":"query","pipeline":["url-component","shell-double-inner"]},{"marker":"__RP_TOK_5__","paramName":"page_token","paramIn":"query","pipeline":["url-component","shell-double-inner"]},{"marker":"__RP_TOK_6__","paramName":"Authorization","paramIn":"header","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_7__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["shell-double-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","query:limit":"100","query:from_usage_date":"2024-01-01T00:00:00Z","query:to_usage_date":"2024-01-01T00:00:00Z","query:subscription_id":"123e4567-e89b-12d3-a456-426614174000","query:subscription_cycle_id":"123e4567-e89b-12d3-a456-426614174000","query:page_token":"string"}},{"id":"javascript","label":"JavaScript","templateCode":"fetch(\"https://merchant.revolut.com/api/subscription-usages?limit=__RP_TOK_0__&from_usage_date=__RP_TOK_1__&to_usage_date=__RP_TOK_2__&subscription_id=__RP_TOK_3__&subscription_cycle_id=__RP_TOK_4__&page_token=__RP_TOK_5__\", {\n method: \"GET\",\n headers: {\n \"Authorization\": \"__RP_TOK_6__\",\n \"Revolut-Api-Version\": \"__RP_TOK_7__\"\n }\n})\n .then(response => response.json())\n .then(data => console.log(data));","templateHtml":"$67c","tokens":[{"marker":"__RP_TOK_0__","paramName":"limit","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"from_usage_date","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"to_usage_date","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_3__","paramName":"subscription_id","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_4__","paramName":"subscription_cycle_id","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_5__","paramName":"page_token","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_6__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_7__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","query:limit":"100","query:from_usage_date":"2024-01-01T00:00:00Z","query:to_usage_date":"2024-01-01T00:00:00Z","query:subscription_id":"123e4567-e89b-12d3-a456-426614174000","query:subscription_cycle_id":"123e4567-e89b-12d3-a456-426614174000","query:page_token":"string"}},{"id":"go","label":"Go","templateCode":"package main\n\nimport (\n \"fmt\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://merchant.revolut.com/api/subscription-usages?limit=__RP_TOK_0__&from_usage_date=__RP_TOK_1__&to_usage_date=__RP_TOK_2__&subscription_id=__RP_TOK_3__&subscription_cycle_id=__RP_TOK_4__&page_token=__RP_TOK_5__\"\n req, _ := http.NewRequest(\"GET\", url, nil)\n req.Header.Add(\"Authorization\", \"__RP_TOK_6__\")\n req.Header.Add(\"Revolut-Api-Version\", \"__RP_TOK_7__\")\n\n res, _ := http.DefaultClient.Do(req)\n defer res.Body.Close()\n fmt.Println(res)\n}","templateHtml":"$67d","tokens":[{"marker":"__RP_TOK_0__","paramName":"limit","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"from_usage_date","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"to_usage_date","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_3__","paramName":"subscription_id","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_4__","paramName":"subscription_cycle_id","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_5__","paramName":"page_token","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_6__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_7__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","query:limit":"100","query:from_usage_date":"2024-01-01T00:00:00Z","query:to_usage_date":"2024-01-01T00:00:00Z","query:subscription_id":"123e4567-e89b-12d3-a456-426614174000","query:subscription_cycle_id":"123e4567-e89b-12d3-a456-426614174000","query:page_token":"string"}},{"id":"python","label":"Python","templateCode":"import requests\n\nurl = \"https://merchant.revolut.com/api/subscription-usages?limit=__RP_TOK_0__&from_usage_date=__RP_TOK_1__&to_usage_date=__RP_TOK_2__&subscription_id=__RP_TOK_3__&subscription_cycle_id=__RP_TOK_4__&page_token=__RP_TOK_5__\"\nheaders = {\n \"Authorization\": \"__RP_TOK_6__\",\n \"Revolut-Api-Version\": \"__RP_TOK_7__\"\n}\n\nresponse = requests.get(url, headers=headers)\nprint(response.json())","templateHtml":"$67e","tokens":[{"marker":"__RP_TOK_0__","paramName":"limit","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"from_usage_date","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"to_usage_date","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_3__","paramName":"subscription_id","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_4__","paramName":"subscription_cycle_id","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_5__","paramName":"page_token","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_6__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_7__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","query:limit":"100","query:from_usage_date":"2024-01-01T00:00:00Z","query:to_usage_date":"2024-01-01T00:00:00Z","query:subscription_id":"123e4567-e89b-12d3-a456-426614174000","query:subscription_cycle_id":"123e4567-e89b-12d3-a456-426614174000","query:page_token":"string"}},{"id":"java","label":"Java","templateCode":"import java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\nimport java.net.URI;\n\npublic class Main {\n public static void main(String[] args) {\n HttpClient client = HttpClient.newHttpClient();\n HttpRequest request = HttpRequest.newBuilder()\n .uri(URI.create(\"https://merchant.revolut.com/api/subscription-usages?limit=__RP_TOK_0__&from_usage_date=__RP_TOK_1__&to_usage_date=__RP_TOK_2__&subscription_id=__RP_TOK_3__&subscription_cycle_id=__RP_TOK_4__&page_token=__RP_TOK_5__\"))\n .header(\"Authorization\", \"__RP_TOK_6__\")\n .header(\"Revolut-Api-Version\", \"__RP_TOK_7__\")\n .GET(HttpRequest.BodyPublishers.noBody())\n .build();\n\n client.sendAsync(request, HttpResponse.BodyHandlers.ofString())\n .thenApply(HttpResponse::body)\n .thenAccept(System.out::println)\n .join();\n }\n}","templateHtml":"$67f","tokens":[{"marker":"__RP_TOK_0__","paramName":"limit","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"from_usage_date","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"to_usage_date","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_3__","paramName":"subscription_id","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_4__","paramName":"subscription_cycle_id","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_5__","paramName":"page_token","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_6__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_7__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","query:limit":"100","query:from_usage_date":"2024-01-01T00:00:00Z","query:to_usage_date":"2024-01-01T00:00:00Z","query:subscription_id":"123e4567-e89b-12d3-a456-426614174000","query:subscription_cycle_id":"123e4567-e89b-12d3-a456-426614174000","query:page_token":"string"}},{"id":"csharp","label":"C#","templateCode":"using System.Net.Http;\nusing System.Net.Http.Headers;\n\nvar client = new HttpClient();\nvar request = new HttpRequestMessage\n{\n Method = HttpMethod.Get,\n RequestUri = new Uri(\"https://merchant.revolut.com/api/subscription-usages?limit=__RP_TOK_0__&from_usage_date=__RP_TOK_1__&to_usage_date=__RP_TOK_2__&subscription_id=__RP_TOK_3__&subscription_cycle_id=__RP_TOK_4__&page_token=__RP_TOK_5__\"),\n Headers =\n {\n { \"Authorization\", \"__RP_TOK_6__\" },\n { \"Revolut-Api-Version\", \"__RP_TOK_7__\" },\n }\n};\n\nusing (var response = await client.SendAsync(request))\n{\n response.EnsureSuccessStatusCode();\n var body = await response.Content.ReadAsStringAsync();\n Console.WriteLine(body);\n}","templateHtml":"$680","tokens":[{"marker":"__RP_TOK_0__","paramName":"limit","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"from_usage_date","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"to_usage_date","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_3__","paramName":"subscription_id","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_4__","paramName":"subscription_cycle_id","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_5__","paramName":"page_token","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_6__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_7__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","query:limit":"100","query:from_usage_date":"2024-01-01T00:00:00Z","query:to_usage_date":"2024-01-01T00:00:00Z","query:subscription_id":"123e4567-e89b-12d3-a456-426614174000","query:subscription_cycle_id":"123e4567-e89b-12d3-a456-426614174000","query:page_token":"string"}}],"https://sandbox-merchant.revolut.com":[{"id":"curl","label":"cURL","templateCode":"curl -X GET \"https://sandbox-merchant.revolut.com/api/subscription-usages?limit=__RP_TOK_0__&from_usage_date=__RP_TOK_1__&to_usage_date=__RP_TOK_2__&subscription_id=__RP_TOK_3__&subscription_cycle_id=__RP_TOK_4__&page_token=__RP_TOK_5__\" \\\n -H \"Authorization: __RP_TOK_6__\" \\\n -H \"Revolut-Api-Version: __RP_TOK_7__\"","templateHtml":"$681","tokens":[{"marker":"__RP_TOK_0__","paramName":"limit","paramIn":"query","pipeline":["url-component","shell-double-inner"]},{"marker":"__RP_TOK_1__","paramName":"from_usage_date","paramIn":"query","pipeline":["url-component","shell-double-inner"]},{"marker":"__RP_TOK_2__","paramName":"to_usage_date","paramIn":"query","pipeline":["url-component","shell-double-inner"]},{"marker":"__RP_TOK_3__","paramName":"subscription_id","paramIn":"query","pipeline":["url-component","shell-double-inner"]},{"marker":"__RP_TOK_4__","paramName":"subscription_cycle_id","paramIn":"query","pipeline":["url-component","shell-double-inner"]},{"marker":"__RP_TOK_5__","paramName":"page_token","paramIn":"query","pipeline":["url-component","shell-double-inner"]},{"marker":"__RP_TOK_6__","paramName":"Authorization","paramIn":"header","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_7__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["shell-double-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","query:limit":"100","query:from_usage_date":"2024-01-01T00:00:00Z","query:to_usage_date":"2024-01-01T00:00:00Z","query:subscription_id":"123e4567-e89b-12d3-a456-426614174000","query:subscription_cycle_id":"123e4567-e89b-12d3-a456-426614174000","query:page_token":"string"}},{"id":"javascript","label":"JavaScript","templateCode":"fetch(\"https://sandbox-merchant.revolut.com/api/subscription-usages?limit=__RP_TOK_0__&from_usage_date=__RP_TOK_1__&to_usage_date=__RP_TOK_2__&subscription_id=__RP_TOK_3__&subscription_cycle_id=__RP_TOK_4__&page_token=__RP_TOK_5__\", {\n method: \"GET\",\n headers: {\n \"Authorization\": \"__RP_TOK_6__\",\n \"Revolut-Api-Version\": \"__RP_TOK_7__\"\n }\n})\n .then(response => response.json())\n .then(data => console.log(data));","templateHtml":"$682","tokens":[{"marker":"__RP_TOK_0__","paramName":"limit","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"from_usage_date","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"to_usage_date","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_3__","paramName":"subscription_id","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_4__","paramName":"subscription_cycle_id","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_5__","paramName":"page_token","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_6__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_7__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","query:limit":"100","query:from_usage_date":"2024-01-01T00:00:00Z","query:to_usage_date":"2024-01-01T00:00:00Z","query:subscription_id":"123e4567-e89b-12d3-a456-426614174000","query:subscription_cycle_id":"123e4567-e89b-12d3-a456-426614174000","query:page_token":"string"}},{"id":"go","label":"Go","templateCode":"package main\n\nimport (\n \"fmt\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://sandbox-merchant.revolut.com/api/subscription-usages?limit=__RP_TOK_0__&from_usage_date=__RP_TOK_1__&to_usage_date=__RP_TOK_2__&subscription_id=__RP_TOK_3__&subscription_cycle_id=__RP_TOK_4__&page_token=__RP_TOK_5__\"\n req, _ := http.NewRequest(\"GET\", url, nil)\n req.Header.Add(\"Authorization\", \"__RP_TOK_6__\")\n req.Header.Add(\"Revolut-Api-Version\", \"__RP_TOK_7__\")\n\n res, _ := http.DefaultClient.Do(req)\n defer res.Body.Close()\n fmt.Println(res)\n}","templateHtml":"$683","tokens":[{"marker":"__RP_TOK_0__","paramName":"limit","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"from_usage_date","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"to_usage_date","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_3__","paramName":"subscription_id","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_4__","paramName":"subscription_cycle_id","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_5__","paramName":"page_token","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_6__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_7__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","query:limit":"100","query:from_usage_date":"2024-01-01T00:00:00Z","query:to_usage_date":"2024-01-01T00:00:00Z","query:subscription_id":"123e4567-e89b-12d3-a456-426614174000","query:subscription_cycle_id":"123e4567-e89b-12d3-a456-426614174000","query:page_token":"string"}},{"id":"python","label":"Python","templateCode":"import requests\n\nurl = \"https://sandbox-merchant.revolut.com/api/subscription-usages?limit=__RP_TOK_0__&from_usage_date=__RP_TOK_1__&to_usage_date=__RP_TOK_2__&subscription_id=__RP_TOK_3__&subscription_cycle_id=__RP_TOK_4__&page_token=__RP_TOK_5__\"\nheaders = {\n \"Authorization\": \"__RP_TOK_6__\",\n \"Revolut-Api-Version\": \"__RP_TOK_7__\"\n}\n\nresponse = requests.get(url, headers=headers)\nprint(response.json())","templateHtml":"$684","tokens":[{"marker":"__RP_TOK_0__","paramName":"limit","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"from_usage_date","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"to_usage_date","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_3__","paramName":"subscription_id","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_4__","paramName":"subscription_cycle_id","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_5__","paramName":"page_token","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_6__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_7__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","query:limit":"100","query:from_usage_date":"2024-01-01T00:00:00Z","query:to_usage_date":"2024-01-01T00:00:00Z","query:subscription_id":"123e4567-e89b-12d3-a456-426614174000","query:subscription_cycle_id":"123e4567-e89b-12d3-a456-426614174000","query:page_token":"string"}},{"id":"java","label":"Java","templateCode":"import java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\nimport java.net.URI;\n\npublic class Main {\n public static void main(String[] args) {\n HttpClient client = HttpClient.newHttpClient();\n HttpRequest request = HttpRequest.newBuilder()\n .uri(URI.create(\"https://sandbox-merchant.revolut.com/api/subscription-usages?limit=__RP_TOK_0__&from_usage_date=__RP_TOK_1__&to_usage_date=__RP_TOK_2__&subscription_id=__RP_TOK_3__&subscription_cycle_id=__RP_TOK_4__&page_token=__RP_TOK_5__\"))\n .header(\"Authorization\", \"__RP_TOK_6__\")\n .header(\"Revolut-Api-Version\", \"__RP_TOK_7__\")\n .GET(HttpRequest.BodyPublishers.noBody())\n .build();\n\n client.sendAsync(request, HttpResponse.BodyHandlers.ofString())\n .thenApply(HttpResponse::body)\n .thenAccept(System.out::println)\n .join();\n }\n}","templateHtml":"$685","tokens":[{"marker":"__RP_TOK_0__","paramName":"limit","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"from_usage_date","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"to_usage_date","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_3__","paramName":"subscription_id","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_4__","paramName":"subscription_cycle_id","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_5__","paramName":"page_token","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_6__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_7__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","query:limit":"100","query:from_usage_date":"2024-01-01T00:00:00Z","query:to_usage_date":"2024-01-01T00:00:00Z","query:subscription_id":"123e4567-e89b-12d3-a456-426614174000","query:subscription_cycle_id":"123e4567-e89b-12d3-a456-426614174000","query:page_token":"string"}},{"id":"csharp","label":"C#","templateCode":"using System.Net.Http;\nusing System.Net.Http.Headers;\n\nvar client = new HttpClient();\nvar request = new HttpRequestMessage\n{\n Method = HttpMethod.Get,\n RequestUri = new Uri(\"https://sandbox-merchant.revolut.com/api/subscription-usages?limit=__RP_TOK_0__&from_usage_date=__RP_TOK_1__&to_usage_date=__RP_TOK_2__&subscription_id=__RP_TOK_3__&subscription_cycle_id=__RP_TOK_4__&page_token=__RP_TOK_5__\"),\n Headers =\n {\n { \"Authorization\", \"__RP_TOK_6__\" },\n { \"Revolut-Api-Version\", \"__RP_TOK_7__\" },\n }\n};\n\nusing (var response = await client.SendAsync(request))\n{\n response.EnsureSuccessStatusCode();\n var body = await response.Content.ReadAsStringAsync();\n Console.WriteLine(body);\n}","templateHtml":"$686","tokens":[{"marker":"__RP_TOK_0__","paramName":"limit","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"from_usage_date","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"to_usage_date","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_3__","paramName":"subscription_id","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_4__","paramName":"subscription_cycle_id","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_5__","paramName":"page_token","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_6__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_7__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","query:limit":"100","query:from_usage_date":"2024-01-01T00:00:00Z","query:to_usage_date":"2024-01-01T00:00:00Z","query:subscription_id":"123e4567-e89b-12d3-a456-426614174000","query:subscription_cycle_id":"123e4567-e89b-12d3-a456-426614174000","query:page_token":"string"}}]},"method":"get","servers":"$62:props:children:0:props:children:props:children:1:props:children:1:props:children:0:0:props:servers","path":"/api/subscription-usages","parameters":["$651:props:children:0:props:children:1:props:parameters:0","$651:props:children:0:props:children:1:props:parameters:1","$651:props:children:0:props:children:1:props:parameters:2","$651:props:children:0:props:children:1:props:parameters:3","$651:props:children:0:props:children:1:props:parameters:4","$651:props:children:0:props:children:1:props:parameters:5","$651:props:children:0:props:children:1:props:parameters:6","$651:props:children:0:props:children:1:props:parameters:7"]}],"$L687"],"$L688","$L689"]}]]}] 653:["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"next_page_token\": \"9e5d2caa-bb60-4b5b-b7cf-6345bbdff67e\",\n \"customers\": [\n {\n \"id\": \"9dfb8491-bfb0-4420-ad63-0fa7bdd3dffb\",\n \"full_name\": \"First Customer\",\n \"email\": \"first.customer@example.com\",\n \"created_at\": \"2020-06-24T12:12:56.596703Z\",\n \"updated_at\": \"2020-06-24T12:12:56.737082Z\"\n },\n {\n \"id\": \"6c7c97a8-cfc1-4cf3-8b38-26a74fdf1fae\",\n \"full_name\": \"Second Customer\",\n \"email\": \"second.customer@example.com\",\n \"phone\": \"+441234567890\",\n \"created_at\": \"2020-06-24T12:03:39.979397Z\",\n \"updated_at\": \"2020-06-25T10:03:39.134417Z\"\n }\n ]\n}"}]}] 405:["$","div","CodeBlock-0",{"className":"wzy01m0 _18b50nc0","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"
'Authorization: Bearer <yourSecretApiKey>'
"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"'Authorization: Bearer '\n"}]}]]}] 406:["$","div","CodeBlock-0",{"className":"wzy01m0 _18b50nc0","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"
'Authorization: Bearer <yourSecretApiKey>'
"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"'Authorization: Bearer '\n"}]}]]}] 408:["$","div","request-application/json-webhook_signing_secret_rotate_request",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"
{\n  \"expiration_period\": \"PT5H30M\"\n}
"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"expiration_period\": \"PT5H30M\"\n}"}]}]]}] 68a:T69c,
{
  "id": "c6b981f4-53b3-47d5-9b24-4f87af1160eb",
  "url": "https://example.com/webhooks",
  "events": [
    "ORDER_AUTHORISED",
    "ORDER_COMPLETED"
  ],
  "signing_secret": "wsk_4jETWMz1g1b37gCONjNp84t2KSSIT7dK"
}
409:["$","div","200-application/json-updated_webhook",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$68a"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"id\": \"c6b981f4-53b3-47d5-9b24-4f87af1160eb\",\n \"url\": \"https://example.com/webhooks\",\n \"events\": [\n \"ORDER_AUTHORISED\",\n \"ORDER_COMPLETED\"\n ],\n \"signing_secret\": \"wsk_4jETWMz1g1b37gCONjNp84t2KSSIT7dK\"\n}"}]}]]}] 68b:T44d,
{
  "code": "string",
  "message": "string",
  "timestamp": 123
}
40a:["$","div","400-application/json-default",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$68b"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"code\": \"string\",\n \"message\": \"string\",\n \"timestamp\": 123\n}"}]}]]}] 68c:T44d,
{
  "code": "string",
  "message": "string",
  "timestamp": 123
}
40b:["$","div","401-application/json-default",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$68c"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"code\": \"string\",\n \"message\": \"string\",\n \"timestamp\": 123\n}"}]}]]}] 68d:T44d,
{
  "code": "string",
  "message": "string",
  "timestamp": 123
}
40c:["$","div","404-application/json-default",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$68d"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"code\": \"string\",\n \"message\": \"string\",\n \"timestamp\": 123\n}"}]}]]}] 5fb:"Create a payment intent" 66e:["$","$L10d",null,{"security":[{"Api-Key":[]}],"authorization":{"Api-Key":{"type":"apiKey","in":"header","name":"Authorization","description":"Each Merchant API request must contain an authorization header in the following format:\n\n```\n'Authorization: Bearer '\n```\n\nTo use this API, you need to generate API keys from your Revolut Business account. The Secret key is used in the authorization header for all server calls, while the Public key is provided with payment methods at checkout.\n\n:::info\nFor detailed instructions on generating your API keys, see: [Generate API keys](https://developer.revolut.com/docs/guides/merchant/get-started#generate-api-keys).\n:::","descriptionNode":"$L68e"}}}] 66f:["$","$L10f",null,{"exampleBlocks":{},"title":"Request body samples","headingAs":"h4"}] 670:["$","$L110",null,{"exampleBlocks":{"200":{"application/json":{"variants":[{"key":"cycles_list","label":"List of subscription cycles","rawValue":"$39:props:children:0:props:children:props:responses:200:content:application/json:examples:cycles_list:value","block":"$L68f"}],"syncedPropertyName":"$undefined"}},"400":{"application/json":{"variants":[{"key":"default","label":"Example","rawValue":{"code":"string","message":"string","timestamp":123},"block":"$L690"}],"syncedPropertyName":"$undefined"}},"401":{"application/json":{"variants":[{"key":"default","label":"Example","rawValue":{"code":"string","message":"string","timestamp":123},"block":"$L691"}],"syncedPropertyName":"$undefined"}},"404":{"application/json":{"variants":[{"key":"default","label":"Example","rawValue":{"code":"string","message":"string","timestamp":123},"block":"$L692"}],"syncedPropertyName":"$undefined"}},"default":{"application/json":{"variants":[{"key":"default","label":"Example","rawValue":{"code":"string","message":"string","timestamp":123},"block":"$L693"}],"syncedPropertyName":"$undefined"}}},"headingAs":"h4"}] 687:["$","$L10d",null,{"security":[{"Api-Key":[]}],"authorization":{"Api-Key":{"type":"apiKey","in":"header","name":"Authorization","description":"Each Merchant API request must contain an authorization header in the following format:\n\n```\n'Authorization: Bearer '\n```\n\nTo use this API, you need to generate API keys from your Revolut Business account. The Secret key is used in the authorization header for all server calls, while the Public key is provided with payment methods at checkout.\n\n:::info\nFor detailed instructions on generating your API keys, see: [Generate API keys](https://developer.revolut.com/docs/guides/merchant/get-started#generate-api-keys).\n:::","descriptionNode":"$L694"}}}] 688:["$","$L10f",null,{"exampleBlocks":{},"title":"Request body samples","headingAs":"h4"}] 689:["$","$L110",null,{"exampleBlocks":{"200":{"application/json":{"variants":[{"key":"usage_list","label":"Retrieve a list of usage records","rawValue":"$3c:props:children:0:props:children:props:responses:200:content:application/json:examples:usage_list:value","block":"$L695"}],"syncedPropertyName":"$undefined"}},"400":{"application/json":{"variants":[{"key":"default","label":"Example","rawValue":{"code":"string","message":"string","timestamp":123},"block":"$L696"}],"syncedPropertyName":"$undefined"}},"401":{"application/json":{"variants":[{"key":"default","label":"Example","rawValue":{"code":"string","message":"string","timestamp":123},"block":"$L697"}],"syncedPropertyName":"$undefined"}},"default":{"application/json":{"variants":[{"key":"default","label":"Example","rawValue":{"code":"string","message":"string","timestamp":123},"block":"$L698"}],"syncedPropertyName":"$undefined"}}},"headingAs":"h4"}] 480:["$","div","CodeBlock-0",{"className":"wzy01m0 _18b50nc0","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"
'Authorization: Bearer <yourSecretApiKey>'
"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"'Authorization: Bearer '\n"}]}]]}] 481:["$","div","CodeBlock-0",{"className":"wzy01m0 _18b50nc0","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"
'Authorization: Bearer <yourSecretApiKey>'
"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"'Authorization: Bearer '\n"}]}]]}] 482:["$","div","CodeBlock-0",{"className":"wzy01m0 _18b50nc0","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"
'Authorization: Bearer <yourSecretApiKey>'
"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"'Authorization: Bearer '\n"}]}]]}] 699:T12cf,
{
  "terminals": [
    {
      "id": "0e53f673-7705-473a-a263-89a3e7647c3d",
      "name": "Terminal 1",
      "type": "newland_n950",
      "serial_number": "RT-00123456",
      "battery_level": 85,
      "online": true,
      "last_online_at": "2025-01-15T14:30:00Z"
    },
    {
      "id": "a7b2c8d1-4e5f-6a7b-8c9d-0e1f2a3b4c5d",
      "name": "Terminal 2",
      "type": "newland_n950",
      "serial_number": "RT-00123457",
      "battery_level": 92,
      "online": true,
      "last_online_at": "2025-01-15T14:32:00Z"
    }
  ]
}
485:["$","div","200-application/json-terminals_list",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$699"}}]}]],"$L69a"]}] 69b:T44d,
{
  "code": "string",
  "message": "string",
  "timestamp": 123
}
486:["$","div","400-application/json-default",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$69b"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"code\": \"string\",\n \"message\": \"string\",\n \"timestamp\": 123\n}"}]}]]}] 69c:T44d,
{
  "code": "string",
  "message": "string",
  "timestamp": 123
}
487:["$","div","401-application/json-default",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$69c"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"code\": \"string\",\n \"message\": \"string\",\n \"timestamp\": 123\n}"}]}]]}] 69d:T6a5,
{
  "id": "b4d58add-b3fe-40e4-a70a-8c78df977888",
  "state": "pending",
  "order_id": "5c9fc54e-11b4-4f7f-8686-4a64d4d20db4",
  "amount": 2500,
  "currency": "GBP"
}
489:["$","div","200-application/json-payment_intent_pending",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$69d"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"id\": \"b4d58add-b3fe-40e4-a70a-8c78df977888\",\n \"state\": \"pending\",\n \"order_id\": \"5c9fc54e-11b4-4f7f-8686-4a64d4d20db4\",\n \"amount\": 2500,\n \"currency\": \"GBP\"\n}"}]}]]}] 69e:Ta1f,
{
  "id": "b4d58add-b3fe-40e4-a70a-8c78df977888",
  "order_id": "5c9fc54e-11b4-4f7f-8686-4a64d4d20db4",
  "state": "processing",
  "amount": 2500,
  "currency": "GBP",
  "terminal_id": "0e53f673-7705-473a-a263-89a3e7647c3d",
  "created_at": "2025-01-15T11:01:00Z",
  "updated_at": "2025-01-15T11:02:15Z"
}
48a:["$","div","200-application/json-payment_intent_processing",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$69e"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"id\": \"b4d58add-b3fe-40e4-a70a-8c78df977888\",\n \"order_id\": \"5c9fc54e-11b4-4f7f-8686-4a64d4d20db4\",\n \"state\": \"processing\",\n \"amount\": 2500,\n \"currency\": \"GBP\",\n \"terminal_id\": \"0e53f673-7705-473a-a263-89a3e7647c3d\",\n \"created_at\": \"2025-01-15T11:01:00Z\",\n \"updated_at\": \"2025-01-15T11:02:15Z\"\n}"}]}]]}] 69f:Tb50,
{
  "id": "b4d58add-b3fe-40e4-a70a-8c78df977888",
  "state": "completed",
  "terminal_id": "0e53f673-7705-473a-a263-89a3e7647c3d",
  "order_id": "5c9fc54e-11b4-4f7f-8686-4a64d4d20db4",
  "payment_id": "7a8b9c0d-1e2f-3a4b-5c6d-7e8f9a0b1c2d",
  "amount": 2500,
  "currency": "GBP",
  "created_at": "2025-01-15T11:01:00Z",
  "updated_at": "2025-01-15T11:02:30Z"
}
48b:["$","div","200-application/json-payment_intent_completed",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$69f"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"id\": \"b4d58add-b3fe-40e4-a70a-8c78df977888\",\n \"state\": \"completed\",\n \"terminal_id\": \"0e53f673-7705-473a-a263-89a3e7647c3d\",\n \"order_id\": \"5c9fc54e-11b4-4f7f-8686-4a64d4d20db4\",\n \"payment_id\": \"7a8b9c0d-1e2f-3a4b-5c6d-7e8f9a0b1c2d\",\n \"amount\": 2500,\n \"currency\": \"GBP\",\n \"created_at\": \"2025-01-15T11:01:00Z\",\n \"updated_at\": \"2025-01-15T11:02:30Z\"\n}"}]}]]}] 6a0:Ta1e,
{
  "id": "b4d58add-b3fe-40e4-a70a-8c78df977888",
  "state": "cancelled",
  "terminal_id": "0e53f673-7705-473a-a263-89a3e7647c3d",
  "order_id": "5c9fc54e-11b4-4f7f-8686-4a64d4d20db4",
  "amount": 2500,
  "currency": "GBP",
  "created_at": "2025-01-15T11:01:00Z",
  "updated_at": "2025-01-15T11:01:45Z"
}
48c:["$","div","200-application/json-payment_intent_cancelled",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$6a0"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"id\": \"b4d58add-b3fe-40e4-a70a-8c78df977888\",\n \"state\": \"cancelled\",\n \"terminal_id\": \"0e53f673-7705-473a-a263-89a3e7647c3d\",\n \"order_id\": \"5c9fc54e-11b4-4f7f-8686-4a64d4d20db4\",\n \"amount\": 2500,\n \"currency\": \"GBP\",\n \"created_at\": \"2025-01-15T11:01:00Z\",\n \"updated_at\": \"2025-01-15T11:01:45Z\"\n}"}]}]]}] 6a1:Ta1b,
{
  "id": "b4d58add-b3fe-40e4-a70a-8c78df977888",
  "state": "failed",
  "terminal_id": "0e53f673-7705-473a-a263-89a3e7647c3d",
  "order_id": "5c9fc54e-11b4-4f7f-8686-4a64d4d20db4",
  "amount": 2500,
  "currency": "GBP",
  "created_at": "2025-01-15T11:01:00Z",
  "updated_at": "2025-01-15T11:03:00Z"
}
48d:["$","div","200-application/json-payment_intent_failed",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$6a1"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"id\": \"b4d58add-b3fe-40e4-a70a-8c78df977888\",\n \"state\": \"failed\",\n \"terminal_id\": \"0e53f673-7705-473a-a263-89a3e7647c3d\",\n \"order_id\": \"5c9fc54e-11b4-4f7f-8686-4a64d4d20db4\",\n \"amount\": 2500,\n \"currency\": \"GBP\",\n \"created_at\": \"2025-01-15T11:01:00Z\",\n \"updated_at\": \"2025-01-15T11:03:00Z\"\n}"}]}]]}] 48e:["$","div","401-application/json-default",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"
{\n  \"errorId\": \"string\",\n  \"timestamp\": 123\n}
"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"errorId\": \"string\",\n \"timestamp\": 123\n}"}]}]]}] 48f:["$","div","404-application/json-default",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"
{\n  \"errorId\": \"string\",\n  \"timestamp\": 123\n}
"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"errorId\": \"string\",\n \"timestamp\": 123\n}"}]}]]}] 6a2:Ta1e,
{
  "id": "b4d58add-b3fe-40e4-a70a-8c78df977888",
  "state": "cancelled",
  "terminal_id": "0e53f673-7705-473a-a263-89a3e7647c3d",
  "order_id": "5c9fc54e-11b4-4f7f-8686-4a64d4d20db4",
  "amount": 2500,
  "currency": "GBP",
  "created_at": "2025-01-15T11:01:00Z",
  "updated_at": "2025-01-15T11:01:45Z"
}
491:["$","div","200-application/json-payment_intent_cancelled",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$6a2"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"id\": \"b4d58add-b3fe-40e4-a70a-8c78df977888\",\n \"state\": \"cancelled\",\n \"terminal_id\": \"0e53f673-7705-473a-a263-89a3e7647c3d\",\n \"order_id\": \"5c9fc54e-11b4-4f7f-8686-4a64d4d20db4\",\n \"amount\": 2500,\n \"currency\": \"GBP\",\n \"created_at\": \"2025-01-15T11:01:00Z\",\n \"updated_at\": \"2025-01-15T11:01:45Z\"\n}"}]}]]}] 492:["$","div","400-application/json-default",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"
{\n  \"errorId\": \"string\",\n  \"timestamp\": 123\n}
"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"errorId\": \"string\",\n \"timestamp\": 123\n}"}]}]]}] 493:["$","div","401-application/json-default",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"
{\n  \"errorId\": \"string\",\n  \"timestamp\": 123\n}
"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"errorId\": \"string\",\n \"timestamp\": 123\n}"}]}]]}] 494:["$","div","404-application/json-default",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"
{\n  \"errorId\": \"string\",\n  \"timestamp\": 123\n}
"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"errorId\": \"string\",\n \"timestamp\": 123\n}"}]}]]}] 496:["$","div","request-application/json-change_plan",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"
{\n  \"plan_variation_id\": \"850e8400-e29b-41d4-a716-446655440003\",\n  \"scheduled\": \"at_cycle_end\"\n}
"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"plan_variation_id\": \"850e8400-e29b-41d4-a716-446655440003\",\n \"scheduled\": \"at_cycle_end\"\n}"}]}]]}] 6a3:T48c,
{
  "plan_variation_id": "850e8400-e29b-41d4-a716-446655440003",
  "scheduled": "at_cycle_end",
  "reason": "customer_request"
}
497:["$","div","request-application/json-change_plan_with_reason",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$6a3"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"plan_variation_id\": \"850e8400-e29b-41d4-a716-446655440003\",\n \"scheduled\": \"at_cycle_end\",\n \"reason\": \"customer_request\"\n}"}]}]]}] 6a4:T4b1,
{
  "plan_variation_id": "850e8400-e29b-41d4-a716-446655440003",
  "plan_variation_phase_id": "950e8400-e29b-41d4-a716-446655440004",
  "scheduled": "at_cycle_end"
}
498:["$","div","request-application/json-change_plan_with_phase",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$6a4"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"plan_variation_id\": \"850e8400-e29b-41d4-a716-446655440003\",\n \"plan_variation_phase_id\": \"950e8400-e29b-41d4-a716-446655440004\",\n \"scheduled\": \"at_cycle_end\"\n}"}]}]]}] 6a5:T4b4,
{
  "code": "bad_request",
  "message": "Immediate plan change is not supported. Please provide 'scheduled' field (e.g. 'at_cycle_end')",
  "timestamp": 1601296792533
}
499:["$","div","400-application/json-immediate_not_supported",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$6a5"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"code\": \"bad_request\",\n \"message\": \"Immediate plan change is not supported. Please provide 'scheduled' field (e.g. 'at_cycle_end')\",\n \"timestamp\": 1601296792533\n}"}]}]]}] 6a6:T44d,
{
  "code": "string",
  "message": "string",
  "timestamp": 123
}
49a:["$","div","401-application/json-default",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$6a6"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"code\": \"string\",\n \"message\": \"string\",\n \"timestamp\": 123\n}"}]}]]}] 6a7:T44d,
{
  "code": "string",
  "message": "string",
  "timestamp": 123
}
49b:["$","div","404-application/json-default",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$6a7"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"code\": \"string\",\n \"message\": \"string\",\n \"timestamp\": 123\n}"}]}]]}] 6a8:T47c,
{
  "code": "subscription_finished",
  "message": "The subscription is finished",
  "timestamp": 1601296792533
}
49c:["$","div","422-application/json-subscription_finished",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$6a8"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"code\": \"subscription_finished\",\n \"message\": \"The subscription is finished\",\n \"timestamp\": 1601296792533\n}"}]}]]}] 6a9:T4a8,
{
  "code": "subscription_cycle_next_cycle_exists",
  "message": "Next cycle already exists with a different plan variation",
  "timestamp": 1601296792533
}
49d:["$","div","422-application/json-next_cycle_exists",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$6a9"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"code\": \"subscription_cycle_next_cycle_exists\",\n \"message\": \"Next cycle already exists with a different plan variation\",\n \"timestamp\": 1601296792533\n}"}]}]]}] 6aa:T44d,
{
  "code": "string",
  "message": "string",
  "timestamp": 123
}
49e:["$","div","default-application/json-default",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$6aa"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"code\": \"string\",\n \"message\": \"string\",\n \"timestamp\": 123\n}"}]}]]}] 5d9:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The unique identifier of the payment intent."}]]}] 5da:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The current state of the payment intent."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"State","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"pending"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Payment intent created and sent to terminal, customer has not yet started interacting","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"processing"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Customer is actively interacting with the terminal (e.g., inserting card, entering PIN)","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"completed"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["Payment authorization is complete, includes a ",["$","code","code-0",{"children":"payment_id"}]," in the response"],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"cancelled"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Payment intent was cancelled (by system or customer)","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-4",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"failed"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Payment intent failed due to technical issues (timeout, terminal unavailable, network error)","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 5db:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The unique identifier of the terminal."}]]}] 5dc:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Permanent order ID used to retrieve, capture, cancel, or refund an order after authorization."}]]}] 5dd:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The ID of the payment."}]]}] 5de:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The payment amount expressed in minor currency units, according to the ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_4217","target":"_blank","rel":"noreferrer","children":"ISO 4217 standard"}],". For example, ",["$","code","code-0",{"children":"7034"}]," in ",["$","code","code-1",{"children":"EUR"}]," corresponds to €70.34."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["Conversion between major and minor units varies by currency. For instance, ",["$","code","code-0",{"children":"100"}]," minor units equal £1.00 in ",["$","code","code-1",{"children":"GBP"}],", whereas in ",["$","code","code-2",{"children":"ISK"}]," they represent 100 units. For more details, see the ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_4217","target":"_blank","rel":"noreferrer","children":"ISO 4217 standard"}],"."]}]}]]}]]}] 5df:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":[["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_4217","target":"_blank","rel":"noreferrer","children":"ISO 4217"}]," currency code in upper case."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information about the supported currencies, see: ",["$","a","a-0",{"href":"https://help.revolut.com/business/help/merchant-accounts/payments/in-which-currencies-can-i-accept-payments/","target":"_blank","rel":"noreferrer","children":"Help Center"}],"."]}]}]]}]]}] 5e0:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The date and time the payment intent was created."}]]}] 5e1:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The date and time the payment intent was last updated."}]]}] 5e2:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Represents a payment intent that has been pushed to a Revolut Terminal device."}],"\n",["$","p","p-1",{"children":["When the payment intent reaches ",["$","code","code-0",{"children":"completed"}]," state, it includes a ",["$","code","code-1",{"children":"payment_id"}]," that can be used to ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#retrieve-payment-details","target":"_blank","rel":"noreferrer","children":"retrieve the final payment status"}],"."]}]]}] 5e3:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Payment intent created"}]]}] 5e4:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The ID of the error. You can share this ID with Revolut support for troubleshooting."}]]}] 5e5:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The date and time the error happened."}]]}] 5e6:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Bad Request"}]]}] 69a:["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"terminals\": [\n {\n \"id\": \"0e53f673-7705-473a-a263-89a3e7647c3d\",\n \"name\": \"Terminal 1\",\n \"type\": \"newland_n950\",\n \"serial_number\": \"RT-00123456\",\n \"battery_level\": 85,\n \"online\": true,\n \"last_online_at\": \"2025-01-15T14:30:00Z\"\n },\n {\n \"id\": \"a7b2c8d1-4e5f-6a7b-8c9d-0e1f2a3b4c5d\",\n \"name\": \"Terminal 2\",\n \"type\": \"newland_n950\",\n \"serial_number\": \"RT-00123457\",\n \"battery_level\": 92,\n \"online\": true,\n \"last_online_at\": \"2025-01-15T14:32:00Z\"\n }\n ]\n}"}]}] 4b4:["$","div","CodeBlock-0",{"className":"wzy01m0 _18b50nc0","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"
'Authorization: Bearer <yourSecretApiKey>'
"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"'Authorization: Bearer '\n"}]}]]}] 483:["$","div","CodeBlock-0",{"className":"wzy01m0 _18b50nc0","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"
https://merchant.revolut.com/api/payouts?state=completed&state=processing
"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"https://merchant.revolut.com/api/payouts?state=completed&state=processing\n"}]}]]}] 4b6:["$","div","request-application/json-challenge_min",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"
{\n  \"reason\": \"refund_already_issued\",\n  \"evidences\": [\n    \"121ac27c-b00a-44d0-9120-efeeec7c912d\"\n  ]\n}
"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"reason\": \"refund_already_issued\",\n \"evidences\": [\n \"121ac27c-b00a-44d0-9120-efeeec7c912d\"\n ]\n}"}]}]]}] 6ab:T600,
{
  "reason": "product_already_delivered",
  "comment": "The customer received the product on 2026-05-10 as confirmed by our delivery records.",
  "evidences": [
    "121ac27c-b00a-44d0-9120-efeeec7c912d",
    "0010e98d-0653-4dbe-8a4f-70cd5e9491f2"
  ]
}
4b7:["$","div","request-application/json-challenge_with_evidence",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$6ab"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"reason\": \"product_already_delivered\",\n \"comment\": \"The customer received the product on 2026-05-10 as confirmed by our delivery records.\",\n \"evidences\": [\n \"121ac27c-b00a-44d0-9120-efeeec7c912d\",\n \"0010e98d-0653-4dbe-8a4f-70cd5e9491f2\"\n ]\n}"}]}]]}] 6ac:T478,
{
  "code": "bad_request",
  "message": "Missing Revolut-Api-Version header",
  "timestamp": 1601296792533
}
4b8:["$","div","400-application/json-default",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$6ac"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"code\": \"bad_request\",\n \"message\": \"Missing Revolut-Api-Version header\",\n \"timestamp\": 1601296792533\n}"}]}]]}] 6ad:T46f,
{
  "code": "unauthenticated",
  "message": "Authentication failed",
  "timestamp": 1721049596461
}
4b9:["$","div","401-application/json-default",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$6ad"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"code\": \"unauthenticated\",\n \"message\": \"Authentication failed\",\n \"timestamp\": 1721049596461\n}"}]}]]}] 6ae:T478,
{
  "code": "not_found",
  "message": "The requested operation is forbidden",
  "timestamp": 1721050063886
}
4ba:["$","div","403-application/json-default",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$6ae"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"code\": \"not_found\",\n \"message\": \"The requested operation is forbidden\",\n \"timestamp\": 1721050063886\n}"}]}]]}] 6af:T477,
{
  "code": "not_found",
  "message": "The requested resource is not found",
  "timestamp": 1721050063886
}
4bb:["$","div","404-application/json-default",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$6af"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"code\": \"not_found\",\n \"message\": \"The requested resource is not found\",\n \"timestamp\": 1721050063886\n}"}]}]]}] 6b0:T44d,
{
  "code": "string",
  "message": "string",
  "timestamp": 123
}
4bc:["$","div","422-application/json-default",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$6b0"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"code\": \"string\",\n \"message\": \"string\",\n \"timestamp\": 123\n}"}]}]]}] 5e7:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The ID of the error. You can share this ID with Revolut support for troubleshooting."}]]}] 5e8:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The date and time the error happened."}]]}] 5e9:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unauthorized"}]]}] 5ea:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The ID of the error. You can share this ID with Revolut support for troubleshooting."}]]}] 5eb:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The date and time the error happened."}]]}] 5ec:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Not Found"}]]}] 5ed:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The payment amount expressed in minor currency units, according to the ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_4217","target":"_blank","rel":"noreferrer","children":"ISO 4217 standard"}],". For example, ",["$","code","code-0",{"children":"7034"}]," in ",["$","code","code-1",{"children":"EUR"}]," corresponds to €70.34."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["Conversion between major and minor units varies by currency. For instance, ",["$","code","code-0",{"children":"100"}]," minor units equal £1.00 in ",["$","code","code-1",{"children":"GBP"}],", whereas in ",["$","code","code-2",{"children":"ISK"}]," they represent 100 units. For more details, see the ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_4217","target":"_blank","rel":"noreferrer","children":"ISO 4217 standard"}],"."]}]}]]}]]}] 5ee:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The unique identifier of the terminal."}]]}] 5ef:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Request body for creating a payment intent to push to a terminal."}]]}] 5fc:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Create a payment intent to push a payment request to a specific Revolut Terminal device."}],"\n",["$","p","p-1",{"children":"This endpoint is used in push payments to Revolut Terminal integration, where a POS system sends payment requests to physical terminal devices. The terminal must be in Pay at Counter mode and assigned to the same location as the order."}],"\n",["$","p","p-2",{"children":["$","strong","strong-0",{"children":"Requirements:"}]}],"\n",["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["Order must be created with ",["$","code","code-0",{"children":"channel: \"pos\""}]," and include a ",["$","code","code-1",{"children":"location_id"}]]}],"\n",["$","li","li-1",{"children":["Terminal must be online, in ",["$","code","code-0",{"children":"pos"}]," operation mode, and assigned to the same location"]}],"\n",["$","li","li-2",{"children":"Amount must match the order amount"}],"\n"]}],"\n",["$","p","p-3",{"children":["$","strong","strong-0",{"children":"What happens next:"}]}],"\n",["$","ul","ul-1",{"children":["\n",["$","li","li-0",{"children":"The payment request appears on the Revolut Terminal screen"}],"\n",["$","li","li-1",{"children":"Customer presents their card or device to complete payment"}],"\n",["$","li","li-2",{"children":["You should poll the payment intent status until it reaches a final state (",["$","code","code-0",{"children":"completed"}],", ",["$","code","code-1",{"children":"cancelled"}],", or ",["$","code","code-2",{"children":"failed"}],")"]}],"\n",["$","li","li-3",{"children":["When the payment intent reaches ",["$","code","code-0",{"children":"completed"}]," state, use the returned ",["$","code","code-1",{"children":"payment_id"}]," to retrieve the final payment status"]}],"\n"]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For the complete push payments flow, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/accept-payments/in-person-payments/terminal/push-payments","target":"_blank","rel":"noreferrer","children":"Push payments to Revolut Terminal"}],"."]}]}]]}]]}] 5fd:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["This parameter accepts the ",["$","a","a-0",{"href":"https://business.revolut.com/settings/apis?tab=merchant-api","target":"_blank","rel":"noreferrer","children":"Merchant API Secret key"}]," to authorise requests coming from the merchant's backend."]}],"\n",["$","p","p-1",{"children":["It ensures that ensures that each request is authenticated and authorised by verifying the secret key. The secret key should be included in all request headers as a ",["$","code","code-0",{"children":"Bearer"}]," token."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#authentication","target":"_blank","rel":"noreferrer","children":"Authentication"}]]}]}]]}]]}] 5fe:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The version of the Merchant API, specified in ",["$","code","code-0",{"children":"YYYY-MM-DD"}]," format."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information about API versioning, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/reference/versioning/api-versions","target":"_blank","rel":"noreferrer","children":"API versions"}],"."]}]}]]}]]}] 5ff:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A UUID string, typically used to identify resources."}]]}] 600:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ID of the ",["$","code","code-0",{"children":"Order"}]," object."]}]]}] 658:"Retrieve a subscription cycle list" 671:"Retrieve a subscription usage list" 610:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Each Merchant API request must contain an authorization header in the following format:"}],"\n","$L6b1","\n",["$","p","p-1",{"children":"To use this API, you need to generate API keys from your Revolut Business account. The Secret key is used in the authorization header for all server calls, while the Public key is provided with payment methods at checkout."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For detailed instructions on generating your API keys, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/get-started#generate-api-keys","target":"_blank","rel":"noreferrer","children":"Generate API keys"}],"."]}]}]]}]]}] 616:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Token for retrieving the next page of results."}],"\n",["$","p","p-1",{"children":"If not present, there are no more results to retrieve."}]]}] 617:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unique identifier for the subscription cycle."}]]}] 618:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unique identifier for the subscription."}]]}] 619:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unique identifier for the subscription plan variation."}]]}] 61a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unique identifier for the subscription plan phase."}]]}] 61b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The sequential cycle number within the subscription."}],"\n",["$","p","p-1",{"children":["Starts at ",["$","code","code-0",{"children":"1"}]," for the first cycle and increments with each new billing cycle."]}]]}] 61c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The unique identifier of the previous billing cycle."}],"\n",["$","p","p-1",{"children":["This field is ",["$","code","code-0",{"children":"null"}]," for the first cycle in a subscription."]}]]}] 61d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The state of the subscription cycle."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"State","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"pending"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["The cycle has been created but has not yet started. A cycle can enter this state automatically when usage is reported for a future cycle via ",["$","code","code-0",{"children":"POST /api/subscription-usages"}],"."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"active"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The cycle is currently active and in progress.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"finished"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The cycle has completed.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 61e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The date and time the subscription cycle starts in ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_8601","target":"_blank","rel":"noreferrer","children":"ISO 8601"}]," format."]}]]}] 61f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The date and time the subscription cycle ends in ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_8601","target":"_blank","rel":"noreferrer","children":"ISO 8601"}]," format."]}]]}] 620:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The deadline for submitting or correcting usage records for this cycle, in ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_8601","target":"_blank","rel":"noreferrer","children":"ISO 8601"}]," format."]}],"\n",["$","p","p-1",{"children":["Set to 12 hours after the cycle's ",["$","code","code-0",{"children":"end_date"}]," by default. After this time, Revolut aggregates all reported usage records and creates the ",["$","code","code-1",{"children":"post_billing_order_id"}]," to initiate the charge."]}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":"Only present for cycles that include usage-based subscription items."}]}]]}]]}] 621:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Permanent order ID used to retrieve, capture, cancel, or refund an order after authorization."}]]}] 638:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["Token for retrieving the next page of results. Use this token as the value of the ",["$","code","code-0",{"children":"page_token"}]," query parameter in your next request to retrieve the next page."]}],"\n",["$","p","p-1",{"children":"If not present, there are no more results to retrieve."}]]}] 639:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The unique identifier of the usage record."}]]}] 63a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unique identifier for the subscription."}]]}] 63b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unique identifier for the subscription cycle."}]]}] 63c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["A merchant-defined identifier for a usage-based subscription item. You set this code on each usage item when creating a subscription plan, and supply it when reporting consumption on ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#create-subscription-usage","target":"_blank","rel":"noreferrer","children":"Create a subscription usage endpoint"}]," to target the correct metered item."]}],"\n",["$","p","p-1",{"children":["This allows a subscription with multiple usage items (e.g., ",["$","code","code-0",{"children":"api_calls"}]," and ",["$","code","code-1",{"children":"storage_gb"}],") to receive consumption reports against the right item without relying on internal IDs."]}],"\n",["$","p","p-2",{"children":"The code must be unique within a plan phase."}]]}] 63d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The timestamp indicating when the consumption actually occurred."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Constraint","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Detail","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":"Format","className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":[["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_8601","target":"_blank","rel":"noreferrer","children":"ISO 8601"}]," date-time string (e.g., ",["$","code","code-0",{"children":"YYYY-MM-DDTHH:mm:ssZ"}],")."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":"Timezone","className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Must be UTC.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":"Validation","className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["Revolut uses this to identify the applicable billing cycle. Accepted for the active cycle (",["$","code","code-0",{"children":"start_date ≤ usage_date < end_date"}],"), for a recently ended cycle before its ",["$","code","code-1",{"children":"usage_cutoff_date"}],", and for the one next upcoming cycle. Other dates are rejected."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 63e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The quantity of consumption to record for this usage report."}],"\n",["$","p","p-1",{"children":"Supports up to 20 digits before and 20 digits after the decimal point."}]]}] 63f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Key-value pairs you can attach to a usage record for your own tracking and reporting purposes."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Constraint","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Detail","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":"Keys","className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Maximum 50 keys per record.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":"Value types","className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"String, number, or boolean only.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":"Number precision","className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Up to 20 digits before and 20 digits after the decimal point.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 640:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The date and time the usage record was created in ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_8601","target":"_blank","rel":"noreferrer","children":"ISO 8601"}]," format."]}]]}] 641:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The date and time the usage record was last updated in ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_8601","target":"_blank","rel":"noreferrer","children":"ISO 8601"}]," format."]}]]}] 642:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"List of subscription usages."}]]}] 4fd:["$","div","CodeBlock-0",{"className":"wzy01m0 _18b50nc0","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"
'Authorization: Bearer <yourSecretApiKey>'
"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"'Authorization: Bearer '\n"}]}]]}] 6b2:T51d,
{
  "url": "https://example.com/webhooks/updated",
  "events": [
    "ORDER_COMPLETED",
    "ORDER_AUTHORISED",
    "ORDER_CANCELLED"
  ]
}
4ff:["$","div","request-application/json-webhook_update_request",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$6b2"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"url\": \"https://example.com/webhooks/updated\",\n \"events\": [\n \"ORDER_COMPLETED\",\n \"ORDER_AUTHORISED\",\n \"ORDER_CANCELLED\"\n ]\n}"}]}]]}] 6b3:T69c,
{
  "id": "c6b981f4-53b3-47d5-9b24-4f87af1160eb",
  "url": "https://example.com/webhooks",
  "events": [
    "ORDER_AUTHORISED",
    "ORDER_COMPLETED"
  ],
  "signing_secret": "wsk_4jETWMz1g1b37gCONjNp84t2KSSIT7dK"
}
500:["$","div","200-application/json-updated_webhook",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$6b3"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"id\": \"c6b981f4-53b3-47d5-9b24-4f87af1160eb\",\n \"url\": \"https://example.com/webhooks\",\n \"events\": [\n \"ORDER_AUTHORISED\",\n \"ORDER_COMPLETED\"\n ],\n \"signing_secret\": \"wsk_4jETWMz1g1b37gCONjNp84t2KSSIT7dK\"\n}"}]}]]}] 6b4:T44d,
{
  "code": "string",
  "message": "string",
  "timestamp": 123
}
501:["$","div","400-application/json-default",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$6b4"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"code\": \"string\",\n \"message\": \"string\",\n \"timestamp\": 123\n}"}]}]]}] 6b5:T44d,
{
  "code": "string",
  "message": "string",
  "timestamp": 123
}
502:["$","div","401-application/json-default",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$6b5"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"code\": \"string\",\n \"message\": \"string\",\n \"timestamp\": 123\n}"}]}]]}] 6b6:T44d,
{
  "code": "string",
  "message": "string",
  "timestamp": 123
}
503:["$","div","404-application/json-default",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$6b6"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"code\": \"string\",\n \"message\": \"string\",\n \"timestamp\": 123\n}"}]}]]}] 622:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ID of the order created after the cycle's ",["$","code","code-0",{"children":"usage_cutoff_date"}]," to charge usage-based items accumulated during the cycle."]}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Scenario","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Detail","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":"Ongoing subscription","className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["This order also acts as the next cycle's ",["$","code","code-0",{"children":"order_id"}],", combining usage post-billing for the current cycle with pre-billing for the next."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":"Last cycle","className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"A standalone finishing order is created to charge all usage from this cycle.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":"Subscription ended with unpaid cycles","className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The finishing order consolidates all outstanding usage charges, including any from previous cycles where payment failed.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":"Only present for cycles that include usage-based subscription items."}]}]]}]]}] 623:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Indicates whether this billing cycle occurs during the subscription's trial period."}],"\n",["$","p","p-1",{"children":["This value is automatically calculated by the system based on the cycle's timing relative to the subscription's trial period. Returns ",["$","code","code-0",{"children":"true"}]," if the cycle is within the trial period (before ",["$","code","code-1",{"children":"trial_end_date"}],"), otherwise ",["$","code","code-2",{"children":"false"}],"."]}],"\n",["$","p","p-2",{"children":"Trial cycles typically have different billing behavior, such as reduced or zero charges."}]]}] 624:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"List of subscription cycles."}]]}] 625:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"List of subscription cycles retrieved successfully"}]]}] 626:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An identifier that can be used to determine what went wrong."}],"\n",["$","p","p-1",{"children":"Error codes are not globally unique, but uniqueness is guaranteed within endpoints."}]]}] 627:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Some human readable text describing what went wrong."}]]}] 628:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://www.unixtimestamp.com/","target":"_blank","rel":"noreferrer","children":"UNIX timestamp"}]," of the date and time the error happened."]}]]}] 629:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Bad Request"}]]}] 62a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An identifier that can be used to determine what went wrong."}],"\n",["$","p","p-1",{"children":"Error codes are not globally unique, but uniqueness is guaranteed within endpoints."}]]}] 62b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Some human readable text describing what went wrong."}]]}] 62c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://www.unixtimestamp.com/","target":"_blank","rel":"noreferrer","children":"UNIX timestamp"}]," of the date and time the error happened."]}]]}] 62d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unauthorized"}]]}] 62e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An identifier that can be used to determine what went wrong."}],"\n",["$","p","p-1",{"children":"Error codes are not globally unique, but uniqueness is guaranteed within endpoints."}]]}] 62f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Some human readable text describing what went wrong."}]]}] 630:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://www.unixtimestamp.com/","target":"_blank","rel":"noreferrer","children":"UNIX timestamp"}]," of the date and time the error happened."]}]]}] 631:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Subscription not found"}]]}] 632:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An identifier that can be used to determine what went wrong."}],"\n",["$","p","p-1",{"children":"Error codes are not globally unique, but uniqueness is guaranteed within endpoints."}]]}] 633:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Some human readable text describing what went wrong."}]]}] 634:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://www.unixtimestamp.com/","target":"_blank","rel":"noreferrer","children":"UNIX timestamp"}]," of the date and time the error happened."]}]]}] 635:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Error response"}]]}] 659:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Retrieve all billing cycles for a specific subscription."}],"\n",["$","p","p-1",{"children":"You can use the query parameters for:"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Filtering","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Pagination","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["Filter the subscription cycles that you want to retrieve, for example, only retrieve cycles that started within a specific date range. ",["$","br","br-0",{}],["$","br","br-1",{}],"Parameters used for filtering:",["$","br","br-2",{}],["$","ul","ul-0",{"children":[["$","li","li-0",{"children":["$","code","code-0",{"children":"from"}]}],["$","li","li-1",{"children":["$","code","code-0",{"children":"to"}]}]]}]],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["View the subscription cycles without loading all of them at once, for example, return a specified number of cycles per page. ",["$","br","br-0",{}],["$","br","br-1",{}],"Parameters used for pagination: ",["$","br","br-2",{}],["$","ul","ul-0",{"children":[["$","li","li-0",{"children":["$","code","code-0",{"children":"limit"}]}],["$","li","li-1",{"children":["$","code","code-0",{"children":"page_token"}]}]]}]],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 65a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["This parameter accepts the ",["$","a","a-0",{"href":"https://business.revolut.com/settings/apis?tab=merchant-api","target":"_blank","rel":"noreferrer","children":"Merchant API Secret key"}]," to authorise requests coming from the merchant's backend."]}],"\n",["$","p","p-1",{"children":["It ensures that ensures that each request is authenticated and authorised by verifying the secret key. The secret key should be included in all request headers as a ",["$","code","code-0",{"children":"Bearer"}]," token."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#authentication","target":"_blank","rel":"noreferrer","children":"Authentication"}]]}]}]]}]]}] 65b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The version of the Merchant API, specified in ",["$","code","code-0",{"children":"YYYY-MM-DD"}]," format."]}],"\n",["$","p","p-1",{"children":"If not specified, you will receive an error."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information about API versioning, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/reference/versioning/api-versions","target":"_blank","rel":"noreferrer","children":"API versions"}],"."]}]}]]}]]}] 65c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A UUID string, typically used to identify resources."}]]}] 65d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The ID of the subscription."}]]}] 65e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["Maximum number of records to return. Used for ",["$","strong","strong-0",{"children":"pagination"}],"."]}]]}] 65f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["Filter records created from this date/time. Used for ",["$","strong","strong-0",{"children":"filtering"}],"."]}]]}] 660:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["Filter records created until this date/time. Used for ",["$","strong","strong-0",{"children":"filtering"}],"."]}]]}] 661:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["Token for retrieving the next page of results. Used for ",["$","strong","strong-0",{"children":"pagination"}],"."]}],"\n",["$","p","p-1",{"children":"To paginate through results:"}],"\n",["$","ol","ol-0",{"children":["\n",["$","li","li-0",{"children":["Make an initial request with the desired ",["$","code","code-0",{"children":"limit"}],"."]}],"\n",["$","li","li-1",{"children":["The response will include a ",["$","code","code-0",{"children":"next_page_token"}]," if more results are available."]}],"\n",["$","li","li-2",{"children":["Use that token in the ",["$","code","code-0",{"children":"page_token"}]," parameter of your next request."]}],"\n",["$","li","li-3",{"children":["Repeat until ",["$","code","code-0",{"children":"next_page_token"}]," is not present."]}],"\n"]}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["When using ",["$","code","code-0",{"children":"page_token"}],", you must include all query parameters from the initial request (such as ",["$","code","code-1",{"children":"from"}],", ",["$","code","code-2",{"children":"to"}],", or other filter parameters) to maintain consistent filtering across pages."]}]}]]}]]}] 643:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"List of subscription usages retrieved successfully"}]]}] 644:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An identifier that can be used to determine what went wrong."}],"\n",["$","p","p-1",{"children":"Error codes are not globally unique, but uniqueness is guaranteed within endpoints."}]]}] 645:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Some human readable text describing what went wrong."}]]}] 646:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://www.unixtimestamp.com/","target":"_blank","rel":"noreferrer","children":"UNIX timestamp"}]," of the date and time the error happened."]}]]}] 647:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Bad Request"}]]}] 648:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An identifier that can be used to determine what went wrong."}],"\n",["$","p","p-1",{"children":"Error codes are not globally unique, but uniqueness is guaranteed within endpoints."}]]}] 649:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Some human readable text describing what went wrong."}]]}] 64a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://www.unixtimestamp.com/","target":"_blank","rel":"noreferrer","children":"UNIX timestamp"}]," of the date and time the error happened."]}]]}] 64b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unauthorized"}]]}] 64c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An identifier that can be used to determine what went wrong."}],"\n",["$","p","p-1",{"children":"Error codes are not globally unique, but uniqueness is guaranteed within endpoints."}]]}] 64d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Some human readable text describing what went wrong."}]]}] 64e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://www.unixtimestamp.com/","target":"_blank","rel":"noreferrer","children":"UNIX timestamp"}]," of the date and time the error happened."]}]]}] 64f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Error response"}]]}] 672:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["Retrieve all usage records for the merchant account. Results are ordered by ",["$","code","code-0",{"children":"usage_date"}],", unlike other list endpoints which order by ",["$","code","code-1",{"children":"created_at"}],". You can use the query parameters for:"]}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Filtering","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Pagination","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["Filter the usage records that you want to retrieve, for example, only retrieve records for a specific subscription or billing cycle. ",["$","br","br-0",{}],["$","br","br-1",{}],"Parameters used for filtering:",["$","br","br-2",{}],["$","ul","ul-0",{"children":[["$","li","li-0",{"children":["$","code","code-0",{"children":"subscription_id"}]}],["$","li","li-1",{"children":["$","code","code-0",{"children":"subscription_cycle_id"}]}],["$","li","li-2",{"children":["$","code","code-0",{"children":"from_usage_date"}]}],["$","li","li-3",{"children":["$","code","code-0",{"children":"to_usage_date"}]}]]}]],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["View usage records without loading all of them at once, for example, return a specified number of records per page. ",["$","br","br-0",{}],["$","br","br-1",{}],"Parameters used for pagination:",["$","br","br-2",{}],["$","ul","ul-0",{"children":[["$","li","li-0",{"children":["$","code","code-0",{"children":"limit"}]}],["$","li","li-1",{"children":["$","code","code-0",{"children":"page_token"}]}]]}]],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 673:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["This parameter accepts the ",["$","a","a-0",{"href":"https://business.revolut.com/settings/apis?tab=merchant-api","target":"_blank","rel":"noreferrer","children":"Merchant API Secret key"}]," to authorise requests coming from the merchant's backend."]}],"\n",["$","p","p-1",{"children":["It ensures that ensures that each request is authenticated and authorised by verifying the secret key. The secret key should be included in all request headers as a ",["$","code","code-0",{"children":"Bearer"}]," token."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#authentication","target":"_blank","rel":"noreferrer","children":"Authentication"}]]}]}]]}]]}] 674:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The version of the Merchant API, specified in ",["$","code","code-0",{"children":"YYYY-MM-DD"}]," format."]}],"\n",["$","p","p-1",{"children":"If not specified, you will receive an error."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information about API versioning, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/reference/versioning/api-versions","target":"_blank","rel":"noreferrer","children":"API versions"}],"."]}]}]]}]]}] 675:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["Maximum number of records to return. Used for ",["$","strong","strong-0",{"children":"pagination"}],"."]}]]}] 676:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["Filter usage records with a ",["$","code","code-0",{"children":"usage_date"}]," on or after this date and time."]}]]}] 677:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["Filter usage records with a ",["$","code","code-0",{"children":"usage_date"}]," before this date and time."]}]]}] 678:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Filter usages by the ID of the subscription."}]]}] 679:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Filter usages by the ID of the subscription cycle."}]]}] 67a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["Token for retrieving the next page of results. Used for ",["$","strong","strong-0",{"children":"pagination"}],"."]}],"\n",["$","p","p-1",{"children":"To paginate through results:"}],"\n",["$","ol","ol-0",{"children":["\n",["$","li","li-0",{"children":["Make an initial request with the desired ",["$","code","code-0",{"children":"limit"}],"."]}],"\n",["$","li","li-1",{"children":["The response will include a ",["$","code","code-0",{"children":"next_page_token"}]," if more results are available."]}],"\n",["$","li","li-2",{"children":["Use that token in the ",["$","code","code-0",{"children":"page_token"}]," parameter of your next request."]}],"\n",["$","li","li-3",{"children":["Repeat until ",["$","code","code-0",{"children":"next_page_token"}]," is not present."]}],"\n"]}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["When using ",["$","code","code-0",{"children":"page_token"}],", you must include all query parameters from the initial request (such as ",["$","code","code-1",{"children":"from"}],", ",["$","code","code-2",{"children":"to"}],", or other filter parameters) to maintain consistent filtering across pages."]}]}]]}]]}] 517:["$","div","CodeBlock-0",{"className":"wzy01m0 _18b50nc0","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"
'Authorization: Bearer <yourSecretApiKey>'
"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"'Authorization: Bearer '\n"}]}]]}] 519:["$","div","request-application/json-create_webhook",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"
{\n  \"event_type\": \"fast_checkout.validate_address\",\n  \"url\": \"https://backend.example.com/webhooks/validate-address\"\n}
"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"event_type\": \"fast_checkout.validate_address\",\n \"url\": \"https://backend.example.com/webhooks/validate-address\"\n}"}]}]]}] 6b7:T4bb,
{
  "event_type": "fast_checkout.validate_address",
  "url": "https://backend.example.com/webhooks/validate-address",
  "location_id": "8d9a7125-805f-40f3-a405-bc89765db996"
}
51a:["$","div","request-application/json-create_webhook_with_location_id",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$6b7"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"event_type\": \"fast_checkout.validate_address\",\n \"url\": \"https://backend.example.com/webhooks/validate-address\",\n \"location_id\": \"8d9a7125-805f-40f3-a405-bc89765db996\"\n}"}]}]]}] 6b8:T5e6,
{
  "id": "f6abc4df-eb48-417c-8e75-f7c6d7ad394f",
  "signing_key": "swsk_y5z3LEHYZ9ndote3qegzWD6uL4t1lfp1",
  "url": "https://backend.example.com/webhooks/validate-address",
  "event_type": "fast_checkout.validate_address"
}
51b:["$","div","200-application/json-example_without_location",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$6b8"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"id\": \"f6abc4df-eb48-417c-8e75-f7c6d7ad394f\",\n \"signing_key\": \"swsk_y5z3LEHYZ9ndote3qegzWD6uL4t1lfp1\",\n \"url\": \"https://backend.example.com/webhooks/validate-address\",\n \"event_type\": \"fast_checkout.validate_address\"\n}"}]}]]}] 6b9:T719,
{
  "id": "f6abc4df-eb48-417c-8e75-f7c6d7ad394f",
  "signing_key": "swsk_y5z3LEHYZ9ndote3qegzWD6uL4t1lfp1",
  "url": "https://backend.example.com/webhooks/validate-address",
  "event_type": "fast_checkout.validate_address",
  "location_id": "b0ebede4-5cbc-4951-977f-70329faa8769"
}
51c:["$","div","200-application/json-example_with_location",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$6b9"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"id\": \"f6abc4df-eb48-417c-8e75-f7c6d7ad394f\",\n \"signing_key\": \"swsk_y5z3LEHYZ9ndote3qegzWD6uL4t1lfp1\",\n \"url\": \"https://backend.example.com/webhooks/validate-address\",\n \"event_type\": \"fast_checkout.validate_address\",\n \"location_id\": \"b0ebede4-5cbc-4951-977f-70329faa8769\"\n}"}]}]]}] 51d:["$","div","400-application/json-default",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"
{\n  \"errorId\": \"string\",\n  \"timestamp\": 123\n}
"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"errorId\": \"string\",\n \"timestamp\": 123\n}"}]}]]}] 68e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Each Merchant API request must contain an authorization header in the following format:"}],"\n","$L6ba","\n",["$","p","p-1",{"children":"To use this API, you need to generate API keys from your Revolut Business account. The Secret key is used in the authorization header for all server calls, while the Public key is provided with payment methods at checkout."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For detailed instructions on generating your API keys, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/get-started#generate-api-keys","target":"_blank","rel":"noreferrer","children":"Generate API keys"}],"."]}]}]]}]]}] 694:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Each Merchant API request must contain an authorization header in the following format:"}],"\n","$L6bb","\n",["$","p","p-1",{"children":"To use this API, you need to generate API keys from your Revolut Business account. The Secret key is used in the authorization header for all server calls, while the Public key is provided with payment methods at checkout."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For detailed instructions on generating your API keys, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/get-started#generate-api-keys","target":"_blank","rel":"noreferrer","children":"Generate API keys"}],"."]}]}]]}]]}] 579:["$","div","CodeBlock-0",{"className":"wzy01m0 _18b50nc0","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"
'Authorization: Bearer <yourSecretApiKey>'
"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"'Authorization: Bearer '\n"}]}]]}] 57a:["$","div","CodeBlock-0",{"className":"wzy01m0 _18b50nc0","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"
'Authorization: Bearer <yourSecretApiKey>'
"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"'Authorization: Bearer '\n"}]}]]}] 57b:["$","div","CodeBlock-0",{"className":"wzy01m0 _18b50nc0","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"
'Authorization: Bearer <yourSecretApiKey>'
"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"'Authorization: Bearer '\n"}]}]]}] 57c:["$","div","CodeBlock-0",{"className":"wzy01m0 _18b50nc0","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"
'Authorization: Bearer <yourSecretApiKey>'
"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"'Authorization: Bearer '\n"}]}]]}] 5b4:["$","div","CodeBlock-0",{"className":"wzy01m0 _18b50nc0","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"
'Authorization: Bearer <yourSecretApiKey>'
"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"'Authorization: Bearer '\n"}]}]]}] 6bc:T593,
{
  "full_name": "Example Customer",
  "email": "example.customer@example.com",
  "phone": "+441234567890",
  "date_of_birth": "1990-01-01"
}
5b6:["$","div","request-application/json-example_customer_creation",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$6bc"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"full_name\": \"Example Customer\",\n \"email\": \"example.customer@example.com\",\n \"phone\": \"+441234567890\",\n \"date_of_birth\": \"1990-01-01\"\n}"}]}]]}] 6bd:T7f4,
{
  "id": "6c7c97a8-cfc1-4cf3-8b38-26a74fdf1fae",
  "full_name": "Example Customer",
  "email": "example.customer@example.com",
  "phone": "+441234567890",
  "created_at": "2020-06-24T12:03:39.979397Z",
  "updated_at": "2020-06-24T12:03:39.979397Z"
}
5b7:["$","div","201-application/json-created_customer",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$6bd"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"id\": \"6c7c97a8-cfc1-4cf3-8b38-26a74fdf1fae\",\n \"full_name\": \"Example Customer\",\n \"email\": \"example.customer@example.com\",\n \"phone\": \"+441234567890\",\n \"created_at\": \"2020-06-24T12:03:39.979397Z\",\n \"updated_at\": \"2020-06-24T12:03:39.979397Z\"\n}"}]}]]}] 6be:T44d,
{
  "code": "string",
  "message": "string",
  "timestamp": 123
}
5b8:["$","div","400-application/json-default",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$6be"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"code\": \"string\",\n \"message\": \"string\",\n \"timestamp\": 123\n}"}]}]]}] 6bf:T44d,
{
  "code": "string",
  "message": "string",
  "timestamp": 123
}
5b9:["$","div","401-application/json-default",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$6bf"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"code\": \"string\",\n \"message\": \"string\",\n \"timestamp\": 123\n}"}]}]]}] 6c0:Tc9e,
{
  "id": "950e8400-e29b-41d4-a716-446655440004",
  "subscription_id": "650e8400-e29b-41d4-a716-446655440001",
  "plan_variation_id": "750e8400-e29b-41d4-a716-446655440002",
  "plan_variation_phase_id": "850e8400-e29b-41d4-a716-446655440003",
  "number": 1,
  "state": "finished",
  "start_date": "2025-06-05T21:00:00.036001Z",
  "end_date": "2025-07-05T21:00:00.036001Z",
  "order_id": "b50e8400-e29b-41d4-a716-446655440006",
  "trial": true
}
5bb:["$","div","200-application/json-finished_cycle",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$6c0"}}]}]],"$L6c1"]}] 6c2:T44d,
{
  "code": "string",
  "message": "string",
  "timestamp": 123
}
5bc:["$","div","400-application/json-default",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$6c2"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"code\": \"string\",\n \"message\": \"string\",\n \"timestamp\": 123\n}"}]}]]}] 6c3:T44d,
{
  "code": "string",
  "message": "string",
  "timestamp": 123
}
5bd:["$","div","401-application/json-default",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$6c3"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"code\": \"string\",\n \"message\": \"string\",\n \"timestamp\": 123\n}"}]}]]}] 6c4:T44d,
{
  "code": "string",
  "message": "string",
  "timestamp": 123
}
5be:["$","div","404-application/json-default",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$6c4"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"code\": \"string\",\n \"message\": \"string\",\n \"timestamp\": 123\n}"}]}]]}] 6c5:T44d,
{
  "code": "string",
  "message": "string",
  "timestamp": 123
}
5bf:["$","div","default-application/json-default",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$6c5"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"code\": \"string\",\n \"message\": \"string\",\n \"timestamp\": 123\n}"}]}]]}] 6c6:Td31,
{
  "id": "750e8400-e29b-41d4-a716-446655440000",
  "subscription_id": "550e8400-e29b-41d4-a716-446655440000",
  "subscription_cycle_id": "850e8400-e29b-41d4-a716-446655440000",
  "subscription_item_code": "api_calls",
  "usage_date": "2026-03-01T21:00:00Z",
  "quantity": 100,
  "metadata": {
    "user_id": "12345",
    "api_version": "v2"
  },
  "created_at": "2026-03-01T21:05:00Z",
  "updated_at": "2026-03-01T21:05:00Z"
}
5c1:["$","div","200-application/json-usage_record",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$6c6"}}]}]],"$L6c7"]}] 6c8:T44d,
{
  "code": "string",
  "message": "string",
  "timestamp": 123
}
5c2:["$","div","400-application/json-default",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$6c8"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"code\": \"string\",\n \"message\": \"string\",\n \"timestamp\": 123\n}"}]}]]}] 6c9:T44d,
{
  "code": "string",
  "message": "string",
  "timestamp": 123
}
5c3:["$","div","401-application/json-default",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$6c9"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"code\": \"string\",\n \"message\": \"string\",\n \"timestamp\": 123\n}"}]}]]}] 6ca:T44d,
{
  "code": "string",
  "message": "string",
  "timestamp": 123
}
5c4:["$","div","404-application/json-default",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$6ca"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"code\": \"string\",\n \"message\": \"string\",\n \"timestamp\": 123\n}"}]}]]}] 6cb:T44d,
{
  "code": "string",
  "message": "string",
  "timestamp": 123
}
5c5:["$","div","default-application/json-default",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$6cb"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"code\": \"string\",\n \"message\": \"string\",\n \"timestamp\": 123\n}"}]}]]}] 6c1:["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"id\": \"950e8400-e29b-41d4-a716-446655440004\",\n \"subscription_id\": \"650e8400-e29b-41d4-a716-446655440001\",\n \"plan_variation_id\": \"750e8400-e29b-41d4-a716-446655440002\",\n \"plan_variation_phase_id\": \"850e8400-e29b-41d4-a716-446655440003\",\n \"number\": 1,\n \"state\": \"finished\",\n \"start_date\": \"2025-06-05T21:00:00.036001Z\",\n \"end_date\": \"2025-07-05T21:00:00.036001Z\",\n \"order_id\": \"b50e8400-e29b-41d4-a716-446655440006\",\n \"trial\": true\n}"}]}] 6c7:["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"id\": \"750e8400-e29b-41d4-a716-446655440000\",\n \"subscription_id\": \"550e8400-e29b-41d4-a716-446655440000\",\n \"subscription_cycle_id\": \"850e8400-e29b-41d4-a716-446655440000\",\n \"subscription_item_code\": \"api_calls\",\n \"usage_date\": \"2026-03-01T21:00:00Z\",\n \"quantity\": 100,\n \"metadata\": {\n \"user_id\": \"12345\",\n \"api_version\": \"v2\"\n },\n \"created_at\": \"2026-03-01T21:05:00Z\",\n \"updated_at\": \"2026-03-01T21:05:00Z\"\n}"}]}] 5d8:["$","div","CodeBlock-0",{"className":"wzy01m0 _18b50nc0","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"
'Authorization: Bearer <yourSecretApiKey>'
"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"'Authorization: Bearer '\n"}]}]]}] 5f7:["$","div","CodeBlock-0",{"className":"wzy01m0 _18b50nc0","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"
'Authorization: Bearer <yourSecretApiKey>'
"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"'Authorization: Bearer '\n"}]}]]}] 3e:["$","$7a","update-subscription-usage",{"children":[["$","section",null,{"className":"y9a0do0","data-variant":"endpoint","children":["$","$L7b",null,{"responses":{"200":{"description":"Usage updated successfully","content":{"application/json":{"schema":{"type":"object","required":"$3d:props:children:0:props:children:props:responses:200:content:application/json:schema:required","properties":{"id":{"type":"string","format":"uuid","description":"The unique identifier of the usage record.","descriptionNode":"$L6cc"},"subscription_id":{"type":"string","format":"uuid","description":"Unique identifier for the subscription.","descriptionNode":"$L6cd"},"subscription_cycle_id":{"type":"string","format":"uuid","description":"Unique identifier for the subscription cycle.","descriptionNode":"$L6ce"},"subscription_item_code":{"type":"string","description":"A merchant-defined identifier for a usage-based subscription item. You set this code on each usage item when creating a subscription plan, and supply it when reporting consumption on [Create a subscription usage endpoint](https://developer.revolut.com/docs/api/merchant#create-subscription-usage) to target the correct metered item.\n\nThis allows a subscription with multiple usage items (e.g., `api_calls` and `storage_gb`) to receive consumption reports against the right item without relying on internal IDs.\n\nThe code must be unique within a plan phase.","maxLength":250,"examples":"$3d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:subscription_item_code:examples","descriptionNode":"$L6cf"},"usage_date":{"type":"string","format":"date-time","description":"The timestamp indicating when the consumption actually occurred.\n\n| Constraint | Detail |\n| ---------- | ------ |\n| Format | [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date-time string (e.g., `YYYY-MM-DDTHH:mm:ssZ`). |\n| Timezone | Must be UTC. |\n| Validation | Revolut uses this to identify the applicable billing cycle. Accepted for the active cycle (`start_date ≤ usage_date < end_date`), for a recently ended cycle before its `usage_cutoff_date`, and for the one next upcoming cycle. Other dates are rejected. |","examples":"$3d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:usage_date:examples","descriptionNode":"$L6d0"},"quantity":{"type":"number","exclusiveMinimum":0,"description":"The quantity of consumption to record for this usage report. \n\nSupports up to 20 digits before and 20 digits after the decimal point.","examples":"$3d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:quantity:examples","descriptionNode":"$L6d1"},"metadata":{"type":"object","description":"Key-value pairs you can attach to a usage record for your own tracking and reporting purposes.\n\n| Constraint | Detail |\n| ---------- | ------ |\n| Keys | Maximum 50 keys per record. |\n| Value types | String, number, or boolean only. |\n| Number precision | Up to 20 digits before and 20 digits after the decimal point. |","additionalProperties":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]},"maxProperties":50,"examples":"$3d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:metadata:examples","descriptionNode":"$L6d2"},"created_at":{"type":"string","format":"date-time","description":"The date and time the usage record was created in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format.","examples":"$3d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:created_at:examples","descriptionNode":"$L6d3"},"updated_at":{"type":"string","format":"date-time","description":"The date and time the usage record was last updated in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format.","examples":"$3d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:updated_at:examples","descriptionNode":"$L6d4"}}},"examples":{"updated_usage":{"summary":"Successful usage record creation","description":"Returns the reported usages","value":"$3d:props:children:0:props:children:props:responses:200:content:application/json:examples:usage_record:value"}}}},"descriptionNode":"$L6d5"},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"code":{"type":"string","description":"An identifier that can be used to determine what went wrong.\n\nError codes are not globally unique, but uniqueness is guaranteed within endpoints.","descriptionNode":"$L6d6"},"message":{"type":"string","description":"Some human readable text describing what went wrong.","descriptionNode":"$L6d7"},"timestamp":{"type":"integer","description":"The [UNIX timestamp](https://www.unixtimestamp.com/) of the date and time the error happened.","descriptionNode":"$L6d8"}}}}},"descriptionNode":"$L6d9"},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"code":{"type":"string","description":"An identifier that can be used to determine what went wrong.\n\nError codes are not globally unique, but uniqueness is guaranteed within endpoints.","descriptionNode":"$L6da"},"message":{"type":"string","description":"Some human readable text describing what went wrong.","descriptionNode":"$L6db"},"timestamp":{"type":"integer","description":"The [UNIX timestamp](https://www.unixtimestamp.com/) of the date and time the error happened.","descriptionNode":"$L6dc"}}}}},"descriptionNode":"$L6dd"},"404":{"description":"Usage not found","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"code":{"type":"string","description":"An identifier that can be used to determine what went wrong.\n\nError codes are not globally unique, but uniqueness is guaranteed within endpoints.","descriptionNode":"$L6de"},"message":{"type":"string","description":"Some human readable text describing what went wrong.","descriptionNode":"$L6df"},"timestamp":{"type":"integer","description":"The [UNIX timestamp](https://www.unixtimestamp.com/) of the date and time the error happened.","descriptionNode":"$L6e0"}}}}},"descriptionNode":"$L6e1"},"422":{"description":"Unprocessable entity (business rule violation)","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"code":{"type":"string","description":"An identifier that can be used to determine what went wrong.\n\nError codes are not globally unique, but uniqueness is guaranteed within endpoints.","descriptionNode":"$L6e2"},"message":{"type":"string","description":"Some human readable text describing what went wrong.","descriptionNode":"$L6e3"},"timestamp":{"type":"integer","description":"The [UNIX timestamp](https://www.unixtimestamp.com/) of the date and time the error happened.","descriptionNode":"$L6e4"}}},"examples":{"usage_locked":{"summary":"Cycle is past the usage cutoff date","value":{"code":"subscription_usage_locked","message":"Cannot modify usage for a locked cycle","timestamp":1743465600}}}}},"descriptionNode":"$L6e5"},"default":{"description":"Error response","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"code":{"type":"string","description":"An identifier that can be used to determine what went wrong.\n\nError codes are not globally unique, but uniqueness is guaranteed within endpoints.","descriptionNode":"$L6e6"},"message":{"type":"string","description":"Some human readable text describing what went wrong.","descriptionNode":"$L6e7"},"timestamp":{"type":"integer","description":"The [UNIX timestamp](https://www.unixtimestamp.com/) of the date and time the error happened.","descriptionNode":"$L6e8"}}}}},"descriptionNode":"$L6e9"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"quantity":{"type":"number","exclusiveMinimum":0,"description":"The quantity of consumption to record for this usage report. \n\nSupports up to 20 digits before and 20 digits after the decimal point.","examples":"$3d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:quantity:examples","descriptionNode":"$L6ea"},"metadata":{"type":"object","description":"Key-value pairs you can attach to a usage record for your own tracking and reporting purposes.\n\n| Constraint | Detail |\n| ---------- | ------ |\n| Keys | Maximum 50 keys per record. |\n| Value types | String, number, or boolean only. |\n| Number precision | Up to 20 digits before and 20 digits after the decimal point. |","additionalProperties":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]},"maxProperties":50,"examples":"$3d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:metadata:examples","descriptionNode":"$L6eb"}}},"examples":{"update_usage_quantity":{"summary":"Update quantity","value":{"quantity":150}},"update_usage_metadata":{"summary":"Update metadata","value":{"metadata":{"user_id":"67890","api_version":"v3"}}},"update_usage":{"summary":"Update both quantity and metadata","value":{"quantity":200,"metadata":{"user_id":"54321"}}}}}}},"variantLabels":["Update quantity","Update metadata","Update both quantity and metadata"],"children":["$L6ec","$L6ed"]}]}],false]}] 611:["$","div","request-application/json-create_payment_intent",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"
{\n  \"amount\": 2500,\n  \"terminal_id\": \"0e53f673-7705-473a-a263-89a3e7647c3d\"\n}
"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"amount\": 2500,\n \"terminal_id\": \"0e53f673-7705-473a-a263-89a3e7647c3d\"\n}"}]}]]}] 6ee:T6a5,
{
  "id": "b4d58add-b3fe-40e4-a70a-8c78df977888",
  "state": "pending",
  "order_id": "5c9fc54e-11b4-4f7f-8686-4a64d4d20db4",
  "amount": 2500,
  "currency": "GBP"
}
612:["$","div","201-application/json-payment_intent_pending",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$6ee"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"id\": \"b4d58add-b3fe-40e4-a70a-8c78df977888\",\n \"state\": \"pending\",\n \"order_id\": \"5c9fc54e-11b4-4f7f-8686-4a64d4d20db4\",\n \"amount\": 2500,\n \"currency\": \"GBP\"\n}"}]}]]}] 613:["$","div","400-application/json-default",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"
{\n  \"errorId\": \"string\",\n  \"timestamp\": 123\n}
"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"errorId\": \"string\",\n \"timestamp\": 123\n}"}]}]]}] 614:["$","div","401-application/json-default",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"
{\n  \"errorId\": \"string\",\n  \"timestamp\": 123\n}
"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"errorId\": \"string\",\n \"timestamp\": 123\n}"}]}]]}] 615:["$","div","404-application/json-default",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"
{\n  \"errorId\": \"string\",\n  \"timestamp\": 123\n}
"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"errorId\": \"string\",\n \"timestamp\": 123\n}"}]}]]}] 655:["$","div","CodeBlock-0",{"className":"wzy01m0 _18b50nc0","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"
'Authorization: Bearer <yourSecretApiKey>'
"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"'Authorization: Bearer '\n"}]}]]}] 656:["$","div","CodeBlock-0",{"className":"wzy01m0 _18b50nc0","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"
'Authorization: Bearer <yourSecretApiKey>'
"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"'Authorization: Bearer '\n"}]}]]}] 657:["$","div","CodeBlock-0",{"className":"wzy01m0 _18b50nc0","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"
'Authorization: Bearer <yourSecretApiKey>'
"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"'Authorization: Bearer '\n"}]}]]}] 6ec:["$","div",null,{"className":"ezz1n30","children":[["$","div",null,{"data-header":"$undefined","className":"ezz1n31","children":["$","div",null,{"className":"y9a0do1","children":[["$","h2",null,{"id":"update-subscription-usage","children":[["$L6ef","$undefined"],["$","$L15",null,{"id":"update-subscription-usage"}]]}],["$","$L16",null,{"url":"/docs/api/merchant/2025-10-16/operations/update-subscription-usage.md"}]]}]}],"$undefined"]}] 6f5:T640,
curl -X PATCH "https://merchant.revolut.com/api/subscription-usages/__RP_TOK_0__" \
  -H "Content-Type: application/json" \
  -H "Authorization: __RP_TOK_1__" \
  -H "Revolut-Api-Version: __RP_TOK_2__" \
  -d '{
  "quantity": 150
}'
6f6:Te89,
const payload = {
  "quantity": 150
};
fetch("https://merchant.revolut.com/api/subscription-usages/__RP_TOK_0__", {
  method: "PATCH",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "__RP_TOK_1__",
    "Revolut-Api-Version": "__RP_TOK_2__"
  },
  body: JSON.stringify(payload)
})
  .then(response => response.json())
  .then(data => console.log(data));
6f7:T1625,
package main

import (
  "fmt"
  "net/http"
  "bytes"
  "encoding/json"
)

func main() {
  url := "https://merchant.revolut.com/api/subscription-usages/__RP_TOK_0__"
  jsonData := []byte(`
{
  "quantity": 150
}
  `)
  req, _ := http.NewRequest("PATCH", url, bytes.NewBuffer(jsonData))
  req.Header.Add("Content-Type", "application/json")
  req.Header.Add("Authorization", "__RP_TOK_1__")
  req.Header.Add("Revolut-Api-Version", "__RP_TOK_2__")

  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  fmt.Println(res)
}
6f8:Tbbd,
import requests

url = "https://merchant.revolut.com/api/subscription-usages/__RP_TOK_0__"
headers = {
  "Content-Type": "application/json",
  "Authorization": "__RP_TOK_1__",
  "Revolut-Api-Version": "__RP_TOK_2__"
}
payload = {
  "quantity": 150
}

response = requests.patch(url, headers=headers, json=payload)
print(response.json())
6f9:T1b89,
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;

public class Main {
  public static void main(String[] args) {
    HttpClient client = HttpClient.newHttpClient();
    String body = """
{
  "quantity": 150
}
    """;

    HttpRequest request = HttpRequest.newBuilder()
      .uri(URI.create("https://merchant.revolut.com/api/subscription-usages/__RP_TOK_0__"))
      .header("Content-Type", "application/json")
      .header("Authorization", "__RP_TOK_1__")
      .header("Revolut-Api-Version", "__RP_TOK_2__")
      .PATCH(HttpRequest.BodyPublishers.ofString(body))
      .build();

    client.sendAsync(request, HttpResponse.BodyHandlers.ofString())
      .thenApply(HttpResponse::body)
      .thenAccept(System.out::println)
      .join();
  }
}
6fa:T1cc7,
using System.Net.Http;
using System.Net.Http.Headers;

var client = new HttpClient();
var request = new HttpRequestMessage
{
  Method = HttpMethod.Patch,
  RequestUri = new Uri("https://merchant.revolut.com/api/subscription-usages/__RP_TOK_0__"),
  Headers =
  {
    { "Authorization", "__RP_TOK_1__" },
    { "Revolut-Api-Version", "__RP_TOK_2__" },
  },
  Content = new StringContent(@"{
  ""quantity"": 150
}")
  {
    Headers =
    {
      ContentType = new MediaTypeHeaderValue("application/json")
    }
  }
};

using (var response = await client.SendAsync(request))
{
  response.EnsureSuccessStatusCode();
  var body = await response.Content.ReadAsStringAsync();
  Console.WriteLine(body);
}
6fb:T648,
curl -X PATCH "https://sandbox-merchant.revolut.com/api/subscription-usages/__RP_TOK_0__" \
  -H "Content-Type: application/json" \
  -H "Authorization: __RP_TOK_1__" \
  -H "Revolut-Api-Version: __RP_TOK_2__" \
  -d '{
  "quantity": 150
}'
6fc:Te91,
const payload = {
  "quantity": 150
};
fetch("https://sandbox-merchant.revolut.com/api/subscription-usages/__RP_TOK_0__", {
  method: "PATCH",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "__RP_TOK_1__",
    "Revolut-Api-Version": "__RP_TOK_2__"
  },
  body: JSON.stringify(payload)
})
  .then(response => response.json())
  .then(data => console.log(data));
6fd:T162d,
package main

import (
  "fmt"
  "net/http"
  "bytes"
  "encoding/json"
)

func main() {
  url := "https://sandbox-merchant.revolut.com/api/subscription-usages/__RP_TOK_0__"
  jsonData := []byte(`
{
  "quantity": 150
}
  `)
  req, _ := http.NewRequest("PATCH", url, bytes.NewBuffer(jsonData))
  req.Header.Add("Content-Type", "application/json")
  req.Header.Add("Authorization", "__RP_TOK_1__")
  req.Header.Add("Revolut-Api-Version", "__RP_TOK_2__")

  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  fmt.Println(res)
}
6fe:Tbc5,
import requests

url = "https://sandbox-merchant.revolut.com/api/subscription-usages/__RP_TOK_0__"
headers = {
  "Content-Type": "application/json",
  "Authorization": "__RP_TOK_1__",
  "Revolut-Api-Version": "__RP_TOK_2__"
}
payload = {
  "quantity": 150
}

response = requests.patch(url, headers=headers, json=payload)
print(response.json())
6ff:T1b91,
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;

public class Main {
  public static void main(String[] args) {
    HttpClient client = HttpClient.newHttpClient();
    String body = """
{
  "quantity": 150
}
    """;

    HttpRequest request = HttpRequest.newBuilder()
      .uri(URI.create("https://sandbox-merchant.revolut.com/api/subscription-usages/__RP_TOK_0__"))
      .header("Content-Type", "application/json")
      .header("Authorization", "__RP_TOK_1__")
      .header("Revolut-Api-Version", "__RP_TOK_2__")
      .PATCH(HttpRequest.BodyPublishers.ofString(body))
      .build();

    client.sendAsync(request, HttpResponse.BodyHandlers.ofString())
      .thenApply(HttpResponse::body)
      .thenAccept(System.out::println)
      .join();
  }
}
700:T1ccf,
using System.Net.Http;
using System.Net.Http.Headers;

var client = new HttpClient();
var request = new HttpRequestMessage
{
  Method = HttpMethod.Patch,
  RequestUri = new Uri("https://sandbox-merchant.revolut.com/api/subscription-usages/__RP_TOK_0__"),
  Headers =
  {
    { "Authorization", "__RP_TOK_1__" },
    { "Revolut-Api-Version", "__RP_TOK_2__" },
  },
  Content = new StringContent(@"{
  ""quantity"": 150
}")
  {
    Headers =
    {
      ContentType = new MediaTypeHeaderValue("application/json")
    }
  }
};

using (var response = await client.SendAsync(request))
{
  response.EnsureSuccessStatusCode();
  var body = await response.Content.ReadAsStringAsync();
  Console.WriteLine(body);
}
6ed:["$","div",null,{"className":"ezz1n30","children":[["$","div",null,{"data-header":"$undefined","className":"ezz1n31","children":["$L6f0",["$","$L85",null,{"parameters":[{"name":"Authorization","in":"header","schema":{"type":"string","format":"Bearer ","examples":"$62:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:0:schema:examples"},"required":true,"description":"This parameter accepts the [Merchant API Secret key](https://business.revolut.com/settings/apis?tab=merchant-api) to authorise requests coming from the merchant's backend. \n\nIt ensures that ensures that each request is authenticated and authorised by verifying the secret key. The secret key should be included in all request headers as a `Bearer` token.\n\n:::info\nFor more information, see: [Authentication](https://developer.revolut.com/docs/api/merchant#authentication)\n:::","descriptionNode":"$L6f1"},{"name":"Revolut-Api-Version","in":"header","schema":{"type":"string","format":"date","enum":"$36:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:1:schema:enum","examples":"$36:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:1:schema:examples"},"required":true,"description":"The version of the Merchant API, specified in `YYYY-MM-DD` format.\n\nIf not specified, you will receive an error.\n\n\n:::info\nFor more information about API versioning, see: [API versions](https://developer.revolut.com/docs/guides/merchant/reference/versioning/api-versions).\n:::","x-config-always-visible-in-example":true,"example":"2025-10-16","descriptionNode":"$L6f2"},{"name":"usage_id","in":"path","schema":{"type":"string","format":"uuid","description":"A UUID string, typically used to identify resources.","descriptionNode":"$L6f3"},"required":true,"description":"The ID of the usage record.","descriptionNode":"$L6f4"}],"requestBody":"$3e:props:children:0:props:children:props:requestBody","heading":"Request","requestBodySchemaTitle":"Request body","headingAs":"h3"}],["$","$L89",null,{"responses":"$3e:props:children:0:props:children:props:responses","headingAs":"h3"}]]}],["$","div",null,{"className":"ezz1n32","children":[[["$","$L8a",null,{"itemsByServer":{"https://merchant.revolut.com":[{"id":"curl","label":"cURL","templateCode":"curl -X PATCH \"https://merchant.revolut.com/api/subscription-usages/__RP_TOK_0__\" \\\n -H \"Content-Type: application/json\" \\\n -H \"Authorization: __RP_TOK_1__\" \\\n -H \"Revolut-Api-Version: __RP_TOK_2__\" \\\n -d '{\n \"quantity\": 150\n}'","templateHtml":"$6f5","tokens":[{"marker":"__RP_TOK_0__","paramName":"usage_id","paramIn":"path","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["shell-double-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:usage_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"javascript","label":"JavaScript","templateCode":"const payload = {\n \"quantity\": 150\n};\nfetch(\"https://merchant.revolut.com/api/subscription-usages/__RP_TOK_0__\", {\n method: \"PATCH\",\n headers: {\n \"Content-Type\": \"application/json\",\n \"Authorization\": \"__RP_TOK_1__\",\n \"Revolut-Api-Version\": \"__RP_TOK_2__\"\n },\n body: JSON.stringify(payload)\n})\n .then(response => response.json())\n .then(data => console.log(data));","templateHtml":"$6f6","tokens":[{"marker":"__RP_TOK_0__","paramName":"usage_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:usage_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"go","label":"Go","templateCode":"package main\n\nimport (\n \"fmt\"\n \"net/http\"\n \"bytes\"\n \"encoding/json\"\n)\n\nfunc main() {\n url := \"https://merchant.revolut.com/api/subscription-usages/__RP_TOK_0__\"\n jsonData := []byte(`\n{\n \"quantity\": 150\n}\n `)\n req, _ := http.NewRequest(\"PATCH\", url, bytes.NewBuffer(jsonData))\n req.Header.Add(\"Content-Type\", \"application/json\")\n req.Header.Add(\"Authorization\", \"__RP_TOK_1__\")\n req.Header.Add(\"Revolut-Api-Version\", \"__RP_TOK_2__\")\n\n res, _ := http.DefaultClient.Do(req)\n defer res.Body.Close()\n fmt.Println(res)\n}","templateHtml":"$6f7","tokens":[{"marker":"__RP_TOK_0__","paramName":"usage_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:usage_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"python","label":"Python","templateCode":"import requests\n\nurl = \"https://merchant.revolut.com/api/subscription-usages/__RP_TOK_0__\"\nheaders = {\n \"Content-Type\": \"application/json\",\n \"Authorization\": \"__RP_TOK_1__\",\n \"Revolut-Api-Version\": \"__RP_TOK_2__\"\n}\npayload = {\n \"quantity\": 150\n}\n\nresponse = requests.patch(url, headers=headers, json=payload)\nprint(response.json())","templateHtml":"$6f8","tokens":[{"marker":"__RP_TOK_0__","paramName":"usage_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:usage_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"java","label":"Java","templateCode":"import java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\nimport java.net.URI;\n\npublic class Main {\n public static void main(String[] args) {\n HttpClient client = HttpClient.newHttpClient();\n String body = \"\"\"\n{\n \"quantity\": 150\n}\n \"\"\";\n\n HttpRequest request = HttpRequest.newBuilder()\n .uri(URI.create(\"https://merchant.revolut.com/api/subscription-usages/__RP_TOK_0__\"))\n .header(\"Content-Type\", \"application/json\")\n .header(\"Authorization\", \"__RP_TOK_1__\")\n .header(\"Revolut-Api-Version\", \"__RP_TOK_2__\")\n .PATCH(HttpRequest.BodyPublishers.ofString(body))\n .build();\n\n client.sendAsync(request, HttpResponse.BodyHandlers.ofString())\n .thenApply(HttpResponse::body)\n .thenAccept(System.out::println)\n .join();\n }\n}","templateHtml":"$6f9","tokens":[{"marker":"__RP_TOK_0__","paramName":"usage_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:usage_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"csharp","label":"C#","templateCode":"using System.Net.Http;\nusing System.Net.Http.Headers;\n\nvar client = new HttpClient();\nvar request = new HttpRequestMessage\n{\n Method = HttpMethod.Patch,\n RequestUri = new Uri(\"https://merchant.revolut.com/api/subscription-usages/__RP_TOK_0__\"),\n Headers =\n {\n { \"Authorization\", \"__RP_TOK_1__\" },\n { \"Revolut-Api-Version\", \"__RP_TOK_2__\" },\n },\n Content = new StringContent(@\"{\n \"\"quantity\"\": 150\n}\")\n {\n Headers =\n {\n ContentType = new MediaTypeHeaderValue(\"application/json\")\n }\n }\n};\n\nusing (var response = await client.SendAsync(request))\n{\n response.EnsureSuccessStatusCode();\n var body = await response.Content.ReadAsStringAsync();\n Console.WriteLine(body);\n}","templateHtml":"$6fa","tokens":[{"marker":"__RP_TOK_0__","paramName":"usage_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:usage_id":"123e4567-e89b-12d3-a456-426614174000"}}],"https://sandbox-merchant.revolut.com":[{"id":"curl","label":"cURL","templateCode":"curl -X PATCH \"https://sandbox-merchant.revolut.com/api/subscription-usages/__RP_TOK_0__\" \\\n -H \"Content-Type: application/json\" \\\n -H \"Authorization: __RP_TOK_1__\" \\\n -H \"Revolut-Api-Version: __RP_TOK_2__\" \\\n -d '{\n \"quantity\": 150\n}'","templateHtml":"$6fb","tokens":[{"marker":"__RP_TOK_0__","paramName":"usage_id","paramIn":"path","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["shell-double-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:usage_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"javascript","label":"JavaScript","templateCode":"const payload = {\n \"quantity\": 150\n};\nfetch(\"https://sandbox-merchant.revolut.com/api/subscription-usages/__RP_TOK_0__\", {\n method: \"PATCH\",\n headers: {\n \"Content-Type\": \"application/json\",\n \"Authorization\": \"__RP_TOK_1__\",\n \"Revolut-Api-Version\": \"__RP_TOK_2__\"\n },\n body: JSON.stringify(payload)\n})\n .then(response => response.json())\n .then(data => console.log(data));","templateHtml":"$6fc","tokens":[{"marker":"__RP_TOK_0__","paramName":"usage_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:usage_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"go","label":"Go","templateCode":"package main\n\nimport (\n \"fmt\"\n \"net/http\"\n \"bytes\"\n \"encoding/json\"\n)\n\nfunc main() {\n url := \"https://sandbox-merchant.revolut.com/api/subscription-usages/__RP_TOK_0__\"\n jsonData := []byte(`\n{\n \"quantity\": 150\n}\n `)\n req, _ := http.NewRequest(\"PATCH\", url, bytes.NewBuffer(jsonData))\n req.Header.Add(\"Content-Type\", \"application/json\")\n req.Header.Add(\"Authorization\", \"__RP_TOK_1__\")\n req.Header.Add(\"Revolut-Api-Version\", \"__RP_TOK_2__\")\n\n res, _ := http.DefaultClient.Do(req)\n defer res.Body.Close()\n fmt.Println(res)\n}","templateHtml":"$6fd","tokens":[{"marker":"__RP_TOK_0__","paramName":"usage_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:usage_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"python","label":"Python","templateCode":"import requests\n\nurl = \"https://sandbox-merchant.revolut.com/api/subscription-usages/__RP_TOK_0__\"\nheaders = {\n \"Content-Type\": \"application/json\",\n \"Authorization\": \"__RP_TOK_1__\",\n \"Revolut-Api-Version\": \"__RP_TOK_2__\"\n}\npayload = {\n \"quantity\": 150\n}\n\nresponse = requests.patch(url, headers=headers, json=payload)\nprint(response.json())","templateHtml":"$6fe","tokens":[{"marker":"__RP_TOK_0__","paramName":"usage_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:usage_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"java","label":"Java","templateCode":"import java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\nimport java.net.URI;\n\npublic class Main {\n public static void main(String[] args) {\n HttpClient client = HttpClient.newHttpClient();\n String body = \"\"\"\n{\n \"quantity\": 150\n}\n \"\"\";\n\n HttpRequest request = HttpRequest.newBuilder()\n .uri(URI.create(\"https://sandbox-merchant.revolut.com/api/subscription-usages/__RP_TOK_0__\"))\n .header(\"Content-Type\", \"application/json\")\n .header(\"Authorization\", \"__RP_TOK_1__\")\n .header(\"Revolut-Api-Version\", \"__RP_TOK_2__\")\n .PATCH(HttpRequest.BodyPublishers.ofString(body))\n .build();\n\n client.sendAsync(request, HttpResponse.BodyHandlers.ofString())\n .thenApply(HttpResponse::body)\n .thenAccept(System.out::println)\n .join();\n }\n}","templateHtml":"$6ff","tokens":[{"marker":"__RP_TOK_0__","paramName":"usage_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:usage_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"csharp","label":"C#","templateCode":"using System.Net.Http;\nusing System.Net.Http.Headers;\n\nvar client = new HttpClient();\nvar request = new HttpRequestMessage\n{\n Method = HttpMethod.Patch,\n RequestUri = new Uri(\"https://sandbox-merchant.revolut.com/api/subscription-usages/__RP_TOK_0__\"),\n Headers =\n {\n { \"Authorization\", \"__RP_TOK_1__\" },\n { \"Revolut-Api-Version\", \"__RP_TOK_2__\" },\n },\n Content = new StringContent(@\"{\n \"\"quantity\"\": 150\n}\")\n {\n Headers =\n {\n ContentType = new MediaTypeHeaderValue(\"application/json\")\n }\n }\n};\n\nusing (var response = await client.SendAsync(request))\n{\n response.EnsureSuccessStatusCode();\n var body = await response.Content.ReadAsStringAsync();\n Console.WriteLine(body);\n}","templateHtml":"$700","tokens":[{"marker":"__RP_TOK_0__","paramName":"usage_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:usage_id":"123e4567-e89b-12d3-a456-426614174000"}}]},"method":"patch","servers":"$62:props:children:0:props:children:props:children:1:props:children:1:props:children:0:0:props:servers","path":"/api/subscription-usages/{usage_id}","parameters":["$6ed:props:children:0:props:children:1:props:parameters:0","$6ed:props:children:0:props:children:1:props:parameters:1","$6ed:props:children:0:props:children:1:props:parameters:2"]}],"$L701"],"$L702","$L703"]}]]}] 701:["$","$L10d",null,{"security":[{"Api-Key":[]}],"authorization":{"Api-Key":{"type":"apiKey","in":"header","name":"Authorization","description":"Each Merchant API request must contain an authorization header in the following format:\n\n```\n'Authorization: Bearer '\n```\n\nTo use this API, you need to generate API keys from your Revolut Business account. The Secret key is used in the authorization header for all server calls, while the Public key is provided with payment methods at checkout.\n\n:::info\nFor detailed instructions on generating your API keys, see: [Generate API keys](https://developer.revolut.com/docs/guides/merchant/get-started#generate-api-keys).\n:::","descriptionNode":"$L704"}}}] 702:["$","$L10f",null,{"exampleBlocks":{"application/json":{"variants":[{"key":"update_usage_quantity","label":"Update quantity","rawValue":"$3e:props:children:0:props:children:props:requestBody:content:application/json:examples:update_usage_quantity:value","block":"$L705"},{"key":"update_usage_metadata","label":"Update metadata","rawValue":"$3e:props:children:0:props:children:props:requestBody:content:application/json:examples:update_usage_metadata:value","block":"$L706"},{"key":"update_usage","label":"Update both quantity and metadata","rawValue":"$3e:props:children:0:props:children:props:requestBody:content:application/json:examples:update_usage:value","block":"$L707"}],"syncedPropertyName":"$undefined"}},"title":"Request body samples","headingAs":"h4"}] 703:["$","$L110",null,{"exampleBlocks":{"200":{"application/json":{"variants":[{"key":"updated_usage","label":"Successful usage record creation","rawValue":"$3d:props:children:0:props:children:props:responses:200:content:application/json:examples:usage_record:value","block":"$L708"}],"syncedPropertyName":"$undefined"}},"400":{"application/json":{"variants":[{"key":"default","label":"Example","rawValue":{"code":"string","message":"string","timestamp":123},"block":"$L709"}],"syncedPropertyName":"$undefined"}},"401":{"application/json":{"variants":[{"key":"default","label":"Example","rawValue":{"code":"string","message":"string","timestamp":123},"block":"$L70a"}],"syncedPropertyName":"$undefined"}},"404":{"application/json":{"variants":[{"key":"default","label":"Example","rawValue":{"code":"string","message":"string","timestamp":123},"block":"$L70b"}],"syncedPropertyName":"$undefined"}},"422":{"application/json":{"variants":[{"key":"usage_locked","label":"Cycle is past the usage cutoff date","rawValue":"$3e:props:children:0:props:children:props:responses:422:content:application/json:examples:usage_locked:value","block":"$L70c"}],"syncedPropertyName":"$undefined"}},"default":{"application/json":{"variants":[{"key":"default","label":"Example","rawValue":{"code":"string","message":"string","timestamp":123},"block":"$L70d"}],"syncedPropertyName":"$undefined"}}},"headingAs":"h4"}] 70e:T1bb2,
{
  "next_page_token": "9e5d2caa-bb60-4b5b-b7cf-6345bbdff67e",
  "cycles": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440010",
      "subscription_id": "650e8400-e29b-41d4-a716-446655440001",
      "plan_variation_id": "750e8400-e29b-41d4-a716-446655440002",
      "plan_variation_phase_id": "850e8400-e29b-41d4-a716-446655440003",
      "number": 2,
      "previous_cycle_id": "550e8400-e29b-41d4-a716-446655440000",
      "state": "active",
      "start_date": "2025-07-05T21:00:00.036001Z",
      "end_date": "2025-08-05T21:00:00.036001Z",
      "order_id": "a50e8400-e29b-41d4-a716-446655440015",
      "trial": false
    },
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "subscription_id": "650e8400-e29b-41d4-a716-446655440001",
      "plan_variation_id": "750e8400-e29b-41d4-a716-446655440002",
      "number": 1,
      "state": "finished",
      "start_date": "2025-06-05T21:00:00.036001Z",
      "end_date": "2025-07-05T21:00:00.036001Z",
      "order_id": "a50e8400-e29b-41d4-a716-446655440005",
      "trial": true
    }
  ]
}
68f:["$","div","200-application/json-cycles_list",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$70e"}}]}]],"$L70f"]}] 710:T44d,
{
  "code": "string",
  "message": "string",
  "timestamp": 123
}
690:["$","div","400-application/json-default",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$710"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"code\": \"string\",\n \"message\": \"string\",\n \"timestamp\": 123\n}"}]}]]}] 711:T44d,
{
  "code": "string",
  "message": "string",
  "timestamp": 123
}
691:["$","div","401-application/json-default",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$711"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"code\": \"string\",\n \"message\": \"string\",\n \"timestamp\": 123\n}"}]}]]}] 712:T44d,
{
  "code": "string",
  "message": "string",
  "timestamp": 123
}
692:["$","div","404-application/json-default",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$712"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"code\": \"string\",\n \"message\": \"string\",\n \"timestamp\": 123\n}"}]}]]}] 713:T44d,
{
  "code": "string",
  "message": "string",
  "timestamp": 123
}
693:["$","div","default-application/json-default",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$713"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"code\": \"string\",\n \"message\": \"string\",\n \"timestamp\": 123\n}"}]}]]}] 714:T1cfb,
{
  "next_page_token": "9e5d2caa-bb60-4b5b-b7cf-6345bbdff67e",
  "subscription_usages": [
    {
      "id": "750e8400-e29b-41d4-a716-446655440000",
      "subscription_id": "550e8400-e29b-41d4-a716-446655440000",
      "subscription_cycle_id": "850e8400-e29b-41d4-a716-446655440000",
      "subscription_item_code": "api_calls",
      "usage_date": "2026-03-01T21:00:00Z",
      "quantity": 100,
      "metadata": {
        "user_id": "12345",
        "api_version": "v2"
      },
      "created_at": "2026-03-01T21:05:00Z",
      "updated_at": "2026-03-01T21:05:00Z"
    },
    {
      "id": "bc903328-9f37-4d7a-8f56-02e5b7c76891",
      "subscription_id": "550e8400-e29b-41d4-a716-446655440000",
      "subscription_cycle_id": "850e8400-e29b-41d4-a716-446655440000",
      "subscription_item_code": "api_calls",
      "usage_date": "2026-03-01T22:15:00Z",
      "quantity": 50,
      "metadata": {
        "user_id": "12345",
        "api_version": "v2"
      },
      "created_at": "2026-03-01T22:20:00Z",
      "updated_at": "2026-03-01T22:20:00Z"
    }
  ]
}
695:["$","div","200-application/json-usage_list",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$714"}}]}]],"$L715"]}] 716:T44d,
{
  "code": "string",
  "message": "string",
  "timestamp": 123
}
696:["$","div","400-application/json-default",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$716"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"code\": \"string\",\n \"message\": \"string\",\n \"timestamp\": 123\n}"}]}]]}] 717:T44d,
{
  "code": "string",
  "message": "string",
  "timestamp": 123
}
697:["$","div","401-application/json-default",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$717"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"code\": \"string\",\n \"message\": \"string\",\n \"timestamp\": 123\n}"}]}]]}] 718:T44d,
{
  "code": "string",
  "message": "string",
  "timestamp": 123
}
698:["$","div","default-application/json-default",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$718"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"code\": \"string\",\n \"message\": \"string\",\n \"timestamp\": 123\n}"}]}]]}] 719:T426,{ "next_page_token": "9e5d2caa-bb60-4b5b-b7cf-6345bbdff67e", "cycles": [ { "id": "550e8400-e29b-41d4-a716-446655440010", "subscription_id": "650e8400-e29b-41d4-a716-446655440001", "plan_variation_id": "750e8400-e29b-41d4-a716-446655440002", "plan_variation_phase_id": "850e8400-e29b-41d4-a716-446655440003", "number": 2, "previous_cycle_id": "550e8400-e29b-41d4-a716-446655440000", "state": "active", "start_date": "2025-07-05T21:00:00.036001Z", "end_date": "2025-08-05T21:00:00.036001Z", "order_id": "a50e8400-e29b-41d4-a716-446655440015", "trial": false }, { "id": "550e8400-e29b-41d4-a716-446655440000", "subscription_id": "650e8400-e29b-41d4-a716-446655440001", "plan_variation_id": "750e8400-e29b-41d4-a716-446655440002", "number": 1, "state": "finished", "start_date": "2025-06-05T21:00:00.036001Z", "end_date": "2025-07-05T21:00:00.036001Z", "order_id": "a50e8400-e29b-41d4-a716-446655440005", "trial": true } ] }70f:["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"$719"}]}] 71a:T427,{ "next_page_token": "9e5d2caa-bb60-4b5b-b7cf-6345bbdff67e", "subscription_usages": [ { "id": "750e8400-e29b-41d4-a716-446655440000", "subscription_id": "550e8400-e29b-41d4-a716-446655440000", "subscription_cycle_id": "850e8400-e29b-41d4-a716-446655440000", "subscription_item_code": "api_calls", "usage_date": "2026-03-01T21:00:00Z", "quantity": 100, "metadata": { "user_id": "12345", "api_version": "v2" }, "created_at": "2026-03-01T21:05:00Z", "updated_at": "2026-03-01T21:05:00Z" }, { "id": "bc903328-9f37-4d7a-8f56-02e5b7c76891", "subscription_id": "550e8400-e29b-41d4-a716-446655440000", "subscription_cycle_id": "850e8400-e29b-41d4-a716-446655440000", "subscription_item_code": "api_calls", "usage_date": "2026-03-01T22:15:00Z", "quantity": 50, "metadata": { "user_id": "12345", "api_version": "v2" }, "created_at": "2026-03-01T22:20:00Z", "updated_at": "2026-03-01T22:20:00Z" } ] }715:["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"$71a"}]}] 34:["$","$7a","retrieve-subscription",{"children":[["$","section",null,{"className":"y9a0do0","data-variant":"endpoint","children":["$","$L7b",null,{"responses":{"200":{"description":"Subscription retrieved successfully","content":{"application/json":{"schema":{"type":"object","required":["id","state","customer_id","plan_id","plan_variation_id","payment_method_type","created_at","updated_at","current_cycle_id"],"properties":{"id":{"type":"string","format":"uuid","description":"Unique identifier for the subscription.","descriptionNode":"$L71b"},"external_reference":{"type":"string","maxLength":1024,"description":"Optional external reference for the subscription.\n\nUse this field to store your own system's identifier for easy tracking and correlation.","descriptionNode":"$L71c"},"state":{"type":"string","enum":["pending","active","overdue","paused","cancelled","finished"],"description":"The state of the subscription.\n\n| State | Description |\n| ----- | ----------- |\n| `pending` | The subscription has been created but is not yet active. This typically occurs when awaiting the first payment or setup completion. |\n| `active` | The subscription is currently active and billing cycles are processing normally. |\n| `overdue` | The subscription has a failed payment and is awaiting resolution. |\n| `paused` | The subscription has been temporarily paused and no billing will occur. |\n| `cancelled` | The subscription has been cancelled and will not renew. |\n| `finished` | The subscription has completed all billing cycles (for limited-duration subscriptions). |","descriptionNode":"$L71d"},"customer_id":{"type":"string","format":"uuid","description":"Unique identifier for the customer.","descriptionNode":"$L71e"},"plan_id":{"type":"string","format":"uuid","description":"Unique identifier for the subscription plan.","descriptionNode":"$L71f"},"plan_variation_id":{"type":"string","format":"uuid","description":"Unique identifier for the subscription plan variation.","descriptionNode":"$L720"},"payment_method_type":{"type":"string","enum":["automatic","manual"],"description":"The type of payment method used for the subscription.\n\n| Type | Description |\n| ---- | ----------- |\n| `automatic` | Payments are automatically charged to the customer's saved payment method. |\n| `manual` | Payments require manual processing by the customer. |","descriptionNode":"$L721"},"payment_method_id":{"type":"string","format":"uuid","description":"Unique identifier for the payment method.","descriptionNode":"$L722"},"created_at":{"type":"string","format":"date-time","description":"The date and time the subscription was created in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format.","descriptionNode":"$L723"},"updated_at":{"type":"string","format":"date-time","description":"The date and time the subscription was last updated in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format.","descriptionNode":"$L724"},"start_date":{"type":["string","null"],"format":"date-time","description":"The date and time the subscription started in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format.\n\nThis field is `null` until the subscription becomes active.","descriptionNode":"$L725"},"current_cycle_id":{"type":"string","format":"uuid","description":"Unique identifier for the subscription cycle.","descriptionNode":"$L726"},"trial_duration":{"type":"string","format":"duration","description":"The trial period duration for this subscription in [ISO 8601 duration format](https://en.wikipedia.org/wiki/ISO_8601#Durations) (e.g., \"P14D\" for 14 days).\n\n### Override plan defaults\n\nSubscription plans can define a default trial duration. When creating a subscription, you can use this field to override the plan's default trial period:\n\n| Field value | Behaviour | Example |\n| ----------- | -------- | ------- |\n| **Not provided** | Uses the trial duration defined in the plan (if any) | Plan has `\"P7D\"` → subscription gets 7-day trial |\n| **Different value** | Overrides the plan's default trial duration | Plan has `\"P7D\"` → set to `\"P30D\"` for promotional offer, or `\"P3D\"` to reduce |\n| **`\"P0D\"`** | Explicitly skips the trial period | Plan has `\"P7D\"` → set to `\"P0D\"` to skip trial entirely |\n\n:::note\nOnly days (`D`) are allowed. Time components such as hours, minutes, or seconds are not permitted.\n:::","pattern":"^P[0-9]+D$","examples":["P14D"],"descriptionNode":"$L727"},"trial_end_date":{"type":["string","null"],"format":"date-time","description":"The date and time when the subscription's trial period ends in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format.\n\nThis value is automatically calculated by the system as: `start_date` + `trial_duration`\n\nThe `trial_duration` used in the calculation comes from either:\n- The subscription's custom `trial_duration` (if provided at creation time), or\n- The plan's default `trial_duration` (if no override was specified)\n\nThis field is `null` when the subscription has no trial period (e.g., when `trial_duration` is not set or is `\"P0D\"`).","examples":["2025-06-19T21:00:00.036001Z"],"descriptionNode":"$L728"},"setup_order_id":{"type":"string","format":"uuid","description":"The ID of the order created for handling the setup payment for the subscription.\n\nUse the [Retrieve an order](https://developer.revolut.com/docs/api/merchant#retrieve-order) endpoint with this ID to get order details, including the `checkout_url` for redirecting customers to the Hosted Payment Page or the `token` for widget integration.\n\n:::note\nThe order is created in parallel to the subscription and is used to collect the initial payment and save the customer's payment method for future billing cycles.\n:::","descriptionNode":"$L729"},"scheduled_action":{"description":"A pending scheduled action on the subscription, applied at the end of the current billing cycle.","type":"object","discriminator":{"propertyName":"type","mapping":{"cancel":"#/components/schemas/Subscription-Scheduled-Action-Cancel","change_plan_variation":"#/components/schemas/Subscription-Scheduled-Action-Change-Plan"}},"oneOf":[{"title":"Subscription-Scheduled-Action-Cancel","type":"object","description":"A cancellation scheduled to take effect at the end of the current billing cycle.","required":["type","reason"],"properties":{"type":{"type":"string","description":"The type of the scheduled action.\n\n| Value | Description |\n| ----- | ----------- |\n| `cancel` | A cancellation scheduled to take effect at the end of the current billing cycle. |\n| `change_plan_variation` | A plan variation change scheduled to take effect at the end of the current billing cycle. |","enum":["cancel","change_plan_variation"],"examples":["change_plan_variation"],"descriptionNode":"$L72a"},"reason":{"type":"string","description":"The reason for the scheduled action. This field is informational and does not affect how the action is processed.\n\n| Value | Description |\n| ----- | ----------- |\n| `customer_request` | The action was requested by the customer. |\n| `merchant_request` | The action was initiated by the merchant. |","enum":"$37:props:children:0:props:children:props:requestBody:content:application/json:schema:properties:reason:enum","default":"merchant_request","examples":"$37:props:children:0:props:children:props:requestBody:content:application/json:schema:properties:reason:examples","descriptionNode":"$L72b"}},"descriptionNode":"$L72c"},{"title":"Subscription-Scheduled-Action-Change-Plan","type":"object","description":"A plan variation change scheduled to take effect at the end of the current billing cycle.","required":["type","reason","plan_variation_id"],"properties":{"type":{"type":"string","description":"The type of the scheduled action.\n\n| Value | Description |\n| ----- | ----------- |\n| `cancel` | A cancellation scheduled to take effect at the end of the current billing cycle. |\n| `change_plan_variation` | A plan variation change scheduled to take effect at the end of the current billing cycle. |","enum":"$34:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:scheduled_action:oneOf:0:properties:type:enum","examples":"$34:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:scheduled_action:oneOf:0:properties:type:examples","descriptionNode":"$L72d"},"reason":{"type":"string","description":"The reason for the scheduled action. This field is informational and does not affect how the action is processed.\n\n| Value | Description |\n| ----- | ----------- |\n| `customer_request` | The action was requested by the customer. |\n| `merchant_request` | The action was initiated by the merchant. |","enum":"$37:props:children:0:props:children:props:requestBody:content:application/json:schema:properties:reason:enum","default":"merchant_request","examples":"$37:props:children:0:props:children:props:requestBody:content:application/json:schema:properties:reason:examples","descriptionNode":"$L72e"},"plan_variation_id":{"type":"string","format":"uuid","description":"Unique identifier for the subscription plan variation.","descriptionNode":"$L72f"},"plan_variation_phase_id":{"type":"string","format":"uuid","description":"Unique identifier for the subscription plan phase.","descriptionNode":"$L730"}},"descriptionNode":"$L731"}],"descriptionNode":"$L732"}}},"examples":{"active_subscription":{"summary":"Active subscription","value":{"id":"550e8400-e29b-41d4-a716-446655440000","external_reference":"ext-ref-12345","state":"active","customer_id":"650e8400-e29b-41d4-a716-446655440001","plan_id":"750e8400-e29b-41d4-a716-446655440002","plan_variation_id":"850e8400-e29b-41d4-a716-446655440003","payment_method_type":"automatic","payment_method_id":"6689e244-8af7-4ada-9448-a91f02d4f192","created_at":"2025-06-05T21:00:00.036001Z","updated_at":"2025-06-05T21:00:00.036001Z","start_date":"2025-06-05T21:00:00.036001Z","current_cycle_id":"950e8400-e29b-41d4-a716-446655440004","trial_duration":"P14D","trial_end_date":"2025-06-19T21:00:00.036001Z"}}}}},"descriptionNode":"$L733"},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"code":{"type":"string","description":"An identifier that can be used to determine what went wrong.\n\nError codes are not globally unique, but uniqueness is guaranteed within endpoints.","descriptionNode":"$L734"},"message":{"type":"string","description":"Some human readable text describing what went wrong.","descriptionNode":"$L735"},"timestamp":{"type":"integer","description":"The [UNIX timestamp](https://www.unixtimestamp.com/) of the date and time the error happened.","descriptionNode":"$L736"}}}}},"descriptionNode":"$L737"},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"code":{"type":"string","description":"An identifier that can be used to determine what went wrong.\n\nError codes are not globally unique, but uniqueness is guaranteed within endpoints.","descriptionNode":"$L738"},"message":{"type":"string","description":"Some human readable text describing what went wrong.","descriptionNode":"$L739"},"timestamp":{"type":"integer","description":"The [UNIX timestamp](https://www.unixtimestamp.com/) of the date and time the error happened.","descriptionNode":"$L73a"}}}}},"descriptionNode":"$L73b"},"404":{"description":"Subscription not found","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"code":{"type":"string","description":"An identifier that can be used to determine what went wrong.\n\nError codes are not globally unique, but uniqueness is guaranteed within endpoints.","descriptionNode":"$L73c"},"message":{"type":"string","description":"Some human readable text describing what went wrong.","descriptionNode":"$L73d"},"timestamp":{"type":"integer","description":"The [UNIX timestamp](https://www.unixtimestamp.com/) of the date and time the error happened.","descriptionNode":"$L73e"}}}}},"descriptionNode":"$L73f"},"default":{"description":"Error response","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"code":{"type":"string","description":"An identifier that can be used to determine what went wrong.\n\nError codes are not globally unique, but uniqueness is guaranteed within endpoints.","descriptionNode":"$L740"},"message":{"type":"string","description":"Some human readable text describing what went wrong.","descriptionNode":"$L741"},"timestamp":{"type":"integer","description":"The [UNIX timestamp](https://www.unixtimestamp.com/) of the date and time the error happened.","descriptionNode":"$L742"}}}}},"descriptionNode":"$L743"}},"requestBody":"$undefined","variantLabels":[],"children":["$L744","$L745"]}]}],false]}] 6ef:"Update a subscription usage" 744:["$","div",null,{"className":"ezz1n30","children":[["$","div",null,{"data-header":"$undefined","className":"ezz1n31","children":["$","div",null,{"className":"y9a0do1","children":[["$","h2",null,{"id":"retrieve-subscription","children":[["$L746","$undefined"],["$","$L15",null,{"id":"retrieve-subscription"}]]}],["$","$L16",null,{"url":"/docs/api/merchant/2025-10-16/operations/retrieve-subscription.md"}]]}]}],"$undefined"]}] 74c:T9d7,
fetch("https://merchant.revolut.com/api/subscriptions/__RP_TOK_0__", {
  method: "GET",
  headers: {
    "Authorization": "__RP_TOK_1__",
    "Revolut-Api-Version": "__RP_TOK_2__"
  }
})
  .then(response => response.json())
  .then(data => console.log(data));
74d:Tf74,
package main

import (
  "fmt"
  "net/http"
)

func main() {
  url := "https://merchant.revolut.com/api/subscriptions/__RP_TOK_0__"
  req, _ := http.NewRequest("GET", url, nil)
  req.Header.Add("Authorization", "__RP_TOK_1__")
  req.Header.Add("Revolut-Api-Version", "__RP_TOK_2__")

  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  fmt.Println(res)
}
74e:T7e9,
import requests

url = "https://merchant.revolut.com/api/subscriptions/__RP_TOK_0__"
headers = {
  "Authorization": "__RP_TOK_1__",
  "Revolut-Api-Version": "__RP_TOK_2__"
}

response = requests.get(url, headers=headers)
print(response.json())
74f:T1715,
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;

public class Main {
  public static void main(String[] args) {
    HttpClient client = HttpClient.newHttpClient();
    HttpRequest request = HttpRequest.newBuilder()
      .uri(URI.create("https://merchant.revolut.com/api/subscriptions/__RP_TOK_0__"))
      .header("Authorization", "__RP_TOK_1__")
      .header("Revolut-Api-Version", "__RP_TOK_2__")
      .GET(HttpRequest.BodyPublishers.noBody())
      .build();

    client.sendAsync(request, HttpResponse.BodyHandlers.ofString())
      .thenApply(HttpResponse::body)
      .thenAccept(System.out::println)
      .join();
  }
}
750:T15bf,
using System.Net.Http;
using System.Net.Http.Headers;

var client = new HttpClient();
var request = new HttpRequestMessage
{
  Method = HttpMethod.Get,
  RequestUri = new Uri("https://merchant.revolut.com/api/subscriptions/__RP_TOK_0__"),
  Headers =
  {
    { "Authorization", "__RP_TOK_1__" },
    { "Revolut-Api-Version", "__RP_TOK_2__" },
  }
};

using (var response = await client.SendAsync(request))
{
  response.EnsureSuccessStatusCode();
  var body = await response.Content.ReadAsStringAsync();
  Console.WriteLine(body);
}
751:T9df,
fetch("https://sandbox-merchant.revolut.com/api/subscriptions/__RP_TOK_0__", {
  method: "GET",
  headers: {
    "Authorization": "__RP_TOK_1__",
    "Revolut-Api-Version": "__RP_TOK_2__"
  }
})
  .then(response => response.json())
  .then(data => console.log(data));
752:Tf7c,
package main

import (
  "fmt"
  "net/http"
)

func main() {
  url := "https://sandbox-merchant.revolut.com/api/subscriptions/__RP_TOK_0__"
  req, _ := http.NewRequest("GET", url, nil)
  req.Header.Add("Authorization", "__RP_TOK_1__")
  req.Header.Add("Revolut-Api-Version", "__RP_TOK_2__")

  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  fmt.Println(res)
}
753:T7f1,
import requests

url = "https://sandbox-merchant.revolut.com/api/subscriptions/__RP_TOK_0__"
headers = {
  "Authorization": "__RP_TOK_1__",
  "Revolut-Api-Version": "__RP_TOK_2__"
}

response = requests.get(url, headers=headers)
print(response.json())
754:T171d,
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;

public class Main {
  public static void main(String[] args) {
    HttpClient client = HttpClient.newHttpClient();
    HttpRequest request = HttpRequest.newBuilder()
      .uri(URI.create("https://sandbox-merchant.revolut.com/api/subscriptions/__RP_TOK_0__"))
      .header("Authorization", "__RP_TOK_1__")
      .header("Revolut-Api-Version", "__RP_TOK_2__")
      .GET(HttpRequest.BodyPublishers.noBody())
      .build();

    client.sendAsync(request, HttpResponse.BodyHandlers.ofString())
      .thenApply(HttpResponse::body)
      .thenAccept(System.out::println)
      .join();
  }
}
755:T15c7,
using System.Net.Http;
using System.Net.Http.Headers;

var client = new HttpClient();
var request = new HttpRequestMessage
{
  Method = HttpMethod.Get,
  RequestUri = new Uri("https://sandbox-merchant.revolut.com/api/subscriptions/__RP_TOK_0__"),
  Headers =
  {
    { "Authorization", "__RP_TOK_1__" },
    { "Revolut-Api-Version", "__RP_TOK_2__" },
  }
};

using (var response = await client.SendAsync(request))
{
  response.EnsureSuccessStatusCode();
  var body = await response.Content.ReadAsStringAsync();
  Console.WriteLine(body);
}
745:["$","div",null,{"className":"ezz1n30","children":[["$","div",null,{"data-header":"$undefined","className":"ezz1n31","children":["$L747",["$","$L85",null,{"parameters":[{"name":"Authorization","in":"header","schema":{"type":"string","format":"Bearer ","examples":"$62:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:0:schema:examples"},"required":true,"description":"This parameter accepts the [Merchant API Secret key](https://business.revolut.com/settings/apis?tab=merchant-api) to authorise requests coming from the merchant's backend. \n\nIt ensures that ensures that each request is authenticated and authorised by verifying the secret key. The secret key should be included in all request headers as a `Bearer` token.\n\n:::info\nFor more information, see: [Authentication](https://developer.revolut.com/docs/api/merchant#authentication)\n:::","descriptionNode":"$L748"},{"name":"Revolut-Api-Version","in":"header","schema":{"type":"string","format":"date","enum":"$36:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:1:schema:enum","examples":"$36:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:1:schema:examples"},"required":true,"description":"The version of the Merchant API, specified in `YYYY-MM-DD` format.\n\nIf not specified, you will receive an error.\n\n\n:::info\nFor more information about API versioning, see: [API versions](https://developer.revolut.com/docs/guides/merchant/reference/versioning/api-versions).\n:::","x-config-always-visible-in-example":true,"example":"2025-10-16","descriptionNode":"$L749"},{"name":"subscription_id","in":"path","schema":{"type":"string","format":"uuid","description":"A UUID string, typically used to identify resources.","descriptionNode":"$L74a"},"required":true,"description":"The ID of the subscription.","descriptionNode":"$L74b"}],"requestBody":"$undefined","heading":"Request","requestBodySchemaTitle":"Request body","headingAs":"h3"}],["$","$L89",null,{"responses":"$34:props:children:0:props:children:props:responses","headingAs":"h3"}]]}],["$","div",null,{"className":"ezz1n32","children":[[["$","$L8a",null,{"itemsByServer":{"https://merchant.revolut.com":[{"id":"curl","label":"cURL","templateCode":"curl -X GET \"https://merchant.revolut.com/api/subscriptions/__RP_TOK_0__\" \\\n -H \"Authorization: __RP_TOK_1__\" \\\n -H \"Revolut-Api-Version: __RP_TOK_2__\"","templateHtml":"
curl -X GET \"https://merchant.revolut.com/api/subscriptions/__RP_TOK_0__\" \\\n  -H \"Authorization: __RP_TOK_1__\" \\\n  -H \"Revolut-Api-Version: __RP_TOK_2__\"
","tokens":[{"marker":"__RP_TOK_0__","paramName":"subscription_id","paramIn":"path","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["shell-double-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:subscription_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"javascript","label":"JavaScript","templateCode":"fetch(\"https://merchant.revolut.com/api/subscriptions/__RP_TOK_0__\", {\n method: \"GET\",\n headers: {\n \"Authorization\": \"__RP_TOK_1__\",\n \"Revolut-Api-Version\": \"__RP_TOK_2__\"\n }\n})\n .then(response => response.json())\n .then(data => console.log(data));","templateHtml":"$74c","tokens":[{"marker":"__RP_TOK_0__","paramName":"subscription_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:subscription_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"go","label":"Go","templateCode":"package main\n\nimport (\n \"fmt\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://merchant.revolut.com/api/subscriptions/__RP_TOK_0__\"\n req, _ := http.NewRequest(\"GET\", url, nil)\n req.Header.Add(\"Authorization\", \"__RP_TOK_1__\")\n req.Header.Add(\"Revolut-Api-Version\", \"__RP_TOK_2__\")\n\n res, _ := http.DefaultClient.Do(req)\n defer res.Body.Close()\n fmt.Println(res)\n}","templateHtml":"$74d","tokens":[{"marker":"__RP_TOK_0__","paramName":"subscription_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:subscription_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"python","label":"Python","templateCode":"import requests\n\nurl = \"https://merchant.revolut.com/api/subscriptions/__RP_TOK_0__\"\nheaders = {\n \"Authorization\": \"__RP_TOK_1__\",\n \"Revolut-Api-Version\": \"__RP_TOK_2__\"\n}\n\nresponse = requests.get(url, headers=headers)\nprint(response.json())","templateHtml":"$74e","tokens":[{"marker":"__RP_TOK_0__","paramName":"subscription_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:subscription_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"java","label":"Java","templateCode":"import java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\nimport java.net.URI;\n\npublic class Main {\n public static void main(String[] args) {\n HttpClient client = HttpClient.newHttpClient();\n HttpRequest request = HttpRequest.newBuilder()\n .uri(URI.create(\"https://merchant.revolut.com/api/subscriptions/__RP_TOK_0__\"))\n .header(\"Authorization\", \"__RP_TOK_1__\")\n .header(\"Revolut-Api-Version\", \"__RP_TOK_2__\")\n .GET(HttpRequest.BodyPublishers.noBody())\n .build();\n\n client.sendAsync(request, HttpResponse.BodyHandlers.ofString())\n .thenApply(HttpResponse::body)\n .thenAccept(System.out::println)\n .join();\n }\n}","templateHtml":"$74f","tokens":[{"marker":"__RP_TOK_0__","paramName":"subscription_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:subscription_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"csharp","label":"C#","templateCode":"using System.Net.Http;\nusing System.Net.Http.Headers;\n\nvar client = new HttpClient();\nvar request = new HttpRequestMessage\n{\n Method = HttpMethod.Get,\n RequestUri = new Uri(\"https://merchant.revolut.com/api/subscriptions/__RP_TOK_0__\"),\n Headers =\n {\n { \"Authorization\", \"__RP_TOK_1__\" },\n { \"Revolut-Api-Version\", \"__RP_TOK_2__\" },\n }\n};\n\nusing (var response = await client.SendAsync(request))\n{\n response.EnsureSuccessStatusCode();\n var body = await response.Content.ReadAsStringAsync();\n Console.WriteLine(body);\n}","templateHtml":"$750","tokens":[{"marker":"__RP_TOK_0__","paramName":"subscription_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:subscription_id":"123e4567-e89b-12d3-a456-426614174000"}}],"https://sandbox-merchant.revolut.com":[{"id":"curl","label":"cURL","templateCode":"curl -X GET \"https://sandbox-merchant.revolut.com/api/subscriptions/__RP_TOK_0__\" \\\n -H \"Authorization: __RP_TOK_1__\" \\\n -H \"Revolut-Api-Version: __RP_TOK_2__\"","templateHtml":"
curl -X GET \"https://sandbox-merchant.revolut.com/api/subscriptions/__RP_TOK_0__\" \\\n  -H \"Authorization: __RP_TOK_1__\" \\\n  -H \"Revolut-Api-Version: __RP_TOK_2__\"
","tokens":[{"marker":"__RP_TOK_0__","paramName":"subscription_id","paramIn":"path","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["shell-double-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:subscription_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"javascript","label":"JavaScript","templateCode":"fetch(\"https://sandbox-merchant.revolut.com/api/subscriptions/__RP_TOK_0__\", {\n method: \"GET\",\n headers: {\n \"Authorization\": \"__RP_TOK_1__\",\n \"Revolut-Api-Version\": \"__RP_TOK_2__\"\n }\n})\n .then(response => response.json())\n .then(data => console.log(data));","templateHtml":"$751","tokens":[{"marker":"__RP_TOK_0__","paramName":"subscription_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:subscription_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"go","label":"Go","templateCode":"package main\n\nimport (\n \"fmt\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://sandbox-merchant.revolut.com/api/subscriptions/__RP_TOK_0__\"\n req, _ := http.NewRequest(\"GET\", url, nil)\n req.Header.Add(\"Authorization\", \"__RP_TOK_1__\")\n req.Header.Add(\"Revolut-Api-Version\", \"__RP_TOK_2__\")\n\n res, _ := http.DefaultClient.Do(req)\n defer res.Body.Close()\n fmt.Println(res)\n}","templateHtml":"$752","tokens":[{"marker":"__RP_TOK_0__","paramName":"subscription_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:subscription_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"python","label":"Python","templateCode":"import requests\n\nurl = \"https://sandbox-merchant.revolut.com/api/subscriptions/__RP_TOK_0__\"\nheaders = {\n \"Authorization\": \"__RP_TOK_1__\",\n \"Revolut-Api-Version\": \"__RP_TOK_2__\"\n}\n\nresponse = requests.get(url, headers=headers)\nprint(response.json())","templateHtml":"$753","tokens":[{"marker":"__RP_TOK_0__","paramName":"subscription_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:subscription_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"java","label":"Java","templateCode":"import java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\nimport java.net.URI;\n\npublic class Main {\n public static void main(String[] args) {\n HttpClient client = HttpClient.newHttpClient();\n HttpRequest request = HttpRequest.newBuilder()\n .uri(URI.create(\"https://sandbox-merchant.revolut.com/api/subscriptions/__RP_TOK_0__\"))\n .header(\"Authorization\", \"__RP_TOK_1__\")\n .header(\"Revolut-Api-Version\", \"__RP_TOK_2__\")\n .GET(HttpRequest.BodyPublishers.noBody())\n .build();\n\n client.sendAsync(request, HttpResponse.BodyHandlers.ofString())\n .thenApply(HttpResponse::body)\n .thenAccept(System.out::println)\n .join();\n }\n}","templateHtml":"$754","tokens":[{"marker":"__RP_TOK_0__","paramName":"subscription_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:subscription_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"csharp","label":"C#","templateCode":"using System.Net.Http;\nusing System.Net.Http.Headers;\n\nvar client = new HttpClient();\nvar request = new HttpRequestMessage\n{\n Method = HttpMethod.Get,\n RequestUri = new Uri(\"https://sandbox-merchant.revolut.com/api/subscriptions/__RP_TOK_0__\"),\n Headers =\n {\n { \"Authorization\", \"__RP_TOK_1__\" },\n { \"Revolut-Api-Version\", \"__RP_TOK_2__\" },\n }\n};\n\nusing (var response = await client.SendAsync(request))\n{\n response.EnsureSuccessStatusCode();\n var body = await response.Content.ReadAsStringAsync();\n Console.WriteLine(body);\n}","templateHtml":"$755","tokens":[{"marker":"__RP_TOK_0__","paramName":"subscription_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:subscription_id":"123e4567-e89b-12d3-a456-426614174000"}}]},"method":"get","servers":"$62:props:children:0:props:children:props:children:1:props:children:1:props:children:0:0:props:servers","path":"/api/subscriptions/{subscription_id}","parameters":["$745:props:children:0:props:children:1:props:parameters:0","$745:props:children:0:props:children:1:props:parameters:1","$745:props:children:0:props:children:1:props:parameters:2"]}],"$L756"],"$L757","$L758"]}]]}] 6b1:["$","div","CodeBlock-0",{"className":"wzy01m0 _18b50nc0","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"
'Authorization: Bearer <yourSecretApiKey>'
"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"'Authorization: Bearer '\n"}]}]]}] 6cc:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The unique identifier of the usage record."}]]}] 6cd:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unique identifier for the subscription."}]]}] 6ce:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unique identifier for the subscription cycle."}]]}] 6cf:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["A merchant-defined identifier for a usage-based subscription item. You set this code on each usage item when creating a subscription plan, and supply it when reporting consumption on ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#create-subscription-usage","target":"_blank","rel":"noreferrer","children":"Create a subscription usage endpoint"}]," to target the correct metered item."]}],"\n",["$","p","p-1",{"children":["This allows a subscription with multiple usage items (e.g., ",["$","code","code-0",{"children":"api_calls"}]," and ",["$","code","code-1",{"children":"storage_gb"}],") to receive consumption reports against the right item without relying on internal IDs."]}],"\n",["$","p","p-2",{"children":"The code must be unique within a plan phase."}]]}] 6d0:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The timestamp indicating when the consumption actually occurred."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Constraint","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Detail","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":"Format","className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":[["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_8601","target":"_blank","rel":"noreferrer","children":"ISO 8601"}]," date-time string (e.g., ",["$","code","code-0",{"children":"YYYY-MM-DDTHH:mm:ssZ"}],")."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":"Timezone","className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Must be UTC.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":"Validation","className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["Revolut uses this to identify the applicable billing cycle. Accepted for the active cycle (",["$","code","code-0",{"children":"start_date ≤ usage_date < end_date"}],"), for a recently ended cycle before its ",["$","code","code-1",{"children":"usage_cutoff_date"}],", and for the one next upcoming cycle. Other dates are rejected."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 6d1:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The quantity of consumption to record for this usage report."}],"\n",["$","p","p-1",{"children":"Supports up to 20 digits before and 20 digits after the decimal point."}]]}] 6d2:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Key-value pairs you can attach to a usage record for your own tracking and reporting purposes."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Constraint","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Detail","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":"Keys","className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Maximum 50 keys per record.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":"Value types","className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"String, number, or boolean only.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":"Number precision","className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Up to 20 digits before and 20 digits after the decimal point.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 6d3:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The date and time the usage record was created in ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_8601","target":"_blank","rel":"noreferrer","children":"ISO 8601"}]," format."]}]]}] 6d4:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The date and time the usage record was last updated in ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_8601","target":"_blank","rel":"noreferrer","children":"ISO 8601"}]," format."]}]]}] 6d5:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Usage updated successfully"}]]}] 6d6:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An identifier that can be used to determine what went wrong."}],"\n",["$","p","p-1",{"children":"Error codes are not globally unique, but uniqueness is guaranteed within endpoints."}]]}] 756:["$","$L10d",null,{"security":[{"Api-Key":[]}],"authorization":{"Api-Key":{"type":"apiKey","in":"header","name":"Authorization","description":"Each Merchant API request must contain an authorization header in the following format:\n\n```\n'Authorization: Bearer '\n```\n\nTo use this API, you need to generate API keys from your Revolut Business account. The Secret key is used in the authorization header for all server calls, while the Public key is provided with payment methods at checkout.\n\n:::info\nFor detailed instructions on generating your API keys, see: [Generate API keys](https://developer.revolut.com/docs/guides/merchant/get-started#generate-api-keys).\n:::","descriptionNode":"$L759"}}}] 757:["$","$L10f",null,{"exampleBlocks":{},"title":"Request body samples","headingAs":"h4"}] 758:["$","$L110",null,{"exampleBlocks":{"200":{"application/json":{"variants":[{"key":"active_subscription","label":"Active subscription","rawValue":"$34:props:children:0:props:children:props:responses:200:content:application/json:examples:active_subscription:value","block":"$L75a"}],"syncedPropertyName":"$undefined"}},"400":{"application/json":{"variants":[{"key":"default","label":"Example","rawValue":{"code":"string","message":"string","timestamp":123},"block":"$L75b"}],"syncedPropertyName":"$undefined"}},"401":{"application/json":{"variants":[{"key":"default","label":"Example","rawValue":{"code":"string","message":"string","timestamp":123},"block":"$L75c"}],"syncedPropertyName":"$undefined"}},"404":{"application/json":{"variants":[{"key":"default","label":"Example","rawValue":{"code":"string","message":"string","timestamp":123},"block":"$L75d"}],"syncedPropertyName":"$undefined"}},"default":{"application/json":{"variants":[{"key":"default","label":"Example","rawValue":{"code":"string","message":"string","timestamp":123},"block":"$L75e"}],"syncedPropertyName":"$undefined"}}},"headingAs":"h4"}] 3b:["$","$7a","create-subscription-usage",{"children":[["$","section",null,{"className":"y9a0do0","data-variant":"endpoint","children":["$","$L7b",null,{"responses":{"201":{"description":"Usage reported successfully","content":{"application/json":{"schema":{"type":"object","required":"$3d:props:children:0:props:children:props:responses:200:content:application/json:schema:required","properties":{"id":{"type":"string","format":"uuid","description":"The unique identifier of the usage record.","descriptionNode":"$L75f"},"subscription_id":{"type":"string","format":"uuid","description":"Unique identifier for the subscription.","descriptionNode":"$L760"},"subscription_cycle_id":{"type":"string","format":"uuid","description":"Unique identifier for the subscription cycle.","descriptionNode":"$L761"},"subscription_item_code":{"type":"string","description":"A merchant-defined identifier for a usage-based subscription item. You set this code on each usage item when creating a subscription plan, and supply it when reporting consumption on [Create a subscription usage endpoint](https://developer.revolut.com/docs/api/merchant#create-subscription-usage) to target the correct metered item.\n\nThis allows a subscription with multiple usage items (e.g., `api_calls` and `storage_gb`) to receive consumption reports against the right item without relying on internal IDs.\n\nThe code must be unique within a plan phase.","maxLength":250,"examples":"$3d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:subscription_item_code:examples","descriptionNode":"$L762"},"usage_date":{"type":"string","format":"date-time","description":"The timestamp indicating when the consumption actually occurred.\n\n| Constraint | Detail |\n| ---------- | ------ |\n| Format | [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date-time string (e.g., `YYYY-MM-DDTHH:mm:ssZ`). |\n| Timezone | Must be UTC. |\n| Validation | Revolut uses this to identify the applicable billing cycle. Accepted for the active cycle (`start_date ≤ usage_date < end_date`), for a recently ended cycle before its `usage_cutoff_date`, and for the one next upcoming cycle. Other dates are rejected. |","examples":"$3d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:usage_date:examples","descriptionNode":"$L763"},"quantity":{"type":"number","exclusiveMinimum":0,"description":"The quantity of consumption to record for this usage report. \n\nSupports up to 20 digits before and 20 digits after the decimal point.","examples":"$3d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:quantity:examples","descriptionNode":"$L764"},"metadata":{"type":"object","description":"Key-value pairs you can attach to a usage record for your own tracking and reporting purposes.\n\n| Constraint | Detail |\n| ---------- | ------ |\n| Keys | Maximum 50 keys per record. |\n| Value types | String, number, or boolean only. |\n| Number precision | Up to 20 digits before and 20 digits after the decimal point. |","additionalProperties":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]},"maxProperties":50,"examples":"$3d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:metadata:examples","descriptionNode":"$L765"},"created_at":{"type":"string","format":"date-time","description":"The date and time the usage record was created in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format.","examples":"$3d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:created_at:examples","descriptionNode":"$L766"},"updated_at":{"type":"string","format":"date-time","description":"The date and time the usage record was last updated in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format.","examples":"$3d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:updated_at:examples","descriptionNode":"$L767"}}},"examples":{"usage_record":{"summary":"Successful usage record creation","description":"Returns the reported usages","value":"$3d:props:children:0:props:children:props:responses:200:content:application/json:examples:usage_record:value"}}}},"descriptionNode":"$L768"},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"code":{"type":"string","description":"An identifier that can be used to determine what went wrong.\n\nError codes are not globally unique, but uniqueness is guaranteed within endpoints.","descriptionNode":"$L769"},"message":{"type":"string","description":"Some human readable text describing what went wrong.","descriptionNode":"$L76a"},"timestamp":{"type":"integer","description":"The [UNIX timestamp](https://www.unixtimestamp.com/) of the date and time the error happened.","descriptionNode":"$L76b"}}},"examples":{"item_code_not_found":{"summary":"Subscription item code not found","value":{"code":"subscription_item_code_not_found","message":"Subscription item code 'api_calls' not found for phase","timestamp":1743465600}}}}},"descriptionNode":"$L76c"},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"code":{"type":"string","description":"An identifier that can be used to determine what went wrong.\n\nError codes are not globally unique, but uniqueness is guaranteed within endpoints.","descriptionNode":"$L76d"},"message":{"type":"string","description":"Some human readable text describing what went wrong.","descriptionNode":"$L76e"},"timestamp":{"type":"integer","description":"The [UNIX timestamp](https://www.unixtimestamp.com/) of the date and time the error happened.","descriptionNode":"$L76f"}}}}},"descriptionNode":"$L770"},"422":{"description":"Unprocessable entity (business rule violation)","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"code":{"type":"string","description":"An identifier that can be used to determine what went wrong.\n\nError codes are not globally unique, but uniqueness is guaranteed within endpoints.","descriptionNode":"$L771"},"message":{"type":"string","description":"Some human readable text describing what went wrong.","descriptionNode":"$L772"},"timestamp":{"type":"integer","description":"The [UNIX timestamp](https://www.unixtimestamp.com/) of the date and time the error happened.","descriptionNode":"$L773"}}},"examples":{"subscription_finished":{"summary":"Subscription is finished","value":{"code":"subscription_finished","message":"Cannot add usage to a finished subscription","timestamp":1743465600}},"usage_after_last_cycle":{"summary":"Usage date after last cycle","value":{"code":"subscription_usage_after_last_cycle","message":"Usage date is after the last cycle","timestamp":1743465600}},"usage_before_start":{"summary":"Usage date before subscription start","value":{"code":"subscription_usage_before_subscription_start","message":"Usage date is before the subscription start date","timestamp":1743465600}},"future_cycle_limit_exceeded":{"summary":"Future cycle limit exceeded","value":{"code":"subscription_usage_future_cycle_limit_exceeded","message":"Cannot add usage for cycles too far in the future","timestamp":1743465600}},"usage_locked":{"summary":"Cycle is past the usage cutoff date","value":{"code":"subscription_usage_locked","message":"Cannot modify usage for a locked cycle","timestamp":1743465600}}}}},"descriptionNode":"$L774"},"default":{"description":"Error response","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"code":{"type":"string","description":"An identifier that can be used to determine what went wrong.\n\nError codes are not globally unique, but uniqueness is guaranteed within endpoints.","descriptionNode":"$L775"},"message":{"type":"string","description":"Some human readable text describing what went wrong.","descriptionNode":"$L776"},"timestamp":{"type":"integer","description":"The [UNIX timestamp](https://www.unixtimestamp.com/) of the date and time the error happened.","descriptionNode":"$L777"}}}}},"descriptionNode":"$L778"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["subscription_id","subscription_item_code","usage_date","quantity"],"properties":{"subscription_id":{"type":"string","format":"uuid","description":"Unique identifier for the subscription.","descriptionNode":"$L779"},"subscription_item_code":{"type":"string","description":"A merchant-defined identifier for a usage-based subscription item. You set this code on each usage item when creating a subscription plan, and supply it when reporting consumption on [Create a subscription usage endpoint](https://developer.revolut.com/docs/api/merchant#create-subscription-usage) to target the correct metered item.\n\nThis allows a subscription with multiple usage items (e.g., `api_calls` and `storage_gb`) to receive consumption reports against the right item without relying on internal IDs.\n\nThe code must be unique within a plan phase.","maxLength":250,"examples":"$3d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:subscription_item_code:examples","descriptionNode":"$L77a"},"usage_date":{"type":"string","format":"date-time","description":"The timestamp indicating when the consumption actually occurred.\n\n| Constraint | Detail |\n| ---------- | ------ |\n| Format | [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date-time string (e.g., `YYYY-MM-DDTHH:mm:ssZ`). |\n| Timezone | Must be UTC. |\n| Validation | Revolut uses this to identify the applicable billing cycle. Accepted for the active cycle (`start_date ≤ usage_date < end_date`), for a recently ended cycle before its `usage_cutoff_date`, and for the one next upcoming cycle. Other dates are rejected. |","examples":"$3d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:usage_date:examples","descriptionNode":"$L77b"},"quantity":{"type":"number","exclusiveMinimum":0,"description":"The quantity of consumption to record for this usage report. \n\nSupports up to 20 digits before and 20 digits after the decimal point.","examples":"$3d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:quantity:examples","descriptionNode":"$L77c"},"metadata":{"type":"object","description":"Key-value pairs you can attach to a usage record for your own tracking and reporting purposes.\n\n| Constraint | Detail |\n| ---------- | ------ |\n| Keys | Maximum 50 keys per record. |\n| Value types | String, number, or boolean only. |\n| Number precision | Up to 20 digits before and 20 digits after the decimal point. |","additionalProperties":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]},"maxProperties":50,"examples":"$3d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:metadata:examples","descriptionNode":"$L77d"}}},"examples":{"report_usage":{"summary":"Report active license seats","description":"Reporting active seats used during a period","value":{"subscription_id":"550e8400-e29b-41d4-a716-446655440000","subscription_item_code":"active_seats","usage_date":"2026-03-15T09:30:00Z","quantity":12,"metadata":{"department":"engineering","update_type":"onboarding"}}}}}}},"variantLabels":[],"children":["$L77e","$L77f"]}]}],false]}] 6d7:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Some human readable text describing what went wrong."}]]}] 6d8:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://www.unixtimestamp.com/","target":"_blank","rel":"noreferrer","children":"UNIX timestamp"}]," of the date and time the error happened."]}]]}] 6d9:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Bad Request"}]]}] 6da:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An identifier that can be used to determine what went wrong."}],"\n",["$","p","p-1",{"children":"Error codes are not globally unique, but uniqueness is guaranteed within endpoints."}]]}] 6db:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Some human readable text describing what went wrong."}]]}] 6dc:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://www.unixtimestamp.com/","target":"_blank","rel":"noreferrer","children":"UNIX timestamp"}]," of the date and time the error happened."]}]]}] 6dd:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unauthorized"}]]}] 6de:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An identifier that can be used to determine what went wrong."}],"\n",["$","p","p-1",{"children":"Error codes are not globally unique, but uniqueness is guaranteed within endpoints."}]]}] 6df:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Some human readable text describing what went wrong."}]]}] 6e0:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://www.unixtimestamp.com/","target":"_blank","rel":"noreferrer","children":"UNIX timestamp"}]," of the date and time the error happened."]}]]}] 6e1:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Usage not found"}]]}] 6e2:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An identifier that can be used to determine what went wrong."}],"\n",["$","p","p-1",{"children":"Error codes are not globally unique, but uniqueness is guaranteed within endpoints."}]]}] 6e3:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Some human readable text describing what went wrong."}]]}] 6e4:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://www.unixtimestamp.com/","target":"_blank","rel":"noreferrer","children":"UNIX timestamp"}]," of the date and time the error happened."]}]]}] 6e5:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unprocessable entity (business rule violation)"}]]}] 6e6:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An identifier that can be used to determine what went wrong."}],"\n",["$","p","p-1",{"children":"Error codes are not globally unique, but uniqueness is guaranteed within endpoints."}]]}] 6e7:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Some human readable text describing what went wrong."}]]}] 6e8:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://www.unixtimestamp.com/","target":"_blank","rel":"noreferrer","children":"UNIX timestamp"}]," of the date and time the error happened."]}]]}] 6e9:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Error response"}]]}] 6ea:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The quantity of consumption to record for this usage report."}],"\n",["$","p","p-1",{"children":"Supports up to 20 digits before and 20 digits after the decimal point."}]]}] 6eb:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Key-value pairs you can attach to a usage record for your own tracking and reporting purposes."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Constraint","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Detail","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":"Keys","className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Maximum 50 keys per record.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":"Value types","className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"String, number, or boolean only.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":"Number precision","className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Up to 20 digits before and 20 digits after the decimal point.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 6f0:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Update the quantity or metadata of a subscription usage record."}]]}] 6f1:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["This parameter accepts the ",["$","a","a-0",{"href":"https://business.revolut.com/settings/apis?tab=merchant-api","target":"_blank","rel":"noreferrer","children":"Merchant API Secret key"}]," to authorise requests coming from the merchant's backend."]}],"\n",["$","p","p-1",{"children":["It ensures that ensures that each request is authenticated and authorised by verifying the secret key. The secret key should be included in all request headers as a ",["$","code","code-0",{"children":"Bearer"}]," token."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#authentication","target":"_blank","rel":"noreferrer","children":"Authentication"}]]}]}]]}]]}] 6f2:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The version of the Merchant API, specified in ",["$","code","code-0",{"children":"YYYY-MM-DD"}]," format."]}],"\n",["$","p","p-1",{"children":"If not specified, you will receive an error."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information about API versioning, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/reference/versioning/api-versions","target":"_blank","rel":"noreferrer","children":"API versions"}],"."]}]}]]}]]}] 6f3:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A UUID string, typically used to identify resources."}]]}] 6f4:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The ID of the usage record."}]]}] 77e:["$","div",null,{"className":"ezz1n30","children":[["$","div",null,{"data-header":"$undefined","className":"ezz1n31","children":["$","div",null,{"className":"y9a0do1","children":[["$","h2",null,{"id":"create-subscription-usage","children":[["$L780","$undefined"],["$","$L15",null,{"id":"create-subscription-usage"}]]}],["$","$L16",null,{"url":"/docs/api/merchant/2025-10-16/operations/create-subscription-usage.md"}]]}]}],"$undefined"]}] 785:Ta3f,
curl -X POST "https://merchant.revolut.com/api/subscription-usages" \
  -H "Content-Type: application/json" \
  -H "Authorization: __RP_TOK_0__" \
  -H "Revolut-Api-Version: __RP_TOK_1__" \
  -H "Idempotency-Key: __RP_TOK_2__" \
  -d '{
  "subscription_id": "550e8400-e29b-41d4-a716-446655440000",
  "subscription_item_code": "active_seats",
  "usage_date": "2026-03-15T09:30:00Z",
  "quantity": 12,
  "metadata": {
    "department": "engineering",
    "update_type": "onboarding"
  }
}'
786:T1640,
const payload = {
  "subscription_id": "550e8400-e29b-41d4-a716-446655440000",
  "subscription_item_code": "active_seats",
  "usage_date": "2026-03-15T09:30:00Z",
  "quantity": 12,
  "metadata": {
    "department": "engineering",
    "update_type": "onboarding"
  }
};
fetch("https://merchant.revolut.com/api/subscription-usages", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "__RP_TOK_0__",
    "Revolut-Api-Version": "__RP_TOK_1__",
    "Idempotency-Key": "__RP_TOK_2__"
  },
  body: JSON.stringify(payload)
})
  .then(response => response.json())
  .then(data => console.log(data));
787:T1b11,
package main

import (
  "fmt"
  "net/http"
  "bytes"
  "encoding/json"
)

func main() {
  url := "https://merchant.revolut.com/api/subscription-usages"
  jsonData := []byte(`
{
  "subscription_id": "550e8400-e29b-41d4-a716-446655440000",
  "subscription_item_code": "active_seats",
  "usage_date": "2026-03-15T09:30:00Z",
  "quantity": 12,
  "metadata": {
    "department": "engineering",
    "update_type": "onboarding"
  }
}
  `)
  req, _ := http.NewRequest("POST", url, bytes.NewBuffer(jsonData))
  req.Header.Add("Content-Type", "application/json")
  req.Header.Add("Authorization", "__RP_TOK_0__")
  req.Header.Add("Revolut-Api-Version", "__RP_TOK_1__")
  req.Header.Add("Idempotency-Key", "__RP_TOK_2__")

  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  fmt.Println(res)
}
788:T1372,
import requests

url = "https://merchant.revolut.com/api/subscription-usages"
headers = {
  "Content-Type": "application/json",
  "Authorization": "__RP_TOK_0__",
  "Revolut-Api-Version": "__RP_TOK_1__",
  "Idempotency-Key": "__RP_TOK_2__"
}
payload = {
  "subscription_id": "550e8400-e29b-41d4-a716-446655440000",
  "subscription_item_code": "active_seats",
  "usage_date": "2026-03-15T09:30:00Z",
  "quantity": 12,
  "metadata": {
    "department": "engineering",
    "update_type": "onboarding"
  }
}

response = requests.post(url, headers=headers, json=payload)
print(response.json())
789:T440,import java.net.http.HttpClient; import java.net.http.HttpRequest; import java.net.http.HttpResponse; import java.net.URI; public class Main { public static void main(String[] args) { HttpClient client = HttpClient.newHttpClient(); String body = """ { "subscription_id": "550e8400-e29b-41d4-a716-446655440000", "subscription_item_code": "active_seats", "usage_date": "2026-03-15T09:30:00Z", "quantity": 12, "metadata": { "department": "engineering", "update_type": "onboarding" } } """; HttpRequest request = HttpRequest.newBuilder() .uri(URI.create("https://merchant.revolut.com/api/subscription-usages")) .header("Content-Type", "application/json") .header("Authorization", "__RP_TOK_0__") .header("Revolut-Api-Version", "__RP_TOK_1__") .header("Idempotency-Key", "__RP_TOK_2__") .POST(HttpRequest.BodyPublishers.ofString(body)) .build(); client.sendAsync(request, HttpResponse.BodyHandlers.ofString()) .thenApply(HttpResponse::body) .thenAccept(System.out::println) .join(); } }78a:T2072,
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;

public class Main {
  public static void main(String[] args) {
    HttpClient client = HttpClient.newHttpClient();
    String body = """
{
  "subscription_id": "550e8400-e29b-41d4-a716-446655440000",
  "subscription_item_code": "active_seats",
  "usage_date": "2026-03-15T09:30:00Z",
  "quantity": 12,
  "metadata": {
    "department": "engineering",
    "update_type": "onboarding"
  }
}
    """;

    HttpRequest request = HttpRequest.newBuilder()
      .uri(URI.create("https://merchant.revolut.com/api/subscription-usages"))
      .header("Content-Type", "application/json")
      .header("Authorization", "__RP_TOK_0__")
      .header("Revolut-Api-Version", "__RP_TOK_1__")
      .header("Idempotency-Key", "__RP_TOK_2__")
      .POST(HttpRequest.BodyPublishers.ofString(body))
      .build();

    client.sendAsync(request, HttpResponse.BodyHandlers.ofString())
      .thenApply(HttpResponse::body)
      .thenAccept(System.out::println)
      .join();
  }
}
78b:T2968,
using System.Net.Http;
using System.Net.Http.Headers;

var client = new HttpClient();
var request = new HttpRequestMessage
{
  Method = HttpMethod.Post,
  RequestUri = new Uri("https://merchant.revolut.com/api/subscription-usages"),
  Headers =
  {
    { "Authorization", "__RP_TOK_0__" },
    { "Revolut-Api-Version", "__RP_TOK_1__" },
    { "Idempotency-Key", "__RP_TOK_2__" },
  },
  Content = new StringContent(@"{
  ""subscription_id"": ""550e8400-e29b-41d4-a716-446655440000"",
  ""subscription_item_code"": ""active_seats"",
  ""usage_date"": ""2026-03-15T09:30:00Z"",
  ""quantity"": 12,
  ""metadata"": {
    ""department"": ""engineering"",
    ""update_type"": ""onboarding""
  }
}")
  {
    Headers =
    {
      ContentType = new MediaTypeHeaderValue("application/json")
    }
  }
};

using (var response = await client.SendAsync(request))
{
  response.EnsureSuccessStatusCode();
  var body = await response.Content.ReadAsStringAsync();
  Console.WriteLine(body);
}
78c:Ta47,
curl -X POST "https://sandbox-merchant.revolut.com/api/subscription-usages" \
  -H "Content-Type: application/json" \
  -H "Authorization: __RP_TOK_0__" \
  -H "Revolut-Api-Version: __RP_TOK_1__" \
  -H "Idempotency-Key: __RP_TOK_2__" \
  -d '{
  "subscription_id": "550e8400-e29b-41d4-a716-446655440000",
  "subscription_item_code": "active_seats",
  "usage_date": "2026-03-15T09:30:00Z",
  "quantity": 12,
  "metadata": {
    "department": "engineering",
    "update_type": "onboarding"
  }
}'
78d:T1648,
const payload = {
  "subscription_id": "550e8400-e29b-41d4-a716-446655440000",
  "subscription_item_code": "active_seats",
  "usage_date": "2026-03-15T09:30:00Z",
  "quantity": 12,
  "metadata": {
    "department": "engineering",
    "update_type": "onboarding"
  }
};
fetch("https://sandbox-merchant.revolut.com/api/subscription-usages", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "__RP_TOK_0__",
    "Revolut-Api-Version": "__RP_TOK_1__",
    "Idempotency-Key": "__RP_TOK_2__"
  },
  body: JSON.stringify(payload)
})
  .then(response => response.json())
  .then(data => console.log(data));
78e:T1b19,
package main

import (
  "fmt"
  "net/http"
  "bytes"
  "encoding/json"
)

func main() {
  url := "https://sandbox-merchant.revolut.com/api/subscription-usages"
  jsonData := []byte(`
{
  "subscription_id": "550e8400-e29b-41d4-a716-446655440000",
  "subscription_item_code": "active_seats",
  "usage_date": "2026-03-15T09:30:00Z",
  "quantity": 12,
  "metadata": {
    "department": "engineering",
    "update_type": "onboarding"
  }
}
  `)
  req, _ := http.NewRequest("POST", url, bytes.NewBuffer(jsonData))
  req.Header.Add("Content-Type", "application/json")
  req.Header.Add("Authorization", "__RP_TOK_0__")
  req.Header.Add("Revolut-Api-Version", "__RP_TOK_1__")
  req.Header.Add("Idempotency-Key", "__RP_TOK_2__")

  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  fmt.Println(res)
}
78f:T137a,
import requests

url = "https://sandbox-merchant.revolut.com/api/subscription-usages"
headers = {
  "Content-Type": "application/json",
  "Authorization": "__RP_TOK_0__",
  "Revolut-Api-Version": "__RP_TOK_1__",
  "Idempotency-Key": "__RP_TOK_2__"
}
payload = {
  "subscription_id": "550e8400-e29b-41d4-a716-446655440000",
  "subscription_item_code": "active_seats",
  "usage_date": "2026-03-15T09:30:00Z",
  "quantity": 12,
  "metadata": {
    "department": "engineering",
    "update_type": "onboarding"
  }
}

response = requests.post(url, headers=headers, json=payload)
print(response.json())
790:T448,import java.net.http.HttpClient; import java.net.http.HttpRequest; import java.net.http.HttpResponse; import java.net.URI; public class Main { public static void main(String[] args) { HttpClient client = HttpClient.newHttpClient(); String body = """ { "subscription_id": "550e8400-e29b-41d4-a716-446655440000", "subscription_item_code": "active_seats", "usage_date": "2026-03-15T09:30:00Z", "quantity": 12, "metadata": { "department": "engineering", "update_type": "onboarding" } } """; HttpRequest request = HttpRequest.newBuilder() .uri(URI.create("https://sandbox-merchant.revolut.com/api/subscription-usages")) .header("Content-Type", "application/json") .header("Authorization", "__RP_TOK_0__") .header("Revolut-Api-Version", "__RP_TOK_1__") .header("Idempotency-Key", "__RP_TOK_2__") .POST(HttpRequest.BodyPublishers.ofString(body)) .build(); client.sendAsync(request, HttpResponse.BodyHandlers.ofString()) .thenApply(HttpResponse::body) .thenAccept(System.out::println) .join(); } }791:T207a,
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;

public class Main {
  public static void main(String[] args) {
    HttpClient client = HttpClient.newHttpClient();
    String body = """
{
  "subscription_id": "550e8400-e29b-41d4-a716-446655440000",
  "subscription_item_code": "active_seats",
  "usage_date": "2026-03-15T09:30:00Z",
  "quantity": 12,
  "metadata": {
    "department": "engineering",
    "update_type": "onboarding"
  }
}
    """;

    HttpRequest request = HttpRequest.newBuilder()
      .uri(URI.create("https://sandbox-merchant.revolut.com/api/subscription-usages"))
      .header("Content-Type", "application/json")
      .header("Authorization", "__RP_TOK_0__")
      .header("Revolut-Api-Version", "__RP_TOK_1__")
      .header("Idempotency-Key", "__RP_TOK_2__")
      .POST(HttpRequest.BodyPublishers.ofString(body))
      .build();

    client.sendAsync(request, HttpResponse.BodyHandlers.ofString())
      .thenApply(HttpResponse::body)
      .thenAccept(System.out::println)
      .join();
  }
}
792:T2970,
using System.Net.Http;
using System.Net.Http.Headers;

var client = new HttpClient();
var request = new HttpRequestMessage
{
  Method = HttpMethod.Post,
  RequestUri = new Uri("https://sandbox-merchant.revolut.com/api/subscription-usages"),
  Headers =
  {
    { "Authorization", "__RP_TOK_0__" },
    { "Revolut-Api-Version", "__RP_TOK_1__" },
    { "Idempotency-Key", "__RP_TOK_2__" },
  },
  Content = new StringContent(@"{
  ""subscription_id"": ""550e8400-e29b-41d4-a716-446655440000"",
  ""subscription_item_code"": ""active_seats"",
  ""usage_date"": ""2026-03-15T09:30:00Z"",
  ""quantity"": 12,
  ""metadata"": {
    ""department"": ""engineering"",
    ""update_type"": ""onboarding""
  }
}")
  {
    Headers =
    {
      ContentType = new MediaTypeHeaderValue("application/json")
    }
  }
};

using (var response = await client.SendAsync(request))
{
  response.EnsureSuccessStatusCode();
  var body = await response.Content.ReadAsStringAsync();
  Console.WriteLine(body);
}
77f:["$","div",null,{"className":"ezz1n30","children":[["$","div",null,{"data-header":"$undefined","className":"ezz1n31","children":["$L781",["$","$L85",null,{"parameters":[{"name":"Authorization","in":"header","schema":{"type":"string","format":"Bearer ","examples":"$62:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:0:schema:examples"},"required":true,"description":"This parameter accepts the [Merchant API Secret key](https://business.revolut.com/settings/apis?tab=merchant-api) to authorise requests coming from the merchant's backend. \n\nIt ensures that ensures that each request is authenticated and authorised by verifying the secret key. The secret key should be included in all request headers as a `Bearer` token.\n\n:::info\nFor more information, see: [Authentication](https://developer.revolut.com/docs/api/merchant#authentication)\n:::","descriptionNode":"$L782"},{"name":"Revolut-Api-Version","in":"header","schema":{"type":"string","format":"date","enum":"$36:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:1:schema:enum","examples":"$36:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:1:schema:examples"},"required":true,"description":"The version of the Merchant API, specified in `YYYY-MM-DD` format.\n\nIf not specified, you will receive an error.\n\n\n:::info\nFor more information about API versioning, see: [API versions](https://developer.revolut.com/docs/guides/merchant/reference/versioning/api-versions).\n:::","x-config-always-visible-in-example":true,"example":"2025-10-16","descriptionNode":"$L783"},{"name":"Idempotency-Key","in":"header","schema":{"type":"string"},"required":true,"description":"The `Idempotency-Key` ensures that requests are processed only once, preventing multiple executions of the same operation due to retries or duplicate requests.\n\nThis header is required. It can accept any unique string value the merchant uses.\n\nA recommended practice is to use a unique identifier from your system (such as the entity's ID or a request UUID) as the idempotency key. This facilitates tracking and managing requests effectively.","descriptionNode":"$L784"}],"requestBody":"$3b:props:children:0:props:children:props:requestBody","heading":"Request","requestBodySchemaTitle":"Request body","headingAs":"h3"}],["$","$L89",null,{"responses":"$3b:props:children:0:props:children:props:responses","headingAs":"h3"}]]}],["$","div",null,{"className":"ezz1n32","children":[[["$","$L8a",null,{"itemsByServer":{"https://merchant.revolut.com":[{"id":"curl","label":"cURL","templateCode":"curl -X POST \"https://merchant.revolut.com/api/subscription-usages\" \\\n -H \"Content-Type: application/json\" \\\n -H \"Authorization: __RP_TOK_0__\" \\\n -H \"Revolut-Api-Version: __RP_TOK_1__\" \\\n -H \"Idempotency-Key: __RP_TOK_2__\" \\\n -d '{\n \"subscription_id\": \"550e8400-e29b-41d4-a716-446655440000\",\n \"subscription_item_code\": \"active_seats\",\n \"usage_date\": \"2026-03-15T09:30:00Z\",\n \"quantity\": 12,\n \"metadata\": {\n \"department\": \"engineering\",\n \"update_type\": \"onboarding\"\n }\n}'","templateHtml":"$785","tokens":[{"marker":"__RP_TOK_0__","paramName":"Authorization","paramIn":"header","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_1__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_2__","paramName":"Idempotency-Key","paramIn":"header","pipeline":["shell-double-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","header:Idempotency-Key":"string"}},{"id":"javascript","label":"JavaScript","templateCode":"const payload = {\n \"subscription_id\": \"550e8400-e29b-41d4-a716-446655440000\",\n \"subscription_item_code\": \"active_seats\",\n \"usage_date\": \"2026-03-15T09:30:00Z\",\n \"quantity\": 12,\n \"metadata\": {\n \"department\": \"engineering\",\n \"update_type\": \"onboarding\"\n }\n};\nfetch(\"https://merchant.revolut.com/api/subscription-usages\", {\n method: \"POST\",\n headers: {\n \"Content-Type\": \"application/json\",\n \"Authorization\": \"__RP_TOK_0__\",\n \"Revolut-Api-Version\": \"__RP_TOK_1__\",\n \"Idempotency-Key\": \"__RP_TOK_2__\"\n },\n body: JSON.stringify(payload)\n})\n .then(response => response.json())\n .then(data => console.log(data));","templateHtml":"$786","tokens":[{"marker":"__RP_TOK_0__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Idempotency-Key","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","header:Idempotency-Key":"string"}},{"id":"go","label":"Go","templateCode":"package main\n\nimport (\n \"fmt\"\n \"net/http\"\n \"bytes\"\n \"encoding/json\"\n)\n\nfunc main() {\n url := \"https://merchant.revolut.com/api/subscription-usages\"\n jsonData := []byte(`\n{\n \"subscription_id\": \"550e8400-e29b-41d4-a716-446655440000\",\n \"subscription_item_code\": \"active_seats\",\n \"usage_date\": \"2026-03-15T09:30:00Z\",\n \"quantity\": 12,\n \"metadata\": {\n \"department\": \"engineering\",\n \"update_type\": \"onboarding\"\n }\n}\n `)\n req, _ := http.NewRequest(\"POST\", url, bytes.NewBuffer(jsonData))\n req.Header.Add(\"Content-Type\", \"application/json\")\n req.Header.Add(\"Authorization\", \"__RP_TOK_0__\")\n req.Header.Add(\"Revolut-Api-Version\", \"__RP_TOK_1__\")\n req.Header.Add(\"Idempotency-Key\", \"__RP_TOK_2__\")\n\n res, _ := http.DefaultClient.Do(req)\n defer res.Body.Close()\n fmt.Println(res)\n}","templateHtml":"$787","tokens":[{"marker":"__RP_TOK_0__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Idempotency-Key","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","header:Idempotency-Key":"string"}},{"id":"python","label":"Python","templateCode":"import requests\n\nurl = \"https://merchant.revolut.com/api/subscription-usages\"\nheaders = {\n \"Content-Type\": \"application/json\",\n \"Authorization\": \"__RP_TOK_0__\",\n \"Revolut-Api-Version\": \"__RP_TOK_1__\",\n \"Idempotency-Key\": \"__RP_TOK_2__\"\n}\npayload = {\n \"subscription_id\": \"550e8400-e29b-41d4-a716-446655440000\",\n \"subscription_item_code\": \"active_seats\",\n \"usage_date\": \"2026-03-15T09:30:00Z\",\n \"quantity\": 12,\n \"metadata\": {\n \"department\": \"engineering\",\n \"update_type\": \"onboarding\"\n }\n}\n\nresponse = requests.post(url, headers=headers, json=payload)\nprint(response.json())","templateHtml":"$788","tokens":[{"marker":"__RP_TOK_0__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Idempotency-Key","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","header:Idempotency-Key":"string"}},{"id":"java","label":"Java","templateCode":"$789","templateHtml":"$78a","tokens":[{"marker":"__RP_TOK_0__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Idempotency-Key","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","header:Idempotency-Key":"string"}},{"id":"csharp","label":"C#","templateCode":"using System.Net.Http;\nusing System.Net.Http.Headers;\n\nvar client = new HttpClient();\nvar request = new HttpRequestMessage\n{\n Method = HttpMethod.Post,\n RequestUri = new Uri(\"https://merchant.revolut.com/api/subscription-usages\"),\n Headers =\n {\n { \"Authorization\", \"__RP_TOK_0__\" },\n { \"Revolut-Api-Version\", \"__RP_TOK_1__\" },\n { \"Idempotency-Key\", \"__RP_TOK_2__\" },\n },\n Content = new StringContent(@\"{\n \"\"subscription_id\"\": \"\"550e8400-e29b-41d4-a716-446655440000\"\",\n \"\"subscription_item_code\"\": \"\"active_seats\"\",\n \"\"usage_date\"\": \"\"2026-03-15T09:30:00Z\"\",\n \"\"quantity\"\": 12,\n \"\"metadata\"\": {\n \"\"department\"\": \"\"engineering\"\",\n \"\"update_type\"\": \"\"onboarding\"\"\n }\n}\")\n {\n Headers =\n {\n ContentType = new MediaTypeHeaderValue(\"application/json\")\n }\n }\n};\n\nusing (var response = await client.SendAsync(request))\n{\n response.EnsureSuccessStatusCode();\n var body = await response.Content.ReadAsStringAsync();\n Console.WriteLine(body);\n}","templateHtml":"$78b","tokens":[{"marker":"__RP_TOK_0__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Idempotency-Key","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","header:Idempotency-Key":"string"}}],"https://sandbox-merchant.revolut.com":[{"id":"curl","label":"cURL","templateCode":"curl -X POST \"https://sandbox-merchant.revolut.com/api/subscription-usages\" \\\n -H \"Content-Type: application/json\" \\\n -H \"Authorization: __RP_TOK_0__\" \\\n -H \"Revolut-Api-Version: __RP_TOK_1__\" \\\n -H \"Idempotency-Key: __RP_TOK_2__\" \\\n -d '{\n \"subscription_id\": \"550e8400-e29b-41d4-a716-446655440000\",\n \"subscription_item_code\": \"active_seats\",\n \"usage_date\": \"2026-03-15T09:30:00Z\",\n \"quantity\": 12,\n \"metadata\": {\n \"department\": \"engineering\",\n \"update_type\": \"onboarding\"\n }\n}'","templateHtml":"$78c","tokens":[{"marker":"__RP_TOK_0__","paramName":"Authorization","paramIn":"header","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_1__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_2__","paramName":"Idempotency-Key","paramIn":"header","pipeline":["shell-double-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","header:Idempotency-Key":"string"}},{"id":"javascript","label":"JavaScript","templateCode":"const payload = {\n \"subscription_id\": \"550e8400-e29b-41d4-a716-446655440000\",\n \"subscription_item_code\": \"active_seats\",\n \"usage_date\": \"2026-03-15T09:30:00Z\",\n \"quantity\": 12,\n \"metadata\": {\n \"department\": \"engineering\",\n \"update_type\": \"onboarding\"\n }\n};\nfetch(\"https://sandbox-merchant.revolut.com/api/subscription-usages\", {\n method: \"POST\",\n headers: {\n \"Content-Type\": \"application/json\",\n \"Authorization\": \"__RP_TOK_0__\",\n \"Revolut-Api-Version\": \"__RP_TOK_1__\",\n \"Idempotency-Key\": \"__RP_TOK_2__\"\n },\n body: JSON.stringify(payload)\n})\n .then(response => response.json())\n .then(data => console.log(data));","templateHtml":"$78d","tokens":[{"marker":"__RP_TOK_0__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Idempotency-Key","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","header:Idempotency-Key":"string"}},{"id":"go","label":"Go","templateCode":"package main\n\nimport (\n \"fmt\"\n \"net/http\"\n \"bytes\"\n \"encoding/json\"\n)\n\nfunc main() {\n url := \"https://sandbox-merchant.revolut.com/api/subscription-usages\"\n jsonData := []byte(`\n{\n \"subscription_id\": \"550e8400-e29b-41d4-a716-446655440000\",\n \"subscription_item_code\": \"active_seats\",\n \"usage_date\": \"2026-03-15T09:30:00Z\",\n \"quantity\": 12,\n \"metadata\": {\n \"department\": \"engineering\",\n \"update_type\": \"onboarding\"\n }\n}\n `)\n req, _ := http.NewRequest(\"POST\", url, bytes.NewBuffer(jsonData))\n req.Header.Add(\"Content-Type\", \"application/json\")\n req.Header.Add(\"Authorization\", \"__RP_TOK_0__\")\n req.Header.Add(\"Revolut-Api-Version\", \"__RP_TOK_1__\")\n req.Header.Add(\"Idempotency-Key\", \"__RP_TOK_2__\")\n\n res, _ := http.DefaultClient.Do(req)\n defer res.Body.Close()\n fmt.Println(res)\n}","templateHtml":"$78e","tokens":[{"marker":"__RP_TOK_0__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Idempotency-Key","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","header:Idempotency-Key":"string"}},{"id":"python","label":"Python","templateCode":"import requests\n\nurl = \"https://sandbox-merchant.revolut.com/api/subscription-usages\"\nheaders = {\n \"Content-Type\": \"application/json\",\n \"Authorization\": \"__RP_TOK_0__\",\n \"Revolut-Api-Version\": \"__RP_TOK_1__\",\n \"Idempotency-Key\": \"__RP_TOK_2__\"\n}\npayload = {\n \"subscription_id\": \"550e8400-e29b-41d4-a716-446655440000\",\n \"subscription_item_code\": \"active_seats\",\n \"usage_date\": \"2026-03-15T09:30:00Z\",\n \"quantity\": 12,\n \"metadata\": {\n \"department\": \"engineering\",\n \"update_type\": \"onboarding\"\n }\n}\n\nresponse = requests.post(url, headers=headers, json=payload)\nprint(response.json())","templateHtml":"$78f","tokens":[{"marker":"__RP_TOK_0__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Idempotency-Key","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","header:Idempotency-Key":"string"}},{"id":"java","label":"Java","templateCode":"$790","templateHtml":"$791","tokens":[{"marker":"__RP_TOK_0__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Idempotency-Key","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","header:Idempotency-Key":"string"}},{"id":"csharp","label":"C#","templateCode":"using System.Net.Http;\nusing System.Net.Http.Headers;\n\nvar client = new HttpClient();\nvar request = new HttpRequestMessage\n{\n Method = HttpMethod.Post,\n RequestUri = new Uri(\"https://sandbox-merchant.revolut.com/api/subscription-usages\"),\n Headers =\n {\n { \"Authorization\", \"__RP_TOK_0__\" },\n { \"Revolut-Api-Version\", \"__RP_TOK_1__\" },\n { \"Idempotency-Key\", \"__RP_TOK_2__\" },\n },\n Content = new StringContent(@\"{\n \"\"subscription_id\"\": \"\"550e8400-e29b-41d4-a716-446655440000\"\",\n \"\"subscription_item_code\"\": \"\"active_seats\"\",\n \"\"usage_date\"\": \"\"2026-03-15T09:30:00Z\"\",\n \"\"quantity\"\": 12,\n \"\"metadata\"\": {\n \"\"department\"\": \"\"engineering\"\",\n \"\"update_type\"\": \"\"onboarding\"\"\n }\n}\")\n {\n Headers =\n {\n ContentType = new MediaTypeHeaderValue(\"application/json\")\n }\n }\n};\n\nusing (var response = await client.SendAsync(request))\n{\n response.EnsureSuccessStatusCode();\n var body = await response.Content.ReadAsStringAsync();\n Console.WriteLine(body);\n}","templateHtml":"$792","tokens":[{"marker":"__RP_TOK_0__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Idempotency-Key","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","header:Idempotency-Key":"string"}}]},"method":"post","servers":"$62:props:children:0:props:children:props:children:1:props:children:1:props:children:0:0:props:servers","path":"/api/subscription-usages","parameters":["$77f:props:children:0:props:children:1:props:parameters:0","$77f:props:children:0:props:children:1:props:parameters:1","$77f:props:children:0:props:children:1:props:parameters:2"]}],"$L793"],"$L794","$L795"]}]]}] 6ba:["$","div","CodeBlock-0",{"className":"wzy01m0 _18b50nc0","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"
'Authorization: Bearer <yourSecretApiKey>'
"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"'Authorization: Bearer '\n"}]}]]}] 6bb:["$","div","CodeBlock-0",{"className":"wzy01m0 _18b50nc0","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"
'Authorization: Bearer <yourSecretApiKey>'
"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"'Authorization: Bearer '\n"}]}]]}] 704:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Each Merchant API request must contain an authorization header in the following format:"}],"\n","$L796","\n",["$","p","p-1",{"children":"To use this API, you need to generate API keys from your Revolut Business account. The Secret key is used in the authorization header for all server calls, while the Public key is provided with payment methods at checkout."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For detailed instructions on generating your API keys, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/get-started#generate-api-keys","target":"_blank","rel":"noreferrer","children":"Generate API keys"}],"."]}]}]]}]]}] 746:"Retrieve a subscription" 793:["$","$L10d",null,{"security":[{"Api-Key":[]}],"authorization":{"Api-Key":{"type":"apiKey","in":"header","name":"Authorization","description":"Each Merchant API request must contain an authorization header in the following format:\n\n```\n'Authorization: Bearer '\n```\n\nTo use this API, you need to generate API keys from your Revolut Business account. The Secret key is used in the authorization header for all server calls, while the Public key is provided with payment methods at checkout.\n\n:::info\nFor detailed instructions on generating your API keys, see: [Generate API keys](https://developer.revolut.com/docs/guides/merchant/get-started#generate-api-keys).\n:::","descriptionNode":"$L797"}}}] 794:["$","$L10f",null,{"exampleBlocks":{"application/json":{"variants":[{"key":"report_usage","label":"Report active license seats","rawValue":"$3b:props:children:0:props:children:props:requestBody:content:application/json:examples:report_usage:value","block":"$L798"}],"syncedPropertyName":"$undefined"}},"title":"Request body samples","headingAs":"h4"}] 795:["$","$L110",null,{"exampleBlocks":{"201":{"application/json":{"variants":[{"key":"usage_record","label":"Successful usage record creation","rawValue":"$3d:props:children:0:props:children:props:responses:200:content:application/json:examples:usage_record:value","block":"$L799"}],"syncedPropertyName":"$undefined"}},"400":{"application/json":{"variants":[{"key":"item_code_not_found","label":"Subscription item code not found","rawValue":"$3b:props:children:0:props:children:props:responses:400:content:application/json:examples:item_code_not_found:value","block":"$L79a"}],"syncedPropertyName":"$undefined"}},"401":{"application/json":{"variants":[{"key":"default","label":"Example","rawValue":{"code":"string","message":"string","timestamp":123},"block":"$L79b"}],"syncedPropertyName":"$undefined"}},"422":{"application/json":{"variants":[{"key":"subscription_finished","label":"Subscription is finished","rawValue":"$3b:props:children:0:props:children:props:responses:422:content:application/json:examples:subscription_finished:value","block":"$L79c"},{"key":"usage_after_last_cycle","label":"Usage date after last cycle","rawValue":"$3b:props:children:0:props:children:props:responses:422:content:application/json:examples:usage_after_last_cycle:value","block":"$L79d"},{"key":"usage_before_start","label":"Usage date before subscription start","rawValue":"$3b:props:children:0:props:children:props:responses:422:content:application/json:examples:usage_before_start:value","block":"$L79e"},{"key":"future_cycle_limit_exceeded","label":"Future cycle limit exceeded","rawValue":"$3b:props:children:0:props:children:props:responses:422:content:application/json:examples:future_cycle_limit_exceeded:value","block":"$L79f"},{"key":"usage_locked","label":"Cycle is past the usage cutoff date","rawValue":"$3b:props:children:0:props:children:props:responses:422:content:application/json:examples:usage_locked:value","block":"$L7a0"}],"syncedPropertyName":"$undefined"}},"default":{"application/json":{"variants":[{"key":"default","label":"Example","rawValue":{"code":"string","message":"string","timestamp":123},"block":"$L7a1"}],"syncedPropertyName":"$undefined"}}},"headingAs":"h4"}] 71b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unique identifier for the subscription."}]]}] 71c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Optional external reference for the subscription."}],"\n",["$","p","p-1",{"children":"Use this field to store your own system's identifier for easy tracking and correlation."}]]}] 71d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The state of the subscription."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"State","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"pending"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The subscription has been created but is not yet active. This typically occurs when awaiting the first payment or setup completion.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"active"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The subscription is currently active and billing cycles are processing normally.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"overdue"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The subscription has a failed payment and is awaiting resolution.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"paused"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The subscription has been temporarily paused and no billing will occur.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-4",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"cancelled"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The subscription has been cancelled and will not renew.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-5",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"finished"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The subscription has completed all billing cycles (for limited-duration subscriptions).","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 71e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unique identifier for the customer."}]]}] 71f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unique identifier for the subscription plan."}]]}] 720:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unique identifier for the subscription plan variation."}]]}] 721:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of payment method used for the subscription."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Type","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"automatic"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Payments are automatically charged to the customer's saved payment method.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"manual"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Payments require manual processing by the customer.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 722:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unique identifier for the payment method."}]]}] 723:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The date and time the subscription was created in ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_8601","target":"_blank","rel":"noreferrer","children":"ISO 8601"}]," format."]}]]}] 724:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The date and time the subscription was last updated in ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_8601","target":"_blank","rel":"noreferrer","children":"ISO 8601"}]," format."]}]]}] 725:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The date and time the subscription started in ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_8601","target":"_blank","rel":"noreferrer","children":"ISO 8601"}]," format."]}],"\n",["$","p","p-1",{"children":["This field is ",["$","code","code-0",{"children":"null"}]," until the subscription becomes active."]}]]}] 726:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unique identifier for the subscription cycle."}]]}] 727:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The trial period duration for this subscription in ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_8601#Durations","target":"_blank","rel":"noreferrer","children":"ISO 8601 duration format"}]," (e.g., \"P14D\" for 14 days)."]}],"\n",["$","h1","h1-0",{"children":"Override plan defaults"}],"\n",["$","p","p-1",{"children":"Subscription plans can define a default trial duration. When creating a subscription, you can use this field to override the plan's default trial period:"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Field value","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Behaviour","className":"eowryt6","ref":"$undefined"}],["$","th","th-2",{"children":"Example","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","strong","strong-0",{"children":"Not provided"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Uses the trial duration defined in the plan (if any)","className":"eowryt7","ref":"$undefined"}],["$","td","td-2",{"children":["Plan has ",["$","code","code-0",{"children":"\"P7D\""}]," → subscription gets 7-day trial"],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","strong","strong-0",{"children":"Different value"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Overrides the plan's default trial duration","className":"eowryt7","ref":"$undefined"}],["$","td","td-2",{"children":["Plan has ",["$","code","code-0",{"children":"\"P7D\""}]," → set to ",["$","code","code-1",{"children":"\"P30D\""}]," for promotional offer, or ",["$","code","code-2",{"children":"\"P3D\""}]," to reduce"],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","strong","strong-0",{"children":["$","code","code-0",{"children":"\"P0D\""}]}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Explicitly skips the trial period","className":"eowryt7","ref":"$undefined"}],["$","td","td-2",{"children":["Plan has ",["$","code","code-0",{"children":"\"P7D\""}]," → set to ",["$","code","code-1",{"children":"\"P0D\""}]," to skip trial entirely"],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["Only days (",["$","code","code-0",{"children":"D"}],") are allowed. Time components such as hours, minutes, or seconds are not permitted."]}]}]]}]]}] 728:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The date and time when the subscription's trial period ends in ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_8601","target":"_blank","rel":"noreferrer","children":"ISO 8601"}]," format."]}],"\n",["$","p","p-1",{"children":["This value is automatically calculated by the system as: ",["$","code","code-0",{"children":"start_date"}]," + ",["$","code","code-1",{"children":"trial_duration"}]]}],"\n",["$","p","p-2",{"children":["The ",["$","code","code-0",{"children":"trial_duration"}]," used in the calculation comes from either:"]}],"\n",["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["The subscription's custom ",["$","code","code-0",{"children":"trial_duration"}]," (if provided at creation time), or"]}],"\n",["$","li","li-1",{"children":["The plan's default ",["$","code","code-0",{"children":"trial_duration"}]," (if no override was specified)"]}],"\n"]}],"\n",["$","p","p-3",{"children":["This field is ",["$","code","code-0",{"children":"null"}]," when the subscription has no trial period (e.g., when ",["$","code","code-1",{"children":"trial_duration"}]," is not set or is ",["$","code","code-2",{"children":"\"P0D\""}],")."]}]]}] 729:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The ID of the order created for handling the setup payment for the subscription."}],"\n",["$","p","p-1",{"children":["Use the ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#retrieve-order","target":"_blank","rel":"noreferrer","children":"Retrieve an order"}]," endpoint with this ID to get order details, including the ",["$","code","code-0",{"children":"checkout_url"}]," for redirecting customers to the Hosted Payment Page or the ",["$","code","code-1",{"children":"token"}]," for widget integration."]}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":"The order is created in parallel to the subscription and is used to collect the initial payment and save the customer's payment method for future billing cycles."}]}]]}]]}] 72a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of the scheduled action."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Value","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"cancel"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"A cancellation scheduled to take effect at the end of the current billing cycle.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"change_plan_variation"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"A plan variation change scheduled to take effect at the end of the current billing cycle.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 72b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The reason for the scheduled action. This field is informational and does not affect how the action is processed."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Value","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"customer_request"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The action was requested by the customer.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"merchant_request"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The action was initiated by the merchant.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 72c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A cancellation scheduled to take effect at the end of the current billing cycle."}]]}] 72d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of the scheduled action."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Value","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"cancel"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"A cancellation scheduled to take effect at the end of the current billing cycle.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"change_plan_variation"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"A plan variation change scheduled to take effect at the end of the current billing cycle.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 72e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The reason for the scheduled action. This field is informational and does not affect how the action is processed."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Value","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"customer_request"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The action was requested by the customer.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"merchant_request"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The action was initiated by the merchant.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 72f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unique identifier for the subscription plan variation."}]]}] 730:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unique identifier for the subscription plan phase."}]]}] 731:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A plan variation change scheduled to take effect at the end of the current billing cycle."}]]}] 732:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A pending scheduled action on the subscription, applied at the end of the current billing cycle."}]]}] 733:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Subscription retrieved successfully"}]]}] 734:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An identifier that can be used to determine what went wrong."}],"\n",["$","p","p-1",{"children":"Error codes are not globally unique, but uniqueness is guaranteed within endpoints."}]]}] 735:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Some human readable text describing what went wrong."}]]}] 736:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://www.unixtimestamp.com/","target":"_blank","rel":"noreferrer","children":"UNIX timestamp"}]," of the date and time the error happened."]}]]}] 737:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Bad Request"}]]}] 738:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An identifier that can be used to determine what went wrong."}],"\n",["$","p","p-1",{"children":"Error codes are not globally unique, but uniqueness is guaranteed within endpoints."}]]}] 739:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Some human readable text describing what went wrong."}]]}] 73a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://www.unixtimestamp.com/","target":"_blank","rel":"noreferrer","children":"UNIX timestamp"}]," of the date and time the error happened."]}]]}] 73b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unauthorized"}]]}] 73c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An identifier that can be used to determine what went wrong."}],"\n",["$","p","p-1",{"children":"Error codes are not globally unique, but uniqueness is guaranteed within endpoints."}]]}] 73d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Some human readable text describing what went wrong."}]]}] 73e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://www.unixtimestamp.com/","target":"_blank","rel":"noreferrer","children":"UNIX timestamp"}]," of the date and time the error happened."]}]]}] 73f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Subscription not found"}]]}] 740:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An identifier that can be used to determine what went wrong."}],"\n",["$","p","p-1",{"children":"Error codes are not globally unique, but uniqueness is guaranteed within endpoints."}]]}] 741:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Some human readable text describing what went wrong."}]]}] 742:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://www.unixtimestamp.com/","target":"_blank","rel":"noreferrer","children":"UNIX timestamp"}]," of the date and time the error happened."]}]]}] 743:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Error response"}]]}] 747:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Retrieve a subscription by its unique identifier."}],"\n",["$","p","p-1",{"children":"Use this endpoint to get the current state and details of a specific subscription."}]]}] 748:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["This parameter accepts the ",["$","a","a-0",{"href":"https://business.revolut.com/settings/apis?tab=merchant-api","target":"_blank","rel":"noreferrer","children":"Merchant API Secret key"}]," to authorise requests coming from the merchant's backend."]}],"\n",["$","p","p-1",{"children":["It ensures that ensures that each request is authenticated and authorised by verifying the secret key. The secret key should be included in all request headers as a ",["$","code","code-0",{"children":"Bearer"}]," token."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#authentication","target":"_blank","rel":"noreferrer","children":"Authentication"}]]}]}]]}]]}] 749:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The version of the Merchant API, specified in ",["$","code","code-0",{"children":"YYYY-MM-DD"}]," format."]}],"\n",["$","p","p-1",{"children":"If not specified, you will receive an error."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information about API versioning, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/reference/versioning/api-versions","target":"_blank","rel":"noreferrer","children":"API versions"}],"."]}]}]]}]]}] 74a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A UUID string, typically used to identify resources."}]]}] 74b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The ID of the subscription."}]]}] 780:"Create a subscription usage" 33:["$","$7a","retrieve-subscription-list",{"children":[["$","section",null,{"className":"y9a0do0","data-variant":"endpoint","children":["$","$L7b",null,{"responses":{"200":{"description":"List of subscriptions retrieved successfully","content":{"application/json":{"schema":{"type":"object","required":["subscriptions"],"properties":{"next_page_token":{"type":"$24:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:next_page_token:type","description":"Token for retrieving the next page of results. Use this token as the value of the `page_token` query parameter in your next request to retrieve the next page.\n\nIf not present, there are no more results to retrieve.","descriptionNode":"$L7a2"},"subscriptions":{"type":"array","description":"List of subscriptions.","items":{"type":"object","required":"$34:props:children:0:props:children:props:responses:200:content:application/json:schema:required","properties":{"id":{"type":"string","format":"uuid","description":"Unique identifier for the subscription.","descriptionNode":"$L7a3"},"external_reference":{"type":"string","maxLength":1024,"description":"Optional external reference for the subscription.\n\nUse this field to store your own system's identifier for easy tracking and correlation.","descriptionNode":"$L7a4"},"state":{"type":"string","enum":"$34:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:state:enum","description":"The state of the subscription.\n\n| State | Description |\n| ----- | ----------- |\n| `pending` | The subscription has been created but is not yet active. This typically occurs when awaiting the first payment or setup completion. |\n| `active` | The subscription is currently active and billing cycles are processing normally. |\n| `overdue` | The subscription has a failed payment and is awaiting resolution. |\n| `paused` | The subscription has been temporarily paused and no billing will occur. |\n| `cancelled` | The subscription has been cancelled and will not renew. |\n| `finished` | The subscription has completed all billing cycles (for limited-duration subscriptions). |","descriptionNode":"$L7a5"},"customer_id":{"type":"string","format":"uuid","description":"Unique identifier for the customer.","descriptionNode":"$L7a6"},"plan_id":{"type":"string","format":"uuid","description":"Unique identifier for the subscription plan.","descriptionNode":"$L7a7"},"plan_variation_id":{"type":"string","format":"uuid","description":"Unique identifier for the subscription plan variation.","descriptionNode":"$L7a8"},"payment_method_type":{"type":"string","enum":"$34:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method_type:enum","description":"The type of payment method used for the subscription.\n\n| Type | Description |\n| ---- | ----------- |\n| `automatic` | Payments are automatically charged to the customer's saved payment method. |\n| `manual` | Payments require manual processing by the customer. |","descriptionNode":"$L7a9"},"payment_method_id":{"type":"string","format":"uuid","description":"Unique identifier for the payment method.","descriptionNode":"$L7aa"},"created_at":{"type":"string","format":"date-time","description":"The date and time the subscription was created in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format.","descriptionNode":"$L7ab"},"updated_at":{"type":"string","format":"date-time","description":"The date and time the subscription was last updated in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format.","descriptionNode":"$L7ac"},"start_date":{"type":"$34:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:start_date:type","format":"date-time","description":"The date and time the subscription started in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format.\n\nThis field is `null` until the subscription becomes active.","descriptionNode":"$L7ad"},"current_cycle_id":{"type":"string","format":"uuid","description":"Unique identifier for the subscription cycle.","descriptionNode":"$L7ae"},"trial_duration":{"type":"string","format":"duration","description":"The trial period duration for this subscription in [ISO 8601 duration format](https://en.wikipedia.org/wiki/ISO_8601#Durations) (e.g., \"P14D\" for 14 days).\n\n### Override plan defaults\n\nSubscription plans can define a default trial duration. When creating a subscription, you can use this field to override the plan's default trial period:\n\n| Field value | Behaviour | Example |\n| ----------- | -------- | ------- |\n| **Not provided** | Uses the trial duration defined in the plan (if any) | Plan has `\"P7D\"` → subscription gets 7-day trial |\n| **Different value** | Overrides the plan's default trial duration | Plan has `\"P7D\"` → set to `\"P30D\"` for promotional offer, or `\"P3D\"` to reduce |\n| **`\"P0D\"`** | Explicitly skips the trial period | Plan has `\"P7D\"` → set to `\"P0D\"` to skip trial entirely |\n\n:::note\nOnly days (`D`) are allowed. Time components such as hours, minutes, or seconds are not permitted.\n:::","pattern":"^P[0-9]+D$","examples":"$34:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:trial_duration:examples","descriptionNode":"$L7af"},"trial_end_date":{"type":"$34:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:trial_end_date:type","format":"date-time","description":"The date and time when the subscription's trial period ends in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format.\n\nThis value is automatically calculated by the system as: `start_date` + `trial_duration`\n\nThe `trial_duration` used in the calculation comes from either:\n- The subscription's custom `trial_duration` (if provided at creation time), or\n- The plan's default `trial_duration` (if no override was specified)\n\nThis field is `null` when the subscription has no trial period (e.g., when `trial_duration` is not set or is `\"P0D\"`).","examples":"$34:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:trial_end_date:examples","descriptionNode":"$L7b0"},"setup_order_id":{"type":"string","format":"uuid","description":"The ID of the order created for handling the setup payment for the subscription.\n\nUse the [Retrieve an order](https://developer.revolut.com/docs/api/merchant#retrieve-order) endpoint with this ID to get order details, including the `checkout_url` for redirecting customers to the Hosted Payment Page or the `token` for widget integration.\n\n:::note\nThe order is created in parallel to the subscription and is used to collect the initial payment and save the customer's payment method for future billing cycles.\n:::","descriptionNode":"$L7b1"},"scheduled_action":{"description":"A pending scheduled action on the subscription, applied at the end of the current billing cycle.","type":"object","discriminator":"$34:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:scheduled_action:discriminator","oneOf":[{"title":"Subscription-Scheduled-Action-Cancel","type":"object","description":"A cancellation scheduled to take effect at the end of the current billing cycle.","required":"$34:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:scheduled_action:oneOf:0:required","properties":{"type":{"type":"string","description":"The type of the scheduled action.\n\n| Value | Description |\n| ----- | ----------- |\n| `cancel` | A cancellation scheduled to take effect at the end of the current billing cycle. |\n| `change_plan_variation` | A plan variation change scheduled to take effect at the end of the current billing cycle. |","enum":"$34:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:scheduled_action:oneOf:0:properties:type:enum","examples":"$34:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:scheduled_action:oneOf:0:properties:type:examples","descriptionNode":"$L7b2"},"reason":{"type":"string","description":"The reason for the scheduled action. This field is informational and does not affect how the action is processed.\n\n| Value | Description |\n| ----- | ----------- |\n| `customer_request` | The action was requested by the customer. |\n| `merchant_request` | The action was initiated by the merchant. |","enum":"$37:props:children:0:props:children:props:requestBody:content:application/json:schema:properties:reason:enum","default":"merchant_request","examples":"$37:props:children:0:props:children:props:requestBody:content:application/json:schema:properties:reason:examples","descriptionNode":"$L7b3"}},"descriptionNode":"$L7b4"},{"title":"Subscription-Scheduled-Action-Change-Plan","type":"object","description":"A plan variation change scheduled to take effect at the end of the current billing cycle.","required":"$34:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:scheduled_action:oneOf:1:required","properties":{"type":{"type":"string","description":"The type of the scheduled action.\n\n| Value | Description |\n| ----- | ----------- |\n| `cancel` | A cancellation scheduled to take effect at the end of the current billing cycle. |\n| `change_plan_variation` | A plan variation change scheduled to take effect at the end of the current billing cycle. |","enum":"$34:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:scheduled_action:oneOf:0:properties:type:enum","examples":"$34:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:scheduled_action:oneOf:0:properties:type:examples","descriptionNode":"$L7b5"},"reason":{"type":"string","description":"The reason for the scheduled action. This field is informational and does not affect how the action is processed.\n\n| Value | Description |\n| ----- | ----------- |\n| `customer_request` | The action was requested by the customer. |\n| `merchant_request` | The action was initiated by the merchant. |","enum":"$37:props:children:0:props:children:props:requestBody:content:application/json:schema:properties:reason:enum","default":"merchant_request","examples":"$37:props:children:0:props:children:props:requestBody:content:application/json:schema:properties:reason:examples","descriptionNode":"$L7b6"},"plan_variation_id":{"type":"string","format":"uuid","description":"Unique identifier for the subscription plan variation.","descriptionNode":"$L7b7"},"plan_variation_phase_id":{"type":"string","format":"uuid","description":"Unique identifier for the subscription plan phase.","descriptionNode":"$L7b8"}},"descriptionNode":"$L7b9"}],"descriptionNode":"$L7ba"}}},"descriptionNode":"$L7bb"}}},"examples":{"subscriptions_list":{"summary":"List of subscriptions","value":{"next_page_token":"9e5d2caa-bb60-4b5b-b7cf-6345bbdff67e","subscriptions":[{"id":"550e8400-e29b-41d4-a716-446655440000","external_reference":"ext-ref-12345","state":"active","customer_id":"650e8400-e29b-41d4-a716-446655440001","plan_id":"750e8400-e29b-41d4-a716-446655440002","plan_variation_id":"850e8400-e29b-41d4-a716-446655440003","payment_method_type":"automatic","payment_method_id":"6689e244-8af7-4ada-9448-a91f02d4f192","created_at":"2025-06-05T21:00:00.036001Z","updated_at":"2025-06-05T21:00:00.036001Z","start_date":"2025-06-05T21:00:00.036001Z","current_cycle_id":"950e8400-e29b-41d4-a716-446655440004"},{"id":"550e8400-e29b-41d4-a716-446655440010","state":"pending","customer_id":"650e8400-e29b-41d4-a716-446655440011","plan_id":"750e8400-e29b-41d4-a716-446655440012","plan_variation_id":"850e8400-e29b-41d4-a716-446655440013","payment_method_type":"automatic","created_at":"2025-06-04T21:00:00.036001Z","updated_at":"2025-06-04T21:00:00.036001Z","current_cycle_id":"a31627fb-b037-4566-8d7b-f380c1f44653"}]}}}}},"descriptionNode":"$L7bc"},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"code":{"type":"string","description":"An identifier that can be used to determine what went wrong.\n\nError codes are not globally unique, but uniqueness is guaranteed within endpoints.","descriptionNode":"$L7bd"},"message":{"type":"string","description":"Some human readable text describing what went wrong.","descriptionNode":"$L7be"},"timestamp":{"type":"integer","description":"The [UNIX timestamp](https://www.unixtimestamp.com/) of the date and time the error happened.","descriptionNode":"$L7bf"}}}}},"descriptionNode":"$L7c0"},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"code":{"type":"string","description":"An identifier that can be used to determine what went wrong.\n\nError codes are not globally unique, but uniqueness is guaranteed within endpoints.","descriptionNode":"$L7c1"},"message":{"type":"string","description":"Some human readable text describing what went wrong.","descriptionNode":"$L7c2"},"timestamp":{"type":"integer","description":"The [UNIX timestamp](https://www.unixtimestamp.com/) of the date and time the error happened.","descriptionNode":"$L7c3"}}}}},"descriptionNode":"$L7c4"},"default":{"description":"Error response","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"code":{"type":"string","description":"An identifier that can be used to determine what went wrong.\n\nError codes are not globally unique, but uniqueness is guaranteed within endpoints.","descriptionNode":"$L7c5"},"message":{"type":"string","description":"Some human readable text describing what went wrong.","descriptionNode":"$L7c6"},"timestamp":{"type":"integer","description":"The [UNIX timestamp](https://www.unixtimestamp.com/) of the date and time the error happened.","descriptionNode":"$L7c7"}}}}},"descriptionNode":"$L7c8"}},"requestBody":"$undefined","variantLabels":[],"children":["$L7c9","$L7ca"]}]}],false]}] 7c9:["$","div",null,{"className":"ezz1n30","children":[["$","div",null,{"data-header":"$undefined","className":"ezz1n31","children":["$","div",null,{"className":"y9a0do1","children":[["$","h2",null,{"id":"retrieve-subscription-list","children":[["$L7cb","$undefined"],["$","$L15",null,{"id":"retrieve-subscription-list"}]]}],["$","$L16",null,{"url":"/docs/api/merchant/2025-10-16/operations/retrieve-subscription-list.md"}]]}]}],"$undefined"]}] 7d4:T43d,
curl -X GET "https://merchant.revolut.com/api/subscriptions?limit=__RP_TOK_0__&from=__RP_TOK_1__&to=__RP_TOK_2__&external_reference=__RP_TOK_3__&page_token=__RP_TOK_4__" \
  -H "Authorization: __RP_TOK_5__" \
  -H "Revolut-Api-Version: __RP_TOK_6__"
7d5:Ta4b,
fetch("https://merchant.revolut.com/api/subscriptions?limit=__RP_TOK_0__&from=__RP_TOK_1__&to=__RP_TOK_2__&external_reference=__RP_TOK_3__&page_token=__RP_TOK_4__", {
  method: "GET",
  headers: {
    "Authorization": "__RP_TOK_5__",
    "Revolut-Api-Version": "__RP_TOK_6__"
  }
})
  .then(response => response.json())
  .then(data => console.log(data));
7d6:Tfe8,
package main

import (
  "fmt"
  "net/http"
)

func main() {
  url := "https://merchant.revolut.com/api/subscriptions?limit=__RP_TOK_0__&from=__RP_TOK_1__&to=__RP_TOK_2__&external_reference=__RP_TOK_3__&page_token=__RP_TOK_4__"
  req, _ := http.NewRequest("GET", url, nil)
  req.Header.Add("Authorization", "__RP_TOK_5__")
  req.Header.Add("Revolut-Api-Version", "__RP_TOK_6__")

  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  fmt.Println(res)
}
7d7:T85d,
import requests

url = "https://merchant.revolut.com/api/subscriptions?limit=__RP_TOK_0__&from=__RP_TOK_1__&to=__RP_TOK_2__&external_reference=__RP_TOK_3__&page_token=__RP_TOK_4__"
headers = {
  "Authorization": "__RP_TOK_5__",
  "Revolut-Api-Version": "__RP_TOK_6__"
}

response = requests.get(url, headers=headers)
print(response.json())
7d8:T1789,
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;

public class Main {
  public static void main(String[] args) {
    HttpClient client = HttpClient.newHttpClient();
    HttpRequest request = HttpRequest.newBuilder()
      .uri(URI.create("https://merchant.revolut.com/api/subscriptions?limit=__RP_TOK_0__&from=__RP_TOK_1__&to=__RP_TOK_2__&external_reference=__RP_TOK_3__&page_token=__RP_TOK_4__"))
      .header("Authorization", "__RP_TOK_5__")
      .header("Revolut-Api-Version", "__RP_TOK_6__")
      .GET(HttpRequest.BodyPublishers.noBody())
      .build();

    client.sendAsync(request, HttpResponse.BodyHandlers.ofString())
      .thenApply(HttpResponse::body)
      .thenAccept(System.out::println)
      .join();
  }
}
7d9:T1633,
using System.Net.Http;
using System.Net.Http.Headers;

var client = new HttpClient();
var request = new HttpRequestMessage
{
  Method = HttpMethod.Get,
  RequestUri = new Uri("https://merchant.revolut.com/api/subscriptions?limit=__RP_TOK_0__&from=__RP_TOK_1__&to=__RP_TOK_2__&external_reference=__RP_TOK_3__&page_token=__RP_TOK_4__"),
  Headers =
  {
    { "Authorization", "__RP_TOK_5__" },
    { "Revolut-Api-Version", "__RP_TOK_6__" },
  }
};

using (var response = await client.SendAsync(request))
{
  response.EnsureSuccessStatusCode();
  var body = await response.Content.ReadAsStringAsync();
  Console.WriteLine(body);
}
7da:T445,
curl -X GET "https://sandbox-merchant.revolut.com/api/subscriptions?limit=__RP_TOK_0__&from=__RP_TOK_1__&to=__RP_TOK_2__&external_reference=__RP_TOK_3__&page_token=__RP_TOK_4__" \
  -H "Authorization: __RP_TOK_5__" \
  -H "Revolut-Api-Version: __RP_TOK_6__"
7db:Ta53,
fetch("https://sandbox-merchant.revolut.com/api/subscriptions?limit=__RP_TOK_0__&from=__RP_TOK_1__&to=__RP_TOK_2__&external_reference=__RP_TOK_3__&page_token=__RP_TOK_4__", {
  method: "GET",
  headers: {
    "Authorization": "__RP_TOK_5__",
    "Revolut-Api-Version": "__RP_TOK_6__"
  }
})
  .then(response => response.json())
  .then(data => console.log(data));
7dc:Tff0,
package main

import (
  "fmt"
  "net/http"
)

func main() {
  url := "https://sandbox-merchant.revolut.com/api/subscriptions?limit=__RP_TOK_0__&from=__RP_TOK_1__&to=__RP_TOK_2__&external_reference=__RP_TOK_3__&page_token=__RP_TOK_4__"
  req, _ := http.NewRequest("GET", url, nil)
  req.Header.Add("Authorization", "__RP_TOK_5__")
  req.Header.Add("Revolut-Api-Version", "__RP_TOK_6__")

  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  fmt.Println(res)
}
7dd:T865,
import requests

url = "https://sandbox-merchant.revolut.com/api/subscriptions?limit=__RP_TOK_0__&from=__RP_TOK_1__&to=__RP_TOK_2__&external_reference=__RP_TOK_3__&page_token=__RP_TOK_4__"
headers = {
  "Authorization": "__RP_TOK_5__",
  "Revolut-Api-Version": "__RP_TOK_6__"
}

response = requests.get(url, headers=headers)
print(response.json())
7de:T1791,
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;

public class Main {
  public static void main(String[] args) {
    HttpClient client = HttpClient.newHttpClient();
    HttpRequest request = HttpRequest.newBuilder()
      .uri(URI.create("https://sandbox-merchant.revolut.com/api/subscriptions?limit=__RP_TOK_0__&from=__RP_TOK_1__&to=__RP_TOK_2__&external_reference=__RP_TOK_3__&page_token=__RP_TOK_4__"))
      .header("Authorization", "__RP_TOK_5__")
      .header("Revolut-Api-Version", "__RP_TOK_6__")
      .GET(HttpRequest.BodyPublishers.noBody())
      .build();

    client.sendAsync(request, HttpResponse.BodyHandlers.ofString())
      .thenApply(HttpResponse::body)
      .thenAccept(System.out::println)
      .join();
  }
}
7df:T163b,
using System.Net.Http;
using System.Net.Http.Headers;

var client = new HttpClient();
var request = new HttpRequestMessage
{
  Method = HttpMethod.Get,
  RequestUri = new Uri("https://sandbox-merchant.revolut.com/api/subscriptions?limit=__RP_TOK_0__&from=__RP_TOK_1__&to=__RP_TOK_2__&external_reference=__RP_TOK_3__&page_token=__RP_TOK_4__"),
  Headers =
  {
    { "Authorization", "__RP_TOK_5__" },
    { "Revolut-Api-Version", "__RP_TOK_6__" },
  }
};

using (var response = await client.SendAsync(request))
{
  response.EnsureSuccessStatusCode();
  var body = await response.Content.ReadAsStringAsync();
  Console.WriteLine(body);
}
7ca:["$","div",null,{"className":"ezz1n30","children":[["$","div",null,{"data-header":"$undefined","className":"ezz1n31","children":["$L7cc",["$","$L85",null,{"parameters":[{"name":"Authorization","in":"header","schema":{"type":"string","format":"Bearer ","examples":"$62:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:0:schema:examples"},"required":true,"description":"This parameter accepts the [Merchant API Secret key](https://business.revolut.com/settings/apis?tab=merchant-api) to authorise requests coming from the merchant's backend. \n\nIt ensures that ensures that each request is authenticated and authorised by verifying the secret key. The secret key should be included in all request headers as a `Bearer` token.\n\n:::info\nFor more information, see: [Authentication](https://developer.revolut.com/docs/api/merchant#authentication)\n:::","descriptionNode":"$L7cd"},{"name":"Revolut-Api-Version","in":"header","schema":{"type":"string","format":"date","enum":"$36:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:1:schema:enum","examples":"$36:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:1:schema:examples"},"required":true,"description":"The version of the Merchant API, specified in `YYYY-MM-DD` format.\n\nIf not specified, you will receive an error.\n\n\n:::info\nFor more information about API versioning, see: [API versions](https://developer.revolut.com/docs/guides/merchant/reference/versioning/api-versions).\n:::","x-config-always-visible-in-example":true,"example":"2025-10-16","descriptionNode":"$L7ce"},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":500,"default":100},"description":"Maximum number of records to return. Used for **pagination**.","required":false,"descriptionNode":"$L7cf"},{"name":"from","in":"query","schema":{"type":"string","format":"date-time"},"description":"Filter records created from this date/time. Used for **filtering**.","required":false,"descriptionNode":"$L7d0"},{"name":"to","in":"query","schema":{"type":"string","format":"date-time"},"description":"Filter records created until this date/time. Used for **filtering**.","required":false,"descriptionNode":"$L7d1"},{"name":"external_reference","in":"query","schema":{"type":"string"},"description":"Return subscriptions with a specific `external_reference`. Used for **filtering**.","required":false,"descriptionNode":"$L7d2"},{"name":"page_token","in":"query","schema":{"type":"string"},"description":"Token for retrieving the next page of results. Used for **pagination**.\n\nTo paginate through results:\n\n 1. Make an initial request with the desired `limit`.\n 1. The response will include a `next_page_token` if more results are available.\n 1. Use that token in the `page_token` parameter of your next request.\n 1. Repeat until `next_page_token` is not present.\n\n:::note\nWhen using `page_token`, you must include all query parameters from the initial request (such as `from`, `to`, or other filter parameters) to maintain consistent filtering across pages.\n:::","required":false,"descriptionNode":"$L7d3"}],"requestBody":"$undefined","heading":"Request","requestBodySchemaTitle":"Request body","headingAs":"h3"}],["$","$L89",null,{"responses":"$33:props:children:0:props:children:props:responses","headingAs":"h3"}]]}],["$","div",null,{"className":"ezz1n32","children":[[["$","$L8a",null,{"itemsByServer":{"https://merchant.revolut.com":[{"id":"curl","label":"cURL","templateCode":"curl -X GET \"https://merchant.revolut.com/api/subscriptions?limit=__RP_TOK_0__&from=__RP_TOK_1__&to=__RP_TOK_2__&external_reference=__RP_TOK_3__&page_token=__RP_TOK_4__\" \\\n -H \"Authorization: __RP_TOK_5__\" \\\n -H \"Revolut-Api-Version: __RP_TOK_6__\"","templateHtml":"$7d4","tokens":[{"marker":"__RP_TOK_0__","paramName":"limit","paramIn":"query","pipeline":["url-component","shell-double-inner"]},{"marker":"__RP_TOK_1__","paramName":"from","paramIn":"query","pipeline":["url-component","shell-double-inner"]},{"marker":"__RP_TOK_2__","paramName":"to","paramIn":"query","pipeline":["url-component","shell-double-inner"]},{"marker":"__RP_TOK_3__","paramName":"external_reference","paramIn":"query","pipeline":["url-component","shell-double-inner"]},{"marker":"__RP_TOK_4__","paramName":"page_token","paramIn":"query","pipeline":["url-component","shell-double-inner"]},{"marker":"__RP_TOK_5__","paramName":"Authorization","paramIn":"header","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_6__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["shell-double-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","query:limit":"100","query:from":"2024-01-01T00:00:00Z","query:to":"2024-01-01T00:00:00Z","query:external_reference":"string","query:page_token":"string"}},{"id":"javascript","label":"JavaScript","templateCode":"fetch(\"https://merchant.revolut.com/api/subscriptions?limit=__RP_TOK_0__&from=__RP_TOK_1__&to=__RP_TOK_2__&external_reference=__RP_TOK_3__&page_token=__RP_TOK_4__\", {\n method: \"GET\",\n headers: {\n \"Authorization\": \"__RP_TOK_5__\",\n \"Revolut-Api-Version\": \"__RP_TOK_6__\"\n }\n})\n .then(response => response.json())\n .then(data => console.log(data));","templateHtml":"$7d5","tokens":[{"marker":"__RP_TOK_0__","paramName":"limit","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"from","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"to","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_3__","paramName":"external_reference","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_4__","paramName":"page_token","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_5__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_6__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","query:limit":"100","query:from":"2024-01-01T00:00:00Z","query:to":"2024-01-01T00:00:00Z","query:external_reference":"string","query:page_token":"string"}},{"id":"go","label":"Go","templateCode":"package main\n\nimport (\n \"fmt\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://merchant.revolut.com/api/subscriptions?limit=__RP_TOK_0__&from=__RP_TOK_1__&to=__RP_TOK_2__&external_reference=__RP_TOK_3__&page_token=__RP_TOK_4__\"\n req, _ := http.NewRequest(\"GET\", url, nil)\n req.Header.Add(\"Authorization\", \"__RP_TOK_5__\")\n req.Header.Add(\"Revolut-Api-Version\", \"__RP_TOK_6__\")\n\n res, _ := http.DefaultClient.Do(req)\n defer res.Body.Close()\n fmt.Println(res)\n}","templateHtml":"$7d6","tokens":[{"marker":"__RP_TOK_0__","paramName":"limit","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"from","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"to","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_3__","paramName":"external_reference","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_4__","paramName":"page_token","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_5__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_6__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","query:limit":"100","query:from":"2024-01-01T00:00:00Z","query:to":"2024-01-01T00:00:00Z","query:external_reference":"string","query:page_token":"string"}},{"id":"python","label":"Python","templateCode":"import requests\n\nurl = \"https://merchant.revolut.com/api/subscriptions?limit=__RP_TOK_0__&from=__RP_TOK_1__&to=__RP_TOK_2__&external_reference=__RP_TOK_3__&page_token=__RP_TOK_4__\"\nheaders = {\n \"Authorization\": \"__RP_TOK_5__\",\n \"Revolut-Api-Version\": \"__RP_TOK_6__\"\n}\n\nresponse = requests.get(url, headers=headers)\nprint(response.json())","templateHtml":"$7d7","tokens":[{"marker":"__RP_TOK_0__","paramName":"limit","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"from","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"to","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_3__","paramName":"external_reference","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_4__","paramName":"page_token","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_5__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_6__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","query:limit":"100","query:from":"2024-01-01T00:00:00Z","query:to":"2024-01-01T00:00:00Z","query:external_reference":"string","query:page_token":"string"}},{"id":"java","label":"Java","templateCode":"import java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\nimport java.net.URI;\n\npublic class Main {\n public static void main(String[] args) {\n HttpClient client = HttpClient.newHttpClient();\n HttpRequest request = HttpRequest.newBuilder()\n .uri(URI.create(\"https://merchant.revolut.com/api/subscriptions?limit=__RP_TOK_0__&from=__RP_TOK_1__&to=__RP_TOK_2__&external_reference=__RP_TOK_3__&page_token=__RP_TOK_4__\"))\n .header(\"Authorization\", \"__RP_TOK_5__\")\n .header(\"Revolut-Api-Version\", \"__RP_TOK_6__\")\n .GET(HttpRequest.BodyPublishers.noBody())\n .build();\n\n client.sendAsync(request, HttpResponse.BodyHandlers.ofString())\n .thenApply(HttpResponse::body)\n .thenAccept(System.out::println)\n .join();\n }\n}","templateHtml":"$7d8","tokens":[{"marker":"__RP_TOK_0__","paramName":"limit","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"from","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"to","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_3__","paramName":"external_reference","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_4__","paramName":"page_token","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_5__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_6__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","query:limit":"100","query:from":"2024-01-01T00:00:00Z","query:to":"2024-01-01T00:00:00Z","query:external_reference":"string","query:page_token":"string"}},{"id":"csharp","label":"C#","templateCode":"using System.Net.Http;\nusing System.Net.Http.Headers;\n\nvar client = new HttpClient();\nvar request = new HttpRequestMessage\n{\n Method = HttpMethod.Get,\n RequestUri = new Uri(\"https://merchant.revolut.com/api/subscriptions?limit=__RP_TOK_0__&from=__RP_TOK_1__&to=__RP_TOK_2__&external_reference=__RP_TOK_3__&page_token=__RP_TOK_4__\"),\n Headers =\n {\n { \"Authorization\", \"__RP_TOK_5__\" },\n { \"Revolut-Api-Version\", \"__RP_TOK_6__\" },\n }\n};\n\nusing (var response = await client.SendAsync(request))\n{\n response.EnsureSuccessStatusCode();\n var body = await response.Content.ReadAsStringAsync();\n Console.WriteLine(body);\n}","templateHtml":"$7d9","tokens":[{"marker":"__RP_TOK_0__","paramName":"limit","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"from","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"to","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_3__","paramName":"external_reference","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_4__","paramName":"page_token","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_5__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_6__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","query:limit":"100","query:from":"2024-01-01T00:00:00Z","query:to":"2024-01-01T00:00:00Z","query:external_reference":"string","query:page_token":"string"}}],"https://sandbox-merchant.revolut.com":[{"id":"curl","label":"cURL","templateCode":"curl -X GET \"https://sandbox-merchant.revolut.com/api/subscriptions?limit=__RP_TOK_0__&from=__RP_TOK_1__&to=__RP_TOK_2__&external_reference=__RP_TOK_3__&page_token=__RP_TOK_4__\" \\\n -H \"Authorization: __RP_TOK_5__\" \\\n -H \"Revolut-Api-Version: __RP_TOK_6__\"","templateHtml":"$7da","tokens":[{"marker":"__RP_TOK_0__","paramName":"limit","paramIn":"query","pipeline":["url-component","shell-double-inner"]},{"marker":"__RP_TOK_1__","paramName":"from","paramIn":"query","pipeline":["url-component","shell-double-inner"]},{"marker":"__RP_TOK_2__","paramName":"to","paramIn":"query","pipeline":["url-component","shell-double-inner"]},{"marker":"__RP_TOK_3__","paramName":"external_reference","paramIn":"query","pipeline":["url-component","shell-double-inner"]},{"marker":"__RP_TOK_4__","paramName":"page_token","paramIn":"query","pipeline":["url-component","shell-double-inner"]},{"marker":"__RP_TOK_5__","paramName":"Authorization","paramIn":"header","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_6__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["shell-double-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","query:limit":"100","query:from":"2024-01-01T00:00:00Z","query:to":"2024-01-01T00:00:00Z","query:external_reference":"string","query:page_token":"string"}},{"id":"javascript","label":"JavaScript","templateCode":"fetch(\"https://sandbox-merchant.revolut.com/api/subscriptions?limit=__RP_TOK_0__&from=__RP_TOK_1__&to=__RP_TOK_2__&external_reference=__RP_TOK_3__&page_token=__RP_TOK_4__\", {\n method: \"GET\",\n headers: {\n \"Authorization\": \"__RP_TOK_5__\",\n \"Revolut-Api-Version\": \"__RP_TOK_6__\"\n }\n})\n .then(response => response.json())\n .then(data => console.log(data));","templateHtml":"$7db","tokens":[{"marker":"__RP_TOK_0__","paramName":"limit","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"from","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"to","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_3__","paramName":"external_reference","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_4__","paramName":"page_token","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_5__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_6__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","query:limit":"100","query:from":"2024-01-01T00:00:00Z","query:to":"2024-01-01T00:00:00Z","query:external_reference":"string","query:page_token":"string"}},{"id":"go","label":"Go","templateCode":"package main\n\nimport (\n \"fmt\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://sandbox-merchant.revolut.com/api/subscriptions?limit=__RP_TOK_0__&from=__RP_TOK_1__&to=__RP_TOK_2__&external_reference=__RP_TOK_3__&page_token=__RP_TOK_4__\"\n req, _ := http.NewRequest(\"GET\", url, nil)\n req.Header.Add(\"Authorization\", \"__RP_TOK_5__\")\n req.Header.Add(\"Revolut-Api-Version\", \"__RP_TOK_6__\")\n\n res, _ := http.DefaultClient.Do(req)\n defer res.Body.Close()\n fmt.Println(res)\n}","templateHtml":"$7dc","tokens":[{"marker":"__RP_TOK_0__","paramName":"limit","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"from","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"to","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_3__","paramName":"external_reference","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_4__","paramName":"page_token","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_5__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_6__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","query:limit":"100","query:from":"2024-01-01T00:00:00Z","query:to":"2024-01-01T00:00:00Z","query:external_reference":"string","query:page_token":"string"}},{"id":"python","label":"Python","templateCode":"import requests\n\nurl = \"https://sandbox-merchant.revolut.com/api/subscriptions?limit=__RP_TOK_0__&from=__RP_TOK_1__&to=__RP_TOK_2__&external_reference=__RP_TOK_3__&page_token=__RP_TOK_4__\"\nheaders = {\n \"Authorization\": \"__RP_TOK_5__\",\n \"Revolut-Api-Version\": \"__RP_TOK_6__\"\n}\n\nresponse = requests.get(url, headers=headers)\nprint(response.json())","templateHtml":"$7dd","tokens":[{"marker":"__RP_TOK_0__","paramName":"limit","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"from","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"to","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_3__","paramName":"external_reference","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_4__","paramName":"page_token","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_5__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_6__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","query:limit":"100","query:from":"2024-01-01T00:00:00Z","query:to":"2024-01-01T00:00:00Z","query:external_reference":"string","query:page_token":"string"}},{"id":"java","label":"Java","templateCode":"import java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\nimport java.net.URI;\n\npublic class Main {\n public static void main(String[] args) {\n HttpClient client = HttpClient.newHttpClient();\n HttpRequest request = HttpRequest.newBuilder()\n .uri(URI.create(\"https://sandbox-merchant.revolut.com/api/subscriptions?limit=__RP_TOK_0__&from=__RP_TOK_1__&to=__RP_TOK_2__&external_reference=__RP_TOK_3__&page_token=__RP_TOK_4__\"))\n .header(\"Authorization\", \"__RP_TOK_5__\")\n .header(\"Revolut-Api-Version\", \"__RP_TOK_6__\")\n .GET(HttpRequest.BodyPublishers.noBody())\n .build();\n\n client.sendAsync(request, HttpResponse.BodyHandlers.ofString())\n .thenApply(HttpResponse::body)\n .thenAccept(System.out::println)\n .join();\n }\n}","templateHtml":"$7de","tokens":[{"marker":"__RP_TOK_0__","paramName":"limit","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"from","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"to","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_3__","paramName":"external_reference","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_4__","paramName":"page_token","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_5__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_6__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","query:limit":"100","query:from":"2024-01-01T00:00:00Z","query:to":"2024-01-01T00:00:00Z","query:external_reference":"string","query:page_token":"string"}},{"id":"csharp","label":"C#","templateCode":"using System.Net.Http;\nusing System.Net.Http.Headers;\n\nvar client = new HttpClient();\nvar request = new HttpRequestMessage\n{\n Method = HttpMethod.Get,\n RequestUri = new Uri(\"https://sandbox-merchant.revolut.com/api/subscriptions?limit=__RP_TOK_0__&from=__RP_TOK_1__&to=__RP_TOK_2__&external_reference=__RP_TOK_3__&page_token=__RP_TOK_4__\"),\n Headers =\n {\n { \"Authorization\", \"__RP_TOK_5__\" },\n { \"Revolut-Api-Version\", \"__RP_TOK_6__\" },\n }\n};\n\nusing (var response = await client.SendAsync(request))\n{\n response.EnsureSuccessStatusCode();\n var body = await response.Content.ReadAsStringAsync();\n Console.WriteLine(body);\n}","templateHtml":"$7df","tokens":[{"marker":"__RP_TOK_0__","paramName":"limit","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"from","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"to","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_3__","paramName":"external_reference","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_4__","paramName":"page_token","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_5__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_6__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","query:limit":"100","query:from":"2024-01-01T00:00:00Z","query:to":"2024-01-01T00:00:00Z","query:external_reference":"string","query:page_token":"string"}}]},"method":"get","servers":"$62:props:children:0:props:children:props:children:1:props:children:1:props:children:0:0:props:servers","path":"/api/subscriptions","parameters":["$7ca:props:children:0:props:children:1:props:parameters:0","$7ca:props:children:0:props:children:1:props:parameters:1","$7ca:props:children:0:props:children:1:props:parameters:2","$7ca:props:children:0:props:children:1:props:parameters:3","$7ca:props:children:0:props:children:1:props:parameters:4","$7ca:props:children:0:props:children:1:props:parameters:5","$7ca:props:children:0:props:children:1:props:parameters:6"]}],"$L7e0"],"$L7e1","$L7e2"]}]]}] 759:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Each Merchant API request must contain an authorization header in the following format:"}],"\n","$L7e3","\n",["$","p","p-1",{"children":"To use this API, you need to generate API keys from your Revolut Business account. The Secret key is used in the authorization header for all server calls, while the Public key is provided with payment methods at checkout."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For detailed instructions on generating your API keys, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/get-started#generate-api-keys","target":"_blank","rel":"noreferrer","children":"Generate API keys"}],"."]}]}]]}]]}] 75f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The unique identifier of the usage record."}]]}] 760:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unique identifier for the subscription."}]]}] 761:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unique identifier for the subscription cycle."}]]}] 762:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["A merchant-defined identifier for a usage-based subscription item. You set this code on each usage item when creating a subscription plan, and supply it when reporting consumption on ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#create-subscription-usage","target":"_blank","rel":"noreferrer","children":"Create a subscription usage endpoint"}]," to target the correct metered item."]}],"\n",["$","p","p-1",{"children":["This allows a subscription with multiple usage items (e.g., ",["$","code","code-0",{"children":"api_calls"}]," and ",["$","code","code-1",{"children":"storage_gb"}],") to receive consumption reports against the right item without relying on internal IDs."]}],"\n",["$","p","p-2",{"children":"The code must be unique within a plan phase."}]]}] 763:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The timestamp indicating when the consumption actually occurred."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Constraint","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Detail","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":"Format","className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":[["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_8601","target":"_blank","rel":"noreferrer","children":"ISO 8601"}]," date-time string (e.g., ",["$","code","code-0",{"children":"YYYY-MM-DDTHH:mm:ssZ"}],")."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":"Timezone","className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Must be UTC.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":"Validation","className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["Revolut uses this to identify the applicable billing cycle. Accepted for the active cycle (",["$","code","code-0",{"children":"start_date ≤ usage_date < end_date"}],"), for a recently ended cycle before its ",["$","code","code-1",{"children":"usage_cutoff_date"}],", and for the one next upcoming cycle. Other dates are rejected."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 764:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The quantity of consumption to record for this usage report."}],"\n",["$","p","p-1",{"children":"Supports up to 20 digits before and 20 digits after the decimal point."}]]}] 765:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Key-value pairs you can attach to a usage record for your own tracking and reporting purposes."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Constraint","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Detail","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":"Keys","className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Maximum 50 keys per record.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":"Value types","className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"String, number, or boolean only.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":"Number precision","className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Up to 20 digits before and 20 digits after the decimal point.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 766:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The date and time the usage record was created in ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_8601","target":"_blank","rel":"noreferrer","children":"ISO 8601"}]," format."]}]]}] 767:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The date and time the usage record was last updated in ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_8601","target":"_blank","rel":"noreferrer","children":"ISO 8601"}]," format."]}]]}] 768:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Usage reported successfully"}]]}] 769:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An identifier that can be used to determine what went wrong."}],"\n",["$","p","p-1",{"children":"Error codes are not globally unique, but uniqueness is guaranteed within endpoints."}]]}] 7e0:["$","$L10d",null,{"security":[{"Api-Key":[]}],"authorization":{"Api-Key":{"type":"apiKey","in":"header","name":"Authorization","description":"Each Merchant API request must contain an authorization header in the following format:\n\n```\n'Authorization: Bearer '\n```\n\nTo use this API, you need to generate API keys from your Revolut Business account. The Secret key is used in the authorization header for all server calls, while the Public key is provided with payment methods at checkout.\n\n:::info\nFor detailed instructions on generating your API keys, see: [Generate API keys](https://developer.revolut.com/docs/guides/merchant/get-started#generate-api-keys).\n:::","descriptionNode":"$L7e4"}}}] 7e1:["$","$L10f",null,{"exampleBlocks":{},"title":"Request body samples","headingAs":"h4"}] 7e2:["$","$L110",null,{"exampleBlocks":{"200":{"application/json":{"variants":[{"key":"subscriptions_list","label":"List of subscriptions","rawValue":"$33:props:children:0:props:children:props:responses:200:content:application/json:examples:subscriptions_list:value","block":"$L7e5"}],"syncedPropertyName":"$undefined"}},"400":{"application/json":{"variants":[{"key":"default","label":"Example","rawValue":{"code":"string","message":"string","timestamp":123},"block":"$L7e6"}],"syncedPropertyName":"$undefined"}},"401":{"application/json":{"variants":[{"key":"default","label":"Example","rawValue":{"code":"string","message":"string","timestamp":123},"block":"$L7e7"}],"syncedPropertyName":"$undefined"}},"default":{"application/json":{"variants":[{"key":"default","label":"Example","rawValue":{"code":"string","message":"string","timestamp":123},"block":"$L7e8"}],"syncedPropertyName":"$undefined"}}},"headingAs":"h4"}] 76a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Some human readable text describing what went wrong."}]]}] 76b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://www.unixtimestamp.com/","target":"_blank","rel":"noreferrer","children":"UNIX timestamp"}]," of the date and time the error happened."]}]]}] 76c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Bad Request"}]]}] 76d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An identifier that can be used to determine what went wrong."}],"\n",["$","p","p-1",{"children":"Error codes are not globally unique, but uniqueness is guaranteed within endpoints."}]]}] 76e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Some human readable text describing what went wrong."}]]}] 76f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://www.unixtimestamp.com/","target":"_blank","rel":"noreferrer","children":"UNIX timestamp"}]," of the date and time the error happened."]}]]}] 770:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unauthorized"}]]}] 771:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An identifier that can be used to determine what went wrong."}],"\n",["$","p","p-1",{"children":"Error codes are not globally unique, but uniqueness is guaranteed within endpoints."}]]}] 772:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Some human readable text describing what went wrong."}]]}] 773:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://www.unixtimestamp.com/","target":"_blank","rel":"noreferrer","children":"UNIX timestamp"}]," of the date and time the error happened."]}]]}] 774:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unprocessable entity (business rule violation)"}]]}] 775:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An identifier that can be used to determine what went wrong."}],"\n",["$","p","p-1",{"children":"Error codes are not globally unique, but uniqueness is guaranteed within endpoints."}]]}] 776:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Some human readable text describing what went wrong."}]]}] 777:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://www.unixtimestamp.com/","target":"_blank","rel":"noreferrer","children":"UNIX timestamp"}]," of the date and time the error happened."]}]]}] 778:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Error response"}]]}] 779:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unique identifier for the subscription."}]]}] 77a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["A merchant-defined identifier for a usage-based subscription item. You set this code on each usage item when creating a subscription plan, and supply it when reporting consumption on ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#create-subscription-usage","target":"_blank","rel":"noreferrer","children":"Create a subscription usage endpoint"}]," to target the correct metered item."]}],"\n",["$","p","p-1",{"children":["This allows a subscription with multiple usage items (e.g., ",["$","code","code-0",{"children":"api_calls"}]," and ",["$","code","code-1",{"children":"storage_gb"}],") to receive consumption reports against the right item without relying on internal IDs."]}],"\n",["$","p","p-2",{"children":"The code must be unique within a plan phase."}]]}] 77b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The timestamp indicating when the consumption actually occurred."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Constraint","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Detail","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":"Format","className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":[["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_8601","target":"_blank","rel":"noreferrer","children":"ISO 8601"}]," date-time string (e.g., ",["$","code","code-0",{"children":"YYYY-MM-DDTHH:mm:ssZ"}],")."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":"Timezone","className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Must be UTC.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":"Validation","className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["Revolut uses this to identify the applicable billing cycle. Accepted for the active cycle (",["$","code","code-0",{"children":"start_date ≤ usage_date < end_date"}],"), for a recently ended cycle before its ",["$","code","code-1",{"children":"usage_cutoff_date"}],", and for the one next upcoming cycle. Other dates are rejected."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 77c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The quantity of consumption to record for this usage report."}],"\n",["$","p","p-1",{"children":"Supports up to 20 digits before and 20 digits after the decimal point."}]]}] 77d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Key-value pairs you can attach to a usage record for your own tracking and reporting purposes."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Constraint","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Detail","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":"Keys","className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Maximum 50 keys per record.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":"Value types","className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"String, number, or boolean only.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":"Number precision","className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Up to 20 digits before and 20 digits after the decimal point.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 781:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["Report a unit of consumption against a usage-based subscription item. Revolut accumulates reported records throughout the billing cycle and processes the charge after the cycle's ",["$","code","code-0",{"children":"usage_cutoff_date"}],"."]}],"\n",["$","h3","h3-0",{"children":"Resolve the billing cycle"}],"\n",["$","p","p-1",{"children":["Revolut automatically identifies the applicable billing cycle from the ",["$","code","code-0",{"children":"usage_date"}]," you provide. The following submission windows are accepted:"]}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Window","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Rule","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":"Active cycle","className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":[["$","code","code-0",{"children":"usage_date"}]," falls within the current cycle (",["$","code","code-1",{"children":"start_date ≤ usage_date < end_date"}],")."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":"Past cycle correction","className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":[["$","code","code-0",{"children":"usage_date"}]," falls within a recently ended cycle, and the request is made before that cycle's ",["$","code","code-1",{"children":"usage_cutoff_date"}]," (12 hours after ",["$","code","code-2",{"children":"end_date"}]," by default)."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":"Next upcoming cycle","className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":[["$","code","code-0",{"children":"usage_date"}]," falls within the one next future cycle. Revolut creates a ",["$","code","code-1",{"children":"pending"}]," cycle to hold the record until it becomes active."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}],"\n",["$","p","p-2",{"children":["Any ",["$","code","code-0",{"children":"usage_date"}]," outside these windows causes the request to be rejected."]}],"\n",["$","h5","h5-0",{"children":"How Revolut calculates the charge"}],"\n",["$","p","p-3",{"children":["After the ",["$","code","code-0",{"children":"usage_cutoff_date"}]," passes, all records for each usage item are aggregated using the method defined on the subscription plan:"]}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-1",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Method","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Behaviour","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"sum"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Totals all reported values during the cycle. Use for cumulative metrics (e.g., total GB transferred).","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"latest"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["Uses the most recently reported value at the ",["$","code","code-0",{"children":"usage_cutoff_date"}],". If no usages are reported during the cycle, the charge is 0. Use for gauge-style metrics (e.g., active seat count at month-end)."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"max"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Uses the highest value reported during the cycle. Use for capacity-based billing (e.g., peak concurrent connections).","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}],"\n","$L7e9","\n","$L7ea"]}] 782:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["This parameter accepts the ",["$","a","a-0",{"href":"https://business.revolut.com/settings/apis?tab=merchant-api","target":"_blank","rel":"noreferrer","children":"Merchant API Secret key"}]," to authorise requests coming from the merchant's backend."]}],"\n",["$","p","p-1",{"children":["It ensures that ensures that each request is authenticated and authorised by verifying the secret key. The secret key should be included in all request headers as a ",["$","code","code-0",{"children":"Bearer"}]," token."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#authentication","target":"_blank","rel":"noreferrer","children":"Authentication"}]]}]}]]}]]}] 783:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The version of the Merchant API, specified in ",["$","code","code-0",{"children":"YYYY-MM-DD"}]," format."]}],"\n",["$","p","p-1",{"children":"If not specified, you will receive an error."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information about API versioning, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/reference/versioning/api-versions","target":"_blank","rel":"noreferrer","children":"API versions"}],"."]}]}]]}]]}] 784:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","code","code-0",{"children":"Idempotency-Key"}]," ensures that requests are processed only once, preventing multiple executions of the same operation due to retries or duplicate requests."]}],"\n",["$","p","p-1",{"children":"This header is required. It can accept any unique string value the merchant uses."}],"\n",["$","p","p-2",{"children":"A recommended practice is to use a unique identifier from your system (such as the entity's ID or a request UUID) as the idempotency key. This facilitates tracking and managing requests effectively."}]]}] 35:["$","$7a","update-subscription",{"children":[["$","section",null,{"className":"y9a0do0","data-variant":"endpoint","children":["$","$L7b",null,{"responses":{"200":{"description":"Subscription updated successfully","content":{"application/json":{"schema":{"type":"object","required":"$34:props:children:0:props:children:props:responses:200:content:application/json:schema:required","properties":{"id":{"type":"string","format":"uuid","description":"Unique identifier for the subscription.","descriptionNode":"$L7eb"},"external_reference":{"type":"string","maxLength":1024,"description":"Optional external reference for the subscription.\n\nUse this field to store your own system's identifier for easy tracking and correlation.","descriptionNode":"$L7ec"},"state":{"type":"string","enum":"$34:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:state:enum","description":"The state of the subscription.\n\n| State | Description |\n| ----- | ----------- |\n| `pending` | The subscription has been created but is not yet active. This typically occurs when awaiting the first payment or setup completion. |\n| `active` | The subscription is currently active and billing cycles are processing normally. |\n| `overdue` | The subscription has a failed payment and is awaiting resolution. |\n| `paused` | The subscription has been temporarily paused and no billing will occur. |\n| `cancelled` | The subscription has been cancelled and will not renew. |\n| `finished` | The subscription has completed all billing cycles (for limited-duration subscriptions). |","descriptionNode":"$L7ed"},"customer_id":{"type":"string","format":"uuid","description":"Unique identifier for the customer.","descriptionNode":"$L7ee"},"plan_id":{"type":"string","format":"uuid","description":"Unique identifier for the subscription plan.","descriptionNode":"$L7ef"},"plan_variation_id":{"type":"string","format":"uuid","description":"Unique identifier for the subscription plan variation.","descriptionNode":"$L7f0"},"payment_method_type":{"type":"string","enum":"$34:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method_type:enum","description":"The type of payment method used for the subscription.\n\n| Type | Description |\n| ---- | ----------- |\n| `automatic` | Payments are automatically charged to the customer's saved payment method. |\n| `manual` | Payments require manual processing by the customer. |","descriptionNode":"$L7f1"},"payment_method_id":{"type":"string","format":"uuid","description":"Unique identifier for the payment method.","descriptionNode":"$L7f2"},"created_at":{"type":"string","format":"date-time","description":"The date and time the subscription was created in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format.","descriptionNode":"$L7f3"},"updated_at":{"type":"string","format":"date-time","description":"The date and time the subscription was last updated in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format.","descriptionNode":"$L7f4"},"start_date":{"type":"$34:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:start_date:type","format":"date-time","description":"The date and time the subscription started in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format.\n\nThis field is `null` until the subscription becomes active.","descriptionNode":"$L7f5"},"current_cycle_id":{"type":"string","format":"uuid","description":"Unique identifier for the subscription cycle.","descriptionNode":"$L7f6"},"trial_duration":{"type":"string","format":"duration","description":"The trial period duration for this subscription in [ISO 8601 duration format](https://en.wikipedia.org/wiki/ISO_8601#Durations) (e.g., \"P14D\" for 14 days).\n\n### Override plan defaults\n\nSubscription plans can define a default trial duration. When creating a subscription, you can use this field to override the plan's default trial period:\n\n| Field value | Behaviour | Example |\n| ----------- | -------- | ------- |\n| **Not provided** | Uses the trial duration defined in the plan (if any) | Plan has `\"P7D\"` → subscription gets 7-day trial |\n| **Different value** | Overrides the plan's default trial duration | Plan has `\"P7D\"` → set to `\"P30D\"` for promotional offer, or `\"P3D\"` to reduce |\n| **`\"P0D\"`** | Explicitly skips the trial period | Plan has `\"P7D\"` → set to `\"P0D\"` to skip trial entirely |\n\n:::note\nOnly days (`D`) are allowed. Time components such as hours, minutes, or seconds are not permitted.\n:::","pattern":"^P[0-9]+D$","examples":"$34:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:trial_duration:examples","descriptionNode":"$L7f7"},"trial_end_date":{"type":"$34:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:trial_end_date:type","format":"date-time","description":"The date and time when the subscription's trial period ends in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format.\n\nThis value is automatically calculated by the system as: `start_date` + `trial_duration`\n\nThe `trial_duration` used in the calculation comes from either:\n- The subscription's custom `trial_duration` (if provided at creation time), or\n- The plan's default `trial_duration` (if no override was specified)\n\nThis field is `null` when the subscription has no trial period (e.g., when `trial_duration` is not set or is `\"P0D\"`).","examples":"$34:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:trial_end_date:examples","descriptionNode":"$L7f8"},"setup_order_id":{"type":"string","format":"uuid","description":"The ID of the order created for handling the setup payment for the subscription.\n\nUse the [Retrieve an order](https://developer.revolut.com/docs/api/merchant#retrieve-order) endpoint with this ID to get order details, including the `checkout_url` for redirecting customers to the Hosted Payment Page or the `token` for widget integration.\n\n:::note\nThe order is created in parallel to the subscription and is used to collect the initial payment and save the customer's payment method for future billing cycles.\n:::","descriptionNode":"$L7f9"},"scheduled_action":{"description":"A pending scheduled action on the subscription, applied at the end of the current billing cycle.","type":"object","discriminator":"$34:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:scheduled_action:discriminator","oneOf":[{"title":"Subscription-Scheduled-Action-Cancel","type":"object","description":"A cancellation scheduled to take effect at the end of the current billing cycle.","required":"$34:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:scheduled_action:oneOf:0:required","properties":{"type":{"type":"string","description":"The type of the scheduled action.\n\n| Value | Description |\n| ----- | ----------- |\n| `cancel` | A cancellation scheduled to take effect at the end of the current billing cycle. |\n| `change_plan_variation` | A plan variation change scheduled to take effect at the end of the current billing cycle. |","enum":"$34:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:scheduled_action:oneOf:0:properties:type:enum","examples":"$34:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:scheduled_action:oneOf:0:properties:type:examples","descriptionNode":"$L7fa"},"reason":{"type":"string","description":"The reason for the scheduled action. This field is informational and does not affect how the action is processed.\n\n| Value | Description |\n| ----- | ----------- |\n| `customer_request` | The action was requested by the customer. |\n| `merchant_request` | The action was initiated by the merchant. |","enum":"$37:props:children:0:props:children:props:requestBody:content:application/json:schema:properties:reason:enum","default":"merchant_request","examples":"$37:props:children:0:props:children:props:requestBody:content:application/json:schema:properties:reason:examples","descriptionNode":"$L7fb"}},"descriptionNode":"$L7fc"},{"title":"Subscription-Scheduled-Action-Change-Plan","type":"object","description":"A plan variation change scheduled to take effect at the end of the current billing cycle.","required":"$34:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:scheduled_action:oneOf:1:required","properties":{"type":{"type":"string","description":"The type of the scheduled action.\n\n| Value | Description |\n| ----- | ----------- |\n| `cancel` | A cancellation scheduled to take effect at the end of the current billing cycle. |\n| `change_plan_variation` | A plan variation change scheduled to take effect at the end of the current billing cycle. |","enum":"$34:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:scheduled_action:oneOf:0:properties:type:enum","examples":"$34:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:scheduled_action:oneOf:0:properties:type:examples","descriptionNode":"$L7fd"},"reason":{"type":"string","description":"The reason for the scheduled action. This field is informational and does not affect how the action is processed.\n\n| Value | Description |\n| ----- | ----------- |\n| `customer_request` | The action was requested by the customer. |\n| `merchant_request` | The action was initiated by the merchant. |","enum":"$37:props:children:0:props:children:props:requestBody:content:application/json:schema:properties:reason:enum","default":"merchant_request","examples":"$37:props:children:0:props:children:props:requestBody:content:application/json:schema:properties:reason:examples","descriptionNode":"$L7fe"},"plan_variation_id":{"type":"string","format":"uuid","description":"Unique identifier for the subscription plan variation.","descriptionNode":"$L7ff"},"plan_variation_phase_id":{"type":"string","format":"uuid","description":"Unique identifier for the subscription plan phase.","descriptionNode":"$L800"}},"descriptionNode":"$L801"}],"descriptionNode":"$L802"}}},"examples":{"updated_subscription":{"summary":"Active subscription","value":"$34:props:children:0:props:children:props:responses:200:content:application/json:examples:active_subscription:value"}}}},"descriptionNode":"$L803"},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"code":{"type":"string","description":"An identifier that can be used to determine what went wrong.\n\nError codes are not globally unique, but uniqueness is guaranteed within endpoints.","descriptionNode":"$L804"},"message":{"type":"string","description":"Some human readable text describing what went wrong.","descriptionNode":"$L805"},"timestamp":{"type":"integer","description":"The [UNIX timestamp](https://www.unixtimestamp.com/) of the date and time the error happened.","descriptionNode":"$L806"}}}}},"descriptionNode":"$L807"},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"code":{"type":"string","description":"An identifier that can be used to determine what went wrong.\n\nError codes are not globally unique, but uniqueness is guaranteed within endpoints.","descriptionNode":"$L808"},"message":{"type":"string","description":"Some human readable text describing what went wrong.","descriptionNode":"$L809"},"timestamp":{"type":"integer","description":"The [UNIX timestamp](https://www.unixtimestamp.com/) of the date and time the error happened.","descriptionNode":"$L80a"}}}}},"descriptionNode":"$L80b"},"404":{"description":"Subscription not found","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"code":{"type":"string","description":"An identifier that can be used to determine what went wrong.\n\nError codes are not globally unique, but uniqueness is guaranteed within endpoints.","descriptionNode":"$L80c"},"message":{"type":"string","description":"Some human readable text describing what went wrong.","descriptionNode":"$L80d"},"timestamp":{"type":"integer","description":"The [UNIX timestamp](https://www.unixtimestamp.com/) of the date and time the error happened.","descriptionNode":"$L80e"}}}}},"descriptionNode":"$L80f"},"default":{"description":"Error response","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"code":{"type":"string","description":"An identifier that can be used to determine what went wrong.\n\nError codes are not globally unique, but uniqueness is guaranteed within endpoints.","descriptionNode":"$L810"},"message":{"type":"string","description":"Some human readable text describing what went wrong.","descriptionNode":"$L811"},"timestamp":{"type":"integer","description":"The [UNIX timestamp](https://www.unixtimestamp.com/) of the date and time the error happened.","descriptionNode":"$L812"}}}}},"descriptionNode":"$L813"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"external_reference":{"type":"string","maxLength":1024,"description":"Optional external reference for the subscription.\n\nUse this field to store your own system's identifier for easy tracking and correlation.","descriptionNode":"$L814"}}},"examples":{"update_subscription":{"summary":"Update subscription","value":{"external_reference":"ext-ref-12345"}}}}}},"variantLabels":[],"children":["$L815","$L816"]}]}],false]}] 7e9:["$","p","p-4",{"children":"The aggregated total is multiplied by the unit price to produce the final charge."}] 7ea:["$","div","inlinealert-0",{"data-type":"warning","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMark","color":"var(--rui-color-warning)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["The ",["$","code","code-0",{"children":"Idempotency-Key"}]," header is ",["$","strong","strong-0",{"children":"required"}]," for this endpoint. Providing a unique idempotency key ensures that duplicate requests due to retries or network issues do not result in duplicate usage records."]}]}]]}] 815:["$","div",null,{"className":"ezz1n30","children":[["$","div",null,{"data-header":"$undefined","className":"ezz1n31","children":["$","div",null,{"className":"y9a0do1","children":[["$","h2",null,{"id":"update-subscription","children":[["$L817","$undefined"],["$","$L15",null,{"id":"update-subscription"}]]}],["$","$L16",null,{"url":"/docs/api/merchant/2025-10-16/operations/update-subscription.md"}]]}]}],"$undefined"]}] 81d:T650,
curl -X PATCH "https://merchant.revolut.com/api/subscriptions/__RP_TOK_0__" \
  -H "Content-Type: application/json" \
  -H "Authorization: __RP_TOK_1__" \
  -H "Revolut-Api-Version: __RP_TOK_2__" \
  -d '{
  "external_reference": "ext-ref-12345"
}'
81e:Te99,
const payload = {
  "external_reference": "ext-ref-12345"
};
fetch("https://merchant.revolut.com/api/subscriptions/__RP_TOK_0__", {
  method: "PATCH",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "__RP_TOK_1__",
    "Revolut-Api-Version": "__RP_TOK_2__"
  },
  body: JSON.stringify(payload)
})
  .then(response => response.json())
  .then(data => console.log(data));
81f:T1635,
package main

import (
  "fmt"
  "net/http"
  "bytes"
  "encoding/json"
)

func main() {
  url := "https://merchant.revolut.com/api/subscriptions/__RP_TOK_0__"
  jsonData := []byte(`
{
  "external_reference": "ext-ref-12345"
}
  `)
  req, _ := http.NewRequest("PATCH", url, bytes.NewBuffer(jsonData))
  req.Header.Add("Content-Type", "application/json")
  req.Header.Add("Authorization", "__RP_TOK_1__")
  req.Header.Add("Revolut-Api-Version", "__RP_TOK_2__")

  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  fmt.Println(res)
}
820:Tbcd,
import requests

url = "https://merchant.revolut.com/api/subscriptions/__RP_TOK_0__"
headers = {
  "Content-Type": "application/json",
  "Authorization": "__RP_TOK_1__",
  "Revolut-Api-Version": "__RP_TOK_2__"
}
payload = {
  "external_reference": "ext-ref-12345"
}

response = requests.patch(url, headers=headers, json=payload)
print(response.json())
821:T1b99,
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;

public class Main {
  public static void main(String[] args) {
    HttpClient client = HttpClient.newHttpClient();
    String body = """
{
  "external_reference": "ext-ref-12345"
}
    """;

    HttpRequest request = HttpRequest.newBuilder()
      .uri(URI.create("https://merchant.revolut.com/api/subscriptions/__RP_TOK_0__"))
      .header("Content-Type", "application/json")
      .header("Authorization", "__RP_TOK_1__")
      .header("Revolut-Api-Version", "__RP_TOK_2__")
      .PATCH(HttpRequest.BodyPublishers.ofString(body))
      .build();

    client.sendAsync(request, HttpResponse.BodyHandlers.ofString())
      .thenApply(HttpResponse::body)
      .thenAccept(System.out::println)
      .join();
  }
}
822:T1d81,
using System.Net.Http;
using System.Net.Http.Headers;

var client = new HttpClient();
var request = new HttpRequestMessage
{
  Method = HttpMethod.Patch,
  RequestUri = new Uri("https://merchant.revolut.com/api/subscriptions/__RP_TOK_0__"),
  Headers =
  {
    { "Authorization", "__RP_TOK_1__" },
    { "Revolut-Api-Version", "__RP_TOK_2__" },
  },
  Content = new StringContent(@"{
  ""external_reference"": ""ext-ref-12345""
}")
  {
    Headers =
    {
      ContentType = new MediaTypeHeaderValue("application/json")
    }
  }
};

using (var response = await client.SendAsync(request))
{
  response.EnsureSuccessStatusCode();
  var body = await response.Content.ReadAsStringAsync();
  Console.WriteLine(body);
}
823:T658,
curl -X PATCH "https://sandbox-merchant.revolut.com/api/subscriptions/__RP_TOK_0__" \
  -H "Content-Type: application/json" \
  -H "Authorization: __RP_TOK_1__" \
  -H "Revolut-Api-Version: __RP_TOK_2__" \
  -d '{
  "external_reference": "ext-ref-12345"
}'
824:Tea1,
const payload = {
  "external_reference": "ext-ref-12345"
};
fetch("https://sandbox-merchant.revolut.com/api/subscriptions/__RP_TOK_0__", {
  method: "PATCH",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "__RP_TOK_1__",
    "Revolut-Api-Version": "__RP_TOK_2__"
  },
  body: JSON.stringify(payload)
})
  .then(response => response.json())
  .then(data => console.log(data));
825:T163d,
package main

import (
  "fmt"
  "net/http"
  "bytes"
  "encoding/json"
)

func main() {
  url := "https://sandbox-merchant.revolut.com/api/subscriptions/__RP_TOK_0__"
  jsonData := []byte(`
{
  "external_reference": "ext-ref-12345"
}
  `)
  req, _ := http.NewRequest("PATCH", url, bytes.NewBuffer(jsonData))
  req.Header.Add("Content-Type", "application/json")
  req.Header.Add("Authorization", "__RP_TOK_1__")
  req.Header.Add("Revolut-Api-Version", "__RP_TOK_2__")

  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  fmt.Println(res)
}
826:Tbd5,
import requests

url = "https://sandbox-merchant.revolut.com/api/subscriptions/__RP_TOK_0__"
headers = {
  "Content-Type": "application/json",
  "Authorization": "__RP_TOK_1__",
  "Revolut-Api-Version": "__RP_TOK_2__"
}
payload = {
  "external_reference": "ext-ref-12345"
}

response = requests.patch(url, headers=headers, json=payload)
print(response.json())
827:T1ba1,
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;

public class Main {
  public static void main(String[] args) {
    HttpClient client = HttpClient.newHttpClient();
    String body = """
{
  "external_reference": "ext-ref-12345"
}
    """;

    HttpRequest request = HttpRequest.newBuilder()
      .uri(URI.create("https://sandbox-merchant.revolut.com/api/subscriptions/__RP_TOK_0__"))
      .header("Content-Type", "application/json")
      .header("Authorization", "__RP_TOK_1__")
      .header("Revolut-Api-Version", "__RP_TOK_2__")
      .PATCH(HttpRequest.BodyPublishers.ofString(body))
      .build();

    client.sendAsync(request, HttpResponse.BodyHandlers.ofString())
      .thenApply(HttpResponse::body)
      .thenAccept(System.out::println)
      .join();
  }
}
828:T1d89,
using System.Net.Http;
using System.Net.Http.Headers;

var client = new HttpClient();
var request = new HttpRequestMessage
{
  Method = HttpMethod.Patch,
  RequestUri = new Uri("https://sandbox-merchant.revolut.com/api/subscriptions/__RP_TOK_0__"),
  Headers =
  {
    { "Authorization", "__RP_TOK_1__" },
    { "Revolut-Api-Version", "__RP_TOK_2__" },
  },
  Content = new StringContent(@"{
  ""external_reference"": ""ext-ref-12345""
}")
  {
    Headers =
    {
      ContentType = new MediaTypeHeaderValue("application/json")
    }
  }
};

using (var response = await client.SendAsync(request))
{
  response.EnsureSuccessStatusCode();
  var body = await response.Content.ReadAsStringAsync();
  Console.WriteLine(body);
}
816:["$","div",null,{"className":"ezz1n30","children":[["$","div",null,{"data-header":"$undefined","className":"ezz1n31","children":["$L818",["$","$L85",null,{"parameters":[{"name":"Authorization","in":"header","schema":{"type":"string","format":"Bearer ","examples":"$62:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:0:schema:examples"},"required":true,"description":"This parameter accepts the [Merchant API Secret key](https://business.revolut.com/settings/apis?tab=merchant-api) to authorise requests coming from the merchant's backend. \n\nIt ensures that ensures that each request is authenticated and authorised by verifying the secret key. The secret key should be included in all request headers as a `Bearer` token.\n\n:::info\nFor more information, see: [Authentication](https://developer.revolut.com/docs/api/merchant#authentication)\n:::","descriptionNode":"$L819"},{"name":"Revolut-Api-Version","in":"header","schema":{"type":"string","format":"date","enum":"$36:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:1:schema:enum","examples":"$36:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:1:schema:examples"},"required":true,"description":"The version of the Merchant API, specified in `YYYY-MM-DD` format.\n\nIf not specified, you will receive an error.\n\n\n:::info\nFor more information about API versioning, see: [API versions](https://developer.revolut.com/docs/guides/merchant/reference/versioning/api-versions).\n:::","x-config-always-visible-in-example":true,"example":"2025-10-16","descriptionNode":"$L81a"},{"name":"subscription_id","in":"path","schema":{"type":"string","format":"uuid","description":"A UUID string, typically used to identify resources.","descriptionNode":"$L81b"},"required":true,"description":"The ID of the subscription.","descriptionNode":"$L81c"}],"requestBody":"$35:props:children:0:props:children:props:requestBody","heading":"Request","requestBodySchemaTitle":"Request body","headingAs":"h3"}],["$","$L89",null,{"responses":"$35:props:children:0:props:children:props:responses","headingAs":"h3"}]]}],["$","div",null,{"className":"ezz1n32","children":[[["$","$L8a",null,{"itemsByServer":{"https://merchant.revolut.com":[{"id":"curl","label":"cURL","templateCode":"curl -X PATCH \"https://merchant.revolut.com/api/subscriptions/__RP_TOK_0__\" \\\n -H \"Content-Type: application/json\" \\\n -H \"Authorization: __RP_TOK_1__\" \\\n -H \"Revolut-Api-Version: __RP_TOK_2__\" \\\n -d '{\n \"external_reference\": \"ext-ref-12345\"\n}'","templateHtml":"$81d","tokens":[{"marker":"__RP_TOK_0__","paramName":"subscription_id","paramIn":"path","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["shell-double-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:subscription_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"javascript","label":"JavaScript","templateCode":"const payload = {\n \"external_reference\": \"ext-ref-12345\"\n};\nfetch(\"https://merchant.revolut.com/api/subscriptions/__RP_TOK_0__\", {\n method: \"PATCH\",\n headers: {\n \"Content-Type\": \"application/json\",\n \"Authorization\": \"__RP_TOK_1__\",\n \"Revolut-Api-Version\": \"__RP_TOK_2__\"\n },\n body: JSON.stringify(payload)\n})\n .then(response => response.json())\n .then(data => console.log(data));","templateHtml":"$81e","tokens":[{"marker":"__RP_TOK_0__","paramName":"subscription_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:subscription_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"go","label":"Go","templateCode":"package main\n\nimport (\n \"fmt\"\n \"net/http\"\n \"bytes\"\n \"encoding/json\"\n)\n\nfunc main() {\n url := \"https://merchant.revolut.com/api/subscriptions/__RP_TOK_0__\"\n jsonData := []byte(`\n{\n \"external_reference\": \"ext-ref-12345\"\n}\n `)\n req, _ := http.NewRequest(\"PATCH\", url, bytes.NewBuffer(jsonData))\n req.Header.Add(\"Content-Type\", \"application/json\")\n req.Header.Add(\"Authorization\", \"__RP_TOK_1__\")\n req.Header.Add(\"Revolut-Api-Version\", \"__RP_TOK_2__\")\n\n res, _ := http.DefaultClient.Do(req)\n defer res.Body.Close()\n fmt.Println(res)\n}","templateHtml":"$81f","tokens":[{"marker":"__RP_TOK_0__","paramName":"subscription_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:subscription_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"python","label":"Python","templateCode":"import requests\n\nurl = \"https://merchant.revolut.com/api/subscriptions/__RP_TOK_0__\"\nheaders = {\n \"Content-Type\": \"application/json\",\n \"Authorization\": \"__RP_TOK_1__\",\n \"Revolut-Api-Version\": \"__RP_TOK_2__\"\n}\npayload = {\n \"external_reference\": \"ext-ref-12345\"\n}\n\nresponse = requests.patch(url, headers=headers, json=payload)\nprint(response.json())","templateHtml":"$820","tokens":[{"marker":"__RP_TOK_0__","paramName":"subscription_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:subscription_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"java","label":"Java","templateCode":"import java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\nimport java.net.URI;\n\npublic class Main {\n public static void main(String[] args) {\n HttpClient client = HttpClient.newHttpClient();\n String body = \"\"\"\n{\n \"external_reference\": \"ext-ref-12345\"\n}\n \"\"\";\n\n HttpRequest request = HttpRequest.newBuilder()\n .uri(URI.create(\"https://merchant.revolut.com/api/subscriptions/__RP_TOK_0__\"))\n .header(\"Content-Type\", \"application/json\")\n .header(\"Authorization\", \"__RP_TOK_1__\")\n .header(\"Revolut-Api-Version\", \"__RP_TOK_2__\")\n .PATCH(HttpRequest.BodyPublishers.ofString(body))\n .build();\n\n client.sendAsync(request, HttpResponse.BodyHandlers.ofString())\n .thenApply(HttpResponse::body)\n .thenAccept(System.out::println)\n .join();\n }\n}","templateHtml":"$821","tokens":[{"marker":"__RP_TOK_0__","paramName":"subscription_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:subscription_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"csharp","label":"C#","templateCode":"using System.Net.Http;\nusing System.Net.Http.Headers;\n\nvar client = new HttpClient();\nvar request = new HttpRequestMessage\n{\n Method = HttpMethod.Patch,\n RequestUri = new Uri(\"https://merchant.revolut.com/api/subscriptions/__RP_TOK_0__\"),\n Headers =\n {\n { \"Authorization\", \"__RP_TOK_1__\" },\n { \"Revolut-Api-Version\", \"__RP_TOK_2__\" },\n },\n Content = new StringContent(@\"{\n \"\"external_reference\"\": \"\"ext-ref-12345\"\"\n}\")\n {\n Headers =\n {\n ContentType = new MediaTypeHeaderValue(\"application/json\")\n }\n }\n};\n\nusing (var response = await client.SendAsync(request))\n{\n response.EnsureSuccessStatusCode();\n var body = await response.Content.ReadAsStringAsync();\n Console.WriteLine(body);\n}","templateHtml":"$822","tokens":[{"marker":"__RP_TOK_0__","paramName":"subscription_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:subscription_id":"123e4567-e89b-12d3-a456-426614174000"}}],"https://sandbox-merchant.revolut.com":[{"id":"curl","label":"cURL","templateCode":"curl -X PATCH \"https://sandbox-merchant.revolut.com/api/subscriptions/__RP_TOK_0__\" \\\n -H \"Content-Type: application/json\" \\\n -H \"Authorization: __RP_TOK_1__\" \\\n -H \"Revolut-Api-Version: __RP_TOK_2__\" \\\n -d '{\n \"external_reference\": \"ext-ref-12345\"\n}'","templateHtml":"$823","tokens":[{"marker":"__RP_TOK_0__","paramName":"subscription_id","paramIn":"path","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["shell-double-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:subscription_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"javascript","label":"JavaScript","templateCode":"const payload = {\n \"external_reference\": \"ext-ref-12345\"\n};\nfetch(\"https://sandbox-merchant.revolut.com/api/subscriptions/__RP_TOK_0__\", {\n method: \"PATCH\",\n headers: {\n \"Content-Type\": \"application/json\",\n \"Authorization\": \"__RP_TOK_1__\",\n \"Revolut-Api-Version\": \"__RP_TOK_2__\"\n },\n body: JSON.stringify(payload)\n})\n .then(response => response.json())\n .then(data => console.log(data));","templateHtml":"$824","tokens":[{"marker":"__RP_TOK_0__","paramName":"subscription_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:subscription_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"go","label":"Go","templateCode":"package main\n\nimport (\n \"fmt\"\n \"net/http\"\n \"bytes\"\n \"encoding/json\"\n)\n\nfunc main() {\n url := \"https://sandbox-merchant.revolut.com/api/subscriptions/__RP_TOK_0__\"\n jsonData := []byte(`\n{\n \"external_reference\": \"ext-ref-12345\"\n}\n `)\n req, _ := http.NewRequest(\"PATCH\", url, bytes.NewBuffer(jsonData))\n req.Header.Add(\"Content-Type\", \"application/json\")\n req.Header.Add(\"Authorization\", \"__RP_TOK_1__\")\n req.Header.Add(\"Revolut-Api-Version\", \"__RP_TOK_2__\")\n\n res, _ := http.DefaultClient.Do(req)\n defer res.Body.Close()\n fmt.Println(res)\n}","templateHtml":"$825","tokens":[{"marker":"__RP_TOK_0__","paramName":"subscription_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:subscription_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"python","label":"Python","templateCode":"import requests\n\nurl = \"https://sandbox-merchant.revolut.com/api/subscriptions/__RP_TOK_0__\"\nheaders = {\n \"Content-Type\": \"application/json\",\n \"Authorization\": \"__RP_TOK_1__\",\n \"Revolut-Api-Version\": \"__RP_TOK_2__\"\n}\npayload = {\n \"external_reference\": \"ext-ref-12345\"\n}\n\nresponse = requests.patch(url, headers=headers, json=payload)\nprint(response.json())","templateHtml":"$826","tokens":[{"marker":"__RP_TOK_0__","paramName":"subscription_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:subscription_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"java","label":"Java","templateCode":"import java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\nimport java.net.URI;\n\npublic class Main {\n public static void main(String[] args) {\n HttpClient client = HttpClient.newHttpClient();\n String body = \"\"\"\n{\n \"external_reference\": \"ext-ref-12345\"\n}\n \"\"\";\n\n HttpRequest request = HttpRequest.newBuilder()\n .uri(URI.create(\"https://sandbox-merchant.revolut.com/api/subscriptions/__RP_TOK_0__\"))\n .header(\"Content-Type\", \"application/json\")\n .header(\"Authorization\", \"__RP_TOK_1__\")\n .header(\"Revolut-Api-Version\", \"__RP_TOK_2__\")\n .PATCH(HttpRequest.BodyPublishers.ofString(body))\n .build();\n\n client.sendAsync(request, HttpResponse.BodyHandlers.ofString())\n .thenApply(HttpResponse::body)\n .thenAccept(System.out::println)\n .join();\n }\n}","templateHtml":"$827","tokens":[{"marker":"__RP_TOK_0__","paramName":"subscription_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:subscription_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"csharp","label":"C#","templateCode":"using System.Net.Http;\nusing System.Net.Http.Headers;\n\nvar client = new HttpClient();\nvar request = new HttpRequestMessage\n{\n Method = HttpMethod.Patch,\n RequestUri = new Uri(\"https://sandbox-merchant.revolut.com/api/subscriptions/__RP_TOK_0__\"),\n Headers =\n {\n { \"Authorization\", \"__RP_TOK_1__\" },\n { \"Revolut-Api-Version\", \"__RP_TOK_2__\" },\n },\n Content = new StringContent(@\"{\n \"\"external_reference\"\": \"\"ext-ref-12345\"\"\n}\")\n {\n Headers =\n {\n ContentType = new MediaTypeHeaderValue(\"application/json\")\n }\n }\n};\n\nusing (var response = await client.SendAsync(request))\n{\n response.EnsureSuccessStatusCode();\n var body = await response.Content.ReadAsStringAsync();\n Console.WriteLine(body);\n}","templateHtml":"$828","tokens":[{"marker":"__RP_TOK_0__","paramName":"subscription_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:subscription_id":"123e4567-e89b-12d3-a456-426614174000"}}]},"method":"patch","servers":"$62:props:children:0:props:children:props:children:1:props:children:1:props:children:0:0:props:servers","path":"/api/subscriptions/{subscription_id}","parameters":["$816:props:children:0:props:children:1:props:parameters:0","$816:props:children:0:props:children:1:props:parameters:1","$816:props:children:0:props:children:1:props:parameters:2"]}],"$L829"],"$L82a","$L82b"]}]]}] 797:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Each Merchant API request must contain an authorization header in the following format:"}],"\n","$L82c","\n",["$","p","p-1",{"children":"To use this API, you need to generate API keys from your Revolut Business account. The Secret key is used in the authorization header for all server calls, while the Public key is provided with payment methods at checkout."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For detailed instructions on generating your API keys, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/get-started#generate-api-keys","target":"_blank","rel":"noreferrer","children":"Generate API keys"}],"."]}]}]]}]]}] 7cb:"Retrieve a subscription list" 829:["$","$L10d",null,{"security":[{"Api-Key":[]}],"authorization":{"Api-Key":{"type":"apiKey","in":"header","name":"Authorization","description":"Each Merchant API request must contain an authorization header in the following format:\n\n```\n'Authorization: Bearer '\n```\n\nTo use this API, you need to generate API keys from your Revolut Business account. The Secret key is used in the authorization header for all server calls, while the Public key is provided with payment methods at checkout.\n\n:::info\nFor detailed instructions on generating your API keys, see: [Generate API keys](https://developer.revolut.com/docs/guides/merchant/get-started#generate-api-keys).\n:::","descriptionNode":"$L82d"}}}] 82a:["$","$L10f",null,{"exampleBlocks":{"application/json":{"variants":[{"key":"update_subscription","label":"Update subscription","rawValue":"$35:props:children:0:props:children:props:requestBody:content:application/json:examples:update_subscription:value","block":"$L82e"}],"syncedPropertyName":"$undefined"}},"title":"Request body samples","headingAs":"h4"}] 82b:["$","$L110",null,{"exampleBlocks":{"200":{"application/json":{"variants":[{"key":"updated_subscription","label":"Active subscription","rawValue":"$34:props:children:0:props:children:props:responses:200:content:application/json:examples:active_subscription:value","block":"$L82f"}],"syncedPropertyName":"$undefined"}},"400":{"application/json":{"variants":[{"key":"default","label":"Example","rawValue":{"code":"string","message":"string","timestamp":123},"block":"$L830"}],"syncedPropertyName":"$undefined"}},"401":{"application/json":{"variants":[{"key":"default","label":"Example","rawValue":{"code":"string","message":"string","timestamp":123},"block":"$L831"}],"syncedPropertyName":"$undefined"}},"404":{"application/json":{"variants":[{"key":"default","label":"Example","rawValue":{"code":"string","message":"string","timestamp":123},"block":"$L832"}],"syncedPropertyName":"$undefined"}},"default":{"application/json":{"variants":[{"key":"default","label":"Example","rawValue":{"code":"string","message":"string","timestamp":123},"block":"$L833"}],"syncedPropertyName":"$undefined"}}},"headingAs":"h4"}] 7a2:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["Token for retrieving the next page of results. Use this token as the value of the ",["$","code","code-0",{"children":"page_token"}]," query parameter in your next request to retrieve the next page."]}],"\n",["$","p","p-1",{"children":"If not present, there are no more results to retrieve."}]]}] 7a3:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unique identifier for the subscription."}]]}] 7a4:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Optional external reference for the subscription."}],"\n",["$","p","p-1",{"children":"Use this field to store your own system's identifier for easy tracking and correlation."}]]}] 7a5:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The state of the subscription."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"State","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"pending"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The subscription has been created but is not yet active. This typically occurs when awaiting the first payment or setup completion.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"active"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The subscription is currently active and billing cycles are processing normally.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"overdue"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The subscription has a failed payment and is awaiting resolution.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"paused"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The subscription has been temporarily paused and no billing will occur.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-4",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"cancelled"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The subscription has been cancelled and will not renew.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-5",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"finished"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The subscription has completed all billing cycles (for limited-duration subscriptions).","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 7a6:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unique identifier for the customer."}]]}] 7a7:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unique identifier for the subscription plan."}]]}] 7a8:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unique identifier for the subscription plan variation."}]]}] 7a9:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of payment method used for the subscription."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Type","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"automatic"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Payments are automatically charged to the customer's saved payment method.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"manual"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Payments require manual processing by the customer.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 7aa:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unique identifier for the payment method."}]]}] 7ab:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The date and time the subscription was created in ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_8601","target":"_blank","rel":"noreferrer","children":"ISO 8601"}]," format."]}]]}] 7ac:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The date and time the subscription was last updated in ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_8601","target":"_blank","rel":"noreferrer","children":"ISO 8601"}]," format."]}]]}] 7ad:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The date and time the subscription started in ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_8601","target":"_blank","rel":"noreferrer","children":"ISO 8601"}]," format."]}],"\n",["$","p","p-1",{"children":["This field is ",["$","code","code-0",{"children":"null"}]," until the subscription becomes active."]}]]}] 7ae:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unique identifier for the subscription cycle."}]]}] 705:["$","div","request-application/json-update_usage_quantity",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"
{\n  \"quantity\": 150\n}
"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"quantity\": 150\n}"}]}]]}] 834:T435,
{
  "metadata": {
    "user_id": "67890",
    "api_version": "v3"
  }
}
706:["$","div","request-application/json-update_usage_metadata",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$834"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"metadata\": {\n \"user_id\": \"67890\",\n \"api_version\": \"v3\"\n }\n}"}]}]]}] 835:T42f,
{
  "quantity": 200,
  "metadata": {
    "user_id": "54321"
  }
}
707:["$","div","request-application/json-update_usage",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$835"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"quantity\": 200,\n \"metadata\": {\n \"user_id\": \"54321\"\n }\n}"}]}]]}] 836:Td31,
{
  "id": "750e8400-e29b-41d4-a716-446655440000",
  "subscription_id": "550e8400-e29b-41d4-a716-446655440000",
  "subscription_cycle_id": "850e8400-e29b-41d4-a716-446655440000",
  "subscription_item_code": "api_calls",
  "usage_date": "2026-03-01T21:00:00Z",
  "quantity": 100,
  "metadata": {
    "user_id": "12345",
    "api_version": "v2"
  },
  "created_at": "2026-03-01T21:05:00Z",
  "updated_at": "2026-03-01T21:05:00Z"
}
708:["$","div","200-application/json-updated_usage",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$836"}}]}]],"$L837"]}] 838:T44d,
{
  "code": "string",
  "message": "string",
  "timestamp": 123
}
709:["$","div","400-application/json-default",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$838"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"code\": \"string\",\n \"message\": \"string\",\n \"timestamp\": 123\n}"}]}]]}] 839:T44d,
{
  "code": "string",
  "message": "string",
  "timestamp": 123
}
70a:["$","div","401-application/json-default",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$839"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"code\": \"string\",\n \"message\": \"string\",\n \"timestamp\": 123\n}"}]}]]}] 83a:T44d,
{
  "code": "string",
  "message": "string",
  "timestamp": 123
}
70b:["$","div","404-application/json-default",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$83a"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"code\": \"string\",\n \"message\": \"string\",\n \"timestamp\": 123\n}"}]}]]}] 83b:T487,
{
  "code": "subscription_usage_locked",
  "message": "Cannot modify usage for a locked cycle",
  "timestamp": 1743465600
}
70c:["$","div","422-application/json-usage_locked",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$83b"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"code\": \"subscription_usage_locked\",\n \"message\": \"Cannot modify usage for a locked cycle\",\n \"timestamp\": 1743465600\n}"}]}]]}] 83c:T44d,
{
  "code": "string",
  "message": "string",
  "timestamp": 123
}
70d:["$","div","default-application/json-default",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$83c"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"code\": \"string\",\n \"message\": \"string\",\n \"timestamp\": 123\n}"}]}]]}] 7af:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The trial period duration for this subscription in ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_8601#Durations","target":"_blank","rel":"noreferrer","children":"ISO 8601 duration format"}]," (e.g., \"P14D\" for 14 days)."]}],"\n",["$","h1","h1-0",{"children":"Override plan defaults"}],"\n",["$","p","p-1",{"children":"Subscription plans can define a default trial duration. When creating a subscription, you can use this field to override the plan's default trial period:"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Field value","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Behaviour","className":"eowryt6","ref":"$undefined"}],["$","th","th-2",{"children":"Example","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","strong","strong-0",{"children":"Not provided"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Uses the trial duration defined in the plan (if any)","className":"eowryt7","ref":"$undefined"}],["$","td","td-2",{"children":["Plan has ",["$","code","code-0",{"children":"\"P7D\""}]," → subscription gets 7-day trial"],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","strong","strong-0",{"children":"Different value"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Overrides the plan's default trial duration","className":"eowryt7","ref":"$undefined"}],["$","td","td-2",{"children":["Plan has ",["$","code","code-0",{"children":"\"P7D\""}]," → set to ",["$","code","code-1",{"children":"\"P30D\""}]," for promotional offer, or ",["$","code","code-2",{"children":"\"P3D\""}]," to reduce"],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","strong","strong-0",{"children":["$","code","code-0",{"children":"\"P0D\""}]}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Explicitly skips the trial period","className":"eowryt7","ref":"$undefined"}],["$","td","td-2",{"children":["Plan has ",["$","code","code-0",{"children":"\"P7D\""}]," → set to ",["$","code","code-1",{"children":"\"P0D\""}]," to skip trial entirely"],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["Only days (",["$","code","code-0",{"children":"D"}],") are allowed. Time components such as hours, minutes, or seconds are not permitted."]}]}]]}]]}] 7b0:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The date and time when the subscription's trial period ends in ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_8601","target":"_blank","rel":"noreferrer","children":"ISO 8601"}]," format."]}],"\n",["$","p","p-1",{"children":["This value is automatically calculated by the system as: ",["$","code","code-0",{"children":"start_date"}]," + ",["$","code","code-1",{"children":"trial_duration"}]]}],"\n",["$","p","p-2",{"children":["The ",["$","code","code-0",{"children":"trial_duration"}]," used in the calculation comes from either:"]}],"\n",["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["The subscription's custom ",["$","code","code-0",{"children":"trial_duration"}]," (if provided at creation time), or"]}],"\n",["$","li","li-1",{"children":["The plan's default ",["$","code","code-0",{"children":"trial_duration"}]," (if no override was specified)"]}],"\n"]}],"\n",["$","p","p-3",{"children":["This field is ",["$","code","code-0",{"children":"null"}]," when the subscription has no trial period (e.g., when ",["$","code","code-1",{"children":"trial_duration"}]," is not set or is ",["$","code","code-2",{"children":"\"P0D\""}],")."]}]]}] 7b1:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The ID of the order created for handling the setup payment for the subscription."}],"\n",["$","p","p-1",{"children":["Use the ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#retrieve-order","target":"_blank","rel":"noreferrer","children":"Retrieve an order"}]," endpoint with this ID to get order details, including the ",["$","code","code-0",{"children":"checkout_url"}]," for redirecting customers to the Hosted Payment Page or the ",["$","code","code-1",{"children":"token"}]," for widget integration."]}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":"The order is created in parallel to the subscription and is used to collect the initial payment and save the customer's payment method for future billing cycles."}]}]]}]]}] 7b2:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of the scheduled action."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Value","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"cancel"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"A cancellation scheduled to take effect at the end of the current billing cycle.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"change_plan_variation"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"A plan variation change scheduled to take effect at the end of the current billing cycle.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 7b3:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The reason for the scheduled action. This field is informational and does not affect how the action is processed."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Value","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"customer_request"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The action was requested by the customer.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"merchant_request"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The action was initiated by the merchant.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 7b4:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A cancellation scheduled to take effect at the end of the current billing cycle."}]]}] 7b5:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of the scheduled action."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Value","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"cancel"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"A cancellation scheduled to take effect at the end of the current billing cycle.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"change_plan_variation"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"A plan variation change scheduled to take effect at the end of the current billing cycle.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 7b6:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The reason for the scheduled action. This field is informational and does not affect how the action is processed."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Value","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"customer_request"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The action was requested by the customer.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"merchant_request"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The action was initiated by the merchant.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 7b7:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unique identifier for the subscription plan variation."}]]}] 7b8:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unique identifier for the subscription plan phase."}]]}] 7b9:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A plan variation change scheduled to take effect at the end of the current billing cycle."}]]}] 7ba:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A pending scheduled action on the subscription, applied at the end of the current billing cycle."}]]}] 7bb:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"List of subscriptions."}]]}] 7bc:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"List of subscriptions retrieved successfully"}]]}] 7bd:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An identifier that can be used to determine what went wrong."}],"\n",["$","p","p-1",{"children":"Error codes are not globally unique, but uniqueness is guaranteed within endpoints."}]]}] 7be:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Some human readable text describing what went wrong."}]]}] 7bf:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://www.unixtimestamp.com/","target":"_blank","rel":"noreferrer","children":"UNIX timestamp"}]," of the date and time the error happened."]}]]}] 7c0:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Bad Request"}]]}] 7c1:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An identifier that can be used to determine what went wrong."}],"\n",["$","p","p-1",{"children":"Error codes are not globally unique, but uniqueness is guaranteed within endpoints."}]]}] 7c2:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Some human readable text describing what went wrong."}]]}] 7c3:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://www.unixtimestamp.com/","target":"_blank","rel":"noreferrer","children":"UNIX timestamp"}]," of the date and time the error happened."]}]]}] 7c4:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unauthorized"}]]}] 7c5:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An identifier that can be used to determine what went wrong."}],"\n",["$","p","p-1",{"children":"Error codes are not globally unique, but uniqueness is guaranteed within endpoints."}]]}] 7c6:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Some human readable text describing what went wrong."}]]}] 7c7:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://www.unixtimestamp.com/","target":"_blank","rel":"noreferrer","children":"UNIX timestamp"}]," of the date and time the error happened."]}]]}] 7c8:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Error response"}]]}] 7cc:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Retrieve all subscriptions for the merchant account. You can use the query parameters for:"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Filtering","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Pagination","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["Filter the subscriptions that you want to retrieve, for example, only retrieve subscriptions created within a specific date range or with a specific external reference. ",["$","br","br-0",{}],["$","br","br-1",{}],"Parameters used for filtering:",["$","br","br-2",{}],["$","ul","ul-0",{"children":[["$","li","li-0",{"children":["$","code","code-0",{"children":"from"}]}],["$","li","li-1",{"children":["$","code","code-0",{"children":"to"}]}],["$","li","li-2",{"children":["$","code","code-0",{"children":"external_reference"}]}]]}]],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["View the subscriptions without loading all of them at once, for example, return a specified number of subscriptions per page. ",["$","br","br-0",{}],["$","br","br-1",{}],"Parameters used for pagination: ",["$","br","br-2",{}],["$","ul","ul-0",{"children":[["$","li","li-0",{"children":["$","code","code-0",{"children":"limit"}]}],["$","li","li-1",{"children":["$","code","code-0",{"children":"page_token"}]}]]}]],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 7cd:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["This parameter accepts the ",["$","a","a-0",{"href":"https://business.revolut.com/settings/apis?tab=merchant-api","target":"_blank","rel":"noreferrer","children":"Merchant API Secret key"}]," to authorise requests coming from the merchant's backend."]}],"\n",["$","p","p-1",{"children":["It ensures that ensures that each request is authenticated and authorised by verifying the secret key. The secret key should be included in all request headers as a ",["$","code","code-0",{"children":"Bearer"}]," token."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#authentication","target":"_blank","rel":"noreferrer","children":"Authentication"}]]}]}]]}]]}] 7ce:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The version of the Merchant API, specified in ",["$","code","code-0",{"children":"YYYY-MM-DD"}]," format."]}],"\n",["$","p","p-1",{"children":"If not specified, you will receive an error."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information about API versioning, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/reference/versioning/api-versions","target":"_blank","rel":"noreferrer","children":"API versions"}],"."]}]}]]}]]}] 7cf:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["Maximum number of records to return. Used for ",["$","strong","strong-0",{"children":"pagination"}],"."]}]]}] 7d0:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["Filter records created from this date/time. Used for ",["$","strong","strong-0",{"children":"filtering"}],"."]}]]}] 7d1:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["Filter records created until this date/time. Used for ",["$","strong","strong-0",{"children":"filtering"}],"."]}]]}] 7d2:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["Return subscriptions with a specific ",["$","code","code-0",{"children":"external_reference"}],". Used for ",["$","strong","strong-0",{"children":"filtering"}],"."]}]]}] 7d3:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["Token for retrieving the next page of results. Used for ",["$","strong","strong-0",{"children":"pagination"}],"."]}],"\n",["$","p","p-1",{"children":"To paginate through results:"}],"\n",["$","ol","ol-0",{"children":["\n",["$","li","li-0",{"children":["Make an initial request with the desired ",["$","code","code-0",{"children":"limit"}],"."]}],"\n",["$","li","li-1",{"children":["The response will include a ",["$","code","code-0",{"children":"next_page_token"}]," if more results are available."]}],"\n",["$","li","li-2",{"children":["Use that token in the ",["$","code","code-0",{"children":"page_token"}]," parameter of your next request."]}],"\n",["$","li","li-3",{"children":["Repeat until ",["$","code","code-0",{"children":"next_page_token"}]," is not present."]}],"\n"]}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["When using ",["$","code","code-0",{"children":"page_token"}],", you must include all query parameters from the initial request (such as ",["$","code","code-1",{"children":"from"}],", ",["$","code","code-2",{"children":"to"}],", or other filter parameters) to maintain consistent filtering across pages."]}]}]]}]]}] 817:"Update a subscription" 837:["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"id\": \"750e8400-e29b-41d4-a716-446655440000\",\n \"subscription_id\": \"550e8400-e29b-41d4-a716-446655440000\",\n \"subscription_cycle_id\": \"850e8400-e29b-41d4-a716-446655440000\",\n \"subscription_item_code\": \"api_calls\",\n \"usage_date\": \"2026-03-01T21:00:00Z\",\n \"quantity\": 100,\n \"metadata\": {\n \"user_id\": \"12345\",\n \"api_version\": \"v2\"\n },\n \"created_at\": \"2026-03-01T21:05:00Z\",\n \"updated_at\": \"2026-03-01T21:05:00Z\"\n}"}]}] 7e4:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Each Merchant API request must contain an authorization header in the following format:"}],"\n","$L83d","\n",["$","p","p-1",{"children":"To use this API, you need to generate API keys from your Revolut Business account. The Secret key is used in the authorization header for all server calls, while the Public key is provided with payment methods at checkout."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For detailed instructions on generating your API keys, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/get-started#generate-api-keys","target":"_blank","rel":"noreferrer","children":"Generate API keys"}],"."]}]}]]}]]}] 7eb:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unique identifier for the subscription."}]]}] 7ec:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Optional external reference for the subscription."}],"\n",["$","p","p-1",{"children":"Use this field to store your own system's identifier for easy tracking and correlation."}]]}] 7ed:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The state of the subscription."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"State","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"pending"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The subscription has been created but is not yet active. This typically occurs when awaiting the first payment or setup completion.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"active"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The subscription is currently active and billing cycles are processing normally.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"overdue"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The subscription has a failed payment and is awaiting resolution.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"paused"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The subscription has been temporarily paused and no billing will occur.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-4",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"cancelled"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The subscription has been cancelled and will not renew.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-5",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"finished"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The subscription has completed all billing cycles (for limited-duration subscriptions).","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 7ee:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unique identifier for the customer."}]]}] 7ef:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unique identifier for the subscription plan."}]]}] 7f0:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unique identifier for the subscription plan variation."}]]}] 7f1:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of payment method used for the subscription."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Type","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"automatic"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Payments are automatically charged to the customer's saved payment method.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"manual"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Payments require manual processing by the customer.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 7f2:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unique identifier for the payment method."}]]}] 7f3:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The date and time the subscription was created in ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_8601","target":"_blank","rel":"noreferrer","children":"ISO 8601"}]," format."]}]]}] 7f4:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The date and time the subscription was last updated in ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_8601","target":"_blank","rel":"noreferrer","children":"ISO 8601"}]," format."]}]]}] 7f5:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The date and time the subscription started in ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_8601","target":"_blank","rel":"noreferrer","children":"ISO 8601"}]," format."]}],"\n",["$","p","p-1",{"children":["This field is ",["$","code","code-0",{"children":"null"}]," until the subscription becomes active."]}]]}] 7f6:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unique identifier for the subscription cycle."}]]}] 7f7:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The trial period duration for this subscription in ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_8601#Durations","target":"_blank","rel":"noreferrer","children":"ISO 8601 duration format"}]," (e.g., \"P14D\" for 14 days)."]}],"\n",["$","h1","h1-0",{"children":"Override plan defaults"}],"\n",["$","p","p-1",{"children":"Subscription plans can define a default trial duration. When creating a subscription, you can use this field to override the plan's default trial period:"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Field value","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Behaviour","className":"eowryt6","ref":"$undefined"}],["$","th","th-2",{"children":"Example","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","strong","strong-0",{"children":"Not provided"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Uses the trial duration defined in the plan (if any)","className":"eowryt7","ref":"$undefined"}],["$","td","td-2",{"children":["Plan has ",["$","code","code-0",{"children":"\"P7D\""}]," → subscription gets 7-day trial"],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","strong","strong-0",{"children":"Different value"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Overrides the plan's default trial duration","className":"eowryt7","ref":"$undefined"}],["$","td","td-2",{"children":["Plan has ",["$","code","code-0",{"children":"\"P7D\""}]," → set to ",["$","code","code-1",{"children":"\"P30D\""}]," for promotional offer, or ",["$","code","code-2",{"children":"\"P3D\""}]," to reduce"],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","strong","strong-0",{"children":["$","code","code-0",{"children":"\"P0D\""}]}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Explicitly skips the trial period","className":"eowryt7","ref":"$undefined"}],["$","td","td-2",{"children":["Plan has ",["$","code","code-0",{"children":"\"P7D\""}]," → set to ",["$","code","code-1",{"children":"\"P0D\""}]," to skip trial entirely"],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["Only days (",["$","code","code-0",{"children":"D"}],") are allowed. Time components such as hours, minutes, or seconds are not permitted."]}]}]]}]]}] 7f8:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The date and time when the subscription's trial period ends in ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_8601","target":"_blank","rel":"noreferrer","children":"ISO 8601"}]," format."]}],"\n",["$","p","p-1",{"children":["This value is automatically calculated by the system as: ",["$","code","code-0",{"children":"start_date"}]," + ",["$","code","code-1",{"children":"trial_duration"}]]}],"\n",["$","p","p-2",{"children":["The ",["$","code","code-0",{"children":"trial_duration"}]," used in the calculation comes from either:"]}],"\n",["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["The subscription's custom ",["$","code","code-0",{"children":"trial_duration"}]," (if provided at creation time), or"]}],"\n",["$","li","li-1",{"children":["The plan's default ",["$","code","code-0",{"children":"trial_duration"}]," (if no override was specified)"]}],"\n"]}],"\n",["$","p","p-3",{"children":["This field is ",["$","code","code-0",{"children":"null"}]," when the subscription has no trial period (e.g., when ",["$","code","code-1",{"children":"trial_duration"}]," is not set or is ",["$","code","code-2",{"children":"\"P0D\""}],")."]}]]}] 7f9:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The ID of the order created for handling the setup payment for the subscription."}],"\n",["$","p","p-1",{"children":["Use the ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#retrieve-order","target":"_blank","rel":"noreferrer","children":"Retrieve an order"}]," endpoint with this ID to get order details, including the ",["$","code","code-0",{"children":"checkout_url"}]," for redirecting customers to the Hosted Payment Page or the ",["$","code","code-1",{"children":"token"}]," for widget integration."]}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":"The order is created in parallel to the subscription and is used to collect the initial payment and save the customer's payment method for future billing cycles."}]}]]}]]}] 7fa:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of the scheduled action."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Value","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"cancel"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"A cancellation scheduled to take effect at the end of the current billing cycle.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"change_plan_variation"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"A plan variation change scheduled to take effect at the end of the current billing cycle.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 7fb:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The reason for the scheduled action. This field is informational and does not affect how the action is processed."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Value","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"customer_request"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The action was requested by the customer.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"merchant_request"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The action was initiated by the merchant.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 7fc:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A cancellation scheduled to take effect at the end of the current billing cycle."}]]}] 7fd:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of the scheduled action."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Value","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"cancel"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"A cancellation scheduled to take effect at the end of the current billing cycle.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"change_plan_variation"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"A plan variation change scheduled to take effect at the end of the current billing cycle.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 7fe:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The reason for the scheduled action. This field is informational and does not affect how the action is processed."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Value","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"customer_request"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The action was requested by the customer.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"merchant_request"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The action was initiated by the merchant.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 7ff:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unique identifier for the subscription plan variation."}]]}] 800:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unique identifier for the subscription plan phase."}]]}] 801:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A plan variation change scheduled to take effect at the end of the current billing cycle."}]]}] 802:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A pending scheduled action on the subscription, applied at the end of the current billing cycle."}]]}] 803:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Subscription updated successfully"}]]}] 804:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An identifier that can be used to determine what went wrong."}],"\n",["$","p","p-1",{"children":"Error codes are not globally unique, but uniqueness is guaranteed within endpoints."}]]}] 805:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Some human readable text describing what went wrong."}]]}] 806:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://www.unixtimestamp.com/","target":"_blank","rel":"noreferrer","children":"UNIX timestamp"}]," of the date and time the error happened."]}]]}] 807:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Bad Request"}]]}] 808:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An identifier that can be used to determine what went wrong."}],"\n",["$","p","p-1",{"children":"Error codes are not globally unique, but uniqueness is guaranteed within endpoints."}]]}] 809:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Some human readable text describing what went wrong."}]]}] 80a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://www.unixtimestamp.com/","target":"_blank","rel":"noreferrer","children":"UNIX timestamp"}]," of the date and time the error happened."]}]]}] 80b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unauthorized"}]]}] 80c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An identifier that can be used to determine what went wrong."}],"\n",["$","p","p-1",{"children":"Error codes are not globally unique, but uniqueness is guaranteed within endpoints."}]]}] 80d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Some human readable text describing what went wrong."}]]}] 80e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://www.unixtimestamp.com/","target":"_blank","rel":"noreferrer","children":"UNIX timestamp"}]," of the date and time the error happened."]}]]}] 80f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Subscription not found"}]]}] 810:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An identifier that can be used to determine what went wrong."}],"\n",["$","p","p-1",{"children":"Error codes are not globally unique, but uniqueness is guaranteed within endpoints."}]]}] 811:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Some human readable text describing what went wrong."}]]}] 812:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://www.unixtimestamp.com/","target":"_blank","rel":"noreferrer","children":"UNIX timestamp"}]," of the date and time the error happened."]}]]}] 813:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Error response"}]]}] 814:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Optional external reference for the subscription."}],"\n",["$","p","p-1",{"children":"Use this field to store your own system's identifier for easy tracking and correlation."}]]}] 818:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Update a subscription's details."}],"\n",["$","p","p-1",{"children":["You can update a subscription and specific parameters based on the value of the ",["$","code","code-0",{"children":"state"}]," parameter:"]}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"State parameter value","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Modifiable parameters","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":[["$","code","code-0",{"children":"pending"}],", ",["$","code","code-1",{"children":"active"}],", ",["$","code","code-2",{"children":"overdue"}],", ",["$","code","code-3",{"children":"paused"}]],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"You can modify all listed parameters.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":[["$","code","code-0",{"children":"cancelled"}],", ",["$","code","code-1",{"children":"finished"}]],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"You cannot modify parameters. These are final states.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}],"\n",["$","p","p-2",{"children":["$","strong","strong-0",{"children":"Common use cases:"}]}],"\n",["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":[["$","strong","strong-0",{"children":"Update external reference"}],": When you need to sync with updated customer records in your system, correct an initial reference value, or re-map the subscription to a different internal tracking ID to maintain consistency with your database."]}],"\n"]}]]}] 819:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["This parameter accepts the ",["$","a","a-0",{"href":"https://business.revolut.com/settings/apis?tab=merchant-api","target":"_blank","rel":"noreferrer","children":"Merchant API Secret key"}]," to authorise requests coming from the merchant's backend."]}],"\n",["$","p","p-1",{"children":["It ensures that ensures that each request is authenticated and authorised by verifying the secret key. The secret key should be included in all request headers as a ",["$","code","code-0",{"children":"Bearer"}]," token."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#authentication","target":"_blank","rel":"noreferrer","children":"Authentication"}]]}]}]]}]]}] 81a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The version of the Merchant API, specified in ",["$","code","code-0",{"children":"YYYY-MM-DD"}]," format."]}],"\n",["$","p","p-1",{"children":"If not specified, you will receive an error."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information about API versioning, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/reference/versioning/api-versions","target":"_blank","rel":"noreferrer","children":"API versions"}],"."]}]}]]}]]}] 81b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A UUID string, typically used to identify resources."}]]}] 81c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The ID of the subscription."}]]}] 82d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Each Merchant API request must contain an authorization header in the following format:"}],"\n","$L83e","\n",["$","p","p-1",{"children":"To use this API, you need to generate API keys from your Revolut Business account. The Secret key is used in the authorization header for all server calls, while the Public key is provided with payment methods at checkout."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For detailed instructions on generating your API keys, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/get-started#generate-api-keys","target":"_blank","rel":"noreferrer","children":"Generate API keys"}],"."]}]}]]}]]}] 83f:T1166,
{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "external_reference": "ext-ref-12345",
  "state": "active",
  "customer_id": "650e8400-e29b-41d4-a716-446655440001",
  "plan_id": "750e8400-e29b-41d4-a716-446655440002",
  "plan_variation_id": "850e8400-e29b-41d4-a716-446655440003",
  "payment_method_type": "automatic",
  "payment_method_id": "6689e244-8af7-4ada-9448-a91f02d4f192",
  "created_at": "2025-06-05T21:00:00.036001Z",
  "updated_at": "2025-06-05T21:00:00.036001Z",
  "start_date": "2025-06-05T21:00:00.036001Z",
  "current_cycle_id": "950e8400-e29b-41d4-a716-446655440004",
  "trial_duration": "P14D",
  "trial_end_date": "2025-06-19T21:00:00.036001Z"
}
75a:["$","div","200-application/json-active_subscription",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$83f"}}]}]],"$L840"]}] 841:T44d,
{
  "code": "string",
  "message": "string",
  "timestamp": 123
}
75b:["$","div","400-application/json-default",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$841"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"code\": \"string\",\n \"message\": \"string\",\n \"timestamp\": 123\n}"}]}]]}] 842:T44d,
{
  "code": "string",
  "message": "string",
  "timestamp": 123
}
75c:["$","div","401-application/json-default",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$842"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"code\": \"string\",\n \"message\": \"string\",\n \"timestamp\": 123\n}"}]}]]}] 843:T44d,
{
  "code": "string",
  "message": "string",
  "timestamp": 123
}
75d:["$","div","404-application/json-default",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$843"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"code\": \"string\",\n \"message\": \"string\",\n \"timestamp\": 123\n}"}]}]]}] 844:T44d,
{
  "code": "string",
  "message": "string",
  "timestamp": 123
}
75e:["$","div","default-application/json-default",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$844"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"code\": \"string\",\n \"message\": \"string\",\n \"timestamp\": 123\n}"}]}]]}] 840:["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"id\": \"550e8400-e29b-41d4-a716-446655440000\",\n \"external_reference\": \"ext-ref-12345\",\n \"state\": \"active\",\n \"customer_id\": \"650e8400-e29b-41d4-a716-446655440001\",\n \"plan_id\": \"750e8400-e29b-41d4-a716-446655440002\",\n \"plan_variation_id\": \"850e8400-e29b-41d4-a716-446655440003\",\n \"payment_method_type\": \"automatic\",\n \"payment_method_id\": \"6689e244-8af7-4ada-9448-a91f02d4f192\",\n \"created_at\": \"2025-06-05T21:00:00.036001Z\",\n \"updated_at\": \"2025-06-05T21:00:00.036001Z\",\n \"start_date\": \"2025-06-05T21:00:00.036001Z\",\n \"current_cycle_id\": \"950e8400-e29b-41d4-a716-446655440004\",\n \"trial_duration\": \"P14D\",\n \"trial_end_date\": \"2025-06-19T21:00:00.036001Z\"\n}"}]}] 796:["$","div","CodeBlock-0",{"className":"wzy01m0 _18b50nc0","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"
'Authorization: Bearer <yourSecretApiKey>'
"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"'Authorization: Bearer '\n"}]}]]}] 32:["$","$7a","create-subscription",{"children":[["$","section",null,{"className":"y9a0do0","data-variant":"endpoint","children":["$","$L7b",null,{"responses":{"201":{"description":"Subscription created successfully","content":{"application/json":{"schema":{"type":"object","required":"$34:props:children:0:props:children:props:responses:200:content:application/json:schema:required","properties":{"id":{"type":"string","format":"uuid","description":"Unique identifier for the subscription.","descriptionNode":"$L845"},"external_reference":{"type":"string","maxLength":1024,"description":"Optional external reference for the subscription.\n\nUse this field to store your own system's identifier for easy tracking and correlation.","descriptionNode":"$L846"},"state":{"type":"string","enum":"$34:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:state:enum","description":"The state of the subscription.\n\n| State | Description |\n| ----- | ----------- |\n| `pending` | The subscription has been created but is not yet active. This typically occurs when awaiting the first payment or setup completion. |\n| `active` | The subscription is currently active and billing cycles are processing normally. |\n| `overdue` | The subscription has a failed payment and is awaiting resolution. |\n| `paused` | The subscription has been temporarily paused and no billing will occur. |\n| `cancelled` | The subscription has been cancelled and will not renew. |\n| `finished` | The subscription has completed all billing cycles (for limited-duration subscriptions). |","descriptionNode":"$L847"},"customer_id":{"type":"string","format":"uuid","description":"Unique identifier for the customer.","descriptionNode":"$L848"},"plan_id":{"type":"string","format":"uuid","description":"Unique identifier for the subscription plan.","descriptionNode":"$L849"},"plan_variation_id":{"type":"string","format":"uuid","description":"Unique identifier for the subscription plan variation.","descriptionNode":"$L84a"},"payment_method_type":{"type":"string","enum":"$34:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method_type:enum","description":"The type of payment method used for the subscription.\n\n| Type | Description |\n| ---- | ----------- |\n| `automatic` | Payments are automatically charged to the customer's saved payment method. |\n| `manual` | Payments require manual processing by the customer. |","descriptionNode":"$L84b"},"payment_method_id":{"type":"string","format":"uuid","description":"Unique identifier for the payment method.","descriptionNode":"$L84c"},"created_at":{"type":"string","format":"date-time","description":"The date and time the subscription was created in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format.","descriptionNode":"$L84d"},"updated_at":{"type":"string","format":"date-time","description":"The date and time the subscription was last updated in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format.","descriptionNode":"$L84e"},"start_date":{"type":"$34:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:start_date:type","format":"date-time","description":"The date and time the subscription started in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format.\n\nThis field is `null` until the subscription becomes active.","descriptionNode":"$L84f"},"current_cycle_id":{"type":"string","format":"uuid","description":"Unique identifier for the subscription cycle.","descriptionNode":"$L850"},"trial_duration":{"type":"string","format":"duration","description":"The trial period duration for this subscription in [ISO 8601 duration format](https://en.wikipedia.org/wiki/ISO_8601#Durations) (e.g., \"P14D\" for 14 days).\n\n### Override plan defaults\n\nSubscription plans can define a default trial duration. When creating a subscription, you can use this field to override the plan's default trial period:\n\n| Field value | Behaviour | Example |\n| ----------- | -------- | ------- |\n| **Not provided** | Uses the trial duration defined in the plan (if any) | Plan has `\"P7D\"` → subscription gets 7-day trial |\n| **Different value** | Overrides the plan's default trial duration | Plan has `\"P7D\"` → set to `\"P30D\"` for promotional offer, or `\"P3D\"` to reduce |\n| **`\"P0D\"`** | Explicitly skips the trial period | Plan has `\"P7D\"` → set to `\"P0D\"` to skip trial entirely |\n\n:::note\nOnly days (`D`) are allowed. Time components such as hours, minutes, or seconds are not permitted.\n:::","pattern":"^P[0-9]+D$","examples":"$34:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:trial_duration:examples","descriptionNode":"$L851"},"trial_end_date":{"type":"$34:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:trial_end_date:type","format":"date-time","description":"The date and time when the subscription's trial period ends in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format.\n\nThis value is automatically calculated by the system as: `start_date` + `trial_duration`\n\nThe `trial_duration` used in the calculation comes from either:\n- The subscription's custom `trial_duration` (if provided at creation time), or\n- The plan's default `trial_duration` (if no override was specified)\n\nThis field is `null` when the subscription has no trial period (e.g., when `trial_duration` is not set or is `\"P0D\"`).","examples":"$34:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:trial_end_date:examples","descriptionNode":"$L852"},"setup_order_id":{"type":"string","format":"uuid","description":"The ID of the order created for handling the setup payment for the subscription.\n\nUse the [Retrieve an order](https://developer.revolut.com/docs/api/merchant#retrieve-order) endpoint with this ID to get order details, including the `checkout_url` for redirecting customers to the Hosted Payment Page or the `token` for widget integration.\n\n:::note\nThe order is created in parallel to the subscription and is used to collect the initial payment and save the customer's payment method for future billing cycles.\n:::","descriptionNode":"$L853"},"scheduled_action":{"description":"A pending scheduled action on the subscription, applied at the end of the current billing cycle.","type":"object","discriminator":"$34:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:scheduled_action:discriminator","oneOf":[{"title":"Subscription-Scheduled-Action-Cancel","type":"object","description":"A cancellation scheduled to take effect at the end of the current billing cycle.","required":"$34:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:scheduled_action:oneOf:0:required","properties":{"type":{"type":"string","description":"The type of the scheduled action.\n\n| Value | Description |\n| ----- | ----------- |\n| `cancel` | A cancellation scheduled to take effect at the end of the current billing cycle. |\n| `change_plan_variation` | A plan variation change scheduled to take effect at the end of the current billing cycle. |","enum":"$34:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:scheduled_action:oneOf:0:properties:type:enum","examples":"$34:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:scheduled_action:oneOf:0:properties:type:examples","descriptionNode":"$L854"},"reason":{"type":"string","description":"The reason for the scheduled action. This field is informational and does not affect how the action is processed.\n\n| Value | Description |\n| ----- | ----------- |\n| `customer_request` | The action was requested by the customer. |\n| `merchant_request` | The action was initiated by the merchant. |","enum":"$37:props:children:0:props:children:props:requestBody:content:application/json:schema:properties:reason:enum","default":"merchant_request","examples":"$37:props:children:0:props:children:props:requestBody:content:application/json:schema:properties:reason:examples","descriptionNode":"$L855"}},"descriptionNode":"$L856"},{"title":"Subscription-Scheduled-Action-Change-Plan","type":"object","description":"A plan variation change scheduled to take effect at the end of the current billing cycle.","required":"$34:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:scheduled_action:oneOf:1:required","properties":{"type":{"type":"string","description":"The type of the scheduled action.\n\n| Value | Description |\n| ----- | ----------- |\n| `cancel` | A cancellation scheduled to take effect at the end of the current billing cycle. |\n| `change_plan_variation` | A plan variation change scheduled to take effect at the end of the current billing cycle. |","enum":"$34:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:scheduled_action:oneOf:0:properties:type:enum","examples":"$34:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:scheduled_action:oneOf:0:properties:type:examples","descriptionNode":"$L857"},"reason":{"type":"string","description":"The reason for the scheduled action. This field is informational and does not affect how the action is processed.\n\n| Value | Description |\n| ----- | ----------- |\n| `customer_request` | The action was requested by the customer. |\n| `merchant_request` | The action was initiated by the merchant. |","enum":"$37:props:children:0:props:children:props:requestBody:content:application/json:schema:properties:reason:enum","default":"merchant_request","examples":"$37:props:children:0:props:children:props:requestBody:content:application/json:schema:properties:reason:examples","descriptionNode":"$L858"},"plan_variation_id":{"type":"string","format":"uuid","description":"Unique identifier for the subscription plan variation.","descriptionNode":"$L859"},"plan_variation_phase_id":{"type":"string","format":"uuid","description":"Unique identifier for the subscription plan phase.","descriptionNode":"$L85a"}},"descriptionNode":"$L85b"}],"descriptionNode":"$L85c"}}},"examples":{"with_setup_order":{"summary":"Subscription created with setup order","value":{"id":"550e8400-e29b-41d4-a716-446655440000","external_reference":"ext-ref-12345","state":"pending","customer_id":"650e8400-e29b-41d4-a716-446655440001","plan_id":"750e8400-e29b-41d4-a716-446655440002","plan_variation_id":"850e8400-e29b-41d4-a716-446655440003","payment_method_type":"automatic","created_at":"2025-06-05T21:00:00.036001Z","updated_at":"2025-06-05T21:00:00.036001Z","setup_order_id":"a50e8400-e29b-41d4-a716-446655440005","current_cycle_id":"a31627fb-b037-4566-8d7b-f380c1f44653"}},"with_setup_order_no_url":{"summary":"Subscription created with setup order (no redirect URL)","value":{"id":"550e8400-e29b-41d4-a716-446655440006","external_reference":"ext-ref-12345","state":"pending","customer_id":"650e8400-e29b-41d4-a716-446655440001","plan_id":"750e8400-e29b-41d4-a716-446655440002","plan_variation_id":"850e8400-e29b-41d4-a716-446655440003","payment_method_type":"automatic","created_at":"2025-06-05T21:00:00.036001Z","updated_at":"2025-06-05T21:00:00.036001Z","setup_order_id":"a50e8400-e29b-41d4-a716-446655440007","current_cycle_id":"a31627fb-b037-4566-8d7b-f380c1f44654"}}}}},"descriptionNode":"$L85d"},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"code":{"type":"string","description":"An identifier that can be used to determine what went wrong.\n\nError codes are not globally unique, but uniqueness is guaranteed within endpoints.","descriptionNode":"$L85e"},"message":{"type":"string","description":"Some human readable text describing what went wrong.","descriptionNode":"$L85f"},"timestamp":{"type":"integer","description":"The [UNIX timestamp](https://www.unixtimestamp.com/) of the date and time the error happened.","descriptionNode":"$L860"}}}}},"descriptionNode":"$L861"},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"code":{"type":"string","description":"An identifier that can be used to determine what went wrong.\n\nError codes are not globally unique, but uniqueness is guaranteed within endpoints.","descriptionNode":"$L862"},"message":{"type":"string","description":"Some human readable text describing what went wrong.","descriptionNode":"$L863"},"timestamp":{"type":"integer","description":"The [UNIX timestamp](https://www.unixtimestamp.com/) of the date and time the error happened.","descriptionNode":"$L864"}}}}},"descriptionNode":"$L865"},"default":{"description":"Error response","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"code":{"type":"string","description":"An identifier that can be used to determine what went wrong.\n\nError codes are not globally unique, but uniqueness is guaranteed within endpoints.","descriptionNode":"$L866"},"message":{"type":"string","description":"Some human readable text describing what went wrong.","descriptionNode":"$L867"},"timestamp":{"type":"integer","description":"The [UNIX timestamp](https://www.unixtimestamp.com/) of the date and time the error happened.","descriptionNode":"$L868"}}}}},"descriptionNode":"$L869"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["plan_variation_id","customer_id"],"properties":{"plan_variation_id":{"type":"string","format":"uuid","description":"Unique identifier for the subscription plan variation.","descriptionNode":"$L86a"},"customer_id":{"type":"string","format":"uuid","description":"Unique identifier for the customer.","descriptionNode":"$L86b"},"external_reference":{"type":"string","maxLength":1024,"description":"Optional external reference for the subscription.\n\nUse this field to store your own system's identifier for easy tracking and correlation.","descriptionNode":"$L86c"},"setup_order_redirect_url":{"type":"string","format":"uri","pattern":"^https?:\\/{2}.+/gi","maxLength":2000,"description":"The URL to which the customer is redirected after completing the setup order on the Revolut Hosted Payment Page.\n\nWhen provided, the response will include a `setup_order_id`. Use the [Retrieve an order](https://developer.revolut.com/docs/api/merchant#retrieve-order) endpoint with this `setup_order_id` to get the `checkout_url` for redirecting the customer to the Hosted Payment Page.\n\n:::warning\nRestrictions:\n- Must be a valid URI as defined by [RFC 3986](https://datatracker.ietf.org/doc/html/rfc3986)\n- URI scheme is required and must be either `http` or `https`\n- URI host is required and cannot be `localhost` or an IP address\n- Max length: `2000`\n- Reserved or invalid characters must be percent-encoded (for example, use `%20` instead of a space)\n:::","descriptionNode":"$L86d"},"trial_duration":{"type":"string","format":"duration","description":"The trial period duration for this subscription in [ISO 8601 duration format](https://en.wikipedia.org/wiki/ISO_8601#Durations) (e.g., \"P14D\" for 14 days).\n\n### Override plan defaults\n\nSubscription plans can define a default trial duration. When creating a subscription, you can use this field to override the plan's default trial period:\n\n| Field value | Behaviour | Example |\n| ----------- | -------- | ------- |\n| **Not provided** | Uses the trial duration defined in the plan (if any) | Plan has `\"P7D\"` → subscription gets 7-day trial |\n| **Different value** | Overrides the plan's default trial duration | Plan has `\"P7D\"` → set to `\"P30D\"` for promotional offer, or `\"P3D\"` to reduce |\n| **`\"P0D\"`** | Explicitly skips the trial period | Plan has `\"P7D\"` → set to `\"P0D\"` to skip trial entirely |\n\n:::note\nOnly days (`D`) are allowed. Time components such as hours, minutes, or seconds are not permitted.\n:::","pattern":"^P[0-9]+D$","examples":"$34:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:trial_duration:examples","descriptionNode":"$L86e"}}},"examples":{"with_setup_order":{"summary":"Subscription with redirect URL","value":{"plan_variation_id":"550e8400-e29b-41d4-a716-446655440000","customer_id":"650e8400-e29b-41d4-a716-446655440001","setup_order_redirect_url":"https://example.com/subscription/setup/complete","external_reference":"ext-ref-12345"}},"with_setup_order_no_url":{"summary":"Subscription without redirect URL","value":{"plan_variation_id":"550e8400-e29b-41d4-a716-446655440000","customer_id":"650e8400-e29b-41d4-a716-446655440001","external_reference":"ext-ref-12345"}},"with_trial":{"summary":"Subscription with trial period overriding the trial duration from plan","value":{"plan_variation_id":"550e8400-e29b-41d4-a716-446655440000","customer_id":"650e8400-e29b-41d4-a716-446655440001","payment_method_id":"6689e244-8af7-4ada-9448-a91f02d4f192","trial_duration":"P14D","external_reference":"ext-ref-12345"}},"skip_trial":{"summary":"Subscription skipping trial predefined in plan","value":{"plan_variation_id":"550e8400-e29b-41d4-a716-446655440000","customer_id":"650e8400-e29b-41d4-a716-446655440001","payment_method_id":"6689e244-8af7-4ada-9448-a91f02d4f192","trial_duration":"P0D","external_reference":"ext-ref-12345"}}}}}},"variantLabels":["Subscription created with setup order","Subscription created with setup order (no redirect URL)"],"children":["$L86f","$L870"]}]}],false]}] 86f:["$","div",null,{"className":"ezz1n30","children":[["$","div",null,{"data-header":"$undefined","className":"ezz1n31","children":["$","div",null,{"className":"y9a0do1","children":[["$","h2",null,{"id":"create-subscription","children":[["$L871","$undefined"],["$","$L15",null,{"id":"create-subscription"}]]}],["$","$L16",null,{"url":"/docs/api/merchant/2025-10-16/operations/create-subscription.md"}]]}]}],"$undefined"]}] 876:T8ea,
curl -X POST "https://merchant.revolut.com/api/subscriptions" \
  -H "Content-Type: application/json" \
  -H "Authorization: __RP_TOK_0__" \
  -H "Revolut-Api-Version: __RP_TOK_1__" \
  -H "Idempotency-Key: __RP_TOK_2__" \
  -d '{
  "plan_variation_id": "550e8400-e29b-41d4-a716-446655440000",
  "customer_id": "650e8400-e29b-41d4-a716-446655440001",
  "setup_order_redirect_url": "https://example.com/subscription/setup/complete",
  "external_reference": "ext-ref-12345"
}'
877:T1363,
const payload = {
  "plan_variation_id": "550e8400-e29b-41d4-a716-446655440000",
  "customer_id": "650e8400-e29b-41d4-a716-446655440001",
  "setup_order_redirect_url": "https://example.com/subscription/setup/complete",
  "external_reference": "ext-ref-12345"
};
fetch("https://merchant.revolut.com/api/subscriptions", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "__RP_TOK_0__",
    "Revolut-Api-Version": "__RP_TOK_1__",
    "Idempotency-Key": "__RP_TOK_2__"
  },
  body: JSON.stringify(payload)
})
  .then(response => response.json())
  .then(data => console.log(data));
878:T19bc,
package main

import (
  "fmt"
  "net/http"
  "bytes"
  "encoding/json"
)

func main() {
  url := "https://merchant.revolut.com/api/subscriptions"
  jsonData := []byte(`
{
  "plan_variation_id": "550e8400-e29b-41d4-a716-446655440000",
  "customer_id": "650e8400-e29b-41d4-a716-446655440001",
  "setup_order_redirect_url": "https://example.com/subscription/setup/complete",
  "external_reference": "ext-ref-12345"
}
  `)
  req, _ := http.NewRequest("POST", url, bytes.NewBuffer(jsonData))
  req.Header.Add("Content-Type", "application/json")
  req.Header.Add("Authorization", "__RP_TOK_0__")
  req.Header.Add("Revolut-Api-Version", "__RP_TOK_1__")
  req.Header.Add("Idempotency-Key", "__RP_TOK_2__")

  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  fmt.Println(res)
}
879:T1095,
import requests

url = "https://merchant.revolut.com/api/subscriptions"
headers = {
  "Content-Type": "application/json",
  "Authorization": "__RP_TOK_0__",
  "Revolut-Api-Version": "__RP_TOK_1__",
  "Idempotency-Key": "__RP_TOK_2__"
}
payload = {
  "plan_variation_id": "550e8400-e29b-41d4-a716-446655440000",
  "customer_id": "650e8400-e29b-41d4-a716-446655440001",
  "setup_order_redirect_url": "https://example.com/subscription/setup/complete",
  "external_reference": "ext-ref-12345"
}

response = requests.post(url, headers=headers, json=payload)
print(response.json())
87a:T433,import java.net.http.HttpClient; import java.net.http.HttpRequest; import java.net.http.HttpResponse; import java.net.URI; public class Main { public static void main(String[] args) { HttpClient client = HttpClient.newHttpClient(); String body = """ { "plan_variation_id": "550e8400-e29b-41d4-a716-446655440000", "customer_id": "650e8400-e29b-41d4-a716-446655440001", "setup_order_redirect_url": "https://example.com/subscription/setup/complete", "external_reference": "ext-ref-12345" } """; HttpRequest request = HttpRequest.newBuilder() .uri(URI.create("https://merchant.revolut.com/api/subscriptions")) .header("Content-Type", "application/json") .header("Authorization", "__RP_TOK_0__") .header("Revolut-Api-Version", "__RP_TOK_1__") .header("Idempotency-Key", "__RP_TOK_2__") .POST(HttpRequest.BodyPublishers.ofString(body)) .build(); client.sendAsync(request, HttpResponse.BodyHandlers.ofString()) .thenApply(HttpResponse::body) .thenAccept(System.out::println) .join(); } }87b:T1f1d,
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;

public class Main {
  public static void main(String[] args) {
    HttpClient client = HttpClient.newHttpClient();
    String body = """
{
  "plan_variation_id": "550e8400-e29b-41d4-a716-446655440000",
  "customer_id": "650e8400-e29b-41d4-a716-446655440001",
  "setup_order_redirect_url": "https://example.com/subscription/setup/complete",
  "external_reference": "ext-ref-12345"
}
    """;

    HttpRequest request = HttpRequest.newBuilder()
      .uri(URI.create("https://merchant.revolut.com/api/subscriptions"))
      .header("Content-Type", "application/json")
      .header("Authorization", "__RP_TOK_0__")
      .header("Revolut-Api-Version", "__RP_TOK_1__")
      .header("Idempotency-Key", "__RP_TOK_2__")
      .POST(HttpRequest.BodyPublishers.ofString(body))
      .build();

    client.sendAsync(request, HttpResponse.BodyHandlers.ofString())
      .thenApply(HttpResponse::body)
      .thenAccept(System.out::println)
      .join();
  }
}
87c:T2533,
using System.Net.Http;
using System.Net.Http.Headers;

var client = new HttpClient();
var request = new HttpRequestMessage
{
  Method = HttpMethod.Post,
  RequestUri = new Uri("https://merchant.revolut.com/api/subscriptions"),
  Headers =
  {
    { "Authorization", "__RP_TOK_0__" },
    { "Revolut-Api-Version", "__RP_TOK_1__" },
    { "Idempotency-Key", "__RP_TOK_2__" },
  },
  Content = new StringContent(@"{
  ""plan_variation_id"": ""550e8400-e29b-41d4-a716-446655440000"",
  ""customer_id"": ""650e8400-e29b-41d4-a716-446655440001"",
  ""setup_order_redirect_url"": ""https://example.com/subscription/setup/complete"",
  ""external_reference"": ""ext-ref-12345""
}")
  {
    Headers =
    {
      ContentType = new MediaTypeHeaderValue("application/json")
    }
  }
};

using (var response = await client.SendAsync(request))
{
  response.EnsureSuccessStatusCode();
  var body = await response.Content.ReadAsStringAsync();
  Console.WriteLine(body);
}
87d:T8f2,
curl -X POST "https://sandbox-merchant.revolut.com/api/subscriptions" \
  -H "Content-Type: application/json" \
  -H "Authorization: __RP_TOK_0__" \
  -H "Revolut-Api-Version: __RP_TOK_1__" \
  -H "Idempotency-Key: __RP_TOK_2__" \
  -d '{
  "plan_variation_id": "550e8400-e29b-41d4-a716-446655440000",
  "customer_id": "650e8400-e29b-41d4-a716-446655440001",
  "setup_order_redirect_url": "https://example.com/subscription/setup/complete",
  "external_reference": "ext-ref-12345"
}'
87e:T136b,
const payload = {
  "plan_variation_id": "550e8400-e29b-41d4-a716-446655440000",
  "customer_id": "650e8400-e29b-41d4-a716-446655440001",
  "setup_order_redirect_url": "https://example.com/subscription/setup/complete",
  "external_reference": "ext-ref-12345"
};
fetch("https://sandbox-merchant.revolut.com/api/subscriptions", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "__RP_TOK_0__",
    "Revolut-Api-Version": "__RP_TOK_1__",
    "Idempotency-Key": "__RP_TOK_2__"
  },
  body: JSON.stringify(payload)
})
  .then(response => response.json())
  .then(data => console.log(data));
87f:T19c4,
package main

import (
  "fmt"
  "net/http"
  "bytes"
  "encoding/json"
)

func main() {
  url := "https://sandbox-merchant.revolut.com/api/subscriptions"
  jsonData := []byte(`
{
  "plan_variation_id": "550e8400-e29b-41d4-a716-446655440000",
  "customer_id": "650e8400-e29b-41d4-a716-446655440001",
  "setup_order_redirect_url": "https://example.com/subscription/setup/complete",
  "external_reference": "ext-ref-12345"
}
  `)
  req, _ := http.NewRequest("POST", url, bytes.NewBuffer(jsonData))
  req.Header.Add("Content-Type", "application/json")
  req.Header.Add("Authorization", "__RP_TOK_0__")
  req.Header.Add("Revolut-Api-Version", "__RP_TOK_1__")
  req.Header.Add("Idempotency-Key", "__RP_TOK_2__")

  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  fmt.Println(res)
}
880:T109d,
import requests

url = "https://sandbox-merchant.revolut.com/api/subscriptions"
headers = {
  "Content-Type": "application/json",
  "Authorization": "__RP_TOK_0__",
  "Revolut-Api-Version": "__RP_TOK_1__",
  "Idempotency-Key": "__RP_TOK_2__"
}
payload = {
  "plan_variation_id": "550e8400-e29b-41d4-a716-446655440000",
  "customer_id": "650e8400-e29b-41d4-a716-446655440001",
  "setup_order_redirect_url": "https://example.com/subscription/setup/complete",
  "external_reference": "ext-ref-12345"
}

response = requests.post(url, headers=headers, json=payload)
print(response.json())
881:T43b,import java.net.http.HttpClient; import java.net.http.HttpRequest; import java.net.http.HttpResponse; import java.net.URI; public class Main { public static void main(String[] args) { HttpClient client = HttpClient.newHttpClient(); String body = """ { "plan_variation_id": "550e8400-e29b-41d4-a716-446655440000", "customer_id": "650e8400-e29b-41d4-a716-446655440001", "setup_order_redirect_url": "https://example.com/subscription/setup/complete", "external_reference": "ext-ref-12345" } """; HttpRequest request = HttpRequest.newBuilder() .uri(URI.create("https://sandbox-merchant.revolut.com/api/subscriptions")) .header("Content-Type", "application/json") .header("Authorization", "__RP_TOK_0__") .header("Revolut-Api-Version", "__RP_TOK_1__") .header("Idempotency-Key", "__RP_TOK_2__") .POST(HttpRequest.BodyPublishers.ofString(body)) .build(); client.sendAsync(request, HttpResponse.BodyHandlers.ofString()) .thenApply(HttpResponse::body) .thenAccept(System.out::println) .join(); } }882:T1f25,
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;

public class Main {
  public static void main(String[] args) {
    HttpClient client = HttpClient.newHttpClient();
    String body = """
{
  "plan_variation_id": "550e8400-e29b-41d4-a716-446655440000",
  "customer_id": "650e8400-e29b-41d4-a716-446655440001",
  "setup_order_redirect_url": "https://example.com/subscription/setup/complete",
  "external_reference": "ext-ref-12345"
}
    """;

    HttpRequest request = HttpRequest.newBuilder()
      .uri(URI.create("https://sandbox-merchant.revolut.com/api/subscriptions"))
      .header("Content-Type", "application/json")
      .header("Authorization", "__RP_TOK_0__")
      .header("Revolut-Api-Version", "__RP_TOK_1__")
      .header("Idempotency-Key", "__RP_TOK_2__")
      .POST(HttpRequest.BodyPublishers.ofString(body))
      .build();

    client.sendAsync(request, HttpResponse.BodyHandlers.ofString())
      .thenApply(HttpResponse::body)
      .thenAccept(System.out::println)
      .join();
  }
}
883:T253b,
using System.Net.Http;
using System.Net.Http.Headers;

var client = new HttpClient();
var request = new HttpRequestMessage
{
  Method = HttpMethod.Post,
  RequestUri = new Uri("https://sandbox-merchant.revolut.com/api/subscriptions"),
  Headers =
  {
    { "Authorization", "__RP_TOK_0__" },
    { "Revolut-Api-Version", "__RP_TOK_1__" },
    { "Idempotency-Key", "__RP_TOK_2__" },
  },
  Content = new StringContent(@"{
  ""plan_variation_id"": ""550e8400-e29b-41d4-a716-446655440000"",
  ""customer_id"": ""650e8400-e29b-41d4-a716-446655440001"",
  ""setup_order_redirect_url"": ""https://example.com/subscription/setup/complete"",
  ""external_reference"": ""ext-ref-12345""
}")
  {
    Headers =
    {
      ContentType = new MediaTypeHeaderValue("application/json")
    }
  }
};

using (var response = await client.SendAsync(request))
{
  response.EnsureSuccessStatusCode();
  var body = await response.Content.ReadAsStringAsync();
  Console.WriteLine(body);
}
870:["$","div",null,{"className":"ezz1n30","children":[["$","div",null,{"data-header":"$undefined","className":"ezz1n31","children":["$L872",["$","$L85",null,{"parameters":[{"name":"Authorization","in":"header","schema":{"type":"string","format":"Bearer ","examples":"$62:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:0:schema:examples"},"required":true,"description":"This parameter accepts the [Merchant API Secret key](https://business.revolut.com/settings/apis?tab=merchant-api) to authorise requests coming from the merchant's backend. \n\nIt ensures that ensures that each request is authenticated and authorised by verifying the secret key. The secret key should be included in all request headers as a `Bearer` token.\n\n:::info\nFor more information, see: [Authentication](https://developer.revolut.com/docs/api/merchant#authentication)\n:::","descriptionNode":"$L873"},{"name":"Revolut-Api-Version","in":"header","schema":{"type":"string","format":"date","enum":"$36:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:1:schema:enum","examples":"$36:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:1:schema:examples"},"required":true,"description":"The version of the Merchant API, specified in `YYYY-MM-DD` format.\n\nIf not specified, you will receive an error.\n\n\n:::info\nFor more information about API versioning, see: [API versions](https://developer.revolut.com/docs/guides/merchant/reference/versioning/api-versions).\n:::","x-config-always-visible-in-example":true,"example":"2025-10-16","descriptionNode":"$L874"},{"name":"Idempotency-Key","in":"header","schema":{"type":"string"},"required":false,"description":"The `Idempotency-Key` ensures that requests are processed only once, preventing multiple executions of the same operation due to retries or duplicate requests.\n\nThis header is optional and can accept any unique string value the merchant uses.\n\nA recommended practice is to use a unique identifier from your system (such as the entity's ID or a request UUID) as the idempotency key. This facilitates tracking and managing requests effectively.","descriptionNode":"$L875"}],"requestBody":"$32:props:children:0:props:children:props:requestBody","heading":"Request","requestBodySchemaTitle":"Request body","headingAs":"h3"}],["$","$L89",null,{"responses":"$32:props:children:0:props:children:props:responses","headingAs":"h3"}]]}],["$","div",null,{"className":"ezz1n32","children":[[["$","$L8a",null,{"itemsByServer":{"https://merchant.revolut.com":[{"id":"curl","label":"cURL","templateCode":"curl -X POST \"https://merchant.revolut.com/api/subscriptions\" \\\n -H \"Content-Type: application/json\" \\\n -H \"Authorization: __RP_TOK_0__\" \\\n -H \"Revolut-Api-Version: __RP_TOK_1__\" \\\n -H \"Idempotency-Key: __RP_TOK_2__\" \\\n -d '{\n \"plan_variation_id\": \"550e8400-e29b-41d4-a716-446655440000\",\n \"customer_id\": \"650e8400-e29b-41d4-a716-446655440001\",\n \"setup_order_redirect_url\": \"https://example.com/subscription/setup/complete\",\n \"external_reference\": \"ext-ref-12345\"\n}'","templateHtml":"$876","tokens":[{"marker":"__RP_TOK_0__","paramName":"Authorization","paramIn":"header","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_1__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_2__","paramName":"Idempotency-Key","paramIn":"header","pipeline":["shell-double-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","header:Idempotency-Key":"string"}},{"id":"javascript","label":"JavaScript","templateCode":"const payload = {\n \"plan_variation_id\": \"550e8400-e29b-41d4-a716-446655440000\",\n \"customer_id\": \"650e8400-e29b-41d4-a716-446655440001\",\n \"setup_order_redirect_url\": \"https://example.com/subscription/setup/complete\",\n \"external_reference\": \"ext-ref-12345\"\n};\nfetch(\"https://merchant.revolut.com/api/subscriptions\", {\n method: \"POST\",\n headers: {\n \"Content-Type\": \"application/json\",\n \"Authorization\": \"__RP_TOK_0__\",\n \"Revolut-Api-Version\": \"__RP_TOK_1__\",\n \"Idempotency-Key\": \"__RP_TOK_2__\"\n },\n body: JSON.stringify(payload)\n})\n .then(response => response.json())\n .then(data => console.log(data));","templateHtml":"$877","tokens":[{"marker":"__RP_TOK_0__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Idempotency-Key","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","header:Idempotency-Key":"string"}},{"id":"go","label":"Go","templateCode":"package main\n\nimport (\n \"fmt\"\n \"net/http\"\n \"bytes\"\n \"encoding/json\"\n)\n\nfunc main() {\n url := \"https://merchant.revolut.com/api/subscriptions\"\n jsonData := []byte(`\n{\n \"plan_variation_id\": \"550e8400-e29b-41d4-a716-446655440000\",\n \"customer_id\": \"650e8400-e29b-41d4-a716-446655440001\",\n \"setup_order_redirect_url\": \"https://example.com/subscription/setup/complete\",\n \"external_reference\": \"ext-ref-12345\"\n}\n `)\n req, _ := http.NewRequest(\"POST\", url, bytes.NewBuffer(jsonData))\n req.Header.Add(\"Content-Type\", \"application/json\")\n req.Header.Add(\"Authorization\", \"__RP_TOK_0__\")\n req.Header.Add(\"Revolut-Api-Version\", \"__RP_TOK_1__\")\n req.Header.Add(\"Idempotency-Key\", \"__RP_TOK_2__\")\n\n res, _ := http.DefaultClient.Do(req)\n defer res.Body.Close()\n fmt.Println(res)\n}","templateHtml":"$878","tokens":[{"marker":"__RP_TOK_0__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Idempotency-Key","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","header:Idempotency-Key":"string"}},{"id":"python","label":"Python","templateCode":"import requests\n\nurl = \"https://merchant.revolut.com/api/subscriptions\"\nheaders = {\n \"Content-Type\": \"application/json\",\n \"Authorization\": \"__RP_TOK_0__\",\n \"Revolut-Api-Version\": \"__RP_TOK_1__\",\n \"Idempotency-Key\": \"__RP_TOK_2__\"\n}\npayload = {\n \"plan_variation_id\": \"550e8400-e29b-41d4-a716-446655440000\",\n \"customer_id\": \"650e8400-e29b-41d4-a716-446655440001\",\n \"setup_order_redirect_url\": \"https://example.com/subscription/setup/complete\",\n \"external_reference\": \"ext-ref-12345\"\n}\n\nresponse = requests.post(url, headers=headers, json=payload)\nprint(response.json())","templateHtml":"$879","tokens":[{"marker":"__RP_TOK_0__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Idempotency-Key","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","header:Idempotency-Key":"string"}},{"id":"java","label":"Java","templateCode":"$87a","templateHtml":"$87b","tokens":[{"marker":"__RP_TOK_0__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Idempotency-Key","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","header:Idempotency-Key":"string"}},{"id":"csharp","label":"C#","templateCode":"using System.Net.Http;\nusing System.Net.Http.Headers;\n\nvar client = new HttpClient();\nvar request = new HttpRequestMessage\n{\n Method = HttpMethod.Post,\n RequestUri = new Uri(\"https://merchant.revolut.com/api/subscriptions\"),\n Headers =\n {\n { \"Authorization\", \"__RP_TOK_0__\" },\n { \"Revolut-Api-Version\", \"__RP_TOK_1__\" },\n { \"Idempotency-Key\", \"__RP_TOK_2__\" },\n },\n Content = new StringContent(@\"{\n \"\"plan_variation_id\"\": \"\"550e8400-e29b-41d4-a716-446655440000\"\",\n \"\"customer_id\"\": \"\"650e8400-e29b-41d4-a716-446655440001\"\",\n \"\"setup_order_redirect_url\"\": \"\"https://example.com/subscription/setup/complete\"\",\n \"\"external_reference\"\": \"\"ext-ref-12345\"\"\n}\")\n {\n Headers =\n {\n ContentType = new MediaTypeHeaderValue(\"application/json\")\n }\n }\n};\n\nusing (var response = await client.SendAsync(request))\n{\n response.EnsureSuccessStatusCode();\n var body = await response.Content.ReadAsStringAsync();\n Console.WriteLine(body);\n}","templateHtml":"$87c","tokens":[{"marker":"__RP_TOK_0__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Idempotency-Key","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","header:Idempotency-Key":"string"}}],"https://sandbox-merchant.revolut.com":[{"id":"curl","label":"cURL","templateCode":"curl -X POST \"https://sandbox-merchant.revolut.com/api/subscriptions\" \\\n -H \"Content-Type: application/json\" \\\n -H \"Authorization: __RP_TOK_0__\" \\\n -H \"Revolut-Api-Version: __RP_TOK_1__\" \\\n -H \"Idempotency-Key: __RP_TOK_2__\" \\\n -d '{\n \"plan_variation_id\": \"550e8400-e29b-41d4-a716-446655440000\",\n \"customer_id\": \"650e8400-e29b-41d4-a716-446655440001\",\n \"setup_order_redirect_url\": \"https://example.com/subscription/setup/complete\",\n \"external_reference\": \"ext-ref-12345\"\n}'","templateHtml":"$87d","tokens":[{"marker":"__RP_TOK_0__","paramName":"Authorization","paramIn":"header","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_1__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_2__","paramName":"Idempotency-Key","paramIn":"header","pipeline":["shell-double-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","header:Idempotency-Key":"string"}},{"id":"javascript","label":"JavaScript","templateCode":"const payload = {\n \"plan_variation_id\": \"550e8400-e29b-41d4-a716-446655440000\",\n \"customer_id\": \"650e8400-e29b-41d4-a716-446655440001\",\n \"setup_order_redirect_url\": \"https://example.com/subscription/setup/complete\",\n \"external_reference\": \"ext-ref-12345\"\n};\nfetch(\"https://sandbox-merchant.revolut.com/api/subscriptions\", {\n method: \"POST\",\n headers: {\n \"Content-Type\": \"application/json\",\n \"Authorization\": \"__RP_TOK_0__\",\n \"Revolut-Api-Version\": \"__RP_TOK_1__\",\n \"Idempotency-Key\": \"__RP_TOK_2__\"\n },\n body: JSON.stringify(payload)\n})\n .then(response => response.json())\n .then(data => console.log(data));","templateHtml":"$87e","tokens":[{"marker":"__RP_TOK_0__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Idempotency-Key","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","header:Idempotency-Key":"string"}},{"id":"go","label":"Go","templateCode":"package main\n\nimport (\n \"fmt\"\n \"net/http\"\n \"bytes\"\n \"encoding/json\"\n)\n\nfunc main() {\n url := \"https://sandbox-merchant.revolut.com/api/subscriptions\"\n jsonData := []byte(`\n{\n \"plan_variation_id\": \"550e8400-e29b-41d4-a716-446655440000\",\n \"customer_id\": \"650e8400-e29b-41d4-a716-446655440001\",\n \"setup_order_redirect_url\": \"https://example.com/subscription/setup/complete\",\n \"external_reference\": \"ext-ref-12345\"\n}\n `)\n req, _ := http.NewRequest(\"POST\", url, bytes.NewBuffer(jsonData))\n req.Header.Add(\"Content-Type\", \"application/json\")\n req.Header.Add(\"Authorization\", \"__RP_TOK_0__\")\n req.Header.Add(\"Revolut-Api-Version\", \"__RP_TOK_1__\")\n req.Header.Add(\"Idempotency-Key\", \"__RP_TOK_2__\")\n\n res, _ := http.DefaultClient.Do(req)\n defer res.Body.Close()\n fmt.Println(res)\n}","templateHtml":"$87f","tokens":[{"marker":"__RP_TOK_0__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Idempotency-Key","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","header:Idempotency-Key":"string"}},{"id":"python","label":"Python","templateCode":"import requests\n\nurl = \"https://sandbox-merchant.revolut.com/api/subscriptions\"\nheaders = {\n \"Content-Type\": \"application/json\",\n \"Authorization\": \"__RP_TOK_0__\",\n \"Revolut-Api-Version\": \"__RP_TOK_1__\",\n \"Idempotency-Key\": \"__RP_TOK_2__\"\n}\npayload = {\n \"plan_variation_id\": \"550e8400-e29b-41d4-a716-446655440000\",\n \"customer_id\": \"650e8400-e29b-41d4-a716-446655440001\",\n \"setup_order_redirect_url\": \"https://example.com/subscription/setup/complete\",\n \"external_reference\": \"ext-ref-12345\"\n}\n\nresponse = requests.post(url, headers=headers, json=payload)\nprint(response.json())","templateHtml":"$880","tokens":[{"marker":"__RP_TOK_0__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Idempotency-Key","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","header:Idempotency-Key":"string"}},{"id":"java","label":"Java","templateCode":"$881","templateHtml":"$882","tokens":[{"marker":"__RP_TOK_0__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Idempotency-Key","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","header:Idempotency-Key":"string"}},{"id":"csharp","label":"C#","templateCode":"using System.Net.Http;\nusing System.Net.Http.Headers;\n\nvar client = new HttpClient();\nvar request = new HttpRequestMessage\n{\n Method = HttpMethod.Post,\n RequestUri = new Uri(\"https://sandbox-merchant.revolut.com/api/subscriptions\"),\n Headers =\n {\n { \"Authorization\", \"__RP_TOK_0__\" },\n { \"Revolut-Api-Version\", \"__RP_TOK_1__\" },\n { \"Idempotency-Key\", \"__RP_TOK_2__\" },\n },\n Content = new StringContent(@\"{\n \"\"plan_variation_id\"\": \"\"550e8400-e29b-41d4-a716-446655440000\"\",\n \"\"customer_id\"\": \"\"650e8400-e29b-41d4-a716-446655440001\"\",\n \"\"setup_order_redirect_url\"\": \"\"https://example.com/subscription/setup/complete\"\",\n \"\"external_reference\"\": \"\"ext-ref-12345\"\"\n}\")\n {\n Headers =\n {\n ContentType = new MediaTypeHeaderValue(\"application/json\")\n }\n }\n};\n\nusing (var response = await client.SendAsync(request))\n{\n response.EnsureSuccessStatusCode();\n var body = await response.Content.ReadAsStringAsync();\n Console.WriteLine(body);\n}","templateHtml":"$883","tokens":[{"marker":"__RP_TOK_0__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Idempotency-Key","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","header:Idempotency-Key":"string"}}]},"method":"post","servers":"$62:props:children:0:props:children:props:children:1:props:children:1:props:children:0:0:props:servers","path":"/api/subscriptions","parameters":["$870:props:children:0:props:children:1:props:parameters:0","$870:props:children:0:props:children:1:props:parameters:1","$870:props:children:0:props:children:1:props:parameters:2"]}],"$L884"],"$L885","$L886"]}]]}] 887:T8d1,
{
  "subscription_id": "550e8400-e29b-41d4-a716-446655440000",
  "subscription_item_code": "active_seats",
  "usage_date": "2026-03-15T09:30:00Z",
  "quantity": 12,
  "metadata": {
    "department": "engineering",
    "update_type": "onboarding"
  }
}
798:["$","div","request-application/json-report_usage",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$887"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"subscription_id\": \"550e8400-e29b-41d4-a716-446655440000\",\n \"subscription_item_code\": \"active_seats\",\n \"usage_date\": \"2026-03-15T09:30:00Z\",\n \"quantity\": 12,\n \"metadata\": {\n \"department\": \"engineering\",\n \"update_type\": \"onboarding\"\n }\n}"}]}]]}] 888:Td31,
{
  "id": "750e8400-e29b-41d4-a716-446655440000",
  "subscription_id": "550e8400-e29b-41d4-a716-446655440000",
  "subscription_cycle_id": "850e8400-e29b-41d4-a716-446655440000",
  "subscription_item_code": "api_calls",
  "usage_date": "2026-03-01T21:00:00Z",
  "quantity": 100,
  "metadata": {
    "user_id": "12345",
    "api_version": "v2"
  },
  "created_at": "2026-03-01T21:05:00Z",
  "updated_at": "2026-03-01T21:05:00Z"
}
799:["$","div","201-application/json-usage_record",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$888"}}]}]],"$L889"]}] 88a:T49e,
{
  "code": "subscription_item_code_not_found",
  "message": "Subscription item code 'api_calls' not found for phase",
  "timestamp": 1743465600
}
79a:["$","div","400-application/json-item_code_not_found",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$88a"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"code\": \"subscription_item_code_not_found\",\n \"message\": \"Subscription item code 'api_calls' not found for phase\",\n \"timestamp\": 1743465600\n}"}]}]]}] 88b:T44d,
{
  "code": "string",
  "message": "string",
  "timestamp": 123
}
79b:["$","div","401-application/json-default",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$88b"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"code\": \"string\",\n \"message\": \"string\",\n \"timestamp\": 123\n}"}]}]]}] 88c:T488,
{
  "code": "subscription_finished",
  "message": "Cannot add usage to a finished subscription",
  "timestamp": 1743465600
}
79c:["$","div","422-application/json-subscription_finished",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$88c"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"code\": \"subscription_finished\",\n \"message\": \"Cannot add usage to a finished subscription\",\n \"timestamp\": 1743465600\n}"}]}]]}] 88d:T48d,
{
  "code": "subscription_usage_after_last_cycle",
  "message": "Usage date is after the last cycle",
  "timestamp": 1743465600
}
79d:["$","div","422-application/json-usage_after_last_cycle",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$88d"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"code\": \"subscription_usage_after_last_cycle\",\n \"message\": \"Usage date is after the last cycle\",\n \"timestamp\": 1743465600\n}"}]}]]}] 88e:T4a4,
{
  "code": "subscription_usage_before_subscription_start",
  "message": "Usage date is before the subscription start date",
  "timestamp": 1743465600
}
79e:["$","div","422-application/json-usage_before_start",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$88e"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"code\": \"subscription_usage_before_subscription_start\",\n \"message\": \"Usage date is before the subscription start date\",\n \"timestamp\": 1743465600\n}"}]}]]}] 88f:T4a7,
{
  "code": "subscription_usage_future_cycle_limit_exceeded",
  "message": "Cannot add usage for cycles too far in the future",
  "timestamp": 1743465600
}
79f:["$","div","422-application/json-future_cycle_limit_exceeded",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$88f"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"code\": \"subscription_usage_future_cycle_limit_exceeded\",\n \"message\": \"Cannot add usage for cycles too far in the future\",\n \"timestamp\": 1743465600\n}"}]}]]}] 890:T487,
{
  "code": "subscription_usage_locked",
  "message": "Cannot modify usage for a locked cycle",
  "timestamp": 1743465600
}
7a0:["$","div","422-application/json-usage_locked",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$890"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"code\": \"subscription_usage_locked\",\n \"message\": \"Cannot modify usage for a locked cycle\",\n \"timestamp\": 1743465600\n}"}]}]]}] 891:T44d,
{
  "code": "string",
  "message": "string",
  "timestamp": 123
}
7a1:["$","div","default-application/json-default",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$891"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"code\": \"string\",\n \"message\": \"string\",\n \"timestamp\": 123\n}"}]}]]}] 884:["$","$L10d",null,{"security":[{"Api-Key":[]}],"authorization":{"Api-Key":{"type":"apiKey","in":"header","name":"Authorization","description":"Each Merchant API request must contain an authorization header in the following format:\n\n```\n'Authorization: Bearer '\n```\n\nTo use this API, you need to generate API keys from your Revolut Business account. The Secret key is used in the authorization header for all server calls, while the Public key is provided with payment methods at checkout.\n\n:::info\nFor detailed instructions on generating your API keys, see: [Generate API keys](https://developer.revolut.com/docs/guides/merchant/get-started#generate-api-keys).\n:::","descriptionNode":"$L892"}}}] 885:["$","$L10f",null,{"exampleBlocks":{"application/json":{"variants":[{"key":"with_setup_order","label":"Subscription with redirect URL","rawValue":"$32:props:children:0:props:children:props:requestBody:content:application/json:examples:with_setup_order:value","block":"$L893"},{"key":"with_setup_order_no_url","label":"Subscription without redirect URL","rawValue":"$32:props:children:0:props:children:props:requestBody:content:application/json:examples:with_setup_order_no_url:value","block":"$L894"},{"key":"with_trial","label":"Subscription with trial period overriding the trial duration from plan","rawValue":"$32:props:children:0:props:children:props:requestBody:content:application/json:examples:with_trial:value","block":"$L895"},{"key":"skip_trial","label":"Subscription skipping trial predefined in plan","rawValue":"$32:props:children:0:props:children:props:requestBody:content:application/json:examples:skip_trial:value","block":"$L896"}],"syncedPropertyName":"$undefined"}},"title":"Request body samples","headingAs":"h4"}] 886:["$","$L110",null,{"exampleBlocks":{"201":{"application/json":{"variants":[{"key":"with_setup_order","label":"Subscription created with setup order","rawValue":"$32:props:children:0:props:children:props:responses:201:content:application/json:examples:with_setup_order:value","block":"$L897"},{"key":"with_setup_order_no_url","label":"Subscription created with setup order (no redirect URL)","rawValue":"$32:props:children:0:props:children:props:responses:201:content:application/json:examples:with_setup_order_no_url:value","block":"$L898"}],"syncedPropertyName":"$undefined"}},"400":{"application/json":{"variants":[{"key":"default","label":"Example","rawValue":{"code":"string","message":"string","timestamp":123},"block":"$L899"}],"syncedPropertyName":"$undefined"}},"401":{"application/json":{"variants":[{"key":"default","label":"Example","rawValue":{"code":"string","message":"string","timestamp":123},"block":"$L89a"}],"syncedPropertyName":"$undefined"}},"default":{"application/json":{"variants":[{"key":"default","label":"Example","rawValue":{"code":"string","message":"string","timestamp":123},"block":"$L89b"}],"syncedPropertyName":"$undefined"}}},"headingAs":"h4"}] 889:["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"id\": \"750e8400-e29b-41d4-a716-446655440000\",\n \"subscription_id\": \"550e8400-e29b-41d4-a716-446655440000\",\n \"subscription_cycle_id\": \"850e8400-e29b-41d4-a716-446655440000\",\n \"subscription_item_code\": \"api_calls\",\n \"usage_date\": \"2026-03-01T21:00:00Z\",\n \"quantity\": 100,\n \"metadata\": {\n \"user_id\": \"12345\",\n \"api_version\": \"v2\"\n },\n \"created_at\": \"2026-03-01T21:05:00Z\",\n \"updated_at\": \"2026-03-01T21:05:00Z\"\n}"}]}] 871:"Create a subscription" 7e3:["$","div","CodeBlock-0",{"className":"wzy01m0 _18b50nc0","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"
'Authorization: Bearer <yourSecretApiKey>'
"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"'Authorization: Bearer '\n"}]}]]}] 89e:T47c,List of event types that the webhook is configured to listen to. Each event is related to status changes of a specific object in the Merchant API: | Object | Event types | | --------- | ----------- | | `Order` |
  • `ORDER_COMPLETED`
  • `ORDER_AUTHORISED`
  • `ORDER_CANCELLED`
  • `ORDER_FAILED`
  • `ORDER_INCREMENTAL_AUTHORISATION_AUTHORISED`
  • `ORDER_INCREMENTAL_AUTHORISATION_DECLINED`
  • `ORDER_INCREMENTAL_AUTHORISATION_FAILED`
| | `Payment` |
  • `ORDER_PAYMENT_AUTHENTICATION_CHALLENGED`
  • `ORDER_PAYMENT_AUTHENTICATED`
  • `ORDER_PAYMENT_AUTHORISATION_STARTED`
  • `ORDER_PAYMENT_DECLINED`
  • `ORDER_PAYMENT_FAILED`
| | `Subscription` |
  • `SUBSCRIPTION_INITIATED`
  • `SUBSCRIPTION_FINISHED`
  • `SUBSCRIPTION_CANCELLED`
  • `SUBSCRIPTION_OVERDUE`
| | `Payout` |
  • `PAYOUT_INITIATED`
  • `PAYOUT_COMPLETED`
  • `PAYOUT_FAILED`
| | `Dispute` |
  • `DISPUTE_ACTION_REQUIRED`
  • `DISPUTE_UNDER_REVIEW`
  • `DISPUTE_WON`
  • `DISPUTE_LOST`
|8b1:T47c,List of event types that the webhook is configured to listen to. Each event is related to status changes of a specific object in the Merchant API: | Object | Event types | | --------- | ----------- | | `Order` |
  • `ORDER_COMPLETED`
  • `ORDER_AUTHORISED`
  • `ORDER_CANCELLED`
  • `ORDER_FAILED`
  • `ORDER_INCREMENTAL_AUTHORISATION_AUTHORISED`
  • `ORDER_INCREMENTAL_AUTHORISATION_DECLINED`
  • `ORDER_INCREMENTAL_AUTHORISATION_FAILED`
| | `Payment` |
  • `ORDER_PAYMENT_AUTHENTICATION_CHALLENGED`
  • `ORDER_PAYMENT_AUTHENTICATED`
  • `ORDER_PAYMENT_AUTHORISATION_STARTED`
  • `ORDER_PAYMENT_DECLINED`
  • `ORDER_PAYMENT_FAILED`
| | `Subscription` |
  • `SUBSCRIPTION_INITIATED`
  • `SUBSCRIPTION_FINISHED`
  • `SUBSCRIPTION_CANCELLED`
  • `SUBSCRIPTION_OVERDUE`
| | `Payout` |
  • `PAYOUT_INITIATED`
  • `PAYOUT_COMPLETED`
  • `PAYOUT_FAILED`
| | `Dispute` |
  • `DISPUTE_ACTION_REQUIRED`
  • `DISPUTE_UNDER_REVIEW`
  • `DISPUTE_WON`
  • `DISPUTE_LOST`
|57:["$","$7a","create-webhook",{"children":[["$","section",null,{"className":"y9a0do0","data-variant":"endpoint","children":["$","$L7b",null,{"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"title":"Webhook","type":"object","description":"A webhook object.\n\nUnlike the legacy API, `signing_secret` is included in all webhook responses, not only on creation.","properties":{"id":{"type":"string","format":"uuid","description":"The ID of the webhook.","descriptionNode":"$L89c"},"url":{"type":"string","format":"uri","pattern":"^https?:\\/{2}.+/gi","maxLength":2000,"description":"Your webhook's URL to which event notifications will be sent. \n\nMust be a valid HTTP or HTTPS URL, capable of receiving `POST` requests.\n\n:::warning\nRestrictions:\n- Must be a valid URI as defined by [RFC 3986](https://datatracker.ietf.org/doc/html/rfc3986)\n- URI scheme is required and must be either `http` or `https`\n- URI host is required and cannot be `localhost` or an IP address\n- Max length: `2000`\n- Reserved or invalid characters must be percent-encoded (for example, use `%20` instead of a space)\n:::","descriptionNode":"$L89d"},"events":{"type":"array","description":"$89e","items":{"type":"string","description":"The available event types your can listen to.","enum":"$59:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:events:items:enum","descriptionNode":"$L89f"},"minItems":1,"descriptionNode":"$L8a0"},"signing_secret":{"type":"string","description":"The signing secret for the webhook. Use it to verify the signature for the webhook request's payload.","descriptionNode":"$L8a1"}},"required":"$59:props:children:0:props:children:props:responses:200:content:application/json:schema:required","descriptionNode":"$L8a2"},"examples":{"created_webhook":{"summary":"Webhook","value":"$59:props:children:0:props:children:props:responses:200:content:application/json:examples:retrieved_webhook:value"}}}},"descriptionNode":"$L8a3"},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"code":{"type":"string","description":"An identifier that can be used to determine what went wrong.\n\nError codes are not globally unique, but uniqueness is guaranteed within endpoints.","descriptionNode":"$L8a4"},"message":{"type":"string","description":"Some human readable text describing what went wrong.","descriptionNode":"$L8a5"},"timestamp":{"type":"integer","description":"The [UNIX timestamp](https://www.unixtimestamp.com/) of the date and time the error happened.","descriptionNode":"$L8a6"}}}}},"descriptionNode":"$L8a7"},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"code":{"type":"string","description":"An identifier that can be used to determine what went wrong.\n\nError codes are not globally unique, but uniqueness is guaranteed within endpoints.","descriptionNode":"$L8a8"},"message":{"type":"string","description":"Some human readable text describing what went wrong.","descriptionNode":"$L8a9"},"timestamp":{"type":"integer","description":"The [UNIX timestamp](https://www.unixtimestamp.com/) of the date and time the error happened.","descriptionNode":"$L8aa"}}}}},"descriptionNode":"$L8ab"},"422":{"description":"Unprocessable Content","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"code":{"type":"string","description":"An identifier that can be used to determine what went wrong.\n\nError codes are not globally unique, but uniqueness is guaranteed within endpoints.","descriptionNode":"$L8ac"},"message":{"type":"string","description":"Some human readable text describing what went wrong.","descriptionNode":"$L8ad"},"timestamp":{"type":"integer","description":"The [UNIX timestamp](https://www.unixtimestamp.com/) of the date and time the error happened.","descriptionNode":"$L8ae"}}}}},"descriptionNode":"$L8af"}},"requestBody":{"content":{"application/json":{"schema":{"title":"Webhook schema for creation and update operations","type":"object","properties":{"url":{"type":"string","format":"uri","pattern":"^https?:\\/{2}.+/gi","maxLength":2000,"description":"Your webhook's URL to which event notifications will be sent. \n\nMust be a valid HTTP or HTTPS URL, capable of receiving `POST` requests.\n\n:::warning\nRestrictions:\n- Must be a valid URI as defined by [RFC 3986](https://datatracker.ietf.org/doc/html/rfc3986)\n- URI scheme is required and must be either `http` or `https`\n- URI host is required and cannot be `localhost` or an IP address\n- Max length: `2000`\n- Reserved or invalid characters must be percent-encoded (for example, use `%20` instead of a space)\n:::","descriptionNode":"$L8b0"},"events":{"type":"array","description":"$8b1","items":{"type":"string","description":"The available event types your can listen to.","enum":"$59:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:events:items:enum","descriptionNode":"$L8b2"},"minItems":1,"descriptionNode":"$L8b3"}},"required":["url","events"]},"examples":{"example_webhook_request":{"summary":"Example webhook request","value":{"url":"https://example.com/webhooks","events":["ORDER_COMPLETED","ORDER_AUTHORISED"]}}}}}},"variantLabels":[],"children":["$L8b4","$L8b5"]}]}],"$L8b6"]}] 8b7:T1d4a,
{
  "next_page_token": "9e5d2caa-bb60-4b5b-b7cf-6345bbdff67e",
  "subscriptions": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "external_reference": "ext-ref-12345",
      "state": "active",
      "customer_id": "650e8400-e29b-41d4-a716-446655440001",
      "plan_id": "750e8400-e29b-41d4-a716-446655440002",
      "plan_variation_id": "850e8400-e29b-41d4-a716-446655440003",
      "payment_method_type": "automatic",
      "payment_method_id": "6689e244-8af7-4ada-9448-a91f02d4f192",
      "created_at": "2025-06-05T21:00:00.036001Z",
      "updated_at": "2025-06-05T21:00:00.036001Z",
      "start_date": "2025-06-05T21:00:00.036001Z",
      "current_cycle_id": "950e8400-e29b-41d4-a716-446655440004"
    },
    {
      "id": "550e8400-e29b-41d4-a716-446655440010",
      "state": "pending",
      "customer_id": "650e8400-e29b-41d4-a716-446655440011",
      "plan_id": "750e8400-e29b-41d4-a716-446655440012",
      "plan_variation_id": "850e8400-e29b-41d4-a716-446655440013",
      "payment_method_type": "automatic",
      "created_at": "2025-06-04T21:00:00.036001Z",
      "updated_at": "2025-06-04T21:00:00.036001Z",
      "current_cycle_id": "a31627fb-b037-4566-8d7b-f380c1f44653"
    }
  ]
}
7e5:["$","div","200-application/json-subscriptions_list",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$8b7"}}]}]],"$L8b8"]}] 8b9:T44d,
{
  "code": "string",
  "message": "string",
  "timestamp": 123
}
7e6:["$","div","400-application/json-default",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$8b9"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"code\": \"string\",\n \"message\": \"string\",\n \"timestamp\": 123\n}"}]}]]}] 8ba:T44d,
{
  "code": "string",
  "message": "string",
  "timestamp": 123
}
7e7:["$","div","401-application/json-default",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$8ba"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"code\": \"string\",\n \"message\": \"string\",\n \"timestamp\": 123\n}"}]}]]}] 8bb:T44d,
{
  "code": "string",
  "message": "string",
  "timestamp": 123
}
7e8:["$","div","default-application/json-default",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$8bb"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"code\": \"string\",\n \"message\": \"string\",\n \"timestamp\": 123\n}"}]}]]}] 845:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unique identifier for the subscription."}]]}] 846:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Optional external reference for the subscription."}],"\n",["$","p","p-1",{"children":"Use this field to store your own system's identifier for easy tracking and correlation."}]]}] 847:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The state of the subscription."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"State","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"pending"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The subscription has been created but is not yet active. This typically occurs when awaiting the first payment or setup completion.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"active"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The subscription is currently active and billing cycles are processing normally.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"overdue"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The subscription has a failed payment and is awaiting resolution.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"paused"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The subscription has been temporarily paused and no billing will occur.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-4",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"cancelled"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The subscription has been cancelled and will not renew.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-5",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"finished"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The subscription has completed all billing cycles (for limited-duration subscriptions).","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 848:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unique identifier for the customer."}]]}] 849:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unique identifier for the subscription plan."}]]}] 84a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unique identifier for the subscription plan variation."}]]}] 84b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of payment method used for the subscription."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Type","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"automatic"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Payments are automatically charged to the customer's saved payment method.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"manual"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Payments require manual processing by the customer.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 84c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unique identifier for the payment method."}]]}] 84d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The date and time the subscription was created in ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_8601","target":"_blank","rel":"noreferrer","children":"ISO 8601"}]," format."]}]]}] 84e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The date and time the subscription was last updated in ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_8601","target":"_blank","rel":"noreferrer","children":"ISO 8601"}]," format."]}]]}] 84f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The date and time the subscription started in ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_8601","target":"_blank","rel":"noreferrer","children":"ISO 8601"}]," format."]}],"\n",["$","p","p-1",{"children":["This field is ",["$","code","code-0",{"children":"null"}]," until the subscription becomes active."]}]]}] 850:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unique identifier for the subscription cycle."}]]}] 8b4:["$","div",null,{"className":"ezz1n30","children":[["$","div",null,{"data-header":"$undefined","className":"ezz1n31","children":["$","div",null,{"className":"y9a0do1","children":[["$","h2",null,{"id":"create-webhook","children":[["$L8bc","$undefined"],["$","$L15",null,{"id":"create-webhook"}]]}],["$","$L16",null,{"url":"/docs/api/merchant/2025-10-16/operations/create-webhook.md"}]]}]}],"$undefined"]}] 8c0:T7c6,
curl -X POST "https://merchant.revolut.com/api/webhooks" \
  -H "Content-Type: application/json" \
  -H "Authorization: __RP_TOK_0__" \
  -H "Revolut-Api-Version: __RP_TOK_1__" \
  -d '{
  "url": "https://example.com/webhooks",
  "events": [
    "ORDER_COMPLETED",
    "ORDER_AUTHORISED"
  ]
}'
8c1:T10b7,
const payload = {
  "url": "https://example.com/webhooks",
  "events": [
    "ORDER_COMPLETED",
    "ORDER_AUTHORISED"
  ]
};
fetch("https://merchant.revolut.com/api/webhooks", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "__RP_TOK_0__",
    "Revolut-Api-Version": "__RP_TOK_1__"
  },
  body: JSON.stringify(payload)
})
  .then(response => response.json())
  .then(data => console.log(data));
8c2:T17ab,
package main

import (
  "fmt"
  "net/http"
  "bytes"
  "encoding/json"
)

func main() {
  url := "https://merchant.revolut.com/api/webhooks"
  jsonData := []byte(`
{
  "url": "https://example.com/webhooks",
  "events": [
    "ORDER_COMPLETED",
    "ORDER_AUTHORISED"
  ]
}
  `)
  req, _ := http.NewRequest("POST", url, bytes.NewBuffer(jsonData))
  req.Header.Add("Content-Type", "application/json")
  req.Header.Add("Authorization", "__RP_TOK_0__")
  req.Header.Add("Revolut-Api-Version", "__RP_TOK_1__")

  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  fmt.Println(res)
}
8c3:Tdeb,
import requests

url = "https://merchant.revolut.com/api/webhooks"
headers = {
  "Content-Type": "application/json",
  "Authorization": "__RP_TOK_0__",
  "Revolut-Api-Version": "__RP_TOK_1__"
}
payload = {
  "url": "https://example.com/webhooks",
  "events": [
    "ORDER_COMPLETED",
    "ORDER_AUTHORISED"
  ]
}

response = requests.post(url, headers=headers, json=payload)
print(response.json())
8c4:T1d0f,
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;

public class Main {
  public static void main(String[] args) {
    HttpClient client = HttpClient.newHttpClient();
    String body = """
{
  "url": "https://example.com/webhooks",
  "events": [
    "ORDER_COMPLETED",
    "ORDER_AUTHORISED"
  ]
}
    """;

    HttpRequest request = HttpRequest.newBuilder()
      .uri(URI.create("https://merchant.revolut.com/api/webhooks"))
      .header("Content-Type", "application/json")
      .header("Authorization", "__RP_TOK_0__")
      .header("Revolut-Api-Version", "__RP_TOK_1__")
      .POST(HttpRequest.BodyPublishers.ofString(body))
      .build();

    client.sendAsync(request, HttpResponse.BodyHandlers.ofString())
      .thenApply(HttpResponse::body)
      .thenAccept(System.out::println)
      .join();
  }
}
8c5:T20f5,
using System.Net.Http;
using System.Net.Http.Headers;

var client = new HttpClient();
var request = new HttpRequestMessage
{
  Method = HttpMethod.Post,
  RequestUri = new Uri("https://merchant.revolut.com/api/webhooks"),
  Headers =
  {
    { "Authorization", "__RP_TOK_0__" },
    { "Revolut-Api-Version", "__RP_TOK_1__" },
  },
  Content = new StringContent(@"{
  ""url"": ""https://example.com/webhooks"",
  ""events"": [
    ""ORDER_COMPLETED"",
    ""ORDER_AUTHORISED""
  ]
}")
  {
    Headers =
    {
      ContentType = new MediaTypeHeaderValue("application/json")
    }
  }
};

using (var response = await client.SendAsync(request))
{
  response.EnsureSuccessStatusCode();
  var body = await response.Content.ReadAsStringAsync();
  Console.WriteLine(body);
}
8c6:T7ce,
curl -X POST "https://sandbox-merchant.revolut.com/api/webhooks" \
  -H "Content-Type: application/json" \
  -H "Authorization: __RP_TOK_0__" \
  -H "Revolut-Api-Version: __RP_TOK_1__" \
  -d '{
  "url": "https://example.com/webhooks",
  "events": [
    "ORDER_COMPLETED",
    "ORDER_AUTHORISED"
  ]
}'
8c7:T10bf,
const payload = {
  "url": "https://example.com/webhooks",
  "events": [
    "ORDER_COMPLETED",
    "ORDER_AUTHORISED"
  ]
};
fetch("https://sandbox-merchant.revolut.com/api/webhooks", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "__RP_TOK_0__",
    "Revolut-Api-Version": "__RP_TOK_1__"
  },
  body: JSON.stringify(payload)
})
  .then(response => response.json())
  .then(data => console.log(data));
8c8:T17b3,
package main

import (
  "fmt"
  "net/http"
  "bytes"
  "encoding/json"
)

func main() {
  url := "https://sandbox-merchant.revolut.com/api/webhooks"
  jsonData := []byte(`
{
  "url": "https://example.com/webhooks",
  "events": [
    "ORDER_COMPLETED",
    "ORDER_AUTHORISED"
  ]
}
  `)
  req, _ := http.NewRequest("POST", url, bytes.NewBuffer(jsonData))
  req.Header.Add("Content-Type", "application/json")
  req.Header.Add("Authorization", "__RP_TOK_0__")
  req.Header.Add("Revolut-Api-Version", "__RP_TOK_1__")

  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  fmt.Println(res)
}
8c9:Tdf3,
import requests

url = "https://sandbox-merchant.revolut.com/api/webhooks"
headers = {
  "Content-Type": "application/json",
  "Authorization": "__RP_TOK_0__",
  "Revolut-Api-Version": "__RP_TOK_1__"
}
payload = {
  "url": "https://example.com/webhooks",
  "events": [
    "ORDER_COMPLETED",
    "ORDER_AUTHORISED"
  ]
}

response = requests.post(url, headers=headers, json=payload)
print(response.json())
8ca:T1d17,
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;

public class Main {
  public static void main(String[] args) {
    HttpClient client = HttpClient.newHttpClient();
    String body = """
{
  "url": "https://example.com/webhooks",
  "events": [
    "ORDER_COMPLETED",
    "ORDER_AUTHORISED"
  ]
}
    """;

    HttpRequest request = HttpRequest.newBuilder()
      .uri(URI.create("https://sandbox-merchant.revolut.com/api/webhooks"))
      .header("Content-Type", "application/json")
      .header("Authorization", "__RP_TOK_0__")
      .header("Revolut-Api-Version", "__RP_TOK_1__")
      .POST(HttpRequest.BodyPublishers.ofString(body))
      .build();

    client.sendAsync(request, HttpResponse.BodyHandlers.ofString())
      .thenApply(HttpResponse::body)
      .thenAccept(System.out::println)
      .join();
  }
}
8cb:T20fd,
using System.Net.Http;
using System.Net.Http.Headers;

var client = new HttpClient();
var request = new HttpRequestMessage
{
  Method = HttpMethod.Post,
  RequestUri = new Uri("https://sandbox-merchant.revolut.com/api/webhooks"),
  Headers =
  {
    { "Authorization", "__RP_TOK_0__" },
    { "Revolut-Api-Version", "__RP_TOK_1__" },
  },
  Content = new StringContent(@"{
  ""url"": ""https://example.com/webhooks"",
  ""events"": [
    ""ORDER_COMPLETED"",
    ""ORDER_AUTHORISED""
  ]
}")
  {
    Headers =
    {
      ContentType = new MediaTypeHeaderValue("application/json")
    }
  }
};

using (var response = await client.SendAsync(request))
{
  response.EnsureSuccessStatusCode();
  var body = await response.Content.ReadAsStringAsync();
  Console.WriteLine(body);
}
8b5:["$","div",null,{"className":"ezz1n30","children":[["$","div",null,{"data-header":"$undefined","className":"ezz1n31","children":["$L8bd",["$","$L85",null,{"parameters":[{"name":"Authorization","in":"header","schema":{"type":"string","format":"Bearer ","examples":"$62:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:0:schema:examples"},"required":true,"description":"This parameter accepts the [Merchant API Secret key](https://business.revolut.com/settings/apis?tab=merchant-api) to authorise requests coming from the merchant's backend. \n\nIt ensures that ensures that each request is authenticated and authorised by verifying the secret key. The secret key should be included in all request headers as a `Bearer` token.\n\n:::info\nFor more information, see: [Authentication](https://developer.revolut.com/docs/api/merchant#authentication)\n:::","descriptionNode":"$L8be"},{"name":"Revolut-Api-Version","in":"header","schema":{"type":"string","format":"date","enum":"$27:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:1:schema:enum","examples":"$27:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:1:schema:examples"},"required":true,"description":"The version of the Merchant API, specified in `YYYY-MM-DD` format.\n\nThis endpoint is available from version `2024-09-01`. If a version earlier than `2024-09-01` is provided, the endpoint returns a `404` response.\n\nIf not specified, you will receive an error.\n\n\n:::info\nFor more information about API versioning, see: [API versions](https://developer.revolut.com/docs/guides/merchant/reference/versioning/api-versions).\n:::","x-config-always-visible-in-example":true,"example":"2025-10-16","descriptionNode":"$L8bf"}],"requestBody":"$57:props:children:0:props:children:props:requestBody","heading":"Request","requestBodySchemaTitle":"Request body","headingAs":"h3"}],["$","$L89",null,{"responses":"$57:props:children:0:props:children:props:responses","headingAs":"h3"}]]}],["$","div",null,{"className":"ezz1n32","children":[[["$","$L8a",null,{"itemsByServer":{"https://merchant.revolut.com":[{"id":"curl","label":"cURL","templateCode":"curl -X POST \"https://merchant.revolut.com/api/webhooks\" \\\n -H \"Content-Type: application/json\" \\\n -H \"Authorization: __RP_TOK_0__\" \\\n -H \"Revolut-Api-Version: __RP_TOK_1__\" \\\n -d '{\n \"url\": \"https://example.com/webhooks\",\n \"events\": [\n \"ORDER_COMPLETED\",\n \"ORDER_AUTHORISED\"\n ]\n}'","templateHtml":"$8c0","tokens":[{"marker":"__RP_TOK_0__","paramName":"Authorization","paramIn":"header","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_1__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["shell-double-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16"}},{"id":"javascript","label":"JavaScript","templateCode":"const payload = {\n \"url\": \"https://example.com/webhooks\",\n \"events\": [\n \"ORDER_COMPLETED\",\n \"ORDER_AUTHORISED\"\n ]\n};\nfetch(\"https://merchant.revolut.com/api/webhooks\", {\n method: \"POST\",\n headers: {\n \"Content-Type\": \"application/json\",\n \"Authorization\": \"__RP_TOK_0__\",\n \"Revolut-Api-Version\": \"__RP_TOK_1__\"\n },\n body: JSON.stringify(payload)\n})\n .then(response => response.json())\n .then(data => console.log(data));","templateHtml":"$8c1","tokens":[{"marker":"__RP_TOK_0__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16"}},{"id":"go","label":"Go","templateCode":"package main\n\nimport (\n \"fmt\"\n \"net/http\"\n \"bytes\"\n \"encoding/json\"\n)\n\nfunc main() {\n url := \"https://merchant.revolut.com/api/webhooks\"\n jsonData := []byte(`\n{\n \"url\": \"https://example.com/webhooks\",\n \"events\": [\n \"ORDER_COMPLETED\",\n \"ORDER_AUTHORISED\"\n ]\n}\n `)\n req, _ := http.NewRequest(\"POST\", url, bytes.NewBuffer(jsonData))\n req.Header.Add(\"Content-Type\", \"application/json\")\n req.Header.Add(\"Authorization\", \"__RP_TOK_0__\")\n req.Header.Add(\"Revolut-Api-Version\", \"__RP_TOK_1__\")\n\n res, _ := http.DefaultClient.Do(req)\n defer res.Body.Close()\n fmt.Println(res)\n}","templateHtml":"$8c2","tokens":[{"marker":"__RP_TOK_0__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16"}},{"id":"python","label":"Python","templateCode":"import requests\n\nurl = \"https://merchant.revolut.com/api/webhooks\"\nheaders = {\n \"Content-Type\": \"application/json\",\n \"Authorization\": \"__RP_TOK_0__\",\n \"Revolut-Api-Version\": \"__RP_TOK_1__\"\n}\npayload = {\n \"url\": \"https://example.com/webhooks\",\n \"events\": [\n \"ORDER_COMPLETED\",\n \"ORDER_AUTHORISED\"\n ]\n}\n\nresponse = requests.post(url, headers=headers, json=payload)\nprint(response.json())","templateHtml":"$8c3","tokens":[{"marker":"__RP_TOK_0__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16"}},{"id":"java","label":"Java","templateCode":"import java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\nimport java.net.URI;\n\npublic class Main {\n public static void main(String[] args) {\n HttpClient client = HttpClient.newHttpClient();\n String body = \"\"\"\n{\n \"url\": \"https://example.com/webhooks\",\n \"events\": [\n \"ORDER_COMPLETED\",\n \"ORDER_AUTHORISED\"\n ]\n}\n \"\"\";\n\n HttpRequest request = HttpRequest.newBuilder()\n .uri(URI.create(\"https://merchant.revolut.com/api/webhooks\"))\n .header(\"Content-Type\", \"application/json\")\n .header(\"Authorization\", \"__RP_TOK_0__\")\n .header(\"Revolut-Api-Version\", \"__RP_TOK_1__\")\n .POST(HttpRequest.BodyPublishers.ofString(body))\n .build();\n\n client.sendAsync(request, HttpResponse.BodyHandlers.ofString())\n .thenApply(HttpResponse::body)\n .thenAccept(System.out::println)\n .join();\n }\n}","templateHtml":"$8c4","tokens":[{"marker":"__RP_TOK_0__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16"}},{"id":"csharp","label":"C#","templateCode":"using System.Net.Http;\nusing System.Net.Http.Headers;\n\nvar client = new HttpClient();\nvar request = new HttpRequestMessage\n{\n Method = HttpMethod.Post,\n RequestUri = new Uri(\"https://merchant.revolut.com/api/webhooks\"),\n Headers =\n {\n { \"Authorization\", \"__RP_TOK_0__\" },\n { \"Revolut-Api-Version\", \"__RP_TOK_1__\" },\n },\n Content = new StringContent(@\"{\n \"\"url\"\": \"\"https://example.com/webhooks\"\",\n \"\"events\"\": [\n \"\"ORDER_COMPLETED\"\",\n \"\"ORDER_AUTHORISED\"\"\n ]\n}\")\n {\n Headers =\n {\n ContentType = new MediaTypeHeaderValue(\"application/json\")\n }\n }\n};\n\nusing (var response = await client.SendAsync(request))\n{\n response.EnsureSuccessStatusCode();\n var body = await response.Content.ReadAsStringAsync();\n Console.WriteLine(body);\n}","templateHtml":"$8c5","tokens":[{"marker":"__RP_TOK_0__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16"}}],"https://sandbox-merchant.revolut.com":[{"id":"curl","label":"cURL","templateCode":"curl -X POST \"https://sandbox-merchant.revolut.com/api/webhooks\" \\\n -H \"Content-Type: application/json\" \\\n -H \"Authorization: __RP_TOK_0__\" \\\n -H \"Revolut-Api-Version: __RP_TOK_1__\" \\\n -d '{\n \"url\": \"https://example.com/webhooks\",\n \"events\": [\n \"ORDER_COMPLETED\",\n \"ORDER_AUTHORISED\"\n ]\n}'","templateHtml":"$8c6","tokens":[{"marker":"__RP_TOK_0__","paramName":"Authorization","paramIn":"header","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_1__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["shell-double-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16"}},{"id":"javascript","label":"JavaScript","templateCode":"const payload = {\n \"url\": \"https://example.com/webhooks\",\n \"events\": [\n \"ORDER_COMPLETED\",\n \"ORDER_AUTHORISED\"\n ]\n};\nfetch(\"https://sandbox-merchant.revolut.com/api/webhooks\", {\n method: \"POST\",\n headers: {\n \"Content-Type\": \"application/json\",\n \"Authorization\": \"__RP_TOK_0__\",\n \"Revolut-Api-Version\": \"__RP_TOK_1__\"\n },\n body: JSON.stringify(payload)\n})\n .then(response => response.json())\n .then(data => console.log(data));","templateHtml":"$8c7","tokens":[{"marker":"__RP_TOK_0__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16"}},{"id":"go","label":"Go","templateCode":"package main\n\nimport (\n \"fmt\"\n \"net/http\"\n \"bytes\"\n \"encoding/json\"\n)\n\nfunc main() {\n url := \"https://sandbox-merchant.revolut.com/api/webhooks\"\n jsonData := []byte(`\n{\n \"url\": \"https://example.com/webhooks\",\n \"events\": [\n \"ORDER_COMPLETED\",\n \"ORDER_AUTHORISED\"\n ]\n}\n `)\n req, _ := http.NewRequest(\"POST\", url, bytes.NewBuffer(jsonData))\n req.Header.Add(\"Content-Type\", \"application/json\")\n req.Header.Add(\"Authorization\", \"__RP_TOK_0__\")\n req.Header.Add(\"Revolut-Api-Version\", \"__RP_TOK_1__\")\n\n res, _ := http.DefaultClient.Do(req)\n defer res.Body.Close()\n fmt.Println(res)\n}","templateHtml":"$8c8","tokens":[{"marker":"__RP_TOK_0__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16"}},{"id":"python","label":"Python","templateCode":"import requests\n\nurl = \"https://sandbox-merchant.revolut.com/api/webhooks\"\nheaders = {\n \"Content-Type\": \"application/json\",\n \"Authorization\": \"__RP_TOK_0__\",\n \"Revolut-Api-Version\": \"__RP_TOK_1__\"\n}\npayload = {\n \"url\": \"https://example.com/webhooks\",\n \"events\": [\n \"ORDER_COMPLETED\",\n \"ORDER_AUTHORISED\"\n ]\n}\n\nresponse = requests.post(url, headers=headers, json=payload)\nprint(response.json())","templateHtml":"$8c9","tokens":[{"marker":"__RP_TOK_0__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16"}},{"id":"java","label":"Java","templateCode":"import java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\nimport java.net.URI;\n\npublic class Main {\n public static void main(String[] args) {\n HttpClient client = HttpClient.newHttpClient();\n String body = \"\"\"\n{\n \"url\": \"https://example.com/webhooks\",\n \"events\": [\n \"ORDER_COMPLETED\",\n \"ORDER_AUTHORISED\"\n ]\n}\n \"\"\";\n\n HttpRequest request = HttpRequest.newBuilder()\n .uri(URI.create(\"https://sandbox-merchant.revolut.com/api/webhooks\"))\n .header(\"Content-Type\", \"application/json\")\n .header(\"Authorization\", \"__RP_TOK_0__\")\n .header(\"Revolut-Api-Version\", \"__RP_TOK_1__\")\n .POST(HttpRequest.BodyPublishers.ofString(body))\n .build();\n\n client.sendAsync(request, HttpResponse.BodyHandlers.ofString())\n .thenApply(HttpResponse::body)\n .thenAccept(System.out::println)\n .join();\n }\n}","templateHtml":"$8ca","tokens":[{"marker":"__RP_TOK_0__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16"}},{"id":"csharp","label":"C#","templateCode":"using System.Net.Http;\nusing System.Net.Http.Headers;\n\nvar client = new HttpClient();\nvar request = new HttpRequestMessage\n{\n Method = HttpMethod.Post,\n RequestUri = new Uri(\"https://sandbox-merchant.revolut.com/api/webhooks\"),\n Headers =\n {\n { \"Authorization\", \"__RP_TOK_0__\" },\n { \"Revolut-Api-Version\", \"__RP_TOK_1__\" },\n },\n Content = new StringContent(@\"{\n \"\"url\"\": \"\"https://example.com/webhooks\"\",\n \"\"events\"\": [\n \"\"ORDER_COMPLETED\"\",\n \"\"ORDER_AUTHORISED\"\"\n ]\n}\")\n {\n Headers =\n {\n ContentType = new MediaTypeHeaderValue(\"application/json\")\n }\n }\n};\n\nusing (var response = await client.SendAsync(request))\n{\n response.EnsureSuccessStatusCode();\n var body = await response.Content.ReadAsStringAsync();\n Console.WriteLine(body);\n}","templateHtml":"$8cb","tokens":[{"marker":"__RP_TOK_0__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16"}}]},"method":"post","servers":"$62:props:children:0:props:children:props:children:1:props:children:1:props:children:0:0:props:servers","path":"/api/webhooks","parameters":["$8b5:props:children:0:props:children:1:props:parameters:0","$8b5:props:children:0:props:children:1:props:parameters:1"]}],"$L8cc"],"$L8cd","$L8ce"]}]]}] 8d1:T492,The event type of the webhook notification that's sent by Revolut to your webhook URL. Each event is related to status changes of a specific object in the Merchant API: | Object | Event types | | --------- | ----------- | | `Order` |
  • `ORDER_COMPLETED`
  • `ORDER_AUTHORISED`
  • `ORDER_CANCELLED`
  • `ORDER_FAILED`
  • `ORDER_INCREMENTAL_AUTHORISATION_AUTHORISED`
  • `ORDER_INCREMENTAL_AUTHORISATION_DECLINED`
  • `ORDER_INCREMENTAL_AUTHORISATION_FAILED`
| | `Payment` |
  • `ORDER_PAYMENT_AUTHENTICATION_CHALLENGED`
  • `ORDER_PAYMENT_AUTHENTICATED`
  • `ORDER_PAYMENT_AUTHORISATION_STARTED`
  • `ORDER_PAYMENT_DECLINED`
  • `ORDER_PAYMENT_FAILED`
| | `Subscription` |
  • `SUBSCRIPTION_INITIATED`
  • `SUBSCRIPTION_FINISHED`
  • `SUBSCRIPTION_CANCELLED`
  • `SUBSCRIPTION_OVERDUE`
| | `Payout` |
  • `PAYOUT_INITIATED`
  • `PAYOUT_COMPLETED`
  • `PAYOUT_FAILED`
| | `Dispute` |
  • `DISPUTE_ACTION_REQUIRED`
  • `DISPUTE_UNDER_REVIEW`
  • `DISPUTE_WON`
  • `DISPUTE_LOST`
|8d6:T492,The event type of the webhook notification that's sent by Revolut to your webhook URL. Each event is related to status changes of a specific object in the Merchant API: | Object | Event types | | --------- | ----------- | | `Order` |
  • `ORDER_COMPLETED`
  • `ORDER_AUTHORISED`
  • `ORDER_CANCELLED`
  • `ORDER_FAILED`
  • `ORDER_INCREMENTAL_AUTHORISATION_AUTHORISED`
  • `ORDER_INCREMENTAL_AUTHORISATION_DECLINED`
  • `ORDER_INCREMENTAL_AUTHORISATION_FAILED`
| | `Payment` |
  • `ORDER_PAYMENT_AUTHENTICATION_CHALLENGED`
  • `ORDER_PAYMENT_AUTHENTICATED`
  • `ORDER_PAYMENT_AUTHORISATION_STARTED`
  • `ORDER_PAYMENT_DECLINED`
  • `ORDER_PAYMENT_FAILED`
| | `Subscription` |
  • `SUBSCRIPTION_INITIATED`
  • `SUBSCRIPTION_FINISHED`
  • `SUBSCRIPTION_CANCELLED`
  • `SUBSCRIPTION_OVERDUE`
| | `Payout` |
  • `PAYOUT_INITIATED`
  • `PAYOUT_COMPLETED`
  • `PAYOUT_FAILED`
| | `Dispute` |
  • `DISPUTE_ACTION_REQUIRED`
  • `DISPUTE_UNDER_REVIEW`
  • `DISPUTE_WON`
  • `DISPUTE_LOST`
|8da:T492,The event type of the webhook notification that's sent by Revolut to your webhook URL. Each event is related to status changes of a specific object in the Merchant API: | Object | Event types | | --------- | ----------- | | `Order` |
  • `ORDER_COMPLETED`
  • `ORDER_AUTHORISED`
  • `ORDER_CANCELLED`
  • `ORDER_FAILED`
  • `ORDER_INCREMENTAL_AUTHORISATION_AUTHORISED`
  • `ORDER_INCREMENTAL_AUTHORISATION_DECLINED`
  • `ORDER_INCREMENTAL_AUTHORISATION_FAILED`
| | `Payment` |
  • `ORDER_PAYMENT_AUTHENTICATION_CHALLENGED`
  • `ORDER_PAYMENT_AUTHENTICATED`
  • `ORDER_PAYMENT_AUTHORISATION_STARTED`
  • `ORDER_PAYMENT_DECLINED`
  • `ORDER_PAYMENT_FAILED`
| | `Subscription` |
  • `SUBSCRIPTION_INITIATED`
  • `SUBSCRIPTION_FINISHED`
  • `SUBSCRIPTION_CANCELLED`
  • `SUBSCRIPTION_OVERDUE`
| | `Payout` |
  • `PAYOUT_INITIATED`
  • `PAYOUT_COMPLETED`
  • `PAYOUT_FAILED`
| | `Dispute` |
  • `DISPUTE_ACTION_REQUIRED`
  • `DISPUTE_UNDER_REVIEW`
  • `DISPUTE_WON`
  • `DISPUTE_LOST`
|8dd:T492,The event type of the webhook notification that's sent by Revolut to your webhook URL. Each event is related to status changes of a specific object in the Merchant API: | Object | Event types | | --------- | ----------- | | `Order` |
  • `ORDER_COMPLETED`
  • `ORDER_AUTHORISED`
  • `ORDER_CANCELLED`
  • `ORDER_FAILED`
  • `ORDER_INCREMENTAL_AUTHORISATION_AUTHORISED`
  • `ORDER_INCREMENTAL_AUTHORISATION_DECLINED`
  • `ORDER_INCREMENTAL_AUTHORISATION_FAILED`
| | `Payment` |
  • `ORDER_PAYMENT_AUTHENTICATION_CHALLENGED`
  • `ORDER_PAYMENT_AUTHENTICATED`
  • `ORDER_PAYMENT_AUTHORISATION_STARTED`
  • `ORDER_PAYMENT_DECLINED`
  • `ORDER_PAYMENT_FAILED`
| | `Subscription` |
  • `SUBSCRIPTION_INITIATED`
  • `SUBSCRIPTION_FINISHED`
  • `SUBSCRIPTION_CANCELLED`
  • `SUBSCRIPTION_OVERDUE`
| | `Payout` |
  • `PAYOUT_INITIATED`
  • `PAYOUT_COMPLETED`
  • `PAYOUT_FAILED`
| | `Dispute` |
  • `DISPUTE_ACTION_REQUIRED`
  • `DISPUTE_UNDER_REVIEW`
  • `DISPUTE_WON`
  • `DISPUTE_LOST`
|8b6:["$","section",null,{"className":"zzkpfh0","children":[["$","h3",null,{"children":"Callbacks"}],["$","div",null,{"className":"zzkpfh1","children":[["$","section","create-webhook-callback-send-webhook-event-request-body-url-post",{"className":"y9a0do6 y9a0do0","data-variant":"callback","children":["$","$L7b",null,{"responses":{"204":{"description":"If the webhook event was delivered successfully, we recommend to respond with a `204` code.\n\n:::info\nYou can respond to and acknowledge the delivery of a webhook event by any HTTP response code between `200-399`.\n:::","descriptionNode":"$L8cf"},"4XX":{"description":"If the webhook event delivery times out or the delivery of the events fails, you can respond with any HTTP `4XX` code. In this case, Revolut will retry sending the webhook event 3 more times, each with a 10-minute delay.","descriptionNode":"$L8d0"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"discriminator":{"propertyName":"event","mapping":{"Order or payment event":"#/components/schemas/Webhook-Order-Event","Subscription":"#/components/schemas/Webhook-Subscription-Event","Payout event":"#/components/schemas/Webhook-Payout-Event","Dispute event":"#/components/schemas/Webhook-Dispute-Event"}},"oneOf":[{"type":"object","properties":{"event":{"type":"string","enum":["ORDER_COMPLETED","ORDER_AUTHORISED","ORDER_CANCELLED","ORDER_FAILED","ORDER_INCREMENTAL_AUTHORISATION_AUTHORISED","ORDER_INCREMENTAL_AUTHORISATION_DECLINED","ORDER_INCREMENTAL_AUTHORISATION_FAILED","ORDER_PAYMENT_AUTHENTICATION_CHALLENGED","ORDER_PAYMENT_AUTHENTICATED","ORDER_PAYMENT_AUTHORISATION_STARTED","ORDER_PAYMENT_DECLINED","ORDER_PAYMENT_FAILED","SUBSCRIPTION_INITIATED","SUBSCRIPTION_FINISHED","SUBSCRIPTION_CANCELLED","SUBSCRIPTION_OVERDUE","PAYOUT_INITIATED","PAYOUT_COMPLETED","PAYOUT_FAILED","DISPUTE_ACTION_REQUIRED","DISPUTE_UNDER_REVIEW","DISPUTE_WON","DISPUTE_LOST"],"description":"$8d1","descriptionNode":"$L8d2"},"order_id":{"type":"string","format":"uuid","description":"The ID of the order the event is related to.","descriptionNode":"$L8d3"},"merchant_order_ext_ref":{"type":"string","description":"The information sent during order creation in the\n`merchant_order_data.reference` field.","descriptionNode":"$L8d4"},"incremental_authorisation_ext_reference":{"type":"string","description":"The reference sent in the `reference` field of the [Increment authorisation](https://developer.revolut.com/docs/api/merchant#increment-authorisation) request. Only present for incremental authorisation events.","descriptionNode":"$L8d5"}},"required":["event","order_id"]},{"type":"object","properties":{"event":{"type":"string","enum":"$8b6:props:children:1:props:children:0:props:children:props:requestBody:content:application/json:schema:oneOf:0:properties:event:enum","description":"$8d6","descriptionNode":"$L8d7"},"subscription_id":{"type":"string","format":"uuid","description":"The ID of the subscription the event is related to.","descriptionNode":"$L8d8"},"external_reference":{"type":"string","description":"The information sent in the `external_reference` field of the [Create a subscription](https://developer.revolut.com/docs/api/merchant#create-subscription) request.","descriptionNode":"$L8d9"}},"required":["event","subscription_id"]},{"type":"object","properties":{"event":{"type":"string","enum":"$8b6:props:children:1:props:children:0:props:children:props:requestBody:content:application/json:schema:oneOf:0:properties:event:enum","description":"$8da","descriptionNode":"$L8db"},"payout_id":{"type":"string","format":"uuid","description":"The ID of the payout the event is related to.","descriptionNode":"$L8dc"}},"required":["event","payout_id"]},{"type":"object","properties":{"event":{"type":"string","enum":"$8b6:props:children:1:props:children:0:props:children:props:requestBody:content:application/json:schema:oneOf:0:properties:event:enum","description":"$8dd","descriptionNode":"$L8de"},"dispute_id":{"type":"string","format":"uuid","description":"The ID of the dispute the event is related to.","descriptionNode":"$L8df"}},"required":["event","dispute_id"]}]},"examples":{"order_event":{"summary":"Webhook event related to an order or payment","value":{"event":"ORDER_COMPLETED","order_id":"6634c172-3398-ac93-aee9-50de0282e3ac","merchant_order_ext_ref":"Example reference #123"}},"subscription_event":{"summary":"Webhook event related to a subscription","value":{"event":"SUBSCRIPTION_INITIATED","subscription_id":"550e8400-e29b-41d4-a716-446655440000","external_reference":"ext-ref-12345"}},"incremental_auth_authorised":{"summary":"Webhook event for successful incremental authorisation","value":{"event":"ORDER_INCREMENTAL_AUTHORISATION_AUTHORISED","order_id":"6634c172-3398-ac93-aee9-50de0282e3ac","incremental_authorisation_ext_reference":"CHG-67890"}},"incremental_auth_declined":{"summary":"Webhook event for declined incremental authorisation","value":{"event":"ORDER_INCREMENTAL_AUTHORISATION_DECLINED","order_id":"6634c172-3398-ac93-aee9-50de0282e3ac","incremental_authorisation_ext_reference":"CHG-67891"}},"incremental_auth_failed":{"summary":"Webhook event for failed incremental authorisation","value":{"event":"ORDER_INCREMENTAL_AUTHORISATION_FAILED","order_id":"6634c172-3398-ac93-aee9-50de0282e3ac","incremental_authorisation_ext_reference":"CHG-67892"}},"authorisation_started":{"summary":"Webhook event for payment authorisation started (SEPA Direct Debit)","value":{"event":"ORDER_PAYMENT_AUTHORISATION_STARTED","order_id":"6634c172-3398-ac93-aee9-50de0282e3ac","merchant_order_ext_ref":"Example reference #123"}},"payout_event":{"summary":"Webhook event related to a payout","value":{"event":"PAYOUT_COMPLETED","payout_id":"6634c172-3398-ac93-aee9-50de0282e3ac"}},"dispute_event":{"summary":"Webhook event related to a dispute","value":{"event":"DISPUTE_ACTION_REQUIRED","dispute_id":"ab934829-e4ba-4e7f-8a21-365cad85c763"}}}}}},"variantLabels":["Webhook event related to an order or payment","Webhook event related to a subscription","Webhook event for successful incremental authorisation","Webhook event for declined incremental authorisation","Webhook event for failed incremental authorisation","Webhook event for payment authorisation started (SEPA Direct Debit)","Webhook event related to a payout","Webhook event related to a dispute"],"children":["$L8e0","$L8e1"]}]}]]}]]}] 8e2:T4c4,{ "next_page_token": "9e5d2caa-bb60-4b5b-b7cf-6345bbdff67e", "subscriptions": [ { "id": "550e8400-e29b-41d4-a716-446655440000", "external_reference": "ext-ref-12345", "state": "active", "customer_id": "650e8400-e29b-41d4-a716-446655440001", "plan_id": "750e8400-e29b-41d4-a716-446655440002", "plan_variation_id": "850e8400-e29b-41d4-a716-446655440003", "payment_method_type": "automatic", "payment_method_id": "6689e244-8af7-4ada-9448-a91f02d4f192", "created_at": "2025-06-05T21:00:00.036001Z", "updated_at": "2025-06-05T21:00:00.036001Z", "start_date": "2025-06-05T21:00:00.036001Z", "current_cycle_id": "950e8400-e29b-41d4-a716-446655440004" }, { "id": "550e8400-e29b-41d4-a716-446655440010", "state": "pending", "customer_id": "650e8400-e29b-41d4-a716-446655440011", "plan_id": "750e8400-e29b-41d4-a716-446655440012", "plan_variation_id": "850e8400-e29b-41d4-a716-446655440013", "payment_method_type": "automatic", "created_at": "2025-06-04T21:00:00.036001Z", "updated_at": "2025-06-04T21:00:00.036001Z", "current_cycle_id": "a31627fb-b037-4566-8d7b-f380c1f44653" } ] }8b8:["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"$8e2"}]}] 851:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The trial period duration for this subscription in ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_8601#Durations","target":"_blank","rel":"noreferrer","children":"ISO 8601 duration format"}]," (e.g., \"P14D\" for 14 days)."]}],"\n",["$","h1","h1-0",{"children":"Override plan defaults"}],"\n",["$","p","p-1",{"children":"Subscription plans can define a default trial duration. When creating a subscription, you can use this field to override the plan's default trial period:"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Field value","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Behaviour","className":"eowryt6","ref":"$undefined"}],["$","th","th-2",{"children":"Example","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","strong","strong-0",{"children":"Not provided"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Uses the trial duration defined in the plan (if any)","className":"eowryt7","ref":"$undefined"}],["$","td","td-2",{"children":["Plan has ",["$","code","code-0",{"children":"\"P7D\""}]," → subscription gets 7-day trial"],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","strong","strong-0",{"children":"Different value"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Overrides the plan's default trial duration","className":"eowryt7","ref":"$undefined"}],["$","td","td-2",{"children":["Plan has ",["$","code","code-0",{"children":"\"P7D\""}]," → set to ",["$","code","code-1",{"children":"\"P30D\""}]," for promotional offer, or ",["$","code","code-2",{"children":"\"P3D\""}]," to reduce"],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","strong","strong-0",{"children":["$","code","code-0",{"children":"\"P0D\""}]}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Explicitly skips the trial period","className":"eowryt7","ref":"$undefined"}],["$","td","td-2",{"children":["Plan has ",["$","code","code-0",{"children":"\"P7D\""}]," → set to ",["$","code","code-1",{"children":"\"P0D\""}]," to skip trial entirely"],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["Only days (",["$","code","code-0",{"children":"D"}],") are allowed. Time components such as hours, minutes, or seconds are not permitted."]}]}]]}]]}] 852:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The date and time when the subscription's trial period ends in ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_8601","target":"_blank","rel":"noreferrer","children":"ISO 8601"}]," format."]}],"\n",["$","p","p-1",{"children":["This value is automatically calculated by the system as: ",["$","code","code-0",{"children":"start_date"}]," + ",["$","code","code-1",{"children":"trial_duration"}]]}],"\n",["$","p","p-2",{"children":["The ",["$","code","code-0",{"children":"trial_duration"}]," used in the calculation comes from either:"]}],"\n",["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["The subscription's custom ",["$","code","code-0",{"children":"trial_duration"}]," (if provided at creation time), or"]}],"\n",["$","li","li-1",{"children":["The plan's default ",["$","code","code-0",{"children":"trial_duration"}]," (if no override was specified)"]}],"\n"]}],"\n",["$","p","p-3",{"children":["This field is ",["$","code","code-0",{"children":"null"}]," when the subscription has no trial period (e.g., when ",["$","code","code-1",{"children":"trial_duration"}]," is not set or is ",["$","code","code-2",{"children":"\"P0D\""}],")."]}]]}] 853:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The ID of the order created for handling the setup payment for the subscription."}],"\n",["$","p","p-1",{"children":["Use the ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#retrieve-order","target":"_blank","rel":"noreferrer","children":"Retrieve an order"}]," endpoint with this ID to get order details, including the ",["$","code","code-0",{"children":"checkout_url"}]," for redirecting customers to the Hosted Payment Page or the ",["$","code","code-1",{"children":"token"}]," for widget integration."]}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":"The order is created in parallel to the subscription and is used to collect the initial payment and save the customer's payment method for future billing cycles."}]}]]}]]}] 854:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of the scheduled action."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Value","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"cancel"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"A cancellation scheduled to take effect at the end of the current billing cycle.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"change_plan_variation"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"A plan variation change scheduled to take effect at the end of the current billing cycle.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 855:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The reason for the scheduled action. This field is informational and does not affect how the action is processed."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Value","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"customer_request"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The action was requested by the customer.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"merchant_request"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The action was initiated by the merchant.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 856:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A cancellation scheduled to take effect at the end of the current billing cycle."}]]}] 857:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of the scheduled action."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Value","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"cancel"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"A cancellation scheduled to take effect at the end of the current billing cycle.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"change_plan_variation"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"A plan variation change scheduled to take effect at the end of the current billing cycle.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 858:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The reason for the scheduled action. This field is informational and does not affect how the action is processed."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Value","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"customer_request"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The action was requested by the customer.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"merchant_request"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The action was initiated by the merchant.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 859:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unique identifier for the subscription plan variation."}]]}] 85a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unique identifier for the subscription plan phase."}]]}] 85b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A plan variation change scheduled to take effect at the end of the current billing cycle."}]]}] 85c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A pending scheduled action on the subscription, applied at the end of the current billing cycle."}]]}] 85d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Subscription created successfully"}]]}] 85e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An identifier that can be used to determine what went wrong."}],"\n",["$","p","p-1",{"children":"Error codes are not globally unique, but uniqueness is guaranteed within endpoints."}]]}] 85f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Some human readable text describing what went wrong."}]]}] 860:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://www.unixtimestamp.com/","target":"_blank","rel":"noreferrer","children":"UNIX timestamp"}]," of the date and time the error happened."]}]]}] 861:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Bad Request"}]]}] 862:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An identifier that can be used to determine what went wrong."}],"\n",["$","p","p-1",{"children":"Error codes are not globally unique, but uniqueness is guaranteed within endpoints."}]]}] 863:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Some human readable text describing what went wrong."}]]}] 864:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://www.unixtimestamp.com/","target":"_blank","rel":"noreferrer","children":"UNIX timestamp"}]," of the date and time the error happened."]}]]}] 865:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unauthorized"}]]}] 866:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An identifier that can be used to determine what went wrong."}],"\n",["$","p","p-1",{"children":"Error codes are not globally unique, but uniqueness is guaranteed within endpoints."}]]}] 867:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Some human readable text describing what went wrong."}]]}] 868:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://www.unixtimestamp.com/","target":"_blank","rel":"noreferrer","children":"UNIX timestamp"}]," of the date and time the error happened."]}]]}] 869:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Error response"}]]}] 86a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unique identifier for the subscription plan variation."}]]}] 86b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unique identifier for the customer."}]]}] 86c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Optional external reference for the subscription."}],"\n",["$","p","p-1",{"children":"Use this field to store your own system's identifier for easy tracking and correlation."}]]}] 86d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The URL to which the customer is redirected after completing the setup order on the Revolut Hosted Payment Page."}],"\n",["$","p","p-1",{"children":["When provided, the response will include a ",["$","code","code-0",{"children":"setup_order_id"}],". Use the ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#retrieve-order","target":"_blank","rel":"noreferrer","children":"Retrieve an order"}]," endpoint with this ",["$","code","code-1",{"children":"setup_order_id"}]," to get the ",["$","code","code-2",{"children":"checkout_url"}]," for redirecting the customer to the Hosted Payment Page."]}],"\n",["$","div","inlinealert-0",{"data-type":"warning","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMark","color":"var(--rui-color-warning)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"Restrictions:"}],["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["Must be a valid URI as defined by ",["$","a","a-0",{"href":"https://datatracker.ietf.org/doc/html/rfc3986","target":"_blank","rel":"noreferrer","children":"RFC 3986"}]]}],"\n",["$","li","li-1",{"children":["URI scheme is required and must be either ",["$","code","code-0",{"children":"http"}]," or ",["$","code","code-1",{"children":"https"}]]}],"\n",["$","li","li-2",{"children":["URI host is required and cannot be ",["$","code","code-0",{"children":"localhost"}]," or an IP address"]}],"\n",["$","li","li-3",{"children":["Max length: ",["$","code","code-0",{"children":"2000"}]]}],"\n",["$","li","li-4",{"children":["Reserved or invalid characters must be percent-encoded (for example, use ",["$","code","code-0",{"children":"%20"}]," instead of a space)"]}],"\n"]}]]}]]}]]}] 86e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The trial period duration for this subscription in ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_8601#Durations","target":"_blank","rel":"noreferrer","children":"ISO 8601 duration format"}]," (e.g., \"P14D\" for 14 days)."]}],"\n",["$","h1","h1-0",{"children":"Override plan defaults"}],"\n",["$","p","p-1",{"children":"Subscription plans can define a default trial duration. When creating a subscription, you can use this field to override the plan's default trial period:"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Field value","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Behaviour","className":"eowryt6","ref":"$undefined"}],["$","th","th-2",{"children":"Example","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","strong","strong-0",{"children":"Not provided"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Uses the trial duration defined in the plan (if any)","className":"eowryt7","ref":"$undefined"}],["$","td","td-2",{"children":["Plan has ",["$","code","code-0",{"children":"\"P7D\""}]," → subscription gets 7-day trial"],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","strong","strong-0",{"children":"Different value"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Overrides the plan's default trial duration","className":"eowryt7","ref":"$undefined"}],["$","td","td-2",{"children":["Plan has ",["$","code","code-0",{"children":"\"P7D\""}]," → set to ",["$","code","code-1",{"children":"\"P30D\""}]," for promotional offer, or ",["$","code","code-2",{"children":"\"P3D\""}]," to reduce"],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","strong","strong-0",{"children":["$","code","code-0",{"children":"\"P0D\""}]}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Explicitly skips the trial period","className":"eowryt7","ref":"$undefined"}],["$","td","td-2",{"children":["Plan has ",["$","code","code-0",{"children":"\"P7D\""}]," → set to ",["$","code","code-1",{"children":"\"P0D\""}]," to skip trial entirely"],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["Only days (",["$","code","code-0",{"children":"D"}],") are allowed. Time components such as hours, minutes, or seconds are not permitted."]}]}]]}]]}] 8cc:["$","$L10d",null,{"security":[{"Api-Key":[]}],"authorization":{"Api-Key":{"type":"apiKey","in":"header","name":"Authorization","description":"Each Merchant API request must contain an authorization header in the following format:\n\n```\n'Authorization: Bearer '\n```\n\nTo use this API, you need to generate API keys from your Revolut Business account. The Secret key is used in the authorization header for all server calls, while the Public key is provided with payment methods at checkout.\n\n:::info\nFor detailed instructions on generating your API keys, see: [Generate API keys](https://developer.revolut.com/docs/guides/merchant/get-started#generate-api-keys).\n:::","descriptionNode":"$L8e3"}}}] 8cd:["$","$L10f",null,{"exampleBlocks":{"application/json":{"variants":[{"key":"example_webhook_request","label":"Example webhook request","rawValue":"$57:props:children:0:props:children:props:requestBody:content:application/json:examples:example_webhook_request:value","block":"$L8e4"}],"syncedPropertyName":"$undefined"}},"title":"Request body samples","headingAs":"h4"}] 8ce:["$","$L110",null,{"exampleBlocks":{"200":{"application/json":{"variants":[{"key":"created_webhook","label":"Webhook","rawValue":"$59:props:children:0:props:children:props:responses:200:content:application/json:examples:retrieved_webhook:value","block":"$L8e5"}],"syncedPropertyName":"$undefined"}},"400":{"application/json":{"variants":[{"key":"default","label":"Example","rawValue":{"code":"string","message":"string","timestamp":123},"block":"$L8e6"}],"syncedPropertyName":"$undefined"}},"401":{"application/json":{"variants":[{"key":"default","label":"Example","rawValue":{"code":"string","message":"string","timestamp":123},"block":"$L8e7"}],"syncedPropertyName":"$undefined"}},"422":{"application/json":{"variants":[{"key":"default","label":"Example","rawValue":{"code":"string","message":"string","timestamp":123},"block":"$L8e8"}],"syncedPropertyName":"$undefined"}}},"headingAs":"h4"}] 8e0:["$","div",null,{"className":"ezz1n30","children":[["$","div",null,{"data-header":"$undefined","className":"ezz1n31","children":["$","div",null,{"className":"y9a0do1","children":[["$","h4",null,{"id":"create-webhook-callback-send-webhook-event-request-body-url-post","children":[["$L8e9","$undefined"],["$","$L15",null,{"id":"create-webhook-callback-send-webhook-event-request-body-url-post"}]]}],"$undefined"]}]}],"$undefined"]}] 8e1:["$","div",null,{"className":"ezz1n30","children":[["$","div",null,{"data-header":"$undefined","className":"ezz1n31","children":["$L8ea",["$","$L85",null,{"parameters":[{"name":"Revolut-Request-Timestamp","in":"header","required":true,"schema":{"type":"string"},"description":"The [UNIX timestamp](https://www.unixtimestamp.com/) of the date and time when the webhook event was sent from Revolut. Used to verify the webhook event payload was actually sent by Revolut.\n\n:::info\nFor more information, see: [Verify payload signature](https://developer.revolut.com/docs/guides/merchant/monitor-and-observe/webhooks/verify-the-payload-signature)\n:::","descriptionNode":"$L8eb"},{"name":"Revolut-Signature","in":"header","required":true,"schema":{"type":"string"},"description":"The payload signature computed by Revolut using a Hash-based Message Authentication Code (HMAC). Used to verify the webhook event payload was actually sent by Revolut.\n\n:::info\nFor more information, see: [Verify payload signature](https://developer.revolut.com/docs/guides/merchant/monitor-and-observe/webhooks/verify-the-payload-signature)\n:::","descriptionNode":"$L8ec"}],"requestBody":"$8b6:props:children:1:props:children:0:props:children:props:requestBody","heading":"Callback request","requestBodySchemaTitle":"Payload","headingAs":"h5"}],["$","$L89",null,{"responses":"$8b6:props:children:1:props:children:0:props:children:props:responses","headingAs":"h5"}]]}],["$","div",null,{"className":"ezz1n32","children":[["$","div",null,{"className":"y9a0do5","children":[["$","span",null,{"className":"b0biwq0","data-method":"post","children":[["$","span",null,{"className":"b0biwq2","children":["$","$L73",null,{"name":"ArrowThinTopRight","size":12}]}],["$","span",null,{"className":"b0biwq3","children":"post"}]]}],["$","span",null,{"className":"y9a0do4","children":"{$request.body#/url}"}]]}],["$","$L10f",null,{"exampleBlocks":{"application/json":{"variants":[{"key":"order_event","label":"Webhook event related to an order or payment","rawValue":"$8b6:props:children:1:props:children:0:props:children:props:requestBody:content:application/json:examples:order_event:value","block":"$L8ed"},{"key":"subscription_event","label":"Webhook event related to a subscription","rawValue":"$8b6:props:children:1:props:children:0:props:children:props:requestBody:content:application/json:examples:subscription_event:value","block":"$L8ee"},{"key":"incremental_auth_authorised","label":"Webhook event for successful incremental authorisation","rawValue":"$8b6:props:children:1:props:children:0:props:children:props:requestBody:content:application/json:examples:incremental_auth_authorised:value","block":"$L8ef"},{"key":"incremental_auth_declined","label":"Webhook event for declined incremental authorisation","rawValue":"$8b6:props:children:1:props:children:0:props:children:props:requestBody:content:application/json:examples:incremental_auth_declined:value","block":"$L8f0"},{"key":"incremental_auth_failed","label":"Webhook event for failed incremental authorisation","rawValue":"$8b6:props:children:1:props:children:0:props:children:props:requestBody:content:application/json:examples:incremental_auth_failed:value","block":"$L8f1"},{"key":"authorisation_started","label":"Webhook event for payment authorisation started (SEPA Direct Debit)","rawValue":"$8b6:props:children:1:props:children:0:props:children:props:requestBody:content:application/json:examples:authorisation_started:value","block":"$L8f2"},{"key":"payout_event","label":"Webhook event related to a payout","rawValue":"$8b6:props:children:1:props:children:0:props:children:props:requestBody:content:application/json:examples:payout_event:value","block":"$L8f3"},{"key":"dispute_event","label":"Webhook event related to a dispute","rawValue":"$8b6:props:children:1:props:children:0:props:children:props:requestBody:content:application/json:examples:dispute_event:value","block":"$L8f4"}],"syncedPropertyName":"event"}},"title":"Payload samples","headingAs":"h5"}],["$","$L110",null,{"exampleBlocks":{"204":{},"4XX":{}},"headingAs":"h5"}]]}]]}] 872:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Create a new subscription for a customer using a subscription plan variation."}],"\n",["$","p","p-1",{"children":"There are several supported flows for creating and activating subscriptions, depending on your integration needs."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["The customer must already exist in the API. The ",["$","code","code-0",{"children":"customer_id"}]," is required for all subscription flows."]}]}]]}],"\n",["$","$L5f9","Expandable-0",{"title":"Flow 1: Hosted Payment Page (HPP)","children":["\n","\n",["$","p","p-0",{"children":"Use this flow to redirect the customer to Revolut's Hosted Payment Page to complete the first payment and save their payment method."}],"\n",["$","p","p-1",{"children":["$","strong","strong-0",{"children":"Backend flow:"}]}],"\n",["$","ol","ol-0",{"children":["\n",["$","li","li-0",{"children":["\n",["$","p","p-0",{"children":["Create a subscription with optional ",["$","code","code-0",{"children":"setup_order_redirect_url"}],":"]}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":["$","code","code-0",{"children":"setup_order_redirect_url"}],"className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Behaviour","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","strong","strong-0",{"children":"Provided"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["The setup order's ",["$","code","code-0",{"children":"redirect_url"}]," field is set to this value."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","strong","strong-0",{"children":"Omitted"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The setup order uses Revolut's default redirect behaviour.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}],"\n"]}],"\n",["$","li","li-1",{"children":["\n",["$","p","p-0",{"children":["The subscription is created in a ",["$","code","code-0",{"children":"pending"}]," state with a ",["$","code","code-1",{"children":"setup_order_id"}]," in the response."]}],"\n"]}],"\n",["$","li","li-2",{"children":["\n",["$","p","p-0",{"children":[["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant/2024-09-01#retrieve-order","target":"_blank","rel":"noreferrer","children":"Retrieve the order"}]," using ",["$","code","code-0",{"children":"setup_order_id"}]," as the ",["$","code","code-1",{"children":"order_id"}]," in the path to get the ",["$","code","code-2",{"children":"checkout_url"}],"."]}],"\n"]}],"\n",["$","li","li-3",{"children":["\n",["$","p","p-0",{"children":["Redirect the customer to the ",["$","code","code-0",{"children":"checkout_url"}]," for the Hosted Payment Page."]}],"\n"]}],"\n"]}],"\n",["$","p","p-2",{"children":["$","strong","strong-0",{"children":"Customer flow:"}]}],"\n",["$","ol","ol-1",{"children":["\n",["$","li","li-0",{"children":["\n",["$","p","p-0",{"children":"Customer is redirected to Revolut's Hosted Payment Page."}],"\n"]}],"\n",["$","li","li-1",{"children":["\n",["$","p","p-0",{"children":"Customer completes payment on the HPP, and their payment method is saved."}],"\n"]}],"\n",["$","li","li-2",{"children":["\n",["$","p","p-0",{"children":"Customer redirect after payment depends on your setup:"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":["$","code","code-0",{"children":"setup_order_redirect_url"}],"className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Customer redirect","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","strong","strong-0",{"children":"Provided"}],"className":"eowryt7","ref":"$undefined"}],"$L8f5"],"className":"eowryt5","ref":"$undefined"}],"$L8f6"],"className":"eowryt3","ref":"$undefined"}]]}]}],"\n"]}],"\n"]}],"\n","$L8f7","\n","$L8f8","\n"]}],"\n","$L8f9"]}] 873:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["This parameter accepts the ",["$","a","a-0",{"href":"https://business.revolut.com/settings/apis?tab=merchant-api","target":"_blank","rel":"noreferrer","children":"Merchant API Secret key"}]," to authorise requests coming from the merchant's backend."]}],"\n",["$","p","p-1",{"children":["It ensures that ensures that each request is authenticated and authorised by verifying the secret key. The secret key should be included in all request headers as a ",["$","code","code-0",{"children":"Bearer"}]," token."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#authentication","target":"_blank","rel":"noreferrer","children":"Authentication"}]]}]}]]}]]}] 874:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The version of the Merchant API, specified in ",["$","code","code-0",{"children":"YYYY-MM-DD"}]," format."]}],"\n",["$","p","p-1",{"children":"If not specified, you will receive an error."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information about API versioning, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/reference/versioning/api-versions","target":"_blank","rel":"noreferrer","children":"API versions"}],"."]}]}]]}]]}] 875:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","code","code-0",{"children":"Idempotency-Key"}]," ensures that requests are processed only once, preventing multiple executions of the same operation due to retries or duplicate requests."]}],"\n",["$","p","p-1",{"children":"This header is optional and can accept any unique string value the merchant uses."}],"\n",["$","p","p-2",{"children":"A recommended practice is to use a unique identifier from your system (such as the entity's ID or a request UUID) as the idempotency key. This facilitates tracking and managing requests effectively."}]]}] 82c:["$","div","CodeBlock-0",{"className":"wzy01m0 _18b50nc0","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"
'Authorization: Bearer <yourSecretApiKey>'
"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"'Authorization: Bearer '\n"}]}]]}] 8f5:["$","td","td-1",{"children":"Customer is redirected to your custom URL.","className":"eowryt7","ref":"$undefined"}] 8f6:["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","strong","strong-0",{"children":"Omitted"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Customer sees the default Revolut completion screen.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}] 8f7:["$","p","p-3",{"children":["$","strong","strong-0",{"children":"Key characteristics:"}]}] 8f8:["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":"Customer completes payment on Revolut's hosted page"}],"\n",["$","li","li-1",{"children":"Payment method is automatically saved for future billing cycles"}],"\n",["$","li","li-2",{"children":"Optional custom redirect after payment"}],"\n",["$","li","li-3",{"children":"Best for web-based integrations"}],"\n"]}] 8f9:["$","$L5f9","Expandable-1",{"title":"Flow 2: Widget or card-not-present (CNP) payment","children":["\n","\n",["$","p","p-0",{"children":"Use this flow when you want to embed the payment experience directly on your website using one of Revolut's payment widgets or handle card-not-present payments."}],"\n",["$","p","p-1",{"children":["$","strong","strong-0",{"children":"Backend flow:"}]}],"\n",["$","ol","ol-0",{"children":["\n",["$","li","li-0",{"children":"Create a subscription with minimal required parameters."}],"\n",["$","li","li-1",{"children":["The subscription is created in a ",["$","code","code-0",{"children":"pending"}]," state with a ",["$","code","code-1",{"children":"setup_order_id"}]," in the response."]}],"\n",["$","li","li-2",{"children":[["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant/2024-09-01#retrieve-order","target":"_blank","rel":"noreferrer","children":"Retrieve the order"}]," using ",["$","code","code-0",{"children":"setup_order_id"}]," as the ",["$","code","code-1",{"children":"order_id"}]," in the path to get order details for your integration."]}],"\n",["$","li","li-3",{"children":"Integrate your payment solution (widget, SDK, or CNP method) on your frontend, ensuring it's configured to save the customer's payment method for recurring billing."}],"\n"]}],"\n",["$","p","p-2",{"children":["$","strong","strong-0",{"children":"Customer flow:"}]}],"\n",["$","ol","ol-1",{"children":["\n",["$","li","li-0",{"children":"Customer stays on your website/application."}],"\n",["$","li","li-1",{"children":"Customer completes payment, and their payment method is saved for future billing cycles."}],"\n"]}],"\n",["$","p","p-3",{"children":["$","strong","strong-0",{"children":"Key characteristics:"}]}],"\n",["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":"Payment experience embedded directly in your application"}],"\n",["$","li","li-1",{"children":"Customer never leaves your website"}],"\n",["$","li","li-2",{"children":"Payment method is saved for future billing cycles"}],"\n",["$","li","li-3",{"children":"Best for native mobile apps or fully custom web experiences"}],"\n"]}],"\n"]}] 892:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Each Merchant API request must contain an authorization header in the following format:"}],"\n","$L8fa","\n",["$","p","p-1",{"children":"To use this API, you need to generate API keys from your Revolut Business account. The Secret key is used in the authorization header for all server calls, while the Public key is provided with payment methods at checkout."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For detailed instructions on generating your API keys, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/get-started#generate-api-keys","target":"_blank","rel":"noreferrer","children":"Generate API keys"}],"."]}]}]]}]]}] 82e:["$","div","request-application/json-update_subscription",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"
{\n  \"external_reference\": \"ext-ref-12345\"\n}
"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"external_reference\": \"ext-ref-12345\"\n}"}]}]]}] 8fb:T1166,
{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "external_reference": "ext-ref-12345",
  "state": "active",
  "customer_id": "650e8400-e29b-41d4-a716-446655440001",
  "plan_id": "750e8400-e29b-41d4-a716-446655440002",
  "plan_variation_id": "850e8400-e29b-41d4-a716-446655440003",
  "payment_method_type": "automatic",
  "payment_method_id": "6689e244-8af7-4ada-9448-a91f02d4f192",
  "created_at": "2025-06-05T21:00:00.036001Z",
  "updated_at": "2025-06-05T21:00:00.036001Z",
  "start_date": "2025-06-05T21:00:00.036001Z",
  "current_cycle_id": "950e8400-e29b-41d4-a716-446655440004",
  "trial_duration": "P14D",
  "trial_end_date": "2025-06-19T21:00:00.036001Z"
}
82f:["$","div","200-application/json-updated_subscription",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$8fb"}}]}]],"$L8fc"]}] 8fd:T44d,
{
  "code": "string",
  "message": "string",
  "timestamp": 123
}
830:["$","div","400-application/json-default",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$8fd"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"code\": \"string\",\n \"message\": \"string\",\n \"timestamp\": 123\n}"}]}]]}] 8fe:T44d,
{
  "code": "string",
  "message": "string",
  "timestamp": 123
}
831:["$","div","401-application/json-default",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$8fe"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"code\": \"string\",\n \"message\": \"string\",\n \"timestamp\": 123\n}"}]}]]}] 8ff:T44d,
{
  "code": "string",
  "message": "string",
  "timestamp": 123
}
832:["$","div","404-application/json-default",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$8ff"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"code\": \"string\",\n \"message\": \"string\",\n \"timestamp\": 123\n}"}]}]]}] 900:T44d,
{
  "code": "string",
  "message": "string",
  "timestamp": 123
}
833:["$","div","default-application/json-default",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$900"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"code\": \"string\",\n \"message\": \"string\",\n \"timestamp\": 123\n}"}]}]]}] 8bc:"Create a webhook" 8fc:["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"id\": \"550e8400-e29b-41d4-a716-446655440000\",\n \"external_reference\": \"ext-ref-12345\",\n \"state\": \"active\",\n \"customer_id\": \"650e8400-e29b-41d4-a716-446655440001\",\n \"plan_id\": \"750e8400-e29b-41d4-a716-446655440002\",\n \"plan_variation_id\": \"850e8400-e29b-41d4-a716-446655440003\",\n \"payment_method_type\": \"automatic\",\n \"payment_method_id\": \"6689e244-8af7-4ada-9448-a91f02d4f192\",\n \"created_at\": \"2025-06-05T21:00:00.036001Z\",\n \"updated_at\": \"2025-06-05T21:00:00.036001Z\",\n \"start_date\": \"2025-06-05T21:00:00.036001Z\",\n \"current_cycle_id\": \"950e8400-e29b-41d4-a716-446655440004\",\n \"trial_duration\": \"P14D\",\n \"trial_end_date\": \"2025-06-19T21:00:00.036001Z\"\n}"}]}] 60:["$","$7a","retrieve-location",{"children":[["$","section",null,{"className":"y9a0do0","data-variant":"endpoint","children":["$","$L7b",null,{"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"title":"Location","type":"object","description":"Location object represents merchant locations depending on type.","oneOf":[{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Unique ID representing the location where merchants sells products.\n\n:::info\nFor more information, see: [Locations](https://developer.revolut.com/docs/api/merchant#tag-locations).\n::: ","descriptionNode":"$L901"},"name":{"type":"string","description":"Name of the location. \n\n:::warning\nThe `name` parameter's value must be unique across all locations.\n:::","descriptionNode":"$L902"},"type":{"type":"string","description":"Type of the location.\n\n| Value | Description |\n| ----- | ----------- |\n| `online` | Represents an online store. |\n| `physical` | Represents a physical point of sale. |","enum":["online","physical"],"descriptionNode":"$L903"},"details":{"type":"object","description":"Additional details of the location.","properties":{"domain":{"type":"string","description":"Domain address of the location. Required for online locations.\n\n:::warning\nThe `domain` parameter's value must be unique across all locations.\n:::","descriptionNode":"$L904"}},"required":["domain"],"descriptionNode":"$L905"}},"required":["id","name","type","details"]},{"title":"Location","type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Unique ID representing the location where merchants sells products.\n\n:::info\nFor more information, see: [Locations](https://developer.revolut.com/docs/api/merchant#tag-locations).\n::: ","descriptionNode":"$L906"},"name":{"type":"string","description":"Name of the location. \n\n:::warning\nThe `name` parameter's value must be unique across all locations.\n:::","descriptionNode":"$L907"},"type":{"type":"string","description":"Type of the location.\n\n| Value | Description |\n| ----- | ----------- |\n| `online` | Represents an online store. |\n| `physical` | Represents a physical point of sale. |","enum":"$60:props:children:0:props:children:props:responses:200:content:application/json:schema:oneOf:0:properties:type:enum","descriptionNode":"$L908"},"details":{"type":"object","description":"Additional details of the location.","properties":{"address":{"type":"object","description":"Details of a physical address.","properties":{"street_line_1":{"type":"string","description":"Primary address line.","maxLength":100,"descriptionNode":"$L909"},"street_line_2":{"type":"string","description":"Secondary address line, such as floor and apartment number.","maxLength":100,"descriptionNode":"$L90a"},"region":{"type":"string","description":"State or province of the address.","maxLength":100,"descriptionNode":"$L90b"},"city":{"type":"string","description":"City of the address.","maxLength":100,"descriptionNode":"$L90c"},"country_code":{"type":"string","pattern":"^[A-Z]{2}$","description":"ISO 2-letter country code.","minLength":2,"maxLength":2,"descriptionNode":"$L90d"},"postcode":{"type":"string","description":"Postal code of the address.","maxLength":100,"descriptionNode":"$L90e"}},"required":["street_line_1","city","country_code","postcode"],"descriptionNode":"$L90f"},"geo_location":{"type":"object","description":"Coordinates of the location.","properties":{"lat":{"type":"number","format":"double","description":"The latitude of the location, in decimal degrees.","minimum":-90,"maximum":90,"descriptionNode":"$L910"},"lon":{"type":"number","format":"double","description":"To longitude of the location, in decimal degrees.","minimum":-180,"maximum":180,"descriptionNode":"$L911"}},"required":["lat","lon"],"descriptionNode":"$L912"},"opening_hours":{"type":"object","description":"An object containing the opening hours for each day of the week.\n\nA day can have multiple intervals (e.g., closing for a lunch break).","properties":{"monday":{"description":"Opening hours for Monday.","type":"array","items":{"type":"object","properties":{"from":{"type":"string","format":"time","description":"The local time when the interval begins.\n\n:::note\nThe format is `hh:mm[:ss]`; seconds are optional and must be `00` if provided.\n:::","examples":["09:00:00"],"descriptionNode":"$L913"},"to":{"type":"string","format":"time","description":"The local time when the interval ends.\n\n:::note\nThe format is `hh:mm[:ss]`; seconds are optional and must be `00` if provided.\n:::","examples":["18:00:00"],"descriptionNode":"$L914"}},"required":["from","to"]},"descriptionNode":"$L915"},"tuesday":{"description":"Opening hours for Tuesday.","type":"array","items":"$60:props:children:0:props:children:props:responses:200:content:application/json:schema:oneOf:1:properties:details:properties:opening_hours:properties:monday:items","descriptionNode":"$L916"},"wednesday":{"description":"Opening hours for Wednesday.","type":"array","items":"$60:props:children:0:props:children:props:responses:200:content:application/json:schema:oneOf:1:properties:details:properties:opening_hours:properties:monday:items","descriptionNode":"$L917"},"thursday":{"description":"Opening hours for Thursday.","type":"array","items":"$60:props:children:0:props:children:props:responses:200:content:application/json:schema:oneOf:1:properties:details:properties:opening_hours:properties:monday:items","descriptionNode":"$L918"},"friday":{"description":"Opening hours for Friday.","type":"array","items":"$60:props:children:0:props:children:props:responses:200:content:application/json:schema:oneOf:1:properties:details:properties:opening_hours:properties:monday:items","descriptionNode":"$L919"},"saturday":{"description":"Opening hours for Saturday.","type":"array","items":"$60:props:children:0:props:children:props:responses:200:content:application/json:schema:oneOf:1:properties:details:properties:opening_hours:properties:monday:items","descriptionNode":"$L91a"},"sunday":{"description":"Opening hours for Sunday.","type":"array","items":"$60:props:children:0:props:children:props:responses:200:content:application/json:schema:oneOf:1:properties:details:properties:opening_hours:properties:monday:items","descriptionNode":"$L91b"}},"descriptionNode":"$L91c"}},"required":["address","geo_location","opening_hours"],"descriptionNode":"$L91d"}},"required":["id","name","type","details"]}],"discriminator":{"propertyName":"type","mapping":{"online":"#/components/schemas/Location-Online","physical":"#/components/schemas/Location-Physical"}},"descriptionNode":"$L91e"},"examples":{"example_online_location":{"summary":"Online location request example","value":{"id":"8d9a7125-805f-40f3-a405-bc89765db996","name":"Grocery website","type":"online","details":{"domain":"groceries.example.com"}}},"example_physical_location":{"summary":"Physical location request example","value":{"id":"8d9a7125-805f-40f3-a405-bc89765db996","name":"Example Street Store","type":"physical","details":{"address":{"street_line_1":"123 Example Street","city":"Example city","postcode":"12345","country_code":"GB"},"geo_location":{"lat":12.3456,"lon":-12.3456},"opening_hours":{"monday":[{"from":"09:00","to":"15:00"},{"from":"16:00","to":"18:00"}],"tuesday":[{"from":"10:00","to":"13:00"},{"from":"16:00","to":"18:00"}]}}}}}}},"descriptionNode":"$L91f"},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"errorId":{"type":"string","description":"The ID of the error. You can share this ID with Revolut support for troubleshooting.","descriptionNode":"$L920"},"timestamp":{"type":"integer","description":"The date and time the error happened.","descriptionNode":"$L921"}},"required":"$62:props:children:0:props:children:props:responses:401:content:application/json:schema:required"}}},"descriptionNode":"$L922"},"404":{"description":"Not Found","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"errorId":{"type":"string","description":"The ID of the error. You can share this ID with Revolut support for troubleshooting.","descriptionNode":"$L923"},"timestamp":{"type":"integer","description":"The date and time the error happened.","descriptionNode":"$L924"}},"required":"$62:props:children:0:props:children:props:responses:401:content:application/json:schema:required"}}},"descriptionNode":"$L925"}},"requestBody":"$undefined","variantLabels":["Online location request example","Physical location request example"],"children":["$L926","$L927"]}]}],false]}] 89c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The ID of the webhook."}]]}] 89d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Your webhook's URL to which event notifications will be sent."}],"\n",["$","p","p-1",{"children":["Must be a valid HTTP or HTTPS URL, capable of receiving ",["$","code","code-0",{"children":"POST"}]," requests."]}],"\n",["$","div","inlinealert-0",{"data-type":"warning","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMark","color":"var(--rui-color-warning)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"Restrictions:"}],["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["Must be a valid URI as defined by ",["$","a","a-0",{"href":"https://datatracker.ietf.org/doc/html/rfc3986","target":"_blank","rel":"noreferrer","children":"RFC 3986"}]]}],"\n",["$","li","li-1",{"children":["URI scheme is required and must be either ",["$","code","code-0",{"children":"http"}]," or ",["$","code","code-1",{"children":"https"}]]}],"\n",["$","li","li-2",{"children":["URI host is required and cannot be ",["$","code","code-0",{"children":"localhost"}]," or an IP address"]}],"\n",["$","li","li-3",{"children":["Max length: ",["$","code","code-0",{"children":"2000"}]]}],"\n",["$","li","li-4",{"children":["Reserved or invalid characters must be percent-encoded (for example, use ",["$","code","code-0",{"children":"%20"}]," instead of a space)"]}],"\n"]}]]}]]}]]}] 89f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The available event types your can listen to."}]]}] 8a0:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"List of event types that the webhook is configured to listen to."}],"\n",["$","p","p-1",{"children":"Each event is related to status changes of a specific object in the Merchant API:"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Object","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Event types","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"Order"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["$","ul","ul-0",{"children":[" ",["$","li","li-0",{"children":["$","code","code-0",{"children":"ORDER_COMPLETED"}]}]," ",["$","li","li-1",{"children":["$","code","code-0",{"children":"ORDER_AUTHORISED"}]}]," ",["$","li","li-2",{"children":["$","code","code-0",{"children":"ORDER_CANCELLED"}]}]," ",["$","li","li-3",{"children":["$","code","code-0",{"children":"ORDER_FAILED"}]}]," ",["$","li","li-4",{"children":["$","code","code-0",{"children":"ORDER_INCREMENTAL_AUTHORISATION_AUTHORISED"}]}]," ",["$","li","li-5",{"children":["$","code","code-0",{"children":"ORDER_INCREMENTAL_AUTHORISATION_DECLINED"}]}]," ",["$","li","li-6",{"children":["$","code","code-0",{"children":"ORDER_INCREMENTAL_AUTHORISATION_FAILED"}]}]," "]}],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"Payment"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["$","ul","ul-0",{"children":[" ",["$","li","li-0",{"children":["$","code","code-0",{"children":"ORDER_PAYMENT_AUTHENTICATION_CHALLENGED"}]}]," ",["$","li","li-1",{"children":["$","code","code-0",{"children":"ORDER_PAYMENT_AUTHENTICATED"}]}]," ",["$","li","li-2",{"children":["$","code","code-0",{"children":"ORDER_PAYMENT_AUTHORISATION_STARTED"}]}]," ",["$","li","li-3",{"children":["$","code","code-0",{"children":"ORDER_PAYMENT_DECLINED"}]}]," ",["$","li","li-4",{"children":["$","code","code-0",{"children":"ORDER_PAYMENT_FAILED"}]}]," "]}],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"Subscription"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["$","ul","ul-0",{"children":[" ",["$","li","li-0",{"children":["$","code","code-0",{"children":"SUBSCRIPTION_INITIATED"}]}]," ",["$","li","li-1",{"children":["$","code","code-0",{"children":"SUBSCRIPTION_FINISHED"}]}]," ",["$","li","li-2",{"children":["$","code","code-0",{"children":"SUBSCRIPTION_CANCELLED"}]}]," ",["$","li","li-3",{"children":["$","code","code-0",{"children":"SUBSCRIPTION_OVERDUE"}]}]]}],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"Payout"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["$","ul","ul-0",{"children":[" ",["$","li","li-0",{"children":["$","code","code-0",{"children":"PAYOUT_INITIATED"}]}]," ",["$","li","li-1",{"children":["$","code","code-0",{"children":"PAYOUT_COMPLETED"}]}]," ",["$","li","li-2",{"children":["$","code","code-0",{"children":"PAYOUT_FAILED"}]}]," "]}],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-4",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"Dispute"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["$","ul","ul-0",{"children":[" ",["$","li","li-0",{"children":["$","code","code-0",{"children":"DISPUTE_ACTION_REQUIRED"}]}]," ",["$","li","li-1",{"children":["$","code","code-0",{"children":"DISPUTE_UNDER_REVIEW"}]}]," ",["$","li","li-2",{"children":["$","code","code-0",{"children":"DISPUTE_WON"}]}]," ",["$","li","li-3",{"children":["$","code","code-0",{"children":"DISPUTE_LOST"}]}]]}],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 8a1:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The signing secret for the webhook. Use it to verify the signature for the webhook request's payload."}]]}] 8a2:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A webhook object."}],"\n",["$","p","p-1",{"children":["Unlike the legacy API, ",["$","code","code-0",{"children":"signing_secret"}]," is included in all webhook responses, not only on creation."]}]]}] 8a3:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"OK"}]]}] 8a4:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An identifier that can be used to determine what went wrong."}],"\n",["$","p","p-1",{"children":"Error codes are not globally unique, but uniqueness is guaranteed within endpoints."}]]}] 8a5:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Some human readable text describing what went wrong."}]]}] 8a6:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://www.unixtimestamp.com/","target":"_blank","rel":"noreferrer","children":"UNIX timestamp"}]," of the date and time the error happened."]}]]}] 8a7:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Bad Request"}]]}] 8e9:"Send webhook event to webhook URL" 926:["$","div",null,{"className":"ezz1n30","children":[["$","div",null,{"data-header":"$undefined","className":"ezz1n31","children":["$","div",null,{"className":"y9a0do1","children":[["$","h2",null,{"id":"retrieve-location","children":[["$L928","$undefined"],["$","$L15",null,{"id":"retrieve-location"}]]}],["$","$L16",null,{"url":"/docs/api/merchant/2025-10-16/operations/retrieve-location.md"}]]}]}],"$undefined"]}] 92d:T8ae,
fetch("https://merchant.revolut.com/api/locations/__RP_TOK_0__", {
  method: "GET",
  headers: {
    "Authorization": "__RP_TOK_1__"
  }
})
  .then(response => response.json())
  .then(data => console.log(data));
92e:Td96,
package main

import (
  "fmt"
  "net/http"
)

func main() {
  url := "https://merchant.revolut.com/api/locations/__RP_TOK_0__"
  req, _ := http.NewRequest("GET", url, nil)
  req.Header.Add("Authorization", "__RP_TOK_1__")

  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  fmt.Println(res)
}
92f:T6c2,
import requests

url = "https://merchant.revolut.com/api/locations/__RP_TOK_0__"
headers = {
  "Authorization": "__RP_TOK_1__"
}

response = requests.get(url, headers=headers)
print(response.json())
930:T153a,
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;

public class Main {
  public static void main(String[] args) {
    HttpClient client = HttpClient.newHttpClient();
    HttpRequest request = HttpRequest.newBuilder()
      .uri(URI.create("https://merchant.revolut.com/api/locations/__RP_TOK_0__"))
      .header("Authorization", "__RP_TOK_1__")
      .GET(HttpRequest.BodyPublishers.noBody())
      .build();

    client.sendAsync(request, HttpResponse.BodyHandlers.ofString())
      .thenApply(HttpResponse::body)
      .thenAccept(System.out::println)
      .join();
  }
}
931:T145a,
using System.Net.Http;
using System.Net.Http.Headers;

var client = new HttpClient();
var request = new HttpRequestMessage
{
  Method = HttpMethod.Get,
  RequestUri = new Uri("https://merchant.revolut.com/api/locations/__RP_TOK_0__"),
  Headers =
  {
    { "Authorization", "__RP_TOK_1__" },
  }
};

using (var response = await client.SendAsync(request))
{
  response.EnsureSuccessStatusCode();
  var body = await response.Content.ReadAsStringAsync();
  Console.WriteLine(body);
}
932:T8b6,
fetch("https://sandbox-merchant.revolut.com/api/locations/__RP_TOK_0__", {
  method: "GET",
  headers: {
    "Authorization": "__RP_TOK_1__"
  }
})
  .then(response => response.json())
  .then(data => console.log(data));
933:Td9e,
package main

import (
  "fmt"
  "net/http"
)

func main() {
  url := "https://sandbox-merchant.revolut.com/api/locations/__RP_TOK_0__"
  req, _ := http.NewRequest("GET", url, nil)
  req.Header.Add("Authorization", "__RP_TOK_1__")

  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  fmt.Println(res)
}
934:T6ca,
import requests

url = "https://sandbox-merchant.revolut.com/api/locations/__RP_TOK_0__"
headers = {
  "Authorization": "__RP_TOK_1__"
}

response = requests.get(url, headers=headers)
print(response.json())
935:T1542,
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;

public class Main {
  public static void main(String[] args) {
    HttpClient client = HttpClient.newHttpClient();
    HttpRequest request = HttpRequest.newBuilder()
      .uri(URI.create("https://sandbox-merchant.revolut.com/api/locations/__RP_TOK_0__"))
      .header("Authorization", "__RP_TOK_1__")
      .GET(HttpRequest.BodyPublishers.noBody())
      .build();

    client.sendAsync(request, HttpResponse.BodyHandlers.ofString())
      .thenApply(HttpResponse::body)
      .thenAccept(System.out::println)
      .join();
  }
}
936:T1462,
using System.Net.Http;
using System.Net.Http.Headers;

var client = new HttpClient();
var request = new HttpRequestMessage
{
  Method = HttpMethod.Get,
  RequestUri = new Uri("https://sandbox-merchant.revolut.com/api/locations/__RP_TOK_0__"),
  Headers =
  {
    { "Authorization", "__RP_TOK_1__" },
  }
};

using (var response = await client.SendAsync(request))
{
  response.EnsureSuccessStatusCode();
  var body = await response.Content.ReadAsStringAsync();
  Console.WriteLine(body);
}
927:["$","div",null,{"className":"ezz1n30","children":[["$","div",null,{"data-header":"$undefined","className":"ezz1n31","children":["$L929",["$","$L85",null,{"parameters":[{"name":"Authorization","in":"header","schema":{"type":"string","format":"Bearer ","examples":"$62:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:0:schema:examples"},"required":true,"description":"This parameter accepts the [Merchant API Secret key](https://business.revolut.com/settings/apis?tab=merchant-api) to authorise requests coming from the merchant's backend. \n\nIt ensures that ensures that each request is authenticated and authorised by verifying the secret key. The secret key should be included in all request headers as a `Bearer` token.\n\n:::info\nFor more information, see: [Authentication](https://developer.revolut.com/docs/api/merchant#authentication)\n:::","descriptionNode":"$L92a"},{"name":"location_id","schema":{"type":"string","format":"uuid","description":"A UUID string, typically used to identify resources.","descriptionNode":"$L92b"},"in":"path","required":true,"description":"The ID of the location.","descriptionNode":"$L92c"}],"requestBody":"$undefined","heading":"Request","requestBodySchemaTitle":"Request body","headingAs":"h3"}],["$","$L89",null,{"responses":"$60:props:children:0:props:children:props:responses","headingAs":"h3"}]]}],["$","div",null,{"className":"ezz1n32","children":[[["$","$L8a",null,{"itemsByServer":{"https://merchant.revolut.com":[{"id":"curl","label":"cURL","templateCode":"curl -X GET \"https://merchant.revolut.com/api/locations/__RP_TOK_0__\" \\\n -H \"Authorization: __RP_TOK_1__\"","templateHtml":"
curl -X GET \"https://merchant.revolut.com/api/locations/__RP_TOK_0__\" \\\n  -H \"Authorization: __RP_TOK_1__\"
","tokens":[{"marker":"__RP_TOK_0__","paramName":"location_id","paramIn":"path","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["shell-double-inner"]}],"defaults":{"header:Authorization":"Bearer ","path:location_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"javascript","label":"JavaScript","templateCode":"fetch(\"https://merchant.revolut.com/api/locations/__RP_TOK_0__\", {\n method: \"GET\",\n headers: {\n \"Authorization\": \"__RP_TOK_1__\"\n }\n})\n .then(response => response.json())\n .then(data => console.log(data));","templateHtml":"$92d","tokens":[{"marker":"__RP_TOK_0__","paramName":"location_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","path:location_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"go","label":"Go","templateCode":"package main\n\nimport (\n \"fmt\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://merchant.revolut.com/api/locations/__RP_TOK_0__\"\n req, _ := http.NewRequest(\"GET\", url, nil)\n req.Header.Add(\"Authorization\", \"__RP_TOK_1__\")\n\n res, _ := http.DefaultClient.Do(req)\n defer res.Body.Close()\n fmt.Println(res)\n}","templateHtml":"$92e","tokens":[{"marker":"__RP_TOK_0__","paramName":"location_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","path:location_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"python","label":"Python","templateCode":"import requests\n\nurl = \"https://merchant.revolut.com/api/locations/__RP_TOK_0__\"\nheaders = {\n \"Authorization\": \"__RP_TOK_1__\"\n}\n\nresponse = requests.get(url, headers=headers)\nprint(response.json())","templateHtml":"$92f","tokens":[{"marker":"__RP_TOK_0__","paramName":"location_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","path:location_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"java","label":"Java","templateCode":"import java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\nimport java.net.URI;\n\npublic class Main {\n public static void main(String[] args) {\n HttpClient client = HttpClient.newHttpClient();\n HttpRequest request = HttpRequest.newBuilder()\n .uri(URI.create(\"https://merchant.revolut.com/api/locations/__RP_TOK_0__\"))\n .header(\"Authorization\", \"__RP_TOK_1__\")\n .GET(HttpRequest.BodyPublishers.noBody())\n .build();\n\n client.sendAsync(request, HttpResponse.BodyHandlers.ofString())\n .thenApply(HttpResponse::body)\n .thenAccept(System.out::println)\n .join();\n }\n}","templateHtml":"$930","tokens":[{"marker":"__RP_TOK_0__","paramName":"location_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","path:location_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"csharp","label":"C#","templateCode":"using System.Net.Http;\nusing System.Net.Http.Headers;\n\nvar client = new HttpClient();\nvar request = new HttpRequestMessage\n{\n Method = HttpMethod.Get,\n RequestUri = new Uri(\"https://merchant.revolut.com/api/locations/__RP_TOK_0__\"),\n Headers =\n {\n { \"Authorization\", \"__RP_TOK_1__\" },\n }\n};\n\nusing (var response = await client.SendAsync(request))\n{\n response.EnsureSuccessStatusCode();\n var body = await response.Content.ReadAsStringAsync();\n Console.WriteLine(body);\n}","templateHtml":"$931","tokens":[{"marker":"__RP_TOK_0__","paramName":"location_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","path:location_id":"123e4567-e89b-12d3-a456-426614174000"}}],"https://sandbox-merchant.revolut.com":[{"id":"curl","label":"cURL","templateCode":"curl -X GET \"https://sandbox-merchant.revolut.com/api/locations/__RP_TOK_0__\" \\\n -H \"Authorization: __RP_TOK_1__\"","templateHtml":"
curl -X GET \"https://sandbox-merchant.revolut.com/api/locations/__RP_TOK_0__\" \\\n  -H \"Authorization: __RP_TOK_1__\"
","tokens":[{"marker":"__RP_TOK_0__","paramName":"location_id","paramIn":"path","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["shell-double-inner"]}],"defaults":{"header:Authorization":"Bearer ","path:location_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"javascript","label":"JavaScript","templateCode":"fetch(\"https://sandbox-merchant.revolut.com/api/locations/__RP_TOK_0__\", {\n method: \"GET\",\n headers: {\n \"Authorization\": \"__RP_TOK_1__\"\n }\n})\n .then(response => response.json())\n .then(data => console.log(data));","templateHtml":"$932","tokens":[{"marker":"__RP_TOK_0__","paramName":"location_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","path:location_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"go","label":"Go","templateCode":"package main\n\nimport (\n \"fmt\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://sandbox-merchant.revolut.com/api/locations/__RP_TOK_0__\"\n req, _ := http.NewRequest(\"GET\", url, nil)\n req.Header.Add(\"Authorization\", \"__RP_TOK_1__\")\n\n res, _ := http.DefaultClient.Do(req)\n defer res.Body.Close()\n fmt.Println(res)\n}","templateHtml":"$933","tokens":[{"marker":"__RP_TOK_0__","paramName":"location_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","path:location_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"python","label":"Python","templateCode":"import requests\n\nurl = \"https://sandbox-merchant.revolut.com/api/locations/__RP_TOK_0__\"\nheaders = {\n \"Authorization\": \"__RP_TOK_1__\"\n}\n\nresponse = requests.get(url, headers=headers)\nprint(response.json())","templateHtml":"$934","tokens":[{"marker":"__RP_TOK_0__","paramName":"location_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","path:location_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"java","label":"Java","templateCode":"import java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\nimport java.net.URI;\n\npublic class Main {\n public static void main(String[] args) {\n HttpClient client = HttpClient.newHttpClient();\n HttpRequest request = HttpRequest.newBuilder()\n .uri(URI.create(\"https://sandbox-merchant.revolut.com/api/locations/__RP_TOK_0__\"))\n .header(\"Authorization\", \"__RP_TOK_1__\")\n .GET(HttpRequest.BodyPublishers.noBody())\n .build();\n\n client.sendAsync(request, HttpResponse.BodyHandlers.ofString())\n .thenApply(HttpResponse::body)\n .thenAccept(System.out::println)\n .join();\n }\n}","templateHtml":"$935","tokens":[{"marker":"__RP_TOK_0__","paramName":"location_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","path:location_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"csharp","label":"C#","templateCode":"using System.Net.Http;\nusing System.Net.Http.Headers;\n\nvar client = new HttpClient();\nvar request = new HttpRequestMessage\n{\n Method = HttpMethod.Get,\n RequestUri = new Uri(\"https://sandbox-merchant.revolut.com/api/locations/__RP_TOK_0__\"),\n Headers =\n {\n { \"Authorization\", \"__RP_TOK_1__\" },\n }\n};\n\nusing (var response = await client.SendAsync(request))\n{\n response.EnsureSuccessStatusCode();\n var body = await response.Content.ReadAsStringAsync();\n Console.WriteLine(body);\n}","templateHtml":"$936","tokens":[{"marker":"__RP_TOK_0__","paramName":"location_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","path:location_id":"123e4567-e89b-12d3-a456-426614174000"}}]},"method":"get","servers":"$62:props:children:0:props:children:props:children:1:props:children:1:props:children:0:0:props:servers","path":"/api/locations/{location_id}","parameters":["$927:props:children:0:props:children:1:props:parameters:0","$927:props:children:0:props:children:1:props:parameters:1"]}],"$L937"],"$L938","$L939"]}]]}] 83d:["$","div","CodeBlock-0",{"className":"wzy01m0 _18b50nc0","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"
'Authorization: Bearer <yourSecretApiKey>'
"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"'Authorization: Bearer '\n"}]}]]}] 8a8:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An identifier that can be used to determine what went wrong."}],"\n",["$","p","p-1",{"children":"Error codes are not globally unique, but uniqueness is guaranteed within endpoints."}]]}] 8a9:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Some human readable text describing what went wrong."}]]}] 8aa:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://www.unixtimestamp.com/","target":"_blank","rel":"noreferrer","children":"UNIX timestamp"}]," of the date and time the error happened."]}]]}] 8ab:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unauthorized"}]]}] 8ac:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An identifier that can be used to determine what went wrong."}],"\n",["$","p","p-1",{"children":"Error codes are not globally unique, but uniqueness is guaranteed within endpoints."}]]}] 8ad:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Some human readable text describing what went wrong."}]]}] 8ae:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://www.unixtimestamp.com/","target":"_blank","rel":"noreferrer","children":"UNIX timestamp"}]," of the date and time the error happened."]}]]}] 8af:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unprocessable Content"}]]}] 8b0:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Your webhook's URL to which event notifications will be sent."}],"\n",["$","p","p-1",{"children":["Must be a valid HTTP or HTTPS URL, capable of receiving ",["$","code","code-0",{"children":"POST"}]," requests."]}],"\n",["$","div","inlinealert-0",{"data-type":"warning","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMark","color":"var(--rui-color-warning)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"Restrictions:"}],["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["Must be a valid URI as defined by ",["$","a","a-0",{"href":"https://datatracker.ietf.org/doc/html/rfc3986","target":"_blank","rel":"noreferrer","children":"RFC 3986"}]]}],"\n",["$","li","li-1",{"children":["URI scheme is required and must be either ",["$","code","code-0",{"children":"http"}]," or ",["$","code","code-1",{"children":"https"}]]}],"\n",["$","li","li-2",{"children":["URI host is required and cannot be ",["$","code","code-0",{"children":"localhost"}]," or an IP address"]}],"\n",["$","li","li-3",{"children":["Max length: ",["$","code","code-0",{"children":"2000"}]]}],"\n",["$","li","li-4",{"children":["Reserved or invalid characters must be percent-encoded (for example, use ",["$","code","code-0",{"children":"%20"}]," instead of a space)"]}],"\n"]}]]}]]}]]}] 8b2:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The available event types your can listen to."}]]}] 8b3:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"List of event types that the webhook is configured to listen to."}],"\n",["$","p","p-1",{"children":"Each event is related to status changes of a specific object in the Merchant API:"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Object","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Event types","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"Order"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["$","ul","ul-0",{"children":[" ",["$","li","li-0",{"children":["$","code","code-0",{"children":"ORDER_COMPLETED"}]}]," ",["$","li","li-1",{"children":["$","code","code-0",{"children":"ORDER_AUTHORISED"}]}]," ",["$","li","li-2",{"children":["$","code","code-0",{"children":"ORDER_CANCELLED"}]}]," ",["$","li","li-3",{"children":["$","code","code-0",{"children":"ORDER_FAILED"}]}]," ",["$","li","li-4",{"children":["$","code","code-0",{"children":"ORDER_INCREMENTAL_AUTHORISATION_AUTHORISED"}]}]," ",["$","li","li-5",{"children":["$","code","code-0",{"children":"ORDER_INCREMENTAL_AUTHORISATION_DECLINED"}]}]," ",["$","li","li-6",{"children":["$","code","code-0",{"children":"ORDER_INCREMENTAL_AUTHORISATION_FAILED"}]}]," "]}],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"Payment"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["$","ul","ul-0",{"children":[" ",["$","li","li-0",{"children":["$","code","code-0",{"children":"ORDER_PAYMENT_AUTHENTICATION_CHALLENGED"}]}]," ",["$","li","li-1",{"children":["$","code","code-0",{"children":"ORDER_PAYMENT_AUTHENTICATED"}]}]," ",["$","li","li-2",{"children":["$","code","code-0",{"children":"ORDER_PAYMENT_AUTHORISATION_STARTED"}]}]," ",["$","li","li-3",{"children":["$","code","code-0",{"children":"ORDER_PAYMENT_DECLINED"}]}]," ",["$","li","li-4",{"children":["$","code","code-0",{"children":"ORDER_PAYMENT_FAILED"}]}]," "]}],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"Subscription"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["$","ul","ul-0",{"children":[" ",["$","li","li-0",{"children":["$","code","code-0",{"children":"SUBSCRIPTION_INITIATED"}]}]," ",["$","li","li-1",{"children":["$","code","code-0",{"children":"SUBSCRIPTION_FINISHED"}]}]," ",["$","li","li-2",{"children":["$","code","code-0",{"children":"SUBSCRIPTION_CANCELLED"}]}]," ",["$","li","li-3",{"children":["$","code","code-0",{"children":"SUBSCRIPTION_OVERDUE"}]}]]}],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"Payout"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["$","ul","ul-0",{"children":[" ",["$","li","li-0",{"children":["$","code","code-0",{"children":"PAYOUT_INITIATED"}]}]," ",["$","li","li-1",{"children":["$","code","code-0",{"children":"PAYOUT_COMPLETED"}]}]," ",["$","li","li-2",{"children":["$","code","code-0",{"children":"PAYOUT_FAILED"}]}]," "]}],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-4",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"Dispute"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["$","ul","ul-0",{"children":[" ",["$","li","li-0",{"children":["$","code","code-0",{"children":"DISPUTE_ACTION_REQUIRED"}]}]," ",["$","li","li-1",{"children":["$","code","code-0",{"children":"DISPUTE_UNDER_REVIEW"}]}]," ",["$","li","li-2",{"children":["$","code","code-0",{"children":"DISPUTE_WON"}]}]," ",["$","li","li-3",{"children":["$","code","code-0",{"children":"DISPUTE_LOST"}]}]]}],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 8bd:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Set up a webhook URL so that the Merchant API can push event notifications to the specified URL."}],"\n",["$","div","inlinealert-0",{"data-type":"warning","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMark","color":"var(--rui-color-warning)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":["Merchants can register a ",["$","strong","strong-0",{"children":"maximum of 10 webhook URLs"}],". If you attempt to register more than 10, the API will return a ",["$","code","code-0",{"children":"422 - Unprocessable Content"}]," error."]}],["$","p","p-1",{"children":"Ensure your webhook registrations are necessary and within the allowed limit."}]]}]]}]]}] 8be:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["This parameter accepts the ",["$","a","a-0",{"href":"https://business.revolut.com/settings/apis?tab=merchant-api","target":"_blank","rel":"noreferrer","children":"Merchant API Secret key"}]," to authorise requests coming from the merchant's backend."]}],"\n",["$","p","p-1",{"children":["It ensures that ensures that each request is authenticated and authorised by verifying the secret key. The secret key should be included in all request headers as a ",["$","code","code-0",{"children":"Bearer"}]," token."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#authentication","target":"_blank","rel":"noreferrer","children":"Authentication"}]]}]}]]}]]}] 8bf:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The version of the Merchant API, specified in ",["$","code","code-0",{"children":"YYYY-MM-DD"}]," format."]}],"\n",["$","p","p-1",{"children":["This endpoint is available from version ",["$","code","code-0",{"children":"2024-09-01"}],". If a version earlier than ",["$","code","code-1",{"children":"2024-09-01"}]," is provided, the endpoint returns a ",["$","code","code-2",{"children":"404"}]," response."]}],"\n",["$","p","p-2",{"children":"If not specified, you will receive an error."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information about API versioning, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/reference/versioning/api-versions","target":"_blank","rel":"noreferrer","children":"API versions"}],"."]}]}]]}]]}] 937:["$","$L10d",null,{"security":[{"Api-Key":[]}],"authorization":{"Api-Key":{"type":"apiKey","in":"header","name":"Authorization","description":"Each Merchant API request must contain an authorization header in the following format:\n\n```\n'Authorization: Bearer '\n```\n\nTo use this API, you need to generate API keys from your Revolut Business account. The Secret key is used in the authorization header for all server calls, while the Public key is provided with payment methods at checkout.\n\n:::info\nFor detailed instructions on generating your API keys, see: [Generate API keys](https://developer.revolut.com/docs/guides/merchant/get-started#generate-api-keys).\n:::","descriptionNode":"$L93a"}}}] 938:["$","$L10f",null,{"exampleBlocks":{},"title":"Request body samples","headingAs":"h4"}] 939:["$","$L110",null,{"exampleBlocks":{"200":{"application/json":{"variants":[{"key":"example_online_location","label":"Online location request example","rawValue":"$60:props:children:0:props:children:props:responses:200:content:application/json:examples:example_online_location:value","block":"$L93b"},{"key":"example_physical_location","label":"Physical location request example","rawValue":"$60:props:children:0:props:children:props:responses:200:content:application/json:examples:example_physical_location:value","block":"$L93c"}],"syncedPropertyName":"type"}},"401":{"application/json":{"variants":[{"key":"default","label":"Example","rawValue":{"errorId":"string","timestamp":123},"block":"$L93d"}],"syncedPropertyName":"$undefined"}},"404":{"application/json":{"variants":[{"key":"default","label":"Example","rawValue":{"errorId":"string","timestamp":123},"block":"$L93e"}],"syncedPropertyName":"$undefined"}}},"headingAs":"h4"}] 8cf:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["If the webhook event was delivered successfully, we recommend to respond with a ",["$","code","code-0",{"children":"204"}]," code."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["You can respond to and acknowledge the delivery of a webhook event by any HTTP response code between ",["$","code","code-0",{"children":"200-399"}],"."]}]}]]}]]}] 8d0:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["If the webhook event delivery times out or the delivery of the events fails, you can respond with any HTTP ",["$","code","code-0",{"children":"4XX"}]," code. In this case, Revolut will retry sending the webhook event 3 more times, each with a 10-minute delay."]}]]}] 8d2:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The event type of the webhook notification that's sent by Revolut to your webhook URL."}],"\n",["$","p","p-1",{"children":"Each event is related to status changes of a specific object in the Merchant API:"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Object","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Event types","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"Order"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["$","ul","ul-0",{"children":[" ",["$","li","li-0",{"children":["$","code","code-0",{"children":"ORDER_COMPLETED"}]}]," ",["$","li","li-1",{"children":["$","code","code-0",{"children":"ORDER_AUTHORISED"}]}]," ",["$","li","li-2",{"children":["$","code","code-0",{"children":"ORDER_CANCELLED"}]}]," ",["$","li","li-3",{"children":["$","code","code-0",{"children":"ORDER_FAILED"}]}]," ",["$","li","li-4",{"children":["$","code","code-0",{"children":"ORDER_INCREMENTAL_AUTHORISATION_AUTHORISED"}]}]," ",["$","li","li-5",{"children":["$","code","code-0",{"children":"ORDER_INCREMENTAL_AUTHORISATION_DECLINED"}]}]," ",["$","li","li-6",{"children":["$","code","code-0",{"children":"ORDER_INCREMENTAL_AUTHORISATION_FAILED"}]}]," "]}],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"Payment"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["$","ul","ul-0",{"children":[" ",["$","li","li-0",{"children":["$","code","code-0",{"children":"ORDER_PAYMENT_AUTHENTICATION_CHALLENGED"}]}]," ",["$","li","li-1",{"children":["$","code","code-0",{"children":"ORDER_PAYMENT_AUTHENTICATED"}]}]," ",["$","li","li-2",{"children":["$","code","code-0",{"children":"ORDER_PAYMENT_AUTHORISATION_STARTED"}]}]," ",["$","li","li-3",{"children":["$","code","code-0",{"children":"ORDER_PAYMENT_DECLINED"}]}]," ",["$","li","li-4",{"children":["$","code","code-0",{"children":"ORDER_PAYMENT_FAILED"}]}]," "]}],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"Subscription"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["$","ul","ul-0",{"children":[" ",["$","li","li-0",{"children":["$","code","code-0",{"children":"SUBSCRIPTION_INITIATED"}]}]," ",["$","li","li-1",{"children":["$","code","code-0",{"children":"SUBSCRIPTION_FINISHED"}]}]," ",["$","li","li-2",{"children":["$","code","code-0",{"children":"SUBSCRIPTION_CANCELLED"}]}]," ",["$","li","li-3",{"children":["$","code","code-0",{"children":"SUBSCRIPTION_OVERDUE"}]}]]}],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"Payout"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["$","ul","ul-0",{"children":[" ",["$","li","li-0",{"children":["$","code","code-0",{"children":"PAYOUT_INITIATED"}]}]," ",["$","li","li-1",{"children":["$","code","code-0",{"children":"PAYOUT_COMPLETED"}]}]," ",["$","li","li-2",{"children":["$","code","code-0",{"children":"PAYOUT_FAILED"}]}]," "]}],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-4",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"Dispute"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["$","ul","ul-0",{"children":[" ",["$","li","li-0",{"children":["$","code","code-0",{"children":"DISPUTE_ACTION_REQUIRED"}]}]," ",["$","li","li-1",{"children":["$","code","code-0",{"children":"DISPUTE_UNDER_REVIEW"}]}]," ",["$","li","li-2",{"children":["$","code","code-0",{"children":"DISPUTE_WON"}]}]," ",["$","li","li-3",{"children":["$","code","code-0",{"children":"DISPUTE_LOST"}]}]]}],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 8d3:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The ID of the order the event is related to."}]]}] 8d4:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The information sent during order creation in the\n",["$","code","code-0",{"children":"merchant_order_data.reference"}]," field."]}]]}] 5f:["$","$7a","retrieve-location-list",{"children":[["$","section",null,{"className":"y9a0do0","data-variant":"endpoint","children":["$","$L7b",null,{"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","items":{"title":"Location","type":"object","description":"Location object represents merchant locations depending on type.","oneOf":[{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Unique ID representing the location where merchants sells products.\n\n:::info\nFor more information, see: [Locations](https://developer.revolut.com/docs/api/merchant#tag-locations).\n::: ","descriptionNode":"$L93f"},"name":{"type":"string","description":"Name of the location. \n\n:::warning\nThe `name` parameter's value must be unique across all locations.\n:::","descriptionNode":"$L940"},"type":{"type":"string","description":"Type of the location.\n\n| Value | Description |\n| ----- | ----------- |\n| `online` | Represents an online store. |\n| `physical` | Represents a physical point of sale. |","enum":"$60:props:children:0:props:children:props:responses:200:content:application/json:schema:oneOf:0:properties:type:enum","descriptionNode":"$L941"},"details":{"type":"object","description":"Additional details of the location.","properties":{"domain":{"type":"string","description":"Domain address of the location. Required for online locations.\n\n:::warning\nThe `domain` parameter's value must be unique across all locations.\n:::","descriptionNode":"$L942"}},"required":"$60:props:children:0:props:children:props:responses:200:content:application/json:schema:oneOf:0:properties:details:required","descriptionNode":"$L943"}},"required":"$60:props:children:0:props:children:props:responses:200:content:application/json:schema:oneOf:0:required"},{"title":"Location","type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Unique ID representing the location where merchants sells products.\n\n:::info\nFor more information, see: [Locations](https://developer.revolut.com/docs/api/merchant#tag-locations).\n::: ","descriptionNode":"$L944"},"name":{"type":"string","description":"Name of the location. \n\n:::warning\nThe `name` parameter's value must be unique across all locations.\n:::","descriptionNode":"$L945"},"type":{"type":"string","description":"Type of the location.\n\n| Value | Description |\n| ----- | ----------- |\n| `online` | Represents an online store. |\n| `physical` | Represents a physical point of sale. |","enum":"$60:props:children:0:props:children:props:responses:200:content:application/json:schema:oneOf:0:properties:type:enum","descriptionNode":"$L946"},"details":{"type":"object","description":"Additional details of the location.","properties":{"address":{"type":"object","description":"Details of a physical address.","properties":{"street_line_1":{"type":"string","description":"Primary address line.","maxLength":100,"descriptionNode":"$L947"},"street_line_2":{"type":"string","description":"Secondary address line, such as floor and apartment number.","maxLength":100,"descriptionNode":"$L948"},"region":{"type":"string","description":"State or province of the address.","maxLength":100,"descriptionNode":"$L949"},"city":{"type":"string","description":"City of the address.","maxLength":100,"descriptionNode":"$L94a"},"country_code":{"type":"string","pattern":"^[A-Z]{2}$","description":"ISO 2-letter country code.","minLength":2,"maxLength":2,"descriptionNode":"$L94b"},"postcode":{"type":"string","description":"Postal code of the address.","maxLength":100,"descriptionNode":"$L94c"}},"required":"$60:props:children:0:props:children:props:responses:200:content:application/json:schema:oneOf:1:properties:details:properties:address:required","descriptionNode":"$L94d"},"geo_location":{"type":"object","description":"Coordinates of the location.","properties":{"lat":{"type":"number","format":"double","description":"The latitude of the location, in decimal degrees.","minimum":-90,"maximum":90,"descriptionNode":"$L94e"},"lon":{"type":"number","format":"double","description":"To longitude of the location, in decimal degrees.","minimum":-180,"maximum":180,"descriptionNode":"$L94f"}},"required":"$60:props:children:0:props:children:props:responses:200:content:application/json:schema:oneOf:1:properties:details:properties:geo_location:required","descriptionNode":"$L950"},"opening_hours":{"type":"object","description":"An object containing the opening hours for each day of the week.\n\nA day can have multiple intervals (e.g., closing for a lunch break).","properties":{"monday":{"description":"Opening hours for Monday.","type":"array","items":{"type":"object","properties":{"from":{"type":"string","format":"time","description":"The local time when the interval begins.\n\n:::note\nThe format is `hh:mm[:ss]`; seconds are optional and must be `00` if provided.\n:::","examples":"$60:props:children:0:props:children:props:responses:200:content:application/json:schema:oneOf:1:properties:details:properties:opening_hours:properties:monday:items:properties:from:examples","descriptionNode":"$L951"},"to":{"type":"string","format":"time","description":"The local time when the interval ends.\n\n:::note\nThe format is `hh:mm[:ss]`; seconds are optional and must be `00` if provided.\n:::","examples":"$60:props:children:0:props:children:props:responses:200:content:application/json:schema:oneOf:1:properties:details:properties:opening_hours:properties:monday:items:properties:to:examples","descriptionNode":"$L952"}},"required":"$60:props:children:0:props:children:props:responses:200:content:application/json:schema:oneOf:1:properties:details:properties:opening_hours:properties:monday:items:required"},"descriptionNode":"$L953"},"tuesday":{"description":"Opening hours for Tuesday.","type":"array","items":"$5f:props:children:0:props:children:props:responses:200:content:application/json:schema:items:oneOf:1:properties:details:properties:opening_hours:properties:monday:items","descriptionNode":"$L954"},"wednesday":{"description":"Opening hours for Wednesday.","type":"array","items":"$5f:props:children:0:props:children:props:responses:200:content:application/json:schema:items:oneOf:1:properties:details:properties:opening_hours:properties:monday:items","descriptionNode":"$L955"},"thursday":{"description":"Opening hours for Thursday.","type":"array","items":"$5f:props:children:0:props:children:props:responses:200:content:application/json:schema:items:oneOf:1:properties:details:properties:opening_hours:properties:monday:items","descriptionNode":"$L956"},"friday":{"description":"Opening hours for Friday.","type":"array","items":"$5f:props:children:0:props:children:props:responses:200:content:application/json:schema:items:oneOf:1:properties:details:properties:opening_hours:properties:monday:items","descriptionNode":"$L957"},"saturday":{"description":"Opening hours for Saturday.","type":"array","items":"$5f:props:children:0:props:children:props:responses:200:content:application/json:schema:items:oneOf:1:properties:details:properties:opening_hours:properties:monday:items","descriptionNode":"$L958"},"sunday":{"description":"Opening hours for Sunday.","type":"array","items":"$5f:props:children:0:props:children:props:responses:200:content:application/json:schema:items:oneOf:1:properties:details:properties:opening_hours:properties:monday:items","descriptionNode":"$L959"}},"descriptionNode":"$L95a"}},"required":"$60:props:children:0:props:children:props:responses:200:content:application/json:schema:oneOf:1:properties:details:required","descriptionNode":"$L95b"}},"required":"$60:props:children:0:props:children:props:responses:200:content:application/json:schema:oneOf:1:required"}],"discriminator":"$60:props:children:0:props:children:props:responses:200:content:application/json:schema:discriminator","descriptionNode":"$L95c"}},"examples":{"list_of_locations":{"summary":"Location list","value":[{"id":"8d9a7125-805f-40f3-a405-bc89765db996","name":"Grocery website","type":"online","details":{"domain":"groceries.example.com"}},{"id":"066223df-d5a8-42f0-b3ce-688c7a76f9a8","name":"Cars website","type":"online","details":{"domain":"cars.example.com"}},{"id":"299050a4-cc7a-44b0-8b2b-7cd1e335ef38","name":"Example Street Store","type":"physical","details":{"address":{"street_line_1":"123 Example Street","city":"Example city","postcode":"12345","country_code":"GB"},"geo_location":{"lat":12.3456,"lon":-12.3456},"opening_hours":{"monday":[{"from":"09:00","to":"15:00"},{"from":"16:00","to":"18:00"}],"tuesday":[{"from":"10:00","to":"13:00"},{"from":"16:00","to":"18:00"}]}}}]}}}},"descriptionNode":"$L95d"},"401":{"description":"Unauthorized","descriptionNode":"$L95e"}},"requestBody":"$undefined","variantLabels":[],"children":["$L95f","$L960"]}]}],false]}] 8e3:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Each Merchant API request must contain an authorization header in the following format:"}],"\n","$L961","\n",["$","p","p-1",{"children":"To use this API, you need to generate API keys from your Revolut Business account. The Secret key is used in the authorization header for all server calls, while the Public key is provided with payment methods at checkout."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For detailed instructions on generating your API keys, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/get-started#generate-api-keys","target":"_blank","rel":"noreferrer","children":"Generate API keys"}],"."]}]}]]}]]}] 8d5:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The reference sent in the ",["$","code","code-0",{"children":"reference"}]," field of the ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#increment-authorisation","target":"_blank","rel":"noreferrer","children":"Increment authorisation"}]," request. Only present for incremental authorisation events."]}]]}] 8d7:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The event type of the webhook notification that's sent by Revolut to your webhook URL."}],"\n",["$","p","p-1",{"children":"Each event is related to status changes of a specific object in the Merchant API:"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Object","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Event types","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"Order"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["$","ul","ul-0",{"children":[" ",["$","li","li-0",{"children":["$","code","code-0",{"children":"ORDER_COMPLETED"}]}]," ",["$","li","li-1",{"children":["$","code","code-0",{"children":"ORDER_AUTHORISED"}]}]," ",["$","li","li-2",{"children":["$","code","code-0",{"children":"ORDER_CANCELLED"}]}]," ",["$","li","li-3",{"children":["$","code","code-0",{"children":"ORDER_FAILED"}]}]," ",["$","li","li-4",{"children":["$","code","code-0",{"children":"ORDER_INCREMENTAL_AUTHORISATION_AUTHORISED"}]}]," ",["$","li","li-5",{"children":["$","code","code-0",{"children":"ORDER_INCREMENTAL_AUTHORISATION_DECLINED"}]}]," ",["$","li","li-6",{"children":["$","code","code-0",{"children":"ORDER_INCREMENTAL_AUTHORISATION_FAILED"}]}]," "]}],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"Payment"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["$","ul","ul-0",{"children":[" ",["$","li","li-0",{"children":["$","code","code-0",{"children":"ORDER_PAYMENT_AUTHENTICATION_CHALLENGED"}]}]," ",["$","li","li-1",{"children":["$","code","code-0",{"children":"ORDER_PAYMENT_AUTHENTICATED"}]}]," ",["$","li","li-2",{"children":["$","code","code-0",{"children":"ORDER_PAYMENT_AUTHORISATION_STARTED"}]}]," ",["$","li","li-3",{"children":["$","code","code-0",{"children":"ORDER_PAYMENT_DECLINED"}]}]," ",["$","li","li-4",{"children":["$","code","code-0",{"children":"ORDER_PAYMENT_FAILED"}]}]," "]}],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"Subscription"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["$","ul","ul-0",{"children":[" ",["$","li","li-0",{"children":["$","code","code-0",{"children":"SUBSCRIPTION_INITIATED"}]}]," ",["$","li","li-1",{"children":["$","code","code-0",{"children":"SUBSCRIPTION_FINISHED"}]}]," ",["$","li","li-2",{"children":["$","code","code-0",{"children":"SUBSCRIPTION_CANCELLED"}]}]," ",["$","li","li-3",{"children":["$","code","code-0",{"children":"SUBSCRIPTION_OVERDUE"}]}]]}],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"Payout"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["$","ul","ul-0",{"children":[" ",["$","li","li-0",{"children":["$","code","code-0",{"children":"PAYOUT_INITIATED"}]}]," ",["$","li","li-1",{"children":["$","code","code-0",{"children":"PAYOUT_COMPLETED"}]}]," ",["$","li","li-2",{"children":["$","code","code-0",{"children":"PAYOUT_FAILED"}]}]," "]}],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-4",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"Dispute"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["$","ul","ul-0",{"children":[" ",["$","li","li-0",{"children":["$","code","code-0",{"children":"DISPUTE_ACTION_REQUIRED"}]}]," ",["$","li","li-1",{"children":["$","code","code-0",{"children":"DISPUTE_UNDER_REVIEW"}]}]," ",["$","li","li-2",{"children":["$","code","code-0",{"children":"DISPUTE_WON"}]}]," ",["$","li","li-3",{"children":["$","code","code-0",{"children":"DISPUTE_LOST"}]}]]}],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 8d8:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The ID of the subscription the event is related to."}]]}] 8d9:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The information sent in the ",["$","code","code-0",{"children":"external_reference"}]," field of the ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#create-subscription","target":"_blank","rel":"noreferrer","children":"Create a subscription"}]," request."]}]]}] 8db:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The event type of the webhook notification that's sent by Revolut to your webhook URL."}],"\n",["$","p","p-1",{"children":"Each event is related to status changes of a specific object in the Merchant API:"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Object","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Event types","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"Order"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["$","ul","ul-0",{"children":[" ",["$","li","li-0",{"children":["$","code","code-0",{"children":"ORDER_COMPLETED"}]}]," ",["$","li","li-1",{"children":["$","code","code-0",{"children":"ORDER_AUTHORISED"}]}]," ",["$","li","li-2",{"children":["$","code","code-0",{"children":"ORDER_CANCELLED"}]}]," ",["$","li","li-3",{"children":["$","code","code-0",{"children":"ORDER_FAILED"}]}]," ",["$","li","li-4",{"children":["$","code","code-0",{"children":"ORDER_INCREMENTAL_AUTHORISATION_AUTHORISED"}]}]," ",["$","li","li-5",{"children":["$","code","code-0",{"children":"ORDER_INCREMENTAL_AUTHORISATION_DECLINED"}]}]," ",["$","li","li-6",{"children":["$","code","code-0",{"children":"ORDER_INCREMENTAL_AUTHORISATION_FAILED"}]}]," "]}],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"Payment"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["$","ul","ul-0",{"children":[" ",["$","li","li-0",{"children":["$","code","code-0",{"children":"ORDER_PAYMENT_AUTHENTICATION_CHALLENGED"}]}]," ",["$","li","li-1",{"children":["$","code","code-0",{"children":"ORDER_PAYMENT_AUTHENTICATED"}]}]," ",["$","li","li-2",{"children":["$","code","code-0",{"children":"ORDER_PAYMENT_AUTHORISATION_STARTED"}]}]," ",["$","li","li-3",{"children":["$","code","code-0",{"children":"ORDER_PAYMENT_DECLINED"}]}]," ",["$","li","li-4",{"children":["$","code","code-0",{"children":"ORDER_PAYMENT_FAILED"}]}]," "]}],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"Subscription"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["$","ul","ul-0",{"children":[" ",["$","li","li-0",{"children":["$","code","code-0",{"children":"SUBSCRIPTION_INITIATED"}]}]," ",["$","li","li-1",{"children":["$","code","code-0",{"children":"SUBSCRIPTION_FINISHED"}]}]," ",["$","li","li-2",{"children":["$","code","code-0",{"children":"SUBSCRIPTION_CANCELLED"}]}]," ",["$","li","li-3",{"children":["$","code","code-0",{"children":"SUBSCRIPTION_OVERDUE"}]}]]}],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"Payout"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["$","ul","ul-0",{"children":[" ",["$","li","li-0",{"children":["$","code","code-0",{"children":"PAYOUT_INITIATED"}]}]," ",["$","li","li-1",{"children":["$","code","code-0",{"children":"PAYOUT_COMPLETED"}]}]," ",["$","li","li-2",{"children":["$","code","code-0",{"children":"PAYOUT_FAILED"}]}]," "]}],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-4",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"Dispute"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["$","ul","ul-0",{"children":[" ",["$","li","li-0",{"children":["$","code","code-0",{"children":"DISPUTE_ACTION_REQUIRED"}]}]," ",["$","li","li-1",{"children":["$","code","code-0",{"children":"DISPUTE_UNDER_REVIEW"}]}]," ",["$","li","li-2",{"children":["$","code","code-0",{"children":"DISPUTE_WON"}]}]," ",["$","li","li-3",{"children":["$","code","code-0",{"children":"DISPUTE_LOST"}]}]]}],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 8dc:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The ID of the payout the event is related to."}]]}] 8de:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The event type of the webhook notification that's sent by Revolut to your webhook URL."}],"\n",["$","p","p-1",{"children":"Each event is related to status changes of a specific object in the Merchant API:"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Object","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Event types","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"Order"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["$","ul","ul-0",{"children":[" ",["$","li","li-0",{"children":["$","code","code-0",{"children":"ORDER_COMPLETED"}]}]," ",["$","li","li-1",{"children":["$","code","code-0",{"children":"ORDER_AUTHORISED"}]}]," ",["$","li","li-2",{"children":["$","code","code-0",{"children":"ORDER_CANCELLED"}]}]," ",["$","li","li-3",{"children":["$","code","code-0",{"children":"ORDER_FAILED"}]}]," ",["$","li","li-4",{"children":["$","code","code-0",{"children":"ORDER_INCREMENTAL_AUTHORISATION_AUTHORISED"}]}]," ",["$","li","li-5",{"children":["$","code","code-0",{"children":"ORDER_INCREMENTAL_AUTHORISATION_DECLINED"}]}]," ",["$","li","li-6",{"children":["$","code","code-0",{"children":"ORDER_INCREMENTAL_AUTHORISATION_FAILED"}]}]," "]}],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"Payment"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["$","ul","ul-0",{"children":[" ",["$","li","li-0",{"children":["$","code","code-0",{"children":"ORDER_PAYMENT_AUTHENTICATION_CHALLENGED"}]}]," ",["$","li","li-1",{"children":["$","code","code-0",{"children":"ORDER_PAYMENT_AUTHENTICATED"}]}]," ",["$","li","li-2",{"children":["$","code","code-0",{"children":"ORDER_PAYMENT_AUTHORISATION_STARTED"}]}]," ",["$","li","li-3",{"children":["$","code","code-0",{"children":"ORDER_PAYMENT_DECLINED"}]}]," ",["$","li","li-4",{"children":["$","code","code-0",{"children":"ORDER_PAYMENT_FAILED"}]}]," "]}],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"Subscription"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["$","ul","ul-0",{"children":[" ",["$","li","li-0",{"children":["$","code","code-0",{"children":"SUBSCRIPTION_INITIATED"}]}]," ",["$","li","li-1",{"children":["$","code","code-0",{"children":"SUBSCRIPTION_FINISHED"}]}]," ",["$","li","li-2",{"children":["$","code","code-0",{"children":"SUBSCRIPTION_CANCELLED"}]}]," ",["$","li","li-3",{"children":["$","code","code-0",{"children":"SUBSCRIPTION_OVERDUE"}]}]]}],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"Payout"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["$","ul","ul-0",{"children":[" ",["$","li","li-0",{"children":["$","code","code-0",{"children":"PAYOUT_INITIATED"}]}]," ",["$","li","li-1",{"children":["$","code","code-0",{"children":"PAYOUT_COMPLETED"}]}]," ",["$","li","li-2",{"children":["$","code","code-0",{"children":"PAYOUT_FAILED"}]}]," "]}],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-4",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"Dispute"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["$","ul","ul-0",{"children":[" ",["$","li","li-0",{"children":["$","code","code-0",{"children":"DISPUTE_ACTION_REQUIRED"}]}]," ",["$","li","li-1",{"children":["$","code","code-0",{"children":"DISPUTE_UNDER_REVIEW"}]}]," ",["$","li","li-2",{"children":["$","code","code-0",{"children":"DISPUTE_WON"}]}]," ",["$","li","li-3",{"children":["$","code","code-0",{"children":"DISPUTE_LOST"}]}]]}],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 8df:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The ID of the dispute the event is related to."}]]}] 8ea:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The following webhook event payload is sent as a HTTP POST request to the URL registered as the merchant's webhook server via the ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#create-webhook","target":"_blank","rel":"noreferrer","children":"Create a webhook"}]," operation."]}],"\n",["$","p","p-1",{"children":"The delivery of the webhook events happen asynchronously, based on the events you subscribed to."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/monitor-and-observe/webhooks/using-webhooks","target":"_blank","rel":"noreferrer","children":"Use webhooks to track order and payment lifecycle"}],"."]}]}]]}],"\n",["$","h4","h4-0",{"children":"IP allowlisting"}],"\n",["$","p","p-2",{"children":"To ensure secure delivery of webhook events, please allowlist the following IP addresses from which the events originate:"}],"\n",["$","p","p-3",{"children":["$","strong","strong-0",{"children":"Production webhook IPs:"}]}],"\n",["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["$","code","code-0",{"children":"35.246.21.235"}]}],"\n",["$","li","li-1",{"children":["$","code","code-0",{"children":"34.89.70.170"}]}],"\n"]}],"\n",["$","p","p-4",{"children":["$","strong","strong-0",{"children":"Sandbox webhook IPs:"}]}],"\n",["$","ul","ul-1",{"children":["\n",["$","li","li-0",{"children":["$","code","code-0",{"children":"35.242.130.242"}]}],"\n",["$","li","li-1",{"children":["$","code","code-0",{"children":"35.242.162.241"}]}],"\n"]}]]}] 8eb:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://www.unixtimestamp.com/","target":"_blank","rel":"noreferrer","children":"UNIX timestamp"}]," of the date and time when the webhook event was sent from Revolut. Used to verify the webhook event payload was actually sent by Revolut."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/monitor-and-observe/webhooks/verify-the-payload-signature","target":"_blank","rel":"noreferrer","children":"Verify payload signature"}]]}]}]]}]]}] 8ec:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The payload signature computed by Revolut using a Hash-based Message Authentication Code (HMAC). Used to verify the webhook event payload was actually sent by Revolut."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/monitor-and-observe/webhooks/verify-the-payload-signature","target":"_blank","rel":"noreferrer","children":"Verify payload signature"}]]}]}]]}]]}] 95f:["$","div",null,{"className":"ezz1n30","children":[["$","div",null,{"data-header":"$undefined","className":"ezz1n31","children":["$","div",null,{"className":"y9a0do1","children":[["$","h2",null,{"id":"retrieve-location-list","children":[["$L962","$undefined"],["$","$L15",null,{"id":"retrieve-location-list"}]]}],["$","$L16",null,{"url":"/docs/api/merchant/2025-10-16/operations/retrieve-location-list.md"}]]}]}],"$undefined"]}] 966:T8b3,
fetch("https://merchant.revolut.com/api/locations?type=__RP_TOK_0__", {
  method: "GET",
  headers: {
    "Authorization": "__RP_TOK_1__"
  }
})
  .then(response => response.json())
  .then(data => console.log(data));
967:Td9b,
package main

import (
  "fmt"
  "net/http"
)

func main() {
  url := "https://merchant.revolut.com/api/locations?type=__RP_TOK_0__"
  req, _ := http.NewRequest("GET", url, nil)
  req.Header.Add("Authorization", "__RP_TOK_1__")

  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  fmt.Println(res)
}
968:T6c7,
import requests

url = "https://merchant.revolut.com/api/locations?type=__RP_TOK_0__"
headers = {
  "Authorization": "__RP_TOK_1__"
}

response = requests.get(url, headers=headers)
print(response.json())
969:T153f,
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;

public class Main {
  public static void main(String[] args) {
    HttpClient client = HttpClient.newHttpClient();
    HttpRequest request = HttpRequest.newBuilder()
      .uri(URI.create("https://merchant.revolut.com/api/locations?type=__RP_TOK_0__"))
      .header("Authorization", "__RP_TOK_1__")
      .GET(HttpRequest.BodyPublishers.noBody())
      .build();

    client.sendAsync(request, HttpResponse.BodyHandlers.ofString())
      .thenApply(HttpResponse::body)
      .thenAccept(System.out::println)
      .join();
  }
}
96a:T145f,
using System.Net.Http;
using System.Net.Http.Headers;

var client = new HttpClient();
var request = new HttpRequestMessage
{
  Method = HttpMethod.Get,
  RequestUri = new Uri("https://merchant.revolut.com/api/locations?type=__RP_TOK_0__"),
  Headers =
  {
    { "Authorization", "__RP_TOK_1__" },
  }
};

using (var response = await client.SendAsync(request))
{
  response.EnsureSuccessStatusCode();
  var body = await response.Content.ReadAsStringAsync();
  Console.WriteLine(body);
}
96b:T8bb,
fetch("https://sandbox-merchant.revolut.com/api/locations?type=__RP_TOK_0__", {
  method: "GET",
  headers: {
    "Authorization": "__RP_TOK_1__"
  }
})
  .then(response => response.json())
  .then(data => console.log(data));
96c:Tda3,
package main

import (
  "fmt"
  "net/http"
)

func main() {
  url := "https://sandbox-merchant.revolut.com/api/locations?type=__RP_TOK_0__"
  req, _ := http.NewRequest("GET", url, nil)
  req.Header.Add("Authorization", "__RP_TOK_1__")

  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  fmt.Println(res)
}
96d:T6cf,
import requests

url = "https://sandbox-merchant.revolut.com/api/locations?type=__RP_TOK_0__"
headers = {
  "Authorization": "__RP_TOK_1__"
}

response = requests.get(url, headers=headers)
print(response.json())
96e:T1547,
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;

public class Main {
  public static void main(String[] args) {
    HttpClient client = HttpClient.newHttpClient();
    HttpRequest request = HttpRequest.newBuilder()
      .uri(URI.create("https://sandbox-merchant.revolut.com/api/locations?type=__RP_TOK_0__"))
      .header("Authorization", "__RP_TOK_1__")
      .GET(HttpRequest.BodyPublishers.noBody())
      .build();

    client.sendAsync(request, HttpResponse.BodyHandlers.ofString())
      .thenApply(HttpResponse::body)
      .thenAccept(System.out::println)
      .join();
  }
}
96f:T1467,
using System.Net.Http;
using System.Net.Http.Headers;

var client = new HttpClient();
var request = new HttpRequestMessage
{
  Method = HttpMethod.Get,
  RequestUri = new Uri("https://sandbox-merchant.revolut.com/api/locations?type=__RP_TOK_0__"),
  Headers =
  {
    { "Authorization", "__RP_TOK_1__" },
  }
};

using (var response = await client.SendAsync(request))
{
  response.EnsureSuccessStatusCode();
  var body = await response.Content.ReadAsStringAsync();
  Console.WriteLine(body);
}
960:["$","div",null,{"className":"ezz1n30","children":[["$","div",null,{"data-header":"$undefined","className":"ezz1n31","children":["$L963",["$","$L85",null,{"parameters":[{"name":"Authorization","in":"header","schema":{"type":"string","format":"Bearer ","examples":"$62:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:0:schema:examples"},"required":true,"description":"This parameter accepts the [Merchant API Secret key](https://business.revolut.com/settings/apis?tab=merchant-api) to authorise requests coming from the merchant's backend. \n\nIt ensures that ensures that each request is authenticated and authorised by verifying the secret key. The secret key should be included in all request headers as a `Bearer` token.\n\n:::info\nFor more information, see: [Authentication](https://developer.revolut.com/docs/api/merchant#authentication)\n:::","descriptionNode":"$L964"},{"name":"type","in":"query","schema":{"type":"string","enum":["online","physical"]},"description":"Filter the list by location type.","descriptionNode":"$L965"}],"requestBody":"$undefined","heading":"Request","requestBodySchemaTitle":"Request body","headingAs":"h3"}],["$","$L89",null,{"responses":"$5f:props:children:0:props:children:props:responses","headingAs":"h3"}]]}],["$","div",null,{"className":"ezz1n32","children":[[["$","$L8a",null,{"itemsByServer":{"https://merchant.revolut.com":[{"id":"curl","label":"cURL","templateCode":"curl -X GET \"https://merchant.revolut.com/api/locations?type=__RP_TOK_0__\" \\\n -H \"Authorization: __RP_TOK_1__\"","templateHtml":"
curl -X GET \"https://merchant.revolut.com/api/locations?type=__RP_TOK_0__\" \\\n  -H \"Authorization: __RP_TOK_1__\"
","tokens":[{"marker":"__RP_TOK_0__","paramName":"type","paramIn":"query","pipeline":["url-component","shell-double-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["shell-double-inner"]}],"defaults":{"header:Authorization":"Bearer ","query:type":"online"}},{"id":"javascript","label":"JavaScript","templateCode":"fetch(\"https://merchant.revolut.com/api/locations?type=__RP_TOK_0__\", {\n method: \"GET\",\n headers: {\n \"Authorization\": \"__RP_TOK_1__\"\n }\n})\n .then(response => response.json())\n .then(data => console.log(data));","templateHtml":"$966","tokens":[{"marker":"__RP_TOK_0__","paramName":"type","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","query:type":"online"}},{"id":"go","label":"Go","templateCode":"package main\n\nimport (\n \"fmt\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://merchant.revolut.com/api/locations?type=__RP_TOK_0__\"\n req, _ := http.NewRequest(\"GET\", url, nil)\n req.Header.Add(\"Authorization\", \"__RP_TOK_1__\")\n\n res, _ := http.DefaultClient.Do(req)\n defer res.Body.Close()\n fmt.Println(res)\n}","templateHtml":"$967","tokens":[{"marker":"__RP_TOK_0__","paramName":"type","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","query:type":"online"}},{"id":"python","label":"Python","templateCode":"import requests\n\nurl = \"https://merchant.revolut.com/api/locations?type=__RP_TOK_0__\"\nheaders = {\n \"Authorization\": \"__RP_TOK_1__\"\n}\n\nresponse = requests.get(url, headers=headers)\nprint(response.json())","templateHtml":"$968","tokens":[{"marker":"__RP_TOK_0__","paramName":"type","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","query:type":"online"}},{"id":"java","label":"Java","templateCode":"import java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\nimport java.net.URI;\n\npublic class Main {\n public static void main(String[] args) {\n HttpClient client = HttpClient.newHttpClient();\n HttpRequest request = HttpRequest.newBuilder()\n .uri(URI.create(\"https://merchant.revolut.com/api/locations?type=__RP_TOK_0__\"))\n .header(\"Authorization\", \"__RP_TOK_1__\")\n .GET(HttpRequest.BodyPublishers.noBody())\n .build();\n\n client.sendAsync(request, HttpResponse.BodyHandlers.ofString())\n .thenApply(HttpResponse::body)\n .thenAccept(System.out::println)\n .join();\n }\n}","templateHtml":"$969","tokens":[{"marker":"__RP_TOK_0__","paramName":"type","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","query:type":"online"}},{"id":"csharp","label":"C#","templateCode":"using System.Net.Http;\nusing System.Net.Http.Headers;\n\nvar client = new HttpClient();\nvar request = new HttpRequestMessage\n{\n Method = HttpMethod.Get,\n RequestUri = new Uri(\"https://merchant.revolut.com/api/locations?type=__RP_TOK_0__\"),\n Headers =\n {\n { \"Authorization\", \"__RP_TOK_1__\" },\n }\n};\n\nusing (var response = await client.SendAsync(request))\n{\n response.EnsureSuccessStatusCode();\n var body = await response.Content.ReadAsStringAsync();\n Console.WriteLine(body);\n}","templateHtml":"$96a","tokens":[{"marker":"__RP_TOK_0__","paramName":"type","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","query:type":"online"}}],"https://sandbox-merchant.revolut.com":[{"id":"curl","label":"cURL","templateCode":"curl -X GET \"https://sandbox-merchant.revolut.com/api/locations?type=__RP_TOK_0__\" \\\n -H \"Authorization: __RP_TOK_1__\"","templateHtml":"
curl -X GET \"https://sandbox-merchant.revolut.com/api/locations?type=__RP_TOK_0__\" \\\n  -H \"Authorization: __RP_TOK_1__\"
","tokens":[{"marker":"__RP_TOK_0__","paramName":"type","paramIn":"query","pipeline":["url-component","shell-double-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["shell-double-inner"]}],"defaults":{"header:Authorization":"Bearer ","query:type":"online"}},{"id":"javascript","label":"JavaScript","templateCode":"fetch(\"https://sandbox-merchant.revolut.com/api/locations?type=__RP_TOK_0__\", {\n method: \"GET\",\n headers: {\n \"Authorization\": \"__RP_TOK_1__\"\n }\n})\n .then(response => response.json())\n .then(data => console.log(data));","templateHtml":"$96b","tokens":[{"marker":"__RP_TOK_0__","paramName":"type","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","query:type":"online"}},{"id":"go","label":"Go","templateCode":"package main\n\nimport (\n \"fmt\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://sandbox-merchant.revolut.com/api/locations?type=__RP_TOK_0__\"\n req, _ := http.NewRequest(\"GET\", url, nil)\n req.Header.Add(\"Authorization\", \"__RP_TOK_1__\")\n\n res, _ := http.DefaultClient.Do(req)\n defer res.Body.Close()\n fmt.Println(res)\n}","templateHtml":"$96c","tokens":[{"marker":"__RP_TOK_0__","paramName":"type","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","query:type":"online"}},{"id":"python","label":"Python","templateCode":"import requests\n\nurl = \"https://sandbox-merchant.revolut.com/api/locations?type=__RP_TOK_0__\"\nheaders = {\n \"Authorization\": \"__RP_TOK_1__\"\n}\n\nresponse = requests.get(url, headers=headers)\nprint(response.json())","templateHtml":"$96d","tokens":[{"marker":"__RP_TOK_0__","paramName":"type","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","query:type":"online"}},{"id":"java","label":"Java","templateCode":"import java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\nimport java.net.URI;\n\npublic class Main {\n public static void main(String[] args) {\n HttpClient client = HttpClient.newHttpClient();\n HttpRequest request = HttpRequest.newBuilder()\n .uri(URI.create(\"https://sandbox-merchant.revolut.com/api/locations?type=__RP_TOK_0__\"))\n .header(\"Authorization\", \"__RP_TOK_1__\")\n .GET(HttpRequest.BodyPublishers.noBody())\n .build();\n\n client.sendAsync(request, HttpResponse.BodyHandlers.ofString())\n .thenApply(HttpResponse::body)\n .thenAccept(System.out::println)\n .join();\n }\n}","templateHtml":"$96e","tokens":[{"marker":"__RP_TOK_0__","paramName":"type","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","query:type":"online"}},{"id":"csharp","label":"C#","templateCode":"using System.Net.Http;\nusing System.Net.Http.Headers;\n\nvar client = new HttpClient();\nvar request = new HttpRequestMessage\n{\n Method = HttpMethod.Get,\n RequestUri = new Uri(\"https://sandbox-merchant.revolut.com/api/locations?type=__RP_TOK_0__\"),\n Headers =\n {\n { \"Authorization\", \"__RP_TOK_1__\" },\n }\n};\n\nusing (var response = await client.SendAsync(request))\n{\n response.EnsureSuccessStatusCode();\n var body = await response.Content.ReadAsStringAsync();\n Console.WriteLine(body);\n}","templateHtml":"$96f","tokens":[{"marker":"__RP_TOK_0__","paramName":"type","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","query:type":"online"}}]},"method":"get","servers":"$62:props:children:0:props:children:props:children:1:props:children:1:props:children:0:0:props:servers","path":"/api/locations","parameters":["$960:props:children:0:props:children:1:props:parameters:0","$960:props:children:0:props:children:1:props:parameters:1"]}],"$L970"],"$L971","$L972"]}]]}] 83e:["$","div","CodeBlock-0",{"className":"wzy01m0 _18b50nc0","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"
'Authorization: Bearer <yourSecretApiKey>'
"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"'Authorization: Bearer '\n"}]}]]}] 928:"Retrieve a location" 970:["$","$L10d",null,{"security":[{"Api-Key":[]}],"authorization":{"Api-Key":{"type":"apiKey","in":"header","name":"Authorization","description":"Each Merchant API request must contain an authorization header in the following format:\n\n```\n'Authorization: Bearer '\n```\n\nTo use this API, you need to generate API keys from your Revolut Business account. The Secret key is used in the authorization header for all server calls, while the Public key is provided with payment methods at checkout.\n\n:::info\nFor detailed instructions on generating your API keys, see: [Generate API keys](https://developer.revolut.com/docs/guides/merchant/get-started#generate-api-keys).\n:::","descriptionNode":"$L973"}}}] 971:["$","$L10f",null,{"exampleBlocks":{},"title":"Request body samples","headingAs":"h4"}] 972:["$","$L110",null,{"exampleBlocks":{"200":{"application/json":{"variants":[{"key":"list_of_locations","label":"Location list","rawValue":"$5f:props:children:0:props:children:props:responses:200:content:application/json:examples:list_of_locations:value","block":"$L974"}],"syncedPropertyName":"$undefined"}},"401":{}},"headingAs":"h4"}] 901:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unique ID representing the location where merchants sells products."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#tag-locations","target":"_blank","rel":"noreferrer","children":"Locations"}],"."]}]}]]}]]}] 902:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Name of the location."}],"\n",["$","div","inlinealert-0",{"data-type":"warning","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMark","color":"var(--rui-color-warning)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["The ",["$","code","code-0",{"children":"name"}]," parameter's value must be unique across all locations."]}]}]]}]]}] 903:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Type of the location."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Value","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"online"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Represents an online store.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"physical"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Represents a physical point of sale.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 904:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Domain address of the location. Required for online locations."}],"\n",["$","div","inlinealert-0",{"data-type":"warning","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMark","color":"var(--rui-color-warning)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["The ",["$","code","code-0",{"children":"domain"}]," parameter's value must be unique across all locations."]}]}]]}]]}] 905:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Additional details of the location."}]]}] 906:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unique ID representing the location where merchants sells products."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#tag-locations","target":"_blank","rel":"noreferrer","children":"Locations"}],"."]}]}]]}]]}] 907:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Name of the location."}],"\n",["$","div","inlinealert-0",{"data-type":"warning","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMark","color":"var(--rui-color-warning)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["The ",["$","code","code-0",{"children":"name"}]," parameter's value must be unique across all locations."]}]}]]}]]}] 908:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Type of the location."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Value","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"online"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Represents an online store.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"physical"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Represents a physical point of sale.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 909:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Primary address line."}]]}] 90a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Secondary address line, such as floor and apartment number."}]]}] 90b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"State or province of the address."}]]}] 90c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"City of the address."}]]}] 90d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"ISO 2-letter country code."}]]}] 90e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Postal code of the address."}]]}] 90f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Details of a physical address."}]]}] 910:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The latitude of the location, in decimal degrees."}]]}] 911:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"To longitude of the location, in decimal degrees."}]]}] 912:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Coordinates of the location."}]]}] 913:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The local time when the interval begins."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["The format is ",["$","code","code-0",{"children":"hh:mm[:ss]"}],"; seconds are optional and must be ",["$","code","code-1",{"children":"00"}]," if provided."]}]}]]}]]}] 914:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The local time when the interval ends."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["The format is ",["$","code","code-0",{"children":"hh:mm[:ss]"}],"; seconds are optional and must be ",["$","code","code-1",{"children":"00"}]," if provided."]}]}]]}]]}] 915:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Opening hours for Monday."}]]}] 916:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Opening hours for Tuesday."}]]}] 917:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Opening hours for Wednesday."}]]}] 918:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Opening hours for Thursday."}]]}] 919:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Opening hours for Friday."}]]}] 91a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Opening hours for Saturday."}]]}] 91b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Opening hours for Sunday."}]]}] 91c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An object containing the opening hours for each day of the week."}],"\n",["$","p","p-1",{"children":"A day can have multiple intervals (e.g., closing for a lunch break)."}]]}] 91d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Additional details of the location."}]]}] 91e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Location object represents merchant locations depending on type."}]]}] 91f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"OK"}]]}] 920:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The ID of the error. You can share this ID with Revolut support for troubleshooting."}]]}] 921:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The date and time the error happened."}]]}] 922:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unauthorized"}]]}] 923:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The ID of the error. You can share this ID with Revolut support for troubleshooting."}]]}] 924:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The date and time the error happened."}]]}] 925:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Not Found"}]]}] 929:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Retrieve details of a specific location, based on its ID."}]]}] 92a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["This parameter accepts the ",["$","a","a-0",{"href":"https://business.revolut.com/settings/apis?tab=merchant-api","target":"_blank","rel":"noreferrer","children":"Merchant API Secret key"}]," to authorise requests coming from the merchant's backend."]}],"\n",["$","p","p-1",{"children":["It ensures that ensures that each request is authenticated and authorised by verifying the secret key. The secret key should be included in all request headers as a ",["$","code","code-0",{"children":"Bearer"}]," token."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#authentication","target":"_blank","rel":"noreferrer","children":"Authentication"}]]}]}]]}]]}] 92b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A UUID string, typically used to identify resources."}]]}] 92c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The ID of the location."}]]}] 962:"Retrieve location list" 21:["$","$7a","retrieve-payment-list",{"children":[["$","section",null,{"className":"y9a0do0","data-variant":"endpoint","children":["$","$L7b",null,{"responses":{"200":{"description":"List of payments","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"The ID of the payment.","descriptionNode":"$L975"},"order_id":{"type":"string","format":"uuid","description":"Permanent order ID used to retrieve, capture, cancel, or refund an order after authorization.","descriptionNode":"$L976"},"payment_method":{"type":"object","description":"The payment method used to pay for the order.","discriminator":{"propertyName":"type","mapping":{"revolut_pay":"#/components/schemas/Revolut-Pay","card":"#/components/schemas/Card-For-Payment-Details","sepa_direct_debit":"#/components/schemas/Sepa-Direct-Debit"}},"oneOf":[{"discriminator":{"propertyName":"subtype","mapping":{"revolut_pay_account":"#/components/schemas/RPay-Account","revolut_pay_card":"#/components/schemas/RPay-Card"}},"oneOf":[{"properties":{"type":{"type":"string","enum":["card","revolut_pay"],"description":"The type of payment method used to pay for the order.","descriptionNode":"$L977"},"subtype":{"type":"string","enum":["revolut_account","card"],"description":"Indicates whether the customer used their card or Revolut account via Revolut Pay.","descriptionNode":"$L978"},"id":{"type":"string","format":"uuid","description":"ID of the saved payment method.\n\n:::note\nThe `id` parameter is only returned if the payment method is saved.\n:::","descriptionNode":"$L979"}},"required":["type","subtype"]},{"properties":{"type":{"type":"string","enum":["card","revolut_pay"],"description":"The type of payment method used to pay for the order.","descriptionNode":"$L97a"},"subtype":{"type":"string","enum":["revolut_account","card"],"description":"Indicates whether the customer used their card or Revolut account via Revolut Pay.","descriptionNode":"$L97b"},"id":{"type":"string","format":"uuid","description":"ID of the saved payment method.\n\n:::note\nThe `id` parameter is only returned if the payment method is saved.\n:::","descriptionNode":"$L97c"},"brand":{"type":"string","description":"The type of the card.","descriptionNode":"$L97d"},"last_four":{"type":"string","description":"The last four digits of the card number.","descriptionNode":"$L97e"}},"required":["type","subtype"]}]},{"properties":{"type":{"type":"string","enum":["card","revolut_pay"],"description":"The type of payment method used to pay for the order.","descriptionNode":"$L97f"},"brand":{"type":"string","description":"The type of the card.","descriptionNode":"$L980"},"last_four":{"type":"string","description":"The last four digits of the card number.","descriptionNode":"$L981"},"id":{"type":"string","format":"uuid","description":"ID of the saved payment method.\n\n:::note\nThe `id` parameter is only returned if the payment method is saved.\n:::","descriptionNode":"$L982"}},"required":["type"]},{"type":"object","description":"Object containing details of a SEPA Direct Debit payment.\n\n:::info\nFor more information, see: [SEPA Direct Debit server-to-server integration](https://developer.revolut.com/docs/guides/merchant/accept-payments/payment-methods/sepa-direct-debit/server-to-server)\n:::","properties":{"id":{"type":"string","format":"uuid","description":"ID of the saved payment method.\n\n:::note\nThe `id` parameter is only returned when the payment method is saved for the merchant.\n:::","descriptionNode":"$L983"},"type":{"type":"string","enum":["apple_pay","card","google_pay","revolut_pay_card","revolut_pay_account","sepa_direct_debit"],"description":"The type of payment method used to pay for the order.\n\nAvailable values:\n\n| Payment method `type` | Description |\n| --------------------- | ----------- |\n| `apple_pay` | The customer paid the order using Apple Pay. |\n| `card` | The customer paid the order using their credit or debit card. |\n| `google_pay` | The customer paid the order using Google Pay. |\n| `revolut_pay_card` | The customer paid the order via Revolut Pay using their credit or debit card. |\n| `revolut_pay_account` | The customer paid the order via Revolut Pay using their Revolut account. |\n| `sepa_direct_debit` | The customer paid the order using SEPA Direct Debit. |","descriptionNode":"$L984"},"debtor_iban_last_four":{"type":"string","description":"The last four digits of the debtor's IBAN.","minLength":4,"maxLength":4,"descriptionNode":"$L985"},"debtor_name":{"type":"string","description":"The full name of the debtor as provided in the mandate.","descriptionNode":"$L986"},"mandate_reference":{"type":"string","description":"The unique mandate reference generated by Revolut. Include this in pre-debit notifications sent to your customers.","descriptionNode":"$L987"}},"required":["type"],"descriptionNode":"$L988"}],"descriptionNode":"$L989"},"token":{"type":"string","format":"uuid","description":"Temporary token of the payment used to fetch the reward offer during checkout and link user registrations to the given offers. \n\nThe token is only valid for a limited time.","descriptionNode":"$L98a"},"amount":{"type":"integer","format":"int64","minimum":0,"description":"The payment amount in minor units (e.g., cents). The value of this field depends on the payment type and state.\n\n| Payment type | State | Amount value |\n|--------------|-------|--------------|\n| Standard payment | Any | Total payment amount |\n| Pre-authorised payment | `authorisation_started` | New amount being authorised (during increment processing) |\n| Pre-authorised payment | `authorised` | Currently authorised amount (equals `authorised_amount`) |\n\n:::info\nFor pre-authorised payments, see the `authorised_amount` field for tracking the currently authorised amount separately.\n:::","examples":[600],"descriptionNode":"$L98b"},"currency":{"type":"string","format":"ISO 4217","minLength":3,"maxLength":3,"description":"[ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) currency code in upper case.\n\n:::info\nFor more information about the supported currencies, see: [Help Center](https://help.revolut.com/business/help/merchant-accounts/payments/in-which-currencies-can-i-accept-payments/).\n:::","descriptionNode":"$L98c"},"state":{"type":"string","description":"The status of the payment.","enum":["pending","authentication_challenge","authentication_verified","authorisation_started","authorisation_passed","authorised","capture_started","captured","refund_validated","refund_started","cancellation_started","declining","completing","cancelling","failing","completed","declined","soft_declined","cancelled","failed"],"descriptionNode":"$L98d"},"decline_reason":{"type":"string","description":"The reason for a `failed` or `declined` payment.\n\nA failed or declined payment can result from multiple reasons. To learn more, check our [failure reasons](https://developer.revolut.com/docs/guides/merchant/reference/error-codes/decline-reasons).","enum":["3ds_challenge_abandoned","3ds_challenge_failed_manually","cardholder_name_missing","customer_challenge_abandoned","customer_challenge_failed","customer_name_mismatch","do_not_honour","expired_card","high_risk","insufficient_funds","invalid_address","invalid_amount","invalid_card","invalid_country","invalid_cvv","invalid_email","invalid_expiry","invalid_merchant","invalid_phone","invalid_pin","issuer_not_available","pick_up_card","rejected_by_customer","restricted_card","suspected_fraud","technical_error","transaction_not_allowed_for_cardholder","unknown_card","withdrawal_limit_exceeded"],"descriptionNode":"$L98e"},"authentication_challenge":{"type":"object","description":"Details about the authentication challenge that should be performed to complete the authentication process. For more information about Revolut's 3DS solution, see: [3D Secure overview](https://developer.revolut.com/docs/guides/merchant/reference/3d-secure).\n\nOnly returned if the payment's state is `authentication_challenge`.","discriminator":{"propertyName":"type","mapping":{"three_ds":"#/components/schemas/Three-Ds","three_ds_fingerprint":"#/components/schemas/Three-Ds-Fingerprint"}},"oneOf":[{"title":"three_ds","type":"object","description":"Information about the 3DS challenge.","properties":{"type":{"type":"string","enum":["three_ds","three_ds_fingerprint"],"description":"Type of the authentication challenge the payment triggers.","descriptionNode":"$L98f"},"acs_url":{"type":"string","format":"url","description":"The URL of the authentication challenge.","descriptionNode":"$L990"}},"required":["type","acs_url"],"descriptionNode":"$L991"},{"title":"three_ds_fingerprint","type":"object","description":"Information about the 3DS fingerprint challenge.","properties":{"type":{"type":"string","enum":"$21:props:children:0:props:children:props:responses:200:content:application/json:schema:items:properties:authentication_challenge:oneOf:0:properties:type:enum","description":"Type of the authentication challenge the payment triggers.","descriptionNode":"$L992"},"fingerprint_url":{"type":"string","format":"url","description":"The URL of the fingerprint. (Used only internally by Revolut.)","descriptionNode":"$L993"},"fingerprint_data":{"type":"string","format":"JSON","description":"Data about the fingerprint used for authentication. (Used only internally\nby Revolut.)","descriptionNode":"$L994"}},"required":["type","fingerprint_url","fingerprint_data"],"descriptionNode":"$L995"}],"descriptionNode":"$L996"}},"required":["id","order_id","payment_method"]}},"examples":{"payment_list":{"summary":"List of payments (failed card attempt, SEPA Direct Debit retry)","value":[{"id":"63dd0e4a-42c4-a1a6-ab2c-6ac9d255ca4b","token":"294358bf-3818-49b2-aacc-7ca971f52695","order_id":"63dd0e3f-7b84-ab5c-927c-1a06f7c9583a","state":"declined","amount":100,"currency":"EUR","payment_method":{"type":"card","card_brand":"visa","funding":"credit","card_last_four":"1234"}},{"id":"649adc44-3e86-a832-879c-2f6d0255dd4c","token":"8061e645-35e0-42bb-8318-603abaeab7b7","order_id":"63dd0e3f-7b84-ab5c-927c-1a06f7c9583a","state":"declined","amount":100,"currency":"EUR","decline_reason":"insufficient_funds","payment_method":{"type":"revolut_pay","subtype":"revolut_account"}},{"id":"663387f1-1c2e-a295-b143-9f1fb1eec175","token":"663387f1-c91e-a464-908a-1cc4548ebc6a","order_id":"63dd0e3f-7b84-ab5c-927c-1a06f7c9583a","state":"pending","amount":100,"currency":"EUR","payment_method":{"type":"sepa_direct_debit","debtor_iban_last_four":"1234","debtor_name":"John Doe","mandate_reference":"A1B2C3D4E5F6A1B2C3D4E5F6A1B2C3D4"}}]}}}},"descriptionNode":"$L997"},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"code":{"type":"string","description":"An identifier that can be used to determine what went wrong.\n\nError codes are not globally unique, but uniqueness is guaranteed within endpoints.","descriptionNode":"$L998"},"message":{"type":"string","description":"Some human readable text describing what went wrong.","descriptionNode":"$L999"},"timestamp":{"type":"integer","description":"The [UNIX timestamp](https://www.unixtimestamp.com/) of the date and time the error happened.","descriptionNode":"$L99a"}}},"examples":{"default":{"value":{"code":"bad_request","message":"Could not parse JSON","timestamp":1720528890647}}}}},"descriptionNode":"$L99b"},"401":{"description":"Unauthenticated","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"code":{"type":"string","description":"An identifier that can be used to determine what went wrong.\n\nError codes are not globally unique, but uniqueness is guaranteed within endpoints.","descriptionNode":"$L99c"},"message":{"type":"string","description":"Some human readable text describing what went wrong.","descriptionNode":"$L99d"},"timestamp":{"type":"integer","description":"The [UNIX timestamp](https://www.unixtimestamp.com/) of the date and time the error happened.","descriptionNode":"$L99e"}}},"examples":{"default":{"value":{"code":"unauthenticated","message":"Authentication failed","timestamp":1720528890647}}}}},"descriptionNode":"$L99f"},"404":{"description":"Not Found","content":{"application/json":{"schema":{"examples":[{"code":"not_found","message":"Order with id b8883ab5-964a-4329-aa44-4d3c76cf3f54 was not found","timestamp":1720528890647}],"title":"Error","type":"object","properties":{"code":{"type":"string","description":"An identifier that can be used to determine what went wrong.\n\nError codes are not globally unique, but uniqueness is guaranteed within endpoints.","descriptionNode":"$L9a0"},"message":{"type":"string","description":"Some human readable text describing what went wrong.","descriptionNode":"$L9a1"},"timestamp":{"type":"integer","description":"The [UNIX timestamp](https://www.unixtimestamp.com/) of the date and time the error happened.","descriptionNode":"$L9a2"}}}}},"descriptionNode":"$L9a3"}},"requestBody":"$undefined","variantLabels":[],"children":["$L9a4","$L9a5"]}]}],false]}] 29:["$","$7a","retrieve-payment-method",{"children":[["$","section",null,{"className":"y9a0do0","data-variant":"endpoint","children":["$","$L7b",null,{"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"title":"Payment method","description":"A saved payment method on a customer profile.\n\nUse the `type` field to determine the specific payment method variant.\n\n:::note\nThis schema represents a stored credential available for future charges and supports three types: `card`, `revolut_pay`, and `sepa_direct_debit`.\n\nIt differs from the `payment_method` object on a Payment, which is a transactional snapshot of how a specific charge was executed and includes additional detail such as wallet wrappers (`apple_pay`, `google_pay`) and Revolut Pay funding source (`revolut_pay_card` vs `revolut_pay_account`).\n:::","discriminator":{"propertyName":"type","mapping":{"card":"#/components/schemas/Card-v2","revolut_pay":"#/components/schemas/Revolut-Pay-v2","sepa_direct_debit":"#/components/schemas/Sepa-Direct-Debit-v2"}},"oneOf":[{"title":"Card payment method","type":"object","description":"A saved card payment method.\n\n:::info\nThe `checks` object (3DS, CVV, address verification) is not included as it is specific to the transactional payment context.\n:::","properties":{"id":{"type":"string","format":"uuid","description":"Unique identifier for the payment method.","descriptionNode":"$L9a6"},"type":{"type":"string","description":"The type of the payment method.","enum":["card","revolut_pay","sepa_direct_debit"],"descriptionNode":"$L9a7"},"saved_for":{"type":"string","enum":["customer","merchant"],"description":"Indicates in which case this saved payment method can be used for payments.\n\n| Value | Description |\n| ----- | ----------- |\n| `customer` | This payment method can be used only when the customer is on the checkout page. |\n| `merchant` | This payment method can be used without the customer being on the checkout page, and the merchant can initiate transactions, for example, to take payments for recurring transactions. |","descriptionNode":"$L9a8"},"created_at":{"type":"string","format":"date-time","description":"The date and time the payment method was added.","descriptionNode":"$L9a9"},"bin":{"type":"string","description":"The BIN (Bank Identification Number) of the payment card, typically the first 6-8 digits.","descriptionNode":"$L9aa"},"last_four":{"type":"string","minLength":4,"maxLength":4,"description":"The last four digits of the payment card number.","descriptionNode":"$L9ab"},"expiry_month":{"type":"integer","description":"The expiry month of the payment card.","descriptionNode":"$L9ac"},"expiry_year":{"type":"integer","description":"The expiry year of the payment card.","descriptionNode":"$L9ad"},"cardholder_name":{"type":"string","description":"The name of the cardholder as it appears on the card.","descriptionNode":"$L9ae"},"brand":{"type":"string","description":"The brand of the payment card.","enum":["visa","mastercard","american_express"],"descriptionNode":"$L9af"},"funding":{"type":"string","description":"The funding type of the payment card.","enum":["debit","credit","prepaid"],"descriptionNode":"$L9b0"},"issuer":{"type":"string","description":"The name of the card-issuing bank or institution.","descriptionNode":"$L9b1"},"issuer_country":{"type":"string","minLength":2,"maxLength":2,"description":"The ISO 3166-1 alpha-2 country code of the country where the payment card was issued.","descriptionNode":"$L9b2"},"billing_address":{"title":"Billing address","type":"object","description":"The billing address associated with the payment method.","properties":{"street_line_1":{"type":"string","description":"Primary address line.","maxLength":100,"descriptionNode":"$L9b3"},"street_line_2":{"type":"string","description":"Secondary address line, such as floor and apartment number.","maxLength":100,"descriptionNode":"$L9b4"},"region":{"type":"string","description":"State or province of the address.","maxLength":100,"descriptionNode":"$L9b5"},"city":{"type":"string","description":"City of the address.","maxLength":100,"descriptionNode":"$L9b6"},"country_code":{"type":"string","pattern":"^[A-Z]{2}$","description":"ISO 2-letter country code.","minLength":2,"maxLength":2,"descriptionNode":"$L9b7"},"postcode":{"type":"string","description":"Postal code of the address.","maxLength":100,"descriptionNode":"$L9b8"}},"required":["country_code","postcode"],"descriptionNode":"$L9b9"},"terminal_hardware_id":{"type":"string","description":"The hardware identifier of the Revolut Terminal device used to process the payment.\n\n:::note\nOnly present for card-present transactions processed via Revolut Terminal.\n:::","descriptionNode":"$L9ba"}},"required":["id","type","created_at"],"descriptionNode":"$L9bb"},{"title":"Revolut Pay payment method","type":"object","description":"A saved Revolut Pay payment method on a customer profile.\n\nBoth Revolut Pay card-backed and account-to-account (A2A) variants are\nrepresented by this single type at the saved payment method level.\nNo underlying card details are exposed here; use the order-level\n`payments[].payment_method` object (types `revolut_pay_card` /\n`revolut_pay_account`) for per-transaction details.","properties":{"id":{"type":"string","format":"uuid","description":"Unique identifier for the payment method.","descriptionNode":"$L9bc"},"type":{"type":"string","description":"The type of the payment method.","enum":"$29:props:children:0:props:children:props:responses:200:content:application/json:schema:oneOf:0:properties:type:enum","descriptionNode":"$L9bd"},"saved_for":{"type":"string","enum":"$29:props:children:0:props:children:props:responses:200:content:application/json:schema:oneOf:0:properties:saved_for:enum","description":"Indicates in which case this saved payment method can be used for payments.\n\n| Value | Description |\n| ----- | ----------- |\n| `customer` | This payment method can be used only when the customer is on the checkout page. |\n| `merchant` | This payment method can be used without the customer being on the checkout page, and the merchant can initiate transactions, for example, to take payments for recurring transactions. |","descriptionNode":"$L9be"},"created_at":{"type":"string","format":"date-time","description":"The date and time the payment method was added.","descriptionNode":"$L9bf"}},"required":["id","type","created_at"],"descriptionNode":"$L9c0"},{"title":"SEPA Direct Debit payment method","type":"object","description":"A saved SEPA Direct Debit payment method on a customer profile.\n\n:::info\nFor more information, see: [SEPA Direct Debit server-to-server integration](https://developer.revolut.com/docs/guides/merchant/accept-payments/payment-methods/sepa-direct-debit/server-to-server)\n:::","properties":{"id":{"type":"string","format":"uuid","description":"Unique identifier for the payment method.","descriptionNode":"$L9c1"},"type":{"type":"string","description":"The type of the payment method.","enum":"$29:props:children:0:props:children:props:responses:200:content:application/json:schema:oneOf:0:properties:type:enum","descriptionNode":"$L9c2"},"saved_for":{"type":"string","enum":"$29:props:children:0:props:children:props:responses:200:content:application/json:schema:oneOf:0:properties:saved_for:enum","description":"Indicates in which case this saved payment method can be used for payments.\n\n| Value | Description |\n| ----- | ----------- |\n| `customer` | This payment method can be used only when the customer is on the checkout page. |\n| `merchant` | This payment method can be used without the customer being on the checkout page, and the merchant can initiate transactions, for example, to take payments for recurring transactions. |","descriptionNode":"$L9c3"},"debtor_iban_last_four":{"type":"string","description":"The last four digits of the debtor's IBAN.","minLength":4,"maxLength":4,"descriptionNode":"$L9c4"},"debtor_name":{"type":"string","description":"The full name of the debtor as provided in the mandate.","descriptionNode":"$L9c5"},"mandate_reference":{"type":"string","description":"The unique mandate reference generated by Revolut. Include this in pre-debit notifications sent to your customers.","descriptionNode":"$L9c6"},"billing_address":{"title":"Billing address","type":"object","description":"The billing address associated with the payment method.","properties":{"street_line_1":"$29:props:children:0:props:children:props:responses:200:content:application/json:schema:oneOf:0:properties:billing_address:properties:street_line_1","street_line_2":"$29:props:children:0:props:children:props:responses:200:content:application/json:schema:oneOf:0:properties:billing_address:properties:street_line_2","region":"$29:props:children:0:props:children:props:responses:200:content:application/json:schema:oneOf:0:properties:billing_address:properties:region","city":"$29:props:children:0:props:children:props:responses:200:content:application/json:schema:oneOf:0:properties:billing_address:properties:city","country_code":"$29:props:children:0:props:children:props:responses:200:content:application/json:schema:oneOf:0:properties:billing_address:properties:country_code","postcode":"$29:props:children:0:props:children:props:responses:200:content:application/json:schema:oneOf:0:properties:billing_address:properties:postcode"},"required":"$29:props:children:0:props:children:props:responses:200:content:application/json:schema:oneOf:0:properties:billing_address:required","descriptionNode":"$L9c7"},"created_at":{"type":"string","format":"date-time","description":"The date and time the payment method was added.","descriptionNode":"$L9c8"}},"required":["id","type","created_at"],"descriptionNode":"$L9c9"}],"descriptionNode":"$L9ca"},"examples":{"retrieved_payment_method":{"retrieved_card":{"summary":"Retrieved card payment method","value":{"id":"edef3ba4-60a0-4df3-8f12-e5fc858c2420","type":"card","saved_for":"customer","created_at":"2023-03-24T14:15:22Z","bin":"459678","last_four":"6896","expiry_month":3,"expiry_year":2025,"cardholder_name":"Example Customer","brand":"visa","funding":"debit","issuer":"EXAMPLE ISSUER","issuer_country":"GB","billing_address":{"street_line_1":"7","street_line_2":"Westferry Circus","postcode":"E144HD","city":"London","region":"Greater London","country_code":"GB"}}},"retrieved_revolut_pay":{"summary":"Retrieved Revolut Pay payment method","value":{"id":"648334a8-9546-a983-a81a-efc6d5bdd0be","type":"revolut_pay","saved_for":"merchant","created_at":"2023-06-09T14:18:16.577888Z"}},"retrieved_sepa_direct_debit":{"summary":"Retrieved SEPA Direct Debit payment method","value":{"id":"6a0fe961-a961-a8b6-ad17-ab2779165a82","type":"sepa_direct_debit","saved_for":"merchant","created_at":"2026-05-22T05:28:01.887482Z","debtor_iban_last_four":"3273","debtor_name":"John Doe","mandate_reference":"69F1CB61BD99A32C8E20D7FB9E21E146","billing_address":{"street_line_1":"Bank of England","street_line_2":"Threadneedle St","postcode":"EC2R 8AH","city":"London","region":"Greater London","country_code":"GB"}}}}}}},"descriptionNode":"$L9cb"},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"code":{"type":"string","description":"An identifier that can be used to determine what went wrong.\n\nError codes are not globally unique, but uniqueness is guaranteed within endpoints.","descriptionNode":"$L9cc"},"message":{"type":"string","description":"Some human readable text describing what went wrong.","descriptionNode":"$L9cd"},"timestamp":{"type":"integer","description":"The [UNIX timestamp](https://www.unixtimestamp.com/) of the date and time the error happened.","descriptionNode":"$L9ce"}}}}},"descriptionNode":"$L9cf"},"404":{"description":"Not Found","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"code":{"type":"string","description":"An identifier that can be used to determine what went wrong.\n\nError codes are not globally unique, but uniqueness is guaranteed within endpoints.","descriptionNode":"$L9d0"},"message":{"type":"string","description":"Some human readable text describing what went wrong.","descriptionNode":"$L9d1"},"timestamp":{"type":"integer","description":"The [UNIX timestamp](https://www.unixtimestamp.com/) of the date and time the error happened.","descriptionNode":"$L9d2"}}}}},"descriptionNode":"$L9d3"}},"requestBody":"$undefined","variantLabels":[],"children":["$L9d4","$L9d5"]}]}],false]}] 9a4:["$","div",null,{"className":"ezz1n30","children":[["$","div",null,{"data-header":"$undefined","className":"ezz1n31","children":["$","div",null,{"className":"y9a0do1","children":[["$","h2",null,{"id":"retrieve-payment-list","children":[["$L9d6","$undefined"],["$","$L15",null,{"id":"retrieve-payment-list"}]]}],["$","$L16",null,{"url":"/docs/api/merchant/2025-10-16/operations/retrieve-payment-list.md"}]]}]}],"$undefined"]}] 9db:T8b4,
fetch("https://merchant.revolut.com/api/orders/__RP_TOK_0__/payments", {
  method: "GET",
  headers: {
    "Authorization": "__RP_TOK_1__"
  }
})
  .then(response => response.json())
  .then(data => console.log(data));
9dc:Td9c,
package main

import (
  "fmt"
  "net/http"
)

func main() {
  url := "https://merchant.revolut.com/api/orders/__RP_TOK_0__/payments"
  req, _ := http.NewRequest("GET", url, nil)
  req.Header.Add("Authorization", "__RP_TOK_1__")

  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  fmt.Println(res)
}
9dd:T6c8,
import requests

url = "https://merchant.revolut.com/api/orders/__RP_TOK_0__/payments"
headers = {
  "Authorization": "__RP_TOK_1__"
}

response = requests.get(url, headers=headers)
print(response.json())
9de:T1540,
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;

public class Main {
  public static void main(String[] args) {
    HttpClient client = HttpClient.newHttpClient();
    HttpRequest request = HttpRequest.newBuilder()
      .uri(URI.create("https://merchant.revolut.com/api/orders/__RP_TOK_0__/payments"))
      .header("Authorization", "__RP_TOK_1__")
      .GET(HttpRequest.BodyPublishers.noBody())
      .build();

    client.sendAsync(request, HttpResponse.BodyHandlers.ofString())
      .thenApply(HttpResponse::body)
      .thenAccept(System.out::println)
      .join();
  }
}
9df:T1460,
using System.Net.Http;
using System.Net.Http.Headers;

var client = new HttpClient();
var request = new HttpRequestMessage
{
  Method = HttpMethod.Get,
  RequestUri = new Uri("https://merchant.revolut.com/api/orders/__RP_TOK_0__/payments"),
  Headers =
  {
    { "Authorization", "__RP_TOK_1__" },
  }
};

using (var response = await client.SendAsync(request))
{
  response.EnsureSuccessStatusCode();
  var body = await response.Content.ReadAsStringAsync();
  Console.WriteLine(body);
}
9e0:T8bc,
fetch("https://sandbox-merchant.revolut.com/api/orders/__RP_TOK_0__/payments", {
  method: "GET",
  headers: {
    "Authorization": "__RP_TOK_1__"
  }
})
  .then(response => response.json())
  .then(data => console.log(data));
9e1:Tda4,
package main

import (
  "fmt"
  "net/http"
)

func main() {
  url := "https://sandbox-merchant.revolut.com/api/orders/__RP_TOK_0__/payments"
  req, _ := http.NewRequest("GET", url, nil)
  req.Header.Add("Authorization", "__RP_TOK_1__")

  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  fmt.Println(res)
}
9e2:T6d0,
import requests

url = "https://sandbox-merchant.revolut.com/api/orders/__RP_TOK_0__/payments"
headers = {
  "Authorization": "__RP_TOK_1__"
}

response = requests.get(url, headers=headers)
print(response.json())
9e3:T1548,
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;

public class Main {
  public static void main(String[] args) {
    HttpClient client = HttpClient.newHttpClient();
    HttpRequest request = HttpRequest.newBuilder()
      .uri(URI.create("https://sandbox-merchant.revolut.com/api/orders/__RP_TOK_0__/payments"))
      .header("Authorization", "__RP_TOK_1__")
      .GET(HttpRequest.BodyPublishers.noBody())
      .build();

    client.sendAsync(request, HttpResponse.BodyHandlers.ofString())
      .thenApply(HttpResponse::body)
      .thenAccept(System.out::println)
      .join();
  }
}
9e4:T1468,
using System.Net.Http;
using System.Net.Http.Headers;

var client = new HttpClient();
var request = new HttpRequestMessage
{
  Method = HttpMethod.Get,
  RequestUri = new Uri("https://sandbox-merchant.revolut.com/api/orders/__RP_TOK_0__/payments"),
  Headers =
  {
    { "Authorization", "__RP_TOK_1__" },
  }
};

using (var response = await client.SendAsync(request))
{
  response.EnsureSuccessStatusCode();
  var body = await response.Content.ReadAsStringAsync();
  Console.WriteLine(body);
}
9a5:["$","div",null,{"className":"ezz1n30","children":[["$","div",null,{"data-header":"$undefined","className":"ezz1n31","children":["$L9d7",["$","$L85",null,{"parameters":[{"name":"Authorization","in":"header","schema":{"type":"string","format":"Bearer ","examples":"$62:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:0:schema:examples"},"required":true,"description":"This parameter accepts the [Merchant API Secret key](https://business.revolut.com/settings/apis?tab=merchant-api) to authorise requests coming from the merchant's backend. \n\nIt ensures that ensures that each request is authenticated and authorised by verifying the secret key. The secret key should be included in all request headers as a `Bearer` token.\n\n:::info\nFor more information, see: [Authentication](https://developer.revolut.com/docs/api/merchant#authentication)\n:::","descriptionNode":"$L9d8"},{"name":"order_id","in":"path","schema":{"type":"string","format":"uuid","description":"A UUID string, typically used to identify resources.","descriptionNode":"$L9d9"},"required":true,"description":"The ID of the `Order` object.","descriptionNode":"$L9da"}],"requestBody":"$undefined","heading":"Request","requestBodySchemaTitle":"Request body","headingAs":"h3"}],["$","$L89",null,{"responses":"$21:props:children:0:props:children:props:responses","headingAs":"h3"}]]}],["$","div",null,{"className":"ezz1n32","children":[[["$","$L8a",null,{"itemsByServer":{"https://merchant.revolut.com":[{"id":"curl","label":"cURL","templateCode":"curl -X GET \"https://merchant.revolut.com/api/orders/__RP_TOK_0__/payments\" \\\n -H \"Authorization: __RP_TOK_1__\"","templateHtml":"
curl -X GET \"https://merchant.revolut.com/api/orders/__RP_TOK_0__/payments\" \\\n  -H \"Authorization: __RP_TOK_1__\"
","tokens":[{"marker":"__RP_TOK_0__","paramName":"order_id","paramIn":"path","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["shell-double-inner"]}],"defaults":{"header:Authorization":"Bearer ","path:order_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"javascript","label":"JavaScript","templateCode":"fetch(\"https://merchant.revolut.com/api/orders/__RP_TOK_0__/payments\", {\n method: \"GET\",\n headers: {\n \"Authorization\": \"__RP_TOK_1__\"\n }\n})\n .then(response => response.json())\n .then(data => console.log(data));","templateHtml":"$9db","tokens":[{"marker":"__RP_TOK_0__","paramName":"order_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","path:order_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"go","label":"Go","templateCode":"package main\n\nimport (\n \"fmt\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://merchant.revolut.com/api/orders/__RP_TOK_0__/payments\"\n req, _ := http.NewRequest(\"GET\", url, nil)\n req.Header.Add(\"Authorization\", \"__RP_TOK_1__\")\n\n res, _ := http.DefaultClient.Do(req)\n defer res.Body.Close()\n fmt.Println(res)\n}","templateHtml":"$9dc","tokens":[{"marker":"__RP_TOK_0__","paramName":"order_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","path:order_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"python","label":"Python","templateCode":"import requests\n\nurl = \"https://merchant.revolut.com/api/orders/__RP_TOK_0__/payments\"\nheaders = {\n \"Authorization\": \"__RP_TOK_1__\"\n}\n\nresponse = requests.get(url, headers=headers)\nprint(response.json())","templateHtml":"$9dd","tokens":[{"marker":"__RP_TOK_0__","paramName":"order_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","path:order_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"java","label":"Java","templateCode":"import java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\nimport java.net.URI;\n\npublic class Main {\n public static void main(String[] args) {\n HttpClient client = HttpClient.newHttpClient();\n HttpRequest request = HttpRequest.newBuilder()\n .uri(URI.create(\"https://merchant.revolut.com/api/orders/__RP_TOK_0__/payments\"))\n .header(\"Authorization\", \"__RP_TOK_1__\")\n .GET(HttpRequest.BodyPublishers.noBody())\n .build();\n\n client.sendAsync(request, HttpResponse.BodyHandlers.ofString())\n .thenApply(HttpResponse::body)\n .thenAccept(System.out::println)\n .join();\n }\n}","templateHtml":"$9de","tokens":[{"marker":"__RP_TOK_0__","paramName":"order_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","path:order_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"csharp","label":"C#","templateCode":"using System.Net.Http;\nusing System.Net.Http.Headers;\n\nvar client = new HttpClient();\nvar request = new HttpRequestMessage\n{\n Method = HttpMethod.Get,\n RequestUri = new Uri(\"https://merchant.revolut.com/api/orders/__RP_TOK_0__/payments\"),\n Headers =\n {\n { \"Authorization\", \"__RP_TOK_1__\" },\n }\n};\n\nusing (var response = await client.SendAsync(request))\n{\n response.EnsureSuccessStatusCode();\n var body = await response.Content.ReadAsStringAsync();\n Console.WriteLine(body);\n}","templateHtml":"$9df","tokens":[{"marker":"__RP_TOK_0__","paramName":"order_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","path:order_id":"123e4567-e89b-12d3-a456-426614174000"}}],"https://sandbox-merchant.revolut.com":[{"id":"curl","label":"cURL","templateCode":"curl -X GET \"https://sandbox-merchant.revolut.com/api/orders/__RP_TOK_0__/payments\" \\\n -H \"Authorization: __RP_TOK_1__\"","templateHtml":"
curl -X GET \"https://sandbox-merchant.revolut.com/api/orders/__RP_TOK_0__/payments\" \\\n  -H \"Authorization: __RP_TOK_1__\"
","tokens":[{"marker":"__RP_TOK_0__","paramName":"order_id","paramIn":"path","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["shell-double-inner"]}],"defaults":{"header:Authorization":"Bearer ","path:order_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"javascript","label":"JavaScript","templateCode":"fetch(\"https://sandbox-merchant.revolut.com/api/orders/__RP_TOK_0__/payments\", {\n method: \"GET\",\n headers: {\n \"Authorization\": \"__RP_TOK_1__\"\n }\n})\n .then(response => response.json())\n .then(data => console.log(data));","templateHtml":"$9e0","tokens":[{"marker":"__RP_TOK_0__","paramName":"order_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","path:order_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"go","label":"Go","templateCode":"package main\n\nimport (\n \"fmt\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://sandbox-merchant.revolut.com/api/orders/__RP_TOK_0__/payments\"\n req, _ := http.NewRequest(\"GET\", url, nil)\n req.Header.Add(\"Authorization\", \"__RP_TOK_1__\")\n\n res, _ := http.DefaultClient.Do(req)\n defer res.Body.Close()\n fmt.Println(res)\n}","templateHtml":"$9e1","tokens":[{"marker":"__RP_TOK_0__","paramName":"order_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","path:order_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"python","label":"Python","templateCode":"import requests\n\nurl = \"https://sandbox-merchant.revolut.com/api/orders/__RP_TOK_0__/payments\"\nheaders = {\n \"Authorization\": \"__RP_TOK_1__\"\n}\n\nresponse = requests.get(url, headers=headers)\nprint(response.json())","templateHtml":"$9e2","tokens":[{"marker":"__RP_TOK_0__","paramName":"order_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","path:order_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"java","label":"Java","templateCode":"import java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\nimport java.net.URI;\n\npublic class Main {\n public static void main(String[] args) {\n HttpClient client = HttpClient.newHttpClient();\n HttpRequest request = HttpRequest.newBuilder()\n .uri(URI.create(\"https://sandbox-merchant.revolut.com/api/orders/__RP_TOK_0__/payments\"))\n .header(\"Authorization\", \"__RP_TOK_1__\")\n .GET(HttpRequest.BodyPublishers.noBody())\n .build();\n\n client.sendAsync(request, HttpResponse.BodyHandlers.ofString())\n .thenApply(HttpResponse::body)\n .thenAccept(System.out::println)\n .join();\n }\n}","templateHtml":"$9e3","tokens":[{"marker":"__RP_TOK_0__","paramName":"order_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","path:order_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"csharp","label":"C#","templateCode":"using System.Net.Http;\nusing System.Net.Http.Headers;\n\nvar client = new HttpClient();\nvar request = new HttpRequestMessage\n{\n Method = HttpMethod.Get,\n RequestUri = new Uri(\"https://sandbox-merchant.revolut.com/api/orders/__RP_TOK_0__/payments\"),\n Headers =\n {\n { \"Authorization\", \"__RP_TOK_1__\" },\n }\n};\n\nusing (var response = await client.SendAsync(request))\n{\n response.EnsureSuccessStatusCode();\n var body = await response.Content.ReadAsStringAsync();\n Console.WriteLine(body);\n}","templateHtml":"$9e4","tokens":[{"marker":"__RP_TOK_0__","paramName":"order_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","path:order_id":"123e4567-e89b-12d3-a456-426614174000"}}]},"method":"get","servers":"$62:props:children:0:props:children:props:children:1:props:children:1:props:children:0:0:props:servers","path":"/api/orders/{order_id}/payments","parameters":["$9a5:props:children:0:props:children:1:props:parameters:0","$9a5:props:children:0:props:children:1:props:parameters:1"]}],"$L9e5"],"$L9e6","$L9e7"]}]]}] 9d4:["$","div",null,{"className":"ezz1n30","children":[["$","div",null,{"data-header":"$undefined","className":"ezz1n31","children":["$","div",null,{"className":"y9a0do1","children":[["$","h2",null,{"id":"retrieve-payment-method","children":[["$L9e8","$undefined"],["$","$L15",null,{"id":"retrieve-payment-method"}]]}],["$","$L16",null,{"url":"/docs/api/merchant/2025-10-16/operations/retrieve-payment-method.md"}]]}]}],"$undefined"]}] 9f0:T9f0,
fetch("https://merchant.revolut.com/api/customers/__RP_TOK_0__/payment-methods/__RP_TOK_1__", {
  method: "GET",
  headers: {
    "Authorization": "__RP_TOK_2__",
    "Revolut-Api-Version": "__RP_TOK_3__"
  }
})
  .then(response => response.json())
  .then(data => console.log(data));
9f1:Tf8d,
package main

import (
  "fmt"
  "net/http"
)

func main() {
  url := "https://merchant.revolut.com/api/customers/__RP_TOK_0__/payment-methods/__RP_TOK_1__"
  req, _ := http.NewRequest("GET", url, nil)
  req.Header.Add("Authorization", "__RP_TOK_2__")
  req.Header.Add("Revolut-Api-Version", "__RP_TOK_3__")

  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  fmt.Println(res)
}
9f2:T802,
import requests

url = "https://merchant.revolut.com/api/customers/__RP_TOK_0__/payment-methods/__RP_TOK_1__"
headers = {
  "Authorization": "__RP_TOK_2__",
  "Revolut-Api-Version": "__RP_TOK_3__"
}

response = requests.get(url, headers=headers)
print(response.json())
9f3:T172e,
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;

public class Main {
  public static void main(String[] args) {
    HttpClient client = HttpClient.newHttpClient();
    HttpRequest request = HttpRequest.newBuilder()
      .uri(URI.create("https://merchant.revolut.com/api/customers/__RP_TOK_0__/payment-methods/__RP_TOK_1__"))
      .header("Authorization", "__RP_TOK_2__")
      .header("Revolut-Api-Version", "__RP_TOK_3__")
      .GET(HttpRequest.BodyPublishers.noBody())
      .build();

    client.sendAsync(request, HttpResponse.BodyHandlers.ofString())
      .thenApply(HttpResponse::body)
      .thenAccept(System.out::println)
      .join();
  }
}
9f4:T15d8,
using System.Net.Http;
using System.Net.Http.Headers;

var client = new HttpClient();
var request = new HttpRequestMessage
{
  Method = HttpMethod.Get,
  RequestUri = new Uri("https://merchant.revolut.com/api/customers/__RP_TOK_0__/payment-methods/__RP_TOK_1__"),
  Headers =
  {
    { "Authorization", "__RP_TOK_2__" },
    { "Revolut-Api-Version", "__RP_TOK_3__" },
  }
};

using (var response = await client.SendAsync(request))
{
  response.EnsureSuccessStatusCode();
  var body = await response.Content.ReadAsStringAsync();
  Console.WriteLine(body);
}
9f5:T9f8,
fetch("https://sandbox-merchant.revolut.com/api/customers/__RP_TOK_0__/payment-methods/__RP_TOK_1__", {
  method: "GET",
  headers: {
    "Authorization": "__RP_TOK_2__",
    "Revolut-Api-Version": "__RP_TOK_3__"
  }
})
  .then(response => response.json())
  .then(data => console.log(data));
9f6:Tf95,
package main

import (
  "fmt"
  "net/http"
)

func main() {
  url := "https://sandbox-merchant.revolut.com/api/customers/__RP_TOK_0__/payment-methods/__RP_TOK_1__"
  req, _ := http.NewRequest("GET", url, nil)
  req.Header.Add("Authorization", "__RP_TOK_2__")
  req.Header.Add("Revolut-Api-Version", "__RP_TOK_3__")

  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  fmt.Println(res)
}
9f7:T80a,
import requests

url = "https://sandbox-merchant.revolut.com/api/customers/__RP_TOK_0__/payment-methods/__RP_TOK_1__"
headers = {
  "Authorization": "__RP_TOK_2__",
  "Revolut-Api-Version": "__RP_TOK_3__"
}

response = requests.get(url, headers=headers)
print(response.json())
9f8:T1736,
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;

public class Main {
  public static void main(String[] args) {
    HttpClient client = HttpClient.newHttpClient();
    HttpRequest request = HttpRequest.newBuilder()
      .uri(URI.create("https://sandbox-merchant.revolut.com/api/customers/__RP_TOK_0__/payment-methods/__RP_TOK_1__"))
      .header("Authorization", "__RP_TOK_2__")
      .header("Revolut-Api-Version", "__RP_TOK_3__")
      .GET(HttpRequest.BodyPublishers.noBody())
      .build();

    client.sendAsync(request, HttpResponse.BodyHandlers.ofString())
      .thenApply(HttpResponse::body)
      .thenAccept(System.out::println)
      .join();
  }
}
9f9:T15e0,
using System.Net.Http;
using System.Net.Http.Headers;

var client = new HttpClient();
var request = new HttpRequestMessage
{
  Method = HttpMethod.Get,
  RequestUri = new Uri("https://sandbox-merchant.revolut.com/api/customers/__RP_TOK_0__/payment-methods/__RP_TOK_1__"),
  Headers =
  {
    { "Authorization", "__RP_TOK_2__" },
    { "Revolut-Api-Version", "__RP_TOK_3__" },
  }
};

using (var response = await client.SendAsync(request))
{
  response.EnsureSuccessStatusCode();
  var body = await response.Content.ReadAsStringAsync();
  Console.WriteLine(body);
}
9d5:["$","div",null,{"className":"ezz1n30","children":[["$","div",null,{"data-header":"$undefined","className":"ezz1n31","children":["$L9e9",["$","$L85",null,{"parameters":[{"name":"Authorization","in":"header","schema":{"type":"string","format":"Bearer ","examples":"$62:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:0:schema:examples"},"required":true,"description":"This parameter accepts the [Merchant API Secret key](https://business.revolut.com/settings/apis?tab=merchant-api) to authorise requests coming from the merchant's backend. \n\nIt ensures that ensures that each request is authenticated and authorised by verifying the secret key. The secret key should be included in all request headers as a `Bearer` token.\n\n:::info\nFor more information, see: [Authentication](https://developer.revolut.com/docs/api/merchant#authentication)\n:::","descriptionNode":"$L9ea"},{"name":"Revolut-Api-Version","in":"header","schema":{"type":"string","format":"date","enum":"$27:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:1:schema:enum","examples":"$27:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:1:schema:examples"},"required":true,"description":"The version of the Merchant API, specified in `YYYY-MM-DD` format.\n\nThis endpoint is available from version `2024-09-01`. If a version earlier than `2024-09-01` is provided, the endpoint returns a `404` response.\n\nIf not specified, you will receive an error.\n\n\n:::info\nFor more information about API versioning, see: [API versions](https://developer.revolut.com/docs/guides/merchant/reference/versioning/api-versions).\n:::","x-config-always-visible-in-example":true,"example":"2025-10-16","descriptionNode":"$L9eb"},{"name":"customer_id","in":"path","schema":{"type":"string","format":"uuid","description":"A UUID string, typically used to identify resources.","descriptionNode":"$L9ec"},"required":true,"description":"The ID of the `Customer` object.","descriptionNode":"$L9ed"},{"name":"payment_method_id","in":"path","schema":{"type":"string","format":"uuid","description":"A UUID string, typically used to identify resources.","descriptionNode":"$L9ee"},"required":true,"description":"The ID of the payment method.","descriptionNode":"$L9ef"}],"requestBody":"$undefined","heading":"Request","requestBodySchemaTitle":"Request body","headingAs":"h3"}],["$","$L89",null,{"responses":"$29:props:children:0:props:children:props:responses","headingAs":"h3"}]]}],["$","div",null,{"className":"ezz1n32","children":[[["$","$L8a",null,{"itemsByServer":{"https://merchant.revolut.com":[{"id":"curl","label":"cURL","templateCode":"curl -X GET \"https://merchant.revolut.com/api/customers/__RP_TOK_0__/payment-methods/__RP_TOK_1__\" \\\n -H \"Authorization: __RP_TOK_2__\" \\\n -H \"Revolut-Api-Version: __RP_TOK_3__\"","templateHtml":"
curl -X GET \"https://merchant.revolut.com/api/customers/__RP_TOK_0__/payment-methods/__RP_TOK_1__\" \\\n  -H \"Authorization: __RP_TOK_2__\" \\\n  -H \"Revolut-Api-Version: __RP_TOK_3__\"
","tokens":[{"marker":"__RP_TOK_0__","paramName":"customer_id","paramIn":"path","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_1__","paramName":"payment_method_id","paramIn":"path","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_2__","paramName":"Authorization","paramIn":"header","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_3__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["shell-double-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:customer_id":"123e4567-e89b-12d3-a456-426614174000","path:payment_method_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"javascript","label":"JavaScript","templateCode":"fetch(\"https://merchant.revolut.com/api/customers/__RP_TOK_0__/payment-methods/__RP_TOK_1__\", {\n method: \"GET\",\n headers: {\n \"Authorization\": \"__RP_TOK_2__\",\n \"Revolut-Api-Version\": \"__RP_TOK_3__\"\n }\n})\n .then(response => response.json())\n .then(data => console.log(data));","templateHtml":"$9f0","tokens":[{"marker":"__RP_TOK_0__","paramName":"customer_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"payment_method_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_3__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:customer_id":"123e4567-e89b-12d3-a456-426614174000","path:payment_method_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"go","label":"Go","templateCode":"package main\n\nimport (\n \"fmt\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://merchant.revolut.com/api/customers/__RP_TOK_0__/payment-methods/__RP_TOK_1__\"\n req, _ := http.NewRequest(\"GET\", url, nil)\n req.Header.Add(\"Authorization\", \"__RP_TOK_2__\")\n req.Header.Add(\"Revolut-Api-Version\", \"__RP_TOK_3__\")\n\n res, _ := http.DefaultClient.Do(req)\n defer res.Body.Close()\n fmt.Println(res)\n}","templateHtml":"$9f1","tokens":[{"marker":"__RP_TOK_0__","paramName":"customer_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"payment_method_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_3__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:customer_id":"123e4567-e89b-12d3-a456-426614174000","path:payment_method_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"python","label":"Python","templateCode":"import requests\n\nurl = \"https://merchant.revolut.com/api/customers/__RP_TOK_0__/payment-methods/__RP_TOK_1__\"\nheaders = {\n \"Authorization\": \"__RP_TOK_2__\",\n \"Revolut-Api-Version\": \"__RP_TOK_3__\"\n}\n\nresponse = requests.get(url, headers=headers)\nprint(response.json())","templateHtml":"$9f2","tokens":[{"marker":"__RP_TOK_0__","paramName":"customer_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"payment_method_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_3__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:customer_id":"123e4567-e89b-12d3-a456-426614174000","path:payment_method_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"java","label":"Java","templateCode":"import java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\nimport java.net.URI;\n\npublic class Main {\n public static void main(String[] args) {\n HttpClient client = HttpClient.newHttpClient();\n HttpRequest request = HttpRequest.newBuilder()\n .uri(URI.create(\"https://merchant.revolut.com/api/customers/__RP_TOK_0__/payment-methods/__RP_TOK_1__\"))\n .header(\"Authorization\", \"__RP_TOK_2__\")\n .header(\"Revolut-Api-Version\", \"__RP_TOK_3__\")\n .GET(HttpRequest.BodyPublishers.noBody())\n .build();\n\n client.sendAsync(request, HttpResponse.BodyHandlers.ofString())\n .thenApply(HttpResponse::body)\n .thenAccept(System.out::println)\n .join();\n }\n}","templateHtml":"$9f3","tokens":[{"marker":"__RP_TOK_0__","paramName":"customer_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"payment_method_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_3__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:customer_id":"123e4567-e89b-12d3-a456-426614174000","path:payment_method_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"csharp","label":"C#","templateCode":"using System.Net.Http;\nusing System.Net.Http.Headers;\n\nvar client = new HttpClient();\nvar request = new HttpRequestMessage\n{\n Method = HttpMethod.Get,\n RequestUri = new Uri(\"https://merchant.revolut.com/api/customers/__RP_TOK_0__/payment-methods/__RP_TOK_1__\"),\n Headers =\n {\n { \"Authorization\", \"__RP_TOK_2__\" },\n { \"Revolut-Api-Version\", \"__RP_TOK_3__\" },\n }\n};\n\nusing (var response = await client.SendAsync(request))\n{\n response.EnsureSuccessStatusCode();\n var body = await response.Content.ReadAsStringAsync();\n Console.WriteLine(body);\n}","templateHtml":"$9f4","tokens":[{"marker":"__RP_TOK_0__","paramName":"customer_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"payment_method_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_3__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:customer_id":"123e4567-e89b-12d3-a456-426614174000","path:payment_method_id":"123e4567-e89b-12d3-a456-426614174000"}}],"https://sandbox-merchant.revolut.com":[{"id":"curl","label":"cURL","templateCode":"curl -X GET \"https://sandbox-merchant.revolut.com/api/customers/__RP_TOK_0__/payment-methods/__RP_TOK_1__\" \\\n -H \"Authorization: __RP_TOK_2__\" \\\n -H \"Revolut-Api-Version: __RP_TOK_3__\"","templateHtml":"
curl -X GET \"https://sandbox-merchant.revolut.com/api/customers/__RP_TOK_0__/payment-methods/__RP_TOK_1__\" \\\n  -H \"Authorization: __RP_TOK_2__\" \\\n  -H \"Revolut-Api-Version: __RP_TOK_3__\"
","tokens":[{"marker":"__RP_TOK_0__","paramName":"customer_id","paramIn":"path","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_1__","paramName":"payment_method_id","paramIn":"path","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_2__","paramName":"Authorization","paramIn":"header","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_3__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["shell-double-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:customer_id":"123e4567-e89b-12d3-a456-426614174000","path:payment_method_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"javascript","label":"JavaScript","templateCode":"fetch(\"https://sandbox-merchant.revolut.com/api/customers/__RP_TOK_0__/payment-methods/__RP_TOK_1__\", {\n method: \"GET\",\n headers: {\n \"Authorization\": \"__RP_TOK_2__\",\n \"Revolut-Api-Version\": \"__RP_TOK_3__\"\n }\n})\n .then(response => response.json())\n .then(data => console.log(data));","templateHtml":"$9f5","tokens":[{"marker":"__RP_TOK_0__","paramName":"customer_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"payment_method_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_3__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:customer_id":"123e4567-e89b-12d3-a456-426614174000","path:payment_method_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"go","label":"Go","templateCode":"package main\n\nimport (\n \"fmt\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://sandbox-merchant.revolut.com/api/customers/__RP_TOK_0__/payment-methods/__RP_TOK_1__\"\n req, _ := http.NewRequest(\"GET\", url, nil)\n req.Header.Add(\"Authorization\", \"__RP_TOK_2__\")\n req.Header.Add(\"Revolut-Api-Version\", \"__RP_TOK_3__\")\n\n res, _ := http.DefaultClient.Do(req)\n defer res.Body.Close()\n fmt.Println(res)\n}","templateHtml":"$9f6","tokens":[{"marker":"__RP_TOK_0__","paramName":"customer_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"payment_method_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_3__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:customer_id":"123e4567-e89b-12d3-a456-426614174000","path:payment_method_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"python","label":"Python","templateCode":"import requests\n\nurl = \"https://sandbox-merchant.revolut.com/api/customers/__RP_TOK_0__/payment-methods/__RP_TOK_1__\"\nheaders = {\n \"Authorization\": \"__RP_TOK_2__\",\n \"Revolut-Api-Version\": \"__RP_TOK_3__\"\n}\n\nresponse = requests.get(url, headers=headers)\nprint(response.json())","templateHtml":"$9f7","tokens":[{"marker":"__RP_TOK_0__","paramName":"customer_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"payment_method_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_3__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:customer_id":"123e4567-e89b-12d3-a456-426614174000","path:payment_method_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"java","label":"Java","templateCode":"import java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\nimport java.net.URI;\n\npublic class Main {\n public static void main(String[] args) {\n HttpClient client = HttpClient.newHttpClient();\n HttpRequest request = HttpRequest.newBuilder()\n .uri(URI.create(\"https://sandbox-merchant.revolut.com/api/customers/__RP_TOK_0__/payment-methods/__RP_TOK_1__\"))\n .header(\"Authorization\", \"__RP_TOK_2__\")\n .header(\"Revolut-Api-Version\", \"__RP_TOK_3__\")\n .GET(HttpRequest.BodyPublishers.noBody())\n .build();\n\n client.sendAsync(request, HttpResponse.BodyHandlers.ofString())\n .thenApply(HttpResponse::body)\n .thenAccept(System.out::println)\n .join();\n }\n}","templateHtml":"$9f8","tokens":[{"marker":"__RP_TOK_0__","paramName":"customer_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"payment_method_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_3__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:customer_id":"123e4567-e89b-12d3-a456-426614174000","path:payment_method_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"csharp","label":"C#","templateCode":"using System.Net.Http;\nusing System.Net.Http.Headers;\n\nvar client = new HttpClient();\nvar request = new HttpRequestMessage\n{\n Method = HttpMethod.Get,\n RequestUri = new Uri(\"https://sandbox-merchant.revolut.com/api/customers/__RP_TOK_0__/payment-methods/__RP_TOK_1__\"),\n Headers =\n {\n { \"Authorization\", \"__RP_TOK_2__\" },\n { \"Revolut-Api-Version\", \"__RP_TOK_3__\" },\n }\n};\n\nusing (var response = await client.SendAsync(request))\n{\n response.EnsureSuccessStatusCode();\n var body = await response.Content.ReadAsStringAsync();\n Console.WriteLine(body);\n}","templateHtml":"$9f9","tokens":[{"marker":"__RP_TOK_0__","paramName":"customer_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"payment_method_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_3__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:customer_id":"123e4567-e89b-12d3-a456-426614174000","path:payment_method_id":"123e4567-e89b-12d3-a456-426614174000"}}]},"method":"get","servers":"$62:props:children:0:props:children:props:children:1:props:children:1:props:children:0:0:props:servers","path":"/api/customers/{customer_id}/payment-methods/{payment_method_id}","parameters":["$9d5:props:children:0:props:children:1:props:parameters:0","$9d5:props:children:0:props:children:1:props:parameters:1","$9d5:props:children:0:props:children:1:props:parameters:2","$9d5:props:children:0:props:children:1:props:parameters:3"]}],"$L9fa"],"$L9fb","$L9fc"]}]]}] 93a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Each Merchant API request must contain an authorization header in the following format:"}],"\n","$L9fd","\n",["$","p","p-1",{"children":"To use this API, you need to generate API keys from your Revolut Business account. The Secret key is used in the authorization header for all server calls, while the Public key is provided with payment methods at checkout."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For detailed instructions on generating your API keys, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/get-started#generate-api-keys","target":"_blank","rel":"noreferrer","children":"Generate API keys"}],"."]}]}]]}]]}] 93f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unique ID representing the location where merchants sells products."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#tag-locations","target":"_blank","rel":"noreferrer","children":"Locations"}],"."]}]}]]}]]}] 940:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Name of the location."}],"\n",["$","div","inlinealert-0",{"data-type":"warning","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMark","color":"var(--rui-color-warning)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["The ",["$","code","code-0",{"children":"name"}]," parameter's value must be unique across all locations."]}]}]]}]]}] 941:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Type of the location."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Value","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"online"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Represents an online store.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"physical"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Represents a physical point of sale.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 942:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Domain address of the location. Required for online locations."}],"\n",["$","div","inlinealert-0",{"data-type":"warning","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMark","color":"var(--rui-color-warning)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["The ",["$","code","code-0",{"children":"domain"}]," parameter's value must be unique across all locations."]}]}]]}]]}] 943:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Additional details of the location."}]]}] 944:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unique ID representing the location where merchants sells products."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#tag-locations","target":"_blank","rel":"noreferrer","children":"Locations"}],"."]}]}]]}]]}] 945:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Name of the location."}],"\n",["$","div","inlinealert-0",{"data-type":"warning","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMark","color":"var(--rui-color-warning)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["The ",["$","code","code-0",{"children":"name"}]," parameter's value must be unique across all locations."]}]}]]}]]}] 946:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Type of the location."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Value","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"online"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Represents an online store.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"physical"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Represents a physical point of sale.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 947:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Primary address line."}]]}] 948:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Secondary address line, such as floor and apartment number."}]]}] 949:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"State or province of the address."}]]}] 94a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"City of the address."}]]}] 94b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"ISO 2-letter country code."}]]}] 94c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Postal code of the address."}]]}] 94d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Details of a physical address."}]]}] 94e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The latitude of the location, in decimal degrees."}]]}] 94f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"To longitude of the location, in decimal degrees."}]]}] 950:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Coordinates of the location."}]]}] 9fe:T5fa,
{
  "plan_variation_id": "550e8400-e29b-41d4-a716-446655440000",
  "customer_id": "650e8400-e29b-41d4-a716-446655440001",
  "setup_order_redirect_url": "https://example.com/subscription/setup/complete",
  "external_reference": "ext-ref-12345"
}
893:["$","div","request-application/json-with_setup_order",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$9fe"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"plan_variation_id\": \"550e8400-e29b-41d4-a716-446655440000\",\n \"customer_id\": \"650e8400-e29b-41d4-a716-446655440001\",\n \"setup_order_redirect_url\": \"https://example.com/subscription/setup/complete\",\n \"external_reference\": \"ext-ref-12345\"\n}"}]}]]}] 9ff:T4af,
{
  "plan_variation_id": "550e8400-e29b-41d4-a716-446655440000",
  "customer_id": "650e8400-e29b-41d4-a716-446655440001",
  "external_reference": "ext-ref-12345"
}
894:["$","div","request-application/json-with_setup_order_no_url",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$9ff"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"plan_variation_id\": \"550e8400-e29b-41d4-a716-446655440000\",\n \"customer_id\": \"650e8400-e29b-41d4-a716-446655440001\",\n \"external_reference\": \"ext-ref-12345\"\n}"}]}]]}] a00:T6fe,
{
  "plan_variation_id": "550e8400-e29b-41d4-a716-446655440000",
  "customer_id": "650e8400-e29b-41d4-a716-446655440001",
  "payment_method_id": "6689e244-8af7-4ada-9448-a91f02d4f192",
  "trial_duration": "P14D",
  "external_reference": "ext-ref-12345"
}
895:["$","div","request-application/json-with_trial",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$a00"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"plan_variation_id\": \"550e8400-e29b-41d4-a716-446655440000\",\n \"customer_id\": \"650e8400-e29b-41d4-a716-446655440001\",\n \"payment_method_id\": \"6689e244-8af7-4ada-9448-a91f02d4f192\",\n \"trial_duration\": \"P14D\",\n \"external_reference\": \"ext-ref-12345\"\n}"}]}]]}] a01:T6fd,
{
  "plan_variation_id": "550e8400-e29b-41d4-a716-446655440000",
  "customer_id": "650e8400-e29b-41d4-a716-446655440001",
  "payment_method_id": "6689e244-8af7-4ada-9448-a91f02d4f192",
  "trial_duration": "P0D",
  "external_reference": "ext-ref-12345"
}
896:["$","div","request-application/json-skip_trial",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$a01"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"plan_variation_id\": \"550e8400-e29b-41d4-a716-446655440000\",\n \"customer_id\": \"650e8400-e29b-41d4-a716-446655440001\",\n \"payment_method_id\": \"6689e244-8af7-4ada-9448-a91f02d4f192\",\n \"trial_duration\": \"P0D\",\n \"external_reference\": \"ext-ref-12345\"\n}"}]}]]}] a02:Tdf8,
{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "external_reference": "ext-ref-12345",
  "state": "pending",
  "customer_id": "650e8400-e29b-41d4-a716-446655440001",
  "plan_id": "750e8400-e29b-41d4-a716-446655440002",
  "plan_variation_id": "850e8400-e29b-41d4-a716-446655440003",
  "payment_method_type": "automatic",
  "created_at": "2025-06-05T21:00:00.036001Z",
  "updated_at": "2025-06-05T21:00:00.036001Z",
  "setup_order_id": "a50e8400-e29b-41d4-a716-446655440005",
  "current_cycle_id": "a31627fb-b037-4566-8d7b-f380c1f44653"
}
897:["$","div","201-application/json-with_setup_order",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$a02"}}]}]],"$La03"]}] a04:Tdf8,
{
  "id": "550e8400-e29b-41d4-a716-446655440006",
  "external_reference": "ext-ref-12345",
  "state": "pending",
  "customer_id": "650e8400-e29b-41d4-a716-446655440001",
  "plan_id": "750e8400-e29b-41d4-a716-446655440002",
  "plan_variation_id": "850e8400-e29b-41d4-a716-446655440003",
  "payment_method_type": "automatic",
  "created_at": "2025-06-05T21:00:00.036001Z",
  "updated_at": "2025-06-05T21:00:00.036001Z",
  "setup_order_id": "a50e8400-e29b-41d4-a716-446655440007",
  "current_cycle_id": "a31627fb-b037-4566-8d7b-f380c1f44654"
}
898:["$","div","201-application/json-with_setup_order_no_url",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$a04"}}]}]],"$La05"]}] a06:T44d,
{
  "code": "string",
  "message": "string",
  "timestamp": 123
}
899:["$","div","400-application/json-default",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$a06"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"code\": \"string\",\n \"message\": \"string\",\n \"timestamp\": 123\n}"}]}]]}] a07:T44d,
{
  "code": "string",
  "message": "string",
  "timestamp": 123
}
89a:["$","div","401-application/json-default",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$a07"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"code\": \"string\",\n \"message\": \"string\",\n \"timestamp\": 123\n}"}]}]]}] a08:T44d,
{
  "code": "string",
  "message": "string",
  "timestamp": 123
}
89b:["$","div","default-application/json-default",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$a08"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"code\": \"string\",\n \"message\": \"string\",\n \"timestamp\": 123\n}"}]}]]}] 9e5:["$","$L10d",null,{"security":[{"Api-Key":[]}],"authorization":{"Api-Key":{"type":"apiKey","in":"header","name":"Authorization","description":"Each Merchant API request must contain an authorization header in the following format:\n\n```\n'Authorization: Bearer '\n```\n\nTo use this API, you need to generate API keys from your Revolut Business account. The Secret key is used in the authorization header for all server calls, while the Public key is provided with payment methods at checkout.\n\n:::info\nFor detailed instructions on generating your API keys, see: [Generate API keys](https://developer.revolut.com/docs/guides/merchant/get-started#generate-api-keys).\n:::","descriptionNode":"$La09"}}}] 9e6:["$","$L10f",null,{"exampleBlocks":{},"title":"Request body samples","headingAs":"h4"}] 9e7:["$","$L110",null,{"exampleBlocks":{"200":{"application/json":{"variants":[{"key":"payment_list","label":"List of payments (failed card attempt, SEPA Direct Debit retry)","rawValue":"$21:props:children:0:props:children:props:responses:200:content:application/json:examples:payment_list:value","block":"$La0a"}],"syncedPropertyName":"$undefined"}},"400":{"application/json":{"variants":[{"key":"default","label":"default","rawValue":"$21:props:children:0:props:children:props:responses:400:content:application/json:examples:default:value","block":"$La0b"}],"syncedPropertyName":"$undefined"}},"401":{"application/json":{"variants":[{"key":"default","label":"default","rawValue":"$21:props:children:0:props:children:props:responses:401:content:application/json:examples:default:value","block":"$La0c"}],"syncedPropertyName":"$undefined"}},"404":{"application/json":{"variants":[{"key":"default","label":"Example","rawValue":{"code":"string","message":"string","timestamp":123},"block":"$La0d"}],"syncedPropertyName":"$undefined"}}},"headingAs":"h4"}] 9fa:["$","$L10d",null,{"security":[{"Api-Key":[]}],"authorization":{"Api-Key":{"type":"apiKey","in":"header","name":"Authorization","description":"Each Merchant API request must contain an authorization header in the following format:\n\n```\n'Authorization: Bearer '\n```\n\nTo use this API, you need to generate API keys from your Revolut Business account. The Secret key is used in the authorization header for all server calls, while the Public key is provided with payment methods at checkout.\n\n:::info\nFor detailed instructions on generating your API keys, see: [Generate API keys](https://developer.revolut.com/docs/guides/merchant/get-started#generate-api-keys).\n:::","descriptionNode":"$La0e"}}}] 9fb:["$","$L10f",null,{"exampleBlocks":{},"title":"Request body samples","headingAs":"h4"}] 9fc:["$","$L110",null,{"exampleBlocks":{"200":{"application/json":{"variants":[{"key":"default","label":"Example","rawValue":{"id":"123e4567-e89b-12d3-a456-426614174000","type":"card","saved_for":"customer","created_at":"2024-01-01T00:00:00Z","bin":"string","last_four":"aaaa","expiry_month":123,"expiry_year":123,"cardholder_name":"string","brand":"visa","funding":"debit","issuer":"string","issuer_country":"aa","billing_address":{"street_line_1":"string","street_line_2":"string","region":"string","city":"string","country_code":"aa","postcode":"string"},"terminal_hardware_id":"string"},"block":"$La0f"}],"syncedPropertyName":"$undefined"}},"401":{"application/json":{"variants":[{"key":"default","label":"Example","rawValue":{"code":"string","message":"string","timestamp":123},"block":"$La10"}],"syncedPropertyName":"$undefined"}},"404":{"application/json":{"variants":[{"key":"default","label":"Example","rawValue":{"code":"string","message":"string","timestamp":123},"block":"$La11"}],"syncedPropertyName":"$undefined"}}},"headingAs":"h4"}] a03:["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"id\": \"550e8400-e29b-41d4-a716-446655440000\",\n \"external_reference\": \"ext-ref-12345\",\n \"state\": \"pending\",\n \"customer_id\": \"650e8400-e29b-41d4-a716-446655440001\",\n \"plan_id\": \"750e8400-e29b-41d4-a716-446655440002\",\n \"plan_variation_id\": \"850e8400-e29b-41d4-a716-446655440003\",\n \"payment_method_type\": \"automatic\",\n \"created_at\": \"2025-06-05T21:00:00.036001Z\",\n \"updated_at\": \"2025-06-05T21:00:00.036001Z\",\n \"setup_order_id\": \"a50e8400-e29b-41d4-a716-446655440005\",\n \"current_cycle_id\": \"a31627fb-b037-4566-8d7b-f380c1f44653\"\n}"}]}] a05:["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"id\": \"550e8400-e29b-41d4-a716-446655440006\",\n \"external_reference\": \"ext-ref-12345\",\n \"state\": \"pending\",\n \"customer_id\": \"650e8400-e29b-41d4-a716-446655440001\",\n \"plan_id\": \"750e8400-e29b-41d4-a716-446655440002\",\n \"plan_variation_id\": \"850e8400-e29b-41d4-a716-446655440003\",\n \"payment_method_type\": \"automatic\",\n \"created_at\": \"2025-06-05T21:00:00.036001Z\",\n \"updated_at\": \"2025-06-05T21:00:00.036001Z\",\n \"setup_order_id\": \"a50e8400-e29b-41d4-a716-446655440007\",\n \"current_cycle_id\": \"a31627fb-b037-4566-8d7b-f380c1f44654\"\n}"}]}] 951:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The local time when the interval begins."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["The format is ",["$","code","code-0",{"children":"hh:mm[:ss]"}],"; seconds are optional and must be ",["$","code","code-1",{"children":"00"}]," if provided."]}]}]]}]]}] 952:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The local time when the interval ends."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["The format is ",["$","code","code-0",{"children":"hh:mm[:ss]"}],"; seconds are optional and must be ",["$","code","code-1",{"children":"00"}]," if provided."]}]}]]}]]}] 953:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Opening hours for Monday."}]]}] 954:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Opening hours for Tuesday."}]]}] 955:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Opening hours for Wednesday."}]]}] 956:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Opening hours for Thursday."}]]}] 957:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Opening hours for Friday."}]]}] 958:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Opening hours for Saturday."}]]}] 959:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Opening hours for Sunday."}]]}] 95a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An object containing the opening hours for each day of the week."}],"\n",["$","p","p-1",{"children":"A day can have multiple intervals (e.g., closing for a lunch break)."}]]}] 95b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Additional details of the location."}]]}] 95c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Location object represents merchant locations depending on type."}]]}] 95d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"OK"}]]}] 95e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unauthorized"}]]}] 963:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Retrieve a list of locations registered for the merchant."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],["$","div",null,{"className":"_25vm6y2","children":"Default behavior"}],["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["Without the ",["$","code","code-0",{"children":"type"}]," query parameter, this endpoint returns only ",["$","strong","strong-0",{"children":"online"}]," locations by default. To retrieve physical locations, you must explicitly specify ",["$","code","code-1",{"children":"type=physical"}]," in the query parameters."]}]}]]}]]}] 964:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["This parameter accepts the ",["$","a","a-0",{"href":"https://business.revolut.com/settings/apis?tab=merchant-api","target":"_blank","rel":"noreferrer","children":"Merchant API Secret key"}]," to authorise requests coming from the merchant's backend."]}],"\n",["$","p","p-1",{"children":["It ensures that ensures that each request is authenticated and authorised by verifying the secret key. The secret key should be included in all request headers as a ",["$","code","code-0",{"children":"Bearer"}]," token."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#authentication","target":"_blank","rel":"noreferrer","children":"Authentication"}]]}]}]]}]]}] 965:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Filter the list by location type."}]]}] 973:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Each Merchant API request must contain an authorization header in the following format:"}],"\n","$La12","\n",["$","p","p-1",{"children":"To use this API, you need to generate API keys from your Revolut Business account. The Secret key is used in the authorization header for all server calls, while the Public key is provided with payment methods at checkout."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For detailed instructions on generating your API keys, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/get-started#generate-api-keys","target":"_blank","rel":"noreferrer","children":"Generate API keys"}],"."]}]}]]}]]}] 9d6:"Retrieve payment list of an order" 9e8:"Retrieve a customer's payment method" 28:["$","$7a","retrieve-payment-method-list",{"children":[["$","section",null,{"className":"y9a0do0","data-variant":"endpoint","children":["$","$L7b",null,{"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","required":["payment_methods"],"properties":{"payment_methods":{"type":"array","description":"Saved payment methods associated with this customer. Each entry represents a\npayment method authorised for future charges. Two types are supported: `card`\n(with full card details) and `revolut_pay` (covers both card-backed and\naccount-to-account Revolut Pay variants). Use the `type` field on each item\nto identify the variant.","items":{"title":"Payment method","description":"A saved payment method on a customer profile.\n\nUse the `type` field to determine the specific payment method variant.\n\n:::note\nThis schema represents a stored credential available for future charges and supports three types: `card`, `revolut_pay`, and `sepa_direct_debit`.\n\nIt differs from the `payment_method` object on a Payment, which is a transactional snapshot of how a specific charge was executed and includes additional detail such as wallet wrappers (`apple_pay`, `google_pay`) and Revolut Pay funding source (`revolut_pay_card` vs `revolut_pay_account`).\n:::","discriminator":"$29:props:children:0:props:children:props:responses:200:content:application/json:schema:discriminator","oneOf":[{"title":"Card payment method","type":"object","description":"A saved card payment method.\n\n:::info\nThe `checks` object (3DS, CVV, address verification) is not included as it is specific to the transactional payment context.\n:::","properties":{"id":{"type":"string","format":"uuid","description":"Unique identifier for the payment method.","descriptionNode":"$La13"},"type":{"type":"string","description":"The type of the payment method.","enum":"$29:props:children:0:props:children:props:responses:200:content:application/json:schema:oneOf:0:properties:type:enum","descriptionNode":"$La14"},"saved_for":{"type":"string","enum":"$29:props:children:0:props:children:props:responses:200:content:application/json:schema:oneOf:0:properties:saved_for:enum","description":"Indicates in which case this saved payment method can be used for payments.\n\n| Value | Description |\n| ----- | ----------- |\n| `customer` | This payment method can be used only when the customer is on the checkout page. |\n| `merchant` | This payment method can be used without the customer being on the checkout page, and the merchant can initiate transactions, for example, to take payments for recurring transactions. |","descriptionNode":"$La15"},"created_at":{"type":"string","format":"date-time","description":"The date and time the payment method was added.","descriptionNode":"$La16"},"bin":{"type":"string","description":"The BIN (Bank Identification Number) of the payment card, typically the first 6-8 digits.","descriptionNode":"$La17"},"last_four":{"type":"string","minLength":4,"maxLength":4,"description":"The last four digits of the payment card number.","descriptionNode":"$La18"},"expiry_month":{"type":"integer","description":"The expiry month of the payment card.","descriptionNode":"$La19"},"expiry_year":{"type":"integer","description":"The expiry year of the payment card.","descriptionNode":"$La1a"},"cardholder_name":{"type":"string","description":"The name of the cardholder as it appears on the card.","descriptionNode":"$La1b"},"brand":{"type":"string","description":"The brand of the payment card.","enum":"$29:props:children:0:props:children:props:responses:200:content:application/json:schema:oneOf:0:properties:brand:enum","descriptionNode":"$La1c"},"funding":{"type":"string","description":"The funding type of the payment card.","enum":"$29:props:children:0:props:children:props:responses:200:content:application/json:schema:oneOf:0:properties:funding:enum","descriptionNode":"$La1d"},"issuer":{"type":"string","description":"The name of the card-issuing bank or institution.","descriptionNode":"$La1e"},"issuer_country":{"type":"string","minLength":2,"maxLength":2,"description":"The ISO 3166-1 alpha-2 country code of the country where the payment card was issued.","descriptionNode":"$La1f"},"billing_address":{"title":"Billing address","type":"object","description":"The billing address associated with the payment method.","properties":{"street_line_1":{"type":"string","description":"Primary address line.","maxLength":100,"descriptionNode":"$La20"},"street_line_2":{"type":"string","description":"Secondary address line, such as floor and apartment number.","maxLength":100,"descriptionNode":"$La21"},"region":{"type":"string","description":"State or province of the address.","maxLength":100,"descriptionNode":"$La22"},"city":{"type":"string","description":"City of the address.","maxLength":100,"descriptionNode":"$La23"},"country_code":{"type":"string","pattern":"^[A-Z]{2}$","description":"ISO 2-letter country code.","minLength":2,"maxLength":2,"descriptionNode":"$La24"},"postcode":{"type":"string","description":"Postal code of the address.","maxLength":100,"descriptionNode":"$La25"}},"required":"$29:props:children:0:props:children:props:responses:200:content:application/json:schema:oneOf:0:properties:billing_address:required","descriptionNode":"$La26"},"terminal_hardware_id":{"type":"string","description":"The hardware identifier of the Revolut Terminal device used to process the payment.\n\n:::note\nOnly present for card-present transactions processed via Revolut Terminal.\n:::","descriptionNode":"$La27"}},"required":"$29:props:children:0:props:children:props:responses:200:content:application/json:schema:oneOf:0:required","descriptionNode":"$La28"},{"title":"Revolut Pay payment method","type":"object","description":"A saved Revolut Pay payment method on a customer profile.\n\nBoth Revolut Pay card-backed and account-to-account (A2A) variants are\nrepresented by this single type at the saved payment method level.\nNo underlying card details are exposed here; use the order-level\n`payments[].payment_method` object (types `revolut_pay_card` /\n`revolut_pay_account`) for per-transaction details.","properties":{"id":{"type":"string","format":"uuid","description":"Unique identifier for the payment method.","descriptionNode":"$La29"},"type":{"type":"string","description":"The type of the payment method.","enum":"$29:props:children:0:props:children:props:responses:200:content:application/json:schema:oneOf:0:properties:type:enum","descriptionNode":"$La2a"},"saved_for":{"type":"string","enum":"$29:props:children:0:props:children:props:responses:200:content:application/json:schema:oneOf:0:properties:saved_for:enum","description":"Indicates in which case this saved payment method can be used for payments.\n\n| Value | Description |\n| ----- | ----------- |\n| `customer` | This payment method can be used only when the customer is on the checkout page. |\n| `merchant` | This payment method can be used without the customer being on the checkout page, and the merchant can initiate transactions, for example, to take payments for recurring transactions. |","descriptionNode":"$La2b"},"created_at":{"type":"string","format":"date-time","description":"The date and time the payment method was added.","descriptionNode":"$La2c"}},"required":"$29:props:children:0:props:children:props:responses:200:content:application/json:schema:oneOf:1:required","descriptionNode":"$La2d"},{"title":"SEPA Direct Debit payment method","type":"object","description":"A saved SEPA Direct Debit payment method on a customer profile.\n\n:::info\nFor more information, see: [SEPA Direct Debit server-to-server integration](https://developer.revolut.com/docs/guides/merchant/accept-payments/payment-methods/sepa-direct-debit/server-to-server)\n:::","properties":{"id":{"type":"string","format":"uuid","description":"Unique identifier for the payment method.","descriptionNode":"$La2e"},"type":{"type":"string","description":"The type of the payment method.","enum":"$29:props:children:0:props:children:props:responses:200:content:application/json:schema:oneOf:0:properties:type:enum","descriptionNode":"$La2f"},"saved_for":{"type":"string","enum":"$29:props:children:0:props:children:props:responses:200:content:application/json:schema:oneOf:0:properties:saved_for:enum","description":"Indicates in which case this saved payment method can be used for payments.\n\n| Value | Description |\n| ----- | ----------- |\n| `customer` | This payment method can be used only when the customer is on the checkout page. |\n| `merchant` | This payment method can be used without the customer being on the checkout page, and the merchant can initiate transactions, for example, to take payments for recurring transactions. |","descriptionNode":"$La30"},"debtor_iban_last_four":{"type":"string","description":"The last four digits of the debtor's IBAN.","minLength":4,"maxLength":4,"descriptionNode":"$La31"},"debtor_name":{"type":"string","description":"The full name of the debtor as provided in the mandate.","descriptionNode":"$La32"},"mandate_reference":{"type":"string","description":"The unique mandate reference generated by Revolut. Include this in pre-debit notifications sent to your customers.","descriptionNode":"$La33"},"billing_address":{"title":"Billing address","type":"object","description":"The billing address associated with the payment method.","properties":{"street_line_1":"$28:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_methods:items:oneOf:0:properties:billing_address:properties:street_line_1","street_line_2":"$28:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_methods:items:oneOf:0:properties:billing_address:properties:street_line_2","region":"$28:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_methods:items:oneOf:0:properties:billing_address:properties:region","city":"$28:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_methods:items:oneOf:0:properties:billing_address:properties:city","country_code":"$28:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_methods:items:oneOf:0:properties:billing_address:properties:country_code","postcode":"$28:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_methods:items:oneOf:0:properties:billing_address:properties:postcode"},"required":"$29:props:children:0:props:children:props:responses:200:content:application/json:schema:oneOf:0:properties:billing_address:required","descriptionNode":"$La34"},"created_at":{"type":"string","format":"date-time","description":"The date and time the payment method was added.","descriptionNode":"$La35"}},"required":"$29:props:children:0:props:children:props:responses:200:content:application/json:schema:oneOf:2:required","descriptionNode":"$La36"}],"descriptionNode":"$La37"},"descriptionNode":"$La38"}}},"examples":{"list_of_payment_methods":{"summary":"List of payment methods","value":{"payment_methods":[{"id":"648334a8-9546-a983-a81a-efc6d5bdd0be","type":"revolut_pay","saved_for":"merchant","created_at":"2023-06-09T14:18:16.577888Z"},{"id":"edef3ba4-60a0-4df3-8f12-e5fc858c2420","type":"card","saved_for":"customer","created_at":"2023-03-24T14:15:22Z","bin":"459678","last_four":"6896","expiry_month":3,"expiry_year":2025,"cardholder_name":"Example Customer","brand":"visa","funding":"debit","issuer":"EXAMPLE ISSUER","issuer_country":"GB","billing_address":{"street_line_1":"7","street_line_2":"Westferry Circus","postcode":"E144HD","city":"London","region":"Greater London","country_code":"GB"}},{"id":"a04406c4-05be-498b-8207-cc1e02a9b3ca","type":"card","saved_for":"merchant","created_at":"2023-03-24T14:15:22Z","bin":"459885","last_four":"7653","expiry_month":12,"expiry_year":2026,"cardholder_name":"Example Holder","brand":"mastercard","funding":"credit","issuer":"EXAMPLE ISSUER","issuer_country":"GB","billing_address":{"street_line_1":"Revolut","street_line_2":"1 Canada Square","postcode":"EC2V 6DN","city":"London","region":"Greater London","country_code":"GB"}},{"id":"6a0fe961-a961-a8b6-ad17-ab2779165a82","type":"sepa_direct_debit","saved_for":"merchant","created_at":"2026-05-22T05:28:01.887482Z","debtor_iban_last_four":"3273","debtor_name":"John Doe","mandate_reference":"69F1CB61BD99A32C8E20D7FB9E21E146","billing_address":{"street_line_1":"Bank of England","street_line_2":"Threadneedle St","postcode":"EC2R 8AH","city":"London","region":"Greater London","country_code":"GB"}}]}}}}},"descriptionNode":"$La39"},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"code":{"type":"string","description":"An identifier that can be used to determine what went wrong.\n\nError codes are not globally unique, but uniqueness is guaranteed within endpoints.","descriptionNode":"$La3a"},"message":{"type":"string","description":"Some human readable text describing what went wrong.","descriptionNode":"$La3b"},"timestamp":{"type":"integer","description":"The [UNIX timestamp](https://www.unixtimestamp.com/) of the date and time the error happened.","descriptionNode":"$La3c"}}}}},"descriptionNode":"$La3d"},"404":{"description":"Not Found","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"code":{"type":"string","description":"An identifier that can be used to determine what went wrong.\n\nError codes are not globally unique, but uniqueness is guaranteed within endpoints.","descriptionNode":"$La3e"},"message":{"type":"string","description":"Some human readable text describing what went wrong.","descriptionNode":"$La3f"},"timestamp":{"type":"integer","description":"The [UNIX timestamp](https://www.unixtimestamp.com/) of the date and time the error happened.","descriptionNode":"$La40"}}}}},"descriptionNode":"$La41"}},"requestBody":"$undefined","variantLabels":[],"children":["$La42","$La43"]}]}],false]}] a44:T474,
{
  "url": "https://example.com/webhooks",
  "events": [
    "ORDER_COMPLETED",
    "ORDER_AUTHORISED"
  ]
}
8e4:["$","div","request-application/json-example_webhook_request",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$a44"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"url\": \"https://example.com/webhooks\",\n \"events\": [\n \"ORDER_COMPLETED\",\n \"ORDER_AUTHORISED\"\n ]\n}"}]}]]}] a45:T69c,
{
  "id": "c6b981f4-53b3-47d5-9b24-4f87af1160eb",
  "url": "https://example.com/webhooks",
  "events": [
    "ORDER_AUTHORISED",
    "ORDER_COMPLETED"
  ],
  "signing_secret": "wsk_4jETWMz1g1b37gCONjNp84t2KSSIT7dK"
}
8e5:["$","div","200-application/json-created_webhook",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$a45"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"id\": \"c6b981f4-53b3-47d5-9b24-4f87af1160eb\",\n \"url\": \"https://example.com/webhooks\",\n \"events\": [\n \"ORDER_AUTHORISED\",\n \"ORDER_COMPLETED\"\n ],\n \"signing_secret\": \"wsk_4jETWMz1g1b37gCONjNp84t2KSSIT7dK\"\n}"}]}]]}] a46:T44d,
{
  "code": "string",
  "message": "string",
  "timestamp": 123
}
8e6:["$","div","400-application/json-default",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$a46"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"code\": \"string\",\n \"message\": \"string\",\n \"timestamp\": 123\n}"}]}]]}] a47:T44d,
{
  "code": "string",
  "message": "string",
  "timestamp": 123
}
8e7:["$","div","401-application/json-default",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$a47"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"code\": \"string\",\n \"message\": \"string\",\n \"timestamp\": 123\n}"}]}]]}] a48:T44d,
{
  "code": "string",
  "message": "string",
  "timestamp": 123
}
8e8:["$","div","422-application/json-default",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$a48"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"code\": \"string\",\n \"message\": \"string\",\n \"timestamp\": 123\n}"}]}]]}] a49:T498,
{
  "event": "ORDER_COMPLETED",
  "order_id": "6634c172-3398-ac93-aee9-50de0282e3ac",
  "merchant_order_ext_ref": "Example reference #123"
}
8ed:["$","div","request-application/json-order_event",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$a49"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"event\": \"ORDER_COMPLETED\",\n \"order_id\": \"6634c172-3398-ac93-aee9-50de0282e3ac\",\n \"merchant_order_ext_ref\": \"Example reference #123\"\n}"}]}]]}] a4a:T499,
{
  "event": "SUBSCRIPTION_INITIATED",
  "subscription_id": "550e8400-e29b-41d4-a716-446655440000",
  "external_reference": "ext-ref-12345"
}
8ee:["$","div","request-application/json-subscription_event",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$a4a"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"event\": \"SUBSCRIPTION_INITIATED\",\n \"subscription_id\": \"550e8400-e29b-41d4-a716-446655440000\",\n \"external_reference\": \"ext-ref-12345\"\n}"}]}]]}] a4b:T4b7,
{
  "event": "ORDER_INCREMENTAL_AUTHORISATION_AUTHORISED",
  "order_id": "6634c172-3398-ac93-aee9-50de0282e3ac",
  "incremental_authorisation_ext_reference": "CHG-67890"
}
8ef:["$","div","request-application/json-incremental_auth_authorised",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$a4b"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"event\": \"ORDER_INCREMENTAL_AUTHORISATION_AUTHORISED\",\n \"order_id\": \"6634c172-3398-ac93-aee9-50de0282e3ac\",\n \"incremental_authorisation_ext_reference\": \"CHG-67890\"\n}"}]}]]}] a4c:T4b5,
{
  "event": "ORDER_INCREMENTAL_AUTHORISATION_DECLINED",
  "order_id": "6634c172-3398-ac93-aee9-50de0282e3ac",
  "incremental_authorisation_ext_reference": "CHG-67891"
}
8f0:["$","div","request-application/json-incremental_auth_declined",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$a4c"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"event\": \"ORDER_INCREMENTAL_AUTHORISATION_DECLINED\",\n \"order_id\": \"6634c172-3398-ac93-aee9-50de0282e3ac\",\n \"incremental_authorisation_ext_reference\": \"CHG-67891\"\n}"}]}]]}] a4d:T4b3,
{
  "event": "ORDER_INCREMENTAL_AUTHORISATION_FAILED",
  "order_id": "6634c172-3398-ac93-aee9-50de0282e3ac",
  "incremental_authorisation_ext_reference": "CHG-67892"
}
8f1:["$","div","request-application/json-incremental_auth_failed",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$a4d"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"event\": \"ORDER_INCREMENTAL_AUTHORISATION_FAILED\",\n \"order_id\": \"6634c172-3398-ac93-aee9-50de0282e3ac\",\n \"incremental_authorisation_ext_reference\": \"CHG-67892\"\n}"}]}]]}] a4e:T4ac,
{
  "event": "ORDER_PAYMENT_AUTHORISATION_STARTED",
  "order_id": "6634c172-3398-ac93-aee9-50de0282e3ac",
  "merchant_order_ext_ref": "Example reference #123"
}
8f2:["$","div","request-application/json-authorisation_started",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$a4e"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"event\": \"ORDER_PAYMENT_AUTHORISATION_STARTED\",\n \"order_id\": \"6634c172-3398-ac93-aee9-50de0282e3ac\",\n \"merchant_order_ext_ref\": \"Example reference #123\"\n}"}]}]]}] 8f3:["$","div","request-application/json-payout_event",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"
{\n  \"event\": \"PAYOUT_COMPLETED\",\n  \"payout_id\": \"6634c172-3398-ac93-aee9-50de0282e3ac\"\n}
"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"event\": \"PAYOUT_COMPLETED\",\n \"payout_id\": \"6634c172-3398-ac93-aee9-50de0282e3ac\"\n}"}]}]]}] 8f4:["$","div","request-application/json-dispute_event",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"
{\n  \"event\": \"DISPUTE_ACTION_REQUIRED\",\n  \"dispute_id\": \"ab934829-e4ba-4e7f-8a21-365cad85c763\"\n}
"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"event\": \"DISPUTE_ACTION_REQUIRED\",\n \"dispute_id\": \"ab934829-e4ba-4e7f-8a21-365cad85c763\"\n}"}]}]]}] 975:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The ID of the payment."}]]}] 976:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Permanent order ID used to retrieve, capture, cancel, or refund an order after authorization."}]]}] 977:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of payment method used to pay for the order."}]]}] 978:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Indicates whether the customer used their card or Revolut account via Revolut Pay."}]]}] 979:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"ID of the saved payment method."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["The ",["$","code","code-0",{"children":"id"}]," parameter is only returned if the payment method is saved."]}]}]]}]]}] 97a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of payment method used to pay for the order."}]]}] 97b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Indicates whether the customer used their card or Revolut account via Revolut Pay."}]]}] 97c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"ID of the saved payment method."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["The ",["$","code","code-0",{"children":"id"}]," parameter is only returned if the payment method is saved."]}]}]]}]]}] 97d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of the card."}]]}] 97e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The last four digits of the card number."}]]}] 97f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of payment method used to pay for the order."}]]}] 980:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of the card."}]]}] 981:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The last four digits of the card number."}]]}] 982:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"ID of the saved payment method."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["The ",["$","code","code-0",{"children":"id"}]," parameter is only returned if the payment method is saved."]}]}]]}]]}] 983:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"ID of the saved payment method."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["The ",["$","code","code-0",{"children":"id"}]," parameter is only returned when the payment method is saved for the merchant."]}]}]]}]]}] 9a6:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unique identifier for the payment method."}]]}] 9a7:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of the payment method."}]]}] 9a8:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Indicates in which case this saved payment method can be used for payments."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Value","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"customer"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"This payment method can be used only when the customer is on the checkout page.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"merchant"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"This payment method can be used without the customer being on the checkout page, and the merchant can initiate transactions, for example, to take payments for recurring transactions.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 9a9:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The date and time the payment method was added."}]]}] 9aa:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The BIN (Bank Identification Number) of the payment card, typically the first 6-8 digits."}]]}] 9ab:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The last four digits of the payment card number."}]]}] 9ac:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The expiry month of the payment card."}]]}] 9ad:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The expiry year of the payment card."}]]}] 9ae:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The name of the cardholder as it appears on the card."}]]}] 9af:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The brand of the payment card."}]]}] 9b0:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The funding type of the payment card."}]]}] 9b1:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The name of the card-issuing bank or institution."}]]}] 9b2:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The ISO 3166-1 alpha-2 country code of the country where the payment card was issued."}]]}] 9b3:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Primary address line."}]]}] a42:["$","div",null,{"className":"ezz1n30","children":[["$","div",null,{"data-header":"$undefined","className":"ezz1n31","children":["$","div",null,{"className":"y9a0do1","children":[["$","h2",null,{"id":"retrieve-payment-method-list","children":[["$La4f","$undefined"],["$","$L15",null,{"id":"retrieve-payment-method-list"}]]}],["$","$L16",null,{"url":"/docs/api/merchant/2025-10-16/operations/retrieve-payment-method-list.md"}]]}]}],"$undefined"]}] a56:T9fe,
fetch("https://merchant.revolut.com/api/customers/__RP_TOK_0__/payment-methods?only_merchant=__RP_TOK_1__", {
  method: "GET",
  headers: {
    "Authorization": "__RP_TOK_2__",
    "Revolut-Api-Version": "__RP_TOK_3__"
  }
})
  .then(response => response.json())
  .then(data => console.log(data));
a57:Tf9b,
package main

import (
  "fmt"
  "net/http"
)

func main() {
  url := "https://merchant.revolut.com/api/customers/__RP_TOK_0__/payment-methods?only_merchant=__RP_TOK_1__"
  req, _ := http.NewRequest("GET", url, nil)
  req.Header.Add("Authorization", "__RP_TOK_2__")
  req.Header.Add("Revolut-Api-Version", "__RP_TOK_3__")

  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  fmt.Println(res)
}
a58:T810,
import requests

url = "https://merchant.revolut.com/api/customers/__RP_TOK_0__/payment-methods?only_merchant=__RP_TOK_1__"
headers = {
  "Authorization": "__RP_TOK_2__",
  "Revolut-Api-Version": "__RP_TOK_3__"
}

response = requests.get(url, headers=headers)
print(response.json())
a59:T173c,
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;

public class Main {
  public static void main(String[] args) {
    HttpClient client = HttpClient.newHttpClient();
    HttpRequest request = HttpRequest.newBuilder()
      .uri(URI.create("https://merchant.revolut.com/api/customers/__RP_TOK_0__/payment-methods?only_merchant=__RP_TOK_1__"))
      .header("Authorization", "__RP_TOK_2__")
      .header("Revolut-Api-Version", "__RP_TOK_3__")
      .GET(HttpRequest.BodyPublishers.noBody())
      .build();

    client.sendAsync(request, HttpResponse.BodyHandlers.ofString())
      .thenApply(HttpResponse::body)
      .thenAccept(System.out::println)
      .join();
  }
}
a5a:T15e6,
using System.Net.Http;
using System.Net.Http.Headers;

var client = new HttpClient();
var request = new HttpRequestMessage
{
  Method = HttpMethod.Get,
  RequestUri = new Uri("https://merchant.revolut.com/api/customers/__RP_TOK_0__/payment-methods?only_merchant=__RP_TOK_1__"),
  Headers =
  {
    { "Authorization", "__RP_TOK_2__" },
    { "Revolut-Api-Version", "__RP_TOK_3__" },
  }
};

using (var response = await client.SendAsync(request))
{
  response.EnsureSuccessStatusCode();
  var body = await response.Content.ReadAsStringAsync();
  Console.WriteLine(body);
}
a5b:Ta06,
fetch("https://sandbox-merchant.revolut.com/api/customers/__RP_TOK_0__/payment-methods?only_merchant=__RP_TOK_1__", {
  method: "GET",
  headers: {
    "Authorization": "__RP_TOK_2__",
    "Revolut-Api-Version": "__RP_TOK_3__"
  }
})
  .then(response => response.json())
  .then(data => console.log(data));
a5c:Tfa3,
package main

import (
  "fmt"
  "net/http"
)

func main() {
  url := "https://sandbox-merchant.revolut.com/api/customers/__RP_TOK_0__/payment-methods?only_merchant=__RP_TOK_1__"
  req, _ := http.NewRequest("GET", url, nil)
  req.Header.Add("Authorization", "__RP_TOK_2__")
  req.Header.Add("Revolut-Api-Version", "__RP_TOK_3__")

  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  fmt.Println(res)
}
a5d:T818,
import requests

url = "https://sandbox-merchant.revolut.com/api/customers/__RP_TOK_0__/payment-methods?only_merchant=__RP_TOK_1__"
headers = {
  "Authorization": "__RP_TOK_2__",
  "Revolut-Api-Version": "__RP_TOK_3__"
}

response = requests.get(url, headers=headers)
print(response.json())
a5e:T1744,
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;

public class Main {
  public static void main(String[] args) {
    HttpClient client = HttpClient.newHttpClient();
    HttpRequest request = HttpRequest.newBuilder()
      .uri(URI.create("https://sandbox-merchant.revolut.com/api/customers/__RP_TOK_0__/payment-methods?only_merchant=__RP_TOK_1__"))
      .header("Authorization", "__RP_TOK_2__")
      .header("Revolut-Api-Version", "__RP_TOK_3__")
      .GET(HttpRequest.BodyPublishers.noBody())
      .build();

    client.sendAsync(request, HttpResponse.BodyHandlers.ofString())
      .thenApply(HttpResponse::body)
      .thenAccept(System.out::println)
      .join();
  }
}
a5f:T15ee,
using System.Net.Http;
using System.Net.Http.Headers;

var client = new HttpClient();
var request = new HttpRequestMessage
{
  Method = HttpMethod.Get,
  RequestUri = new Uri("https://sandbox-merchant.revolut.com/api/customers/__RP_TOK_0__/payment-methods?only_merchant=__RP_TOK_1__"),
  Headers =
  {
    { "Authorization", "__RP_TOK_2__" },
    { "Revolut-Api-Version", "__RP_TOK_3__" },
  }
};

using (var response = await client.SendAsync(request))
{
  response.EnsureSuccessStatusCode();
  var body = await response.Content.ReadAsStringAsync();
  Console.WriteLine(body);
}
a43:["$","div",null,{"className":"ezz1n30","children":[["$","div",null,{"data-header":"$undefined","className":"ezz1n31","children":["$La50",["$","$L85",null,{"parameters":[{"name":"Authorization","in":"header","schema":{"type":"string","format":"Bearer ","examples":"$62:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:0:schema:examples"},"required":true,"description":"This parameter accepts the [Merchant API Secret key](https://business.revolut.com/settings/apis?tab=merchant-api) to authorise requests coming from the merchant's backend. \n\nIt ensures that ensures that each request is authenticated and authorised by verifying the secret key. The secret key should be included in all request headers as a `Bearer` token.\n\n:::info\nFor more information, see: [Authentication](https://developer.revolut.com/docs/api/merchant#authentication)\n:::","descriptionNode":"$La51"},{"name":"Revolut-Api-Version","in":"header","schema":{"type":"string","format":"date","enum":"$27:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:1:schema:enum","examples":"$27:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:1:schema:examples"},"required":true,"description":"The version of the Merchant API, specified in `YYYY-MM-DD` format.\n\nThis endpoint is available from version `2024-09-01`. If a version earlier than `2024-09-01` is provided, the endpoint returns a `404` response.\n\nIf not specified, you will receive an error.\n\n\n:::info\nFor more information about API versioning, see: [API versions](https://developer.revolut.com/docs/guides/merchant/reference/versioning/api-versions).\n:::","x-config-always-visible-in-example":true,"example":"2025-10-16","descriptionNode":"$La52"},{"name":"customer_id","in":"path","schema":{"type":"string","format":"uuid","description":"A UUID string, typically used to identify resources.","descriptionNode":"$La53"},"required":true,"description":"The ID of the `Customer` object.","descriptionNode":"$La54"},{"name":"only_merchant","in":"query","schema":{"type":"boolean"},"description":"If `true`, returns only the saved payment methods that can be used for\nmerchant-initiated transactions (MIT).","required":false,"descriptionNode":"$La55"}],"requestBody":"$undefined","heading":"Request","requestBodySchemaTitle":"Request body","headingAs":"h3"}],["$","$L89",null,{"responses":"$28:props:children:0:props:children:props:responses","headingAs":"h3"}]]}],["$","div",null,{"className":"ezz1n32","children":[[["$","$L8a",null,{"itemsByServer":{"https://merchant.revolut.com":[{"id":"curl","label":"cURL","templateCode":"curl -X GET \"https://merchant.revolut.com/api/customers/__RP_TOK_0__/payment-methods?only_merchant=__RP_TOK_1__\" \\\n -H \"Authorization: __RP_TOK_2__\" \\\n -H \"Revolut-Api-Version: __RP_TOK_3__\"","templateHtml":"
curl -X GET \"https://merchant.revolut.com/api/customers/__RP_TOK_0__/payment-methods?only_merchant=__RP_TOK_1__\" \\\n  -H \"Authorization: __RP_TOK_2__\" \\\n  -H \"Revolut-Api-Version: __RP_TOK_3__\"
","tokens":[{"marker":"__RP_TOK_0__","paramName":"customer_id","paramIn":"path","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_1__","paramName":"only_merchant","paramIn":"query","pipeline":["url-component","shell-double-inner"]},{"marker":"__RP_TOK_2__","paramName":"Authorization","paramIn":"header","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_3__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["shell-double-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:customer_id":"123e4567-e89b-12d3-a456-426614174000","query:only_merchant":"true"}},{"id":"javascript","label":"JavaScript","templateCode":"fetch(\"https://merchant.revolut.com/api/customers/__RP_TOK_0__/payment-methods?only_merchant=__RP_TOK_1__\", {\n method: \"GET\",\n headers: {\n \"Authorization\": \"__RP_TOK_2__\",\n \"Revolut-Api-Version\": \"__RP_TOK_3__\"\n }\n})\n .then(response => response.json())\n .then(data => console.log(data));","templateHtml":"$a56","tokens":[{"marker":"__RP_TOK_0__","paramName":"customer_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"only_merchant","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_3__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:customer_id":"123e4567-e89b-12d3-a456-426614174000","query:only_merchant":"true"}},{"id":"go","label":"Go","templateCode":"package main\n\nimport (\n \"fmt\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://merchant.revolut.com/api/customers/__RP_TOK_0__/payment-methods?only_merchant=__RP_TOK_1__\"\n req, _ := http.NewRequest(\"GET\", url, nil)\n req.Header.Add(\"Authorization\", \"__RP_TOK_2__\")\n req.Header.Add(\"Revolut-Api-Version\", \"__RP_TOK_3__\")\n\n res, _ := http.DefaultClient.Do(req)\n defer res.Body.Close()\n fmt.Println(res)\n}","templateHtml":"$a57","tokens":[{"marker":"__RP_TOK_0__","paramName":"customer_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"only_merchant","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_3__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:customer_id":"123e4567-e89b-12d3-a456-426614174000","query:only_merchant":"true"}},{"id":"python","label":"Python","templateCode":"import requests\n\nurl = \"https://merchant.revolut.com/api/customers/__RP_TOK_0__/payment-methods?only_merchant=__RP_TOK_1__\"\nheaders = {\n \"Authorization\": \"__RP_TOK_2__\",\n \"Revolut-Api-Version\": \"__RP_TOK_3__\"\n}\n\nresponse = requests.get(url, headers=headers)\nprint(response.json())","templateHtml":"$a58","tokens":[{"marker":"__RP_TOK_0__","paramName":"customer_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"only_merchant","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_3__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:customer_id":"123e4567-e89b-12d3-a456-426614174000","query:only_merchant":"true"}},{"id":"java","label":"Java","templateCode":"import java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\nimport java.net.URI;\n\npublic class Main {\n public static void main(String[] args) {\n HttpClient client = HttpClient.newHttpClient();\n HttpRequest request = HttpRequest.newBuilder()\n .uri(URI.create(\"https://merchant.revolut.com/api/customers/__RP_TOK_0__/payment-methods?only_merchant=__RP_TOK_1__\"))\n .header(\"Authorization\", \"__RP_TOK_2__\")\n .header(\"Revolut-Api-Version\", \"__RP_TOK_3__\")\n .GET(HttpRequest.BodyPublishers.noBody())\n .build();\n\n client.sendAsync(request, HttpResponse.BodyHandlers.ofString())\n .thenApply(HttpResponse::body)\n .thenAccept(System.out::println)\n .join();\n }\n}","templateHtml":"$a59","tokens":[{"marker":"__RP_TOK_0__","paramName":"customer_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"only_merchant","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_3__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:customer_id":"123e4567-e89b-12d3-a456-426614174000","query:only_merchant":"true"}},{"id":"csharp","label":"C#","templateCode":"using System.Net.Http;\nusing System.Net.Http.Headers;\n\nvar client = new HttpClient();\nvar request = new HttpRequestMessage\n{\n Method = HttpMethod.Get,\n RequestUri = new Uri(\"https://merchant.revolut.com/api/customers/__RP_TOK_0__/payment-methods?only_merchant=__RP_TOK_1__\"),\n Headers =\n {\n { \"Authorization\", \"__RP_TOK_2__\" },\n { \"Revolut-Api-Version\", \"__RP_TOK_3__\" },\n }\n};\n\nusing (var response = await client.SendAsync(request))\n{\n response.EnsureSuccessStatusCode();\n var body = await response.Content.ReadAsStringAsync();\n Console.WriteLine(body);\n}","templateHtml":"$a5a","tokens":[{"marker":"__RP_TOK_0__","paramName":"customer_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"only_merchant","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_3__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:customer_id":"123e4567-e89b-12d3-a456-426614174000","query:only_merchant":"true"}}],"https://sandbox-merchant.revolut.com":[{"id":"curl","label":"cURL","templateCode":"curl -X GET \"https://sandbox-merchant.revolut.com/api/customers/__RP_TOK_0__/payment-methods?only_merchant=__RP_TOK_1__\" \\\n -H \"Authorization: __RP_TOK_2__\" \\\n -H \"Revolut-Api-Version: __RP_TOK_3__\"","templateHtml":"
curl -X GET \"https://sandbox-merchant.revolut.com/api/customers/__RP_TOK_0__/payment-methods?only_merchant=__RP_TOK_1__\" \\\n  -H \"Authorization: __RP_TOK_2__\" \\\n  -H \"Revolut-Api-Version: __RP_TOK_3__\"
","tokens":[{"marker":"__RP_TOK_0__","paramName":"customer_id","paramIn":"path","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_1__","paramName":"only_merchant","paramIn":"query","pipeline":["url-component","shell-double-inner"]},{"marker":"__RP_TOK_2__","paramName":"Authorization","paramIn":"header","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_3__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["shell-double-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:customer_id":"123e4567-e89b-12d3-a456-426614174000","query:only_merchant":"true"}},{"id":"javascript","label":"JavaScript","templateCode":"fetch(\"https://sandbox-merchant.revolut.com/api/customers/__RP_TOK_0__/payment-methods?only_merchant=__RP_TOK_1__\", {\n method: \"GET\",\n headers: {\n \"Authorization\": \"__RP_TOK_2__\",\n \"Revolut-Api-Version\": \"__RP_TOK_3__\"\n }\n})\n .then(response => response.json())\n .then(data => console.log(data));","templateHtml":"$a5b","tokens":[{"marker":"__RP_TOK_0__","paramName":"customer_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"only_merchant","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_3__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:customer_id":"123e4567-e89b-12d3-a456-426614174000","query:only_merchant":"true"}},{"id":"go","label":"Go","templateCode":"package main\n\nimport (\n \"fmt\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://sandbox-merchant.revolut.com/api/customers/__RP_TOK_0__/payment-methods?only_merchant=__RP_TOK_1__\"\n req, _ := http.NewRequest(\"GET\", url, nil)\n req.Header.Add(\"Authorization\", \"__RP_TOK_2__\")\n req.Header.Add(\"Revolut-Api-Version\", \"__RP_TOK_3__\")\n\n res, _ := http.DefaultClient.Do(req)\n defer res.Body.Close()\n fmt.Println(res)\n}","templateHtml":"$a5c","tokens":[{"marker":"__RP_TOK_0__","paramName":"customer_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"only_merchant","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_3__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:customer_id":"123e4567-e89b-12d3-a456-426614174000","query:only_merchant":"true"}},{"id":"python","label":"Python","templateCode":"import requests\n\nurl = \"https://sandbox-merchant.revolut.com/api/customers/__RP_TOK_0__/payment-methods?only_merchant=__RP_TOK_1__\"\nheaders = {\n \"Authorization\": \"__RP_TOK_2__\",\n \"Revolut-Api-Version\": \"__RP_TOK_3__\"\n}\n\nresponse = requests.get(url, headers=headers)\nprint(response.json())","templateHtml":"$a5d","tokens":[{"marker":"__RP_TOK_0__","paramName":"customer_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"only_merchant","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_3__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:customer_id":"123e4567-e89b-12d3-a456-426614174000","query:only_merchant":"true"}},{"id":"java","label":"Java","templateCode":"import java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\nimport java.net.URI;\n\npublic class Main {\n public static void main(String[] args) {\n HttpClient client = HttpClient.newHttpClient();\n HttpRequest request = HttpRequest.newBuilder()\n .uri(URI.create(\"https://sandbox-merchant.revolut.com/api/customers/__RP_TOK_0__/payment-methods?only_merchant=__RP_TOK_1__\"))\n .header(\"Authorization\", \"__RP_TOK_2__\")\n .header(\"Revolut-Api-Version\", \"__RP_TOK_3__\")\n .GET(HttpRequest.BodyPublishers.noBody())\n .build();\n\n client.sendAsync(request, HttpResponse.BodyHandlers.ofString())\n .thenApply(HttpResponse::body)\n .thenAccept(System.out::println)\n .join();\n }\n}","templateHtml":"$a5e","tokens":[{"marker":"__RP_TOK_0__","paramName":"customer_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"only_merchant","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_3__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:customer_id":"123e4567-e89b-12d3-a456-426614174000","query:only_merchant":"true"}},{"id":"csharp","label":"C#","templateCode":"using System.Net.Http;\nusing System.Net.Http.Headers;\n\nvar client = new HttpClient();\nvar request = new HttpRequestMessage\n{\n Method = HttpMethod.Get,\n RequestUri = new Uri(\"https://sandbox-merchant.revolut.com/api/customers/__RP_TOK_0__/payment-methods?only_merchant=__RP_TOK_1__\"),\n Headers =\n {\n { \"Authorization\", \"__RP_TOK_2__\" },\n { \"Revolut-Api-Version\", \"__RP_TOK_3__\" },\n }\n};\n\nusing (var response = await client.SendAsync(request))\n{\n response.EnsureSuccessStatusCode();\n var body = await response.Content.ReadAsStringAsync();\n Console.WriteLine(body);\n}","templateHtml":"$a5f","tokens":[{"marker":"__RP_TOK_0__","paramName":"customer_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"only_merchant","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_3__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:customer_id":"123e4567-e89b-12d3-a456-426614174000","query:only_merchant":"true"}}]},"method":"get","servers":"$62:props:children:0:props:children:props:children:1:props:children:1:props:children:0:0:props:servers","path":"/api/customers/{customer_id}/payment-methods","parameters":["$a43:props:children:0:props:children:1:props:parameters:0","$a43:props:children:0:props:children:1:props:parameters:1","$a43:props:children:0:props:children:1:props:parameters:2","$a43:props:children:0:props:children:1:props:parameters:3"]}],"$La60"],"$La61","$La62"]}]]}] 8fa:["$","div","CodeBlock-0",{"className":"wzy01m0 _18b50nc0","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"
'Authorization: Bearer <yourSecretApiKey>'
"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"'Authorization: Bearer '\n"}]}]]}] 984:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of payment method used to pay for the order."}],"\n",["$","p","p-1",{"children":"Available values:"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":["Payment method ",["$","code","code-0",{"children":"type"}]],"className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"apple_pay"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using Apple Pay.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"card"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using their credit or debit card.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"google_pay"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using Google Pay.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"revolut_pay_card"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order via Revolut Pay using their credit or debit card.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-4",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"revolut_pay_account"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order via Revolut Pay using their Revolut account.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-5",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"sepa_direct_debit"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using SEPA Direct Debit.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 985:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The last four digits of the debtor's IBAN."}]]}] 986:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The full name of the debtor as provided in the mandate."}]]}] 987:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The unique mandate reference generated by Revolut. Include this in pre-debit notifications sent to your customers."}]]}] 988:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object containing details of a SEPA Direct Debit payment."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/accept-payments/payment-methods/sepa-direct-debit/server-to-server","target":"_blank","rel":"noreferrer","children":"SEPA Direct Debit server-to-server integration"}]]}]}]]}]]}] 989:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The payment method used to pay for the order."}]]}] 98a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Temporary token of the payment used to fetch the reward offer during checkout and link user registrations to the given offers."}],"\n",["$","p","p-1",{"children":"The token is only valid for a limited time."}]]}] 98b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The payment amount in minor units (e.g., cents). The value of this field depends on the payment type and state."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Payment type","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"State","className":"eowryt6","ref":"$undefined"}],["$","th","th-2",{"children":"Amount value","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":"Standard payment","className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Any","className":"eowryt7","ref":"$undefined"}],["$","td","td-2",{"children":"Total payment amount","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":"Pre-authorised payment","className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["$","code","code-0",{"children":"authorisation_started"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-2",{"children":"New amount being authorised (during increment processing)","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":"Pre-authorised payment","className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["$","code","code-0",{"children":"authorised"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-2",{"children":["Currently authorised amount (equals ",["$","code","code-0",{"children":"authorised_amount"}],")"],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For pre-authorised payments, see the ",["$","code","code-0",{"children":"authorised_amount"}]," field for tracking the currently authorised amount separately."]}]}]]}]]}] 98c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":[["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_4217","target":"_blank","rel":"noreferrer","children":"ISO 4217"}]," currency code in upper case."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information about the supported currencies, see: ",["$","a","a-0",{"href":"https://help.revolut.com/business/help/merchant-accounts/payments/in-which-currencies-can-i-accept-payments/","target":"_blank","rel":"noreferrer","children":"Help Center"}],"."]}]}]]}]]}] 98d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The status of the payment."}]]}] 98e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The reason for a ",["$","code","code-0",{"children":"failed"}]," or ",["$","code","code-1",{"children":"declined"}]," payment."]}],"\n",["$","p","p-1",{"children":["A failed or declined payment can result from multiple reasons. To learn more, check our ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/reference/error-codes/decline-reasons","target":"_blank","rel":"noreferrer","children":"failure reasons"}],"."]}]]}] 98f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Type of the authentication challenge the payment triggers."}]]}] 990:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The URL of the authentication challenge."}]]}] 991:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Information about the 3DS challenge."}]]}] 992:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Type of the authentication challenge the payment triggers."}]]}] 993:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The URL of the fingerprint. (Used only internally by Revolut.)"}]]}] 994:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Data about the fingerprint used for authentication. (Used only internally\nby Revolut.)"}]]}] 995:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Information about the 3DS fingerprint challenge."}]]}] 996:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["Details about the authentication challenge that should be performed to complete the authentication process. For more information about Revolut's 3DS solution, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/reference/3d-secure","target":"_blank","rel":"noreferrer","children":"3D Secure overview"}],"."]}],"\n",["$","p","p-1",{"children":["Only returned if the payment's state is ",["$","code","code-0",{"children":"authentication_challenge"}],"."]}]]}] 997:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"List of payments"}]]}] 998:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An identifier that can be used to determine what went wrong."}],"\n",["$","p","p-1",{"children":"Error codes are not globally unique, but uniqueness is guaranteed within endpoints."}]]}] 999:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Some human readable text describing what went wrong."}]]}] 99a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://www.unixtimestamp.com/","target":"_blank","rel":"noreferrer","children":"UNIX timestamp"}]," of the date and time the error happened."]}]]}] 99b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Bad Request"}]]}] 99c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An identifier that can be used to determine what went wrong."}],"\n",["$","p","p-1",{"children":"Error codes are not globally unique, but uniqueness is guaranteed within endpoints."}]]}] 99d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Some human readable text describing what went wrong."}]]}] 99e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://www.unixtimestamp.com/","target":"_blank","rel":"noreferrer","children":"UNIX timestamp"}]," of the date and time the error happened."]}]]}] 99f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unauthenticated"}]]}] 9a0:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An identifier that can be used to determine what went wrong."}],"\n",["$","p","p-1",{"children":"Error codes are not globally unique, but uniqueness is guaranteed within endpoints."}]]}] 9a1:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Some human readable text describing what went wrong."}]]}] 9a2:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://www.unixtimestamp.com/","target":"_blank","rel":"noreferrer","children":"UNIX timestamp"}]," of the date and time the error happened."]}]]}] 9a3:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Not Found"}]]}] 9d7:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Retrieve a list of payments for a specific order, based on the order's ID."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":"This endpoint is part of a new API, pay attention to the different endpoint URL."}]}]]}],"\n",["$","p","p-1",{"children":"Use this endpoint to retrieve payment details for saved payment methods to make merchant and customer initiated transactions. For more information, see:"}],"\n",["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/optimise-checkout/save-payment-methods/checkout-with-saved-card","target":"_blank","rel":"noreferrer","children":"Speed up customer checkout by using saved card details"}]}],"\n",["$","li","li-1",{"children":["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/optimise-checkout/save-payment-methods/subscription-management","target":"_blank","rel":"noreferrer","children":"Manage subscriptions"}]}],"\n"]}]]}] 9d8:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["This parameter accepts the ",["$","a","a-0",{"href":"https://business.revolut.com/settings/apis?tab=merchant-api","target":"_blank","rel":"noreferrer","children":"Merchant API Secret key"}]," to authorise requests coming from the merchant's backend."]}],"\n",["$","p","p-1",{"children":["It ensures that ensures that each request is authenticated and authorised by verifying the secret key. The secret key should be included in all request headers as a ",["$","code","code-0",{"children":"Bearer"}]," token."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#authentication","target":"_blank","rel":"noreferrer","children":"Authentication"}]]}]}]]}]]}] 9d9:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A UUID string, typically used to identify resources."}]]}] 9da:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ID of the ",["$","code","code-0",{"children":"Order"}]," object."]}]]}] 9b4:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Secondary address line, such as floor and apartment number."}]]}] 9b5:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"State or province of the address."}]]}] 9b6:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"City of the address."}]]}] 9b7:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"ISO 2-letter country code."}]]}] 9b8:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Postal code of the address."}]]}] 9b9:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The billing address associated with the payment method."}]]}] 9ba:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The hardware identifier of the Revolut Terminal device used to process the payment."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":"Only present for card-present transactions processed via Revolut Terminal."}]}]]}]]}] 9bb:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A saved card payment method."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["The ",["$","code","code-0",{"children":"checks"}]," object (3DS, CVV, address verification) is not included as it is specific to the transactional payment context."]}]}]]}]]}] 9bc:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unique identifier for the payment method."}]]}] 9bd:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of the payment method."}]]}] 9be:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Indicates in which case this saved payment method can be used for payments."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Value","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"customer"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"This payment method can be used only when the customer is on the checkout page.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"merchant"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"This payment method can be used without the customer being on the checkout page, and the merchant can initiate transactions, for example, to take payments for recurring transactions.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 9bf:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The date and time the payment method was added."}]]}] 9c0:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A saved Revolut Pay payment method on a customer profile."}],"\n",["$","p","p-1",{"children":["Both Revolut Pay card-backed and account-to-account (A2A) variants are\nrepresented by this single type at the saved payment method level.\nNo underlying card details are exposed here; use the order-level\n",["$","code","code-0",{"children":"payments[].payment_method"}]," object (types ",["$","code","code-1",{"children":"revolut_pay_card"}]," /\n",["$","code","code-2",{"children":"revolut_pay_account"}],") for per-transaction details."]}]]}] 9c1:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unique identifier for the payment method."}]]}] 9c2:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of the payment method."}]]}] 9c3:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Indicates in which case this saved payment method can be used for payments."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Value","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"customer"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"This payment method can be used only when the customer is on the checkout page.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"merchant"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"This payment method can be used without the customer being on the checkout page, and the merchant can initiate transactions, for example, to take payments for recurring transactions.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 9c4:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The last four digits of the debtor's IBAN."}]]}] 9c5:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The full name of the debtor as provided in the mandate."}]]}] 9c6:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The unique mandate reference generated by Revolut. Include this in pre-debit notifications sent to your customers."}]]}] 9c7:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The billing address associated with the payment method."}]]}] 9c8:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The date and time the payment method was added."}]]}] 9c9:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A saved SEPA Direct Debit payment method on a customer profile."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/accept-payments/payment-methods/sepa-direct-debit/server-to-server","target":"_blank","rel":"noreferrer","children":"SEPA Direct Debit server-to-server integration"}]]}]}]]}]]}] 9ca:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A saved payment method on a customer profile."}],"\n",["$","p","p-1",{"children":["Use the ",["$","code","code-0",{"children":"type"}]," field to determine the specific payment method variant."]}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":["This schema represents a stored credential available for future charges and supports three types: ",["$","code","code-0",{"children":"card"}],", ",["$","code","code-1",{"children":"revolut_pay"}],", and ",["$","code","code-2",{"children":"sepa_direct_debit"}],"."]}],["$","p","p-1",{"children":["It differs from the ",["$","code","code-0",{"children":"payment_method"}]," object on a Payment, which is a transactional snapshot of how a specific charge was executed and includes additional detail such as wallet wrappers (",["$","code","code-1",{"children":"apple_pay"}],", ",["$","code","code-2",{"children":"google_pay"}],") and Revolut Pay funding source (",["$","code","code-3",{"children":"revolut_pay_card"}]," vs ",["$","code","code-4",{"children":"revolut_pay_account"}],")."]}]]}]]}]]}] 9cb:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"OK"}]]}] 9cc:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An identifier that can be used to determine what went wrong."}],"\n",["$","p","p-1",{"children":"Error codes are not globally unique, but uniqueness is guaranteed within endpoints."}]]}] 9cd:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Some human readable text describing what went wrong."}]]}] 9ce:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://www.unixtimestamp.com/","target":"_blank","rel":"noreferrer","children":"UNIX timestamp"}]," of the date and time the error happened."]}]]}] 9cf:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unauthorized"}]]}] 9d0:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An identifier that can be used to determine what went wrong."}],"\n",["$","p","p-1",{"children":"Error codes are not globally unique, but uniqueness is guaranteed within endpoints."}]]}] 9d1:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Some human readable text describing what went wrong."}]]}] 9d2:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://www.unixtimestamp.com/","target":"_blank","rel":"noreferrer","children":"UNIX timestamp"}]," of the date and time the error happened."]}]]}] 9d3:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Not Found"}]]}] 9e9:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Retrieve the information of a specific saved payment method for a customer."}]]}] 9ea:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["This parameter accepts the ",["$","a","a-0",{"href":"https://business.revolut.com/settings/apis?tab=merchant-api","target":"_blank","rel":"noreferrer","children":"Merchant API Secret key"}]," to authorise requests coming from the merchant's backend."]}],"\n",["$","p","p-1",{"children":["It ensures that ensures that each request is authenticated and authorised by verifying the secret key. The secret key should be included in all request headers as a ",["$","code","code-0",{"children":"Bearer"}]," token."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#authentication","target":"_blank","rel":"noreferrer","children":"Authentication"}]]}]}]]}]]}] 9eb:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The version of the Merchant API, specified in ",["$","code","code-0",{"children":"YYYY-MM-DD"}]," format."]}],"\n",["$","p","p-1",{"children":["This endpoint is available from version ",["$","code","code-0",{"children":"2024-09-01"}],". If a version earlier than ",["$","code","code-1",{"children":"2024-09-01"}]," is provided, the endpoint returns a ",["$","code","code-2",{"children":"404"}]," response."]}],"\n",["$","p","p-2",{"children":"If not specified, you will receive an error."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information about API versioning, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/reference/versioning/api-versions","target":"_blank","rel":"noreferrer","children":"API versions"}],"."]}]}]]}]]}] 9ec:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A UUID string, typically used to identify resources."}]]}] 9ed:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ID of the ",["$","code","code-0",{"children":"Customer"}]," object."]}]]}] 9ee:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A UUID string, typically used to identify resources."}]]}] 9ef:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The ID of the payment method."}]]}] a60:["$","$L10d",null,{"security":[{"Api-Key":[]}],"authorization":{"Api-Key":{"type":"apiKey","in":"header","name":"Authorization","description":"Each Merchant API request must contain an authorization header in the following format:\n\n```\n'Authorization: Bearer '\n```\n\nTo use this API, you need to generate API keys from your Revolut Business account. The Secret key is used in the authorization header for all server calls, while the Public key is provided with payment methods at checkout.\n\n:::info\nFor detailed instructions on generating your API keys, see: [Generate API keys](https://developer.revolut.com/docs/guides/merchant/get-started#generate-api-keys).\n:::","descriptionNode":"$La63"}}}] a61:["$","$L10f",null,{"exampleBlocks":{},"title":"Request body samples","headingAs":"h4"}] a62:["$","$L110",null,{"exampleBlocks":{"200":{"application/json":{"variants":[{"key":"list_of_payment_methods","label":"List of payment methods","rawValue":"$28:props:children:0:props:children:props:responses:200:content:application/json:examples:list_of_payment_methods:value","block":"$La64"}],"syncedPropertyName":"$undefined"}},"401":{"application/json":{"variants":[{"key":"default","label":"Example","rawValue":{"code":"string","message":"string","timestamp":123},"block":"$La65"}],"syncedPropertyName":"$undefined"}},"404":{"application/json":{"variants":[{"key":"default","label":"Example","rawValue":{"code":"string","message":"string","timestamp":123},"block":"$La66"}],"syncedPropertyName":"$undefined"}}},"headingAs":"h4"}] 31:["$","$7a","retrieve-subscription-plan",{"children":[["$","section",null,{"className":"y9a0do0","data-variant":"endpoint","children":["$","$L7b",null,{"responses":{"200":{"description":"Subscription plan retrieved successfully","content":{"application/json":{"schema":{"type":"object","required":["id","name","state","created_at","updated_at","variations"],"properties":{"id":{"type":"string","format":"uuid","description":"Unique identifier for the subscription plan.","descriptionNode":"$La67"},"name":{"type":"string","minLength":1,"maxLength":1024,"description":"The name of the subscription plan.","descriptionNode":"$La68"},"trial_duration":{"type":"string","format":"duration","description":"The default trial period duration for this subscription plan in [ISO 8601 duration format](https://en.wikipedia.org/wiki/ISO_8601#Durations) (e.g., \"P14D\" for 14 days).\n\nThis value serves as the default trial duration for all subscriptions created from this plan. Individual subscriptions can override this value at creation time.\n\n:::note\nOnly days (`D`) are allowed. Time components such as hours, minutes, or seconds are not permitted.\n:::","pattern":"^P[0-9]+D$","examples":["P14D"],"descriptionNode":"$La69"},"state":{"type":"string","enum":["active","deactivated"],"description":"The state of the subscription plan.\n\n| State | Description |\n| ----- | ----------- |\n| `active` | The plan is active and can be used to create new subscriptions. |\n| `deactivated` | The plan has been deactivated and cannot be used for new subscriptions. |","descriptionNode":"$La6a"},"created_at":{"type":"string","format":"date-time","description":"The date and time the subscription plan was created in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format.","descriptionNode":"$La6b"},"updated_at":{"type":"string","format":"date-time","description":"The date and time the subscription plan was last updated in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format.","descriptionNode":"$La6c"},"variations":{"type":"array","description":"List of subscription plan variations.","items":{"type":"object","required":["id","phases"],"properties":{"id":{"type":"string","format":"uuid","description":"Unique identifier for the subscription plan variation.","descriptionNode":"$La6d"},"phases":{"type":"array","description":"List of billing phases for this variation.","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Unique identifier for the subscription plan phase.","descriptionNode":"$La6e"},"ordinal":{"type":"integer","minimum":1,"description":"The sequential order of this phase in the subscription billing lifecycle.\n\nPhases execute in ascending order based on this value:\n- Phase with `ordinal=1` executes first\n- Phase with `ordinal=2` executes second, and so on\n\nWhen a phase completes its `cycle_count`, the subscription automatically progresses to the phase with the next `ordinal` value.\n\n**Example**: A subscription with phases ordered as `ordinal=1` (trial), `ordinal=2` (regular), `ordinal=3` (discounted) will progress through them in that sequence.","title":"Subscription-Plan-Ordinal","descriptionNode":"$La6f"},"cycle_duration":{"type":"string","format":"duration","description":"The length of each billing cycle for this phase in [ISO 8601 duration format](https://en.wikipedia.org/wiki/ISO_8601#Durations).\n\nThis determines how often the customer is billed during this phase. The total time spent in a phase is `cycle_duration × cycle_count`.\n\n**Common durations**:\n\n| Duration | Description |\n| -------- | ----------- |\n| `P1M` | 1 month |\n| `P1Y` | 1 year |\n| `P15D` | 15 days |\n| `P1W` | 1 week |\n| `PT2H` | 2 hours |\n\n**Example**: If `cycle_duration=P1M` and `cycle_count=12`, the customer will be billed monthly for 12 months (1 year total).","descriptionNode":"$La70"},"cycle_count":{"type":["integer","null"],"minimum":1,"description":"Number of billing cycles for this phase before moving to the next phase.\n\n| Value | Behavior |\n| ----- | -------- |\n| `null` or omitted | Phase continues indefinitely. The subscription remains in this phase with no automatic progression. |\n| Specific number (e.g., `1`, `3`, `12`) | After completing this many billing cycles, the subscription automatically moves to the next phase as determined by the `ordinal` field. |\n\n**Example**: If `cycle_count=3` and `cycle_duration=P1M`, the subscription will complete 3 monthly cycles then move to the phase with the next highest `ordinal` value.\n\n:::note\nIf no next phase exists in after a cycle with a specific `cycle_count`, the subscription will automatically stop when it completes its cycles.\n:::","title":"Cycle-Count","descriptionNode":"$La71"},"amount":{"type":"integer","minimum":0,"description":"Subscription amount in minor currency units (e.g., cents for USD, pence for GBP).\n\nFor example, `9900` in `GBP` represents £99.00.\n\n:::info\nConversion between major and minor units varies by currency. For instance, `100` minor units equal £1.00 in `GBP`, whereas in `ISK` they represent 100 units. For more details, see the [ISO 4217 standard](https://en.wikipedia.org/wiki/ISO_4217).\n:::","descriptionNode":"$La72"},"currency":{"type":"string","format":"ISO 4217","minLength":3,"maxLength":3,"description":"[ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) currency code in upper case.\n\n:::info\nFor more information about the supported currencies, see: [Help Center](https://help.revolut.com/business/help/merchant-accounts/payments/in-which-currencies-can-i-accept-payments/).\n:::","descriptionNode":"$La73"},"subscription_items":{"type":"array","description":"A list of subscription items for this phase.","items":{"title":"Subscription item","type":"object","description":"A subscription item that defines a billing line within a plan phase. Can be either a fixed-fee (flat) item or a metered (usage) item.","discriminator":{"propertyName":"type","mapping":{"flat":"#/components/schemas/Subscription-Item-Flat","usage":"#/components/schemas/Subscription-Item-Usage"}},"oneOf":[{"type":"object","description":"Object structure of flat subscription item.","properties":{"id":{"type":"string","format":"uuid","description":"The unique identifier of the subscription item.","descriptionNode":"$La74"},"name":{"type":"string","description":"The name of the subscription item.","maxLength":250,"examples":["Base Subscription Fee"],"descriptionNode":"$La75"},"type":{"type":"string","description":"The type of subscription item.","enum":["flat","usage"],"examples":["flat"],"descriptionNode":"$La76"},"package_size":{"type":"number","description":"The number of units grouped together as a single billable package. Used to enable pricing of items that are too inexpensive to charge individually.\n\nFor example, a `package_size` of `1000` with a unit price of 10 minor units (£0.10 in GBP) lets you sell 1000 tokens for £0.10 — effectively pricing each token at £0.0001, below the minimum chargeable amount.\n\nSet to `1` to price each unit individually.","examples":[1],"descriptionNode":"$La77"},"unit":{"type":"string","description":"The unit of measurement for the item.","maxLength":100,"examples":["subscription"],"descriptionNode":"$La78"},"quantity":{"type":"number","description":"The quantity of the item.","examples":[1],"descriptionNode":"$La79"},"amount":{"type":"integer","description":"Amount in minor currency units (e.g., cents for USD).","examples":[9900],"descriptionNode":"$La7a"},"currency":{"type":"string","format":"ISO 4217","minLength":3,"maxLength":3,"description":"[ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) currency code in upper case.\n\n:::info\nFor more information about the supported currencies, see: [Help Center](https://help.revolut.com/business/help/merchant-accounts/payments/in-which-currencies-can-i-accept-payments/).\n:::","descriptionNode":"$La7b"}},"required":["id","name","type","amount","currency","unit","quantity"],"descriptionNode":"$La7c"},{"type":"object","description":"Object structure of usage subscription item.","properties":{"id":{"type":"string","format":"uuid","description":"The unique identifier of the subscription item.","descriptionNode":"$La7d"},"name":{"type":"string","description":"The name of the subscription item.","maxLength":250,"examples":"$31:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:variations:items:properties:phases:items:properties:subscription_items:items:oneOf:0:properties:name:examples","descriptionNode":"$La7e"},"type":{"type":"string","description":"The type of subscription item.","enum":"$31:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:variations:items:properties:phases:items:properties:subscription_items:items:oneOf:0:properties:type:enum","examples":"$31:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:variations:items:properties:phases:items:properties:subscription_items:items:oneOf:0:properties:type:examples","descriptionNode":"$La7f"},"package_size":{"type":"number","description":"The number of units grouped together as a single billable package. Used to enable pricing of items that are too inexpensive to charge individually.\n\nFor example, a `package_size` of `1000` with a unit price of 10 minor units (£0.10 in GBP) lets you sell 1000 tokens for £0.10 — effectively pricing each token at £0.0001, below the minimum chargeable amount.\n\nSet to `1` to price each unit individually.","examples":"$31:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:variations:items:properties:phases:items:properties:subscription_items:items:oneOf:0:properties:package_size:examples","descriptionNode":"$La80"},"unit":{"type":"string","description":"The unit of measurement for the item.","maxLength":100,"examples":"$31:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:variations:items:properties:phases:items:properties:subscription_items:items:oneOf:0:properties:unit:examples","descriptionNode":"$La81"},"amount":{"type":"integer","description":"Flat amount per unit in minor currency units. Mutually exclusive with `tiers`.","examples":[10],"descriptionNode":"$La82"},"currency":{"type":"string","format":"ISO 4217","minLength":3,"maxLength":3,"description":"[ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) currency code in upper case.\n\n:::info\nFor more information about the supported currencies, see: [Help Center](https://help.revolut.com/business/help/merchant-accounts/payments/in-which-currencies-can-i-accept-payments/).\n:::","descriptionNode":"$La83"},"tiers":{"type":"array","description":"Graduated pricing tiers. Mutually exclusive with `amount`.","items":{"type":"object","properties":{"upper_quantity_threshold":{"type":["number","null"],"description":"The upper bound of the tier (exclusive). Null means unlimited.","examples":[100],"descriptionNode":"$La84"},"amount":{"type":"integer","description":"Per-unit amount in minor currency units (e.g., cents for USD) charged for usage within this tier's threshold range.","examples":[500],"descriptionNode":"$La85"}},"required":["amount"]},"descriptionNode":"$La86"},"code":{"type":"string","description":"A merchant-defined identifier for a usage-based subscription item. You set this code on each usage item when creating a subscription plan, and supply it when reporting consumption on [Create a subscription usage endpoint](https://developer.revolut.com/docs/api/merchant#create-subscription-usage) to target the correct metered item.\n\nThis allows a subscription with multiple usage items (e.g., `api_calls` and `storage_gb`) to receive consumption reports against the right item without relying on internal IDs.\n\nThe code must be unique within a plan phase.","maxLength":250,"examples":"$3d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:subscription_item_code:examples","descriptionNode":"$La87"},"usage_aggregation_method":{"type":"string","description":"The method used to aggregate usage events over a billing cycle to calculate the chargeable amount.\n\n| Value | Behaviour |\n| ----- | --------- |\n| `sum` | Totals all reported usage events during the cycle. Use for cumulative metrics (e.g., API calls, data transferred). |\n| `latest` | Uses the most recently reported value at the end of the cycle. If no usage is reported in a cycle, `0` is used — values do not carry over from previous cycles. Use for gauge-style metrics (e.g., active seats). |\n| `max` | Uses the peak value reported during the cycle. Use for capacity-based billing (e.g., max concurrent connections). |","enum":["sum","latest","max"],"examples":["sum"],"descriptionNode":"$La88"}},"required":["id","name","type","currency","unit","code","usage_aggregation_method"],"descriptionNode":"$La89"}],"descriptionNode":"$La8a"},"descriptionNode":"$La8b"}},"required":["id","ordinal","cycle_duration"]},"descriptionNode":"$La8c"}}},"descriptionNode":"$La8d"}}},"examples":{"simple_plan":{"summary":"Simple yearly and monthly plan","value":{"id":"f757b068-f287-43c8-8d05-9c073fecbe73","name":"Enterprise Pro Plan","state":"active","created_at":"2026-01-26T08:59:09.433527Z","updated_at":"2026-01-26T08:59:09.433527Z","variations":[{"id":"f4e0a171-4f4e-484b-b0a2-22085059af65","phases":[{"id":"23319d04-4b23-4ae7-ba54-82112c752683","ordinal":1,"cycle_duration":"P1M","amount":990,"currency":"GBP"}]},{"id":"7cf47b0d-3da9-496b-a4e9-fbbe43c33ee3","phases":[{"id":"feed2491-c895-4bfa-ba05-a3a088842d5c","ordinal":1,"cycle_duration":"P1Y","amount":9990,"currency":"GBP"}]}]}},"trial_plan_with_duration":{"summary":"Plan with trial duration","value":{"id":"750e8400-e29b-41d4-a716-446655440010","name":"Premium Plan with 14-day Trial","trial_duration":"P14D","state":"active","created_at":"2025-06-04T21:00:00.036001Z","updated_at":"2025-06-04T21:00:00.036001Z","variations":[{"id":"850e8400-e29b-41d4-a716-446655440011","phases":[{"id":"950e8400-e29b-41d4-a716-446655440012","ordinal":1,"cycle_duration":"P1M","amount":9900,"currency":"GBP"}]}]}},"limited_plan":{"summary":"Plan that ends after 12 months","value":{"id":"550e8400-e29b-41d4-a716-446655440003","name":"12-month Limited Plan","state":"active","created_at":"2025-06-05T21:00:00.036001Z","updated_at":"2025-06-05T21:00:00.036001Z","variations":[{"id":"550e8400-e29b-41d4-a716-446655440004","phases":[{"id":"550e8400-e29b-41d4-a716-446655440005","ordinal":1,"cycle_duration":"P1M","cycle_count":12,"amount":1000,"currency":"GBP"}]}]}}}}},"descriptionNode":"$La8e"},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"code":{"type":"string","description":"An identifier that can be used to determine what went wrong.\n\nError codes are not globally unique, but uniqueness is guaranteed within endpoints.","descriptionNode":"$La8f"},"message":{"type":"string","description":"Some human readable text describing what went wrong.","descriptionNode":"$La90"},"timestamp":{"type":"integer","description":"The [UNIX timestamp](https://www.unixtimestamp.com/) of the date and time the error happened.","descriptionNode":"$La91"}}}}},"descriptionNode":"$La92"},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"code":{"type":"string","description":"An identifier that can be used to determine what went wrong.\n\nError codes are not globally unique, but uniqueness is guaranteed within endpoints.","descriptionNode":"$La93"},"message":{"type":"string","description":"Some human readable text describing what went wrong.","descriptionNode":"$La94"},"timestamp":{"type":"integer","description":"The [UNIX timestamp](https://www.unixtimestamp.com/) of the date and time the error happened.","descriptionNode":"$La95"}}}}},"descriptionNode":"$La96"},"404":{"description":"Subscription plan not found","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"code":{"type":"string","description":"An identifier that can be used to determine what went wrong.\n\nError codes are not globally unique, but uniqueness is guaranteed within endpoints.","descriptionNode":"$La97"},"message":{"type":"string","description":"Some human readable text describing what went wrong.","descriptionNode":"$La98"},"timestamp":{"type":"integer","description":"The [UNIX timestamp](https://www.unixtimestamp.com/) of the date and time the error happened.","descriptionNode":"$La99"}}}}},"descriptionNode":"$La9a"},"default":{"description":"Error response","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"code":{"type":"string","description":"An identifier that can be used to determine what went wrong.\n\nError codes are not globally unique, but uniqueness is guaranteed within endpoints.","descriptionNode":"$La9b"},"message":{"type":"string","description":"Some human readable text describing what went wrong.","descriptionNode":"$La9c"},"timestamp":{"type":"integer","description":"The [UNIX timestamp](https://www.unixtimestamp.com/) of the date and time the error happened.","descriptionNode":"$La9d"}}}}},"descriptionNode":"$La9e"}},"requestBody":"$undefined","variantLabels":["Simple yearly and monthly plan","Plan with trial duration","Plan that ends after 12 months"],"children":["$La9f","$Laa0"]}]}],false]}] a09:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Each Merchant API request must contain an authorization header in the following format:"}],"\n","$Laa1","\n",["$","p","p-1",{"children":"To use this API, you need to generate API keys from your Revolut Business account. The Secret key is used in the authorization header for all server calls, while the Public key is provided with payment methods at checkout."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For detailed instructions on generating your API keys, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/get-started#generate-api-keys","target":"_blank","rel":"noreferrer","children":"Generate API keys"}],"."]}]}]]}]]}] a0e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Each Merchant API request must contain an authorization header in the following format:"}],"\n","$Laa2","\n",["$","p","p-1",{"children":"To use this API, you need to generate API keys from your Revolut Business account. The Secret key is used in the authorization header for all server calls, while the Public key is provided with payment methods at checkout."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For detailed instructions on generating your API keys, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/get-started#generate-api-keys","target":"_blank","rel":"noreferrer","children":"Generate API keys"}],"."]}]}]]}]]}] a9f:["$","div",null,{"className":"ezz1n30","children":[["$","div",null,{"data-header":"$undefined","className":"ezz1n31","children":["$","div",null,{"className":"y9a0do1","children":[["$","h2",null,{"id":"retrieve-subscription-plan","children":[["$Laa3","$undefined"],["$","$L15",null,{"id":"retrieve-subscription-plan"}]]}],["$","$L16",null,{"url":"/docs/api/merchant/2025-10-16/operations/retrieve-subscription-plan.md"}]]}]}],"$undefined"]}] aa9:T9dc,
fetch("https://merchant.revolut.com/api/subscription-plans/__RP_TOK_0__", {
  method: "GET",
  headers: {
    "Authorization": "__RP_TOK_1__",
    "Revolut-Api-Version": "__RP_TOK_2__"
  }
})
  .then(response => response.json())
  .then(data => console.log(data));
aaa:Tf79,
package main

import (
  "fmt"
  "net/http"
)

func main() {
  url := "https://merchant.revolut.com/api/subscription-plans/__RP_TOK_0__"
  req, _ := http.NewRequest("GET", url, nil)
  req.Header.Add("Authorization", "__RP_TOK_1__")
  req.Header.Add("Revolut-Api-Version", "__RP_TOK_2__")

  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  fmt.Println(res)
}
aab:T7ee,
import requests

url = "https://merchant.revolut.com/api/subscription-plans/__RP_TOK_0__"
headers = {
  "Authorization": "__RP_TOK_1__",
  "Revolut-Api-Version": "__RP_TOK_2__"
}

response = requests.get(url, headers=headers)
print(response.json())
aac:T171a,
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;

public class Main {
  public static void main(String[] args) {
    HttpClient client = HttpClient.newHttpClient();
    HttpRequest request = HttpRequest.newBuilder()
      .uri(URI.create("https://merchant.revolut.com/api/subscription-plans/__RP_TOK_0__"))
      .header("Authorization", "__RP_TOK_1__")
      .header("Revolut-Api-Version", "__RP_TOK_2__")
      .GET(HttpRequest.BodyPublishers.noBody())
      .build();

    client.sendAsync(request, HttpResponse.BodyHandlers.ofString())
      .thenApply(HttpResponse::body)
      .thenAccept(System.out::println)
      .join();
  }
}
aad:T15c4,
using System.Net.Http;
using System.Net.Http.Headers;

var client = new HttpClient();
var request = new HttpRequestMessage
{
  Method = HttpMethod.Get,
  RequestUri = new Uri("https://merchant.revolut.com/api/subscription-plans/__RP_TOK_0__"),
  Headers =
  {
    { "Authorization", "__RP_TOK_1__" },
    { "Revolut-Api-Version", "__RP_TOK_2__" },
  }
};

using (var response = await client.SendAsync(request))
{
  response.EnsureSuccessStatusCode();
  var body = await response.Content.ReadAsStringAsync();
  Console.WriteLine(body);
}
aae:T9e4,
fetch("https://sandbox-merchant.revolut.com/api/subscription-plans/__RP_TOK_0__", {
  method: "GET",
  headers: {
    "Authorization": "__RP_TOK_1__",
    "Revolut-Api-Version": "__RP_TOK_2__"
  }
})
  .then(response => response.json())
  .then(data => console.log(data));
aaf:Tf81,
package main

import (
  "fmt"
  "net/http"
)

func main() {
  url := "https://sandbox-merchant.revolut.com/api/subscription-plans/__RP_TOK_0__"
  req, _ := http.NewRequest("GET", url, nil)
  req.Header.Add("Authorization", "__RP_TOK_1__")
  req.Header.Add("Revolut-Api-Version", "__RP_TOK_2__")

  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  fmt.Println(res)
}
ab0:T7f6,
import requests

url = "https://sandbox-merchant.revolut.com/api/subscription-plans/__RP_TOK_0__"
headers = {
  "Authorization": "__RP_TOK_1__",
  "Revolut-Api-Version": "__RP_TOK_2__"
}

response = requests.get(url, headers=headers)
print(response.json())
ab1:T1722,
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;

public class Main {
  public static void main(String[] args) {
    HttpClient client = HttpClient.newHttpClient();
    HttpRequest request = HttpRequest.newBuilder()
      .uri(URI.create("https://sandbox-merchant.revolut.com/api/subscription-plans/__RP_TOK_0__"))
      .header("Authorization", "__RP_TOK_1__")
      .header("Revolut-Api-Version", "__RP_TOK_2__")
      .GET(HttpRequest.BodyPublishers.noBody())
      .build();

    client.sendAsync(request, HttpResponse.BodyHandlers.ofString())
      .thenApply(HttpResponse::body)
      .thenAccept(System.out::println)
      .join();
  }
}
ab2:T15cc,
using System.Net.Http;
using System.Net.Http.Headers;

var client = new HttpClient();
var request = new HttpRequestMessage
{
  Method = HttpMethod.Get,
  RequestUri = new Uri("https://sandbox-merchant.revolut.com/api/subscription-plans/__RP_TOK_0__"),
  Headers =
  {
    { "Authorization", "__RP_TOK_1__" },
    { "Revolut-Api-Version", "__RP_TOK_2__" },
  }
};

using (var response = await client.SendAsync(request))
{
  response.EnsureSuccessStatusCode();
  var body = await response.Content.ReadAsStringAsync();
  Console.WriteLine(body);
}
aa0:["$","div",null,{"className":"ezz1n30","children":[["$","div",null,{"data-header":"$undefined","className":"ezz1n31","children":["$Laa4",["$","$L85",null,{"parameters":[{"name":"Authorization","in":"header","schema":{"type":"string","format":"Bearer ","examples":"$62:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:0:schema:examples"},"required":true,"description":"This parameter accepts the [Merchant API Secret key](https://business.revolut.com/settings/apis?tab=merchant-api) to authorise requests coming from the merchant's backend. \n\nIt ensures that ensures that each request is authenticated and authorised by verifying the secret key. The secret key should be included in all request headers as a `Bearer` token.\n\n:::info\nFor more information, see: [Authentication](https://developer.revolut.com/docs/api/merchant#authentication)\n:::","descriptionNode":"$Laa5"},{"name":"Revolut-Api-Version","in":"header","schema":{"type":"string","format":"date","enum":"$36:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:1:schema:enum","examples":"$36:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:1:schema:examples"},"required":true,"description":"The version of the Merchant API, specified in `YYYY-MM-DD` format.\n\nIf not specified, you will receive an error.\n\n\n:::info\nFor more information about API versioning, see: [API versions](https://developer.revolut.com/docs/guides/merchant/reference/versioning/api-versions).\n:::","x-config-always-visible-in-example":true,"example":"2025-10-16","descriptionNode":"$Laa6"},{"name":"subscription_plan_id","in":"path","schema":{"type":"string","format":"uuid","description":"A UUID string, typically used to identify resources.","descriptionNode":"$Laa7"},"required":true,"description":"The ID of the subscription plan.","descriptionNode":"$Laa8"}],"requestBody":"$undefined","heading":"Request","requestBodySchemaTitle":"Request body","headingAs":"h3"}],["$","$L89",null,{"responses":"$31:props:children:0:props:children:props:responses","headingAs":"h3"}]]}],["$","div",null,{"className":"ezz1n32","children":[[["$","$L8a",null,{"itemsByServer":{"https://merchant.revolut.com":[{"id":"curl","label":"cURL","templateCode":"curl -X GET \"https://merchant.revolut.com/api/subscription-plans/__RP_TOK_0__\" \\\n -H \"Authorization: __RP_TOK_1__\" \\\n -H \"Revolut-Api-Version: __RP_TOK_2__\"","templateHtml":"
curl -X GET \"https://merchant.revolut.com/api/subscription-plans/__RP_TOK_0__\" \\\n  -H \"Authorization: __RP_TOK_1__\" \\\n  -H \"Revolut-Api-Version: __RP_TOK_2__\"
","tokens":[{"marker":"__RP_TOK_0__","paramName":"subscription_plan_id","paramIn":"path","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["shell-double-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:subscription_plan_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"javascript","label":"JavaScript","templateCode":"fetch(\"https://merchant.revolut.com/api/subscription-plans/__RP_TOK_0__\", {\n method: \"GET\",\n headers: {\n \"Authorization\": \"__RP_TOK_1__\",\n \"Revolut-Api-Version\": \"__RP_TOK_2__\"\n }\n})\n .then(response => response.json())\n .then(data => console.log(data));","templateHtml":"$aa9","tokens":[{"marker":"__RP_TOK_0__","paramName":"subscription_plan_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:subscription_plan_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"go","label":"Go","templateCode":"package main\n\nimport (\n \"fmt\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://merchant.revolut.com/api/subscription-plans/__RP_TOK_0__\"\n req, _ := http.NewRequest(\"GET\", url, nil)\n req.Header.Add(\"Authorization\", \"__RP_TOK_1__\")\n req.Header.Add(\"Revolut-Api-Version\", \"__RP_TOK_2__\")\n\n res, _ := http.DefaultClient.Do(req)\n defer res.Body.Close()\n fmt.Println(res)\n}","templateHtml":"$aaa","tokens":[{"marker":"__RP_TOK_0__","paramName":"subscription_plan_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:subscription_plan_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"python","label":"Python","templateCode":"import requests\n\nurl = \"https://merchant.revolut.com/api/subscription-plans/__RP_TOK_0__\"\nheaders = {\n \"Authorization\": \"__RP_TOK_1__\",\n \"Revolut-Api-Version\": \"__RP_TOK_2__\"\n}\n\nresponse = requests.get(url, headers=headers)\nprint(response.json())","templateHtml":"$aab","tokens":[{"marker":"__RP_TOK_0__","paramName":"subscription_plan_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:subscription_plan_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"java","label":"Java","templateCode":"import java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\nimport java.net.URI;\n\npublic class Main {\n public static void main(String[] args) {\n HttpClient client = HttpClient.newHttpClient();\n HttpRequest request = HttpRequest.newBuilder()\n .uri(URI.create(\"https://merchant.revolut.com/api/subscription-plans/__RP_TOK_0__\"))\n .header(\"Authorization\", \"__RP_TOK_1__\")\n .header(\"Revolut-Api-Version\", \"__RP_TOK_2__\")\n .GET(HttpRequest.BodyPublishers.noBody())\n .build();\n\n client.sendAsync(request, HttpResponse.BodyHandlers.ofString())\n .thenApply(HttpResponse::body)\n .thenAccept(System.out::println)\n .join();\n }\n}","templateHtml":"$aac","tokens":[{"marker":"__RP_TOK_0__","paramName":"subscription_plan_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:subscription_plan_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"csharp","label":"C#","templateCode":"using System.Net.Http;\nusing System.Net.Http.Headers;\n\nvar client = new HttpClient();\nvar request = new HttpRequestMessage\n{\n Method = HttpMethod.Get,\n RequestUri = new Uri(\"https://merchant.revolut.com/api/subscription-plans/__RP_TOK_0__\"),\n Headers =\n {\n { \"Authorization\", \"__RP_TOK_1__\" },\n { \"Revolut-Api-Version\", \"__RP_TOK_2__\" },\n }\n};\n\nusing (var response = await client.SendAsync(request))\n{\n response.EnsureSuccessStatusCode();\n var body = await response.Content.ReadAsStringAsync();\n Console.WriteLine(body);\n}","templateHtml":"$aad","tokens":[{"marker":"__RP_TOK_0__","paramName":"subscription_plan_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:subscription_plan_id":"123e4567-e89b-12d3-a456-426614174000"}}],"https://sandbox-merchant.revolut.com":[{"id":"curl","label":"cURL","templateCode":"curl -X GET \"https://sandbox-merchant.revolut.com/api/subscription-plans/__RP_TOK_0__\" \\\n -H \"Authorization: __RP_TOK_1__\" \\\n -H \"Revolut-Api-Version: __RP_TOK_2__\"","templateHtml":"
curl -X GET \"https://sandbox-merchant.revolut.com/api/subscription-plans/__RP_TOK_0__\" \\\n  -H \"Authorization: __RP_TOK_1__\" \\\n  -H \"Revolut-Api-Version: __RP_TOK_2__\"
","tokens":[{"marker":"__RP_TOK_0__","paramName":"subscription_plan_id","paramIn":"path","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["shell-double-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:subscription_plan_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"javascript","label":"JavaScript","templateCode":"fetch(\"https://sandbox-merchant.revolut.com/api/subscription-plans/__RP_TOK_0__\", {\n method: \"GET\",\n headers: {\n \"Authorization\": \"__RP_TOK_1__\",\n \"Revolut-Api-Version\": \"__RP_TOK_2__\"\n }\n})\n .then(response => response.json())\n .then(data => console.log(data));","templateHtml":"$aae","tokens":[{"marker":"__RP_TOK_0__","paramName":"subscription_plan_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:subscription_plan_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"go","label":"Go","templateCode":"package main\n\nimport (\n \"fmt\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://sandbox-merchant.revolut.com/api/subscription-plans/__RP_TOK_0__\"\n req, _ := http.NewRequest(\"GET\", url, nil)\n req.Header.Add(\"Authorization\", \"__RP_TOK_1__\")\n req.Header.Add(\"Revolut-Api-Version\", \"__RP_TOK_2__\")\n\n res, _ := http.DefaultClient.Do(req)\n defer res.Body.Close()\n fmt.Println(res)\n}","templateHtml":"$aaf","tokens":[{"marker":"__RP_TOK_0__","paramName":"subscription_plan_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:subscription_plan_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"python","label":"Python","templateCode":"import requests\n\nurl = \"https://sandbox-merchant.revolut.com/api/subscription-plans/__RP_TOK_0__\"\nheaders = {\n \"Authorization\": \"__RP_TOK_1__\",\n \"Revolut-Api-Version\": \"__RP_TOK_2__\"\n}\n\nresponse = requests.get(url, headers=headers)\nprint(response.json())","templateHtml":"$ab0","tokens":[{"marker":"__RP_TOK_0__","paramName":"subscription_plan_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:subscription_plan_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"java","label":"Java","templateCode":"import java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\nimport java.net.URI;\n\npublic class Main {\n public static void main(String[] args) {\n HttpClient client = HttpClient.newHttpClient();\n HttpRequest request = HttpRequest.newBuilder()\n .uri(URI.create(\"https://sandbox-merchant.revolut.com/api/subscription-plans/__RP_TOK_0__\"))\n .header(\"Authorization\", \"__RP_TOK_1__\")\n .header(\"Revolut-Api-Version\", \"__RP_TOK_2__\")\n .GET(HttpRequest.BodyPublishers.noBody())\n .build();\n\n client.sendAsync(request, HttpResponse.BodyHandlers.ofString())\n .thenApply(HttpResponse::body)\n .thenAccept(System.out::println)\n .join();\n }\n}","templateHtml":"$ab1","tokens":[{"marker":"__RP_TOK_0__","paramName":"subscription_plan_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:subscription_plan_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"csharp","label":"C#","templateCode":"using System.Net.Http;\nusing System.Net.Http.Headers;\n\nvar client = new HttpClient();\nvar request = new HttpRequestMessage\n{\n Method = HttpMethod.Get,\n RequestUri = new Uri(\"https://sandbox-merchant.revolut.com/api/subscription-plans/__RP_TOK_0__\"),\n Headers =\n {\n { \"Authorization\", \"__RP_TOK_1__\" },\n { \"Revolut-Api-Version\", \"__RP_TOK_2__\" },\n }\n};\n\nusing (var response = await client.SendAsync(request))\n{\n response.EnsureSuccessStatusCode();\n var body = await response.Content.ReadAsStringAsync();\n Console.WriteLine(body);\n}","templateHtml":"$ab2","tokens":[{"marker":"__RP_TOK_0__","paramName":"subscription_plan_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:subscription_plan_id":"123e4567-e89b-12d3-a456-426614174000"}}]},"method":"get","servers":"$62:props:children:0:props:children:props:children:1:props:children:1:props:children:0:0:props:servers","path":"/api/subscription-plans/{subscription_plan_id}","parameters":["$aa0:props:children:0:props:children:1:props:parameters:0","$aa0:props:children:0:props:children:1:props:parameters:1","$aa0:props:children:0:props:children:1:props:parameters:2"]}],"$Lab3"],"$Lab4","$Lab5"]}]]}] a4f:"Retrieve payment method list of a customer" ab3:["$","$L10d",null,{"security":[{"Api-Key":[]}],"authorization":{"Api-Key":{"type":"apiKey","in":"header","name":"Authorization","description":"Each Merchant API request must contain an authorization header in the following format:\n\n```\n'Authorization: Bearer '\n```\n\nTo use this API, you need to generate API keys from your Revolut Business account. The Secret key is used in the authorization header for all server calls, while the Public key is provided with payment methods at checkout.\n\n:::info\nFor detailed instructions on generating your API keys, see: [Generate API keys](https://developer.revolut.com/docs/guides/merchant/get-started#generate-api-keys).\n:::","descriptionNode":"$Lab6"}}}] ab4:["$","$L10f",null,{"exampleBlocks":{},"title":"Request body samples","headingAs":"h4"}] ab5:["$","$L110",null,{"exampleBlocks":{"200":{"application/json":{"variants":[{"key":"simple_plan","label":"Simple yearly and monthly plan","rawValue":"$31:props:children:0:props:children:props:responses:200:content:application/json:examples:simple_plan:value","block":"$Lab7"},{"key":"trial_plan_with_duration","label":"Plan with trial duration","rawValue":"$31:props:children:0:props:children:props:responses:200:content:application/json:examples:trial_plan_with_duration:value","block":"$Lab8"},{"key":"limited_plan","label":"Plan that ends after 12 months","rawValue":"$31:props:children:0:props:children:props:responses:200:content:application/json:examples:limited_plan:value","block":"$Lab9"}],"syncedPropertyName":"$undefined"}},"400":{"application/json":{"variants":[{"key":"default","label":"Example","rawValue":{"code":"string","message":"string","timestamp":123},"block":"$Laba"}],"syncedPropertyName":"$undefined"}},"401":{"application/json":{"variants":[{"key":"default","label":"Example","rawValue":{"code":"string","message":"string","timestamp":123},"block":"$Labb"}],"syncedPropertyName":"$undefined"}},"404":{"application/json":{"variants":[{"key":"default","label":"Example","rawValue":{"code":"string","message":"string","timestamp":123},"block":"$Labc"}],"syncedPropertyName":"$undefined"}},"default":{"application/json":{"variants":[{"key":"default","label":"Example","rawValue":{"code":"string","message":"string","timestamp":123},"block":"$Labd"}],"syncedPropertyName":"$undefined"}}},"headingAs":"h4"}] 2a:["$","$7a","update-payment-method",{"children":[["$","section",null,{"className":"y9a0do0","data-variant":"endpoint","children":["$","$L7b",null,{"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"title":"Payment method","description":"A saved payment method on a customer profile.\n\nUse the `type` field to determine the specific payment method variant.\n\n:::note\nThis schema represents a stored credential available for future charges and supports three types: `card`, `revolut_pay`, and `sepa_direct_debit`.\n\nIt differs from the `payment_method` object on a Payment, which is a transactional snapshot of how a specific charge was executed and includes additional detail such as wallet wrappers (`apple_pay`, `google_pay`) and Revolut Pay funding source (`revolut_pay_card` vs `revolut_pay_account`).\n:::","discriminator":"$29:props:children:0:props:children:props:responses:200:content:application/json:schema:discriminator","oneOf":[{"title":"Card payment method","type":"object","description":"A saved card payment method.\n\n:::info\nThe `checks` object (3DS, CVV, address verification) is not included as it is specific to the transactional payment context.\n:::","properties":{"id":{"type":"string","format":"uuid","description":"Unique identifier for the payment method.","descriptionNode":"$Labe"},"type":{"type":"string","description":"The type of the payment method.","enum":"$29:props:children:0:props:children:props:responses:200:content:application/json:schema:oneOf:0:properties:type:enum","descriptionNode":"$Labf"},"saved_for":{"type":"string","enum":"$29:props:children:0:props:children:props:responses:200:content:application/json:schema:oneOf:0:properties:saved_for:enum","description":"Indicates in which case this saved payment method can be used for payments.\n\n| Value | Description |\n| ----- | ----------- |\n| `customer` | This payment method can be used only when the customer is on the checkout page. |\n| `merchant` | This payment method can be used without the customer being on the checkout page, and the merchant can initiate transactions, for example, to take payments for recurring transactions. |","descriptionNode":"$Lac0"},"created_at":{"type":"string","format":"date-time","description":"The date and time the payment method was added.","descriptionNode":"$Lac1"},"bin":{"type":"string","description":"The BIN (Bank Identification Number) of the payment card, typically the first 6-8 digits.","descriptionNode":"$Lac2"},"last_four":{"type":"string","minLength":4,"maxLength":4,"description":"The last four digits of the payment card number.","descriptionNode":"$Lac3"},"expiry_month":{"type":"integer","description":"The expiry month of the payment card.","descriptionNode":"$Lac4"},"expiry_year":{"type":"integer","description":"The expiry year of the payment card.","descriptionNode":"$Lac5"},"cardholder_name":{"type":"string","description":"The name of the cardholder as it appears on the card.","descriptionNode":"$Lac6"},"brand":{"type":"string","description":"The brand of the payment card.","enum":"$29:props:children:0:props:children:props:responses:200:content:application/json:schema:oneOf:0:properties:brand:enum","descriptionNode":"$Lac7"},"funding":{"type":"string","description":"The funding type of the payment card.","enum":"$29:props:children:0:props:children:props:responses:200:content:application/json:schema:oneOf:0:properties:funding:enum","descriptionNode":"$Lac8"},"issuer":{"type":"string","description":"The name of the card-issuing bank or institution.","descriptionNode":"$Lac9"},"issuer_country":{"type":"string","minLength":2,"maxLength":2,"description":"The ISO 3166-1 alpha-2 country code of the country where the payment card was issued.","descriptionNode":"$Laca"},"billing_address":{"title":"Billing address","type":"object","description":"The billing address associated with the payment method.","properties":{"street_line_1":{"type":"string","description":"Primary address line.","maxLength":100,"descriptionNode":"$Lacb"},"street_line_2":{"type":"string","description":"Secondary address line, such as floor and apartment number.","maxLength":100,"descriptionNode":"$Lacc"},"region":{"type":"string","description":"State or province of the address.","maxLength":100,"descriptionNode":"$Lacd"},"city":{"type":"string","description":"City of the address.","maxLength":100,"descriptionNode":"$Lace"},"country_code":{"type":"string","pattern":"^[A-Z]{2}$","description":"ISO 2-letter country code.","minLength":2,"maxLength":2,"descriptionNode":"$Lacf"},"postcode":{"type":"string","description":"Postal code of the address.","maxLength":100,"descriptionNode":"$Lad0"}},"required":"$29:props:children:0:props:children:props:responses:200:content:application/json:schema:oneOf:0:properties:billing_address:required","descriptionNode":"$Lad1"},"terminal_hardware_id":{"type":"string","description":"The hardware identifier of the Revolut Terminal device used to process the payment.\n\n:::note\nOnly present for card-present transactions processed via Revolut Terminal.\n:::","descriptionNode":"$Lad2"}},"required":"$29:props:children:0:props:children:props:responses:200:content:application/json:schema:oneOf:0:required","descriptionNode":"$Lad3"},{"title":"Revolut Pay payment method","type":"object","description":"A saved Revolut Pay payment method on a customer profile.\n\nBoth Revolut Pay card-backed and account-to-account (A2A) variants are\nrepresented by this single type at the saved payment method level.\nNo underlying card details are exposed here; use the order-level\n`payments[].payment_method` object (types `revolut_pay_card` /\n`revolut_pay_account`) for per-transaction details.","properties":{"id":{"type":"string","format":"uuid","description":"Unique identifier for the payment method.","descriptionNode":"$Lad4"},"type":{"type":"string","description":"The type of the payment method.","enum":"$29:props:children:0:props:children:props:responses:200:content:application/json:schema:oneOf:0:properties:type:enum","descriptionNode":"$Lad5"},"saved_for":{"type":"string","enum":"$29:props:children:0:props:children:props:responses:200:content:application/json:schema:oneOf:0:properties:saved_for:enum","description":"Indicates in which case this saved payment method can be used for payments.\n\n| Value | Description |\n| ----- | ----------- |\n| `customer` | This payment method can be used only when the customer is on the checkout page. |\n| `merchant` | This payment method can be used without the customer being on the checkout page, and the merchant can initiate transactions, for example, to take payments for recurring transactions. |","descriptionNode":"$Lad6"},"created_at":{"type":"string","format":"date-time","description":"The date and time the payment method was added.","descriptionNode":"$Lad7"}},"required":"$29:props:children:0:props:children:props:responses:200:content:application/json:schema:oneOf:1:required","descriptionNode":"$Lad8"},{"title":"SEPA Direct Debit payment method","type":"object","description":"A saved SEPA Direct Debit payment method on a customer profile.\n\n:::info\nFor more information, see: [SEPA Direct Debit server-to-server integration](https://developer.revolut.com/docs/guides/merchant/accept-payments/payment-methods/sepa-direct-debit/server-to-server)\n:::","properties":{"id":{"type":"string","format":"uuid","description":"Unique identifier for the payment method.","descriptionNode":"$Lad9"},"type":{"type":"string","description":"The type of the payment method.","enum":"$29:props:children:0:props:children:props:responses:200:content:application/json:schema:oneOf:0:properties:type:enum","descriptionNode":"$Lada"},"saved_for":{"type":"string","enum":"$29:props:children:0:props:children:props:responses:200:content:application/json:schema:oneOf:0:properties:saved_for:enum","description":"Indicates in which case this saved payment method can be used for payments.\n\n| Value | Description |\n| ----- | ----------- |\n| `customer` | This payment method can be used only when the customer is on the checkout page. |\n| `merchant` | This payment method can be used without the customer being on the checkout page, and the merchant can initiate transactions, for example, to take payments for recurring transactions. |","descriptionNode":"$Ladb"},"debtor_iban_last_four":{"type":"string","description":"The last four digits of the debtor's IBAN.","minLength":4,"maxLength":4,"descriptionNode":"$Ladc"},"debtor_name":{"type":"string","description":"The full name of the debtor as provided in the mandate.","descriptionNode":"$Ladd"},"mandate_reference":{"type":"string","description":"The unique mandate reference generated by Revolut. Include this in pre-debit notifications sent to your customers.","descriptionNode":"$Lade"},"billing_address":{"title":"Billing address","type":"object","description":"The billing address associated with the payment method.","properties":{"street_line_1":"$2a:props:children:0:props:children:props:responses:200:content:application/json:schema:oneOf:0:properties:billing_address:properties:street_line_1","street_line_2":"$2a:props:children:0:props:children:props:responses:200:content:application/json:schema:oneOf:0:properties:billing_address:properties:street_line_2","region":"$2a:props:children:0:props:children:props:responses:200:content:application/json:schema:oneOf:0:properties:billing_address:properties:region","city":"$2a:props:children:0:props:children:props:responses:200:content:application/json:schema:oneOf:0:properties:billing_address:properties:city","country_code":"$2a:props:children:0:props:children:props:responses:200:content:application/json:schema:oneOf:0:properties:billing_address:properties:country_code","postcode":"$2a:props:children:0:props:children:props:responses:200:content:application/json:schema:oneOf:0:properties:billing_address:properties:postcode"},"required":"$29:props:children:0:props:children:props:responses:200:content:application/json:schema:oneOf:0:properties:billing_address:required","descriptionNode":"$Ladf"},"created_at":{"type":"string","format":"date-time","description":"The date and time the payment method was added.","descriptionNode":"$Lae0"}},"required":"$29:props:children:0:props:children:props:responses:200:content:application/json:schema:oneOf:2:required","descriptionNode":"$Lae1"}],"descriptionNode":"$Lae2"},"examples":{"updated_payment_method":{"retrieved_card":"$29:props:children:0:props:children:props:responses:200:content:application/json:examples:retrieved_payment_method:retrieved_card","retrieved_revolut_pay":"$29:props:children:0:props:children:props:responses:200:content:application/json:examples:retrieved_payment_method:retrieved_revolut_pay","retrieved_sepa_direct_debit":"$29:props:children:0:props:children:props:responses:200:content:application/json:examples:retrieved_payment_method:retrieved_sepa_direct_debit"}}}},"descriptionNode":"$Lae3"},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"code":{"type":"string","description":"An identifier that can be used to determine what went wrong.\n\nError codes are not globally unique, but uniqueness is guaranteed within endpoints.","descriptionNode":"$Lae4"},"message":{"type":"string","description":"Some human readable text describing what went wrong.","descriptionNode":"$Lae5"},"timestamp":{"type":"integer","description":"The [UNIX timestamp](https://www.unixtimestamp.com/) of the date and time the error happened.","descriptionNode":"$Lae6"}}}}},"descriptionNode":"$Lae7"},"404":{"description":"Not Found","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"code":{"type":"string","description":"An identifier that can be used to determine what went wrong.\n\nError codes are not globally unique, but uniqueness is guaranteed within endpoints.","descriptionNode":"$Lae8"},"message":{"type":"string","description":"Some human readable text describing what went wrong.","descriptionNode":"$Lae9"},"timestamp":{"type":"integer","description":"The [UNIX timestamp](https://www.unixtimestamp.com/) of the date and time the error happened.","descriptionNode":"$Laea"}}}}},"descriptionNode":"$Laeb"}},"requestBody":{"content":{"application/json":{"schema":{"title":"Payment method update","type":"object","description":"Fields to update on a saved payment method.","properties":{"saved_for":{"type":"string","enum":["customer"],"description":"Update the value of `saved_for` from `merchant` to `customer`.\n\nOnce updated, this payment method can no longer be used for merchant-initiated transactions (MIT). It can only be used when the customer is present on the checkout page.\n\n| Value | Description |\n| ----- | ----------- |\n| `customer` | Restrict this payment method to customer-initiated transactions only. |","descriptionNode":"$Laec"}},"descriptionNode":"$Laed"},"examples":{"example_payment_method_update":{"summary":"Update a payment method","value":{"saved_for":"customer"}}}}}},"variantLabels":[],"children":["$Laee","$Laef"]}]}],false]}] af0:T67f,
{
  "id": "8d9a7125-805f-40f3-a405-bc89765db996",
  "name": "Grocery website",
  "type": "online",
  "details": {
    "domain": "groceries.example.com"
  }
}
93b:["$","div","200-application/json-example_online_location",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$af0"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"id\": \"8d9a7125-805f-40f3-a405-bc89765db996\",\n \"name\": \"Grocery website\",\n \"type\": \"online\",\n \"details\": {\n \"domain\": \"groceries.example.com\"\n }\n}"}]}]]}] af1:T1b29,
{
  "id": "8d9a7125-805f-40f3-a405-bc89765db996",
  "name": "Example Street Store",
  "type": "physical",
  "details": {
    "address": {
      "street_line_1": "123 Example Street",
      "city": "Example city",
      "postcode": "12345",
      "country_code": "GB"
    },
    "geo_location": {
      "lat": 12.3456,
      "lon": -12.3456
    },
    "opening_hours": {
      "monday": [
        {
          "from": "09:00",
          "to": "15:00"
        },
        {
          "from": "16:00",
          "to": "18:00"
        }
      ],
      "tuesday": [
        {
          "from": "10:00",
          "to": "13:00"
        },
        {
          "from": "16:00",
          "to": "18:00"
        }
      ]
    }
  }
}
93c:["$","div","200-application/json-example_physical_location",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$af1"}}]}]],"$Laf2"]}] 93d:["$","div","401-application/json-default",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"
{\n  \"errorId\": \"string\",\n  \"timestamp\": 123\n}
"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"errorId\": \"string\",\n \"timestamp\": 123\n}"}]}]]}] 93e:["$","div","404-application/json-default",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"
{\n  \"errorId\": \"string\",\n  \"timestamp\": 123\n}
"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"errorId\": \"string\",\n \"timestamp\": 123\n}"}]}]]}] 961:["$","div","CodeBlock-0",{"className":"wzy01m0 _18b50nc0","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"
'Authorization: Bearer <yourSecretApiKey>'
"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"'Authorization: Bearer '\n"}]}]]}] a13:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unique identifier for the payment method."}]]}] a14:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of the payment method."}]]}] a15:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Indicates in which case this saved payment method can be used for payments."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Value","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"customer"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"This payment method can be used only when the customer is on the checkout page.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"merchant"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"This payment method can be used without the customer being on the checkout page, and the merchant can initiate transactions, for example, to take payments for recurring transactions.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] a16:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The date and time the payment method was added."}]]}] a17:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The BIN (Bank Identification Number) of the payment card, typically the first 6-8 digits."}]]}] a18:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The last four digits of the payment card number."}]]}] a19:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The expiry month of the payment card."}]]}] a1a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The expiry year of the payment card."}]]}] a1b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The name of the cardholder as it appears on the card."}]]}] a1c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The brand of the payment card."}]]}] a1d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The funding type of the payment card."}]]}] a1e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The name of the card-issuing bank or institution."}]]}] a1f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The ISO 3166-1 alpha-2 country code of the country where the payment card was issued."}]]}] aee:["$","div",null,{"className":"ezz1n30","children":[["$","div",null,{"data-header":"$undefined","className":"ezz1n31","children":["$","div",null,{"className":"y9a0do1","children":[["$","h2",null,{"id":"update-payment-method","children":[["$Laf3","$undefined"],["$","$L15",null,{"id":"update-payment-method"}]]}],["$","$L16",null,{"url":"/docs/api/merchant/2025-10-16/operations/update-payment-method.md"}]]}]}],"$undefined"]}] afb:T65b,
curl -X PATCH "https://merchant.revolut.com/api/customers/__RP_TOK_0__/payment-methods/__RP_TOK_1__" \
  -H "Content-Type: application/json" \
  -H "Authorization: __RP_TOK_2__" \
  -H "Revolut-Api-Version: __RP_TOK_3__" \
  -d '{
  "saved_for": "customer"
}'
afc:Tea4,
const payload = {
  "saved_for": "customer"
};
fetch("https://merchant.revolut.com/api/customers/__RP_TOK_0__/payment-methods/__RP_TOK_1__", {
  method: "PATCH",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "__RP_TOK_2__",
    "Revolut-Api-Version": "__RP_TOK_3__"
  },
  body: JSON.stringify(payload)
})
  .then(response => response.json())
  .then(data => console.log(data));
afd:T1640,
package main

import (
  "fmt"
  "net/http"
  "bytes"
  "encoding/json"
)

func main() {
  url := "https://merchant.revolut.com/api/customers/__RP_TOK_0__/payment-methods/__RP_TOK_1__"
  jsonData := []byte(`
{
  "saved_for": "customer"
}
  `)
  req, _ := http.NewRequest("PATCH", url, bytes.NewBuffer(jsonData))
  req.Header.Add("Content-Type", "application/json")
  req.Header.Add("Authorization", "__RP_TOK_2__")
  req.Header.Add("Revolut-Api-Version", "__RP_TOK_3__")

  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  fmt.Println(res)
}
afe:Tbd8,
import requests

url = "https://merchant.revolut.com/api/customers/__RP_TOK_0__/payment-methods/__RP_TOK_1__"
headers = {
  "Content-Type": "application/json",
  "Authorization": "__RP_TOK_2__",
  "Revolut-Api-Version": "__RP_TOK_3__"
}
payload = {
  "saved_for": "customer"
}

response = requests.patch(url, headers=headers, json=payload)
print(response.json())
aff:T1ba4,
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;

public class Main {
  public static void main(String[] args) {
    HttpClient client = HttpClient.newHttpClient();
    String body = """
{
  "saved_for": "customer"
}
    """;

    HttpRequest request = HttpRequest.newBuilder()
      .uri(URI.create("https://merchant.revolut.com/api/customers/__RP_TOK_0__/payment-methods/__RP_TOK_1__"))
      .header("Content-Type", "application/json")
      .header("Authorization", "__RP_TOK_2__")
      .header("Revolut-Api-Version", "__RP_TOK_3__")
      .PATCH(HttpRequest.BodyPublishers.ofString(body))
      .build();

    client.sendAsync(request, HttpResponse.BodyHandlers.ofString())
      .thenApply(HttpResponse::body)
      .thenAccept(System.out::println)
      .join();
  }
}
b00:T1d8c,
using System.Net.Http;
using System.Net.Http.Headers;

var client = new HttpClient();
var request = new HttpRequestMessage
{
  Method = HttpMethod.Patch,
  RequestUri = new Uri("https://merchant.revolut.com/api/customers/__RP_TOK_0__/payment-methods/__RP_TOK_1__"),
  Headers =
  {
    { "Authorization", "__RP_TOK_2__" },
    { "Revolut-Api-Version", "__RP_TOK_3__" },
  },
  Content = new StringContent(@"{
  ""saved_for"": ""customer""
}")
  {
    Headers =
    {
      ContentType = new MediaTypeHeaderValue("application/json")
    }
  }
};

using (var response = await client.SendAsync(request))
{
  response.EnsureSuccessStatusCode();
  var body = await response.Content.ReadAsStringAsync();
  Console.WriteLine(body);
}
b01:T663,
curl -X PATCH "https://sandbox-merchant.revolut.com/api/customers/__RP_TOK_0__/payment-methods/__RP_TOK_1__" \
  -H "Content-Type: application/json" \
  -H "Authorization: __RP_TOK_2__" \
  -H "Revolut-Api-Version: __RP_TOK_3__" \
  -d '{
  "saved_for": "customer"
}'
b02:Teac,
const payload = {
  "saved_for": "customer"
};
fetch("https://sandbox-merchant.revolut.com/api/customers/__RP_TOK_0__/payment-methods/__RP_TOK_1__", {
  method: "PATCH",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "__RP_TOK_2__",
    "Revolut-Api-Version": "__RP_TOK_3__"
  },
  body: JSON.stringify(payload)
})
  .then(response => response.json())
  .then(data => console.log(data));
b03:T1648,
package main

import (
  "fmt"
  "net/http"
  "bytes"
  "encoding/json"
)

func main() {
  url := "https://sandbox-merchant.revolut.com/api/customers/__RP_TOK_0__/payment-methods/__RP_TOK_1__"
  jsonData := []byte(`
{
  "saved_for": "customer"
}
  `)
  req, _ := http.NewRequest("PATCH", url, bytes.NewBuffer(jsonData))
  req.Header.Add("Content-Type", "application/json")
  req.Header.Add("Authorization", "__RP_TOK_2__")
  req.Header.Add("Revolut-Api-Version", "__RP_TOK_3__")

  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  fmt.Println(res)
}
b04:Tbe0,
import requests

url = "https://sandbox-merchant.revolut.com/api/customers/__RP_TOK_0__/payment-methods/__RP_TOK_1__"
headers = {
  "Content-Type": "application/json",
  "Authorization": "__RP_TOK_2__",
  "Revolut-Api-Version": "__RP_TOK_3__"
}
payload = {
  "saved_for": "customer"
}

response = requests.patch(url, headers=headers, json=payload)
print(response.json())
b05:T1bac,
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;

public class Main {
  public static void main(String[] args) {
    HttpClient client = HttpClient.newHttpClient();
    String body = """
{
  "saved_for": "customer"
}
    """;

    HttpRequest request = HttpRequest.newBuilder()
      .uri(URI.create("https://sandbox-merchant.revolut.com/api/customers/__RP_TOK_0__/payment-methods/__RP_TOK_1__"))
      .header("Content-Type", "application/json")
      .header("Authorization", "__RP_TOK_2__")
      .header("Revolut-Api-Version", "__RP_TOK_3__")
      .PATCH(HttpRequest.BodyPublishers.ofString(body))
      .build();

    client.sendAsync(request, HttpResponse.BodyHandlers.ofString())
      .thenApply(HttpResponse::body)
      .thenAccept(System.out::println)
      .join();
  }
}
b06:T1d94,
using System.Net.Http;
using System.Net.Http.Headers;

var client = new HttpClient();
var request = new HttpRequestMessage
{
  Method = HttpMethod.Patch,
  RequestUri = new Uri("https://sandbox-merchant.revolut.com/api/customers/__RP_TOK_0__/payment-methods/__RP_TOK_1__"),
  Headers =
  {
    { "Authorization", "__RP_TOK_2__" },
    { "Revolut-Api-Version", "__RP_TOK_3__" },
  },
  Content = new StringContent(@"{
  ""saved_for"": ""customer""
}")
  {
    Headers =
    {
      ContentType = new MediaTypeHeaderValue("application/json")
    }
  }
};

using (var response = await client.SendAsync(request))
{
  response.EnsureSuccessStatusCode();
  var body = await response.Content.ReadAsStringAsync();
  Console.WriteLine(body);
}
aef:["$","div",null,{"className":"ezz1n30","children":[["$","div",null,{"data-header":"$undefined","className":"ezz1n31","children":["$Laf4",["$","$L85",null,{"parameters":[{"name":"Authorization","in":"header","schema":{"type":"string","format":"Bearer ","examples":"$62:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:0:schema:examples"},"required":true,"description":"This parameter accepts the [Merchant API Secret key](https://business.revolut.com/settings/apis?tab=merchant-api) to authorise requests coming from the merchant's backend. \n\nIt ensures that ensures that each request is authenticated and authorised by verifying the secret key. The secret key should be included in all request headers as a `Bearer` token.\n\n:::info\nFor more information, see: [Authentication](https://developer.revolut.com/docs/api/merchant#authentication)\n:::","descriptionNode":"$Laf5"},{"name":"Revolut-Api-Version","in":"header","schema":{"type":"string","format":"date","enum":"$27:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:1:schema:enum","examples":"$27:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:1:schema:examples"},"required":true,"description":"The version of the Merchant API, specified in `YYYY-MM-DD` format.\n\nThis endpoint is available from version `2024-09-01`. If a version earlier than `2024-09-01` is provided, the endpoint returns a `404` response.\n\nIf not specified, you will receive an error.\n\n\n:::info\nFor more information about API versioning, see: [API versions](https://developer.revolut.com/docs/guides/merchant/reference/versioning/api-versions).\n:::","x-config-always-visible-in-example":true,"example":"2025-10-16","descriptionNode":"$Laf6"},{"name":"customer_id","in":"path","schema":{"type":"string","format":"uuid","description":"A UUID string, typically used to identify resources.","descriptionNode":"$Laf7"},"required":true,"description":"The ID of the `Customer` object.","descriptionNode":"$Laf8"},{"name":"payment_method_id","in":"path","schema":{"type":"string","format":"uuid","description":"A UUID string, typically used to identify resources.","descriptionNode":"$Laf9"},"required":true,"description":"The ID of the payment method.","descriptionNode":"$Lafa"}],"requestBody":"$2a:props:children:0:props:children:props:requestBody","heading":"Request","requestBodySchemaTitle":"Request body","headingAs":"h3"}],["$","$L89",null,{"responses":"$2a:props:children:0:props:children:props:responses","headingAs":"h3"}]]}],["$","div",null,{"className":"ezz1n32","children":[[["$","$L8a",null,{"itemsByServer":{"https://merchant.revolut.com":[{"id":"curl","label":"cURL","templateCode":"curl -X PATCH \"https://merchant.revolut.com/api/customers/__RP_TOK_0__/payment-methods/__RP_TOK_1__\" \\\n -H \"Content-Type: application/json\" \\\n -H \"Authorization: __RP_TOK_2__\" \\\n -H \"Revolut-Api-Version: __RP_TOK_3__\" \\\n -d '{\n \"saved_for\": \"customer\"\n}'","templateHtml":"$afb","tokens":[{"marker":"__RP_TOK_0__","paramName":"customer_id","paramIn":"path","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_1__","paramName":"payment_method_id","paramIn":"path","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_2__","paramName":"Authorization","paramIn":"header","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_3__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["shell-double-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:customer_id":"123e4567-e89b-12d3-a456-426614174000","path:payment_method_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"javascript","label":"JavaScript","templateCode":"const payload = {\n \"saved_for\": \"customer\"\n};\nfetch(\"https://merchant.revolut.com/api/customers/__RP_TOK_0__/payment-methods/__RP_TOK_1__\", {\n method: \"PATCH\",\n headers: {\n \"Content-Type\": \"application/json\",\n \"Authorization\": \"__RP_TOK_2__\",\n \"Revolut-Api-Version\": \"__RP_TOK_3__\"\n },\n body: JSON.stringify(payload)\n})\n .then(response => response.json())\n .then(data => console.log(data));","templateHtml":"$afc","tokens":[{"marker":"__RP_TOK_0__","paramName":"customer_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"payment_method_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_3__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:customer_id":"123e4567-e89b-12d3-a456-426614174000","path:payment_method_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"go","label":"Go","templateCode":"package main\n\nimport (\n \"fmt\"\n \"net/http\"\n \"bytes\"\n \"encoding/json\"\n)\n\nfunc main() {\n url := \"https://merchant.revolut.com/api/customers/__RP_TOK_0__/payment-methods/__RP_TOK_1__\"\n jsonData := []byte(`\n{\n \"saved_for\": \"customer\"\n}\n `)\n req, _ := http.NewRequest(\"PATCH\", url, bytes.NewBuffer(jsonData))\n req.Header.Add(\"Content-Type\", \"application/json\")\n req.Header.Add(\"Authorization\", \"__RP_TOK_2__\")\n req.Header.Add(\"Revolut-Api-Version\", \"__RP_TOK_3__\")\n\n res, _ := http.DefaultClient.Do(req)\n defer res.Body.Close()\n fmt.Println(res)\n}","templateHtml":"$afd","tokens":[{"marker":"__RP_TOK_0__","paramName":"customer_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"payment_method_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_3__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:customer_id":"123e4567-e89b-12d3-a456-426614174000","path:payment_method_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"python","label":"Python","templateCode":"import requests\n\nurl = \"https://merchant.revolut.com/api/customers/__RP_TOK_0__/payment-methods/__RP_TOK_1__\"\nheaders = {\n \"Content-Type\": \"application/json\",\n \"Authorization\": \"__RP_TOK_2__\",\n \"Revolut-Api-Version\": \"__RP_TOK_3__\"\n}\npayload = {\n \"saved_for\": \"customer\"\n}\n\nresponse = requests.patch(url, headers=headers, json=payload)\nprint(response.json())","templateHtml":"$afe","tokens":[{"marker":"__RP_TOK_0__","paramName":"customer_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"payment_method_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_3__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:customer_id":"123e4567-e89b-12d3-a456-426614174000","path:payment_method_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"java","label":"Java","templateCode":"import java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\nimport java.net.URI;\n\npublic class Main {\n public static void main(String[] args) {\n HttpClient client = HttpClient.newHttpClient();\n String body = \"\"\"\n{\n \"saved_for\": \"customer\"\n}\n \"\"\";\n\n HttpRequest request = HttpRequest.newBuilder()\n .uri(URI.create(\"https://merchant.revolut.com/api/customers/__RP_TOK_0__/payment-methods/__RP_TOK_1__\"))\n .header(\"Content-Type\", \"application/json\")\n .header(\"Authorization\", \"__RP_TOK_2__\")\n .header(\"Revolut-Api-Version\", \"__RP_TOK_3__\")\n .PATCH(HttpRequest.BodyPublishers.ofString(body))\n .build();\n\n client.sendAsync(request, HttpResponse.BodyHandlers.ofString())\n .thenApply(HttpResponse::body)\n .thenAccept(System.out::println)\n .join();\n }\n}","templateHtml":"$aff","tokens":[{"marker":"__RP_TOK_0__","paramName":"customer_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"payment_method_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_3__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:customer_id":"123e4567-e89b-12d3-a456-426614174000","path:payment_method_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"csharp","label":"C#","templateCode":"using System.Net.Http;\nusing System.Net.Http.Headers;\n\nvar client = new HttpClient();\nvar request = new HttpRequestMessage\n{\n Method = HttpMethod.Patch,\n RequestUri = new Uri(\"https://merchant.revolut.com/api/customers/__RP_TOK_0__/payment-methods/__RP_TOK_1__\"),\n Headers =\n {\n { \"Authorization\", \"__RP_TOK_2__\" },\n { \"Revolut-Api-Version\", \"__RP_TOK_3__\" },\n },\n Content = new StringContent(@\"{\n \"\"saved_for\"\": \"\"customer\"\"\n}\")\n {\n Headers =\n {\n ContentType = new MediaTypeHeaderValue(\"application/json\")\n }\n }\n};\n\nusing (var response = await client.SendAsync(request))\n{\n response.EnsureSuccessStatusCode();\n var body = await response.Content.ReadAsStringAsync();\n Console.WriteLine(body);\n}","templateHtml":"$b00","tokens":[{"marker":"__RP_TOK_0__","paramName":"customer_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"payment_method_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_3__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:customer_id":"123e4567-e89b-12d3-a456-426614174000","path:payment_method_id":"123e4567-e89b-12d3-a456-426614174000"}}],"https://sandbox-merchant.revolut.com":[{"id":"curl","label":"cURL","templateCode":"curl -X PATCH \"https://sandbox-merchant.revolut.com/api/customers/__RP_TOK_0__/payment-methods/__RP_TOK_1__\" \\\n -H \"Content-Type: application/json\" \\\n -H \"Authorization: __RP_TOK_2__\" \\\n -H \"Revolut-Api-Version: __RP_TOK_3__\" \\\n -d '{\n \"saved_for\": \"customer\"\n}'","templateHtml":"$b01","tokens":[{"marker":"__RP_TOK_0__","paramName":"customer_id","paramIn":"path","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_1__","paramName":"payment_method_id","paramIn":"path","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_2__","paramName":"Authorization","paramIn":"header","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_3__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["shell-double-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:customer_id":"123e4567-e89b-12d3-a456-426614174000","path:payment_method_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"javascript","label":"JavaScript","templateCode":"const payload = {\n \"saved_for\": \"customer\"\n};\nfetch(\"https://sandbox-merchant.revolut.com/api/customers/__RP_TOK_0__/payment-methods/__RP_TOK_1__\", {\n method: \"PATCH\",\n headers: {\n \"Content-Type\": \"application/json\",\n \"Authorization\": \"__RP_TOK_2__\",\n \"Revolut-Api-Version\": \"__RP_TOK_3__\"\n },\n body: JSON.stringify(payload)\n})\n .then(response => response.json())\n .then(data => console.log(data));","templateHtml":"$b02","tokens":[{"marker":"__RP_TOK_0__","paramName":"customer_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"payment_method_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_3__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:customer_id":"123e4567-e89b-12d3-a456-426614174000","path:payment_method_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"go","label":"Go","templateCode":"package main\n\nimport (\n \"fmt\"\n \"net/http\"\n \"bytes\"\n \"encoding/json\"\n)\n\nfunc main() {\n url := \"https://sandbox-merchant.revolut.com/api/customers/__RP_TOK_0__/payment-methods/__RP_TOK_1__\"\n jsonData := []byte(`\n{\n \"saved_for\": \"customer\"\n}\n `)\n req, _ := http.NewRequest(\"PATCH\", url, bytes.NewBuffer(jsonData))\n req.Header.Add(\"Content-Type\", \"application/json\")\n req.Header.Add(\"Authorization\", \"__RP_TOK_2__\")\n req.Header.Add(\"Revolut-Api-Version\", \"__RP_TOK_3__\")\n\n res, _ := http.DefaultClient.Do(req)\n defer res.Body.Close()\n fmt.Println(res)\n}","templateHtml":"$b03","tokens":[{"marker":"__RP_TOK_0__","paramName":"customer_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"payment_method_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_3__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:customer_id":"123e4567-e89b-12d3-a456-426614174000","path:payment_method_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"python","label":"Python","templateCode":"import requests\n\nurl = \"https://sandbox-merchant.revolut.com/api/customers/__RP_TOK_0__/payment-methods/__RP_TOK_1__\"\nheaders = {\n \"Content-Type\": \"application/json\",\n \"Authorization\": \"__RP_TOK_2__\",\n \"Revolut-Api-Version\": \"__RP_TOK_3__\"\n}\npayload = {\n \"saved_for\": \"customer\"\n}\n\nresponse = requests.patch(url, headers=headers, json=payload)\nprint(response.json())","templateHtml":"$b04","tokens":[{"marker":"__RP_TOK_0__","paramName":"customer_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"payment_method_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_3__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:customer_id":"123e4567-e89b-12d3-a456-426614174000","path:payment_method_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"java","label":"Java","templateCode":"import java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\nimport java.net.URI;\n\npublic class Main {\n public static void main(String[] args) {\n HttpClient client = HttpClient.newHttpClient();\n String body = \"\"\"\n{\n \"saved_for\": \"customer\"\n}\n \"\"\";\n\n HttpRequest request = HttpRequest.newBuilder()\n .uri(URI.create(\"https://sandbox-merchant.revolut.com/api/customers/__RP_TOK_0__/payment-methods/__RP_TOK_1__\"))\n .header(\"Content-Type\", \"application/json\")\n .header(\"Authorization\", \"__RP_TOK_2__\")\n .header(\"Revolut-Api-Version\", \"__RP_TOK_3__\")\n .PATCH(HttpRequest.BodyPublishers.ofString(body))\n .build();\n\n client.sendAsync(request, HttpResponse.BodyHandlers.ofString())\n .thenApply(HttpResponse::body)\n .thenAccept(System.out::println)\n .join();\n }\n}","templateHtml":"$b05","tokens":[{"marker":"__RP_TOK_0__","paramName":"customer_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"payment_method_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_3__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:customer_id":"123e4567-e89b-12d3-a456-426614174000","path:payment_method_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"csharp","label":"C#","templateCode":"using System.Net.Http;\nusing System.Net.Http.Headers;\n\nvar client = new HttpClient();\nvar request = new HttpRequestMessage\n{\n Method = HttpMethod.Patch,\n RequestUri = new Uri(\"https://sandbox-merchant.revolut.com/api/customers/__RP_TOK_0__/payment-methods/__RP_TOK_1__\"),\n Headers =\n {\n { \"Authorization\", \"__RP_TOK_2__\" },\n { \"Revolut-Api-Version\", \"__RP_TOK_3__\" },\n },\n Content = new StringContent(@\"{\n \"\"saved_for\"\": \"\"customer\"\"\n}\")\n {\n Headers =\n {\n ContentType = new MediaTypeHeaderValue(\"application/json\")\n }\n }\n};\n\nusing (var response = await client.SendAsync(request))\n{\n response.EnsureSuccessStatusCode();\n var body = await response.Content.ReadAsStringAsync();\n Console.WriteLine(body);\n}","templateHtml":"$b06","tokens":[{"marker":"__RP_TOK_0__","paramName":"customer_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"payment_method_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_3__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:customer_id":"123e4567-e89b-12d3-a456-426614174000","path:payment_method_id":"123e4567-e89b-12d3-a456-426614174000"}}]},"method":"patch","servers":"$62:props:children:0:props:children:props:children:1:props:children:1:props:children:0:0:props:servers","path":"/api/customers/{customer_id}/payment-methods/{payment_method_id}","parameters":["$aef:props:children:0:props:children:1:props:parameters:0","$aef:props:children:0:props:children:1:props:parameters:1","$aef:props:children:0:props:children:1:props:parameters:2","$aef:props:children:0:props:children:1:props:parameters:3"]}],"$Lb07"],"$Lb08","$Lb09"]}]]}] af2:["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"id\": \"8d9a7125-805f-40f3-a405-bc89765db996\",\n \"name\": \"Example Street Store\",\n \"type\": \"physical\",\n \"details\": {\n \"address\": {\n \"street_line_1\": \"123 Example Street\",\n \"city\": \"Example city\",\n \"postcode\": \"12345\",\n \"country_code\": \"GB\"\n },\n \"geo_location\": {\n \"lat\": 12.3456,\n \"lon\": -12.3456\n },\n \"opening_hours\": {\n \"monday\": [\n {\n \"from\": \"09:00\",\n \"to\": \"15:00\"\n },\n {\n \"from\": \"16:00\",\n \"to\": \"18:00\"\n }\n ],\n \"tuesday\": [\n {\n \"from\": \"10:00\",\n \"to\": \"13:00\"\n },\n {\n \"from\": \"16:00\",\n \"to\": \"18:00\"\n }\n ]\n }\n }\n}"}]}] b0c:T514,Provides additional granularity about the dispute state. It details the progression of the dispute process, showing the current stage or phase. | Parameter value | Description | | --------------- | ----------- | | `new` | The dispute has been recently created and is in the initial phase, awaiting further processing. | | `lost_expired` | The dispute has been lost due to expiration, likely because the merchant did not respond within the required timeframe. | | `pre_arbitration` | The dispute is in the pre-arbitration phase, where preliminary evidence is being gathered before a formal arbitration process. | | `won_pre_arbitration`| The merchant secured a win during the pre-arbitration phase based on the evidence provided. | | `lost_pre_arbitration` | The dispute was lost during the pre-arbitration phase, indicating that the preliminary review did not favor the merchant. | | `lost_accepted` | The loss has been accepted as final, implying that no further contestation is likely or needed. | | `arbitration` | The dispute has escalated to the arbitration stage, where a neutral third party is reviewing the evidence. | | `won_arbitration` | The merchant won the dispute during the arbitration process. | | `lost_arbitration` | The merchant lost the dispute during the arbitration process. |45:["$","$7a","retrieve-dispute",{"children":[["$","section",null,{"className":"y9a0do0","data-variant":"endpoint","children":["$","$L7b",null,{"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Unique identifier of the dispute.","descriptionNode":"$Lb0a"},"state":{"type":"string","enum":["needs_response","under_review","won","lost"],"description":"Represents the state of the dispute.\n\nIt indicates either the final outcome of the dispute or if further action is required.\n\n| Parameter value | Description |\n| --------------- | ----------- |\n| `needs_response` | Indicates that the dispute requires a response or action from the merchant. |\n| `under_review` | Indicates that the dispute is currently under review, and the outcome is pending. |\n| `won` | Indicates that the dispute has been resolved in favor of the merchant. |\n| `lost` | Indicates that the dispute has been resolved against the merchant. |","descriptionNode":"$Lb0b"},"substate":{"type":"string","enum":["arbitration","lost_accepted","lost_arbitration","lost_expired","lost_pre_arbitration","lost_representment","new","pre_arbitration","representment","won_arbitration","won_pre_arbitration","won_representment","won_reversal"],"description":"$b0c","descriptionNode":"$Lb0d"},"created_at":{"type":"string","format":"date-time","description":"[ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time when the dispute was created.","descriptionNode":"$Lb0e"},"updated_at":{"type":"string","format":"date-time","description":"[ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time when the dispute was last updated.","descriptionNode":"$Lb0f"},"response_due_date":{"type":"string","format":"date-time","description":"[ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time until when the merchant needs to respond to the dispute.\n\nThe response time by default is 15 days after the dispute is created. If no response is provided by this date, the dispute transitions to:\n - `state: lost`\n - `substate: lost_expired` ","descriptionNode":"$Lb10"},"reason_code":{"type":"string","description":"Dispute reason code from the payment scheme, following standard formats defined by individual providers.\n\n:::info\nFor complete, official lists of dispute codes, see: \n- **Visa**: [Visa Core Rules and Visa Product and Service Rules](https://corporate.visa.com/content/dam/VCOM/download/about-visa/visa-rules-public.pdf) \n- **Mastercard**: [Chargeback Guide - Merchant Edition](https://www.mastercard.com/content/dam/public/mastercardcom/na/global-site/documents/chargeback-guide.pdf)\n- **American Express**: [Chargeback Codes](https://www.americanexpress.com/content/dam/amex/au/en/merchant/static/chargebackcodeguide.pdf)\n:::","descriptionNode":"$Lb11"},"reason_description":{"type":"string","description":"Provides a human-readable explanation for the dispute reason codes.","descriptionNode":"$Lb12"},"amount":{"type":"integer","description":"Disputed amount expressed in minor currency units, according to the [ISO 4217 standard](https://en.wikipedia.org/wiki/ISO_4217). For example, `7034` in `EUR` corresponds to €70.34.\n\n:::info\nConversion between major and minor units varies by currency. For instance, `100` minor units equal £1.00 in `GBP`, whereas in `ISK` they represent 100 units. For more details, see the [ISO 4217 standard](https://en.wikipedia.org/wiki/ISO_4217).\n:::","descriptionNode":"$Lb13"},"currency":{"type":"string","format":"ISO 4217","minLength":3,"maxLength":3,"description":"[ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) currency code in upper case.\n\n:::info\nFor more information about the supported currencies, see: [Help Center](https://help.revolut.com/business/help/merchant-accounts/payments/in-which-currencies-can-i-accept-payments/).\n:::","descriptionNode":"$Lb14"},"payment":{"type":"object","description":"Object containing the details of the original payment associated with the dispute.","properties":{"id":{"type":"string","format":"uuid","description":"The ID of the original payment that was disputed.","descriptionNode":"$Lb15"},"order_id":{"type":"string","format":"uuid","description":"The ID of the order linked to the original disputed payment.","descriptionNode":"$Lb16"},"created_at":{"type":"string","format":"date-time","description":"[ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time when the original disputed payment was created.","descriptionNode":"$Lb17"},"arn":{"type":"string","description":"Acquirer Reference Number (ARN) of the original payment.\n\n:::note\nOnly returned for payments made by a card.\n:::","descriptionNode":"$Lb18"},"amount":{"type":"integer","description":"Amount of the original payment expressed in minor currency units, according to the [ISO 4217 standard](https://en.wikipedia.org/wiki/ISO_4217). For example, `7034` in `EUR` corresponds to €70.34.\n\n:::info\nConversion between major and minor units varies by currency. For instance, `100` minor units equal £1.00 in `GBP`, whereas in `ISK` they represent 100 units. For more details, see the [ISO 4217 standard](https://en.wikipedia.org/wiki/ISO_4217).\n:::","descriptionNode":"$Lb19"},"currency":{"type":"string","format":"ISO 4217","minLength":3,"maxLength":3,"description":"[ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) currency code in upper case.\n\n:::info\nFor more information about the supported currencies, see: [Help Center](https://help.revolut.com/business/help/merchant-accounts/payments/in-which-currencies-can-i-accept-payments/).\n:::","descriptionNode":"$Lb1a"},"payment_method":{"type":"object","description":"Payment method used for the original payment.\n\nUse the `type` field to determine the specific payment method variant.","discriminator":{"propertyName":"type","mapping":{"apple_pay":"#/components/schemas/Dispute-Payment-Method-Apple-Pay","apple_tap_to_pay":"#/components/schemas/Dispute-Payment-Method-Apple-Tap-To-Pay","card":"#/components/schemas/Dispute-Payment-Method-Card","google_pay":"#/components/schemas/Dispute-Payment-Method-Google-Pay","revolut_pay_account":"#/components/schemas/Dispute-Payment-Method-Revolut-Pay-Account","revolut_pay_card":"#/components/schemas/Dispute-Payment-Method-Revolut-Pay-Card","sepa_direct_debit":"#/components/schemas/Dispute-Payment-Method-Sepa-Direct-Debit"}},"oneOf":[{"type":"object","description":"Object containing details of a card used via Apple Pay.","properties":{"type":{"type":"string","enum":["apple_pay","apple_tap_to_pay","card","google_pay","revolut_pay_account","revolut_pay_card","sepa_direct_debit"],"description":"Type of the payment method used for the original payment.\n\nAvailable values:\n\n| Payment method `type` | Description |\n| --------------------- | ----------- |\n| `apple_pay` | The customer paid the order using Apple Pay. |\n| `apple_tap_to_pay` | The customer paid the order using Apple Tap to Pay. |\n| `card` | The customer paid the order using their credit or debit card. |\n| `google_pay` | The customer paid the order using Google Pay. |\n| `revolut_pay_card` | The customer paid the order via Revolut Pay using their credit or debit card. |\n| `revolut_pay_account` | The customer paid the order via Revolut Pay using their Revolut account. |\n| `sepa_direct_debit` | The customer paid the order via SEPA Direct Debit. |","descriptionNode":"$Lb1b"},"card_brand":{"type":"string","description":"The brand of the payment card.","enum":"$29:props:children:0:props:children:props:responses:200:content:application/json:schema:oneOf:0:properties:brand:enum","descriptionNode":"$Lb1c"},"card_last_four":{"type":"string","minLength":4,"maxLength":4,"description":"The last four digits of the payment card number.","descriptionNode":"$Lb1d"}},"required":["type"],"descriptionNode":"$Lb1e"},{"type":"object","description":"Object containing details of a payment made via Apple Tap to Pay.","properties":{"type":{"type":"string","enum":"$45:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment:properties:payment_method:oneOf:0:properties:type:enum","description":"Type of the payment method used for the original payment.\n\nAvailable values:\n\n| Payment method `type` | Description |\n| --------------------- | ----------- |\n| `apple_pay` | The customer paid the order using Apple Pay. |\n| `apple_tap_to_pay` | The customer paid the order using Apple Tap to Pay. |\n| `card` | The customer paid the order using their credit or debit card. |\n| `google_pay` | The customer paid the order using Google Pay. |\n| `revolut_pay_card` | The customer paid the order via Revolut Pay using their credit or debit card. |\n| `revolut_pay_account` | The customer paid the order via Revolut Pay using their Revolut account. |\n| `sepa_direct_debit` | The customer paid the order via SEPA Direct Debit. |","descriptionNode":"$Lb1f"}},"required":["type"],"descriptionNode":"$Lb20"},{"type":"object","description":"Object containing details of the card used for the payment.","properties":{"type":{"type":"string","enum":"$45:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment:properties:payment_method:oneOf:0:properties:type:enum","description":"Type of the payment method used for the original payment.\n\nAvailable values:\n\n| Payment method `type` | Description |\n| --------------------- | ----------- |\n| `apple_pay` | The customer paid the order using Apple Pay. |\n| `apple_tap_to_pay` | The customer paid the order using Apple Tap to Pay. |\n| `card` | The customer paid the order using their credit or debit card. |\n| `google_pay` | The customer paid the order using Google Pay. |\n| `revolut_pay_card` | The customer paid the order via Revolut Pay using their credit or debit card. |\n| `revolut_pay_account` | The customer paid the order via Revolut Pay using their Revolut account. |\n| `sepa_direct_debit` | The customer paid the order via SEPA Direct Debit. |","descriptionNode":"$Lb21"},"card_brand":{"type":"string","description":"The brand of the payment card.","enum":"$29:props:children:0:props:children:props:responses:200:content:application/json:schema:oneOf:0:properties:brand:enum","descriptionNode":"$Lb22"},"card_last_four":{"type":"string","minLength":4,"maxLength":4,"description":"The last four digits of the payment card number.","descriptionNode":"$Lb23"}},"required":["type"],"descriptionNode":"$Lb24"},{"type":"object","description":"Object containing details of a card used via Google Pay.","properties":{"type":{"type":"string","enum":"$45:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment:properties:payment_method:oneOf:0:properties:type:enum","description":"Type of the payment method used for the original payment.\n\nAvailable values:\n\n| Payment method `type` | Description |\n| --------------------- | ----------- |\n| `apple_pay` | The customer paid the order using Apple Pay. |\n| `apple_tap_to_pay` | The customer paid the order using Apple Tap to Pay. |\n| `card` | The customer paid the order using their credit or debit card. |\n| `google_pay` | The customer paid the order using Google Pay. |\n| `revolut_pay_card` | The customer paid the order via Revolut Pay using their credit or debit card. |\n| `revolut_pay_account` | The customer paid the order via Revolut Pay using their Revolut account. |\n| `sepa_direct_debit` | The customer paid the order via SEPA Direct Debit. |","descriptionNode":"$Lb25"},"card_brand":{"type":"string","description":"The brand of the payment card.","enum":"$29:props:children:0:props:children:props:responses:200:content:application/json:schema:oneOf:0:properties:brand:enum","descriptionNode":"$Lb26"},"card_last_four":{"type":"string","minLength":4,"maxLength":4,"description":"The last four digits of the payment card number.","descriptionNode":"$Lb27"}},"required":["type"],"descriptionNode":"$Lb28"},{"type":"object","description":"Object containing details of a payment made via Revolut Pay account.","properties":{"type":{"type":"string","enum":"$45:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment:properties:payment_method:oneOf:0:properties:type:enum","description":"Type of the payment method used for the original payment.\n\nAvailable values:\n\n| Payment method `type` | Description |\n| --------------------- | ----------- |\n| `apple_pay` | The customer paid the order using Apple Pay. |\n| `apple_tap_to_pay` | The customer paid the order using Apple Tap to Pay. |\n| `card` | The customer paid the order using their credit or debit card. |\n| `google_pay` | The customer paid the order using Google Pay. |\n| `revolut_pay_card` | The customer paid the order via Revolut Pay using their credit or debit card. |\n| `revolut_pay_account` | The customer paid the order via Revolut Pay using their Revolut account. |\n| `sepa_direct_debit` | The customer paid the order via SEPA Direct Debit. |","descriptionNode":"$Lb29"}},"required":["type"],"descriptionNode":"$Lb2a"},{"type":"object","description":"Object containing details of a card used via Revolut Pay.","properties":{"type":{"type":"string","enum":"$45:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment:properties:payment_method:oneOf:0:properties:type:enum","description":"Type of the payment method used for the original payment.\n\nAvailable values:\n\n| Payment method `type` | Description |\n| --------------------- | ----------- |\n| `apple_pay` | The customer paid the order using Apple Pay. |\n| `apple_tap_to_pay` | The customer paid the order using Apple Tap to Pay. |\n| `card` | The customer paid the order using their credit or debit card. |\n| `google_pay` | The customer paid the order using Google Pay. |\n| `revolut_pay_card` | The customer paid the order via Revolut Pay using their credit or debit card. |\n| `revolut_pay_account` | The customer paid the order via Revolut Pay using their Revolut account. |\n| `sepa_direct_debit` | The customer paid the order via SEPA Direct Debit. |","descriptionNode":"$Lb2b"},"card_brand":{"type":"string","description":"The brand of the payment card.","enum":"$29:props:children:0:props:children:props:responses:200:content:application/json:schema:oneOf:0:properties:brand:enum","descriptionNode":"$Lb2c"},"card_last_four":{"type":"string","minLength":4,"maxLength":4,"description":"The last four digits of the payment card number.","descriptionNode":"$Lb2d"}},"required":["type"],"descriptionNode":"$Lb2e"},{"type":"object","description":"Object containing details of a SEPA Direct Debit payment.","properties":{"type":{"type":"string","enum":"$45:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment:properties:payment_method:oneOf:0:properties:type:enum","description":"Type of the payment method used for the original payment.\n\nAvailable values:\n\n| Payment method `type` | Description |\n| --------------------- | ----------- |\n| `apple_pay` | The customer paid the order using Apple Pay. |\n| `apple_tap_to_pay` | The customer paid the order using Apple Tap to Pay. |\n| `card` | The customer paid the order using their credit or debit card. |\n| `google_pay` | The customer paid the order using Google Pay. |\n| `revolut_pay_card` | The customer paid the order via Revolut Pay using their credit or debit card. |\n| `revolut_pay_account` | The customer paid the order via Revolut Pay using their Revolut account. |\n| `sepa_direct_debit` | The customer paid the order via SEPA Direct Debit. |","descriptionNode":"$Lb2f"},"debtor_iban_last_four":{"type":"string","description":"The last four digits of the debtor's IBAN.","minLength":4,"maxLength":4,"descriptionNode":"$Lb30"},"debtor_name":{"type":"string","description":"The full name of the debtor as provided in the mandate.","descriptionNode":"$Lb31"},"mandate_reference":{"type":"string","description":"The unique mandate reference generated by Revolut. Include this in pre-debit notifications sent to your customers.","descriptionNode":"$Lb32"}},"required":["type"],"descriptionNode":"$Lb33"}],"descriptionNode":"$Lb34"}},"descriptionNode":"$Lb35"}}},"examples":{"card_dispute":{"summary":"Dispute for a card payment","value":{"id":"fccc53e9-00e0-4847-9d54-6938e9cdd3ef","state":"lost","substate":"lost_accepted","created_at":"2025-03-12T07:00:00.000000Z","updated_at":"2025-03-13T10:00:00.000000Z","response_due_date":"2025-03-15T12:00:00.000000Z","reason_code":"50","reason_description":"Fraud","amount":1500,"currency":"EUR","payment":{"id":"67810850-4c48-a25d-8765-d03d36ca6719","order_id":"38bd1186-a276-4b14-91b4-5da886481f85","created_at":"2025-01-02T10:00:00Z","arn":"P58PC241502Q7800000000A","amount":3000,"currency":"EUR","payment_method":{"type":"card","card_brand":"visa","card_last_four":"1234"}}}},"sepa_direct_debit_dispute":{"summary":"Dispute for a SEPA Direct Debit payment","value":{"id":"7a2d8f4b-1c3e-4a56-b789-0d1e2f3a4b5c","state":"needs_response","substate":"new","created_at":"2026-05-22T09:00:00Z","updated_at":"2026-05-22T09:00:00Z","response_due_date":"2026-06-05T09:00:00Z","reason_code":"OTHER","reason_description":"merchant_dispute","amount":10000,"currency":"EUR","payment":{"id":"6a0f2bc4-2137-a1ad-9eb6-b34cf4ca6597","order_id":"2bcaf93a-aa87-4d3d-b5c6-62e06051cff2","created_at":"2026-05-21T15:59:00.451602Z","amount":10000,"currency":"EUR","payment_method":{"type":"sepa_direct_debit","debtor_iban_last_four":"3273","debtor_name":"John Doe","mandate_reference":"69F1CB61BD99A32C8E20D7FB9E21E146"}}}}}}},"descriptionNode":"$Lb36"},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"code":{"type":"string","description":"An identifier that can be used to determine what went wrong.\n\nError codes are not globally unique, but uniqueness is guaranteed within endpoints.","descriptionNode":"$Lb37"},"message":{"type":"string","description":"Some human readable text describing what went wrong.","descriptionNode":"$Lb38"},"timestamp":{"type":"integer","description":"The [UNIX timestamp](https://www.unixtimestamp.com/) of the date and time the error happened.","descriptionNode":"$Lb39"}}},"examples":{"default":{"value":{"code":"bad_request","message":"Missing Revolut-Api-Version header","timestamp":1601296792533}}}}},"descriptionNode":"$Lb3a"},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"code":{"type":"string","description":"An identifier that can be used to determine what went wrong.\n\nError codes are not globally unique, but uniqueness is guaranteed within endpoints.","descriptionNode":"$Lb3b"},"message":{"type":"string","description":"Some human readable text describing what went wrong.","descriptionNode":"$Lb3c"},"timestamp":{"type":"integer","description":"The [UNIX timestamp](https://www.unixtimestamp.com/) of the date and time the error happened.","descriptionNode":"$Lb3d"}}},"examples":{"default":{"value":{"code":"unauthenticated","message":"Authentication failed","timestamp":1721049596461}}}}},"descriptionNode":"$Lb3e"},"404":{"description":"Not Found","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"code":{"type":"string","description":"An identifier that can be used to determine what went wrong.\n\nError codes are not globally unique, but uniqueness is guaranteed within endpoints.","descriptionNode":"$Lb3f"},"message":{"type":"string","description":"Some human readable text describing what went wrong.","descriptionNode":"$Lb40"},"timestamp":{"type":"integer","description":"The [UNIX timestamp](https://www.unixtimestamp.com/) of the date and time the error happened.","descriptionNode":"$Lb41"}}},"examples":{"default":{"value":{"code":"not_found","message":"The requested resource is not found","timestamp":1721050063886}}}}},"descriptionNode":"$Lb42"}},"requestBody":"$undefined","variantLabels":["Dispute for a card payment","Dispute for a SEPA Direct Debit payment"],"children":["$Lb43","$Lb44"]}]}],false]}] a20:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Primary address line."}]]}] a21:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Secondary address line, such as floor and apartment number."}]]}] a22:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"State or province of the address."}]]}] a23:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"City of the address."}]]}] a24:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"ISO 2-letter country code."}]]}] a25:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Postal code of the address."}]]}] a26:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The billing address associated with the payment method."}]]}] a27:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The hardware identifier of the Revolut Terminal device used to process the payment."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":"Only present for card-present transactions processed via Revolut Terminal."}]}]]}]]}] a28:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A saved card payment method."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["The ",["$","code","code-0",{"children":"checks"}]," object (3DS, CVV, address verification) is not included as it is specific to the transactional payment context."]}]}]]}]]}] a29:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unique identifier for the payment method."}]]}] a2a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of the payment method."}]]}] a2b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Indicates in which case this saved payment method can be used for payments."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Value","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"customer"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"This payment method can be used only when the customer is on the checkout page.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"merchant"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"This payment method can be used without the customer being on the checkout page, and the merchant can initiate transactions, for example, to take payments for recurring transactions.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] a2c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The date and time the payment method was added."}]]}] a2d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A saved Revolut Pay payment method on a customer profile."}],"\n",["$","p","p-1",{"children":["Both Revolut Pay card-backed and account-to-account (A2A) variants are\nrepresented by this single type at the saved payment method level.\nNo underlying card details are exposed here; use the order-level\n",["$","code","code-0",{"children":"payments[].payment_method"}]," object (types ",["$","code","code-1",{"children":"revolut_pay_card"}]," /\n",["$","code","code-2",{"children":"revolut_pay_account"}],") for per-transaction details."]}]]}] a2e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unique identifier for the payment method."}]]}] a2f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of the payment method."}]]}] a30:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Indicates in which case this saved payment method can be used for payments."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Value","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"customer"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"This payment method can be used only when the customer is on the checkout page.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"merchant"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"This payment method can be used without the customer being on the checkout page, and the merchant can initiate transactions, for example, to take payments for recurring transactions.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] a31:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The last four digits of the debtor's IBAN."}]]}] a32:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The full name of the debtor as provided in the mandate."}]]}] a33:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The unique mandate reference generated by Revolut. Include this in pre-debit notifications sent to your customers."}]]}] a34:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The billing address associated with the payment method."}]]}] a35:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The date and time the payment method was added."}]]}] a36:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A saved SEPA Direct Debit payment method on a customer profile."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/accept-payments/payment-methods/sepa-direct-debit/server-to-server","target":"_blank","rel":"noreferrer","children":"SEPA Direct Debit server-to-server integration"}]]}]}]]}]]}] a37:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A saved payment method on a customer profile."}],"\n",["$","p","p-1",{"children":["Use the ",["$","code","code-0",{"children":"type"}]," field to determine the specific payment method variant."]}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":["This schema represents a stored credential available for future charges and supports three types: ",["$","code","code-0",{"children":"card"}],", ",["$","code","code-1",{"children":"revolut_pay"}],", and ",["$","code","code-2",{"children":"sepa_direct_debit"}],"."]}],["$","p","p-1",{"children":["It differs from the ",["$","code","code-0",{"children":"payment_method"}]," object on a Payment, which is a transactional snapshot of how a specific charge was executed and includes additional detail such as wallet wrappers (",["$","code","code-1",{"children":"apple_pay"}],", ",["$","code","code-2",{"children":"google_pay"}],") and Revolut Pay funding source (",["$","code","code-3",{"children":"revolut_pay_card"}]," vs ",["$","code","code-4",{"children":"revolut_pay_account"}],")."]}]]}]]}]]}] a38:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["Saved payment methods associated with this customer. Each entry represents a\npayment method authorised for future charges. Two types are supported: ",["$","code","code-0",{"children":"card"}],"\n(with full card details) and ",["$","code","code-1",{"children":"revolut_pay"}]," (covers both card-backed and\naccount-to-account Revolut Pay variants). Use the ",["$","code","code-2",{"children":"type"}]," field on each item\nto identify the variant."]}]]}] a39:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"OK"}]]}] a3a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An identifier that can be used to determine what went wrong."}],"\n",["$","p","p-1",{"children":"Error codes are not globally unique, but uniqueness is guaranteed within endpoints."}]]}] a3b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Some human readable text describing what went wrong."}]]}] a3c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://www.unixtimestamp.com/","target":"_blank","rel":"noreferrer","children":"UNIX timestamp"}]," of the date and time the error happened."]}]]}] a3d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unauthorized"}]]}] a3e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An identifier that can be used to determine what went wrong."}],"\n",["$","p","p-1",{"children":"Error codes are not globally unique, but uniqueness is guaranteed within endpoints."}]]}] a3f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Some human readable text describing what went wrong."}]]}] a40:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://www.unixtimestamp.com/","target":"_blank","rel":"noreferrer","children":"UNIX timestamp"}]," of the date and time the error happened."]}]]}] a41:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Not Found"}]]}] a50:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Retrieve all the saved payment methods for a specific customer.\nThis can be useful in the following example cases:"}],"\n",["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":"To show what payment information is stored for the customer."}],"\n",["$","li","li-1",{"children":"To try a different payment method if the first payment method fails when a recurring transaction occurs."}],"\n"]}]]}] a51:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["This parameter accepts the ",["$","a","a-0",{"href":"https://business.revolut.com/settings/apis?tab=merchant-api","target":"_blank","rel":"noreferrer","children":"Merchant API Secret key"}]," to authorise requests coming from the merchant's backend."]}],"\n",["$","p","p-1",{"children":["It ensures that ensures that each request is authenticated and authorised by verifying the secret key. The secret key should be included in all request headers as a ",["$","code","code-0",{"children":"Bearer"}]," token."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#authentication","target":"_blank","rel":"noreferrer","children":"Authentication"}]]}]}]]}]]}] a52:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The version of the Merchant API, specified in ",["$","code","code-0",{"children":"YYYY-MM-DD"}]," format."]}],"\n",["$","p","p-1",{"children":["This endpoint is available from version ",["$","code","code-0",{"children":"2024-09-01"}],". If a version earlier than ",["$","code","code-1",{"children":"2024-09-01"}]," is provided, the endpoint returns a ",["$","code","code-2",{"children":"404"}]," response."]}],"\n",["$","p","p-2",{"children":"If not specified, you will receive an error."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information about API versioning, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/reference/versioning/api-versions","target":"_blank","rel":"noreferrer","children":"API versions"}],"."]}]}]]}]]}] a53:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A UUID string, typically used to identify resources."}]]}] a54:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ID of the ",["$","code","code-0",{"children":"Customer"}]," object."]}]]}] a55:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["If ",["$","code","code-0",{"children":"true"}],", returns only the saved payment methods that can be used for\nmerchant-initiated transactions (MIT)."]}]]}] aa3:"Retrieve a subscription plan" b07:["$","$L10d",null,{"security":[{"Api-Key":[]}],"authorization":{"Api-Key":{"type":"apiKey","in":"header","name":"Authorization","description":"Each Merchant API request must contain an authorization header in the following format:\n\n```\n'Authorization: Bearer '\n```\n\nTo use this API, you need to generate API keys from your Revolut Business account. The Secret key is used in the authorization header for all server calls, while the Public key is provided with payment methods at checkout.\n\n:::info\nFor detailed instructions on generating your API keys, see: [Generate API keys](https://developer.revolut.com/docs/guides/merchant/get-started#generate-api-keys).\n:::","descriptionNode":"$Lb45"}}}] b08:["$","$L10f",null,{"exampleBlocks":{"application/json":{"variants":[{"key":"example_payment_method_update","label":"Update a payment method","rawValue":"$2a:props:children:0:props:children:props:requestBody:content:application/json:examples:example_payment_method_update:value","block":"$Lb46"}],"syncedPropertyName":"$undefined"}},"title":"Request body samples","headingAs":"h4"}] b09:["$","$L110",null,{"exampleBlocks":{"200":{"application/json":{"variants":[{"key":"default","label":"Example","rawValue":{"id":"123e4567-e89b-12d3-a456-426614174000","type":"card","saved_for":"customer","created_at":"2024-01-01T00:00:00Z","bin":"string","last_four":"aaaa","expiry_month":123,"expiry_year":123,"cardholder_name":"string","brand":"visa","funding":"debit","issuer":"string","issuer_country":"aa","billing_address":{"street_line_1":"string","street_line_2":"string","region":"string","city":"string","country_code":"aa","postcode":"string"},"terminal_hardware_id":"string"},"block":"$Lb47"}],"syncedPropertyName":"$undefined"}},"401":{"application/json":{"variants":[{"key":"default","label":"Example","rawValue":{"code":"string","message":"string","timestamp":123},"block":"$Lb48"}],"syncedPropertyName":"$undefined"}},"404":{"application/json":{"variants":[{"key":"default","label":"Example","rawValue":{"code":"string","message":"string","timestamp":123},"block":"$Lb49"}],"syncedPropertyName":"$undefined"}}},"headingAs":"h4"}] b43:["$","div",null,{"className":"ezz1n30","children":[["$","div",null,{"data-header":"$undefined","className":"ezz1n31","children":["$","div",null,{"className":"y9a0do1","children":[["$","h2",null,{"id":"retrieve-dispute","children":[["$Lb4a","$undefined"],["$","$L15",null,{"id":"retrieve-dispute"}]]}],["$","$L16",null,{"url":"/docs/api/merchant/2025-10-16/operations/retrieve-dispute.md"}]]}]}],"$undefined"]}] b50:T9d2,
fetch("https://merchant.revolut.com/api/disputes/__RP_TOK_0__", {
  method: "GET",
  headers: {
    "Authorization": "__RP_TOK_1__",
    "Revolut-Api-Version": "__RP_TOK_2__"
  }
})
  .then(response => response.json())
  .then(data => console.log(data));
b51:Tf6f,
package main

import (
  "fmt"
  "net/http"
)

func main() {
  url := "https://merchant.revolut.com/api/disputes/__RP_TOK_0__"
  req, _ := http.NewRequest("GET", url, nil)
  req.Header.Add("Authorization", "__RP_TOK_1__")
  req.Header.Add("Revolut-Api-Version", "__RP_TOK_2__")

  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  fmt.Println(res)
}
b52:T7e4,
import requests

url = "https://merchant.revolut.com/api/disputes/__RP_TOK_0__"
headers = {
  "Authorization": "__RP_TOK_1__",
  "Revolut-Api-Version": "__RP_TOK_2__"
}

response = requests.get(url, headers=headers)
print(response.json())
b53:T1710,
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;

public class Main {
  public static void main(String[] args) {
    HttpClient client = HttpClient.newHttpClient();
    HttpRequest request = HttpRequest.newBuilder()
      .uri(URI.create("https://merchant.revolut.com/api/disputes/__RP_TOK_0__"))
      .header("Authorization", "__RP_TOK_1__")
      .header("Revolut-Api-Version", "__RP_TOK_2__")
      .GET(HttpRequest.BodyPublishers.noBody())
      .build();

    client.sendAsync(request, HttpResponse.BodyHandlers.ofString())
      .thenApply(HttpResponse::body)
      .thenAccept(System.out::println)
      .join();
  }
}
b54:T15ba,
using System.Net.Http;
using System.Net.Http.Headers;

var client = new HttpClient();
var request = new HttpRequestMessage
{
  Method = HttpMethod.Get,
  RequestUri = new Uri("https://merchant.revolut.com/api/disputes/__RP_TOK_0__"),
  Headers =
  {
    { "Authorization", "__RP_TOK_1__" },
    { "Revolut-Api-Version", "__RP_TOK_2__" },
  }
};

using (var response = await client.SendAsync(request))
{
  response.EnsureSuccessStatusCode();
  var body = await response.Content.ReadAsStringAsync();
  Console.WriteLine(body);
}
b55:T9da,
fetch("https://sandbox-merchant.revolut.com/api/disputes/__RP_TOK_0__", {
  method: "GET",
  headers: {
    "Authorization": "__RP_TOK_1__",
    "Revolut-Api-Version": "__RP_TOK_2__"
  }
})
  .then(response => response.json())
  .then(data => console.log(data));
b56:Tf77,
package main

import (
  "fmt"
  "net/http"
)

func main() {
  url := "https://sandbox-merchant.revolut.com/api/disputes/__RP_TOK_0__"
  req, _ := http.NewRequest("GET", url, nil)
  req.Header.Add("Authorization", "__RP_TOK_1__")
  req.Header.Add("Revolut-Api-Version", "__RP_TOK_2__")

  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  fmt.Println(res)
}
b57:T7ec,
import requests

url = "https://sandbox-merchant.revolut.com/api/disputes/__RP_TOK_0__"
headers = {
  "Authorization": "__RP_TOK_1__",
  "Revolut-Api-Version": "__RP_TOK_2__"
}

response = requests.get(url, headers=headers)
print(response.json())
b58:T1718,
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;

public class Main {
  public static void main(String[] args) {
    HttpClient client = HttpClient.newHttpClient();
    HttpRequest request = HttpRequest.newBuilder()
      .uri(URI.create("https://sandbox-merchant.revolut.com/api/disputes/__RP_TOK_0__"))
      .header("Authorization", "__RP_TOK_1__")
      .header("Revolut-Api-Version", "__RP_TOK_2__")
      .GET(HttpRequest.BodyPublishers.noBody())
      .build();

    client.sendAsync(request, HttpResponse.BodyHandlers.ofString())
      .thenApply(HttpResponse::body)
      .thenAccept(System.out::println)
      .join();
  }
}
b59:T15c2,
using System.Net.Http;
using System.Net.Http.Headers;

var client = new HttpClient();
var request = new HttpRequestMessage
{
  Method = HttpMethod.Get,
  RequestUri = new Uri("https://sandbox-merchant.revolut.com/api/disputes/__RP_TOK_0__"),
  Headers =
  {
    { "Authorization", "__RP_TOK_1__" },
    { "Revolut-Api-Version", "__RP_TOK_2__" },
  }
};

using (var response = await client.SendAsync(request))
{
  response.EnsureSuccessStatusCode();
  var body = await response.Content.ReadAsStringAsync();
  Console.WriteLine(body);
}
b44:["$","div",null,{"className":"ezz1n30","children":[["$","div",null,{"data-header":"$undefined","className":"ezz1n31","children":["$Lb4b",["$","$L85",null,{"parameters":[{"name":"Authorization","in":"header","schema":{"type":"string","format":"Bearer ","examples":"$62:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:0:schema:examples"},"required":true,"description":"This parameter accepts the [Merchant API Secret key](https://business.revolut.com/settings/apis?tab=merchant-api) to authorise requests coming from the merchant's backend. \n\nIt ensures that ensures that each request is authenticated and authorised by verifying the secret key. The secret key should be included in all request headers as a `Bearer` token.\n\n:::info\nFor more information, see: [Authentication](https://developer.revolut.com/docs/api/merchant#authentication)\n:::","descriptionNode":"$Lb4c"},{"name":"Revolut-Api-Version","in":"header","schema":{"type":"string","format":"date","enum":"$36:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:1:schema:enum","examples":"$36:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:1:schema:examples"},"required":true,"description":"The version of the Merchant API, specified in `YYYY-MM-DD` format.\n\nIf not specified, you will receive an error.\n\n\n:::info\nFor more information about API versioning, see: [API versions](https://developer.revolut.com/docs/guides/merchant/reference/versioning/api-versions).\n:::","x-config-always-visible-in-example":true,"example":"2025-10-16","descriptionNode":"$Lb4d"},{"name":"dispute_id","in":"path","schema":{"type":"string","format":"uuid","description":"A UUID string, typically used to identify resources.","descriptionNode":"$Lb4e"},"required":true,"description":"The ID of the `Dispute` object.","descriptionNode":"$Lb4f"}],"requestBody":"$undefined","heading":"Request","requestBodySchemaTitle":"Request body","headingAs":"h3"}],["$","$L89",null,{"responses":"$45:props:children:0:props:children:props:responses","headingAs":"h3"}]]}],["$","div",null,{"className":"ezz1n32","children":[[["$","$L8a",null,{"itemsByServer":{"https://merchant.revolut.com":[{"id":"curl","label":"cURL","templateCode":"curl -X GET \"https://merchant.revolut.com/api/disputes/__RP_TOK_0__\" \\\n -H \"Authorization: __RP_TOK_1__\" \\\n -H \"Revolut-Api-Version: __RP_TOK_2__\"","templateHtml":"
curl -X GET \"https://merchant.revolut.com/api/disputes/__RP_TOK_0__\" \\\n  -H \"Authorization: __RP_TOK_1__\" \\\n  -H \"Revolut-Api-Version: __RP_TOK_2__\"
","tokens":[{"marker":"__RP_TOK_0__","paramName":"dispute_id","paramIn":"path","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["shell-double-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:dispute_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"javascript","label":"JavaScript","templateCode":"fetch(\"https://merchant.revolut.com/api/disputes/__RP_TOK_0__\", {\n method: \"GET\",\n headers: {\n \"Authorization\": \"__RP_TOK_1__\",\n \"Revolut-Api-Version\": \"__RP_TOK_2__\"\n }\n})\n .then(response => response.json())\n .then(data => console.log(data));","templateHtml":"$b50","tokens":[{"marker":"__RP_TOK_0__","paramName":"dispute_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:dispute_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"go","label":"Go","templateCode":"package main\n\nimport (\n \"fmt\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://merchant.revolut.com/api/disputes/__RP_TOK_0__\"\n req, _ := http.NewRequest(\"GET\", url, nil)\n req.Header.Add(\"Authorization\", \"__RP_TOK_1__\")\n req.Header.Add(\"Revolut-Api-Version\", \"__RP_TOK_2__\")\n\n res, _ := http.DefaultClient.Do(req)\n defer res.Body.Close()\n fmt.Println(res)\n}","templateHtml":"$b51","tokens":[{"marker":"__RP_TOK_0__","paramName":"dispute_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:dispute_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"python","label":"Python","templateCode":"import requests\n\nurl = \"https://merchant.revolut.com/api/disputes/__RP_TOK_0__\"\nheaders = {\n \"Authorization\": \"__RP_TOK_1__\",\n \"Revolut-Api-Version\": \"__RP_TOK_2__\"\n}\n\nresponse = requests.get(url, headers=headers)\nprint(response.json())","templateHtml":"$b52","tokens":[{"marker":"__RP_TOK_0__","paramName":"dispute_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:dispute_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"java","label":"Java","templateCode":"import java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\nimport java.net.URI;\n\npublic class Main {\n public static void main(String[] args) {\n HttpClient client = HttpClient.newHttpClient();\n HttpRequest request = HttpRequest.newBuilder()\n .uri(URI.create(\"https://merchant.revolut.com/api/disputes/__RP_TOK_0__\"))\n .header(\"Authorization\", \"__RP_TOK_1__\")\n .header(\"Revolut-Api-Version\", \"__RP_TOK_2__\")\n .GET(HttpRequest.BodyPublishers.noBody())\n .build();\n\n client.sendAsync(request, HttpResponse.BodyHandlers.ofString())\n .thenApply(HttpResponse::body)\n .thenAccept(System.out::println)\n .join();\n }\n}","templateHtml":"$b53","tokens":[{"marker":"__RP_TOK_0__","paramName":"dispute_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:dispute_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"csharp","label":"C#","templateCode":"using System.Net.Http;\nusing System.Net.Http.Headers;\n\nvar client = new HttpClient();\nvar request = new HttpRequestMessage\n{\n Method = HttpMethod.Get,\n RequestUri = new Uri(\"https://merchant.revolut.com/api/disputes/__RP_TOK_0__\"),\n Headers =\n {\n { \"Authorization\", \"__RP_TOK_1__\" },\n { \"Revolut-Api-Version\", \"__RP_TOK_2__\" },\n }\n};\n\nusing (var response = await client.SendAsync(request))\n{\n response.EnsureSuccessStatusCode();\n var body = await response.Content.ReadAsStringAsync();\n Console.WriteLine(body);\n}","templateHtml":"$b54","tokens":[{"marker":"__RP_TOK_0__","paramName":"dispute_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:dispute_id":"123e4567-e89b-12d3-a456-426614174000"}}],"https://sandbox-merchant.revolut.com":[{"id":"curl","label":"cURL","templateCode":"curl -X GET \"https://sandbox-merchant.revolut.com/api/disputes/__RP_TOK_0__\" \\\n -H \"Authorization: __RP_TOK_1__\" \\\n -H \"Revolut-Api-Version: __RP_TOK_2__\"","templateHtml":"
curl -X GET \"https://sandbox-merchant.revolut.com/api/disputes/__RP_TOK_0__\" \\\n  -H \"Authorization: __RP_TOK_1__\" \\\n  -H \"Revolut-Api-Version: __RP_TOK_2__\"
","tokens":[{"marker":"__RP_TOK_0__","paramName":"dispute_id","paramIn":"path","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["shell-double-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:dispute_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"javascript","label":"JavaScript","templateCode":"fetch(\"https://sandbox-merchant.revolut.com/api/disputes/__RP_TOK_0__\", {\n method: \"GET\",\n headers: {\n \"Authorization\": \"__RP_TOK_1__\",\n \"Revolut-Api-Version\": \"__RP_TOK_2__\"\n }\n})\n .then(response => response.json())\n .then(data => console.log(data));","templateHtml":"$b55","tokens":[{"marker":"__RP_TOK_0__","paramName":"dispute_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:dispute_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"go","label":"Go","templateCode":"package main\n\nimport (\n \"fmt\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://sandbox-merchant.revolut.com/api/disputes/__RP_TOK_0__\"\n req, _ := http.NewRequest(\"GET\", url, nil)\n req.Header.Add(\"Authorization\", \"__RP_TOK_1__\")\n req.Header.Add(\"Revolut-Api-Version\", \"__RP_TOK_2__\")\n\n res, _ := http.DefaultClient.Do(req)\n defer res.Body.Close()\n fmt.Println(res)\n}","templateHtml":"$b56","tokens":[{"marker":"__RP_TOK_0__","paramName":"dispute_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:dispute_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"python","label":"Python","templateCode":"import requests\n\nurl = \"https://sandbox-merchant.revolut.com/api/disputes/__RP_TOK_0__\"\nheaders = {\n \"Authorization\": \"__RP_TOK_1__\",\n \"Revolut-Api-Version\": \"__RP_TOK_2__\"\n}\n\nresponse = requests.get(url, headers=headers)\nprint(response.json())","templateHtml":"$b57","tokens":[{"marker":"__RP_TOK_0__","paramName":"dispute_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:dispute_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"java","label":"Java","templateCode":"import java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\nimport java.net.URI;\n\npublic class Main {\n public static void main(String[] args) {\n HttpClient client = HttpClient.newHttpClient();\n HttpRequest request = HttpRequest.newBuilder()\n .uri(URI.create(\"https://sandbox-merchant.revolut.com/api/disputes/__RP_TOK_0__\"))\n .header(\"Authorization\", \"__RP_TOK_1__\")\n .header(\"Revolut-Api-Version\", \"__RP_TOK_2__\")\n .GET(HttpRequest.BodyPublishers.noBody())\n .build();\n\n client.sendAsync(request, HttpResponse.BodyHandlers.ofString())\n .thenApply(HttpResponse::body)\n .thenAccept(System.out::println)\n .join();\n }\n}","templateHtml":"$b58","tokens":[{"marker":"__RP_TOK_0__","paramName":"dispute_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:dispute_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"csharp","label":"C#","templateCode":"using System.Net.Http;\nusing System.Net.Http.Headers;\n\nvar client = new HttpClient();\nvar request = new HttpRequestMessage\n{\n Method = HttpMethod.Get,\n RequestUri = new Uri(\"https://sandbox-merchant.revolut.com/api/disputes/__RP_TOK_0__\"),\n Headers =\n {\n { \"Authorization\", \"__RP_TOK_1__\" },\n { \"Revolut-Api-Version\", \"__RP_TOK_2__\" },\n }\n};\n\nusing (var response = await client.SendAsync(request))\n{\n response.EnsureSuccessStatusCode();\n var body = await response.Content.ReadAsStringAsync();\n Console.WriteLine(body);\n}","templateHtml":"$b59","tokens":[{"marker":"__RP_TOK_0__","paramName":"dispute_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:dispute_id":"123e4567-e89b-12d3-a456-426614174000"}}]},"method":"get","servers":"$62:props:children:0:props:children:props:children:1:props:children:1:props:children:0:0:props:servers","path":"/api/disputes/{dispute_id}","parameters":["$b44:props:children:0:props:children:1:props:parameters:0","$b44:props:children:0:props:children:1:props:parameters:1","$b44:props:children:0:props:children:1:props:parameters:2"]}],"$Lb5a"],"$Lb5b","$Lb5c"]}]]}] b5d:T27d5,
[
  {
    "id": "8d9a7125-805f-40f3-a405-bc89765db996",
    "name": "Grocery website",
    "type": "online",
    "details": {
      "domain": "groceries.example.com"
    }
  },
  {
    "id": "066223df-d5a8-42f0-b3ce-688c7a76f9a8",
    "name": "Cars website",
    "type": "online",
    "details": {
      "domain": "cars.example.com"
    }
  },
  {
    "id": "299050a4-cc7a-44b0-8b2b-7cd1e335ef38",
    "name": "Example Street Store",
    "type": "physical",
    "details": {
      "address": {
        "street_line_1": "123 Example Street",
        "city": "Example city",
        "postcode": "12345",
        "country_code": "GB"
      },
      "geo_location": {
        "lat": 12.3456,
        "lon": -12.3456
      },
      "opening_hours": {
        "monday": [
          {
            "from": "09:00",
            "to": "15:00"
          },
          {
            "from": "16:00",
            "to": "18:00"
          }
        ],
        "tuesday": [
          {
            "from": "10:00",
            "to": "13:00"
          },
          {
            "from": "16:00",
            "to": "18:00"
          }
        ]
      }
    }
  }
]
974:["$","div","200-application/json-list_of_locations",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$b5d"}}]}]],"$Lb5e"]}] a63:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Each Merchant API request must contain an authorization header in the following format:"}],"\n","$Lb5f","\n",["$","p","p-1",{"children":"To use this API, you need to generate API keys from your Revolut Business account. The Secret key is used in the authorization header for all server calls, while the Public key is provided with payment methods at checkout."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For detailed instructions on generating your API keys, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/get-started#generate-api-keys","target":"_blank","rel":"noreferrer","children":"Generate API keys"}],"."]}]}]]}]]}] a67:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unique identifier for the subscription plan."}]]}] a68:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The name of the subscription plan."}]]}] a69:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The default trial period duration for this subscription plan in ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_8601#Durations","target":"_blank","rel":"noreferrer","children":"ISO 8601 duration format"}]," (e.g., \"P14D\" for 14 days)."]}],"\n",["$","p","p-1",{"children":"This value serves as the default trial duration for all subscriptions created from this plan. Individual subscriptions can override this value at creation time."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["Only days (",["$","code","code-0",{"children":"D"}],") are allowed. Time components such as hours, minutes, or seconds are not permitted."]}]}]]}]]}] a6a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The state of the subscription plan."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"State","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"active"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The plan is active and can be used to create new subscriptions.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"deactivated"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The plan has been deactivated and cannot be used for new subscriptions.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] a6b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The date and time the subscription plan was created in ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_8601","target":"_blank","rel":"noreferrer","children":"ISO 8601"}]," format."]}]]}] a6c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The date and time the subscription plan was last updated in ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_8601","target":"_blank","rel":"noreferrer","children":"ISO 8601"}]," format."]}]]}] a6d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unique identifier for the subscription plan variation."}]]}] a6e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unique identifier for the subscription plan phase."}]]}] a6f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The sequential order of this phase in the subscription billing lifecycle."}],"\n",["$","p","p-1",{"children":"Phases execute in ascending order based on this value:"}],"\n",["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["Phase with ",["$","code","code-0",{"children":"ordinal=1"}]," executes first"]}],"\n",["$","li","li-1",{"children":["Phase with ",["$","code","code-0",{"children":"ordinal=2"}]," executes second, and so on"]}],"\n"]}],"\n",["$","p","p-2",{"children":["When a phase completes its ",["$","code","code-0",{"children":"cycle_count"}],", the subscription automatically progresses to the phase with the next ",["$","code","code-1",{"children":"ordinal"}]," value."]}],"\n",["$","p","p-3",{"children":[["$","strong","strong-0",{"children":"Example"}],": A subscription with phases ordered as ",["$","code","code-0",{"children":"ordinal=1"}]," (trial), ",["$","code","code-1",{"children":"ordinal=2"}]," (regular), ",["$","code","code-2",{"children":"ordinal=3"}]," (discounted) will progress through them in that sequence."]}]]}] b5a:["$","$L10d",null,{"security":[{"Api-Key":[]}],"authorization":{"Api-Key":{"type":"apiKey","in":"header","name":"Authorization","description":"Each Merchant API request must contain an authorization header in the following format:\n\n```\n'Authorization: Bearer '\n```\n\nTo use this API, you need to generate API keys from your Revolut Business account. The Secret key is used in the authorization header for all server calls, while the Public key is provided with payment methods at checkout.\n\n:::info\nFor detailed instructions on generating your API keys, see: [Generate API keys](https://developer.revolut.com/docs/guides/merchant/get-started#generate-api-keys).\n:::","descriptionNode":"$Lb60"}}}] b5b:["$","$L10f",null,{"exampleBlocks":{},"title":"Request body samples","headingAs":"h4"}] b5c:["$","$L110",null,{"exampleBlocks":{"200":{"application/json":{"variants":[{"key":"card_dispute","label":"Dispute for a card payment","rawValue":"$45:props:children:0:props:children:props:responses:200:content:application/json:examples:card_dispute:value","block":"$Lb61"},{"key":"sepa_direct_debit_dispute","label":"Dispute for a SEPA Direct Debit payment","rawValue":"$45:props:children:0:props:children:props:responses:200:content:application/json:examples:sepa_direct_debit_dispute:value","block":"$Lb62"}],"syncedPropertyName":"$undefined"}},"400":{"application/json":{"variants":[{"key":"default","label":"default","rawValue":"$45:props:children:0:props:children:props:responses:400:content:application/json:examples:default:value","block":"$Lb63"}],"syncedPropertyName":"$undefined"}},"401":{"application/json":{"variants":[{"key":"default","label":"default","rawValue":"$45:props:children:0:props:children:props:responses:401:content:application/json:examples:default:value","block":"$Lb64"}],"syncedPropertyName":"$undefined"}},"404":{"application/json":{"variants":[{"key":"default","label":"default","rawValue":"$45:props:children:0:props:children:props:responses:404:content:application/json:examples:default:value","block":"$Lb65"}],"syncedPropertyName":"$undefined"}}},"headingAs":"h4"}] b66:T479,[ { "id": "8d9a7125-805f-40f3-a405-bc89765db996", "name": "Grocery website", "type": "online", "details": { "domain": "groceries.example.com" } }, { "id": "066223df-d5a8-42f0-b3ce-688c7a76f9a8", "name": "Cars website", "type": "online", "details": { "domain": "cars.example.com" } }, { "id": "299050a4-cc7a-44b0-8b2b-7cd1e335ef38", "name": "Example Street Store", "type": "physical", "details": { "address": { "street_line_1": "123 Example Street", "city": "Example city", "postcode": "12345", "country_code": "GB" }, "geo_location": { "lat": 12.3456, "lon": -12.3456 }, "opening_hours": { "monday": [ { "from": "09:00", "to": "15:00" }, { "from": "16:00", "to": "18:00" } ], "tuesday": [ { "from": "10:00", "to": "13:00" }, { "from": "16:00", "to": "18:00" } ] } } } ]b5e:["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"$b66"}]}] a70:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The length of each billing cycle for this phase in ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_8601#Durations","target":"_blank","rel":"noreferrer","children":"ISO 8601 duration format"}],"."]}],"\n",["$","p","p-1",{"children":["This determines how often the customer is billed during this phase. The total time spent in a phase is ",["$","code","code-0",{"children":"cycle_duration × cycle_count"}],"."]}],"\n",["$","p","p-2",{"children":[["$","strong","strong-0",{"children":"Common durations"}],":"]}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Duration","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"P1M"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"1 month","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"P1Y"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"1 year","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"P15D"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"15 days","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"P1W"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"1 week","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-4",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"PT2H"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"2 hours","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}],"\n",["$","p","p-3",{"children":[["$","strong","strong-0",{"children":"Example"}],": If ",["$","code","code-0",{"children":"cycle_duration=P1M"}]," and ",["$","code","code-1",{"children":"cycle_count=12"}],", the customer will be billed monthly for 12 months (1 year total)."]}]]}] a71:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Number of billing cycles for this phase before moving to the next phase."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Value","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Behavior","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":[["$","code","code-0",{"children":"null"}]," or omitted"],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Phase continues indefinitely. The subscription remains in this phase with no automatic progression.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["Specific number (e.g., ",["$","code","code-0",{"children":"1"}],", ",["$","code","code-1",{"children":"3"}],", ",["$","code","code-2",{"children":"12"}],")"],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["After completing this many billing cycles, the subscription automatically moves to the next phase as determined by the ",["$","code","code-0",{"children":"ordinal"}]," field."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}],"\n",["$","p","p-1",{"children":[["$","strong","strong-0",{"children":"Example"}],": If ",["$","code","code-0",{"children":"cycle_count=3"}]," and ",["$","code","code-1",{"children":"cycle_duration=P1M"}],", the subscription will complete 3 monthly cycles then move to the phase with the next highest ",["$","code","code-2",{"children":"ordinal"}]," value."]}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["If no next phase exists in after a cycle with a specific ",["$","code","code-0",{"children":"cycle_count"}],", the subscription will automatically stop when it completes its cycles."]}]}]]}]]}] a72:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Subscription amount in minor currency units (e.g., cents for USD, pence for GBP)."}],"\n",["$","p","p-1",{"children":["For example, ",["$","code","code-0",{"children":"9900"}]," in ",["$","code","code-1",{"children":"GBP"}]," represents £99.00."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["Conversion between major and minor units varies by currency. For instance, ",["$","code","code-0",{"children":"100"}]," minor units equal £1.00 in ",["$","code","code-1",{"children":"GBP"}],", whereas in ",["$","code","code-2",{"children":"ISK"}]," they represent 100 units. For more details, see the ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_4217","target":"_blank","rel":"noreferrer","children":"ISO 4217 standard"}],"."]}]}]]}]]}] a73:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":[["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_4217","target":"_blank","rel":"noreferrer","children":"ISO 4217"}]," currency code in upper case."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information about the supported currencies, see: ",["$","a","a-0",{"href":"https://help.revolut.com/business/help/merchant-accounts/payments/in-which-currencies-can-i-accept-payments/","target":"_blank","rel":"noreferrer","children":"Help Center"}],"."]}]}]]}]]}] a74:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The unique identifier of the subscription item."}]]}] a75:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The name of the subscription item."}]]}] a76:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of subscription item."}]]}] a77:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The number of units grouped together as a single billable package. Used to enable pricing of items that are too inexpensive to charge individually."}],"\n",["$","p","p-1",{"children":["For example, a ",["$","code","code-0",{"children":"package_size"}]," of ",["$","code","code-1",{"children":"1000"}]," with a unit price of 10 minor units (£0.10 in GBP) lets you sell 1000 tokens for £0.10 — effectively pricing each token at £0.0001, below the minimum chargeable amount."]}],"\n",["$","p","p-2",{"children":["Set to ",["$","code","code-0",{"children":"1"}]," to price each unit individually."]}]]}] a78:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The unit of measurement for the item."}]]}] a79:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The quantity of the item."}]]}] a7a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Amount in minor currency units (e.g., cents for USD)."}]]}] a7b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":[["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_4217","target":"_blank","rel":"noreferrer","children":"ISO 4217"}]," currency code in upper case."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information about the supported currencies, see: ",["$","a","a-0",{"href":"https://help.revolut.com/business/help/merchant-accounts/payments/in-which-currencies-can-i-accept-payments/","target":"_blank","rel":"noreferrer","children":"Help Center"}],"."]}]}]]}]]}] a7c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object structure of flat subscription item."}]]}] a7d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The unique identifier of the subscription item."}]]}] a7e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The name of the subscription item."}]]}] a7f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of subscription item."}]]}] a80:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The number of units grouped together as a single billable package. Used to enable pricing of items that are too inexpensive to charge individually."}],"\n",["$","p","p-1",{"children":["For example, a ",["$","code","code-0",{"children":"package_size"}]," of ",["$","code","code-1",{"children":"1000"}]," with a unit price of 10 minor units (£0.10 in GBP) lets you sell 1000 tokens for £0.10 — effectively pricing each token at £0.0001, below the minimum chargeable amount."]}],"\n",["$","p","p-2",{"children":["Set to ",["$","code","code-0",{"children":"1"}]," to price each unit individually."]}]]}] a81:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The unit of measurement for the item."}]]}] a82:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["Flat amount per unit in minor currency units. Mutually exclusive with ",["$","code","code-0",{"children":"tiers"}],"."]}]]}] a83:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":[["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_4217","target":"_blank","rel":"noreferrer","children":"ISO 4217"}]," currency code in upper case."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information about the supported currencies, see: ",["$","a","a-0",{"href":"https://help.revolut.com/business/help/merchant-accounts/payments/in-which-currencies-can-i-accept-payments/","target":"_blank","rel":"noreferrer","children":"Help Center"}],"."]}]}]]}]]}] a84:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The upper bound of the tier (exclusive). Null means unlimited."}]]}] a85:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Per-unit amount in minor currency units (e.g., cents for USD) charged for usage within this tier's threshold range."}]]}] a86:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["Graduated pricing tiers. Mutually exclusive with ",["$","code","code-0",{"children":"amount"}],"."]}]]}] a87:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["A merchant-defined identifier for a usage-based subscription item. You set this code on each usage item when creating a subscription plan, and supply it when reporting consumption on ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#create-subscription-usage","target":"_blank","rel":"noreferrer","children":"Create a subscription usage endpoint"}]," to target the correct metered item."]}],"\n",["$","p","p-1",{"children":["This allows a subscription with multiple usage items (e.g., ",["$","code","code-0",{"children":"api_calls"}]," and ",["$","code","code-1",{"children":"storage_gb"}],") to receive consumption reports against the right item without relying on internal IDs."]}],"\n",["$","p","p-2",{"children":"The code must be unique within a plan phase."}]]}] a88:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The method used to aggregate usage events over a billing cycle to calculate the chargeable amount."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Value","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Behaviour","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"sum"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Totals all reported usage events during the cycle. Use for cumulative metrics (e.g., API calls, data transferred).","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"latest"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["Uses the most recently reported value at the end of the cycle. If no usage is reported in a cycle, ",["$","code","code-0",{"children":"0"}]," is used — values do not carry over from previous cycles. Use for gauge-style metrics (e.g., active seats)."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"max"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Uses the peak value reported during the cycle. Use for capacity-based billing (e.g., max concurrent connections).","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] a89:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object structure of usage subscription item."}]]}] a8a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A subscription item that defines a billing line within a plan phase. Can be either a fixed-fee (flat) item or a metered (usage) item."}]]}] a8b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A list of subscription items for this phase."}]]}] a8c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"List of billing phases for this variation."}]]}] a8d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"List of subscription plan variations."}]]}] a8e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Subscription plan retrieved successfully"}]]}] a8f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An identifier that can be used to determine what went wrong."}],"\n",["$","p","p-1",{"children":"Error codes are not globally unique, but uniqueness is guaranteed within endpoints."}]]}] a90:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Some human readable text describing what went wrong."}]]}] a91:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://www.unixtimestamp.com/","target":"_blank","rel":"noreferrer","children":"UNIX timestamp"}]," of the date and time the error happened."]}]]}] a92:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Bad Request"}]]}] a93:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An identifier that can be used to determine what went wrong."}],"\n",["$","p","p-1",{"children":"Error codes are not globally unique, but uniqueness is guaranteed within endpoints."}]]}] a94:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Some human readable text describing what went wrong."}]]}] a95:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://www.unixtimestamp.com/","target":"_blank","rel":"noreferrer","children":"UNIX timestamp"}]," of the date and time the error happened."]}]]}] a96:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unauthorized"}]]}] a97:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An identifier that can be used to determine what went wrong."}],"\n",["$","p","p-1",{"children":"Error codes are not globally unique, but uniqueness is guaranteed within endpoints."}]]}] a98:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Some human readable text describing what went wrong."}]]}] a99:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://www.unixtimestamp.com/","target":"_blank","rel":"noreferrer","children":"UNIX timestamp"}]," of the date and time the error happened."]}]]}] a9a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Subscription plan not found"}]]}] a9b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An identifier that can be used to determine what went wrong."}],"\n",["$","p","p-1",{"children":"Error codes are not globally unique, but uniqueness is guaranteed within endpoints."}]]}] a9c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Some human readable text describing what went wrong."}]]}] a9d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://www.unixtimestamp.com/","target":"_blank","rel":"noreferrer","children":"UNIX timestamp"}]," of the date and time the error happened."]}]]}] a9e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Error response"}]]}] aa4:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Retrieve a specific subscription plan by its unique identifier."}],"\n",["$","p","p-1",{"children":["A subscription plan contains ",["$","strong","strong-0",{"children":"variations"}]," (different pricing options like monthly vs. yearly), and each variation contains ",["$","strong","strong-1",{"children":"phases"}]," (sequential billing stages)."]}],"\n",["$","p","p-2",{"children":["Phases execute based on their ",["$","code","code-0",{"children":"ordinal"}]," value. When a phase completes its ",["$","code","code-1",{"children":"cycle_count"}],", the subscription moves to the next phase. If ",["$","code","code-2",{"children":"cycle_count"}]," is ",["$","code","code-3",{"children":"null"}]," or omitted, the phase continues indefinitely."]}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["If a ",["$","code","code-0",{"children":"trial_duration"}]," is defined, phases begin immediately after the trial ends."]}]}]]}]]}] aa5:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["This parameter accepts the ",["$","a","a-0",{"href":"https://business.revolut.com/settings/apis?tab=merchant-api","target":"_blank","rel":"noreferrer","children":"Merchant API Secret key"}]," to authorise requests coming from the merchant's backend."]}],"\n",["$","p","p-1",{"children":["It ensures that ensures that each request is authenticated and authorised by verifying the secret key. The secret key should be included in all request headers as a ",["$","code","code-0",{"children":"Bearer"}]," token."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#authentication","target":"_blank","rel":"noreferrer","children":"Authentication"}]]}]}]]}]]}] aa6:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The version of the Merchant API, specified in ",["$","code","code-0",{"children":"YYYY-MM-DD"}]," format."]}],"\n",["$","p","p-1",{"children":"If not specified, you will receive an error."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information about API versioning, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/reference/versioning/api-versions","target":"_blank","rel":"noreferrer","children":"API versions"}],"."]}]}]]}]]}] aa7:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A UUID string, typically used to identify resources."}]]}] aa8:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The ID of the subscription plan."}]]}] af3:"Update a customer's payment method" 30:["$","$7a","retrieve-subscription-plan-list",{"children":[["$","section",null,{"className":"y9a0do0","data-variant":"endpoint","children":["$","$L7b",null,{"responses":{"200":{"description":"List of subscription plans retrieved successfully","content":{"application/json":{"schema":{"type":"object","required":["subscription_plans"],"properties":{"next_page_token":{"type":["string","null"],"description":"Token for retrieving the next page of results.\n\nIf not present, there are no more results to retrieve.","descriptionNode":"$Lb67"},"subscription_plans":{"type":"array","description":"List of subscription plans.","items":{"type":"object","required":"$31:props:children:0:props:children:props:responses:200:content:application/json:schema:required","properties":{"id":{"type":"string","format":"uuid","description":"Unique identifier for the subscription plan.","descriptionNode":"$Lb68"},"name":{"type":"string","minLength":1,"maxLength":1024,"description":"The name of the subscription plan.","descriptionNode":"$Lb69"},"trial_duration":{"type":"string","format":"duration","description":"The default trial period duration for this subscription plan in [ISO 8601 duration format](https://en.wikipedia.org/wiki/ISO_8601#Durations) (e.g., \"P14D\" for 14 days).\n\nThis value serves as the default trial duration for all subscriptions created from this plan. Individual subscriptions can override this value at creation time.\n\n:::note\nOnly days (`D`) are allowed. Time components such as hours, minutes, or seconds are not permitted.\n:::","pattern":"^P[0-9]+D$","examples":"$31:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:trial_duration:examples","descriptionNode":"$Lb6a"},"state":{"type":"string","enum":"$31:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:state:enum","description":"The state of the subscription plan.\n\n| State | Description |\n| ----- | ----------- |\n| `active` | The plan is active and can be used to create new subscriptions. |\n| `deactivated` | The plan has been deactivated and cannot be used for new subscriptions. |","descriptionNode":"$Lb6b"},"created_at":{"type":"string","format":"date-time","description":"The date and time the subscription plan was created in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format.","descriptionNode":"$Lb6c"},"updated_at":{"type":"string","format":"date-time","description":"The date and time the subscription plan was last updated in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format.","descriptionNode":"$Lb6d"},"variations":{"type":"array","description":"List of subscription plan variations.","items":{"type":"object","required":"$31:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:variations:items:required","properties":{"id":{"type":"string","format":"uuid","description":"Unique identifier for the subscription plan variation.","descriptionNode":"$Lb6e"},"phases":{"type":"array","description":"List of billing phases for this variation.","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Unique identifier for the subscription plan phase.","descriptionNode":"$Lb6f"},"ordinal":{"type":"integer","minimum":1,"description":"The sequential order of this phase in the subscription billing lifecycle.\n\nPhases execute in ascending order based on this value:\n- Phase with `ordinal=1` executes first\n- Phase with `ordinal=2` executes second, and so on\n\nWhen a phase completes its `cycle_count`, the subscription automatically progresses to the phase with the next `ordinal` value.\n\n**Example**: A subscription with phases ordered as `ordinal=1` (trial), `ordinal=2` (regular), `ordinal=3` (discounted) will progress through them in that sequence.","title":"Subscription-Plan-Ordinal","descriptionNode":"$Lb70"},"cycle_duration":{"type":"string","format":"duration","description":"The length of each billing cycle for this phase in [ISO 8601 duration format](https://en.wikipedia.org/wiki/ISO_8601#Durations).\n\nThis determines how often the customer is billed during this phase. The total time spent in a phase is `cycle_duration × cycle_count`.\n\n**Common durations**:\n\n| Duration | Description |\n| -------- | ----------- |\n| `P1M` | 1 month |\n| `P1Y` | 1 year |\n| `P15D` | 15 days |\n| `P1W` | 1 week |\n| `PT2H` | 2 hours |\n\n**Example**: If `cycle_duration=P1M` and `cycle_count=12`, the customer will be billed monthly for 12 months (1 year total).","descriptionNode":"$Lb71"},"cycle_count":{"type":"$31:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:variations:items:properties:phases:items:properties:cycle_count:type","minimum":1,"description":"Number of billing cycles for this phase before moving to the next phase.\n\n| Value | Behavior |\n| ----- | -------- |\n| `null` or omitted | Phase continues indefinitely. The subscription remains in this phase with no automatic progression. |\n| Specific number (e.g., `1`, `3`, `12`) | After completing this many billing cycles, the subscription automatically moves to the next phase as determined by the `ordinal` field. |\n\n**Example**: If `cycle_count=3` and `cycle_duration=P1M`, the subscription will complete 3 monthly cycles then move to the phase with the next highest `ordinal` value.\n\n:::note\nIf no next phase exists in after a cycle with a specific `cycle_count`, the subscription will automatically stop when it completes its cycles.\n:::","title":"Cycle-Count","descriptionNode":"$Lb72"},"amount":{"type":"integer","minimum":0,"description":"Subscription amount in minor currency units (e.g., cents for USD, pence for GBP).\n\nFor example, `9900` in `GBP` represents £99.00.\n\n:::info\nConversion between major and minor units varies by currency. For instance, `100` minor units equal £1.00 in `GBP`, whereas in `ISK` they represent 100 units. For more details, see the [ISO 4217 standard](https://en.wikipedia.org/wiki/ISO_4217).\n:::","descriptionNode":"$Lb73"},"currency":{"type":"string","format":"ISO 4217","minLength":3,"maxLength":3,"description":"[ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) currency code in upper case.\n\n:::info\nFor more information about the supported currencies, see: [Help Center](https://help.revolut.com/business/help/merchant-accounts/payments/in-which-currencies-can-i-accept-payments/).\n:::","descriptionNode":"$Lb74"},"subscription_items":{"type":"array","description":"A list of subscription items for this phase.","items":{"title":"Subscription item","type":"object","description":"A subscription item that defines a billing line within a plan phase. Can be either a fixed-fee (flat) item or a metered (usage) item.","discriminator":"$31:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:variations:items:properties:phases:items:properties:subscription_items:items:discriminator","oneOf":[{"type":"object","description":"Object structure of flat subscription item.","properties":{"id":{"type":"string","format":"uuid","description":"The unique identifier of the subscription item.","descriptionNode":"$Lb75"},"name":{"type":"string","description":"The name of the subscription item.","maxLength":250,"examples":"$31:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:variations:items:properties:phases:items:properties:subscription_items:items:oneOf:0:properties:name:examples","descriptionNode":"$Lb76"},"type":{"type":"string","description":"The type of subscription item.","enum":"$31:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:variations:items:properties:phases:items:properties:subscription_items:items:oneOf:0:properties:type:enum","examples":"$31:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:variations:items:properties:phases:items:properties:subscription_items:items:oneOf:0:properties:type:examples","descriptionNode":"$Lb77"},"package_size":{"type":"number","description":"The number of units grouped together as a single billable package. Used to enable pricing of items that are too inexpensive to charge individually.\n\nFor example, a `package_size` of `1000` with a unit price of 10 minor units (£0.10 in GBP) lets you sell 1000 tokens for £0.10 — effectively pricing each token at £0.0001, below the minimum chargeable amount.\n\nSet to `1` to price each unit individually.","examples":"$31:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:variations:items:properties:phases:items:properties:subscription_items:items:oneOf:0:properties:package_size:examples","descriptionNode":"$Lb78"},"unit":{"type":"string","description":"The unit of measurement for the item.","maxLength":100,"examples":"$31:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:variations:items:properties:phases:items:properties:subscription_items:items:oneOf:0:properties:unit:examples","descriptionNode":"$Lb79"},"quantity":{"type":"number","description":"The quantity of the item.","examples":"$31:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:variations:items:properties:phases:items:properties:subscription_items:items:oneOf:0:properties:quantity:examples","descriptionNode":"$Lb7a"},"amount":{"type":"integer","description":"Amount in minor currency units (e.g., cents for USD).","examples":"$31:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:variations:items:properties:phases:items:properties:subscription_items:items:oneOf:0:properties:amount:examples","descriptionNode":"$Lb7b"},"currency":{"type":"string","format":"ISO 4217","minLength":3,"maxLength":3,"description":"[ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) currency code in upper case.\n\n:::info\nFor more information about the supported currencies, see: [Help Center](https://help.revolut.com/business/help/merchant-accounts/payments/in-which-currencies-can-i-accept-payments/).\n:::","descriptionNode":"$Lb7c"}},"required":"$31:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:variations:items:properties:phases:items:properties:subscription_items:items:oneOf:0:required","descriptionNode":"$Lb7d"},{"type":"object","description":"Object structure of usage subscription item.","properties":{"id":{"type":"string","format":"uuid","description":"The unique identifier of the subscription item.","descriptionNode":"$Lb7e"},"name":{"type":"string","description":"The name of the subscription item.","maxLength":250,"examples":"$31:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:variations:items:properties:phases:items:properties:subscription_items:items:oneOf:0:properties:name:examples","descriptionNode":"$Lb7f"},"type":{"type":"string","description":"The type of subscription item.","enum":"$31:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:variations:items:properties:phases:items:properties:subscription_items:items:oneOf:0:properties:type:enum","examples":"$31:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:variations:items:properties:phases:items:properties:subscription_items:items:oneOf:0:properties:type:examples","descriptionNode":"$Lb80"},"package_size":{"type":"number","description":"The number of units grouped together as a single billable package. Used to enable pricing of items that are too inexpensive to charge individually.\n\nFor example, a `package_size` of `1000` with a unit price of 10 minor units (£0.10 in GBP) lets you sell 1000 tokens for £0.10 — effectively pricing each token at £0.0001, below the minimum chargeable amount.\n\nSet to `1` to price each unit individually.","examples":"$31:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:variations:items:properties:phases:items:properties:subscription_items:items:oneOf:0:properties:package_size:examples","descriptionNode":"$Lb81"},"unit":{"type":"string","description":"The unit of measurement for the item.","maxLength":100,"examples":"$31:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:variations:items:properties:phases:items:properties:subscription_items:items:oneOf:0:properties:unit:examples","descriptionNode":"$Lb82"},"amount":{"type":"integer","description":"Flat amount per unit in minor currency units. Mutually exclusive with `tiers`.","examples":"$31:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:variations:items:properties:phases:items:properties:subscription_items:items:oneOf:1:properties:amount:examples","descriptionNode":"$Lb83"},"currency":{"type":"string","format":"ISO 4217","minLength":3,"maxLength":3,"description":"[ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) currency code in upper case.\n\n:::info\nFor more information about the supported currencies, see: [Help Center](https://help.revolut.com/business/help/merchant-accounts/payments/in-which-currencies-can-i-accept-payments/).\n:::","descriptionNode":"$Lb84"},"tiers":{"type":"array","description":"Graduated pricing tiers. Mutually exclusive with `amount`.","items":{"type":"object","properties":{"upper_quantity_threshold":{"type":"$31:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:variations:items:properties:phases:items:properties:subscription_items:items:oneOf:1:properties:tiers:items:properties:upper_quantity_threshold:type","description":"The upper bound of the tier (exclusive). Null means unlimited.","examples":"$31:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:variations:items:properties:phases:items:properties:subscription_items:items:oneOf:1:properties:tiers:items:properties:upper_quantity_threshold:examples","descriptionNode":"$Lb85"},"amount":{"type":"integer","description":"Per-unit amount in minor currency units (e.g., cents for USD) charged for usage within this tier's threshold range.","examples":"$31:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:variations:items:properties:phases:items:properties:subscription_items:items:oneOf:1:properties:tiers:items:properties:amount:examples","descriptionNode":"$Lb86"}},"required":"$31:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:variations:items:properties:phases:items:properties:subscription_items:items:oneOf:1:properties:tiers:items:required"},"descriptionNode":"$Lb87"},"code":{"type":"string","description":"A merchant-defined identifier for a usage-based subscription item. You set this code on each usage item when creating a subscription plan, and supply it when reporting consumption on [Create a subscription usage endpoint](https://developer.revolut.com/docs/api/merchant#create-subscription-usage) to target the correct metered item.\n\nThis allows a subscription with multiple usage items (e.g., `api_calls` and `storage_gb`) to receive consumption reports against the right item without relying on internal IDs.\n\nThe code must be unique within a plan phase.","maxLength":250,"examples":"$3d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:subscription_item_code:examples","descriptionNode":"$Lb88"},"usage_aggregation_method":{"type":"string","description":"The method used to aggregate usage events over a billing cycle to calculate the chargeable amount.\n\n| Value | Behaviour |\n| ----- | --------- |\n| `sum` | Totals all reported usage events during the cycle. Use for cumulative metrics (e.g., API calls, data transferred). |\n| `latest` | Uses the most recently reported value at the end of the cycle. If no usage is reported in a cycle, `0` is used — values do not carry over from previous cycles. Use for gauge-style metrics (e.g., active seats). |\n| `max` | Uses the peak value reported during the cycle. Use for capacity-based billing (e.g., max concurrent connections). |","enum":"$31:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:variations:items:properties:phases:items:properties:subscription_items:items:oneOf:1:properties:usage_aggregation_method:enum","examples":"$31:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:variations:items:properties:phases:items:properties:subscription_items:items:oneOf:1:properties:usage_aggregation_method:examples","descriptionNode":"$Lb89"}},"required":"$31:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:variations:items:properties:phases:items:properties:subscription_items:items:oneOf:1:required","descriptionNode":"$Lb8a"}],"descriptionNode":"$Lb8b"},"descriptionNode":"$Lb8c"}},"required":"$31:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:variations:items:properties:phases:items:required"},"descriptionNode":"$Lb8d"}}},"descriptionNode":"$Lb8e"}}},"descriptionNode":"$Lb8f"}}},"examples":{"plans_list":{"summary":"List of subscription plans","value":{"next_page_token":"9e5d2caa-bb60-4b5b-b7cf-6345bbdff67e","subscription_plans":[{"id":"550e8400-e29b-41d4-a716-446655440000","name":"Premium Plan with 14-days Trial","state":"active","trial_duration":"P14D","created_at":"2025-06-05T21:00:00.036001Z","updated_at":"2025-06-05T21:00:00.036001Z","variations":[{"id":"550e8400-e29b-41d4-a716-446655440001","phases":[{"id":"550e8400-e29b-41d4-a716-446655440002","ordinal":1,"cycle_duration":"P1Y","amount":99900,"currency":"GBP"}]}]},{"id":"f757b068-f287-43c8-8d05-9c073fecbe73","name":"Enterprise Pro Plan","state":"active","created_at":"2026-01-26T08:59:09.433527Z","updated_at":"2026-01-26T08:59:09.433527Z","variations":[{"id":"f4e0a171-4f4e-484b-b0a2-22085059af65","phases":[{"id":"23319d04-4b23-4ae7-ba54-82112c752683","ordinal":1,"cycle_duration":"P1M","amount":990,"currency":"GBP"}]},{"id":"7cf47b0d-3da9-496b-a4e9-fbbe43c33ee3","phases":[{"id":"feed2491-c895-4bfa-ba05-a3a088842d5c","ordinal":1,"cycle_duration":"P1Y","amount":9990,"currency":"GBP"}]}]}]}}}}},"descriptionNode":"$Lb90"},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"code":{"type":"string","description":"An identifier that can be used to determine what went wrong.\n\nError codes are not globally unique, but uniqueness is guaranteed within endpoints.","descriptionNode":"$Lb91"},"message":{"type":"string","description":"Some human readable text describing what went wrong.","descriptionNode":"$Lb92"},"timestamp":{"type":"integer","description":"The [UNIX timestamp](https://www.unixtimestamp.com/) of the date and time the error happened.","descriptionNode":"$Lb93"}}}}},"descriptionNode":"$Lb94"},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"code":{"type":"string","description":"An identifier that can be used to determine what went wrong.\n\nError codes are not globally unique, but uniqueness is guaranteed within endpoints.","descriptionNode":"$Lb95"},"message":{"type":"string","description":"Some human readable text describing what went wrong.","descriptionNode":"$Lb96"},"timestamp":{"type":"integer","description":"The [UNIX timestamp](https://www.unixtimestamp.com/) of the date and time the error happened.","descriptionNode":"$Lb97"}}}}},"descriptionNode":"$Lb98"},"default":{"description":"Error response","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"code":{"type":"string","description":"An identifier that can be used to determine what went wrong.\n\nError codes are not globally unique, but uniqueness is guaranteed within endpoints.","descriptionNode":"$Lb99"},"message":{"type":"string","description":"Some human readable text describing what went wrong.","descriptionNode":"$Lb9a"},"timestamp":{"type":"integer","description":"The [UNIX timestamp](https://www.unixtimestamp.com/) of the date and time the error happened.","descriptionNode":"$Lb9b"}}}}},"descriptionNode":"$Lb9c"}},"requestBody":"$undefined","variantLabels":[],"children":["$Lb9d","$Lb9e"]}]}],false]}] ab6:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Each Merchant API request must contain an authorization header in the following format:"}],"\n","$Lb9f","\n",["$","p","p-1",{"children":"To use this API, you need to generate API keys from your Revolut Business account. The Secret key is used in the authorization header for all server calls, while the Public key is provided with payment methods at checkout."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For detailed instructions on generating your API keys, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/get-started#generate-api-keys","target":"_blank","rel":"noreferrer","children":"Generate API keys"}],"."]}]}]]}]]}] abe:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unique identifier for the payment method."}]]}] abf:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of the payment method."}]]}] ac0:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Indicates in which case this saved payment method can be used for payments."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Value","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"customer"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"This payment method can be used only when the customer is on the checkout page.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"merchant"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"This payment method can be used without the customer being on the checkout page, and the merchant can initiate transactions, for example, to take payments for recurring transactions.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] ac1:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The date and time the payment method was added."}]]}] ac2:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The BIN (Bank Identification Number) of the payment card, typically the first 6-8 digits."}]]}] ac3:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The last four digits of the payment card number."}]]}] ac4:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The expiry month of the payment card."}]]}] ac5:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The expiry year of the payment card."}]]}] ac6:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The name of the cardholder as it appears on the card."}]]}] ac7:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The brand of the payment card."}]]}] ac8:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The funding type of the payment card."}]]}] ac9:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The name of the card-issuing bank or institution."}]]}] aca:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The ISO 3166-1 alpha-2 country code of the country where the payment card was issued."}]]}] acb:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Primary address line."}]]}] acc:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Secondary address line, such as floor and apartment number."}]]}] acd:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"State or province of the address."}]]}] ace:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"City of the address."}]]}] b4a:"Retrieve a dispute" b9d:["$","div",null,{"className":"ezz1n30","children":[["$","div",null,{"data-header":"$undefined","className":"ezz1n31","children":["$","div",null,{"className":"y9a0do1","children":[["$","h2",null,{"id":"retrieve-subscription-plan-list","children":[["$Lba0","$undefined"],["$","$L15",null,{"id":"retrieve-subscription-plan-list"}]]}],["$","$L16",null,{"url":"/docs/api/merchant/2025-10-16/operations/retrieve-subscription-plan-list.md"}]]}]}],"$undefined"]}] ba8:T41d,
curl -X GET "https://merchant.revolut.com/api/subscription-plans?limit=__RP_TOK_0__&from=__RP_TOK_1__&to=__RP_TOK_2__&page_token=__RP_TOK_3__" \
  -H "Authorization: __RP_TOK_4__" \
  -H "Revolut-Api-Version: __RP_TOK_5__"
ba9:Ta2b,
fetch("https://merchant.revolut.com/api/subscription-plans?limit=__RP_TOK_0__&from=__RP_TOK_1__&to=__RP_TOK_2__&page_token=__RP_TOK_3__", {
  method: "GET",
  headers: {
    "Authorization": "__RP_TOK_4__",
    "Revolut-Api-Version": "__RP_TOK_5__"
  }
})
  .then(response => response.json())
  .then(data => console.log(data));
baa:Tfc8,
package main

import (
  "fmt"
  "net/http"
)

func main() {
  url := "https://merchant.revolut.com/api/subscription-plans?limit=__RP_TOK_0__&from=__RP_TOK_1__&to=__RP_TOK_2__&page_token=__RP_TOK_3__"
  req, _ := http.NewRequest("GET", url, nil)
  req.Header.Add("Authorization", "__RP_TOK_4__")
  req.Header.Add("Revolut-Api-Version", "__RP_TOK_5__")

  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  fmt.Println(res)
}
bab:T83d,
import requests

url = "https://merchant.revolut.com/api/subscription-plans?limit=__RP_TOK_0__&from=__RP_TOK_1__&to=__RP_TOK_2__&page_token=__RP_TOK_3__"
headers = {
  "Authorization": "__RP_TOK_4__",
  "Revolut-Api-Version": "__RP_TOK_5__"
}

response = requests.get(url, headers=headers)
print(response.json())
bac:T1769,
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;

public class Main {
  public static void main(String[] args) {
    HttpClient client = HttpClient.newHttpClient();
    HttpRequest request = HttpRequest.newBuilder()
      .uri(URI.create("https://merchant.revolut.com/api/subscription-plans?limit=__RP_TOK_0__&from=__RP_TOK_1__&to=__RP_TOK_2__&page_token=__RP_TOK_3__"))
      .header("Authorization", "__RP_TOK_4__")
      .header("Revolut-Api-Version", "__RP_TOK_5__")
      .GET(HttpRequest.BodyPublishers.noBody())
      .build();

    client.sendAsync(request, HttpResponse.BodyHandlers.ofString())
      .thenApply(HttpResponse::body)
      .thenAccept(System.out::println)
      .join();
  }
}
bad:T1613,
using System.Net.Http;
using System.Net.Http.Headers;

var client = new HttpClient();
var request = new HttpRequestMessage
{
  Method = HttpMethod.Get,
  RequestUri = new Uri("https://merchant.revolut.com/api/subscription-plans?limit=__RP_TOK_0__&from=__RP_TOK_1__&to=__RP_TOK_2__&page_token=__RP_TOK_3__"),
  Headers =
  {
    { "Authorization", "__RP_TOK_4__" },
    { "Revolut-Api-Version", "__RP_TOK_5__" },
  }
};

using (var response = await client.SendAsync(request))
{
  response.EnsureSuccessStatusCode();
  var body = await response.Content.ReadAsStringAsync();
  Console.WriteLine(body);
}
bae:T425,
curl -X GET "https://sandbox-merchant.revolut.com/api/subscription-plans?limit=__RP_TOK_0__&from=__RP_TOK_1__&to=__RP_TOK_2__&page_token=__RP_TOK_3__" \
  -H "Authorization: __RP_TOK_4__" \
  -H "Revolut-Api-Version: __RP_TOK_5__"
baf:Ta33,
fetch("https://sandbox-merchant.revolut.com/api/subscription-plans?limit=__RP_TOK_0__&from=__RP_TOK_1__&to=__RP_TOK_2__&page_token=__RP_TOK_3__", {
  method: "GET",
  headers: {
    "Authorization": "__RP_TOK_4__",
    "Revolut-Api-Version": "__RP_TOK_5__"
  }
})
  .then(response => response.json())
  .then(data => console.log(data));
bb0:Tfd0,
package main

import (
  "fmt"
  "net/http"
)

func main() {
  url := "https://sandbox-merchant.revolut.com/api/subscription-plans?limit=__RP_TOK_0__&from=__RP_TOK_1__&to=__RP_TOK_2__&page_token=__RP_TOK_3__"
  req, _ := http.NewRequest("GET", url, nil)
  req.Header.Add("Authorization", "__RP_TOK_4__")
  req.Header.Add("Revolut-Api-Version", "__RP_TOK_5__")

  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  fmt.Println(res)
}
bb1:T845,
import requests

url = "https://sandbox-merchant.revolut.com/api/subscription-plans?limit=__RP_TOK_0__&from=__RP_TOK_1__&to=__RP_TOK_2__&page_token=__RP_TOK_3__"
headers = {
  "Authorization": "__RP_TOK_4__",
  "Revolut-Api-Version": "__RP_TOK_5__"
}

response = requests.get(url, headers=headers)
print(response.json())
bb2:T1771,
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;

public class Main {
  public static void main(String[] args) {
    HttpClient client = HttpClient.newHttpClient();
    HttpRequest request = HttpRequest.newBuilder()
      .uri(URI.create("https://sandbox-merchant.revolut.com/api/subscription-plans?limit=__RP_TOK_0__&from=__RP_TOK_1__&to=__RP_TOK_2__&page_token=__RP_TOK_3__"))
      .header("Authorization", "__RP_TOK_4__")
      .header("Revolut-Api-Version", "__RP_TOK_5__")
      .GET(HttpRequest.BodyPublishers.noBody())
      .build();

    client.sendAsync(request, HttpResponse.BodyHandlers.ofString())
      .thenApply(HttpResponse::body)
      .thenAccept(System.out::println)
      .join();
  }
}
bb3:T161b,
using System.Net.Http;
using System.Net.Http.Headers;

var client = new HttpClient();
var request = new HttpRequestMessage
{
  Method = HttpMethod.Get,
  RequestUri = new Uri("https://sandbox-merchant.revolut.com/api/subscription-plans?limit=__RP_TOK_0__&from=__RP_TOK_1__&to=__RP_TOK_2__&page_token=__RP_TOK_3__"),
  Headers =
  {
    { "Authorization", "__RP_TOK_4__" },
    { "Revolut-Api-Version", "__RP_TOK_5__" },
  }
};

using (var response = await client.SendAsync(request))
{
  response.EnsureSuccessStatusCode();
  var body = await response.Content.ReadAsStringAsync();
  Console.WriteLine(body);
}
b9e:["$","div",null,{"className":"ezz1n30","children":[["$","div",null,{"data-header":"$undefined","className":"ezz1n31","children":["$Lba1",["$","$L85",null,{"parameters":[{"name":"Authorization","in":"header","schema":{"type":"string","format":"Bearer ","examples":"$62:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:0:schema:examples"},"required":true,"description":"This parameter accepts the [Merchant API Secret key](https://business.revolut.com/settings/apis?tab=merchant-api) to authorise requests coming from the merchant's backend. \n\nIt ensures that ensures that each request is authenticated and authorised by verifying the secret key. The secret key should be included in all request headers as a `Bearer` token.\n\n:::info\nFor more information, see: [Authentication](https://developer.revolut.com/docs/api/merchant#authentication)\n:::","descriptionNode":"$Lba2"},{"name":"Revolut-Api-Version","in":"header","schema":{"type":"string","format":"date","enum":"$36:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:1:schema:enum","examples":"$36:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:1:schema:examples"},"required":true,"description":"The version of the Merchant API, specified in `YYYY-MM-DD` format.\n\nIf not specified, you will receive an error.\n\n\n:::info\nFor more information about API versioning, see: [API versions](https://developer.revolut.com/docs/guides/merchant/reference/versioning/api-versions).\n:::","x-config-always-visible-in-example":true,"example":"2025-10-16","descriptionNode":"$Lba3"},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":500,"default":100},"description":"Maximum number of records to return. Used for **pagination**.","required":false,"descriptionNode":"$Lba4"},{"name":"from","in":"query","schema":{"type":"string","format":"date-time"},"description":"Filter records created from this date/time. Used for **filtering**.","required":false,"descriptionNode":"$Lba5"},{"name":"to","in":"query","schema":{"type":"string","format":"date-time"},"description":"Filter records created until this date/time. Used for **filtering**.","required":false,"descriptionNode":"$Lba6"},{"name":"page_token","in":"query","schema":{"type":"string"},"description":"Token for retrieving the next page of results. Used for **pagination**.\n\nTo paginate through results:\n\n 1. Make an initial request with the desired `limit`.\n 1. The response will include a `next_page_token` if more results are available.\n 1. Use that token in the `page_token` parameter of your next request.\n 1. Repeat until `next_page_token` is not present.\n\n:::note\nWhen using `page_token`, you must include all query parameters from the initial request (such as `from`, `to`, or other filter parameters) to maintain consistent filtering across pages.\n:::","required":false,"descriptionNode":"$Lba7"}],"requestBody":"$undefined","heading":"Request","requestBodySchemaTitle":"Request body","headingAs":"h3"}],["$","$L89",null,{"responses":"$30:props:children:0:props:children:props:responses","headingAs":"h3"}]]}],["$","div",null,{"className":"ezz1n32","children":[[["$","$L8a",null,{"itemsByServer":{"https://merchant.revolut.com":[{"id":"curl","label":"cURL","templateCode":"curl -X GET \"https://merchant.revolut.com/api/subscription-plans?limit=__RP_TOK_0__&from=__RP_TOK_1__&to=__RP_TOK_2__&page_token=__RP_TOK_3__\" \\\n -H \"Authorization: __RP_TOK_4__\" \\\n -H \"Revolut-Api-Version: __RP_TOK_5__\"","templateHtml":"$ba8","tokens":[{"marker":"__RP_TOK_0__","paramName":"limit","paramIn":"query","pipeline":["url-component","shell-double-inner"]},{"marker":"__RP_TOK_1__","paramName":"from","paramIn":"query","pipeline":["url-component","shell-double-inner"]},{"marker":"__RP_TOK_2__","paramName":"to","paramIn":"query","pipeline":["url-component","shell-double-inner"]},{"marker":"__RP_TOK_3__","paramName":"page_token","paramIn":"query","pipeline":["url-component","shell-double-inner"]},{"marker":"__RP_TOK_4__","paramName":"Authorization","paramIn":"header","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_5__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["shell-double-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","query:limit":"100","query:from":"2024-01-01T00:00:00Z","query:to":"2024-01-01T00:00:00Z","query:page_token":"string"}},{"id":"javascript","label":"JavaScript","templateCode":"fetch(\"https://merchant.revolut.com/api/subscription-plans?limit=__RP_TOK_0__&from=__RP_TOK_1__&to=__RP_TOK_2__&page_token=__RP_TOK_3__\", {\n method: \"GET\",\n headers: {\n \"Authorization\": \"__RP_TOK_4__\",\n \"Revolut-Api-Version\": \"__RP_TOK_5__\"\n }\n})\n .then(response => response.json())\n .then(data => console.log(data));","templateHtml":"$ba9","tokens":[{"marker":"__RP_TOK_0__","paramName":"limit","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"from","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"to","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_3__","paramName":"page_token","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_4__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_5__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","query:limit":"100","query:from":"2024-01-01T00:00:00Z","query:to":"2024-01-01T00:00:00Z","query:page_token":"string"}},{"id":"go","label":"Go","templateCode":"package main\n\nimport (\n \"fmt\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://merchant.revolut.com/api/subscription-plans?limit=__RP_TOK_0__&from=__RP_TOK_1__&to=__RP_TOK_2__&page_token=__RP_TOK_3__\"\n req, _ := http.NewRequest(\"GET\", url, nil)\n req.Header.Add(\"Authorization\", \"__RP_TOK_4__\")\n req.Header.Add(\"Revolut-Api-Version\", \"__RP_TOK_5__\")\n\n res, _ := http.DefaultClient.Do(req)\n defer res.Body.Close()\n fmt.Println(res)\n}","templateHtml":"$baa","tokens":[{"marker":"__RP_TOK_0__","paramName":"limit","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"from","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"to","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_3__","paramName":"page_token","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_4__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_5__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","query:limit":"100","query:from":"2024-01-01T00:00:00Z","query:to":"2024-01-01T00:00:00Z","query:page_token":"string"}},{"id":"python","label":"Python","templateCode":"import requests\n\nurl = \"https://merchant.revolut.com/api/subscription-plans?limit=__RP_TOK_0__&from=__RP_TOK_1__&to=__RP_TOK_2__&page_token=__RP_TOK_3__\"\nheaders = {\n \"Authorization\": \"__RP_TOK_4__\",\n \"Revolut-Api-Version\": \"__RP_TOK_5__\"\n}\n\nresponse = requests.get(url, headers=headers)\nprint(response.json())","templateHtml":"$bab","tokens":[{"marker":"__RP_TOK_0__","paramName":"limit","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"from","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"to","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_3__","paramName":"page_token","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_4__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_5__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","query:limit":"100","query:from":"2024-01-01T00:00:00Z","query:to":"2024-01-01T00:00:00Z","query:page_token":"string"}},{"id":"java","label":"Java","templateCode":"import java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\nimport java.net.URI;\n\npublic class Main {\n public static void main(String[] args) {\n HttpClient client = HttpClient.newHttpClient();\n HttpRequest request = HttpRequest.newBuilder()\n .uri(URI.create(\"https://merchant.revolut.com/api/subscription-plans?limit=__RP_TOK_0__&from=__RP_TOK_1__&to=__RP_TOK_2__&page_token=__RP_TOK_3__\"))\n .header(\"Authorization\", \"__RP_TOK_4__\")\n .header(\"Revolut-Api-Version\", \"__RP_TOK_5__\")\n .GET(HttpRequest.BodyPublishers.noBody())\n .build();\n\n client.sendAsync(request, HttpResponse.BodyHandlers.ofString())\n .thenApply(HttpResponse::body)\n .thenAccept(System.out::println)\n .join();\n }\n}","templateHtml":"$bac","tokens":[{"marker":"__RP_TOK_0__","paramName":"limit","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"from","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"to","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_3__","paramName":"page_token","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_4__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_5__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","query:limit":"100","query:from":"2024-01-01T00:00:00Z","query:to":"2024-01-01T00:00:00Z","query:page_token":"string"}},{"id":"csharp","label":"C#","templateCode":"using System.Net.Http;\nusing System.Net.Http.Headers;\n\nvar client = new HttpClient();\nvar request = new HttpRequestMessage\n{\n Method = HttpMethod.Get,\n RequestUri = new Uri(\"https://merchant.revolut.com/api/subscription-plans?limit=__RP_TOK_0__&from=__RP_TOK_1__&to=__RP_TOK_2__&page_token=__RP_TOK_3__\"),\n Headers =\n {\n { \"Authorization\", \"__RP_TOK_4__\" },\n { \"Revolut-Api-Version\", \"__RP_TOK_5__\" },\n }\n};\n\nusing (var response = await client.SendAsync(request))\n{\n response.EnsureSuccessStatusCode();\n var body = await response.Content.ReadAsStringAsync();\n Console.WriteLine(body);\n}","templateHtml":"$bad","tokens":[{"marker":"__RP_TOK_0__","paramName":"limit","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"from","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"to","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_3__","paramName":"page_token","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_4__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_5__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","query:limit":"100","query:from":"2024-01-01T00:00:00Z","query:to":"2024-01-01T00:00:00Z","query:page_token":"string"}}],"https://sandbox-merchant.revolut.com":[{"id":"curl","label":"cURL","templateCode":"curl -X GET \"https://sandbox-merchant.revolut.com/api/subscription-plans?limit=__RP_TOK_0__&from=__RP_TOK_1__&to=__RP_TOK_2__&page_token=__RP_TOK_3__\" \\\n -H \"Authorization: __RP_TOK_4__\" \\\n -H \"Revolut-Api-Version: __RP_TOK_5__\"","templateHtml":"$bae","tokens":[{"marker":"__RP_TOK_0__","paramName":"limit","paramIn":"query","pipeline":["url-component","shell-double-inner"]},{"marker":"__RP_TOK_1__","paramName":"from","paramIn":"query","pipeline":["url-component","shell-double-inner"]},{"marker":"__RP_TOK_2__","paramName":"to","paramIn":"query","pipeline":["url-component","shell-double-inner"]},{"marker":"__RP_TOK_3__","paramName":"page_token","paramIn":"query","pipeline":["url-component","shell-double-inner"]},{"marker":"__RP_TOK_4__","paramName":"Authorization","paramIn":"header","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_5__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["shell-double-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","query:limit":"100","query:from":"2024-01-01T00:00:00Z","query:to":"2024-01-01T00:00:00Z","query:page_token":"string"}},{"id":"javascript","label":"JavaScript","templateCode":"fetch(\"https://sandbox-merchant.revolut.com/api/subscription-plans?limit=__RP_TOK_0__&from=__RP_TOK_1__&to=__RP_TOK_2__&page_token=__RP_TOK_3__\", {\n method: \"GET\",\n headers: {\n \"Authorization\": \"__RP_TOK_4__\",\n \"Revolut-Api-Version\": \"__RP_TOK_5__\"\n }\n})\n .then(response => response.json())\n .then(data => console.log(data));","templateHtml":"$baf","tokens":[{"marker":"__RP_TOK_0__","paramName":"limit","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"from","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"to","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_3__","paramName":"page_token","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_4__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_5__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","query:limit":"100","query:from":"2024-01-01T00:00:00Z","query:to":"2024-01-01T00:00:00Z","query:page_token":"string"}},{"id":"go","label":"Go","templateCode":"package main\n\nimport (\n \"fmt\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://sandbox-merchant.revolut.com/api/subscription-plans?limit=__RP_TOK_0__&from=__RP_TOK_1__&to=__RP_TOK_2__&page_token=__RP_TOK_3__\"\n req, _ := http.NewRequest(\"GET\", url, nil)\n req.Header.Add(\"Authorization\", \"__RP_TOK_4__\")\n req.Header.Add(\"Revolut-Api-Version\", \"__RP_TOK_5__\")\n\n res, _ := http.DefaultClient.Do(req)\n defer res.Body.Close()\n fmt.Println(res)\n}","templateHtml":"$bb0","tokens":[{"marker":"__RP_TOK_0__","paramName":"limit","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"from","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"to","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_3__","paramName":"page_token","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_4__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_5__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","query:limit":"100","query:from":"2024-01-01T00:00:00Z","query:to":"2024-01-01T00:00:00Z","query:page_token":"string"}},{"id":"python","label":"Python","templateCode":"import requests\n\nurl = \"https://sandbox-merchant.revolut.com/api/subscription-plans?limit=__RP_TOK_0__&from=__RP_TOK_1__&to=__RP_TOK_2__&page_token=__RP_TOK_3__\"\nheaders = {\n \"Authorization\": \"__RP_TOK_4__\",\n \"Revolut-Api-Version\": \"__RP_TOK_5__\"\n}\n\nresponse = requests.get(url, headers=headers)\nprint(response.json())","templateHtml":"$bb1","tokens":[{"marker":"__RP_TOK_0__","paramName":"limit","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"from","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"to","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_3__","paramName":"page_token","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_4__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_5__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","query:limit":"100","query:from":"2024-01-01T00:00:00Z","query:to":"2024-01-01T00:00:00Z","query:page_token":"string"}},{"id":"java","label":"Java","templateCode":"import java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\nimport java.net.URI;\n\npublic class Main {\n public static void main(String[] args) {\n HttpClient client = HttpClient.newHttpClient();\n HttpRequest request = HttpRequest.newBuilder()\n .uri(URI.create(\"https://sandbox-merchant.revolut.com/api/subscription-plans?limit=__RP_TOK_0__&from=__RP_TOK_1__&to=__RP_TOK_2__&page_token=__RP_TOK_3__\"))\n .header(\"Authorization\", \"__RP_TOK_4__\")\n .header(\"Revolut-Api-Version\", \"__RP_TOK_5__\")\n .GET(HttpRequest.BodyPublishers.noBody())\n .build();\n\n client.sendAsync(request, HttpResponse.BodyHandlers.ofString())\n .thenApply(HttpResponse::body)\n .thenAccept(System.out::println)\n .join();\n }\n}","templateHtml":"$bb2","tokens":[{"marker":"__RP_TOK_0__","paramName":"limit","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"from","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"to","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_3__","paramName":"page_token","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_4__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_5__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","query:limit":"100","query:from":"2024-01-01T00:00:00Z","query:to":"2024-01-01T00:00:00Z","query:page_token":"string"}},{"id":"csharp","label":"C#","templateCode":"using System.Net.Http;\nusing System.Net.Http.Headers;\n\nvar client = new HttpClient();\nvar request = new HttpRequestMessage\n{\n Method = HttpMethod.Get,\n RequestUri = new Uri(\"https://sandbox-merchant.revolut.com/api/subscription-plans?limit=__RP_TOK_0__&from=__RP_TOK_1__&to=__RP_TOK_2__&page_token=__RP_TOK_3__\"),\n Headers =\n {\n { \"Authorization\", \"__RP_TOK_4__\" },\n { \"Revolut-Api-Version\", \"__RP_TOK_5__\" },\n }\n};\n\nusing (var response = await client.SendAsync(request))\n{\n response.EnsureSuccessStatusCode();\n var body = await response.Content.ReadAsStringAsync();\n Console.WriteLine(body);\n}","templateHtml":"$bb3","tokens":[{"marker":"__RP_TOK_0__","paramName":"limit","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"from","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"to","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_3__","paramName":"page_token","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_4__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_5__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","query:limit":"100","query:from":"2024-01-01T00:00:00Z","query:to":"2024-01-01T00:00:00Z","query:page_token":"string"}}]},"method":"get","servers":"$62:props:children:0:props:children:props:children:1:props:children:1:props:children:0:0:props:servers","path":"/api/subscription-plans","parameters":["$b9e:props:children:0:props:children:1:props:parameters:0","$b9e:props:children:0:props:children:1:props:parameters:1","$b9e:props:children:0:props:children:1:props:parameters:2","$b9e:props:children:0:props:children:1:props:parameters:3","$b9e:props:children:0:props:children:1:props:parameters:4","$b9e:props:children:0:props:children:1:props:parameters:5"]}],"$Lbb4"],"$Lbb5","$Lbb6"]}]]}] 9fd:["$","div","CodeBlock-0",{"className":"wzy01m0 _18b50nc0","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"
'Authorization: Bearer <yourSecretApiKey>'
"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"'Authorization: Bearer '\n"}]}]]}] bb9:T514,Provides additional granularity about the dispute state. It details the progression of the dispute process, showing the current stage or phase. | Parameter value | Description | | --------------- | ----------- | | `new` | The dispute has been recently created and is in the initial phase, awaiting further processing. | | `lost_expired` | The dispute has been lost due to expiration, likely because the merchant did not respond within the required timeframe. | | `pre_arbitration` | The dispute is in the pre-arbitration phase, where preliminary evidence is being gathered before a formal arbitration process. | | `won_pre_arbitration`| The merchant secured a win during the pre-arbitration phase based on the evidence provided. | | `lost_pre_arbitration` | The dispute was lost during the pre-arbitration phase, indicating that the preliminary review did not favor the merchant. | | `lost_accepted` | The loss has been accepted as final, implying that no further contestation is likely or needed. | | `arbitration` | The dispute has escalated to the arbitration stage, where a neutral third party is reviewing the evidence. | | `won_arbitration` | The merchant won the dispute during the arbitration process. | | `lost_arbitration` | The merchant lost the dispute during the arbitration process. |44:["$","$7a","retrieve-dispute-list",{"children":[["$","section",null,{"className":"y9a0do0","data-variant":"endpoint","children":["$","$L7b",null,{"responses":{"200":{"description":"List of disputes retrieved","content":{"application/json":{"schema":{"type":"array","description":"An array containing a list of disputes.","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Unique identifier of the dispute.","descriptionNode":"$Lbb7"},"state":{"type":"string","enum":"$45:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:state:enum","description":"Represents the state of the dispute.\n\nIt indicates either the final outcome of the dispute or if further action is required.\n\n| Parameter value | Description |\n| --------------- | ----------- |\n| `needs_response` | Indicates that the dispute requires a response or action from the merchant. |\n| `under_review` | Indicates that the dispute is currently under review, and the outcome is pending. |\n| `won` | Indicates that the dispute has been resolved in favor of the merchant. |\n| `lost` | Indicates that the dispute has been resolved against the merchant. |","descriptionNode":"$Lbb8"},"substate":{"type":"string","enum":"$45:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:substate:enum","description":"$bb9","descriptionNode":"$Lbba"},"created_at":{"type":"string","format":"date-time","description":"[ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time when the dispute was created.","descriptionNode":"$Lbbb"},"updated_at":{"type":"string","format":"date-time","description":"[ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time when the dispute was last updated.","descriptionNode":"$Lbbc"},"response_due_date":{"type":"string","format":"date-time","description":"[ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time until when the merchant needs to respond to the dispute.\n\nThe response time by default is 15 days after the dispute is created. If no response is provided by this date, the dispute transitions to:\n - `state: lost`\n - `substate: lost_expired` ","descriptionNode":"$Lbbd"},"reason_code":{"type":"string","description":"Dispute reason code from the payment scheme, following standard formats defined by individual providers.\n\n:::info\nFor complete, official lists of dispute codes, see: \n- **Visa**: [Visa Core Rules and Visa Product and Service Rules](https://corporate.visa.com/content/dam/VCOM/download/about-visa/visa-rules-public.pdf) \n- **Mastercard**: [Chargeback Guide - Merchant Edition](https://www.mastercard.com/content/dam/public/mastercardcom/na/global-site/documents/chargeback-guide.pdf)\n- **American Express**: [Chargeback Codes](https://www.americanexpress.com/content/dam/amex/au/en/merchant/static/chargebackcodeguide.pdf)\n:::","descriptionNode":"$Lbbe"},"reason_description":{"type":"string","description":"Provides a human-readable explanation for the dispute reason codes.","descriptionNode":"$Lbbf"},"amount":{"type":"integer","description":"Disputed amount expressed in minor currency units, according to the [ISO 4217 standard](https://en.wikipedia.org/wiki/ISO_4217). For example, `7034` in `EUR` corresponds to €70.34.\n\n:::info\nConversion between major and minor units varies by currency. For instance, `100` minor units equal £1.00 in `GBP`, whereas in `ISK` they represent 100 units. For more details, see the [ISO 4217 standard](https://en.wikipedia.org/wiki/ISO_4217).\n:::","descriptionNode":"$Lbc0"},"currency":{"type":"string","format":"ISO 4217","minLength":3,"maxLength":3,"description":"[ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) currency code in upper case.\n\n:::info\nFor more information about the supported currencies, see: [Help Center](https://help.revolut.com/business/help/merchant-accounts/payments/in-which-currencies-can-i-accept-payments/).\n:::","descriptionNode":"$Lbc1"},"payment":{"type":"object","description":"Object containing the details of the original payment associated with the dispute.","properties":{"id":{"type":"string","format":"uuid","description":"The ID of the original payment that was disputed.","descriptionNode":"$Lbc2"},"order_id":{"type":"string","format":"uuid","description":"The ID of the order linked to the original disputed payment.","descriptionNode":"$Lbc3"},"created_at":{"type":"string","format":"date-time","description":"[ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time when the original disputed payment was created.","descriptionNode":"$Lbc4"},"arn":{"type":"string","description":"Acquirer Reference Number (ARN) of the original payment.\n\n:::note\nOnly returned for payments made by a card.\n:::","descriptionNode":"$Lbc5"},"amount":{"type":"integer","description":"Amount of the original payment expressed in minor currency units, according to the [ISO 4217 standard](https://en.wikipedia.org/wiki/ISO_4217). For example, `7034` in `EUR` corresponds to €70.34.\n\n:::info\nConversion between major and minor units varies by currency. For instance, `100` minor units equal £1.00 in `GBP`, whereas in `ISK` they represent 100 units. For more details, see the [ISO 4217 standard](https://en.wikipedia.org/wiki/ISO_4217).\n:::","descriptionNode":"$Lbc6"},"currency":{"type":"string","format":"ISO 4217","minLength":3,"maxLength":3,"description":"[ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) currency code in upper case.\n\n:::info\nFor more information about the supported currencies, see: [Help Center](https://help.revolut.com/business/help/merchant-accounts/payments/in-which-currencies-can-i-accept-payments/).\n:::","descriptionNode":"$Lbc7"},"payment_method":{"type":"object","description":"Payment method used for the original payment.\n\nUse the `type` field to determine the specific payment method variant.","discriminator":"$45:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment:properties:payment_method:discriminator","oneOf":[{"type":"object","description":"Object containing details of a card used via Apple Pay.","properties":{"type":{"type":"string","enum":"$45:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment:properties:payment_method:oneOf:0:properties:type:enum","description":"Type of the payment method used for the original payment.\n\nAvailable values:\n\n| Payment method `type` | Description |\n| --------------------- | ----------- |\n| `apple_pay` | The customer paid the order using Apple Pay. |\n| `apple_tap_to_pay` | The customer paid the order using Apple Tap to Pay. |\n| `card` | The customer paid the order using their credit or debit card. |\n| `google_pay` | The customer paid the order using Google Pay. |\n| `revolut_pay_card` | The customer paid the order via Revolut Pay using their credit or debit card. |\n| `revolut_pay_account` | The customer paid the order via Revolut Pay using their Revolut account. |\n| `sepa_direct_debit` | The customer paid the order via SEPA Direct Debit. |","descriptionNode":"$Lbc8"},"card_brand":{"type":"string","description":"The brand of the payment card.","enum":"$29:props:children:0:props:children:props:responses:200:content:application/json:schema:oneOf:0:properties:brand:enum","descriptionNode":"$Lbc9"},"card_last_four":{"type":"string","minLength":4,"maxLength":4,"description":"The last four digits of the payment card number.","descriptionNode":"$Lbca"}},"required":"$45:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment:properties:payment_method:oneOf:0:required","descriptionNode":"$Lbcb"},{"type":"object","description":"Object containing details of a payment made via Apple Tap to Pay.","properties":{"type":{"type":"string","enum":"$45:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment:properties:payment_method:oneOf:0:properties:type:enum","description":"Type of the payment method used for the original payment.\n\nAvailable values:\n\n| Payment method `type` | Description |\n| --------------------- | ----------- |\n| `apple_pay` | The customer paid the order using Apple Pay. |\n| `apple_tap_to_pay` | The customer paid the order using Apple Tap to Pay. |\n| `card` | The customer paid the order using their credit or debit card. |\n| `google_pay` | The customer paid the order using Google Pay. |\n| `revolut_pay_card` | The customer paid the order via Revolut Pay using their credit or debit card. |\n| `revolut_pay_account` | The customer paid the order via Revolut Pay using their Revolut account. |\n| `sepa_direct_debit` | The customer paid the order via SEPA Direct Debit. |","descriptionNode":"$Lbcc"}},"required":"$45:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment:properties:payment_method:oneOf:1:required","descriptionNode":"$Lbcd"},{"type":"object","description":"Object containing details of the card used for the payment.","properties":{"type":{"type":"string","enum":"$45:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment:properties:payment_method:oneOf:0:properties:type:enum","description":"Type of the payment method used for the original payment.\n\nAvailable values:\n\n| Payment method `type` | Description |\n| --------------------- | ----------- |\n| `apple_pay` | The customer paid the order using Apple Pay. |\n| `apple_tap_to_pay` | The customer paid the order using Apple Tap to Pay. |\n| `card` | The customer paid the order using their credit or debit card. |\n| `google_pay` | The customer paid the order using Google Pay. |\n| `revolut_pay_card` | The customer paid the order via Revolut Pay using their credit or debit card. |\n| `revolut_pay_account` | The customer paid the order via Revolut Pay using their Revolut account. |\n| `sepa_direct_debit` | The customer paid the order via SEPA Direct Debit. |","descriptionNode":"$Lbce"},"card_brand":{"type":"string","description":"The brand of the payment card.","enum":"$29:props:children:0:props:children:props:responses:200:content:application/json:schema:oneOf:0:properties:brand:enum","descriptionNode":"$Lbcf"},"card_last_four":{"type":"string","minLength":4,"maxLength":4,"description":"The last four digits of the payment card number.","descriptionNode":"$Lbd0"}},"required":"$45:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment:properties:payment_method:oneOf:2:required","descriptionNode":"$Lbd1"},{"type":"object","description":"Object containing details of a card used via Google Pay.","properties":{"type":{"type":"string","enum":"$45:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment:properties:payment_method:oneOf:0:properties:type:enum","description":"Type of the payment method used for the original payment.\n\nAvailable values:\n\n| Payment method `type` | Description |\n| --------------------- | ----------- |\n| `apple_pay` | The customer paid the order using Apple Pay. |\n| `apple_tap_to_pay` | The customer paid the order using Apple Tap to Pay. |\n| `card` | The customer paid the order using their credit or debit card. |\n| `google_pay` | The customer paid the order using Google Pay. |\n| `revolut_pay_card` | The customer paid the order via Revolut Pay using their credit or debit card. |\n| `revolut_pay_account` | The customer paid the order via Revolut Pay using their Revolut account. |\n| `sepa_direct_debit` | The customer paid the order via SEPA Direct Debit. |","descriptionNode":"$Lbd2"},"card_brand":{"type":"string","description":"The brand of the payment card.","enum":"$29:props:children:0:props:children:props:responses:200:content:application/json:schema:oneOf:0:properties:brand:enum","descriptionNode":"$Lbd3"},"card_last_four":{"type":"string","minLength":4,"maxLength":4,"description":"The last four digits of the payment card number.","descriptionNode":"$Lbd4"}},"required":"$45:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment:properties:payment_method:oneOf:3:required","descriptionNode":"$Lbd5"},{"type":"object","description":"Object containing details of a payment made via Revolut Pay account.","properties":{"type":{"type":"string","enum":"$45:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment:properties:payment_method:oneOf:0:properties:type:enum","description":"Type of the payment method used for the original payment.\n\nAvailable values:\n\n| Payment method `type` | Description |\n| --------------------- | ----------- |\n| `apple_pay` | The customer paid the order using Apple Pay. |\n| `apple_tap_to_pay` | The customer paid the order using Apple Tap to Pay. |\n| `card` | The customer paid the order using their credit or debit card. |\n| `google_pay` | The customer paid the order using Google Pay. |\n| `revolut_pay_card` | The customer paid the order via Revolut Pay using their credit or debit card. |\n| `revolut_pay_account` | The customer paid the order via Revolut Pay using their Revolut account. |\n| `sepa_direct_debit` | The customer paid the order via SEPA Direct Debit. |","descriptionNode":"$Lbd6"}},"required":"$45:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment:properties:payment_method:oneOf:4:required","descriptionNode":"$Lbd7"},{"type":"object","description":"Object containing details of a card used via Revolut Pay.","properties":{"type":{"type":"string","enum":"$45:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment:properties:payment_method:oneOf:0:properties:type:enum","description":"Type of the payment method used for the original payment.\n\nAvailable values:\n\n| Payment method `type` | Description |\n| --------------------- | ----------- |\n| `apple_pay` | The customer paid the order using Apple Pay. |\n| `apple_tap_to_pay` | The customer paid the order using Apple Tap to Pay. |\n| `card` | The customer paid the order using their credit or debit card. |\n| `google_pay` | The customer paid the order using Google Pay. |\n| `revolut_pay_card` | The customer paid the order via Revolut Pay using their credit or debit card. |\n| `revolut_pay_account` | The customer paid the order via Revolut Pay using their Revolut account. |\n| `sepa_direct_debit` | The customer paid the order via SEPA Direct Debit. |","descriptionNode":"$Lbd8"},"card_brand":{"type":"string","description":"The brand of the payment card.","enum":"$29:props:children:0:props:children:props:responses:200:content:application/json:schema:oneOf:0:properties:brand:enum","descriptionNode":"$Lbd9"},"card_last_four":{"type":"string","minLength":4,"maxLength":4,"description":"The last four digits of the payment card number.","descriptionNode":"$Lbda"}},"required":"$45:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment:properties:payment_method:oneOf:5:required","descriptionNode":"$Lbdb"},{"type":"object","description":"Object containing details of a SEPA Direct Debit payment.","properties":{"type":{"type":"string","enum":"$45:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment:properties:payment_method:oneOf:0:properties:type:enum","description":"Type of the payment method used for the original payment.\n\nAvailable values:\n\n| Payment method `type` | Description |\n| --------------------- | ----------- |\n| `apple_pay` | The customer paid the order using Apple Pay. |\n| `apple_tap_to_pay` | The customer paid the order using Apple Tap to Pay. |\n| `card` | The customer paid the order using their credit or debit card. |\n| `google_pay` | The customer paid the order using Google Pay. |\n| `revolut_pay_card` | The customer paid the order via Revolut Pay using their credit or debit card. |\n| `revolut_pay_account` | The customer paid the order via Revolut Pay using their Revolut account. |\n| `sepa_direct_debit` | The customer paid the order via SEPA Direct Debit. |","descriptionNode":"$Lbdc"},"debtor_iban_last_four":{"type":"string","description":"The last four digits of the debtor's IBAN.","minLength":4,"maxLength":4,"descriptionNode":"$Lbdd"},"debtor_name":{"type":"string","description":"The full name of the debtor as provided in the mandate.","descriptionNode":"$Lbde"},"mandate_reference":{"type":"string","description":"The unique mandate reference generated by Revolut. Include this in pre-debit notifications sent to your customers.","descriptionNode":"$Lbdf"}},"required":"$45:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment:properties:payment_method:oneOf:6:required","descriptionNode":"$Lbe0"}],"descriptionNode":"$Lbe1"}},"descriptionNode":"$Lbe2"}}},"descriptionNode":"$Lbe3"},"examples":{"dispute_list":{"summary":"List of disputes","value":[{"id":"ab934829-e4ba-4e7f-8a21-365cad85c763","state":"under_review","substate":"arbitration","created_at":"2024-06-13T12:06:18.732706Z","updated_at":"2024-09-12T22:27:10.005680Z","response_due_date":"2024-10-12T22:27:10.005625Z","reason_code":"50","reason_description":"Fraud","amount":50,"currency":"EUR","payment":{"id":"6666f6c7-3898-a094-9c83-dc0152e0185c","order_id":"6666f685-46a7-a7b9-9860-a28a4f3495a4","created_at":"2024-06-10T12:51:19.960490Z","amount":50,"currency":"EUR","payment_method":{"type":"revolut_pay_account"}}},{"id":"340b85dc-da99-4c5f-9d47-37a45d52a455","state":"lost","substate":"lost_expired","created_at":"2024-09-11T21:20:05.659978Z","updated_at":"2024-09-12T22:35:31.721921Z","response_due_date":"2024-09-22T22:35:31.721860Z","reason_code":"12.4","reason_description":"Incorrect Account Number","amount":40,"currency":"EUR","payment":{"id":"66e1fc66-7606-a7fb-b2e8-b48fb637783a","order_id":"66e1fc4d-5cbe-a692-80aa-1cb912291d55","created_at":"2024-09-11T20:24:06.271746Z","amount":40,"currency":"EUR","payment_method":{"type":"card","card_brand":"visa","card_last_four":"1234"}}},{"id":"e9b5472b-7308-4aea-86a0-d4427bc04c24","state":"lost","substate":"lost_pre_arbitration","created_at":"2026-05-22T09:00:00Z","updated_at":"2026-05-22T10:15:00Z","response_due_date":"2030-12-15T00:00:00Z","reason_code":"OTHER","reason_description":"merchant_dispute","amount":91700,"currency":"GBP","payment":{"id":"6a0f2bc4-2137-a1ad-9eb6-b34cf4ca6597","order_id":"2bcaf93a-aa87-4d3d-b5c6-62e06051cff2","created_at":"2026-05-21T15:59:00.451602Z","amount":1000,"currency":"GBP","payment_method":{"type":"sepa_direct_debit","debtor_iban_last_four":"3273","debtor_name":"John Doe","mandate_reference":"69F1CB61BD99A32C8E20D7FB9E21E146"}}}]}}}},"descriptionNode":"$Lbe4"},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"code":{"type":"string","description":"An identifier that can be used to determine what went wrong.\n\nError codes are not globally unique, but uniqueness is guaranteed within endpoints.","descriptionNode":"$Lbe5"},"message":{"type":"string","description":"Some human readable text describing what went wrong.","descriptionNode":"$Lbe6"},"timestamp":{"type":"integer","description":"The [UNIX timestamp](https://www.unixtimestamp.com/) of the date and time the error happened.","descriptionNode":"$Lbe7"}}},"examples":{"default":{"value":{"code":"validation","message":"limit must be between 1 and 500","timestamp":1601296792533}}}}},"descriptionNode":"$Lbe8"},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"code":{"type":"string","description":"An identifier that can be used to determine what went wrong.\n\nError codes are not globally unique, but uniqueness is guaranteed within endpoints.","descriptionNode":"$Lbe9"},"message":{"type":"string","description":"Some human readable text describing what went wrong.","descriptionNode":"$Lbea"},"timestamp":{"type":"integer","description":"The [UNIX timestamp](https://www.unixtimestamp.com/) of the date and time the error happened.","descriptionNode":"$Lbeb"}}},"examples":{"default":{"value":{"code":"unauthenticated","message":"Authentication failed","timestamp":1721049596461}}}}},"descriptionNode":"$Lbec"}},"requestBody":"$undefined","variantLabels":[],"children":["$Lbed","$Lbee"]}]}],false]}] acf:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"ISO 2-letter country code."}]]}] ad0:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Postal code of the address."}]]}] ad1:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The billing address associated with the payment method."}]]}] ad2:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The hardware identifier of the Revolut Terminal device used to process the payment."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":"Only present for card-present transactions processed via Revolut Terminal."}]}]]}]]}] ad3:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A saved card payment method."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["The ",["$","code","code-0",{"children":"checks"}]," object (3DS, CVV, address verification) is not included as it is specific to the transactional payment context."]}]}]]}]]}] ad4:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unique identifier for the payment method."}]]}] ad5:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of the payment method."}]]}] ad6:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Indicates in which case this saved payment method can be used for payments."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Value","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"customer"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"This payment method can be used only when the customer is on the checkout page.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"merchant"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"This payment method can be used without the customer being on the checkout page, and the merchant can initiate transactions, for example, to take payments for recurring transactions.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] ad7:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The date and time the payment method was added."}]]}] ad8:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A saved Revolut Pay payment method on a customer profile."}],"\n",["$","p","p-1",{"children":["Both Revolut Pay card-backed and account-to-account (A2A) variants are\nrepresented by this single type at the saved payment method level.\nNo underlying card details are exposed here; use the order-level\n",["$","code","code-0",{"children":"payments[].payment_method"}]," object (types ",["$","code","code-1",{"children":"revolut_pay_card"}]," /\n",["$","code","code-2",{"children":"revolut_pay_account"}],") for per-transaction details."]}]]}] ad9:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unique identifier for the payment method."}]]}] ada:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of the payment method."}]]}] adb:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Indicates in which case this saved payment method can be used for payments."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Value","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"customer"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"This payment method can be used only when the customer is on the checkout page.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"merchant"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"This payment method can be used without the customer being on the checkout page, and the merchant can initiate transactions, for example, to take payments for recurring transactions.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] adc:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The last four digits of the debtor's IBAN."}]]}] add:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The full name of the debtor as provided in the mandate."}]]}] ade:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The unique mandate reference generated by Revolut. Include this in pre-debit notifications sent to your customers."}]]}] adf:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The billing address associated with the payment method."}]]}] ae0:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The date and time the payment method was added."}]]}] ae1:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A saved SEPA Direct Debit payment method on a customer profile."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/accept-payments/payment-methods/sepa-direct-debit/server-to-server","target":"_blank","rel":"noreferrer","children":"SEPA Direct Debit server-to-server integration"}]]}]}]]}]]}] ae2:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A saved payment method on a customer profile."}],"\n",["$","p","p-1",{"children":["Use the ",["$","code","code-0",{"children":"type"}]," field to determine the specific payment method variant."]}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":["This schema represents a stored credential available for future charges and supports three types: ",["$","code","code-0",{"children":"card"}],", ",["$","code","code-1",{"children":"revolut_pay"}],", and ",["$","code","code-2",{"children":"sepa_direct_debit"}],"."]}],["$","p","p-1",{"children":["It differs from the ",["$","code","code-0",{"children":"payment_method"}]," object on a Payment, which is a transactional snapshot of how a specific charge was executed and includes additional detail such as wallet wrappers (",["$","code","code-1",{"children":"apple_pay"}],", ",["$","code","code-2",{"children":"google_pay"}],") and Revolut Pay funding source (",["$","code","code-3",{"children":"revolut_pay_card"}]," vs ",["$","code","code-4",{"children":"revolut_pay_account"}],")."]}]]}]]}]]}] ae3:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"OK"}]]}] ae4:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An identifier that can be used to determine what went wrong."}],"\n",["$","p","p-1",{"children":"Error codes are not globally unique, but uniqueness is guaranteed within endpoints."}]]}] ae5:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Some human readable text describing what went wrong."}]]}] ae6:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://www.unixtimestamp.com/","target":"_blank","rel":"noreferrer","children":"UNIX timestamp"}]," of the date and time the error happened."]}]]}] ae7:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unauthorized"}]]}] ae8:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An identifier that can be used to determine what went wrong."}],"\n",["$","p","p-1",{"children":"Error codes are not globally unique, but uniqueness is guaranteed within endpoints."}]]}] ae9:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Some human readable text describing what went wrong."}]]}] aea:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://www.unixtimestamp.com/","target":"_blank","rel":"noreferrer","children":"UNIX timestamp"}]," of the date and time the error happened."]}]]}] aeb:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Not Found"}]]}] aec:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["Update the value of ",["$","code","code-0",{"children":"saved_for"}]," from ",["$","code","code-1",{"children":"merchant"}]," to ",["$","code","code-2",{"children":"customer"}],"."]}],"\n",["$","p","p-1",{"children":"Once updated, this payment method can no longer be used for merchant-initiated transactions (MIT). It can only be used when the customer is present on the checkout page."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Value","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"customer"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Restrict this payment method to customer-initiated transactions only.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] aed:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Fields to update on a saved payment method."}]]}] af4:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Update the attributes of a specific saved payment method for a customer."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":["Updating ",["$","code","code-0",{"children":"saved_for"}]," to ",["$","code","code-1",{"children":"customer"}]," is a one-way operation — you can't change it back to ",["$","code","code-2",{"children":"merchant"}],"."]}],["$","p","p-1",{"children":"Once updated, this payment method can no longer be used for merchant-initiated transactions (MIT), for example, to charge recurring payments. It can only be used when the customer is on the checkout page."}],["$","p","p-2",{"children":"For more information, see:"}],["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant/2024-09-01#pay-order","target":"_blank","rel":"noreferrer","children":"Pay for an order"}]}],"\n",["$","li","li-1",{"children":["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/optimise-checkout/save-payment-methods/charge-saved-payment-method","target":"_blank","rel":"noreferrer","children":"Charge a customer's saved payment method"}]}],"\n"]}]]}]]}]]}] af5:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["This parameter accepts the ",["$","a","a-0",{"href":"https://business.revolut.com/settings/apis?tab=merchant-api","target":"_blank","rel":"noreferrer","children":"Merchant API Secret key"}]," to authorise requests coming from the merchant's backend."]}],"\n",["$","p","p-1",{"children":["It ensures that ensures that each request is authenticated and authorised by verifying the secret key. The secret key should be included in all request headers as a ",["$","code","code-0",{"children":"Bearer"}]," token."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#authentication","target":"_blank","rel":"noreferrer","children":"Authentication"}]]}]}]]}]]}] af6:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The version of the Merchant API, specified in ",["$","code","code-0",{"children":"YYYY-MM-DD"}]," format."]}],"\n",["$","p","p-1",{"children":["This endpoint is available from version ",["$","code","code-0",{"children":"2024-09-01"}],". If a version earlier than ",["$","code","code-1",{"children":"2024-09-01"}]," is provided, the endpoint returns a ",["$","code","code-2",{"children":"404"}]," response."]}],"\n",["$","p","p-2",{"children":"If not specified, you will receive an error."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information about API versioning, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/reference/versioning/api-versions","target":"_blank","rel":"noreferrer","children":"API versions"}],"."]}]}]]}]]}] af7:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A UUID string, typically used to identify resources."}]]}] af8:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ID of the ",["$","code","code-0",{"children":"Customer"}]," object."]}]]}] af9:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A UUID string, typically used to identify resources."}]]}] afa:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The ID of the payment method."}]]}] b0a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unique identifier of the dispute."}]]}] b0b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Represents the state of the dispute."}],"\n",["$","p","p-1",{"children":"It indicates either the final outcome of the dispute or if further action is required."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Parameter value","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"needs_response"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Indicates that the dispute requires a response or action from the merchant.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"under_review"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Indicates that the dispute is currently under review, and the outcome is pending.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"won"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Indicates that the dispute has been resolved in favor of the merchant.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"lost"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Indicates that the dispute has been resolved against the merchant.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] b0d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Provides additional granularity about the dispute state."}],"\n",["$","p","p-1",{"children":"It details the progression of the dispute process, showing the current stage or phase."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Parameter value","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"new"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The dispute has been recently created and is in the initial phase, awaiting further processing.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"lost_expired"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The dispute has been lost due to expiration, likely because the merchant did not respond within the required timeframe.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"pre_arbitration"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The dispute is in the pre-arbitration phase, where preliminary evidence is being gathered before a formal arbitration process.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"won_pre_arbitration"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The merchant secured a win during the pre-arbitration phase based on the evidence provided.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-4",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"lost_pre_arbitration"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The dispute was lost during the pre-arbitration phase, indicating that the preliminary review did not favor the merchant.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-5",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"lost_accepted"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The loss has been accepted as final, implying that no further contestation is likely or needed.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-6",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"arbitration"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The dispute has escalated to the arbitration stage, where a neutral third party is reviewing the evidence.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-7",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"won_arbitration"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The merchant won the dispute during the arbitration process.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-8",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"lost_arbitration"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The merchant lost the dispute during the arbitration process.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] b0e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":[["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_8601","target":"_blank","rel":"noreferrer","children":"ISO 8601"}]," date and time when the dispute was created."]}]]}] b0f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":[["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_8601","target":"_blank","rel":"noreferrer","children":"ISO 8601"}]," date and time when the dispute was last updated."]}]]}] b10:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":[["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_8601","target":"_blank","rel":"noreferrer","children":"ISO 8601"}]," date and time until when the merchant needs to respond to the dispute."]}],"\n",["$","p","p-1",{"children":"The response time by default is 15 days after the dispute is created. If no response is provided by this date, the dispute transitions to:"}],"\n",["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["$","code","code-0",{"children":"state: lost"}]}],"\n",["$","li","li-1",{"children":["$","code","code-0",{"children":"substate: lost_expired"}]}],"\n"]}]]}] bb4:["$","$L10d",null,{"security":[{"Api-Key":[]}],"authorization":{"Api-Key":{"type":"apiKey","in":"header","name":"Authorization","description":"Each Merchant API request must contain an authorization header in the following format:\n\n```\n'Authorization: Bearer '\n```\n\nTo use this API, you need to generate API keys from your Revolut Business account. The Secret key is used in the authorization header for all server calls, while the Public key is provided with payment methods at checkout.\n\n:::info\nFor detailed instructions on generating your API keys, see: [Generate API keys](https://developer.revolut.com/docs/guides/merchant/get-started#generate-api-keys).\n:::","descriptionNode":"$Lbef"}}}] bb5:["$","$L10f",null,{"exampleBlocks":{},"title":"Request body samples","headingAs":"h4"}] bb6:["$","$L110",null,{"exampleBlocks":{"200":{"application/json":{"variants":[{"key":"plans_list","label":"List of subscription plans","rawValue":"$30:props:children:0:props:children:props:responses:200:content:application/json:examples:plans_list:value","block":"$Lbf0"}],"syncedPropertyName":"$undefined"}},"400":{"application/json":{"variants":[{"key":"default","label":"Example","rawValue":{"code":"string","message":"string","timestamp":123},"block":"$Lbf1"}],"syncedPropertyName":"$undefined"}},"401":{"application/json":{"variants":[{"key":"default","label":"Example","rawValue":{"code":"string","message":"string","timestamp":123},"block":"$Lbf2"}],"syncedPropertyName":"$undefined"}},"default":{"application/json":{"variants":[{"key":"default","label":"Example","rawValue":{"code":"string","message":"string","timestamp":123},"block":"$Lbf3"}],"syncedPropertyName":"$undefined"}}},"headingAs":"h4"}] bed:["$","div",null,{"className":"ezz1n30","children":[["$","div",null,{"data-header":"$undefined","className":"ezz1n31","children":["$","div",null,{"className":"y9a0do1","children":[["$","h2",null,{"id":"retrieve-dispute-list","children":[["$Lbf4","$undefined"],["$","$L15",null,{"id":"retrieve-dispute-list"}]]}],["$","$L16",null,{"url":"/docs/api/merchant/2025-10-16/operations/retrieve-dispute-list.md"}]]}]}],"$undefined"]}] bfd:T445,
curl -X GET "https://merchant.revolut.com/api/disputes?limit=__RP_TOK_0__&from_created_date=__RP_TOK_1__&to_created_date=__RP_TOK_2__&state=__RP_TOK_3__&payment_id=__RP_TOK_4__" \
  -H "Authorization: __RP_TOK_5__" \
  -H "Revolut-Api-Version: __RP_TOK_6__"
bfe:Ta53,
fetch("https://merchant.revolut.com/api/disputes?limit=__RP_TOK_0__&from_created_date=__RP_TOK_1__&to_created_date=__RP_TOK_2__&state=__RP_TOK_3__&payment_id=__RP_TOK_4__", {
  method: "GET",
  headers: {
    "Authorization": "__RP_TOK_5__",
    "Revolut-Api-Version": "__RP_TOK_6__"
  }
})
  .then(response => response.json())
  .then(data => console.log(data));
bff:Tff0,
package main

import (
  "fmt"
  "net/http"
)

func main() {
  url := "https://merchant.revolut.com/api/disputes?limit=__RP_TOK_0__&from_created_date=__RP_TOK_1__&to_created_date=__RP_TOK_2__&state=__RP_TOK_3__&payment_id=__RP_TOK_4__"
  req, _ := http.NewRequest("GET", url, nil)
  req.Header.Add("Authorization", "__RP_TOK_5__")
  req.Header.Add("Revolut-Api-Version", "__RP_TOK_6__")

  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  fmt.Println(res)
}
c00:T865,
import requests

url = "https://merchant.revolut.com/api/disputes?limit=__RP_TOK_0__&from_created_date=__RP_TOK_1__&to_created_date=__RP_TOK_2__&state=__RP_TOK_3__&payment_id=__RP_TOK_4__"
headers = {
  "Authorization": "__RP_TOK_5__",
  "Revolut-Api-Version": "__RP_TOK_6__"
}

response = requests.get(url, headers=headers)
print(response.json())
c01:T1791,
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;

public class Main {
  public static void main(String[] args) {
    HttpClient client = HttpClient.newHttpClient();
    HttpRequest request = HttpRequest.newBuilder()
      .uri(URI.create("https://merchant.revolut.com/api/disputes?limit=__RP_TOK_0__&from_created_date=__RP_TOK_1__&to_created_date=__RP_TOK_2__&state=__RP_TOK_3__&payment_id=__RP_TOK_4__"))
      .header("Authorization", "__RP_TOK_5__")
      .header("Revolut-Api-Version", "__RP_TOK_6__")
      .GET(HttpRequest.BodyPublishers.noBody())
      .build();

    client.sendAsync(request, HttpResponse.BodyHandlers.ofString())
      .thenApply(HttpResponse::body)
      .thenAccept(System.out::println)
      .join();
  }
}
c02:T163b,
using System.Net.Http;
using System.Net.Http.Headers;

var client = new HttpClient();
var request = new HttpRequestMessage
{
  Method = HttpMethod.Get,
  RequestUri = new Uri("https://merchant.revolut.com/api/disputes?limit=__RP_TOK_0__&from_created_date=__RP_TOK_1__&to_created_date=__RP_TOK_2__&state=__RP_TOK_3__&payment_id=__RP_TOK_4__"),
  Headers =
  {
    { "Authorization", "__RP_TOK_5__" },
    { "Revolut-Api-Version", "__RP_TOK_6__" },
  }
};

using (var response = await client.SendAsync(request))
{
  response.EnsureSuccessStatusCode();
  var body = await response.Content.ReadAsStringAsync();
  Console.WriteLine(body);
}
c03:T44d,
curl -X GET "https://sandbox-merchant.revolut.com/api/disputes?limit=__RP_TOK_0__&from_created_date=__RP_TOK_1__&to_created_date=__RP_TOK_2__&state=__RP_TOK_3__&payment_id=__RP_TOK_4__" \
  -H "Authorization: __RP_TOK_5__" \
  -H "Revolut-Api-Version: __RP_TOK_6__"
c04:Ta5b,
fetch("https://sandbox-merchant.revolut.com/api/disputes?limit=__RP_TOK_0__&from_created_date=__RP_TOK_1__&to_created_date=__RP_TOK_2__&state=__RP_TOK_3__&payment_id=__RP_TOK_4__", {
  method: "GET",
  headers: {
    "Authorization": "__RP_TOK_5__",
    "Revolut-Api-Version": "__RP_TOK_6__"
  }
})
  .then(response => response.json())
  .then(data => console.log(data));
c05:Tff8,
package main

import (
  "fmt"
  "net/http"
)

func main() {
  url := "https://sandbox-merchant.revolut.com/api/disputes?limit=__RP_TOK_0__&from_created_date=__RP_TOK_1__&to_created_date=__RP_TOK_2__&state=__RP_TOK_3__&payment_id=__RP_TOK_4__"
  req, _ := http.NewRequest("GET", url, nil)
  req.Header.Add("Authorization", "__RP_TOK_5__")
  req.Header.Add("Revolut-Api-Version", "__RP_TOK_6__")

  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  fmt.Println(res)
}
c06:T86d,
import requests

url = "https://sandbox-merchant.revolut.com/api/disputes?limit=__RP_TOK_0__&from_created_date=__RP_TOK_1__&to_created_date=__RP_TOK_2__&state=__RP_TOK_3__&payment_id=__RP_TOK_4__"
headers = {
  "Authorization": "__RP_TOK_5__",
  "Revolut-Api-Version": "__RP_TOK_6__"
}

response = requests.get(url, headers=headers)
print(response.json())
c07:T1799,
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;

public class Main {
  public static void main(String[] args) {
    HttpClient client = HttpClient.newHttpClient();
    HttpRequest request = HttpRequest.newBuilder()
      .uri(URI.create("https://sandbox-merchant.revolut.com/api/disputes?limit=__RP_TOK_0__&from_created_date=__RP_TOK_1__&to_created_date=__RP_TOK_2__&state=__RP_TOK_3__&payment_id=__RP_TOK_4__"))
      .header("Authorization", "__RP_TOK_5__")
      .header("Revolut-Api-Version", "__RP_TOK_6__")
      .GET(HttpRequest.BodyPublishers.noBody())
      .build();

    client.sendAsync(request, HttpResponse.BodyHandlers.ofString())
      .thenApply(HttpResponse::body)
      .thenAccept(System.out::println)
      .join();
  }
}
c08:T1643,
using System.Net.Http;
using System.Net.Http.Headers;

var client = new HttpClient();
var request = new HttpRequestMessage
{
  Method = HttpMethod.Get,
  RequestUri = new Uri("https://sandbox-merchant.revolut.com/api/disputes?limit=__RP_TOK_0__&from_created_date=__RP_TOK_1__&to_created_date=__RP_TOK_2__&state=__RP_TOK_3__&payment_id=__RP_TOK_4__"),
  Headers =
  {
    { "Authorization", "__RP_TOK_5__" },
    { "Revolut-Api-Version", "__RP_TOK_6__" },
  }
};

using (var response = await client.SendAsync(request))
{
  response.EnsureSuccessStatusCode();
  var body = await response.Content.ReadAsStringAsync();
  Console.WriteLine(body);
}
bee:["$","div",null,{"className":"ezz1n30","children":[["$","div",null,{"data-header":"$undefined","className":"ezz1n31","children":["$Lbf5",["$","$L85",null,{"parameters":[{"name":"Authorization","in":"header","schema":{"type":"string","format":"Bearer ","examples":"$62:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:0:schema:examples"},"required":true,"description":"This parameter accepts the [Merchant API Secret key](https://business.revolut.com/settings/apis?tab=merchant-api) to authorise requests coming from the merchant's backend. \n\nIt ensures that ensures that each request is authenticated and authorised by verifying the secret key. The secret key should be included in all request headers as a `Bearer` token.\n\n:::info\nFor more information, see: [Authentication](https://developer.revolut.com/docs/api/merchant#authentication)\n:::","descriptionNode":"$Lbf6"},{"name":"Revolut-Api-Version","in":"header","schema":{"type":"string","format":"date","enum":"$36:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:1:schema:enum","examples":"$36:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:1:schema:examples"},"required":true,"description":"The version of the Merchant API, specified in `YYYY-MM-DD` format.\n\nIf not specified, you will receive an error.\n\n\n:::info\nFor more information about API versioning, see: [API versions](https://developer.revolut.com/docs/guides/merchant/reference/versioning/api-versions).\n:::","x-config-always-visible-in-example":true,"example":"2025-10-16","descriptionNode":"$Lbf7"},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":500,"default":100},"description":"Maximum number of records to return. Used for **pagination**.","required":false,"descriptionNode":"$Lbf8"},{"name":"from_created_date","in":"query","required":false,"schema":{"type":"string","format":"date-time"},"description":"Retrieve records with a `created_at` value ≥ `from_created_date`.\n\nUse the [ISO 8601 date-time format](https://en.wikipedia.org/wiki/ISO_8601): `yyyy-MM-ddTHH:mm:ss[.SSSSSS]Z`.","descriptionNode":"$Lbf9"},{"name":"to_created_date","in":"query","required":false,"schema":{"type":"string","format":"date-time"},"description":"Retrieve records with a `created_at` value ≤ `to_created_date`.\n\nUse the [ISO 8601 date-time format](https://en.wikipedia.org/wiki/ISO_8601): `yyyy-MM-ddTHH:mm:ss[.SSSSSS]Z`.","descriptionNode":"$Lbfa"},{"name":"state","in":"query","required":false,"schema":{"type":"array","items":{"type":"string","enum":["needs_response","under_review","won","lost"]}},"style":"form","explode":true,"description":"Filter disputes by state. Repeat the parameter to filter by multiple states.\n\n| Value | Description |\n|-------|-------------|\n| `needs_response` | Dispute requires your response |\n| `under_review` | Dispute is being reviewed |\n| `won` | Dispute resolved in your favour |\n| `lost` | Dispute resolved against you |\n\nThe parameter is case sensitive.","descriptionNode":"$Lbfb"},{"name":"payment_id","in":"query","required":false,"schema":{"type":"array","items":{"type":"string","format":"uuid"}},"style":"form","explode":true,"description":"Filter disputes by the ID of the associated payment. Repeat the parameter to filter by multiple payment IDs.\n\n```\nhttps://merchant.revolut.com/api/disputes?payment_id=123&payment_id=456\n```","descriptionNode":"$Lbfc"}],"requestBody":"$undefined","heading":"Request","requestBodySchemaTitle":"Request body","headingAs":"h3"}],["$","$L89",null,{"responses":"$44:props:children:0:props:children:props:responses","headingAs":"h3"}]]}],["$","div",null,{"className":"ezz1n32","children":[[["$","$L8a",null,{"itemsByServer":{"https://merchant.revolut.com":[{"id":"curl","label":"cURL","templateCode":"curl -X GET \"https://merchant.revolut.com/api/disputes?limit=__RP_TOK_0__&from_created_date=__RP_TOK_1__&to_created_date=__RP_TOK_2__&state=__RP_TOK_3__&payment_id=__RP_TOK_4__\" \\\n -H \"Authorization: __RP_TOK_5__\" \\\n -H \"Revolut-Api-Version: __RP_TOK_6__\"","templateHtml":"$bfd","tokens":[{"marker":"__RP_TOK_0__","paramName":"limit","paramIn":"query","pipeline":["url-component","shell-double-inner"]},{"marker":"__RP_TOK_1__","paramName":"from_created_date","paramIn":"query","pipeline":["url-component","shell-double-inner"]},{"marker":"__RP_TOK_2__","paramName":"to_created_date","paramIn":"query","pipeline":["url-component","shell-double-inner"]},{"marker":"__RP_TOK_3__","paramName":"state","paramIn":"query","pipeline":["url-component","shell-double-inner"]},{"marker":"__RP_TOK_4__","paramName":"payment_id","paramIn":"query","pipeline":["url-component","shell-double-inner"]},{"marker":"__RP_TOK_5__","paramName":"Authorization","paramIn":"header","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_6__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["shell-double-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","query:limit":"100","query:from_created_date":"2024-01-01T00:00:00Z","query:to_created_date":"2024-01-01T00:00:00Z","query:state":"[]","query:payment_id":"[]"}},{"id":"javascript","label":"JavaScript","templateCode":"fetch(\"https://merchant.revolut.com/api/disputes?limit=__RP_TOK_0__&from_created_date=__RP_TOK_1__&to_created_date=__RP_TOK_2__&state=__RP_TOK_3__&payment_id=__RP_TOK_4__\", {\n method: \"GET\",\n headers: {\n \"Authorization\": \"__RP_TOK_5__\",\n \"Revolut-Api-Version\": \"__RP_TOK_6__\"\n }\n})\n .then(response => response.json())\n .then(data => console.log(data));","templateHtml":"$bfe","tokens":[{"marker":"__RP_TOK_0__","paramName":"limit","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"from_created_date","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"to_created_date","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_3__","paramName":"state","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_4__","paramName":"payment_id","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_5__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_6__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","query:limit":"100","query:from_created_date":"2024-01-01T00:00:00Z","query:to_created_date":"2024-01-01T00:00:00Z","query:state":"[]","query:payment_id":"[]"}},{"id":"go","label":"Go","templateCode":"package main\n\nimport (\n \"fmt\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://merchant.revolut.com/api/disputes?limit=__RP_TOK_0__&from_created_date=__RP_TOK_1__&to_created_date=__RP_TOK_2__&state=__RP_TOK_3__&payment_id=__RP_TOK_4__\"\n req, _ := http.NewRequest(\"GET\", url, nil)\n req.Header.Add(\"Authorization\", \"__RP_TOK_5__\")\n req.Header.Add(\"Revolut-Api-Version\", \"__RP_TOK_6__\")\n\n res, _ := http.DefaultClient.Do(req)\n defer res.Body.Close()\n fmt.Println(res)\n}","templateHtml":"$bff","tokens":[{"marker":"__RP_TOK_0__","paramName":"limit","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"from_created_date","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"to_created_date","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_3__","paramName":"state","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_4__","paramName":"payment_id","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_5__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_6__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","query:limit":"100","query:from_created_date":"2024-01-01T00:00:00Z","query:to_created_date":"2024-01-01T00:00:00Z","query:state":"[]","query:payment_id":"[]"}},{"id":"python","label":"Python","templateCode":"import requests\n\nurl = \"https://merchant.revolut.com/api/disputes?limit=__RP_TOK_0__&from_created_date=__RP_TOK_1__&to_created_date=__RP_TOK_2__&state=__RP_TOK_3__&payment_id=__RP_TOK_4__\"\nheaders = {\n \"Authorization\": \"__RP_TOK_5__\",\n \"Revolut-Api-Version\": \"__RP_TOK_6__\"\n}\n\nresponse = requests.get(url, headers=headers)\nprint(response.json())","templateHtml":"$c00","tokens":[{"marker":"__RP_TOK_0__","paramName":"limit","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"from_created_date","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"to_created_date","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_3__","paramName":"state","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_4__","paramName":"payment_id","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_5__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_6__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","query:limit":"100","query:from_created_date":"2024-01-01T00:00:00Z","query:to_created_date":"2024-01-01T00:00:00Z","query:state":"[]","query:payment_id":"[]"}},{"id":"java","label":"Java","templateCode":"import java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\nimport java.net.URI;\n\npublic class Main {\n public static void main(String[] args) {\n HttpClient client = HttpClient.newHttpClient();\n HttpRequest request = HttpRequest.newBuilder()\n .uri(URI.create(\"https://merchant.revolut.com/api/disputes?limit=__RP_TOK_0__&from_created_date=__RP_TOK_1__&to_created_date=__RP_TOK_2__&state=__RP_TOK_3__&payment_id=__RP_TOK_4__\"))\n .header(\"Authorization\", \"__RP_TOK_5__\")\n .header(\"Revolut-Api-Version\", \"__RP_TOK_6__\")\n .GET(HttpRequest.BodyPublishers.noBody())\n .build();\n\n client.sendAsync(request, HttpResponse.BodyHandlers.ofString())\n .thenApply(HttpResponse::body)\n .thenAccept(System.out::println)\n .join();\n }\n}","templateHtml":"$c01","tokens":[{"marker":"__RP_TOK_0__","paramName":"limit","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"from_created_date","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"to_created_date","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_3__","paramName":"state","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_4__","paramName":"payment_id","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_5__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_6__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","query:limit":"100","query:from_created_date":"2024-01-01T00:00:00Z","query:to_created_date":"2024-01-01T00:00:00Z","query:state":"[]","query:payment_id":"[]"}},{"id":"csharp","label":"C#","templateCode":"using System.Net.Http;\nusing System.Net.Http.Headers;\n\nvar client = new HttpClient();\nvar request = new HttpRequestMessage\n{\n Method = HttpMethod.Get,\n RequestUri = new Uri(\"https://merchant.revolut.com/api/disputes?limit=__RP_TOK_0__&from_created_date=__RP_TOK_1__&to_created_date=__RP_TOK_2__&state=__RP_TOK_3__&payment_id=__RP_TOK_4__\"),\n Headers =\n {\n { \"Authorization\", \"__RP_TOK_5__\" },\n { \"Revolut-Api-Version\", \"__RP_TOK_6__\" },\n }\n};\n\nusing (var response = await client.SendAsync(request))\n{\n response.EnsureSuccessStatusCode();\n var body = await response.Content.ReadAsStringAsync();\n Console.WriteLine(body);\n}","templateHtml":"$c02","tokens":[{"marker":"__RP_TOK_0__","paramName":"limit","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"from_created_date","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"to_created_date","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_3__","paramName":"state","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_4__","paramName":"payment_id","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_5__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_6__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","query:limit":"100","query:from_created_date":"2024-01-01T00:00:00Z","query:to_created_date":"2024-01-01T00:00:00Z","query:state":"[]","query:payment_id":"[]"}}],"https://sandbox-merchant.revolut.com":[{"id":"curl","label":"cURL","templateCode":"curl -X GET \"https://sandbox-merchant.revolut.com/api/disputes?limit=__RP_TOK_0__&from_created_date=__RP_TOK_1__&to_created_date=__RP_TOK_2__&state=__RP_TOK_3__&payment_id=__RP_TOK_4__\" \\\n -H \"Authorization: __RP_TOK_5__\" \\\n -H \"Revolut-Api-Version: __RP_TOK_6__\"","templateHtml":"$c03","tokens":[{"marker":"__RP_TOK_0__","paramName":"limit","paramIn":"query","pipeline":["url-component","shell-double-inner"]},{"marker":"__RP_TOK_1__","paramName":"from_created_date","paramIn":"query","pipeline":["url-component","shell-double-inner"]},{"marker":"__RP_TOK_2__","paramName":"to_created_date","paramIn":"query","pipeline":["url-component","shell-double-inner"]},{"marker":"__RP_TOK_3__","paramName":"state","paramIn":"query","pipeline":["url-component","shell-double-inner"]},{"marker":"__RP_TOK_4__","paramName":"payment_id","paramIn":"query","pipeline":["url-component","shell-double-inner"]},{"marker":"__RP_TOK_5__","paramName":"Authorization","paramIn":"header","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_6__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["shell-double-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","query:limit":"100","query:from_created_date":"2024-01-01T00:00:00Z","query:to_created_date":"2024-01-01T00:00:00Z","query:state":"[]","query:payment_id":"[]"}},{"id":"javascript","label":"JavaScript","templateCode":"fetch(\"https://sandbox-merchant.revolut.com/api/disputes?limit=__RP_TOK_0__&from_created_date=__RP_TOK_1__&to_created_date=__RP_TOK_2__&state=__RP_TOK_3__&payment_id=__RP_TOK_4__\", {\n method: \"GET\",\n headers: {\n \"Authorization\": \"__RP_TOK_5__\",\n \"Revolut-Api-Version\": \"__RP_TOK_6__\"\n }\n})\n .then(response => response.json())\n .then(data => console.log(data));","templateHtml":"$c04","tokens":[{"marker":"__RP_TOK_0__","paramName":"limit","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"from_created_date","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"to_created_date","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_3__","paramName":"state","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_4__","paramName":"payment_id","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_5__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_6__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","query:limit":"100","query:from_created_date":"2024-01-01T00:00:00Z","query:to_created_date":"2024-01-01T00:00:00Z","query:state":"[]","query:payment_id":"[]"}},{"id":"go","label":"Go","templateCode":"package main\n\nimport (\n \"fmt\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://sandbox-merchant.revolut.com/api/disputes?limit=__RP_TOK_0__&from_created_date=__RP_TOK_1__&to_created_date=__RP_TOK_2__&state=__RP_TOK_3__&payment_id=__RP_TOK_4__\"\n req, _ := http.NewRequest(\"GET\", url, nil)\n req.Header.Add(\"Authorization\", \"__RP_TOK_5__\")\n req.Header.Add(\"Revolut-Api-Version\", \"__RP_TOK_6__\")\n\n res, _ := http.DefaultClient.Do(req)\n defer res.Body.Close()\n fmt.Println(res)\n}","templateHtml":"$c05","tokens":[{"marker":"__RP_TOK_0__","paramName":"limit","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"from_created_date","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"to_created_date","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_3__","paramName":"state","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_4__","paramName":"payment_id","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_5__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_6__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","query:limit":"100","query:from_created_date":"2024-01-01T00:00:00Z","query:to_created_date":"2024-01-01T00:00:00Z","query:state":"[]","query:payment_id":"[]"}},{"id":"python","label":"Python","templateCode":"import requests\n\nurl = \"https://sandbox-merchant.revolut.com/api/disputes?limit=__RP_TOK_0__&from_created_date=__RP_TOK_1__&to_created_date=__RP_TOK_2__&state=__RP_TOK_3__&payment_id=__RP_TOK_4__\"\nheaders = {\n \"Authorization\": \"__RP_TOK_5__\",\n \"Revolut-Api-Version\": \"__RP_TOK_6__\"\n}\n\nresponse = requests.get(url, headers=headers)\nprint(response.json())","templateHtml":"$c06","tokens":[{"marker":"__RP_TOK_0__","paramName":"limit","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"from_created_date","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"to_created_date","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_3__","paramName":"state","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_4__","paramName":"payment_id","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_5__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_6__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","query:limit":"100","query:from_created_date":"2024-01-01T00:00:00Z","query:to_created_date":"2024-01-01T00:00:00Z","query:state":"[]","query:payment_id":"[]"}},{"id":"java","label":"Java","templateCode":"import java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\nimport java.net.URI;\n\npublic class Main {\n public static void main(String[] args) {\n HttpClient client = HttpClient.newHttpClient();\n HttpRequest request = HttpRequest.newBuilder()\n .uri(URI.create(\"https://sandbox-merchant.revolut.com/api/disputes?limit=__RP_TOK_0__&from_created_date=__RP_TOK_1__&to_created_date=__RP_TOK_2__&state=__RP_TOK_3__&payment_id=__RP_TOK_4__\"))\n .header(\"Authorization\", \"__RP_TOK_5__\")\n .header(\"Revolut-Api-Version\", \"__RP_TOK_6__\")\n .GET(HttpRequest.BodyPublishers.noBody())\n .build();\n\n client.sendAsync(request, HttpResponse.BodyHandlers.ofString())\n .thenApply(HttpResponse::body)\n .thenAccept(System.out::println)\n .join();\n }\n}","templateHtml":"$c07","tokens":[{"marker":"__RP_TOK_0__","paramName":"limit","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"from_created_date","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"to_created_date","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_3__","paramName":"state","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_4__","paramName":"payment_id","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_5__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_6__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","query:limit":"100","query:from_created_date":"2024-01-01T00:00:00Z","query:to_created_date":"2024-01-01T00:00:00Z","query:state":"[]","query:payment_id":"[]"}},{"id":"csharp","label":"C#","templateCode":"using System.Net.Http;\nusing System.Net.Http.Headers;\n\nvar client = new HttpClient();\nvar request = new HttpRequestMessage\n{\n Method = HttpMethod.Get,\n RequestUri = new Uri(\"https://sandbox-merchant.revolut.com/api/disputes?limit=__RP_TOK_0__&from_created_date=__RP_TOK_1__&to_created_date=__RP_TOK_2__&state=__RP_TOK_3__&payment_id=__RP_TOK_4__\"),\n Headers =\n {\n { \"Authorization\", \"__RP_TOK_5__\" },\n { \"Revolut-Api-Version\", \"__RP_TOK_6__\" },\n }\n};\n\nusing (var response = await client.SendAsync(request))\n{\n response.EnsureSuccessStatusCode();\n var body = await response.Content.ReadAsStringAsync();\n Console.WriteLine(body);\n}","templateHtml":"$c08","tokens":[{"marker":"__RP_TOK_0__","paramName":"limit","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"from_created_date","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"to_created_date","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_3__","paramName":"state","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_4__","paramName":"payment_id","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_5__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_6__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","query:limit":"100","query:from_created_date":"2024-01-01T00:00:00Z","query:to_created_date":"2024-01-01T00:00:00Z","query:state":"[]","query:payment_id":"[]"}}]},"method":"get","servers":"$62:props:children:0:props:children:props:children:1:props:children:1:props:children:0:0:props:servers","path":"/api/disputes","parameters":["$bee:props:children:0:props:children:1:props:parameters:0","$bee:props:children:0:props:children:1:props:parameters:1","$bee:props:children:0:props:children:1:props:parameters:2","$bee:props:children:0:props:children:1:props:parameters:3","$bee:props:children:0:props:children:1:props:parameters:4","$bee:props:children:0:props:children:1:props:parameters:5","$bee:props:children:0:props:children:1:props:parameters:6"]}],"$Lc09"],"$Lc0a","$Lc0b"]}]]}] c0c:T261d,
[
  {
    "id": "63dd0e4a-42c4-a1a6-ab2c-6ac9d255ca4b",
    "token": "294358bf-3818-49b2-aacc-7ca971f52695",
    "order_id": "63dd0e3f-7b84-ab5c-927c-1a06f7c9583a",
    "state": "declined",
    "amount": 100,
    "currency": "EUR",
    "payment_method": {
      "type": "card",
      "card_brand": "visa",
      "funding": "credit",
      "card_last_four": "1234"
    }
  },
  {
    "id": "649adc44-3e86-a832-879c-2f6d0255dd4c",
    "token": "8061e645-35e0-42bb-8318-603abaeab7b7",
    "order_id": "63dd0e3f-7b84-ab5c-927c-1a06f7c9583a",
    "state": "declined",
    "amount": 100,
    "currency": "EUR",
    "decline_reason": "insufficient_funds",
    "payment_method": {
      "type": "revolut_pay",
      "subtype": "revolut_account"
    }
  },
  {
    "id": "663387f1-1c2e-a295-b143-9f1fb1eec175",
    "token": "663387f1-c91e-a464-908a-1cc4548ebc6a",
    "order_id": "63dd0e3f-7b84-ab5c-927c-1a06f7c9583a",
    "state": "pending",
    "amount": 100,
    "currency": "EUR",
    "payment_method": {
      "type": "sepa_direct_debit",
      "debtor_iban_last_four": "1234",
      "debtor_name": "John Doe",
      "mandate_reference": "A1B2C3D4E5F6A1B2C3D4E5F6A1B2C3D4"
    }
  }
]
a0a:["$","div","200-application/json-payment_list",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$c0c"}}]}]],"$Lc0d"]}] c0e:T46a,
{
  "code": "bad_request",
  "message": "Could not parse JSON",
  "timestamp": 1720528890647
}
a0b:["$","div","400-application/json-default",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$c0e"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"code\": \"bad_request\",\n \"message\": \"Could not parse JSON\",\n \"timestamp\": 1720528890647\n}"}]}]]}] c0f:T46f,
{
  "code": "unauthenticated",
  "message": "Authentication failed",
  "timestamp": 1720528890647
}
a0c:["$","div","401-application/json-default",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$c0f"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"code\": \"unauthenticated\",\n \"message\": \"Authentication failed\",\n \"timestamp\": 1720528890647\n}"}]}]]}] c10:T44d,
{
  "code": "string",
  "message": "string",
  "timestamp": 123
}
a0d:["$","div","404-application/json-default",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$c10"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"code\": \"string\",\n \"message\": \"string\",\n \"timestamp\": 123\n}"}]}]]}] c11:T177f,
{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "type": "card",
  "saved_for": "customer",
  "created_at": "2024-01-01T00:00:00Z",
  "bin": "string",
  "last_four": "aaaa",
  "expiry_month": 123,
  "expiry_year": 123,
  "cardholder_name": "string",
  "brand": "visa",
  "funding": "debit",
  "issuer": "string",
  "issuer_country": "aa",
  "billing_address": {
    "street_line_1": "string",
    "street_line_2": "string",
    "region": "string",
    "city": "string",
    "country_code": "aa",
    "postcode": "string"
  },
  "terminal_hardware_id": "string"
}
a0f:["$","div","200-application/json-default",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$c11"}}]}]],"$Lc12"]}] c13:T44d,
{
  "code": "string",
  "message": "string",
  "timestamp": 123
}
a10:["$","div","401-application/json-default",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$c13"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"code\": \"string\",\n \"message\": \"string\",\n \"timestamp\": 123\n}"}]}]]}] c14:T44d,
{
  "code": "string",
  "message": "string",
  "timestamp": 123
}
a11:["$","div","404-application/json-default",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$c14"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"code\": \"string\",\n \"message\": \"string\",\n \"timestamp\": 123\n}"}]}]]}] b45:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Each Merchant API request must contain an authorization header in the following format:"}],"\n","$Lc15","\n",["$","p","p-1",{"children":"To use this API, you need to generate API keys from your Revolut Business account. The Secret key is used in the authorization header for all server calls, while the Public key is provided with payment methods at checkout."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For detailed instructions on generating your API keys, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/get-started#generate-api-keys","target":"_blank","rel":"noreferrer","children":"Generate API keys"}],"."]}]}]]}]]}] b11:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Dispute reason code from the payment scheme, following standard formats defined by individual providers."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"For complete, official lists of dispute codes, see:"}],["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":[["$","strong","strong-0",{"children":"Visa"}],": ",["$","a","a-0",{"href":"https://corporate.visa.com/content/dam/VCOM/download/about-visa/visa-rules-public.pdf","target":"_blank","rel":"noreferrer","children":"Visa Core Rules and Visa Product and Service Rules"}]]}],"\n",["$","li","li-1",{"children":[["$","strong","strong-0",{"children":"Mastercard"}],": ",["$","a","a-0",{"href":"https://www.mastercard.com/content/dam/public/mastercardcom/na/global-site/documents/chargeback-guide.pdf","target":"_blank","rel":"noreferrer","children":"Chargeback Guide - Merchant Edition"}]]}],"\n",["$","li","li-2",{"children":[["$","strong","strong-0",{"children":"American Express"}],": ",["$","a","a-0",{"href":"https://www.americanexpress.com/content/dam/amex/au/en/merchant/static/chargebackcodeguide.pdf","target":"_blank","rel":"noreferrer","children":"Chargeback Codes"}]]}],"\n"]}]]}]]}]]}] b12:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Provides a human-readable explanation for the dispute reason codes."}]]}] b13:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["Disputed amount expressed in minor currency units, according to the ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_4217","target":"_blank","rel":"noreferrer","children":"ISO 4217 standard"}],". For example, ",["$","code","code-0",{"children":"7034"}]," in ",["$","code","code-1",{"children":"EUR"}]," corresponds to €70.34."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["Conversion between major and minor units varies by currency. For instance, ",["$","code","code-0",{"children":"100"}]," minor units equal £1.00 in ",["$","code","code-1",{"children":"GBP"}],", whereas in ",["$","code","code-2",{"children":"ISK"}]," they represent 100 units. For more details, see the ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_4217","target":"_blank","rel":"noreferrer","children":"ISO 4217 standard"}],"."]}]}]]}]]}] b14:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":[["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_4217","target":"_blank","rel":"noreferrer","children":"ISO 4217"}]," currency code in upper case."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information about the supported currencies, see: ",["$","a","a-0",{"href":"https://help.revolut.com/business/help/merchant-accounts/payments/in-which-currencies-can-i-accept-payments/","target":"_blank","rel":"noreferrer","children":"Help Center"}],"."]}]}]]}]]}] b15:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The ID of the original payment that was disputed."}]]}] b16:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The ID of the order linked to the original disputed payment."}]]}] b17:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":[["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_8601","target":"_blank","rel":"noreferrer","children":"ISO 8601"}]," date and time when the original disputed payment was created."]}]]}] b18:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Acquirer Reference Number (ARN) of the original payment."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":"Only returned for payments made by a card."}]}]]}]]}] b19:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["Amount of the original payment expressed in minor currency units, according to the ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_4217","target":"_blank","rel":"noreferrer","children":"ISO 4217 standard"}],". For example, ",["$","code","code-0",{"children":"7034"}]," in ",["$","code","code-1",{"children":"EUR"}]," corresponds to €70.34."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["Conversion between major and minor units varies by currency. For instance, ",["$","code","code-0",{"children":"100"}]," minor units equal £1.00 in ",["$","code","code-1",{"children":"GBP"}],", whereas in ",["$","code","code-2",{"children":"ISK"}]," they represent 100 units. For more details, see the ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_4217","target":"_blank","rel":"noreferrer","children":"ISO 4217 standard"}],"."]}]}]]}]]}] b1a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":[["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_4217","target":"_blank","rel":"noreferrer","children":"ISO 4217"}]," currency code in upper case."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information about the supported currencies, see: ",["$","a","a-0",{"href":"https://help.revolut.com/business/help/merchant-accounts/payments/in-which-currencies-can-i-accept-payments/","target":"_blank","rel":"noreferrer","children":"Help Center"}],"."]}]}]]}]]}] b1b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Type of the payment method used for the original payment."}],"\n",["$","p","p-1",{"children":"Available values:"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":["Payment method ",["$","code","code-0",{"children":"type"}]],"className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"apple_pay"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using Apple Pay.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"apple_tap_to_pay"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using Apple Tap to Pay.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"card"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using their credit or debit card.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"google_pay"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using Google Pay.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-4",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"revolut_pay_card"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order via Revolut Pay using their credit or debit card.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-5",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"revolut_pay_account"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order via Revolut Pay using their Revolut account.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-6",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"sepa_direct_debit"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order via SEPA Direct Debit.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] b1c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The brand of the payment card."}]]}] b1d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The last four digits of the payment card number."}]]}] b1e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object containing details of a card used via Apple Pay."}]]}] b1f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Type of the payment method used for the original payment."}],"\n",["$","p","p-1",{"children":"Available values:"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":["Payment method ",["$","code","code-0",{"children":"type"}]],"className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"apple_pay"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using Apple Pay.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"apple_tap_to_pay"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using Apple Tap to Pay.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"card"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using their credit or debit card.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"google_pay"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using Google Pay.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-4",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"revolut_pay_card"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order via Revolut Pay using their credit or debit card.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-5",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"revolut_pay_account"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order via Revolut Pay using their Revolut account.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-6",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"sepa_direct_debit"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order via SEPA Direct Debit.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] b20:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object containing details of a payment made via Apple Tap to Pay."}]]}] b21:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Type of the payment method used for the original payment."}],"\n",["$","p","p-1",{"children":"Available values:"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":["Payment method ",["$","code","code-0",{"children":"type"}]],"className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"apple_pay"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using Apple Pay.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"apple_tap_to_pay"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using Apple Tap to Pay.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"card"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using their credit or debit card.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"google_pay"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using Google Pay.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-4",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"revolut_pay_card"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order via Revolut Pay using their credit or debit card.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-5",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"revolut_pay_account"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order via Revolut Pay using their Revolut account.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-6",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"sepa_direct_debit"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order via SEPA Direct Debit.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] b22:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The brand of the payment card."}]]}] b23:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The last four digits of the payment card number."}]]}] b24:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object containing details of the card used for the payment."}]]}] b25:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Type of the payment method used for the original payment."}],"\n",["$","p","p-1",{"children":"Available values:"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":["Payment method ",["$","code","code-0",{"children":"type"}]],"className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"apple_pay"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using Apple Pay.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"apple_tap_to_pay"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using Apple Tap to Pay.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"card"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using their credit or debit card.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"google_pay"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using Google Pay.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-4",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"revolut_pay_card"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order via Revolut Pay using their credit or debit card.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-5",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"revolut_pay_account"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order via Revolut Pay using their Revolut account.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-6",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"sepa_direct_debit"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order via SEPA Direct Debit.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] b26:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The brand of the payment card."}]]}] b27:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The last four digits of the payment card number."}]]}] b28:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object containing details of a card used via Google Pay."}]]}] b29:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Type of the payment method used for the original payment."}],"\n",["$","p","p-1",{"children":"Available values:"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":["Payment method ",["$","code","code-0",{"children":"type"}]],"className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"apple_pay"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using Apple Pay.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"apple_tap_to_pay"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using Apple Tap to Pay.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"card"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using their credit or debit card.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"google_pay"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using Google Pay.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-4",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"revolut_pay_card"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order via Revolut Pay using their credit or debit card.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-5",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"revolut_pay_account"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order via Revolut Pay using their Revolut account.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-6",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"sepa_direct_debit"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order via SEPA Direct Debit.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] b2a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object containing details of a payment made via Revolut Pay account."}]]}] b2b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Type of the payment method used for the original payment."}],"\n",["$","p","p-1",{"children":"Available values:"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":["Payment method ",["$","code","code-0",{"children":"type"}]],"className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"apple_pay"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using Apple Pay.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"apple_tap_to_pay"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using Apple Tap to Pay.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"card"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using their credit or debit card.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"google_pay"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using Google Pay.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-4",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"revolut_pay_card"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order via Revolut Pay using their credit or debit card.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-5",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"revolut_pay_account"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order via Revolut Pay using their Revolut account.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-6",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"sepa_direct_debit"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order via SEPA Direct Debit.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] b2c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The brand of the payment card."}]]}] b2d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The last four digits of the payment card number."}]]}] b2e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object containing details of a card used via Revolut Pay."}]]}] b2f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Type of the payment method used for the original payment."}],"\n",["$","p","p-1",{"children":"Available values:"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":["Payment method ",["$","code","code-0",{"children":"type"}]],"className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"apple_pay"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using Apple Pay.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"apple_tap_to_pay"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using Apple Tap to Pay.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"card"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using their credit or debit card.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"google_pay"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using Google Pay.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-4",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"revolut_pay_card"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order via Revolut Pay using their credit or debit card.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-5",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"revolut_pay_account"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order via Revolut Pay using their Revolut account.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-6",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"sepa_direct_debit"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order via SEPA Direct Debit.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] b30:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The last four digits of the debtor's IBAN."}]]}] b31:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The full name of the debtor as provided in the mandate."}]]}] b32:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The unique mandate reference generated by Revolut. Include this in pre-debit notifications sent to your customers."}]]}] b33:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object containing details of a SEPA Direct Debit payment."}]]}] b34:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Payment method used for the original payment."}],"\n",["$","p","p-1",{"children":["Use the ",["$","code","code-0",{"children":"type"}]," field to determine the specific payment method variant."]}]]}] b35:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object containing the details of the original payment associated with the dispute."}]]}] b36:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Successful response"}]]}] b37:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An identifier that can be used to determine what went wrong."}],"\n",["$","p","p-1",{"children":"Error codes are not globally unique, but uniqueness is guaranteed within endpoints."}]]}] b38:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Some human readable text describing what went wrong."}]]}] b39:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://www.unixtimestamp.com/","target":"_blank","rel":"noreferrer","children":"UNIX timestamp"}]," of the date and time the error happened."]}]]}] b3a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Bad Request"}]]}] b3b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An identifier that can be used to determine what went wrong."}],"\n",["$","p","p-1",{"children":"Error codes are not globally unique, but uniqueness is guaranteed within endpoints."}]]}] b3c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Some human readable text describing what went wrong."}]]}] b3d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://www.unixtimestamp.com/","target":"_blank","rel":"noreferrer","children":"UNIX timestamp"}]," of the date and time the error happened."]}]]}] b3e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unauthorized"}]]}] b3f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An identifier that can be used to determine what went wrong."}],"\n",["$","p","p-1",{"children":"Error codes are not globally unique, but uniqueness is guaranteed within endpoints."}]]}] b40:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Some human readable text describing what went wrong."}]]}] b41:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://www.unixtimestamp.com/","target":"_blank","rel":"noreferrer","children":"UNIX timestamp"}]," of the date and time the error happened."]}]]}] b42:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Not Found"}]]}] b4b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Retrieve the details of a specific dispute by its ID."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["This endpoint is only available in ",["$","strong","strong-0",{"children":"Production"}]," environment."]}]}]]}]]}] b4c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["This parameter accepts the ",["$","a","a-0",{"href":"https://business.revolut.com/settings/apis?tab=merchant-api","target":"_blank","rel":"noreferrer","children":"Merchant API Secret key"}]," to authorise requests coming from the merchant's backend."]}],"\n",["$","p","p-1",{"children":["It ensures that ensures that each request is authenticated and authorised by verifying the secret key. The secret key should be included in all request headers as a ",["$","code","code-0",{"children":"Bearer"}]," token."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#authentication","target":"_blank","rel":"noreferrer","children":"Authentication"}]]}]}]]}]]}] b4d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The version of the Merchant API, specified in ",["$","code","code-0",{"children":"YYYY-MM-DD"}]," format."]}],"\n",["$","p","p-1",{"children":"If not specified, you will receive an error."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information about API versioning, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/reference/versioning/api-versions","target":"_blank","rel":"noreferrer","children":"API versions"}],"."]}]}]]}]]}] b4e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A UUID string, typically used to identify resources."}]]}] b4f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ID of the ",["$","code","code-0",{"children":"Dispute"}]," object."]}]]}] c09:["$","$L10d",null,{"security":[{"Api-Key":[]}],"authorization":{"Api-Key":{"type":"apiKey","in":"header","name":"Authorization","description":"Each Merchant API request must contain an authorization header in the following format:\n\n```\n'Authorization: Bearer '\n```\n\nTo use this API, you need to generate API keys from your Revolut Business account. The Secret key is used in the authorization header for all server calls, while the Public key is provided with payment methods at checkout.\n\n:::info\nFor detailed instructions on generating your API keys, see: [Generate API keys](https://developer.revolut.com/docs/guides/merchant/get-started#generate-api-keys).\n:::","descriptionNode":"$Lc16"}}}] c0a:["$","$L10f",null,{"exampleBlocks":{},"title":"Request body samples","headingAs":"h4"}] c0b:["$","$L110",null,{"exampleBlocks":{"200":{"application/json":{"variants":[{"key":"dispute_list","label":"List of disputes","rawValue":"$44:props:children:0:props:children:props:responses:200:content:application/json:examples:dispute_list:value","block":"$Lc17"}],"syncedPropertyName":"$undefined"}},"400":{"application/json":{"variants":[{"key":"default","label":"default","rawValue":"$44:props:children:0:props:children:props:responses:400:content:application/json:examples:default:value","block":"$Lc18"}],"syncedPropertyName":"$undefined"}},"401":{"application/json":{"variants":[{"key":"default","label":"default","rawValue":"$44:props:children:0:props:children:props:responses:401:content:application/json:examples:default:value","block":"$Lc19"}],"syncedPropertyName":"$undefined"}}},"headingAs":"h4"}] c1a:T49d,[ { "id": "63dd0e4a-42c4-a1a6-ab2c-6ac9d255ca4b", "token": "294358bf-3818-49b2-aacc-7ca971f52695", "order_id": "63dd0e3f-7b84-ab5c-927c-1a06f7c9583a", "state": "declined", "amount": 100, "currency": "EUR", "payment_method": { "type": "card", "card_brand": "visa", "funding": "credit", "card_last_four": "1234" } }, { "id": "649adc44-3e86-a832-879c-2f6d0255dd4c", "token": "8061e645-35e0-42bb-8318-603abaeab7b7", "order_id": "63dd0e3f-7b84-ab5c-927c-1a06f7c9583a", "state": "declined", "amount": 100, "currency": "EUR", "decline_reason": "insufficient_funds", "payment_method": { "type": "revolut_pay", "subtype": "revolut_account" } }, { "id": "663387f1-1c2e-a295-b143-9f1fb1eec175", "token": "663387f1-c91e-a464-908a-1cc4548ebc6a", "order_id": "63dd0e3f-7b84-ab5c-927c-1a06f7c9583a", "state": "pending", "amount": 100, "currency": "EUR", "payment_method": { "type": "sepa_direct_debit", "debtor_iban_last_four": "1234", "debtor_name": "John Doe", "mandate_reference": "A1B2C3D4E5F6A1B2C3D4E5F6A1B2C3D4" } } ]c0d:["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"$c1a"}]}] c12:["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"id\": \"123e4567-e89b-12d3-a456-426614174000\",\n \"type\": \"card\",\n \"saved_for\": \"customer\",\n \"created_at\": \"2024-01-01T00:00:00Z\",\n \"bin\": \"string\",\n \"last_four\": \"aaaa\",\n \"expiry_month\": 123,\n \"expiry_year\": 123,\n \"cardholder_name\": \"string\",\n \"brand\": \"visa\",\n \"funding\": \"debit\",\n \"issuer\": \"string\",\n \"issuer_country\": \"aa\",\n \"billing_address\": {\n \"street_line_1\": \"string\",\n \"street_line_2\": \"string\",\n \"region\": \"string\",\n \"city\": \"string\",\n \"country_code\": \"aa\",\n \"postcode\": \"string\"\n },\n \"terminal_hardware_id\": \"string\"\n}"}]}] a12:["$","div","CodeBlock-0",{"className":"wzy01m0 _18b50nc0","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"
'Authorization: Bearer <yourSecretApiKey>'
"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"'Authorization: Bearer '\n"}]}]]}] 25:["$","$7a","retrieve-customer",{"children":[["$","section",null,{"className":"y9a0do0","data-variant":"endpoint","children":["$","$L7b",null,{"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"title":"Customer","type":"object","description":"A customer object.","properties":{"id":{"type":"string","format":"uuid","description":"Unique identifier for the customer.","descriptionNode":"$Lc1b"},"full_name":{"type":"string","description":"The full name of the customer.","descriptionNode":"$Lc1c"},"email":{"type":"string","format":"email","description":"The email address of the customer.","descriptionNode":"$Lc1d"},"phone":{"type":"string","description":"The phone number of the customer in [E.164 format](https://en.wikipedia.org/wiki/E.164).","descriptionNode":"$Lc1e"},"created_at":{"type":"string","format":"date-time","description":"The date and time the customer was created.","descriptionNode":"$Lc1f"},"updated_at":{"type":"string","format":"date-time","description":"The date and time the customer was last updated.","descriptionNode":"$Lc20"},"payment_methods":{"type":"array","description":"Saved payment methods associated with this customer. Each entry represents a\npayment method authorised for future charges. Two types are supported: `card`\n(with full card details) and `revolut_pay` (covers both card-backed and\naccount-to-account Revolut Pay variants). Use the `type` field on each item\nto identify the variant.","items":{"title":"Payment method","description":"A saved payment method on a customer profile.\n\nUse the `type` field to determine the specific payment method variant.\n\n:::note\nThis schema represents a stored credential available for future charges and supports three types: `card`, `revolut_pay`, and `sepa_direct_debit`.\n\nIt differs from the `payment_method` object on a Payment, which is a transactional snapshot of how a specific charge was executed and includes additional detail such as wallet wrappers (`apple_pay`, `google_pay`) and Revolut Pay funding source (`revolut_pay_card` vs `revolut_pay_account`).\n:::","discriminator":"$29:props:children:0:props:children:props:responses:200:content:application/json:schema:discriminator","oneOf":[{"title":"Card payment method","type":"object","description":"A saved card payment method.\n\n:::info\nThe `checks` object (3DS, CVV, address verification) is not included as it is specific to the transactional payment context.\n:::","properties":{"id":{"type":"string","format":"uuid","description":"Unique identifier for the payment method.","descriptionNode":"$Lc21"},"type":{"type":"string","description":"The type of the payment method.","enum":"$29:props:children:0:props:children:props:responses:200:content:application/json:schema:oneOf:0:properties:type:enum","descriptionNode":"$Lc22"},"saved_for":{"type":"string","enum":"$29:props:children:0:props:children:props:responses:200:content:application/json:schema:oneOf:0:properties:saved_for:enum","description":"Indicates in which case this saved payment method can be used for payments.\n\n| Value | Description |\n| ----- | ----------- |\n| `customer` | This payment method can be used only when the customer is on the checkout page. |\n| `merchant` | This payment method can be used without the customer being on the checkout page, and the merchant can initiate transactions, for example, to take payments for recurring transactions. |","descriptionNode":"$Lc23"},"created_at":{"type":"string","format":"date-time","description":"The date and time the payment method was added.","descriptionNode":"$Lc24"},"bin":{"type":"string","description":"The BIN (Bank Identification Number) of the payment card, typically the first 6-8 digits.","descriptionNode":"$Lc25"},"last_four":{"type":"string","minLength":4,"maxLength":4,"description":"The last four digits of the payment card number.","descriptionNode":"$Lc26"},"expiry_month":{"type":"integer","description":"The expiry month of the payment card.","descriptionNode":"$Lc27"},"expiry_year":{"type":"integer","description":"The expiry year of the payment card.","descriptionNode":"$Lc28"},"cardholder_name":{"type":"string","description":"The name of the cardholder as it appears on the card.","descriptionNode":"$Lc29"},"brand":{"type":"string","description":"The brand of the payment card.","enum":"$29:props:children:0:props:children:props:responses:200:content:application/json:schema:oneOf:0:properties:brand:enum","descriptionNode":"$Lc2a"},"funding":{"type":"string","description":"The funding type of the payment card.","enum":"$29:props:children:0:props:children:props:responses:200:content:application/json:schema:oneOf:0:properties:funding:enum","descriptionNode":"$Lc2b"},"issuer":{"type":"string","description":"The name of the card-issuing bank or institution.","descriptionNode":"$Lc2c"},"issuer_country":{"type":"string","minLength":2,"maxLength":2,"description":"The ISO 3166-1 alpha-2 country code of the country where the payment card was issued.","descriptionNode":"$Lc2d"},"billing_address":{"title":"Billing address","type":"object","description":"The billing address associated with the payment method.","properties":{"street_line_1":{"type":"string","description":"Primary address line.","maxLength":100,"descriptionNode":"$Lc2e"},"street_line_2":{"type":"string","description":"Secondary address line, such as floor and apartment number.","maxLength":100,"descriptionNode":"$Lc2f"},"region":{"type":"string","description":"State or province of the address.","maxLength":100,"descriptionNode":"$Lc30"},"city":{"type":"string","description":"City of the address.","maxLength":100,"descriptionNode":"$Lc31"},"country_code":{"type":"string","pattern":"^[A-Z]{2}$","description":"ISO 2-letter country code.","minLength":2,"maxLength":2,"descriptionNode":"$Lc32"},"postcode":{"type":"string","description":"Postal code of the address.","maxLength":100,"descriptionNode":"$Lc33"}},"required":"$29:props:children:0:props:children:props:responses:200:content:application/json:schema:oneOf:0:properties:billing_address:required","descriptionNode":"$Lc34"},"terminal_hardware_id":{"type":"string","description":"The hardware identifier of the Revolut Terminal device used to process the payment.\n\n:::note\nOnly present for card-present transactions processed via Revolut Terminal.\n:::","descriptionNode":"$Lc35"}},"required":"$29:props:children:0:props:children:props:responses:200:content:application/json:schema:oneOf:0:required","descriptionNode":"$Lc36"},{"title":"Revolut Pay payment method","type":"object","description":"A saved Revolut Pay payment method on a customer profile.\n\nBoth Revolut Pay card-backed and account-to-account (A2A) variants are\nrepresented by this single type at the saved payment method level.\nNo underlying card details are exposed here; use the order-level\n`payments[].payment_method` object (types `revolut_pay_card` /\n`revolut_pay_account`) for per-transaction details.","properties":{"id":{"type":"string","format":"uuid","description":"Unique identifier for the payment method.","descriptionNode":"$Lc37"},"type":{"type":"string","description":"The type of the payment method.","enum":"$29:props:children:0:props:children:props:responses:200:content:application/json:schema:oneOf:0:properties:type:enum","descriptionNode":"$Lc38"},"saved_for":{"type":"string","enum":"$29:props:children:0:props:children:props:responses:200:content:application/json:schema:oneOf:0:properties:saved_for:enum","description":"Indicates in which case this saved payment method can be used for payments.\n\n| Value | Description |\n| ----- | ----------- |\n| `customer` | This payment method can be used only when the customer is on the checkout page. |\n| `merchant` | This payment method can be used without the customer being on the checkout page, and the merchant can initiate transactions, for example, to take payments for recurring transactions. |","descriptionNode":"$Lc39"},"created_at":{"type":"string","format":"date-time","description":"The date and time the payment method was added.","descriptionNode":"$Lc3a"}},"required":"$29:props:children:0:props:children:props:responses:200:content:application/json:schema:oneOf:1:required","descriptionNode":"$Lc3b"},{"title":"SEPA Direct Debit payment method","type":"object","description":"A saved SEPA Direct Debit payment method on a customer profile.\n\n:::info\nFor more information, see: [SEPA Direct Debit server-to-server integration](https://developer.revolut.com/docs/guides/merchant/accept-payments/payment-methods/sepa-direct-debit/server-to-server)\n:::","properties":{"id":{"type":"string","format":"uuid","description":"Unique identifier for the payment method.","descriptionNode":"$Lc3c"},"type":{"type":"string","description":"The type of the payment method.","enum":"$29:props:children:0:props:children:props:responses:200:content:application/json:schema:oneOf:0:properties:type:enum","descriptionNode":"$Lc3d"},"saved_for":{"type":"string","enum":"$29:props:children:0:props:children:props:responses:200:content:application/json:schema:oneOf:0:properties:saved_for:enum","description":"Indicates in which case this saved payment method can be used for payments.\n\n| Value | Description |\n| ----- | ----------- |\n| `customer` | This payment method can be used only when the customer is on the checkout page. |\n| `merchant` | This payment method can be used without the customer being on the checkout page, and the merchant can initiate transactions, for example, to take payments for recurring transactions. |","descriptionNode":"$Lc3e"},"debtor_iban_last_four":{"type":"string","description":"The last four digits of the debtor's IBAN.","minLength":4,"maxLength":4,"descriptionNode":"$Lc3f"},"debtor_name":{"type":"string","description":"The full name of the debtor as provided in the mandate.","descriptionNode":"$Lc40"},"mandate_reference":{"type":"string","description":"The unique mandate reference generated by Revolut. Include this in pre-debit notifications sent to your customers.","descriptionNode":"$Lc41"},"billing_address":{"title":"Billing address","type":"object","description":"The billing address associated with the payment method.","properties":{"street_line_1":"$25:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_methods:items:oneOf:0:properties:billing_address:properties:street_line_1","street_line_2":"$25:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_methods:items:oneOf:0:properties:billing_address:properties:street_line_2","region":"$25:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_methods:items:oneOf:0:properties:billing_address:properties:region","city":"$25:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_methods:items:oneOf:0:properties:billing_address:properties:city","country_code":"$25:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_methods:items:oneOf:0:properties:billing_address:properties:country_code","postcode":"$25:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_methods:items:oneOf:0:properties:billing_address:properties:postcode"},"required":"$29:props:children:0:props:children:props:responses:200:content:application/json:schema:oneOf:0:properties:billing_address:required","descriptionNode":"$Lc42"},"created_at":{"type":"string","format":"date-time","description":"The date and time the payment method was added.","descriptionNode":"$Lc43"}},"required":"$29:props:children:0:props:children:props:responses:200:content:application/json:schema:oneOf:2:required","descriptionNode":"$Lc44"}],"descriptionNode":"$Lc45"},"descriptionNode":"$Lc46"}},"required":["id","created_at","updated_at","email","payment_methods"],"descriptionNode":"$Lc47"},"examples":{"retrieved_customer":{"summary":"Customer","value":{"id":"6c7c97a8-cfc1-4cf3-8b38-26a74fdf1fae","full_name":"Example Customer","email":"example.customer@example.com","phone":"+441234567890","created_at":"2020-06-24T12:03:39.979397Z","updated_at":"2020-06-25T10:03:39.134417Z","payment_methods":[{"id":"648334a8-9546-a983-a81a-efc6d5bdd0be","type":"revolut_pay","saved_for":"merchant","created_at":"2023-06-09T14:18:16.577888Z"},{"id":"edef3ba4-60a0-4df3-8f12-e5fc858c2420","type":"card","saved_for":"customer","created_at":"2023-03-24T14:15:22Z","bin":"459765","last_four":"6578","expiry_month":2,"expiry_year":2025,"cardholder_name":"Example Customer","brand":"visa","funding":"debit","issuer":"EXAMPLE ISSUER","issuer_country":"GB","billing_address":{"street_line_1":"7 Westferry Circus","street_line_2":"Columbus Building","postcode":"E144HD","city":"London","region":"Greater London","country_code":"GB"}},{"id":"6a0fe961-a961-a8b6-ad17-ab2779165a82","type":"sepa_direct_debit","saved_for":"merchant","created_at":"2026-05-22T05:28:01.887482Z","debtor_iban_last_four":"3273","debtor_name":"John Doe","mandate_reference":"69F1CB61BD99A32C8E20D7FB9E21E146","billing_address":{"street_line_1":"Bank of England","street_line_2":"Threadneedle St","postcode":"EC2R 8AH","city":"London","region":"Greater London","country_code":"GB"}}]}}}}},"descriptionNode":"$Lc48"},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"code":{"type":"string","description":"An identifier that can be used to determine what went wrong.\n\nError codes are not globally unique, but uniqueness is guaranteed within endpoints.","descriptionNode":"$Lc49"},"message":{"type":"string","description":"Some human readable text describing what went wrong.","descriptionNode":"$Lc4a"},"timestamp":{"type":"integer","description":"The [UNIX timestamp](https://www.unixtimestamp.com/) of the date and time the error happened.","descriptionNode":"$Lc4b"}}}}},"descriptionNode":"$Lc4c"},"404":{"description":"Not Found","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"code":{"type":"string","description":"An identifier that can be used to determine what went wrong.\n\nError codes are not globally unique, but uniqueness is guaranteed within endpoints.","descriptionNode":"$Lc4d"},"message":{"type":"string","description":"Some human readable text describing what went wrong.","descriptionNode":"$Lc4e"},"timestamp":{"type":"integer","description":"The [UNIX timestamp](https://www.unixtimestamp.com/) of the date and time the error happened.","descriptionNode":"$Lc4f"}}}}},"descriptionNode":"$Lc50"}},"requestBody":"$undefined","variantLabels":[],"children":["$Lc51","$Lc52"]}]}],false]}] b60:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Each Merchant API request must contain an authorization header in the following format:"}],"\n","$Lc53","\n",["$","p","p-1",{"children":"To use this API, you need to generate API keys from your Revolut Business account. The Secret key is used in the authorization header for all server calls, while the Public key is provided with payment methods at checkout."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For detailed instructions on generating your API keys, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/get-started#generate-api-keys","target":"_blank","rel":"noreferrer","children":"Generate API keys"}],"."]}]}]]}]]}] ba0:"Retrieve a subscription plan list" c51:["$","div",null,{"className":"ezz1n30","children":[["$","div",null,{"data-header":"$undefined","className":"ezz1n31","children":["$","div",null,{"className":"y9a0do1","children":[["$","h2",null,{"id":"retrieve-customer","children":[["$Lc54","$undefined"],["$","$L15",null,{"id":"retrieve-customer"}]]}],["$","$L16",null,{"url":"/docs/api/merchant/2025-10-16/operations/retrieve-customer.md"}]]}]}],"$undefined"]}] c5a:T9d3,
fetch("https://merchant.revolut.com/api/customers/__RP_TOK_0__", {
  method: "GET",
  headers: {
    "Authorization": "__RP_TOK_1__",
    "Revolut-Api-Version": "__RP_TOK_2__"
  }
})
  .then(response => response.json())
  .then(data => console.log(data));
c5b:Tf70,
package main

import (
  "fmt"
  "net/http"
)

func main() {
  url := "https://merchant.revolut.com/api/customers/__RP_TOK_0__"
  req, _ := http.NewRequest("GET", url, nil)
  req.Header.Add("Authorization", "__RP_TOK_1__")
  req.Header.Add("Revolut-Api-Version", "__RP_TOK_2__")

  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  fmt.Println(res)
}
c5c:T7e5,
import requests

url = "https://merchant.revolut.com/api/customers/__RP_TOK_0__"
headers = {
  "Authorization": "__RP_TOK_1__",
  "Revolut-Api-Version": "__RP_TOK_2__"
}

response = requests.get(url, headers=headers)
print(response.json())
c5d:T1711,
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;

public class Main {
  public static void main(String[] args) {
    HttpClient client = HttpClient.newHttpClient();
    HttpRequest request = HttpRequest.newBuilder()
      .uri(URI.create("https://merchant.revolut.com/api/customers/__RP_TOK_0__"))
      .header("Authorization", "__RP_TOK_1__")
      .header("Revolut-Api-Version", "__RP_TOK_2__")
      .GET(HttpRequest.BodyPublishers.noBody())
      .build();

    client.sendAsync(request, HttpResponse.BodyHandlers.ofString())
      .thenApply(HttpResponse::body)
      .thenAccept(System.out::println)
      .join();
  }
}
c5e:T15bb,
using System.Net.Http;
using System.Net.Http.Headers;

var client = new HttpClient();
var request = new HttpRequestMessage
{
  Method = HttpMethod.Get,
  RequestUri = new Uri("https://merchant.revolut.com/api/customers/__RP_TOK_0__"),
  Headers =
  {
    { "Authorization", "__RP_TOK_1__" },
    { "Revolut-Api-Version", "__RP_TOK_2__" },
  }
};

using (var response = await client.SendAsync(request))
{
  response.EnsureSuccessStatusCode();
  var body = await response.Content.ReadAsStringAsync();
  Console.WriteLine(body);
}
c5f:T9db,
fetch("https://sandbox-merchant.revolut.com/api/customers/__RP_TOK_0__", {
  method: "GET",
  headers: {
    "Authorization": "__RP_TOK_1__",
    "Revolut-Api-Version": "__RP_TOK_2__"
  }
})
  .then(response => response.json())
  .then(data => console.log(data));
c60:Tf78,
package main

import (
  "fmt"
  "net/http"
)

func main() {
  url := "https://sandbox-merchant.revolut.com/api/customers/__RP_TOK_0__"
  req, _ := http.NewRequest("GET", url, nil)
  req.Header.Add("Authorization", "__RP_TOK_1__")
  req.Header.Add("Revolut-Api-Version", "__RP_TOK_2__")

  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  fmt.Println(res)
}
c61:T7ed,
import requests

url = "https://sandbox-merchant.revolut.com/api/customers/__RP_TOK_0__"
headers = {
  "Authorization": "__RP_TOK_1__",
  "Revolut-Api-Version": "__RP_TOK_2__"
}

response = requests.get(url, headers=headers)
print(response.json())
c62:T1719,
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;

public class Main {
  public static void main(String[] args) {
    HttpClient client = HttpClient.newHttpClient();
    HttpRequest request = HttpRequest.newBuilder()
      .uri(URI.create("https://sandbox-merchant.revolut.com/api/customers/__RP_TOK_0__"))
      .header("Authorization", "__RP_TOK_1__")
      .header("Revolut-Api-Version", "__RP_TOK_2__")
      .GET(HttpRequest.BodyPublishers.noBody())
      .build();

    client.sendAsync(request, HttpResponse.BodyHandlers.ofString())
      .thenApply(HttpResponse::body)
      .thenAccept(System.out::println)
      .join();
  }
}
c63:T15c3,
using System.Net.Http;
using System.Net.Http.Headers;

var client = new HttpClient();
var request = new HttpRequestMessage
{
  Method = HttpMethod.Get,
  RequestUri = new Uri("https://sandbox-merchant.revolut.com/api/customers/__RP_TOK_0__"),
  Headers =
  {
    { "Authorization", "__RP_TOK_1__" },
    { "Revolut-Api-Version", "__RP_TOK_2__" },
  }
};

using (var response = await client.SendAsync(request))
{
  response.EnsureSuccessStatusCode();
  var body = await response.Content.ReadAsStringAsync();
  Console.WriteLine(body);
}
c52:["$","div",null,{"className":"ezz1n30","children":[["$","div",null,{"data-header":"$undefined","className":"ezz1n31","children":["$Lc55",["$","$L85",null,{"parameters":[{"name":"Authorization","in":"header","schema":{"type":"string","format":"Bearer ","examples":"$62:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:0:schema:examples"},"required":true,"description":"This parameter accepts the [Merchant API Secret key](https://business.revolut.com/settings/apis?tab=merchant-api) to authorise requests coming from the merchant's backend. \n\nIt ensures that ensures that each request is authenticated and authorised by verifying the secret key. The secret key should be included in all request headers as a `Bearer` token.\n\n:::info\nFor more information, see: [Authentication](https://developer.revolut.com/docs/api/merchant#authentication)\n:::","descriptionNode":"$Lc56"},{"name":"Revolut-Api-Version","in":"header","schema":{"type":"string","format":"date","enum":"$27:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:1:schema:enum","examples":"$27:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:1:schema:examples"},"required":true,"description":"The version of the Merchant API, specified in `YYYY-MM-DD` format.\n\nThis endpoint is available from version `2024-09-01`. If a version earlier than `2024-09-01` is provided, the endpoint returns a `404` response.\n\nIf not specified, you will receive an error.\n\n\n:::info\nFor more information about API versioning, see: [API versions](https://developer.revolut.com/docs/guides/merchant/reference/versioning/api-versions).\n:::","x-config-always-visible-in-example":true,"example":"2025-10-16","descriptionNode":"$Lc57"},{"name":"customer_id","in":"path","schema":{"type":"string","format":"uuid","description":"A UUID string, typically used to identify resources.","descriptionNode":"$Lc58"},"required":true,"description":"The ID of the `Customer` object.","descriptionNode":"$Lc59"}],"requestBody":"$undefined","heading":"Request","requestBodySchemaTitle":"Request body","headingAs":"h3"}],["$","$L89",null,{"responses":"$25:props:children:0:props:children:props:responses","headingAs":"h3"}]]}],["$","div",null,{"className":"ezz1n32","children":[[["$","$L8a",null,{"itemsByServer":{"https://merchant.revolut.com":[{"id":"curl","label":"cURL","templateCode":"curl -X GET \"https://merchant.revolut.com/api/customers/__RP_TOK_0__\" \\\n -H \"Authorization: __RP_TOK_1__\" \\\n -H \"Revolut-Api-Version: __RP_TOK_2__\"","templateHtml":"
curl -X GET \"https://merchant.revolut.com/api/customers/__RP_TOK_0__\" \\\n  -H \"Authorization: __RP_TOK_1__\" \\\n  -H \"Revolut-Api-Version: __RP_TOK_2__\"
","tokens":[{"marker":"__RP_TOK_0__","paramName":"customer_id","paramIn":"path","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["shell-double-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:customer_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"javascript","label":"JavaScript","templateCode":"fetch(\"https://merchant.revolut.com/api/customers/__RP_TOK_0__\", {\n method: \"GET\",\n headers: {\n \"Authorization\": \"__RP_TOK_1__\",\n \"Revolut-Api-Version\": \"__RP_TOK_2__\"\n }\n})\n .then(response => response.json())\n .then(data => console.log(data));","templateHtml":"$c5a","tokens":[{"marker":"__RP_TOK_0__","paramName":"customer_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:customer_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"go","label":"Go","templateCode":"package main\n\nimport (\n \"fmt\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://merchant.revolut.com/api/customers/__RP_TOK_0__\"\n req, _ := http.NewRequest(\"GET\", url, nil)\n req.Header.Add(\"Authorization\", \"__RP_TOK_1__\")\n req.Header.Add(\"Revolut-Api-Version\", \"__RP_TOK_2__\")\n\n res, _ := http.DefaultClient.Do(req)\n defer res.Body.Close()\n fmt.Println(res)\n}","templateHtml":"$c5b","tokens":[{"marker":"__RP_TOK_0__","paramName":"customer_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:customer_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"python","label":"Python","templateCode":"import requests\n\nurl = \"https://merchant.revolut.com/api/customers/__RP_TOK_0__\"\nheaders = {\n \"Authorization\": \"__RP_TOK_1__\",\n \"Revolut-Api-Version\": \"__RP_TOK_2__\"\n}\n\nresponse = requests.get(url, headers=headers)\nprint(response.json())","templateHtml":"$c5c","tokens":[{"marker":"__RP_TOK_0__","paramName":"customer_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:customer_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"java","label":"Java","templateCode":"import java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\nimport java.net.URI;\n\npublic class Main {\n public static void main(String[] args) {\n HttpClient client = HttpClient.newHttpClient();\n HttpRequest request = HttpRequest.newBuilder()\n .uri(URI.create(\"https://merchant.revolut.com/api/customers/__RP_TOK_0__\"))\n .header(\"Authorization\", \"__RP_TOK_1__\")\n .header(\"Revolut-Api-Version\", \"__RP_TOK_2__\")\n .GET(HttpRequest.BodyPublishers.noBody())\n .build();\n\n client.sendAsync(request, HttpResponse.BodyHandlers.ofString())\n .thenApply(HttpResponse::body)\n .thenAccept(System.out::println)\n .join();\n }\n}","templateHtml":"$c5d","tokens":[{"marker":"__RP_TOK_0__","paramName":"customer_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:customer_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"csharp","label":"C#","templateCode":"using System.Net.Http;\nusing System.Net.Http.Headers;\n\nvar client = new HttpClient();\nvar request = new HttpRequestMessage\n{\n Method = HttpMethod.Get,\n RequestUri = new Uri(\"https://merchant.revolut.com/api/customers/__RP_TOK_0__\"),\n Headers =\n {\n { \"Authorization\", \"__RP_TOK_1__\" },\n { \"Revolut-Api-Version\", \"__RP_TOK_2__\" },\n }\n};\n\nusing (var response = await client.SendAsync(request))\n{\n response.EnsureSuccessStatusCode();\n var body = await response.Content.ReadAsStringAsync();\n Console.WriteLine(body);\n}","templateHtml":"$c5e","tokens":[{"marker":"__RP_TOK_0__","paramName":"customer_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:customer_id":"123e4567-e89b-12d3-a456-426614174000"}}],"https://sandbox-merchant.revolut.com":[{"id":"curl","label":"cURL","templateCode":"curl -X GET \"https://sandbox-merchant.revolut.com/api/customers/__RP_TOK_0__\" \\\n -H \"Authorization: __RP_TOK_1__\" \\\n -H \"Revolut-Api-Version: __RP_TOK_2__\"","templateHtml":"
curl -X GET \"https://sandbox-merchant.revolut.com/api/customers/__RP_TOK_0__\" \\\n  -H \"Authorization: __RP_TOK_1__\" \\\n  -H \"Revolut-Api-Version: __RP_TOK_2__\"
","tokens":[{"marker":"__RP_TOK_0__","paramName":"customer_id","paramIn":"path","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["shell-double-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:customer_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"javascript","label":"JavaScript","templateCode":"fetch(\"https://sandbox-merchant.revolut.com/api/customers/__RP_TOK_0__\", {\n method: \"GET\",\n headers: {\n \"Authorization\": \"__RP_TOK_1__\",\n \"Revolut-Api-Version\": \"__RP_TOK_2__\"\n }\n})\n .then(response => response.json())\n .then(data => console.log(data));","templateHtml":"$c5f","tokens":[{"marker":"__RP_TOK_0__","paramName":"customer_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:customer_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"go","label":"Go","templateCode":"package main\n\nimport (\n \"fmt\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://sandbox-merchant.revolut.com/api/customers/__RP_TOK_0__\"\n req, _ := http.NewRequest(\"GET\", url, nil)\n req.Header.Add(\"Authorization\", \"__RP_TOK_1__\")\n req.Header.Add(\"Revolut-Api-Version\", \"__RP_TOK_2__\")\n\n res, _ := http.DefaultClient.Do(req)\n defer res.Body.Close()\n fmt.Println(res)\n}","templateHtml":"$c60","tokens":[{"marker":"__RP_TOK_0__","paramName":"customer_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:customer_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"python","label":"Python","templateCode":"import requests\n\nurl = \"https://sandbox-merchant.revolut.com/api/customers/__RP_TOK_0__\"\nheaders = {\n \"Authorization\": \"__RP_TOK_1__\",\n \"Revolut-Api-Version\": \"__RP_TOK_2__\"\n}\n\nresponse = requests.get(url, headers=headers)\nprint(response.json())","templateHtml":"$c61","tokens":[{"marker":"__RP_TOK_0__","paramName":"customer_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:customer_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"java","label":"Java","templateCode":"import java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\nimport java.net.URI;\n\npublic class Main {\n public static void main(String[] args) {\n HttpClient client = HttpClient.newHttpClient();\n HttpRequest request = HttpRequest.newBuilder()\n .uri(URI.create(\"https://sandbox-merchant.revolut.com/api/customers/__RP_TOK_0__\"))\n .header(\"Authorization\", \"__RP_TOK_1__\")\n .header(\"Revolut-Api-Version\", \"__RP_TOK_2__\")\n .GET(HttpRequest.BodyPublishers.noBody())\n .build();\n\n client.sendAsync(request, HttpResponse.BodyHandlers.ofString())\n .thenApply(HttpResponse::body)\n .thenAccept(System.out::println)\n .join();\n }\n}","templateHtml":"$c62","tokens":[{"marker":"__RP_TOK_0__","paramName":"customer_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:customer_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"csharp","label":"C#","templateCode":"using System.Net.Http;\nusing System.Net.Http.Headers;\n\nvar client = new HttpClient();\nvar request = new HttpRequestMessage\n{\n Method = HttpMethod.Get,\n RequestUri = new Uri(\"https://sandbox-merchant.revolut.com/api/customers/__RP_TOK_0__\"),\n Headers =\n {\n { \"Authorization\", \"__RP_TOK_1__\" },\n { \"Revolut-Api-Version\", \"__RP_TOK_2__\" },\n }\n};\n\nusing (var response = await client.SendAsync(request))\n{\n response.EnsureSuccessStatusCode();\n var body = await response.Content.ReadAsStringAsync();\n Console.WriteLine(body);\n}","templateHtml":"$c63","tokens":[{"marker":"__RP_TOK_0__","paramName":"customer_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:customer_id":"123e4567-e89b-12d3-a456-426614174000"}}]},"method":"get","servers":"$62:props:children:0:props:children:props:children:1:props:children:1:props:children:0:0:props:servers","path":"/api/customers/{customer_id}","parameters":["$c52:props:children:0:props:children:1:props:parameters:0","$c52:props:children:0:props:children:1:props:parameters:1","$c52:props:children:0:props:children:1:props:parameters:2"]}],"$Lc64"],"$Lc65","$Lc66"]}]]}] b67:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Token for retrieving the next page of results."}],"\n",["$","p","p-1",{"children":"If not present, there are no more results to retrieve."}]]}] b68:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unique identifier for the subscription plan."}]]}] b69:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The name of the subscription plan."}]]}] b6a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The default trial period duration for this subscription plan in ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_8601#Durations","target":"_blank","rel":"noreferrer","children":"ISO 8601 duration format"}]," (e.g., \"P14D\" for 14 days)."]}],"\n",["$","p","p-1",{"children":"This value serves as the default trial duration for all subscriptions created from this plan. Individual subscriptions can override this value at creation time."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["Only days (",["$","code","code-0",{"children":"D"}],") are allowed. Time components such as hours, minutes, or seconds are not permitted."]}]}]]}]]}] b6b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The state of the subscription plan."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"State","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"active"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The plan is active and can be used to create new subscriptions.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"deactivated"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The plan has been deactivated and cannot be used for new subscriptions.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] b6c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The date and time the subscription plan was created in ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_8601","target":"_blank","rel":"noreferrer","children":"ISO 8601"}]," format."]}]]}] b6d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The date and time the subscription plan was last updated in ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_8601","target":"_blank","rel":"noreferrer","children":"ISO 8601"}]," format."]}]]}] b6e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unique identifier for the subscription plan variation."}]]}] b6f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unique identifier for the subscription plan phase."}]]}] b70:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The sequential order of this phase in the subscription billing lifecycle."}],"\n",["$","p","p-1",{"children":"Phases execute in ascending order based on this value:"}],"\n",["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["Phase with ",["$","code","code-0",{"children":"ordinal=1"}]," executes first"]}],"\n",["$","li","li-1",{"children":["Phase with ",["$","code","code-0",{"children":"ordinal=2"}]," executes second, and so on"]}],"\n"]}],"\n",["$","p","p-2",{"children":["When a phase completes its ",["$","code","code-0",{"children":"cycle_count"}],", the subscription automatically progresses to the phase with the next ",["$","code","code-1",{"children":"ordinal"}]," value."]}],"\n",["$","p","p-3",{"children":[["$","strong","strong-0",{"children":"Example"}],": A subscription with phases ordered as ",["$","code","code-0",{"children":"ordinal=1"}]," (trial), ",["$","code","code-1",{"children":"ordinal=2"}]," (regular), ",["$","code","code-2",{"children":"ordinal=3"}]," (discounted) will progress through them in that sequence."]}]]}] bf4:"Retrieve a dispute list" c64:["$","$L10d",null,{"security":[{"Api-Key":[]}],"authorization":{"Api-Key":{"type":"apiKey","in":"header","name":"Authorization","description":"Each Merchant API request must contain an authorization header in the following format:\n\n```\n'Authorization: Bearer '\n```\n\nTo use this API, you need to generate API keys from your Revolut Business account. The Secret key is used in the authorization header for all server calls, while the Public key is provided with payment methods at checkout.\n\n:::info\nFor detailed instructions on generating your API keys, see: [Generate API keys](https://developer.revolut.com/docs/guides/merchant/get-started#generate-api-keys).\n:::","descriptionNode":"$Lc67"}}}] c65:["$","$L10f",null,{"exampleBlocks":{},"title":"Request body samples","headingAs":"h4"}] c66:["$","$L110",null,{"exampleBlocks":{"200":{"application/json":{"variants":[{"key":"retrieved_customer","label":"Customer","rawValue":"$25:props:children:0:props:children:props:responses:200:content:application/json:examples:retrieved_customer:value","block":"$Lc68"}],"syncedPropertyName":"$undefined"}},"401":{"application/json":{"variants":[{"key":"default","label":"Example","rawValue":{"code":"string","message":"string","timestamp":123},"block":"$Lc69"}],"syncedPropertyName":"$undefined"}},"404":{"application/json":{"variants":[{"key":"default","label":"Example","rawValue":{"code":"string","message":"string","timestamp":123},"block":"$Lc6a"}],"syncedPropertyName":"$undefined"}}},"headingAs":"h4"}] b71:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The length of each billing cycle for this phase in ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_8601#Durations","target":"_blank","rel":"noreferrer","children":"ISO 8601 duration format"}],"."]}],"\n",["$","p","p-1",{"children":["This determines how often the customer is billed during this phase. The total time spent in a phase is ",["$","code","code-0",{"children":"cycle_duration × cycle_count"}],"."]}],"\n",["$","p","p-2",{"children":[["$","strong","strong-0",{"children":"Common durations"}],":"]}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Duration","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"P1M"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"1 month","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"P1Y"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"1 year","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"P15D"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"15 days","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"P1W"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"1 week","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-4",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"PT2H"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"2 hours","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}],"\n",["$","p","p-3",{"children":[["$","strong","strong-0",{"children":"Example"}],": If ",["$","code","code-0",{"children":"cycle_duration=P1M"}]," and ",["$","code","code-1",{"children":"cycle_count=12"}],", the customer will be billed monthly for 12 months (1 year total)."]}]]}] b72:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Number of billing cycles for this phase before moving to the next phase."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Value","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Behavior","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":[["$","code","code-0",{"children":"null"}]," or omitted"],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Phase continues indefinitely. The subscription remains in this phase with no automatic progression.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["Specific number (e.g., ",["$","code","code-0",{"children":"1"}],", ",["$","code","code-1",{"children":"3"}],", ",["$","code","code-2",{"children":"12"}],")"],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["After completing this many billing cycles, the subscription automatically moves to the next phase as determined by the ",["$","code","code-0",{"children":"ordinal"}]," field."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}],"\n",["$","p","p-1",{"children":[["$","strong","strong-0",{"children":"Example"}],": If ",["$","code","code-0",{"children":"cycle_count=3"}]," and ",["$","code","code-1",{"children":"cycle_duration=P1M"}],", the subscription will complete 3 monthly cycles then move to the phase with the next highest ",["$","code","code-2",{"children":"ordinal"}]," value."]}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["If no next phase exists in after a cycle with a specific ",["$","code","code-0",{"children":"cycle_count"}],", the subscription will automatically stop when it completes its cycles."]}]}]]}]]}] b73:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Subscription amount in minor currency units (e.g., cents for USD, pence for GBP)."}],"\n",["$","p","p-1",{"children":["For example, ",["$","code","code-0",{"children":"9900"}]," in ",["$","code","code-1",{"children":"GBP"}]," represents £99.00."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["Conversion between major and minor units varies by currency. For instance, ",["$","code","code-0",{"children":"100"}]," minor units equal £1.00 in ",["$","code","code-1",{"children":"GBP"}],", whereas in ",["$","code","code-2",{"children":"ISK"}]," they represent 100 units. For more details, see the ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_4217","target":"_blank","rel":"noreferrer","children":"ISO 4217 standard"}],"."]}]}]]}]]}] b74:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":[["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_4217","target":"_blank","rel":"noreferrer","children":"ISO 4217"}]," currency code in upper case."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information about the supported currencies, see: ",["$","a","a-0",{"href":"https://help.revolut.com/business/help/merchant-accounts/payments/in-which-currencies-can-i-accept-payments/","target":"_blank","rel":"noreferrer","children":"Help Center"}],"."]}]}]]}]]}] b75:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The unique identifier of the subscription item."}]]}] b76:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The name of the subscription item."}]]}] b77:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of subscription item."}]]}] b78:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The number of units grouped together as a single billable package. Used to enable pricing of items that are too inexpensive to charge individually."}],"\n",["$","p","p-1",{"children":["For example, a ",["$","code","code-0",{"children":"package_size"}]," of ",["$","code","code-1",{"children":"1000"}]," with a unit price of 10 minor units (£0.10 in GBP) lets you sell 1000 tokens for £0.10 — effectively pricing each token at £0.0001, below the minimum chargeable amount."]}],"\n",["$","p","p-2",{"children":["Set to ",["$","code","code-0",{"children":"1"}]," to price each unit individually."]}]]}] b79:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The unit of measurement for the item."}]]}] b7a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The quantity of the item."}]]}] b7b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Amount in minor currency units (e.g., cents for USD)."}]]}] b7c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":[["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_4217","target":"_blank","rel":"noreferrer","children":"ISO 4217"}]," currency code in upper case."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information about the supported currencies, see: ",["$","a","a-0",{"href":"https://help.revolut.com/business/help/merchant-accounts/payments/in-which-currencies-can-i-accept-payments/","target":"_blank","rel":"noreferrer","children":"Help Center"}],"."]}]}]]}]]}] b7d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object structure of flat subscription item."}]]}] b7e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The unique identifier of the subscription item."}]]}] b7f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The name of the subscription item."}]]}] b80:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of subscription item."}]]}] b81:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The number of units grouped together as a single billable package. Used to enable pricing of items that are too inexpensive to charge individually."}],"\n",["$","p","p-1",{"children":["For example, a ",["$","code","code-0",{"children":"package_size"}]," of ",["$","code","code-1",{"children":"1000"}]," with a unit price of 10 minor units (£0.10 in GBP) lets you sell 1000 tokens for £0.10 — effectively pricing each token at £0.0001, below the minimum chargeable amount."]}],"\n",["$","p","p-2",{"children":["Set to ",["$","code","code-0",{"children":"1"}]," to price each unit individually."]}]]}] b82:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The unit of measurement for the item."}]]}] b83:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["Flat amount per unit in minor currency units. Mutually exclusive with ",["$","code","code-0",{"children":"tiers"}],"."]}]]}] b84:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":[["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_4217","target":"_blank","rel":"noreferrer","children":"ISO 4217"}]," currency code in upper case."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information about the supported currencies, see: ",["$","a","a-0",{"href":"https://help.revolut.com/business/help/merchant-accounts/payments/in-which-currencies-can-i-accept-payments/","target":"_blank","rel":"noreferrer","children":"Help Center"}],"."]}]}]]}]]}] b85:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The upper bound of the tier (exclusive). Null means unlimited."}]]}] b86:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Per-unit amount in minor currency units (e.g., cents for USD) charged for usage within this tier's threshold range."}]]}] b87:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["Graduated pricing tiers. Mutually exclusive with ",["$","code","code-0",{"children":"amount"}],"."]}]]}] b88:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["A merchant-defined identifier for a usage-based subscription item. You set this code on each usage item when creating a subscription plan, and supply it when reporting consumption on ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#create-subscription-usage","target":"_blank","rel":"noreferrer","children":"Create a subscription usage endpoint"}]," to target the correct metered item."]}],"\n",["$","p","p-1",{"children":["This allows a subscription with multiple usage items (e.g., ",["$","code","code-0",{"children":"api_calls"}]," and ",["$","code","code-1",{"children":"storage_gb"}],") to receive consumption reports against the right item without relying on internal IDs."]}],"\n",["$","p","p-2",{"children":"The code must be unique within a plan phase."}]]}] b89:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The method used to aggregate usage events over a billing cycle to calculate the chargeable amount."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Value","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Behaviour","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"sum"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Totals all reported usage events during the cycle. Use for cumulative metrics (e.g., API calls, data transferred).","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"latest"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["Uses the most recently reported value at the end of the cycle. If no usage is reported in a cycle, ",["$","code","code-0",{"children":"0"}]," is used — values do not carry over from previous cycles. Use for gauge-style metrics (e.g., active seats)."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"max"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Uses the peak value reported during the cycle. Use for capacity-based billing (e.g., max concurrent connections).","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] b8a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object structure of usage subscription item."}]]}] b8b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A subscription item that defines a billing line within a plan phase. Can be either a fixed-fee (flat) item or a metered (usage) item."}]]}] b8c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A list of subscription items for this phase."}]]}] b8d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"List of billing phases for this variation."}]]}] b8e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"List of subscription plan variations."}]]}] b8f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"List of subscription plans."}]]}] b90:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"List of subscription plans retrieved successfully"}]]}] b91:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An identifier that can be used to determine what went wrong."}],"\n",["$","p","p-1",{"children":"Error codes are not globally unique, but uniqueness is guaranteed within endpoints."}]]}] b92:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Some human readable text describing what went wrong."}]]}] b93:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://www.unixtimestamp.com/","target":"_blank","rel":"noreferrer","children":"UNIX timestamp"}]," of the date and time the error happened."]}]]}] b94:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Bad Request"}]]}] b95:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An identifier that can be used to determine what went wrong."}],"\n",["$","p","p-1",{"children":"Error codes are not globally unique, but uniqueness is guaranteed within endpoints."}]]}] b96:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Some human readable text describing what went wrong."}]]}] b97:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://www.unixtimestamp.com/","target":"_blank","rel":"noreferrer","children":"UNIX timestamp"}]," of the date and time the error happened."]}]]}] b98:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unauthorized"}]]}] b99:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An identifier that can be used to determine what went wrong."}],"\n",["$","p","p-1",{"children":"Error codes are not globally unique, but uniqueness is guaranteed within endpoints."}]]}] b9a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Some human readable text describing what went wrong."}]]}] b9b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://www.unixtimestamp.com/","target":"_blank","rel":"noreferrer","children":"UNIX timestamp"}]," of the date and time the error happened."]}]]}] b9c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Error response"}]]}] ba1:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Retrieve all subscription plans configured for your merchant account. You can use the query parameters for:"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Filtering","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Pagination","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["Filter the subscription plans that you want to retrieve, for example, only retrieve plans created within a specific date range. ",["$","br","br-0",{}],["$","br","br-1",{}],"Parameters used for filtering:",["$","br","br-2",{}],["$","ul","ul-0",{"children":[["$","li","li-0",{"children":["$","code","code-0",{"children":"from"}]}],["$","li","li-1",{"children":["$","code","code-0",{"children":"to"}]}]]}]],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["View the subscription plans without loading all of them at once, for example, return a specified number of plans per page. ",["$","br","br-0",{}],["$","br","br-1",{}],"Parameters used for pagination: ",["$","br","br-2",{}],["$","ul","ul-0",{"children":[["$","li","li-0",{"children":["$","code","code-0",{"children":"limit"}]}],["$","li","li-1",{"children":["$","code","code-0",{"children":"page_token"}]}]]}]],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] ba2:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["This parameter accepts the ",["$","a","a-0",{"href":"https://business.revolut.com/settings/apis?tab=merchant-api","target":"_blank","rel":"noreferrer","children":"Merchant API Secret key"}]," to authorise requests coming from the merchant's backend."]}],"\n",["$","p","p-1",{"children":["It ensures that ensures that each request is authenticated and authorised by verifying the secret key. The secret key should be included in all request headers as a ",["$","code","code-0",{"children":"Bearer"}]," token."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#authentication","target":"_blank","rel":"noreferrer","children":"Authentication"}]]}]}]]}]]}] ba3:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The version of the Merchant API, specified in ",["$","code","code-0",{"children":"YYYY-MM-DD"}]," format."]}],"\n",["$","p","p-1",{"children":"If not specified, you will receive an error."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information about API versioning, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/reference/versioning/api-versions","target":"_blank","rel":"noreferrer","children":"API versions"}],"."]}]}]]}]]}] ba4:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["Maximum number of records to return. Used for ",["$","strong","strong-0",{"children":"pagination"}],"."]}]]}] ba5:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["Filter records created from this date/time. Used for ",["$","strong","strong-0",{"children":"filtering"}],"."]}]]}] ba6:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["Filter records created until this date/time. Used for ",["$","strong","strong-0",{"children":"filtering"}],"."]}]]}] ba7:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["Token for retrieving the next page of results. Used for ",["$","strong","strong-0",{"children":"pagination"}],"."]}],"\n",["$","p","p-1",{"children":"To paginate through results:"}],"\n",["$","ol","ol-0",{"children":["\n",["$","li","li-0",{"children":["Make an initial request with the desired ",["$","code","code-0",{"children":"limit"}],"."]}],"\n",["$","li","li-1",{"children":["The response will include a ",["$","code","code-0",{"children":"next_page_token"}]," if more results are available."]}],"\n",["$","li","li-2",{"children":["Use that token in the ",["$","code","code-0",{"children":"page_token"}]," parameter of your next request."]}],"\n",["$","li","li-3",{"children":["Repeat until ",["$","code","code-0",{"children":"next_page_token"}]," is not present."]}],"\n"]}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["When using ",["$","code","code-0",{"children":"page_token"}],", you must include all query parameters from the initial request (such as ",["$","code","code-1",{"children":"from"}],", ",["$","code","code-2",{"children":"to"}],", or other filter parameters) to maintain consistent filtering across pages."]}]}]]}]]}] bb7:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unique identifier of the dispute."}]]}] bb8:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Represents the state of the dispute."}],"\n",["$","p","p-1",{"children":"It indicates either the final outcome of the dispute or if further action is required."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Parameter value","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"needs_response"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Indicates that the dispute requires a response or action from the merchant.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"under_review"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Indicates that the dispute is currently under review, and the outcome is pending.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"won"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Indicates that the dispute has been resolved in favor of the merchant.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"lost"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Indicates that the dispute has been resolved against the merchant.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] bba:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Provides additional granularity about the dispute state."}],"\n",["$","p","p-1",{"children":"It details the progression of the dispute process, showing the current stage or phase."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Parameter value","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"new"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The dispute has been recently created and is in the initial phase, awaiting further processing.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"lost_expired"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The dispute has been lost due to expiration, likely because the merchant did not respond within the required timeframe.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"pre_arbitration"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The dispute is in the pre-arbitration phase, where preliminary evidence is being gathered before a formal arbitration process.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"won_pre_arbitration"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The merchant secured a win during the pre-arbitration phase based on the evidence provided.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-4",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"lost_pre_arbitration"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The dispute was lost during the pre-arbitration phase, indicating that the preliminary review did not favor the merchant.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-5",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"lost_accepted"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The loss has been accepted as final, implying that no further contestation is likely or needed.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-6",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"arbitration"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The dispute has escalated to the arbitration stage, where a neutral third party is reviewing the evidence.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-7",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"won_arbitration"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The merchant won the dispute during the arbitration process.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-8",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"lost_arbitration"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The merchant lost the dispute during the arbitration process.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] bbb:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":[["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_8601","target":"_blank","rel":"noreferrer","children":"ISO 8601"}]," date and time when the dispute was created."]}]]}] bbc:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":[["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_8601","target":"_blank","rel":"noreferrer","children":"ISO 8601"}]," date and time when the dispute was last updated."]}]]}] bbd:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":[["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_8601","target":"_blank","rel":"noreferrer","children":"ISO 8601"}]," date and time until when the merchant needs to respond to the dispute."]}],"\n",["$","p","p-1",{"children":"The response time by default is 15 days after the dispute is created. If no response is provided by this date, the dispute transitions to:"}],"\n",["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["$","code","code-0",{"children":"state: lost"}]}],"\n",["$","li","li-1",{"children":["$","code","code-0",{"children":"substate: lost_expired"}]}],"\n"]}]]}] c6b:T4452,
{
  "payment_methods": [
    {
      "id": "648334a8-9546-a983-a81a-efc6d5bdd0be",
      "type": "revolut_pay",
      "saved_for": "merchant",
      "created_at": "2023-06-09T14:18:16.577888Z"
    },
    {
      "id": "edef3ba4-60a0-4df3-8f12-e5fc858c2420",
      "type": "card",
      "saved_for": "customer",
      "created_at": "2023-03-24T14:15:22Z",
      "bin": "459678",
      "last_four": "6896",
      "expiry_month": 3,
      "expiry_year": 2025,
      "cardholder_name": "Example Customer",
      "brand": "visa",
      "funding": "debit",
      "issuer": "EXAMPLE ISSUER",
      "issuer_country": "GB",
      "billing_address": {
        "street_line_1": "7",
        "street_line_2": "Westferry Circus",
        "postcode": "E144HD",
        "city": "London",
        "region": "Greater London",
        "country_code": "GB"
      }
    },
    {
      "id": "a04406c4-05be-498b-8207-cc1e02a9b3ca",
      "type": "card",
      "saved_for": "merchant",
      "created_at": "2023-03-24T14:15:22Z",
      "bin": "459885",
      "last_four": "7653",
      "expiry_month": 12,
      "expiry_year": 2026,
      "cardholder_name": "Example Holder",
      "brand": "mastercard",
      "funding": "credit",
      "issuer": "EXAMPLE ISSUER",
      "issuer_country": "GB",
      "billing_address": {
        "street_line_1": "Revolut",
        "street_line_2": "1 Canada Square",
        "postcode": "EC2V 6DN",
        "city": "London",
        "region": "Greater London",
        "country_code": "GB"
      }
    },
    {
      "id": "6a0fe961-a961-a8b6-ad17-ab2779165a82",
      "type": "sepa_direct_debit",
      "saved_for": "merchant",
      "created_at": "2026-05-22T05:28:01.887482Z",
      "debtor_iban_last_four": "3273",
      "debtor_name": "John Doe",
      "mandate_reference": "69F1CB61BD99A32C8E20D7FB9E21E146",
      "billing_address": {
        "street_line_1": "Bank of England",
        "street_line_2": "Threadneedle St",
        "postcode": "EC2R 8AH",
        "city": "London",
        "region": "Greater London",
        "country_code": "GB"
      }
    }
  ]
}
a64:["$","div","200-application/json-list_of_payment_methods",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$c6b"}}]}]],"$Lc6c"]}] c6d:T44d,
{
  "code": "string",
  "message": "string",
  "timestamp": 123
}
a65:["$","div","401-application/json-default",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$c6d"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"code\": \"string\",\n \"message\": \"string\",\n \"timestamp\": 123\n}"}]}]]}] c6e:T44d,
{
  "code": "string",
  "message": "string",
  "timestamp": 123
}
a66:["$","div","404-application/json-default",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$c6e"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"code\": \"string\",\n \"message\": \"string\",\n \"timestamp\": 123\n}"}]}]]}] aa1:["$","div","CodeBlock-0",{"className":"wzy01m0 _18b50nc0","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"
'Authorization: Bearer <yourSecretApiKey>'
"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"'Authorization: Bearer '\n"}]}]]}] aa2:["$","div","CodeBlock-0",{"className":"wzy01m0 _18b50nc0","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"
'Authorization: Bearer <yourSecretApiKey>'
"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"'Authorization: Bearer '\n"}]}]]}] bef:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Each Merchant API request must contain an authorization header in the following format:"}],"\n","$Lc6f","\n",["$","p","p-1",{"children":"To use this API, you need to generate API keys from your Revolut Business account. The Secret key is used in the authorization header for all server calls, while the Public key is provided with payment methods at checkout."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For detailed instructions on generating your API keys, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/get-started#generate-api-keys","target":"_blank","rel":"noreferrer","children":"Generate API keys"}],"."]}]}]]}]]}] bbe:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Dispute reason code from the payment scheme, following standard formats defined by individual providers."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"For complete, official lists of dispute codes, see:"}],["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":[["$","strong","strong-0",{"children":"Visa"}],": ",["$","a","a-0",{"href":"https://corporate.visa.com/content/dam/VCOM/download/about-visa/visa-rules-public.pdf","target":"_blank","rel":"noreferrer","children":"Visa Core Rules and Visa Product and Service Rules"}]]}],"\n",["$","li","li-1",{"children":[["$","strong","strong-0",{"children":"Mastercard"}],": ",["$","a","a-0",{"href":"https://www.mastercard.com/content/dam/public/mastercardcom/na/global-site/documents/chargeback-guide.pdf","target":"_blank","rel":"noreferrer","children":"Chargeback Guide - Merchant Edition"}]]}],"\n",["$","li","li-2",{"children":[["$","strong","strong-0",{"children":"American Express"}],": ",["$","a","a-0",{"href":"https://www.americanexpress.com/content/dam/amex/au/en/merchant/static/chargebackcodeguide.pdf","target":"_blank","rel":"noreferrer","children":"Chargeback Codes"}]]}],"\n"]}]]}]]}]]}] bbf:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Provides a human-readable explanation for the dispute reason codes."}]]}] bc0:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["Disputed amount expressed in minor currency units, according to the ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_4217","target":"_blank","rel":"noreferrer","children":"ISO 4217 standard"}],". For example, ",["$","code","code-0",{"children":"7034"}]," in ",["$","code","code-1",{"children":"EUR"}]," corresponds to €70.34."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["Conversion between major and minor units varies by currency. For instance, ",["$","code","code-0",{"children":"100"}]," minor units equal £1.00 in ",["$","code","code-1",{"children":"GBP"}],", whereas in ",["$","code","code-2",{"children":"ISK"}]," they represent 100 units. For more details, see the ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_4217","target":"_blank","rel":"noreferrer","children":"ISO 4217 standard"}],"."]}]}]]}]]}] bc1:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":[["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_4217","target":"_blank","rel":"noreferrer","children":"ISO 4217"}]," currency code in upper case."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information about the supported currencies, see: ",["$","a","a-0",{"href":"https://help.revolut.com/business/help/merchant-accounts/payments/in-which-currencies-can-i-accept-payments/","target":"_blank","rel":"noreferrer","children":"Help Center"}],"."]}]}]]}]]}] bc2:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The ID of the original payment that was disputed."}]]}] bc3:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The ID of the order linked to the original disputed payment."}]]}] bc4:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":[["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_8601","target":"_blank","rel":"noreferrer","children":"ISO 8601"}]," date and time when the original disputed payment was created."]}]]}] bc5:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Acquirer Reference Number (ARN) of the original payment."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":"Only returned for payments made by a card."}]}]]}]]}] bc6:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["Amount of the original payment expressed in minor currency units, according to the ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_4217","target":"_blank","rel":"noreferrer","children":"ISO 4217 standard"}],". For example, ",["$","code","code-0",{"children":"7034"}]," in ",["$","code","code-1",{"children":"EUR"}]," corresponds to €70.34."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["Conversion between major and minor units varies by currency. For instance, ",["$","code","code-0",{"children":"100"}]," minor units equal £1.00 in ",["$","code","code-1",{"children":"GBP"}],", whereas in ",["$","code","code-2",{"children":"ISK"}]," they represent 100 units. For more details, see the ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_4217","target":"_blank","rel":"noreferrer","children":"ISO 4217 standard"}],"."]}]}]]}]]}] bc7:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":[["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_4217","target":"_blank","rel":"noreferrer","children":"ISO 4217"}]," currency code in upper case."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information about the supported currencies, see: ",["$","a","a-0",{"href":"https://help.revolut.com/business/help/merchant-accounts/payments/in-which-currencies-can-i-accept-payments/","target":"_blank","rel":"noreferrer","children":"Help Center"}],"."]}]}]]}]]}] bc8:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Type of the payment method used for the original payment."}],"\n",["$","p","p-1",{"children":"Available values:"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":["Payment method ",["$","code","code-0",{"children":"type"}]],"className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"apple_pay"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using Apple Pay.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"apple_tap_to_pay"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using Apple Tap to Pay.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"card"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using their credit or debit card.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"google_pay"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using Google Pay.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-4",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"revolut_pay_card"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order via Revolut Pay using their credit or debit card.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-5",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"revolut_pay_account"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order via Revolut Pay using their Revolut account.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-6",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"sepa_direct_debit"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order via SEPA Direct Debit.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] bc9:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The brand of the payment card."}]]}] bca:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The last four digits of the payment card number."}]]}] bcb:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object containing details of a card used via Apple Pay."}]]}] bcc:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Type of the payment method used for the original payment."}],"\n",["$","p","p-1",{"children":"Available values:"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":["Payment method ",["$","code","code-0",{"children":"type"}]],"className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"apple_pay"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using Apple Pay.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"apple_tap_to_pay"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using Apple Tap to Pay.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"card"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using their credit or debit card.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"google_pay"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using Google Pay.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-4",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"revolut_pay_card"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order via Revolut Pay using their credit or debit card.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-5",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"revolut_pay_account"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order via Revolut Pay using their Revolut account.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-6",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"sepa_direct_debit"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order via SEPA Direct Debit.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] bcd:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object containing details of a payment made via Apple Tap to Pay."}]]}] bce:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Type of the payment method used for the original payment."}],"\n",["$","p","p-1",{"children":"Available values:"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":["Payment method ",["$","code","code-0",{"children":"type"}]],"className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"apple_pay"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using Apple Pay.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"apple_tap_to_pay"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using Apple Tap to Pay.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"card"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using their credit or debit card.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"google_pay"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using Google Pay.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-4",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"revolut_pay_card"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order via Revolut Pay using their credit or debit card.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-5",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"revolut_pay_account"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order via Revolut Pay using their Revolut account.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-6",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"sepa_direct_debit"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order via SEPA Direct Debit.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] bcf:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The brand of the payment card."}]]}] bd0:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The last four digits of the payment card number."}]]}] bd1:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object containing details of the card used for the payment."}]]}] bd2:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Type of the payment method used for the original payment."}],"\n",["$","p","p-1",{"children":"Available values:"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":["Payment method ",["$","code","code-0",{"children":"type"}]],"className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"apple_pay"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using Apple Pay.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"apple_tap_to_pay"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using Apple Tap to Pay.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"card"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using their credit or debit card.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"google_pay"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using Google Pay.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-4",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"revolut_pay_card"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order via Revolut Pay using their credit or debit card.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-5",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"revolut_pay_account"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order via Revolut Pay using their Revolut account.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-6",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"sepa_direct_debit"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order via SEPA Direct Debit.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] bd3:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The brand of the payment card."}]]}] bd4:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The last four digits of the payment card number."}]]}] bd5:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object containing details of a card used via Google Pay."}]]}] bd6:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Type of the payment method used for the original payment."}],"\n",["$","p","p-1",{"children":"Available values:"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":["Payment method ",["$","code","code-0",{"children":"type"}]],"className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"apple_pay"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using Apple Pay.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"apple_tap_to_pay"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using Apple Tap to Pay.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"card"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using their credit or debit card.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"google_pay"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using Google Pay.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-4",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"revolut_pay_card"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order via Revolut Pay using their credit or debit card.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-5",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"revolut_pay_account"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order via Revolut Pay using their Revolut account.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-6",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"sepa_direct_debit"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order via SEPA Direct Debit.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] bd7:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object containing details of a payment made via Revolut Pay account."}]]}] bd8:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Type of the payment method used for the original payment."}],"\n",["$","p","p-1",{"children":"Available values:"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":["Payment method ",["$","code","code-0",{"children":"type"}]],"className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"apple_pay"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using Apple Pay.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"apple_tap_to_pay"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using Apple Tap to Pay.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"card"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using their credit or debit card.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"google_pay"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using Google Pay.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-4",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"revolut_pay_card"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order via Revolut Pay using their credit or debit card.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-5",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"revolut_pay_account"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order via Revolut Pay using their Revolut account.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-6",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"sepa_direct_debit"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order via SEPA Direct Debit.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] bd9:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The brand of the payment card."}]]}] bda:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The last four digits of the payment card number."}]]}] bdb:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object containing details of a card used via Revolut Pay."}]]}] bdc:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Type of the payment method used for the original payment."}],"\n",["$","p","p-1",{"children":"Available values:"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":["Payment method ",["$","code","code-0",{"children":"type"}]],"className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"apple_pay"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using Apple Pay.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"apple_tap_to_pay"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using Apple Tap to Pay.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"card"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using their credit or debit card.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"google_pay"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using Google Pay.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-4",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"revolut_pay_card"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order via Revolut Pay using their credit or debit card.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-5",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"revolut_pay_account"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order via Revolut Pay using their Revolut account.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-6",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"sepa_direct_debit"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order via SEPA Direct Debit.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] bdd:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The last four digits of the debtor's IBAN."}]]}] bde:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The full name of the debtor as provided in the mandate."}]]}] bdf:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The unique mandate reference generated by Revolut. Include this in pre-debit notifications sent to your customers."}]]}] be0:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object containing details of a SEPA Direct Debit payment."}]]}] be1:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Payment method used for the original payment."}],"\n",["$","p","p-1",{"children":["Use the ",["$","code","code-0",{"children":"type"}]," field to determine the specific payment method variant."]}]]}] be2:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object containing the details of the original payment associated with the dispute."}]]}] be3:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An array containing a list of disputes."}]]}] be4:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"List of disputes retrieved"}]]}] be5:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An identifier that can be used to determine what went wrong."}],"\n",["$","p","p-1",{"children":"Error codes are not globally unique, but uniqueness is guaranteed within endpoints."}]]}] be6:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Some human readable text describing what went wrong."}]]}] be7:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://www.unixtimestamp.com/","target":"_blank","rel":"noreferrer","children":"UNIX timestamp"}]," of the date and time the error happened."]}]]}] be8:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Bad Request"}]]}] be9:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An identifier that can be used to determine what went wrong."}],"\n",["$","p","p-1",{"children":"Error codes are not globally unique, but uniqueness is guaranteed within endpoints."}]]}] bea:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Some human readable text describing what went wrong."}]]}] beb:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://www.unixtimestamp.com/","target":"_blank","rel":"noreferrer","children":"UNIX timestamp"}]," of the date and time the error happened."]}]]}] bec:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unauthorized"}]]}] bf5:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Retrieve a list of disputes associated with your merchant account."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["This endpoint is only available in ",["$","strong","strong-0",{"children":"Production"}]," environment."]}]}]]}],"\n",["$","p","p-1",{"children":"You can also use the query parameters for:"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Filtering","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Pagination","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["Filter the diputes that you want to retrieve, for example, only retrieve the disputes that have a specific state. ",["$","br","br-0",{}],["$","br","br-1",{}],"Parameters used for filtering:",["$","br","br-2",{}],["$","ul","ul-0",{"children":[["$","li","li-0",{"children":["$","code","code-0",{"children":"from_created_date"}]}],["$","li","li-1",{"children":["$","code","code-0",{"children":"to_created_date"}]}],["$","li","li-2",{"children":["$","code","code-0",{"children":"payment_id"}]}],["$","li","li-3",{"children":["$","code","code-0",{"children":"state"}]}]]}]],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["View the disputes without loading all of them at once, for example, return a specified number of disputes per page. ",["$","br","br-0",{}],["$","br","br-1",{}],"Parameters used for pagination: ",["$","br","br-2",{}],["$","ul","ul-0",{"children":[["$","li","li-0",{"children":["$","code","code-0",{"children":"limit"}]}],["$","li","li-1",{"children":[["$","code","code-0",{"children":"from_created_date"}]," or ",["$","code","code-1",{"children":"to_created_date"}]]}]]}]],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] bf6:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["This parameter accepts the ",["$","a","a-0",{"href":"https://business.revolut.com/settings/apis?tab=merchant-api","target":"_blank","rel":"noreferrer","children":"Merchant API Secret key"}]," to authorise requests coming from the merchant's backend."]}],"\n",["$","p","p-1",{"children":["It ensures that ensures that each request is authenticated and authorised by verifying the secret key. The secret key should be included in all request headers as a ",["$","code","code-0",{"children":"Bearer"}]," token."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#authentication","target":"_blank","rel":"noreferrer","children":"Authentication"}]]}]}]]}]]}] bf7:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The version of the Merchant API, specified in ",["$","code","code-0",{"children":"YYYY-MM-DD"}]," format."]}],"\n",["$","p","p-1",{"children":"If not specified, you will receive an error."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information about API versioning, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/reference/versioning/api-versions","target":"_blank","rel":"noreferrer","children":"API versions"}],"."]}]}]]}]]}] bf8:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["Maximum number of records to return. Used for ",["$","strong","strong-0",{"children":"pagination"}],"."]}]]}] bf9:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["Retrieve records with a ",["$","code","code-0",{"children":"created_at"}]," value ≥ ",["$","code","code-1",{"children":"from_created_date"}],"."]}],"\n",["$","p","p-1",{"children":["Use the ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_8601","target":"_blank","rel":"noreferrer","children":"ISO 8601 date-time format"}],": ",["$","code","code-0",{"children":"yyyy-MM-ddTHH:mm:ss[.SSSSSS]Z"}],"."]}]]}] bfa:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["Retrieve records with a ",["$","code","code-0",{"children":"created_at"}]," value ≤ ",["$","code","code-1",{"children":"to_created_date"}],"."]}],"\n",["$","p","p-1",{"children":["Use the ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_8601","target":"_blank","rel":"noreferrer","children":"ISO 8601 date-time format"}],": ",["$","code","code-0",{"children":"yyyy-MM-ddTHH:mm:ss[.SSSSSS]Z"}],"."]}]]}] bfb:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Filter disputes by state. Repeat the parameter to filter by multiple states."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Value","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"needs_response"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Dispute requires your response","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"under_review"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Dispute is being reviewed","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"won"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Dispute resolved in your favour","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"lost"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Dispute resolved against you","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}],"\n",["$","p","p-1",{"children":"The parameter is case sensitive."}]]}] bfc:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Filter disputes by the ID of the associated payment. Repeat the parameter to filter by multiple payment IDs."}],"\n","$Lc70"]}] c54:"Retrieve a customer" c71:T826,{ "payment_methods": [ { "id": "648334a8-9546-a983-a81a-efc6d5bdd0be", "type": "revolut_pay", "saved_for": "merchant", "created_at": "2023-06-09T14:18:16.577888Z" }, { "id": "edef3ba4-60a0-4df3-8f12-e5fc858c2420", "type": "card", "saved_for": "customer", "created_at": "2023-03-24T14:15:22Z", "bin": "459678", "last_four": "6896", "expiry_month": 3, "expiry_year": 2025, "cardholder_name": "Example Customer", "brand": "visa", "funding": "debit", "issuer": "EXAMPLE ISSUER", "issuer_country": "GB", "billing_address": { "street_line_1": "7", "street_line_2": "Westferry Circus", "postcode": "E144HD", "city": "London", "region": "Greater London", "country_code": "GB" } }, { "id": "a04406c4-05be-498b-8207-cc1e02a9b3ca", "type": "card", "saved_for": "merchant", "created_at": "2023-03-24T14:15:22Z", "bin": "459885", "last_four": "7653", "expiry_month": 12, "expiry_year": 2026, "cardholder_name": "Example Holder", "brand": "mastercard", "funding": "credit", "issuer": "EXAMPLE ISSUER", "issuer_country": "GB", "billing_address": { "street_line_1": "Revolut", "street_line_2": "1 Canada Square", "postcode": "EC2V 6DN", "city": "London", "region": "Greater London", "country_code": "GB" } }, { "id": "6a0fe961-a961-a8b6-ad17-ab2779165a82", "type": "sepa_direct_debit", "saved_for": "merchant", "created_at": "2026-05-22T05:28:01.887482Z", "debtor_iban_last_four": "3273", "debtor_name": "John Doe", "mandate_reference": "69F1CB61BD99A32C8E20D7FB9E21E146", "billing_address": { "street_line_1": "Bank of England", "street_line_2": "Threadneedle St", "postcode": "EC2R 8AH", "city": "London", "region": "Greater London", "country_code": "GB" } } ] }c6c:["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"$c71"}]}] c16:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Each Merchant API request must contain an authorization header in the following format:"}],"\n","$Lc72","\n",["$","p","p-1",{"children":"To use this API, you need to generate API keys from your Revolut Business account. The Secret key is used in the authorization header for all server calls, while the Public key is provided with payment methods at checkout."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For detailed instructions on generating your API keys, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/get-started#generate-api-keys","target":"_blank","rel":"noreferrer","children":"Generate API keys"}],"."]}]}]]}]]}] c1b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unique identifier for the customer."}]]}] c1c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The full name of the customer."}]]}] c1d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The email address of the customer."}]]}] c1e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The phone number of the customer in ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/E.164","target":"_blank","rel":"noreferrer","children":"E.164 format"}],"."]}]]}] c1f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The date and time the customer was created."}]]}] c20:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The date and time the customer was last updated."}]]}] c21:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unique identifier for the payment method."}]]}] c22:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of the payment method."}]]}] c23:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Indicates in which case this saved payment method can be used for payments."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Value","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"customer"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"This payment method can be used only when the customer is on the checkout page.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"merchant"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"This payment method can be used without the customer being on the checkout page, and the merchant can initiate transactions, for example, to take payments for recurring transactions.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] c24:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The date and time the payment method was added."}]]}] c25:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The BIN (Bank Identification Number) of the payment card, typically the first 6-8 digits."}]]}] c26:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The last four digits of the payment card number."}]]}] c27:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The expiry month of the payment card."}]]}] c28:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The expiry year of the payment card."}]]}] c73:T19af,
{
  "id": "f757b068-f287-43c8-8d05-9c073fecbe73",
  "name": "Enterprise Pro Plan",
  "state": "active",
  "created_at": "2026-01-26T08:59:09.433527Z",
  "updated_at": "2026-01-26T08:59:09.433527Z",
  "variations": [
    {
      "id": "f4e0a171-4f4e-484b-b0a2-22085059af65",
      "phases": [
        {
          "id": "23319d04-4b23-4ae7-ba54-82112c752683",
          "ordinal": 1,
          "cycle_duration": "P1M",
          "amount": 990,
          "currency": "GBP"
        }
      ]
    },
    {
      "id": "7cf47b0d-3da9-496b-a4e9-fbbe43c33ee3",
      "phases": [
        {
          "id": "feed2491-c895-4bfa-ba05-a3a088842d5c",
          "ordinal": 1,
          "cycle_duration": "P1Y",
          "amount": 9990,
          "currency": "GBP"
        }
      ]
    }
  ]
}
ab7:["$","div","200-application/json-simple_plan",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$c73"}}]}]],"$Lc74"]}] c75:T11f1,
{
  "id": "750e8400-e29b-41d4-a716-446655440010",
  "name": "Premium Plan with 14-day Trial",
  "trial_duration": "P14D",
  "state": "active",
  "created_at": "2025-06-04T21:00:00.036001Z",
  "updated_at": "2025-06-04T21:00:00.036001Z",
  "variations": [
    {
      "id": "850e8400-e29b-41d4-a716-446655440011",
      "phases": [
        {
          "id": "950e8400-e29b-41d4-a716-446655440012",
          "ordinal": 1,
          "cycle_duration": "P1M",
          "amount": 9900,
          "currency": "GBP"
        }
      ]
    }
  ]
}
ab8:["$","div","200-application/json-trial_plan_with_duration",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$c75"}}]}]],"$Lc76"]}] c77:T11e9,
{
  "id": "550e8400-e29b-41d4-a716-446655440003",
  "name": "12-month Limited Plan",
  "state": "active",
  "created_at": "2025-06-05T21:00:00.036001Z",
  "updated_at": "2025-06-05T21:00:00.036001Z",
  "variations": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440004",
      "phases": [
        {
          "id": "550e8400-e29b-41d4-a716-446655440005",
          "ordinal": 1,
          "cycle_duration": "P1M",
          "cycle_count": 12,
          "amount": 1000,
          "currency": "GBP"
        }
      ]
    }
  ]
}
ab9:["$","div","200-application/json-limited_plan",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$c77"}}]}]],"$Lc78"]}] c79:T44d,
{
  "code": "string",
  "message": "string",
  "timestamp": 123
}
aba:["$","div","400-application/json-default",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$c79"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"code\": \"string\",\n \"message\": \"string\",\n \"timestamp\": 123\n}"}]}]]}] c7a:T44d,
{
  "code": "string",
  "message": "string",
  "timestamp": 123
}
abb:["$","div","401-application/json-default",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$c7a"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"code\": \"string\",\n \"message\": \"string\",\n \"timestamp\": 123\n}"}]}]]}] c7b:T44d,
{
  "code": "string",
  "message": "string",
  "timestamp": 123
}
abc:["$","div","404-application/json-default",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$c7b"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"code\": \"string\",\n \"message\": \"string\",\n \"timestamp\": 123\n}"}]}]]}] c7c:T44d,
{
  "code": "string",
  "message": "string",
  "timestamp": 123
}
abd:["$","div","default-application/json-default",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$c7c"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"code\": \"string\",\n \"message\": \"string\",\n \"timestamp\": 123\n}"}]}]]}] c29:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The name of the cardholder as it appears on the card."}]]}] c2a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The brand of the payment card."}]]}] c2b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The funding type of the payment card."}]]}] c2c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The name of the card-issuing bank or institution."}]]}] c2d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The ISO 3166-1 alpha-2 country code of the country where the payment card was issued."}]]}] c2e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Primary address line."}]]}] c2f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Secondary address line, such as floor and apartment number."}]]}] c30:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"State or province of the address."}]]}] c31:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"City of the address."}]]}] c32:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"ISO 2-letter country code."}]]}] c33:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Postal code of the address."}]]}] c34:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The billing address associated with the payment method."}]]}] c35:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The hardware identifier of the Revolut Terminal device used to process the payment."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":"Only present for card-present transactions processed via Revolut Terminal."}]}]]}]]}] c36:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A saved card payment method."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["The ",["$","code","code-0",{"children":"checks"}]," object (3DS, CVV, address verification) is not included as it is specific to the transactional payment context."]}]}]]}]]}] c37:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unique identifier for the payment method."}]]}] c38:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of the payment method."}]]}] c39:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Indicates in which case this saved payment method can be used for payments."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Value","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"customer"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"This payment method can be used only when the customer is on the checkout page.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"merchant"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"This payment method can be used without the customer being on the checkout page, and the merchant can initiate transactions, for example, to take payments for recurring transactions.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] c3a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The date and time the payment method was added."}]]}] c3b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A saved Revolut Pay payment method on a customer profile."}],"\n",["$","p","p-1",{"children":["Both Revolut Pay card-backed and account-to-account (A2A) variants are\nrepresented by this single type at the saved payment method level.\nNo underlying card details are exposed here; use the order-level\n",["$","code","code-0",{"children":"payments[].payment_method"}]," object (types ",["$","code","code-1",{"children":"revolut_pay_card"}]," /\n",["$","code","code-2",{"children":"revolut_pay_account"}],") for per-transaction details."]}]]}] c3c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unique identifier for the payment method."}]]}] c3d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of the payment method."}]]}] c3e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Indicates in which case this saved payment method can be used for payments."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Value","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"customer"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"This payment method can be used only when the customer is on the checkout page.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"merchant"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"This payment method can be used without the customer being on the checkout page, and the merchant can initiate transactions, for example, to take payments for recurring transactions.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] c3f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The last four digits of the debtor's IBAN."}]]}] c40:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The full name of the debtor as provided in the mandate."}]]}] c41:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The unique mandate reference generated by Revolut. Include this in pre-debit notifications sent to your customers."}]]}] c42:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The billing address associated with the payment method."}]]}] c43:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The date and time the payment method was added."}]]}] c44:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A saved SEPA Direct Debit payment method on a customer profile."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/accept-payments/payment-methods/sepa-direct-debit/server-to-server","target":"_blank","rel":"noreferrer","children":"SEPA Direct Debit server-to-server integration"}]]}]}]]}]]}] c45:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A saved payment method on a customer profile."}],"\n",["$","p","p-1",{"children":["Use the ",["$","code","code-0",{"children":"type"}]," field to determine the specific payment method variant."]}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":["This schema represents a stored credential available for future charges and supports three types: ",["$","code","code-0",{"children":"card"}],", ",["$","code","code-1",{"children":"revolut_pay"}],", and ",["$","code","code-2",{"children":"sepa_direct_debit"}],"."]}],["$","p","p-1",{"children":["It differs from the ",["$","code","code-0",{"children":"payment_method"}]," object on a Payment, which is a transactional snapshot of how a specific charge was executed and includes additional detail such as wallet wrappers (",["$","code","code-1",{"children":"apple_pay"}],", ",["$","code","code-2",{"children":"google_pay"}],") and Revolut Pay funding source (",["$","code","code-3",{"children":"revolut_pay_card"}]," vs ",["$","code","code-4",{"children":"revolut_pay_account"}],")."]}]]}]]}]]}] c46:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["Saved payment methods associated with this customer. Each entry represents a\npayment method authorised for future charges. Two types are supported: ",["$","code","code-0",{"children":"card"}],"\n(with full card details) and ",["$","code","code-1",{"children":"revolut_pay"}]," (covers both card-backed and\naccount-to-account Revolut Pay variants). Use the ",["$","code","code-2",{"children":"type"}]," field on each item\nto identify the variant."]}]]}] c47:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A customer object."}]]}] c48:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"OK"}]]}] c49:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An identifier that can be used to determine what went wrong."}],"\n",["$","p","p-1",{"children":"Error codes are not globally unique, but uniqueness is guaranteed within endpoints."}]]}] c4a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Some human readable text describing what went wrong."}]]}] c4b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://www.unixtimestamp.com/","target":"_blank","rel":"noreferrer","children":"UNIX timestamp"}]," of the date and time the error happened."]}]]}] c4c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unauthorized"}]]}] c4d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An identifier that can be used to determine what went wrong."}],"\n",["$","p","p-1",{"children":"Error codes are not globally unique, but uniqueness is guaranteed within endpoints."}]]}] c4e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Some human readable text describing what went wrong."}]]}] c4f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://www.unixtimestamp.com/","target":"_blank","rel":"noreferrer","children":"UNIX timestamp"}]," of the date and time the error happened."]}]]}] c50:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Not Found"}]]}] c55:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Get the information about a specific customer, including their saved payment methods."}]]}] c56:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["This parameter accepts the ",["$","a","a-0",{"href":"https://business.revolut.com/settings/apis?tab=merchant-api","target":"_blank","rel":"noreferrer","children":"Merchant API Secret key"}]," to authorise requests coming from the merchant's backend."]}],"\n",["$","p","p-1",{"children":["It ensures that ensures that each request is authenticated and authorised by verifying the secret key. The secret key should be included in all request headers as a ",["$","code","code-0",{"children":"Bearer"}]," token."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#authentication","target":"_blank","rel":"noreferrer","children":"Authentication"}]]}]}]]}]]}] c57:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The version of the Merchant API, specified in ",["$","code","code-0",{"children":"YYYY-MM-DD"}]," format."]}],"\n",["$","p","p-1",{"children":["This endpoint is available from version ",["$","code","code-0",{"children":"2024-09-01"}],". If a version earlier than ",["$","code","code-1",{"children":"2024-09-01"}]," is provided, the endpoint returns a ",["$","code","code-2",{"children":"404"}]," response."]}],"\n",["$","p","p-2",{"children":"If not specified, you will receive an error."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information about API versioning, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/reference/versioning/api-versions","target":"_blank","rel":"noreferrer","children":"API versions"}],"."]}]}]]}]]}] c58:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A UUID string, typically used to identify resources."}]]}] c59:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ID of the ",["$","code","code-0",{"children":"Customer"}]," object."]}]]}] c74:["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"id\": \"f757b068-f287-43c8-8d05-9c073fecbe73\",\n \"name\": \"Enterprise Pro Plan\",\n \"state\": \"active\",\n \"created_at\": \"2026-01-26T08:59:09.433527Z\",\n \"updated_at\": \"2026-01-26T08:59:09.433527Z\",\n \"variations\": [\n {\n \"id\": \"f4e0a171-4f4e-484b-b0a2-22085059af65\",\n \"phases\": [\n {\n \"id\": \"23319d04-4b23-4ae7-ba54-82112c752683\",\n \"ordinal\": 1,\n \"cycle_duration\": \"P1M\",\n \"amount\": 990,\n \"currency\": \"GBP\"\n }\n ]\n },\n {\n \"id\": \"7cf47b0d-3da9-496b-a4e9-fbbe43c33ee3\",\n \"phases\": [\n {\n \"id\": \"feed2491-c895-4bfa-ba05-a3a088842d5c\",\n \"ordinal\": 1,\n \"cycle_duration\": \"P1Y\",\n \"amount\": 9990,\n \"currency\": \"GBP\"\n }\n ]\n }\n ]\n}"}]}] c76:["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"id\": \"750e8400-e29b-41d4-a716-446655440010\",\n \"name\": \"Premium Plan with 14-day Trial\",\n \"trial_duration\": \"P14D\",\n \"state\": \"active\",\n \"created_at\": \"2025-06-04T21:00:00.036001Z\",\n \"updated_at\": \"2025-06-04T21:00:00.036001Z\",\n \"variations\": [\n {\n \"id\": \"850e8400-e29b-41d4-a716-446655440011\",\n \"phases\": [\n {\n \"id\": \"950e8400-e29b-41d4-a716-446655440012\",\n \"ordinal\": 1,\n \"cycle_duration\": \"P1M\",\n \"amount\": 9900,\n \"currency\": \"GBP\"\n }\n ]\n }\n ]\n}"}]}] c78:["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"id\": \"550e8400-e29b-41d4-a716-446655440003\",\n \"name\": \"12-month Limited Plan\",\n \"state\": \"active\",\n \"created_at\": \"2025-06-05T21:00:00.036001Z\",\n \"updated_at\": \"2025-06-05T21:00:00.036001Z\",\n \"variations\": [\n {\n \"id\": \"550e8400-e29b-41d4-a716-446655440004\",\n \"phases\": [\n {\n \"id\": \"550e8400-e29b-41d4-a716-446655440005\",\n \"ordinal\": 1,\n \"cycle_duration\": \"P1M\",\n \"cycle_count\": 12,\n \"amount\": 1000,\n \"currency\": \"GBP\"\n }\n ]\n }\n ]\n}"}]}] c67:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Each Merchant API request must contain an authorization header in the following format:"}],"\n","$Lc7d","\n",["$","p","p-1",{"children":"To use this API, you need to generate API keys from your Revolut Business account. The Secret key is used in the authorization header for all server calls, while the Public key is provided with payment methods at checkout."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For detailed instructions on generating your API keys, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/get-started#generate-api-keys","target":"_blank","rel":"noreferrer","children":"Generate API keys"}],"."]}]}]]}]]}] b46:["$","div","request-application/json-example_payment_method_update",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"
{\n  \"saved_for\": \"customer\"\n}
"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"saved_for\": \"customer\"\n}"}]}]]}] c7e:T177f,
{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "type": "card",
  "saved_for": "customer",
  "created_at": "2024-01-01T00:00:00Z",
  "bin": "string",
  "last_four": "aaaa",
  "expiry_month": 123,
  "expiry_year": 123,
  "cardholder_name": "string",
  "brand": "visa",
  "funding": "debit",
  "issuer": "string",
  "issuer_country": "aa",
  "billing_address": {
    "street_line_1": "string",
    "street_line_2": "string",
    "region": "string",
    "city": "string",
    "country_code": "aa",
    "postcode": "string"
  },
  "terminal_hardware_id": "string"
}
b47:["$","div","200-application/json-default",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$c7e"}}]}]],"$Lc7f"]}] c80:T44d,
{
  "code": "string",
  "message": "string",
  "timestamp": 123
}
b48:["$","div","401-application/json-default",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$c80"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"code\": \"string\",\n \"message\": \"string\",\n \"timestamp\": 123\n}"}]}]]}] c81:T44d,
{
  "code": "string",
  "message": "string",
  "timestamp": 123
}
b49:["$","div","404-application/json-default",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$c81"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"code\": \"string\",\n \"message\": \"string\",\n \"timestamp\": 123\n}"}]}]]}] b5f:["$","div","CodeBlock-0",{"className":"wzy01m0 _18b50nc0","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"
'Authorization: Bearer <yourSecretApiKey>'
"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"'Authorization: Bearer '\n"}]}]]}] c7f:["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"id\": \"123e4567-e89b-12d3-a456-426614174000\",\n \"type\": \"card\",\n \"saved_for\": \"customer\",\n \"created_at\": \"2024-01-01T00:00:00Z\",\n \"bin\": \"string\",\n \"last_four\": \"aaaa\",\n \"expiry_month\": 123,\n \"expiry_year\": 123,\n \"cardholder_name\": \"string\",\n \"brand\": \"visa\",\n \"funding\": \"debit\",\n \"issuer\": \"string\",\n \"issuer_country\": \"aa\",\n \"billing_address\": {\n \"street_line_1\": \"string\",\n \"street_line_2\": \"string\",\n \"region\": \"string\",\n \"city\": \"string\",\n \"country_code\": \"aa\",\n \"postcode\": \"string\"\n },\n \"terminal_hardware_id\": \"string\"\n}"}]}] c82:T1823,
{
  "id": "fccc53e9-00e0-4847-9d54-6938e9cdd3ef",
  "state": "lost",
  "substate": "lost_accepted",
  "created_at": "2025-03-12T07:00:00.000000Z",
  "updated_at": "2025-03-13T10:00:00.000000Z",
  "response_due_date": "2025-03-15T12:00:00.000000Z",
  "reason_code": "50",
  "reason_description": "Fraud",
  "amount": 1500,
  "currency": "EUR",
  "payment": {
    "id": "67810850-4c48-a25d-8765-d03d36ca6719",
    "order_id": "38bd1186-a276-4b14-91b4-5da886481f85",
    "created_at": "2025-01-02T10:00:00Z",
    "arn": "P58PC241502Q7800000000A",
    "amount": 3000,
    "currency": "EUR",
    "payment_method": {
      "type": "card",
      "card_brand": "visa",
      "card_last_four": "1234"
    }
  }
}
b61:["$","div","200-application/json-card_dispute",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$c82"}}]}]],"$Lc83"]}] c84:T1857,
{
  "id": "7a2d8f4b-1c3e-4a56-b789-0d1e2f3a4b5c",
  "state": "needs_response",
  "substate": "new",
  "created_at": "2026-05-22T09:00:00Z",
  "updated_at": "2026-05-22T09:00:00Z",
  "response_due_date": "2026-06-05T09:00:00Z",
  "reason_code": "OTHER",
  "reason_description": "merchant_dispute",
  "amount": 10000,
  "currency": "EUR",
  "payment": {
    "id": "6a0f2bc4-2137-a1ad-9eb6-b34cf4ca6597",
    "order_id": "2bcaf93a-aa87-4d3d-b5c6-62e06051cff2",
    "created_at": "2026-05-21T15:59:00.451602Z",
    "amount": 10000,
    "currency": "EUR",
    "payment_method": {
      "type": "sepa_direct_debit",
      "debtor_iban_last_four": "3273",
      "debtor_name": "John Doe",
      "mandate_reference": "69F1CB61BD99A32C8E20D7FB9E21E146"
    }
  }
}
b62:["$","div","200-application/json-sepa_direct_debit_dispute",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$c84"}}]}]],"$Lc85"]}] c86:T478,
{
  "code": "bad_request",
  "message": "Missing Revolut-Api-Version header",
  "timestamp": 1601296792533
}
b63:["$","div","400-application/json-default",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$c86"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"code\": \"bad_request\",\n \"message\": \"Missing Revolut-Api-Version header\",\n \"timestamp\": 1601296792533\n}"}]}]]}] c87:T46f,
{
  "code": "unauthenticated",
  "message": "Authentication failed",
  "timestamp": 1721049596461
}
b64:["$","div","401-application/json-default",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$c87"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"code\": \"unauthenticated\",\n \"message\": \"Authentication failed\",\n \"timestamp\": 1721049596461\n}"}]}]]}] c88:T477,
{
  "code": "not_found",
  "message": "The requested resource is not found",
  "timestamp": 1721050063886
}
b65:["$","div","404-application/json-default",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$c88"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"code\": \"not_found\",\n \"message\": \"The requested resource is not found\",\n \"timestamp\": 1721050063886\n}"}]}]]}] c83:["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"id\": \"fccc53e9-00e0-4847-9d54-6938e9cdd3ef\",\n \"state\": \"lost\",\n \"substate\": \"lost_accepted\",\n \"created_at\": \"2025-03-12T07:00:00.000000Z\",\n \"updated_at\": \"2025-03-13T10:00:00.000000Z\",\n \"response_due_date\": \"2025-03-15T12:00:00.000000Z\",\n \"reason_code\": \"50\",\n \"reason_description\": \"Fraud\",\n \"amount\": 1500,\n \"currency\": \"EUR\",\n \"payment\": {\n \"id\": \"67810850-4c48-a25d-8765-d03d36ca6719\",\n \"order_id\": \"38bd1186-a276-4b14-91b4-5da886481f85\",\n \"created_at\": \"2025-01-02T10:00:00Z\",\n \"arn\": \"P58PC241502Q7800000000A\",\n \"amount\": 3000,\n \"currency\": \"EUR\",\n \"payment_method\": {\n \"type\": \"card\",\n \"card_brand\": \"visa\",\n \"card_last_four\": \"1234\"\n }\n }\n}"}]}] c85:["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"id\": \"7a2d8f4b-1c3e-4a56-b789-0d1e2f3a4b5c\",\n \"state\": \"needs_response\",\n \"substate\": \"new\",\n \"created_at\": \"2026-05-22T09:00:00Z\",\n \"updated_at\": \"2026-05-22T09:00:00Z\",\n \"response_due_date\": \"2026-06-05T09:00:00Z\",\n \"reason_code\": \"OTHER\",\n \"reason_description\": \"merchant_dispute\",\n \"amount\": 10000,\n \"currency\": \"EUR\",\n \"payment\": {\n \"id\": \"6a0f2bc4-2137-a1ad-9eb6-b34cf4ca6597\",\n \"order_id\": \"2bcaf93a-aa87-4d3d-b5c6-62e06051cff2\",\n \"created_at\": \"2026-05-21T15:59:00.451602Z\",\n \"amount\": 10000,\n \"currency\": \"EUR\",\n \"payment_method\": {\n \"type\": \"sepa_direct_debit\",\n \"debtor_iban_last_four\": \"3273\",\n \"debtor_name\": \"John Doe\",\n \"mandate_reference\": \"69F1CB61BD99A32C8E20D7FB9E21E146\"\n }\n }\n}"}]}] b9f:["$","div","CodeBlock-0",{"className":"wzy01m0 _18b50nc0","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"
'Authorization: Bearer <yourSecretApiKey>'
"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"'Authorization: Bearer '\n"}]}]]}] c89:T2ea7,
{
  "next_page_token": "9e5d2caa-bb60-4b5b-b7cf-6345bbdff67e",
  "subscription_plans": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "name": "Premium Plan with 14-days Trial",
      "state": "active",
      "trial_duration": "P14D",
      "created_at": "2025-06-05T21:00:00.036001Z",
      "updated_at": "2025-06-05T21:00:00.036001Z",
      "variations": [
        {
          "id": "550e8400-e29b-41d4-a716-446655440001",
          "phases": [
            {
              "id": "550e8400-e29b-41d4-a716-446655440002",
              "ordinal": 1,
              "cycle_duration": "P1Y",
              "amount": 99900,
              "currency": "GBP"
            }
          ]
        }
      ]
    },
    {
      "id": "f757b068-f287-43c8-8d05-9c073fecbe73",
      "name": "Enterprise Pro Plan",
      "state": "active",
      "created_at": "2026-01-26T08:59:09.433527Z",
      "updated_at": "2026-01-26T08:59:09.433527Z",
      "variations": [
        {
          "id": "f4e0a171-4f4e-484b-b0a2-22085059af65",
          "phases": [
            {
              "id": "23319d04-4b23-4ae7-ba54-82112c752683",
              "ordinal": 1,
              "cycle_duration": "P1M",
              "amount": 990,
              "currency": "GBP"
            }
          ]
        },
        {
          "id": "7cf47b0d-3da9-496b-a4e9-fbbe43c33ee3",
          "phases": [
            {
              "id": "feed2491-c895-4bfa-ba05-a3a088842d5c",
              "ordinal": 1,
              "cycle_duration": "P1Y",
              "amount": 9990,
              "currency": "GBP"
            }
          ]
        }
      ]
    }
  ]
}
bf0:["$","div","200-application/json-plans_list",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$c89"}}]}]],"$Lc8a"]}] c8b:T44d,
{
  "code": "string",
  "message": "string",
  "timestamp": 123
}
bf1:["$","div","400-application/json-default",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$c8b"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"code\": \"string\",\n \"message\": \"string\",\n \"timestamp\": 123\n}"}]}]]}] c8c:T44d,
{
  "code": "string",
  "message": "string",
  "timestamp": 123
}
bf2:["$","div","401-application/json-default",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$c8c"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"code\": \"string\",\n \"message\": \"string\",\n \"timestamp\": 123\n}"}]}]]}] c8d:T44d,
{
  "code": "string",
  "message": "string",
  "timestamp": 123
}
bf3:["$","div","default-application/json-default",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$c8d"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"code\": \"string\",\n \"message\": \"string\",\n \"timestamp\": 123\n}"}]}]]}] c15:["$","div","CodeBlock-0",{"className":"wzy01m0 _18b50nc0","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"
'Authorization: Bearer <yourSecretApiKey>'
"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"'Authorization: Bearer '\n"}]}]]}] c8e:T665,{ "next_page_token": "9e5d2caa-bb60-4b5b-b7cf-6345bbdff67e", "subscription_plans": [ { "id": "550e8400-e29b-41d4-a716-446655440000", "name": "Premium Plan with 14-days Trial", "state": "active", "trial_duration": "P14D", "created_at": "2025-06-05T21:00:00.036001Z", "updated_at": "2025-06-05T21:00:00.036001Z", "variations": [ { "id": "550e8400-e29b-41d4-a716-446655440001", "phases": [ { "id": "550e8400-e29b-41d4-a716-446655440002", "ordinal": 1, "cycle_duration": "P1Y", "amount": 99900, "currency": "GBP" } ] } ] }, { "id": "f757b068-f287-43c8-8d05-9c073fecbe73", "name": "Enterprise Pro Plan", "state": "active", "created_at": "2026-01-26T08:59:09.433527Z", "updated_at": "2026-01-26T08:59:09.433527Z", "variations": [ { "id": "f4e0a171-4f4e-484b-b0a2-22085059af65", "phases": [ { "id": "23319d04-4b23-4ae7-ba54-82112c752683", "ordinal": 1, "cycle_duration": "P1M", "amount": 990, "currency": "GBP" } ] }, { "id": "7cf47b0d-3da9-496b-a4e9-fbbe43c33ee3", "phases": [ { "id": "feed2491-c895-4bfa-ba05-a3a088842d5c", "ordinal": 1, "cycle_duration": "P1Y", "amount": 9990, "currency": "GBP" } ] } ] } ] }c8a:["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"$c8e"}]}] c8f:T4438,
[
  {
    "id": "ab934829-e4ba-4e7f-8a21-365cad85c763",
    "state": "under_review",
    "substate": "arbitration",
    "created_at": "2024-06-13T12:06:18.732706Z",
    "updated_at": "2024-09-12T22:27:10.005680Z",
    "response_due_date": "2024-10-12T22:27:10.005625Z",
    "reason_code": "50",
    "reason_description": "Fraud",
    "amount": 50,
    "currency": "EUR",
    "payment": {
      "id": "6666f6c7-3898-a094-9c83-dc0152e0185c",
      "order_id": "6666f685-46a7-a7b9-9860-a28a4f3495a4",
      "created_at": "2024-06-10T12:51:19.960490Z",
      "amount": 50,
      "currency": "EUR",
      "payment_method": {
        "type": "revolut_pay_account"
      }
    }
  },
  {
    "id": "340b85dc-da99-4c5f-9d47-37a45d52a455",
    "state": "lost",
    "substate": "lost_expired",
    "created_at": "2024-09-11T21:20:05.659978Z",
    "updated_at": "2024-09-12T22:35:31.721921Z",
    "response_due_date": "2024-09-22T22:35:31.721860Z",
    "reason_code": "12.4",
    "reason_description": "Incorrect Account Number",
    "amount": 40,
    "currency": "EUR",
    "payment": {
      "id": "66e1fc66-7606-a7fb-b2e8-b48fb637783a",
      "order_id": "66e1fc4d-5cbe-a692-80aa-1cb912291d55",
      "created_at": "2024-09-11T20:24:06.271746Z",
      "amount": 40,
      "currency": "EUR",
      "payment_method": {
        "type": "card",
        "card_brand": "visa",
        "card_last_four": "1234"
      }
    }
  },
  {
    "id": "e9b5472b-7308-4aea-86a0-d4427bc04c24",
    "state": "lost",
    "substate": "lost_pre_arbitration",
    "created_at": "2026-05-22T09:00:00Z",
    "updated_at": "2026-05-22T10:15:00Z",
    "response_due_date": "2030-12-15T00:00:00Z",
    "reason_code": "OTHER",
    "reason_description": "merchant_dispute",
    "amount": 91700,
    "currency": "GBP",
    "payment": {
      "id": "6a0f2bc4-2137-a1ad-9eb6-b34cf4ca6597",
      "order_id": "2bcaf93a-aa87-4d3d-b5c6-62e06051cff2",
      "created_at": "2026-05-21T15:59:00.451602Z",
      "amount": 1000,
      "currency": "GBP",
      "payment_method": {
        "type": "sepa_direct_debit",
        "debtor_iban_last_four": "3273",
        "debtor_name": "John Doe",
        "mandate_reference": "69F1CB61BD99A32C8E20D7FB9E21E146"
      }
    }
  }
]
c17:["$","div","200-application/json-dispute_list",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$c8f"}}]}]],"$Lc90"]}] c91:T474,
{
  "code": "validation",
  "message": "limit must be between 1 and 500",
  "timestamp": 1601296792533
}
c18:["$","div","400-application/json-default",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$c91"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"code\": \"validation\",\n \"message\": \"limit must be between 1 and 500\",\n \"timestamp\": 1601296792533\n}"}]}]]}] c92:T46f,
{
  "code": "unauthenticated",
  "message": "Authentication failed",
  "timestamp": 1721049596461
}
c19:["$","div","401-application/json-default",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$c92"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"code\": \"unauthenticated\",\n \"message\": \"Authentication failed\",\n \"timestamp\": 1721049596461\n}"}]}]]}] c53:["$","div","CodeBlock-0",{"className":"wzy01m0 _18b50nc0","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"
'Authorization: Bearer <yourSecretApiKey>'
"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"'Authorization: Bearer '\n"}]}]]}] c93:T8b4,[ { "id": "ab934829-e4ba-4e7f-8a21-365cad85c763", "state": "under_review", "substate": "arbitration", "created_at": "2024-06-13T12:06:18.732706Z", "updated_at": "2024-09-12T22:27:10.005680Z", "response_due_date": "2024-10-12T22:27:10.005625Z", "reason_code": "50", "reason_description": "Fraud", "amount": 50, "currency": "EUR", "payment": { "id": "6666f6c7-3898-a094-9c83-dc0152e0185c", "order_id": "6666f685-46a7-a7b9-9860-a28a4f3495a4", "created_at": "2024-06-10T12:51:19.960490Z", "amount": 50, "currency": "EUR", "payment_method": { "type": "revolut_pay_account" } } }, { "id": "340b85dc-da99-4c5f-9d47-37a45d52a455", "state": "lost", "substate": "lost_expired", "created_at": "2024-09-11T21:20:05.659978Z", "updated_at": "2024-09-12T22:35:31.721921Z", "response_due_date": "2024-09-22T22:35:31.721860Z", "reason_code": "12.4", "reason_description": "Incorrect Account Number", "amount": 40, "currency": "EUR", "payment": { "id": "66e1fc66-7606-a7fb-b2e8-b48fb637783a", "order_id": "66e1fc4d-5cbe-a692-80aa-1cb912291d55", "created_at": "2024-09-11T20:24:06.271746Z", "amount": 40, "currency": "EUR", "payment_method": { "type": "card", "card_brand": "visa", "card_last_four": "1234" } } }, { "id": "e9b5472b-7308-4aea-86a0-d4427bc04c24", "state": "lost", "substate": "lost_pre_arbitration", "created_at": "2026-05-22T09:00:00Z", "updated_at": "2026-05-22T10:15:00Z", "response_due_date": "2030-12-15T00:00:00Z", "reason_code": "OTHER", "reason_description": "merchant_dispute", "amount": 91700, "currency": "GBP", "payment": { "id": "6a0f2bc4-2137-a1ad-9eb6-b34cf4ca6597", "order_id": "2bcaf93a-aa87-4d3d-b5c6-62e06051cff2", "created_at": "2026-05-21T15:59:00.451602Z", "amount": 1000, "currency": "GBP", "payment_method": { "type": "sepa_direct_debit", "debtor_iban_last_four": "3273", "debtor_name": "John Doe", "mandate_reference": "69F1CB61BD99A32C8E20D7FB9E21E146" } } } ]c90:["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"$c93"}]}] 26:["$","$7a","update-customer",{"children":[["$","section",null,{"className":"y9a0do0","data-variant":"endpoint","children":["$","$L7b",null,{"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"title":"Customer","type":"object","description":"A customer object.","properties":{"id":{"type":"string","format":"uuid","description":"Unique identifier for the customer.","descriptionNode":"$Lc94"},"full_name":{"type":"string","description":"The full name of the customer.","descriptionNode":"$Lc95"},"email":{"type":"string","format":"email","description":"The email address of the customer.","descriptionNode":"$Lc96"},"phone":{"type":"string","description":"The phone number of the customer in [E.164 format](https://en.wikipedia.org/wiki/E.164).","descriptionNode":"$Lc97"},"created_at":{"type":"string","format":"date-time","description":"The date and time the customer was created.","descriptionNode":"$Lc98"},"updated_at":{"type":"string","format":"date-time","description":"The date and time the customer was last updated.","descriptionNode":"$Lc99"},"payment_methods":{"type":"array","description":"Saved payment methods associated with this customer. Each entry represents a\npayment method authorised for future charges. Two types are supported: `card`\n(with full card details) and `revolut_pay` (covers both card-backed and\naccount-to-account Revolut Pay variants). Use the `type` field on each item\nto identify the variant.","items":{"title":"Payment method","description":"A saved payment method on a customer profile.\n\nUse the `type` field to determine the specific payment method variant.\n\n:::note\nThis schema represents a stored credential available for future charges and supports three types: `card`, `revolut_pay`, and `sepa_direct_debit`.\n\nIt differs from the `payment_method` object on a Payment, which is a transactional snapshot of how a specific charge was executed and includes additional detail such as wallet wrappers (`apple_pay`, `google_pay`) and Revolut Pay funding source (`revolut_pay_card` vs `revolut_pay_account`).\n:::","discriminator":"$29:props:children:0:props:children:props:responses:200:content:application/json:schema:discriminator","oneOf":[{"title":"Card payment method","type":"object","description":"A saved card payment method.\n\n:::info\nThe `checks` object (3DS, CVV, address verification) is not included as it is specific to the transactional payment context.\n:::","properties":{"id":{"type":"string","format":"uuid","description":"Unique identifier for the payment method.","descriptionNode":"$Lc9a"},"type":{"type":"string","description":"The type of the payment method.","enum":"$29:props:children:0:props:children:props:responses:200:content:application/json:schema:oneOf:0:properties:type:enum","descriptionNode":"$Lc9b"},"saved_for":{"type":"string","enum":"$29:props:children:0:props:children:props:responses:200:content:application/json:schema:oneOf:0:properties:saved_for:enum","description":"Indicates in which case this saved payment method can be used for payments.\n\n| Value | Description |\n| ----- | ----------- |\n| `customer` | This payment method can be used only when the customer is on the checkout page. |\n| `merchant` | This payment method can be used without the customer being on the checkout page, and the merchant can initiate transactions, for example, to take payments for recurring transactions. |","descriptionNode":"$Lc9c"},"created_at":{"type":"string","format":"date-time","description":"The date and time the payment method was added.","descriptionNode":"$Lc9d"},"bin":{"type":"string","description":"The BIN (Bank Identification Number) of the payment card, typically the first 6-8 digits.","descriptionNode":"$Lc9e"},"last_four":{"type":"string","minLength":4,"maxLength":4,"description":"The last four digits of the payment card number.","descriptionNode":"$Lc9f"},"expiry_month":{"type":"integer","description":"The expiry month of the payment card.","descriptionNode":"$Lca0"},"expiry_year":{"type":"integer","description":"The expiry year of the payment card.","descriptionNode":"$Lca1"},"cardholder_name":{"type":"string","description":"The name of the cardholder as it appears on the card.","descriptionNode":"$Lca2"},"brand":{"type":"string","description":"The brand of the payment card.","enum":"$29:props:children:0:props:children:props:responses:200:content:application/json:schema:oneOf:0:properties:brand:enum","descriptionNode":"$Lca3"},"funding":{"type":"string","description":"The funding type of the payment card.","enum":"$29:props:children:0:props:children:props:responses:200:content:application/json:schema:oneOf:0:properties:funding:enum","descriptionNode":"$Lca4"},"issuer":{"type":"string","description":"The name of the card-issuing bank or institution.","descriptionNode":"$Lca5"},"issuer_country":{"type":"string","minLength":2,"maxLength":2,"description":"The ISO 3166-1 alpha-2 country code of the country where the payment card was issued.","descriptionNode":"$Lca6"},"billing_address":{"title":"Billing address","type":"object","description":"The billing address associated with the payment method.","properties":{"street_line_1":{"type":"string","description":"Primary address line.","maxLength":100,"descriptionNode":"$Lca7"},"street_line_2":{"type":"string","description":"Secondary address line, such as floor and apartment number.","maxLength":100,"descriptionNode":"$Lca8"},"region":{"type":"string","description":"State or province of the address.","maxLength":100,"descriptionNode":"$Lca9"},"city":{"type":"string","description":"City of the address.","maxLength":100,"descriptionNode":"$Lcaa"},"country_code":{"type":"string","pattern":"^[A-Z]{2}$","description":"ISO 2-letter country code.","minLength":2,"maxLength":2,"descriptionNode":"$Lcab"},"postcode":{"type":"string","description":"Postal code of the address.","maxLength":100,"descriptionNode":"$Lcac"}},"required":"$29:props:children:0:props:children:props:responses:200:content:application/json:schema:oneOf:0:properties:billing_address:required","descriptionNode":"$Lcad"},"terminal_hardware_id":{"type":"string","description":"The hardware identifier of the Revolut Terminal device used to process the payment.\n\n:::note\nOnly present for card-present transactions processed via Revolut Terminal.\n:::","descriptionNode":"$Lcae"}},"required":"$29:props:children:0:props:children:props:responses:200:content:application/json:schema:oneOf:0:required","descriptionNode":"$Lcaf"},{"title":"Revolut Pay payment method","type":"object","description":"A saved Revolut Pay payment method on a customer profile.\n\nBoth Revolut Pay card-backed and account-to-account (A2A) variants are\nrepresented by this single type at the saved payment method level.\nNo underlying card details are exposed here; use the order-level\n`payments[].payment_method` object (types `revolut_pay_card` /\n`revolut_pay_account`) for per-transaction details.","properties":{"id":{"type":"string","format":"uuid","description":"Unique identifier for the payment method.","descriptionNode":"$Lcb0"},"type":{"type":"string","description":"The type of the payment method.","enum":"$29:props:children:0:props:children:props:responses:200:content:application/json:schema:oneOf:0:properties:type:enum","descriptionNode":"$Lcb1"},"saved_for":{"type":"string","enum":"$29:props:children:0:props:children:props:responses:200:content:application/json:schema:oneOf:0:properties:saved_for:enum","description":"Indicates in which case this saved payment method can be used for payments.\n\n| Value | Description |\n| ----- | ----------- |\n| `customer` | This payment method can be used only when the customer is on the checkout page. |\n| `merchant` | This payment method can be used without the customer being on the checkout page, and the merchant can initiate transactions, for example, to take payments for recurring transactions. |","descriptionNode":"$Lcb2"},"created_at":{"type":"string","format":"date-time","description":"The date and time the payment method was added.","descriptionNode":"$Lcb3"}},"required":"$29:props:children:0:props:children:props:responses:200:content:application/json:schema:oneOf:1:required","descriptionNode":"$Lcb4"},{"title":"SEPA Direct Debit payment method","type":"object","description":"A saved SEPA Direct Debit payment method on a customer profile.\n\n:::info\nFor more information, see: [SEPA Direct Debit server-to-server integration](https://developer.revolut.com/docs/guides/merchant/accept-payments/payment-methods/sepa-direct-debit/server-to-server)\n:::","properties":{"id":{"type":"string","format":"uuid","description":"Unique identifier for the payment method.","descriptionNode":"$Lcb5"},"type":{"type":"string","description":"The type of the payment method.","enum":"$29:props:children:0:props:children:props:responses:200:content:application/json:schema:oneOf:0:properties:type:enum","descriptionNode":"$Lcb6"},"saved_for":{"type":"string","enum":"$29:props:children:0:props:children:props:responses:200:content:application/json:schema:oneOf:0:properties:saved_for:enum","description":"Indicates in which case this saved payment method can be used for payments.\n\n| Value | Description |\n| ----- | ----------- |\n| `customer` | This payment method can be used only when the customer is on the checkout page. |\n| `merchant` | This payment method can be used without the customer being on the checkout page, and the merchant can initiate transactions, for example, to take payments for recurring transactions. |","descriptionNode":"$Lcb7"},"debtor_iban_last_four":{"type":"string","description":"The last four digits of the debtor's IBAN.","minLength":4,"maxLength":4,"descriptionNode":"$Lcb8"},"debtor_name":{"type":"string","description":"The full name of the debtor as provided in the mandate.","descriptionNode":"$Lcb9"},"mandate_reference":{"type":"string","description":"The unique mandate reference generated by Revolut. Include this in pre-debit notifications sent to your customers.","descriptionNode":"$Lcba"},"billing_address":{"title":"Billing address","type":"object","description":"The billing address associated with the payment method.","properties":{"street_line_1":"$26:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_methods:items:oneOf:0:properties:billing_address:properties:street_line_1","street_line_2":"$26:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_methods:items:oneOf:0:properties:billing_address:properties:street_line_2","region":"$26:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_methods:items:oneOf:0:properties:billing_address:properties:region","city":"$26:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_methods:items:oneOf:0:properties:billing_address:properties:city","country_code":"$26:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_methods:items:oneOf:0:properties:billing_address:properties:country_code","postcode":"$26:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_methods:items:oneOf:0:properties:billing_address:properties:postcode"},"required":"$29:props:children:0:props:children:props:responses:200:content:application/json:schema:oneOf:0:properties:billing_address:required","descriptionNode":"$Lcbb"},"created_at":{"type":"string","format":"date-time","description":"The date and time the payment method was added.","descriptionNode":"$Lcbc"}},"required":"$29:props:children:0:props:children:props:responses:200:content:application/json:schema:oneOf:2:required","descriptionNode":"$Lcbd"}],"descriptionNode":"$Lcbe"},"descriptionNode":"$Lcbf"}},"required":"$25:props:children:0:props:children:props:responses:200:content:application/json:schema:required","descriptionNode":"$Lcc0"},"examples":{"updated_customer":{"summary":"Customer","value":"$25:props:children:0:props:children:props:responses:200:content:application/json:examples:retrieved_customer:value"}}}},"descriptionNode":"$Lcc1"},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"code":{"type":"string","description":"An identifier that can be used to determine what went wrong.\n\nError codes are not globally unique, but uniqueness is guaranteed within endpoints.","descriptionNode":"$Lcc2"},"message":{"type":"string","description":"Some human readable text describing what went wrong.","descriptionNode":"$Lcc3"},"timestamp":{"type":"integer","description":"The [UNIX timestamp](https://www.unixtimestamp.com/) of the date and time the error happened.","descriptionNode":"$Lcc4"}}}}},"descriptionNode":"$Lcc5"},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"code":{"type":"string","description":"An identifier that can be used to determine what went wrong.\n\nError codes are not globally unique, but uniqueness is guaranteed within endpoints.","descriptionNode":"$Lcc6"},"message":{"type":"string","description":"Some human readable text describing what went wrong.","descriptionNode":"$Lcc7"},"timestamp":{"type":"integer","description":"The [UNIX timestamp](https://www.unixtimestamp.com/) of the date and time the error happened.","descriptionNode":"$Lcc8"}}}}},"descriptionNode":"$Lcc9"},"404":{"description":"Not Found","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"code":{"type":"string","description":"An identifier that can be used to determine what went wrong.\n\nError codes are not globally unique, but uniqueness is guaranteed within endpoints.","descriptionNode":"$Lcca"},"message":{"type":"string","description":"Some human readable text describing what went wrong.","descriptionNode":"$Lccb"},"timestamp":{"type":"integer","description":"The [UNIX timestamp](https://www.unixtimestamp.com/) of the date and time the error happened.","descriptionNode":"$Lccc"}}}}},"descriptionNode":"$Lccd"}},"requestBody":{"content":{"application/json":{"schema":{"title":"Customer update","type":"object","description":"The request body for updating a customer.\n\nAll fields are optional. Only the fields provided in the request will be updated.\n\n:::note\n`business_name` is not supported in this version of the API.\n:::","properties":{"full_name":{"type":"string","description":"The full name of the customer.","descriptionNode":"$Lcce"},"email":{"type":"string","format":"email","description":"The email address of the customer.","descriptionNode":"$Lccf"},"phone":{"type":"string","description":"The phone number of the customer in [E.164 format](https://en.wikipedia.org/wiki/E.164).","descriptionNode":"$Lcd0"},"date_of_birth":{"type":"string","format":"date","description":"The birth date of the customer.","descriptionNode":"$Lcd1"}},"descriptionNode":"$Lcd2"},"examples":{"example_customer_update":{"summary":"Update a customer","value":{"email":"updated.customer@example.com"}}}}}},"variantLabels":[],"children":["$Lcd3","$Lcd4"]}]}],false]}] cd3:["$","div",null,{"className":"ezz1n30","children":[["$","div",null,{"data-header":"$undefined","className":"ezz1n31","children":["$","div",null,{"className":"y9a0do1","children":[["$","h2",null,{"id":"update-customer","children":[["$Lcd5","$undefined"],["$","$L15",null,{"id":"update-customer"}]]}],["$","$L16",null,{"url":"/docs/api/merchant/2025-10-16/operations/update-customer.md"}]]}]}],"$undefined"]}] cdb:T64e,
curl -X PATCH "https://merchant.revolut.com/api/customers/__RP_TOK_0__" \
  -H "Content-Type: application/json" \
  -H "Authorization: __RP_TOK_1__" \
  -H "Revolut-Api-Version: __RP_TOK_2__" \
  -d '{
  "email": "updated.customer@example.com"
}'
cdc:Te97,
const payload = {
  "email": "updated.customer@example.com"
};
fetch("https://merchant.revolut.com/api/customers/__RP_TOK_0__", {
  method: "PATCH",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "__RP_TOK_1__",
    "Revolut-Api-Version": "__RP_TOK_2__"
  },
  body: JSON.stringify(payload)
})
  .then(response => response.json())
  .then(data => console.log(data));
cdd:T1633,
package main

import (
  "fmt"
  "net/http"
  "bytes"
  "encoding/json"
)

func main() {
  url := "https://merchant.revolut.com/api/customers/__RP_TOK_0__"
  jsonData := []byte(`
{
  "email": "updated.customer@example.com"
}
  `)
  req, _ := http.NewRequest("PATCH", url, bytes.NewBuffer(jsonData))
  req.Header.Add("Content-Type", "application/json")
  req.Header.Add("Authorization", "__RP_TOK_1__")
  req.Header.Add("Revolut-Api-Version", "__RP_TOK_2__")

  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  fmt.Println(res)
}
cde:Tbcb,
import requests

url = "https://merchant.revolut.com/api/customers/__RP_TOK_0__"
headers = {
  "Content-Type": "application/json",
  "Authorization": "__RP_TOK_1__",
  "Revolut-Api-Version": "__RP_TOK_2__"
}
payload = {
  "email": "updated.customer@example.com"
}

response = requests.patch(url, headers=headers, json=payload)
print(response.json())
cdf:T1b97,
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;

public class Main {
  public static void main(String[] args) {
    HttpClient client = HttpClient.newHttpClient();
    String body = """
{
  "email": "updated.customer@example.com"
}
    """;

    HttpRequest request = HttpRequest.newBuilder()
      .uri(URI.create("https://merchant.revolut.com/api/customers/__RP_TOK_0__"))
      .header("Content-Type", "application/json")
      .header("Authorization", "__RP_TOK_1__")
      .header("Revolut-Api-Version", "__RP_TOK_2__")
      .PATCH(HttpRequest.BodyPublishers.ofString(body))
      .build();

    client.sendAsync(request, HttpResponse.BodyHandlers.ofString())
      .thenApply(HttpResponse::body)
      .thenAccept(System.out::println)
      .join();
  }
}
ce0:T1d7f,
using System.Net.Http;
using System.Net.Http.Headers;

var client = new HttpClient();
var request = new HttpRequestMessage
{
  Method = HttpMethod.Patch,
  RequestUri = new Uri("https://merchant.revolut.com/api/customers/__RP_TOK_0__"),
  Headers =
  {
    { "Authorization", "__RP_TOK_1__" },
    { "Revolut-Api-Version", "__RP_TOK_2__" },
  },
  Content = new StringContent(@"{
  ""email"": ""updated.customer@example.com""
}")
  {
    Headers =
    {
      ContentType = new MediaTypeHeaderValue("application/json")
    }
  }
};

using (var response = await client.SendAsync(request))
{
  response.EnsureSuccessStatusCode();
  var body = await response.Content.ReadAsStringAsync();
  Console.WriteLine(body);
}
ce1:T656,
curl -X PATCH "https://sandbox-merchant.revolut.com/api/customers/__RP_TOK_0__" \
  -H "Content-Type: application/json" \
  -H "Authorization: __RP_TOK_1__" \
  -H "Revolut-Api-Version: __RP_TOK_2__" \
  -d '{
  "email": "updated.customer@example.com"
}'
ce2:Te9f,
const payload = {
  "email": "updated.customer@example.com"
};
fetch("https://sandbox-merchant.revolut.com/api/customers/__RP_TOK_0__", {
  method: "PATCH",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "__RP_TOK_1__",
    "Revolut-Api-Version": "__RP_TOK_2__"
  },
  body: JSON.stringify(payload)
})
  .then(response => response.json())
  .then(data => console.log(data));
ce3:T163b,
package main

import (
  "fmt"
  "net/http"
  "bytes"
  "encoding/json"
)

func main() {
  url := "https://sandbox-merchant.revolut.com/api/customers/__RP_TOK_0__"
  jsonData := []byte(`
{
  "email": "updated.customer@example.com"
}
  `)
  req, _ := http.NewRequest("PATCH", url, bytes.NewBuffer(jsonData))
  req.Header.Add("Content-Type", "application/json")
  req.Header.Add("Authorization", "__RP_TOK_1__")
  req.Header.Add("Revolut-Api-Version", "__RP_TOK_2__")

  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  fmt.Println(res)
}
ce4:Tbd3,
import requests

url = "https://sandbox-merchant.revolut.com/api/customers/__RP_TOK_0__"
headers = {
  "Content-Type": "application/json",
  "Authorization": "__RP_TOK_1__",
  "Revolut-Api-Version": "__RP_TOK_2__"
}
payload = {
  "email": "updated.customer@example.com"
}

response = requests.patch(url, headers=headers, json=payload)
print(response.json())
ce5:T1b9f,
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;

public class Main {
  public static void main(String[] args) {
    HttpClient client = HttpClient.newHttpClient();
    String body = """
{
  "email": "updated.customer@example.com"
}
    """;

    HttpRequest request = HttpRequest.newBuilder()
      .uri(URI.create("https://sandbox-merchant.revolut.com/api/customers/__RP_TOK_0__"))
      .header("Content-Type", "application/json")
      .header("Authorization", "__RP_TOK_1__")
      .header("Revolut-Api-Version", "__RP_TOK_2__")
      .PATCH(HttpRequest.BodyPublishers.ofString(body))
      .build();

    client.sendAsync(request, HttpResponse.BodyHandlers.ofString())
      .thenApply(HttpResponse::body)
      .thenAccept(System.out::println)
      .join();
  }
}
ce6:T1d87,
using System.Net.Http;
using System.Net.Http.Headers;

var client = new HttpClient();
var request = new HttpRequestMessage
{
  Method = HttpMethod.Patch,
  RequestUri = new Uri("https://sandbox-merchant.revolut.com/api/customers/__RP_TOK_0__"),
  Headers =
  {
    { "Authorization", "__RP_TOK_1__" },
    { "Revolut-Api-Version", "__RP_TOK_2__" },
  },
  Content = new StringContent(@"{
  ""email"": ""updated.customer@example.com""
}")
  {
    Headers =
    {
      ContentType = new MediaTypeHeaderValue("application/json")
    }
  }
};

using (var response = await client.SendAsync(request))
{
  response.EnsureSuccessStatusCode();
  var body = await response.Content.ReadAsStringAsync();
  Console.WriteLine(body);
}
cd4:["$","div",null,{"className":"ezz1n30","children":[["$","div",null,{"data-header":"$undefined","className":"ezz1n31","children":["$Lcd6",["$","$L85",null,{"parameters":[{"name":"Authorization","in":"header","schema":{"type":"string","format":"Bearer ","examples":"$62:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:0:schema:examples"},"required":true,"description":"This parameter accepts the [Merchant API Secret key](https://business.revolut.com/settings/apis?tab=merchant-api) to authorise requests coming from the merchant's backend. \n\nIt ensures that ensures that each request is authenticated and authorised by verifying the secret key. The secret key should be included in all request headers as a `Bearer` token.\n\n:::info\nFor more information, see: [Authentication](https://developer.revolut.com/docs/api/merchant#authentication)\n:::","descriptionNode":"$Lcd7"},{"name":"Revolut-Api-Version","in":"header","schema":{"type":"string","format":"date","enum":"$27:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:1:schema:enum","examples":"$27:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:1:schema:examples"},"required":true,"description":"The version of the Merchant API, specified in `YYYY-MM-DD` format.\n\nThis endpoint is available from version `2024-09-01`. If a version earlier than `2024-09-01` is provided, the endpoint returns a `404` response.\n\nIf not specified, you will receive an error.\n\n\n:::info\nFor more information about API versioning, see: [API versions](https://developer.revolut.com/docs/guides/merchant/reference/versioning/api-versions).\n:::","x-config-always-visible-in-example":true,"example":"2025-10-16","descriptionNode":"$Lcd8"},{"name":"customer_id","in":"path","schema":{"type":"string","format":"uuid","description":"A UUID string, typically used to identify resources.","descriptionNode":"$Lcd9"},"required":true,"description":"The ID of the `Customer` object.","descriptionNode":"$Lcda"}],"requestBody":"$26:props:children:0:props:children:props:requestBody","heading":"Request","requestBodySchemaTitle":"Request body","headingAs":"h3"}],["$","$L89",null,{"responses":"$26:props:children:0:props:children:props:responses","headingAs":"h3"}]]}],["$","div",null,{"className":"ezz1n32","children":[[["$","$L8a",null,{"itemsByServer":{"https://merchant.revolut.com":[{"id":"curl","label":"cURL","templateCode":"curl -X PATCH \"https://merchant.revolut.com/api/customers/__RP_TOK_0__\" \\\n -H \"Content-Type: application/json\" \\\n -H \"Authorization: __RP_TOK_1__\" \\\n -H \"Revolut-Api-Version: __RP_TOK_2__\" \\\n -d '{\n \"email\": \"updated.customer@example.com\"\n}'","templateHtml":"$cdb","tokens":[{"marker":"__RP_TOK_0__","paramName":"customer_id","paramIn":"path","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["shell-double-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:customer_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"javascript","label":"JavaScript","templateCode":"const payload = {\n \"email\": \"updated.customer@example.com\"\n};\nfetch(\"https://merchant.revolut.com/api/customers/__RP_TOK_0__\", {\n method: \"PATCH\",\n headers: {\n \"Content-Type\": \"application/json\",\n \"Authorization\": \"__RP_TOK_1__\",\n \"Revolut-Api-Version\": \"__RP_TOK_2__\"\n },\n body: JSON.stringify(payload)\n})\n .then(response => response.json())\n .then(data => console.log(data));","templateHtml":"$cdc","tokens":[{"marker":"__RP_TOK_0__","paramName":"customer_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:customer_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"go","label":"Go","templateCode":"package main\n\nimport (\n \"fmt\"\n \"net/http\"\n \"bytes\"\n \"encoding/json\"\n)\n\nfunc main() {\n url := \"https://merchant.revolut.com/api/customers/__RP_TOK_0__\"\n jsonData := []byte(`\n{\n \"email\": \"updated.customer@example.com\"\n}\n `)\n req, _ := http.NewRequest(\"PATCH\", url, bytes.NewBuffer(jsonData))\n req.Header.Add(\"Content-Type\", \"application/json\")\n req.Header.Add(\"Authorization\", \"__RP_TOK_1__\")\n req.Header.Add(\"Revolut-Api-Version\", \"__RP_TOK_2__\")\n\n res, _ := http.DefaultClient.Do(req)\n defer res.Body.Close()\n fmt.Println(res)\n}","templateHtml":"$cdd","tokens":[{"marker":"__RP_TOK_0__","paramName":"customer_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:customer_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"python","label":"Python","templateCode":"import requests\n\nurl = \"https://merchant.revolut.com/api/customers/__RP_TOK_0__\"\nheaders = {\n \"Content-Type\": \"application/json\",\n \"Authorization\": \"__RP_TOK_1__\",\n \"Revolut-Api-Version\": \"__RP_TOK_2__\"\n}\npayload = {\n \"email\": \"updated.customer@example.com\"\n}\n\nresponse = requests.patch(url, headers=headers, json=payload)\nprint(response.json())","templateHtml":"$cde","tokens":[{"marker":"__RP_TOK_0__","paramName":"customer_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:customer_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"java","label":"Java","templateCode":"import java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\nimport java.net.URI;\n\npublic class Main {\n public static void main(String[] args) {\n HttpClient client = HttpClient.newHttpClient();\n String body = \"\"\"\n{\n \"email\": \"updated.customer@example.com\"\n}\n \"\"\";\n\n HttpRequest request = HttpRequest.newBuilder()\n .uri(URI.create(\"https://merchant.revolut.com/api/customers/__RP_TOK_0__\"))\n .header(\"Content-Type\", \"application/json\")\n .header(\"Authorization\", \"__RP_TOK_1__\")\n .header(\"Revolut-Api-Version\", \"__RP_TOK_2__\")\n .PATCH(HttpRequest.BodyPublishers.ofString(body))\n .build();\n\n client.sendAsync(request, HttpResponse.BodyHandlers.ofString())\n .thenApply(HttpResponse::body)\n .thenAccept(System.out::println)\n .join();\n }\n}","templateHtml":"$cdf","tokens":[{"marker":"__RP_TOK_0__","paramName":"customer_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:customer_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"csharp","label":"C#","templateCode":"using System.Net.Http;\nusing System.Net.Http.Headers;\n\nvar client = new HttpClient();\nvar request = new HttpRequestMessage\n{\n Method = HttpMethod.Patch,\n RequestUri = new Uri(\"https://merchant.revolut.com/api/customers/__RP_TOK_0__\"),\n Headers =\n {\n { \"Authorization\", \"__RP_TOK_1__\" },\n { \"Revolut-Api-Version\", \"__RP_TOK_2__\" },\n },\n Content = new StringContent(@\"{\n \"\"email\"\": \"\"updated.customer@example.com\"\"\n}\")\n {\n Headers =\n {\n ContentType = new MediaTypeHeaderValue(\"application/json\")\n }\n }\n};\n\nusing (var response = await client.SendAsync(request))\n{\n response.EnsureSuccessStatusCode();\n var body = await response.Content.ReadAsStringAsync();\n Console.WriteLine(body);\n}","templateHtml":"$ce0","tokens":[{"marker":"__RP_TOK_0__","paramName":"customer_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:customer_id":"123e4567-e89b-12d3-a456-426614174000"}}],"https://sandbox-merchant.revolut.com":[{"id":"curl","label":"cURL","templateCode":"curl -X PATCH \"https://sandbox-merchant.revolut.com/api/customers/__RP_TOK_0__\" \\\n -H \"Content-Type: application/json\" \\\n -H \"Authorization: __RP_TOK_1__\" \\\n -H \"Revolut-Api-Version: __RP_TOK_2__\" \\\n -d '{\n \"email\": \"updated.customer@example.com\"\n}'","templateHtml":"$ce1","tokens":[{"marker":"__RP_TOK_0__","paramName":"customer_id","paramIn":"path","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["shell-double-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:customer_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"javascript","label":"JavaScript","templateCode":"const payload = {\n \"email\": \"updated.customer@example.com\"\n};\nfetch(\"https://sandbox-merchant.revolut.com/api/customers/__RP_TOK_0__\", {\n method: \"PATCH\",\n headers: {\n \"Content-Type\": \"application/json\",\n \"Authorization\": \"__RP_TOK_1__\",\n \"Revolut-Api-Version\": \"__RP_TOK_2__\"\n },\n body: JSON.stringify(payload)\n})\n .then(response => response.json())\n .then(data => console.log(data));","templateHtml":"$ce2","tokens":[{"marker":"__RP_TOK_0__","paramName":"customer_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:customer_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"go","label":"Go","templateCode":"package main\n\nimport (\n \"fmt\"\n \"net/http\"\n \"bytes\"\n \"encoding/json\"\n)\n\nfunc main() {\n url := \"https://sandbox-merchant.revolut.com/api/customers/__RP_TOK_0__\"\n jsonData := []byte(`\n{\n \"email\": \"updated.customer@example.com\"\n}\n `)\n req, _ := http.NewRequest(\"PATCH\", url, bytes.NewBuffer(jsonData))\n req.Header.Add(\"Content-Type\", \"application/json\")\n req.Header.Add(\"Authorization\", \"__RP_TOK_1__\")\n req.Header.Add(\"Revolut-Api-Version\", \"__RP_TOK_2__\")\n\n res, _ := http.DefaultClient.Do(req)\n defer res.Body.Close()\n fmt.Println(res)\n}","templateHtml":"$ce3","tokens":[{"marker":"__RP_TOK_0__","paramName":"customer_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:customer_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"python","label":"Python","templateCode":"import requests\n\nurl = \"https://sandbox-merchant.revolut.com/api/customers/__RP_TOK_0__\"\nheaders = {\n \"Content-Type\": \"application/json\",\n \"Authorization\": \"__RP_TOK_1__\",\n \"Revolut-Api-Version\": \"__RP_TOK_2__\"\n}\npayload = {\n \"email\": \"updated.customer@example.com\"\n}\n\nresponse = requests.patch(url, headers=headers, json=payload)\nprint(response.json())","templateHtml":"$ce4","tokens":[{"marker":"__RP_TOK_0__","paramName":"customer_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:customer_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"java","label":"Java","templateCode":"import java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\nimport java.net.URI;\n\npublic class Main {\n public static void main(String[] args) {\n HttpClient client = HttpClient.newHttpClient();\n String body = \"\"\"\n{\n \"email\": \"updated.customer@example.com\"\n}\n \"\"\";\n\n HttpRequest request = HttpRequest.newBuilder()\n .uri(URI.create(\"https://sandbox-merchant.revolut.com/api/customers/__RP_TOK_0__\"))\n .header(\"Content-Type\", \"application/json\")\n .header(\"Authorization\", \"__RP_TOK_1__\")\n .header(\"Revolut-Api-Version\", \"__RP_TOK_2__\")\n .PATCH(HttpRequest.BodyPublishers.ofString(body))\n .build();\n\n client.sendAsync(request, HttpResponse.BodyHandlers.ofString())\n .thenApply(HttpResponse::body)\n .thenAccept(System.out::println)\n .join();\n }\n}","templateHtml":"$ce5","tokens":[{"marker":"__RP_TOK_0__","paramName":"customer_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:customer_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"csharp","label":"C#","templateCode":"using System.Net.Http;\nusing System.Net.Http.Headers;\n\nvar client = new HttpClient();\nvar request = new HttpRequestMessage\n{\n Method = HttpMethod.Patch,\n RequestUri = new Uri(\"https://sandbox-merchant.revolut.com/api/customers/__RP_TOK_0__\"),\n Headers =\n {\n { \"Authorization\", \"__RP_TOK_1__\" },\n { \"Revolut-Api-Version\", \"__RP_TOK_2__\" },\n },\n Content = new StringContent(@\"{\n \"\"email\"\": \"\"updated.customer@example.com\"\"\n}\")\n {\n Headers =\n {\n ContentType = new MediaTypeHeaderValue(\"application/json\")\n }\n }\n};\n\nusing (var response = await client.SendAsync(request))\n{\n response.EnsureSuccessStatusCode();\n var body = await response.Content.ReadAsStringAsync();\n Console.WriteLine(body);\n}","templateHtml":"$ce6","tokens":[{"marker":"__RP_TOK_0__","paramName":"customer_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:customer_id":"123e4567-e89b-12d3-a456-426614174000"}}]},"method":"patch","servers":"$62:props:children:0:props:children:props:children:1:props:children:1:props:children:0:0:props:servers","path":"/api/customers/{customer_id}","parameters":["$cd4:props:children:0:props:children:1:props:parameters:0","$cd4:props:children:0:props:children:1:props:parameters:1","$cd4:props:children:0:props:children:1:props:parameters:2"]}],"$Lce7"],"$Lce8","$Lce9"]}]]}] cea:T34c8,
{
  "id": "6c7c97a8-cfc1-4cf3-8b38-26a74fdf1fae",
  "full_name": "Example Customer",
  "email": "example.customer@example.com",
  "phone": "+441234567890",
  "created_at": "2020-06-24T12:03:39.979397Z",
  "updated_at": "2020-06-25T10:03:39.134417Z",
  "payment_methods": [
    {
      "id": "648334a8-9546-a983-a81a-efc6d5bdd0be",
      "type": "revolut_pay",
      "saved_for": "merchant",
      "created_at": "2023-06-09T14:18:16.577888Z"
    },
    {
      "id": "edef3ba4-60a0-4df3-8f12-e5fc858c2420",
      "type": "card",
      "saved_for": "customer",
      "created_at": "2023-03-24T14:15:22Z",
      "bin": "459765",
      "last_four": "6578",
      "expiry_month": 2,
      "expiry_year": 2025,
      "cardholder_name": "Example Customer",
      "brand": "visa",
      "funding": "debit",
      "issuer": "EXAMPLE ISSUER",
      "issuer_country": "GB",
      "billing_address": {
        "street_line_1": "7 Westferry Circus",
        "street_line_2": "Columbus Building",
        "postcode": "E144HD",
        "city": "London",
        "region": "Greater London",
        "country_code": "GB"
      }
    },
    {
      "id": "6a0fe961-a961-a8b6-ad17-ab2779165a82",
      "type": "sepa_direct_debit",
      "saved_for": "merchant",
      "created_at": "2026-05-22T05:28:01.887482Z",
      "debtor_iban_last_four": "3273",
      "debtor_name": "John Doe",
      "mandate_reference": "69F1CB61BD99A32C8E20D7FB9E21E146",
      "billing_address": {
        "street_line_1": "Bank of England",
        "street_line_2": "Threadneedle St",
        "postcode": "EC2R 8AH",
        "city": "London",
        "region": "Greater London",
        "country_code": "GB"
      }
    }
  ]
}
c68:["$","div","200-application/json-retrieved_customer",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$cea"}}]}]],"$Lceb"]}] cec:T44d,
{
  "code": "string",
  "message": "string",
  "timestamp": 123
}
c69:["$","div","401-application/json-default",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$cec"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"code\": \"string\",\n \"message\": \"string\",\n \"timestamp\": 123\n}"}]}]]}] ced:T44d,
{
  "code": "string",
  "message": "string",
  "timestamp": 123
}
c6a:["$","div","404-application/json-default",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$ced"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"code\": \"string\",\n \"message\": \"string\",\n \"timestamp\": 123\n}"}]}]]}] ce7:["$","$L10d",null,{"security":[{"Api-Key":[]}],"authorization":{"Api-Key":{"type":"apiKey","in":"header","name":"Authorization","description":"Each Merchant API request must contain an authorization header in the following format:\n\n```\n'Authorization: Bearer '\n```\n\nTo use this API, you need to generate API keys from your Revolut Business account. The Secret key is used in the authorization header for all server calls, while the Public key is provided with payment methods at checkout.\n\n:::info\nFor detailed instructions on generating your API keys, see: [Generate API keys](https://developer.revolut.com/docs/guides/merchant/get-started#generate-api-keys).\n:::","descriptionNode":"$Lcee"}}}] ce8:["$","$L10f",null,{"exampleBlocks":{"application/json":{"variants":[{"key":"example_customer_update","label":"Update a customer","rawValue":"$26:props:children:0:props:children:props:requestBody:content:application/json:examples:example_customer_update:value","block":"$Lcef"}],"syncedPropertyName":"$undefined"}},"title":"Request body samples","headingAs":"h4"}] ce9:["$","$L110",null,{"exampleBlocks":{"200":{"application/json":{"variants":[{"key":"updated_customer","label":"Customer","rawValue":"$25:props:children:0:props:children:props:responses:200:content:application/json:examples:retrieved_customer:value","block":"$Lcf0"}],"syncedPropertyName":"$undefined"}},"400":{"application/json":{"variants":[{"key":"default","label":"Example","rawValue":{"code":"string","message":"string","timestamp":123},"block":"$Lcf1"}],"syncedPropertyName":"$undefined"}},"401":{"application/json":{"variants":[{"key":"default","label":"Example","rawValue":{"code":"string","message":"string","timestamp":123},"block":"$Lcf2"}],"syncedPropertyName":"$undefined"}},"404":{"application/json":{"variants":[{"key":"default","label":"Example","rawValue":{"code":"string","message":"string","timestamp":123},"block":"$Lcf3"}],"syncedPropertyName":"$undefined"}}},"headingAs":"h4"}] cf4:T696,{ "id": "6c7c97a8-cfc1-4cf3-8b38-26a74fdf1fae", "full_name": "Example Customer", "email": "example.customer@example.com", "phone": "+441234567890", "created_at": "2020-06-24T12:03:39.979397Z", "updated_at": "2020-06-25T10:03:39.134417Z", "payment_methods": [ { "id": "648334a8-9546-a983-a81a-efc6d5bdd0be", "type": "revolut_pay", "saved_for": "merchant", "created_at": "2023-06-09T14:18:16.577888Z" }, { "id": "edef3ba4-60a0-4df3-8f12-e5fc858c2420", "type": "card", "saved_for": "customer", "created_at": "2023-03-24T14:15:22Z", "bin": "459765", "last_four": "6578", "expiry_month": 2, "expiry_year": 2025, "cardholder_name": "Example Customer", "brand": "visa", "funding": "debit", "issuer": "EXAMPLE ISSUER", "issuer_country": "GB", "billing_address": { "street_line_1": "7 Westferry Circus", "street_line_2": "Columbus Building", "postcode": "E144HD", "city": "London", "region": "Greater London", "country_code": "GB" } }, { "id": "6a0fe961-a961-a8b6-ad17-ab2779165a82", "type": "sepa_direct_debit", "saved_for": "merchant", "created_at": "2026-05-22T05:28:01.887482Z", "debtor_iban_last_four": "3273", "debtor_name": "John Doe", "mandate_reference": "69F1CB61BD99A32C8E20D7FB9E21E146", "billing_address": { "street_line_1": "Bank of England", "street_line_2": "Threadneedle St", "postcode": "EC2R 8AH", "city": "London", "region": "Greater London", "country_code": "GB" } } ] }ceb:["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"$cf4"}]}] c6f:["$","div","CodeBlock-0",{"className":"wzy01m0 _18b50nc0","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"
'Authorization: Bearer <yourSecretApiKey>'
"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"'Authorization: Bearer '\n"}]}]]}] c70:["$","div","CodeBlock-0",{"className":"wzy01m0 _18b50nc0","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"
https://merchant.revolut.com/api/disputes?payment_id=123&payment_id=456
"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"https://merchant.revolut.com/api/disputes?payment_id=123&payment_id=456\n"}]}]]}] 20:["$","$7a","pay-order",{"children":[["$","section",null,{"className":"y9a0do0","data-variant":"endpoint","children":["$","$L7b",null,{"responses":{"200":{"description":"Payment initiated","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"The ID of the payment.","descriptionNode":"$Lcf5"},"order_id":{"type":"string","format":"uuid","description":"Permanent order ID used to retrieve, capture, cancel, or refund an order after authorization.","descriptionNode":"$Lcf6"},"payment_method":{"type":"object","description":"The payment method used to pay for the order.","discriminator":"$21:props:children:0:props:children:props:responses:200:content:application/json:schema:items:properties:payment_method:discriminator","oneOf":[{"discriminator":"$21:props:children:0:props:children:props:responses:200:content:application/json:schema:items:properties:payment_method:oneOf:0:discriminator","oneOf":[{"properties":{"type":{"type":"string","enum":"$21:props:children:0:props:children:props:responses:200:content:application/json:schema:items:properties:payment_method:oneOf:0:oneOf:0:properties:type:enum","description":"The type of payment method used to pay for the order.","descriptionNode":"$Lcf7"},"subtype":{"type":"string","enum":"$21:props:children:0:props:children:props:responses:200:content:application/json:schema:items:properties:payment_method:oneOf:0:oneOf:0:properties:subtype:enum","description":"Indicates whether the customer used their card or Revolut account via Revolut Pay.","descriptionNode":"$Lcf8"},"id":{"type":"string","format":"uuid","description":"ID of the saved payment method.\n\n:::note\nThe `id` parameter is only returned if the payment method is saved.\n:::","descriptionNode":"$Lcf9"}},"required":"$21:props:children:0:props:children:props:responses:200:content:application/json:schema:items:properties:payment_method:oneOf:0:oneOf:0:required"},{"properties":{"type":{"type":"string","enum":"$21:props:children:0:props:children:props:responses:200:content:application/json:schema:items:properties:payment_method:oneOf:0:oneOf:1:properties:type:enum","description":"The type of payment method used to pay for the order.","descriptionNode":"$Lcfa"},"subtype":{"type":"string","enum":"$21:props:children:0:props:children:props:responses:200:content:application/json:schema:items:properties:payment_method:oneOf:0:oneOf:1:properties:subtype:enum","description":"Indicates whether the customer used their card or Revolut account via Revolut Pay.","descriptionNode":"$Lcfb"},"id":{"type":"string","format":"uuid","description":"ID of the saved payment method.\n\n:::note\nThe `id` parameter is only returned if the payment method is saved.\n:::","descriptionNode":"$Lcfc"},"brand":{"type":"string","description":"The type of the card.","descriptionNode":"$Lcfd"},"last_four":{"type":"string","description":"The last four digits of the card number.","descriptionNode":"$Lcfe"}},"required":"$21:props:children:0:props:children:props:responses:200:content:application/json:schema:items:properties:payment_method:oneOf:0:oneOf:1:required"}]},{"properties":{"type":{"type":"string","enum":"$21:props:children:0:props:children:props:responses:200:content:application/json:schema:items:properties:payment_method:oneOf:1:properties:type:enum","description":"The type of payment method used to pay for the order.","descriptionNode":"$Lcff"},"brand":{"type":"string","description":"The type of the card.","descriptionNode":"$Ld00"},"last_four":{"type":"string","description":"The last four digits of the card number.","descriptionNode":"$Ld01"},"id":{"type":"string","format":"uuid","description":"ID of the saved payment method.\n\n:::note\nThe `id` parameter is only returned if the payment method is saved.\n:::","descriptionNode":"$Ld02"}},"required":"$21:props:children:0:props:children:props:responses:200:content:application/json:schema:items:properties:payment_method:oneOf:1:required"},{"type":"object","description":"Object containing details of a SEPA Direct Debit payment.\n\n:::info\nFor more information, see: [SEPA Direct Debit server-to-server integration](https://developer.revolut.com/docs/guides/merchant/accept-payments/payment-methods/sepa-direct-debit/server-to-server)\n:::","properties":{"id":{"type":"string","format":"uuid","description":"ID of the saved payment method.\n\n:::note\nThe `id` parameter is only returned when the payment method is saved for the merchant.\n:::","descriptionNode":"$Ld03"},"type":{"type":"string","enum":"$21:props:children:0:props:children:props:responses:200:content:application/json:schema:items:properties:payment_method:oneOf:2:properties:type:enum","description":"The type of payment method used to pay for the order.\n\nAvailable values:\n\n| Payment method `type` | Description |\n| --------------------- | ----------- |\n| `apple_pay` | The customer paid the order using Apple Pay. |\n| `card` | The customer paid the order using their credit or debit card. |\n| `google_pay` | The customer paid the order using Google Pay. |\n| `revolut_pay_card` | The customer paid the order via Revolut Pay using their credit or debit card. |\n| `revolut_pay_account` | The customer paid the order via Revolut Pay using their Revolut account. |\n| `sepa_direct_debit` | The customer paid the order using SEPA Direct Debit. |","descriptionNode":"$Ld04"},"debtor_iban_last_four":{"type":"string","description":"The last four digits of the debtor's IBAN.","minLength":4,"maxLength":4,"descriptionNode":"$Ld05"},"debtor_name":{"type":"string","description":"The full name of the debtor as provided in the mandate.","descriptionNode":"$Ld06"},"mandate_reference":{"type":"string","description":"The unique mandate reference generated by Revolut. Include this in pre-debit notifications sent to your customers.","descriptionNode":"$Ld07"}},"required":"$21:props:children:0:props:children:props:responses:200:content:application/json:schema:items:properties:payment_method:oneOf:2:required","descriptionNode":"$Ld08"}],"descriptionNode":"$Ld09"},"token":{"type":"string","format":"uuid","description":"Temporary token of the payment used to fetch the reward offer during checkout and link user registrations to the given offers. \n\nThe token is only valid for a limited time.","descriptionNode":"$Ld0a"},"amount":{"type":"integer","format":"int64","minimum":0,"description":"The payment amount in minor units (e.g., cents). The value of this field depends on the payment type and state.\n\n| Payment type | State | Amount value |\n|--------------|-------|--------------|\n| Standard payment | Any | Total payment amount |\n| Pre-authorised payment | `authorisation_started` | New amount being authorised (during increment processing) |\n| Pre-authorised payment | `authorised` | Currently authorised amount (equals `authorised_amount`) |\n\n:::info\nFor pre-authorised payments, see the `authorised_amount` field for tracking the currently authorised amount separately.\n:::","examples":"$21:props:children:0:props:children:props:responses:200:content:application/json:schema:items:properties:amount:examples","descriptionNode":"$Ld0b"},"currency":{"type":"string","format":"ISO 4217","minLength":3,"maxLength":3,"description":"[ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) currency code in upper case.\n\n:::info\nFor more information about the supported currencies, see: [Help Center](https://help.revolut.com/business/help/merchant-accounts/payments/in-which-currencies-can-i-accept-payments/).\n:::","descriptionNode":"$Ld0c"},"state":{"type":"string","description":"The status of the payment.","enum":"$21:props:children:0:props:children:props:responses:200:content:application/json:schema:items:properties:state:enum","descriptionNode":"$Ld0d"},"decline_reason":{"type":"string","description":"The reason for a `failed` or `declined` payment.\n\nA failed or declined payment can result from multiple reasons. To learn more, check our [failure reasons](https://developer.revolut.com/docs/guides/merchant/reference/error-codes/decline-reasons).","enum":"$21:props:children:0:props:children:props:responses:200:content:application/json:schema:items:properties:decline_reason:enum","descriptionNode":"$Ld0e"},"authentication_challenge":{"type":"object","description":"Details about the authentication challenge that should be performed to complete the authentication process. For more information about Revolut's 3DS solution, see: [3D Secure overview](https://developer.revolut.com/docs/guides/merchant/reference/3d-secure).\n\nOnly returned if the payment's state is `authentication_challenge`.","discriminator":"$21:props:children:0:props:children:props:responses:200:content:application/json:schema:items:properties:authentication_challenge:discriminator","oneOf":[{"title":"three_ds","type":"object","description":"Information about the 3DS challenge.","properties":{"type":{"type":"string","enum":"$21:props:children:0:props:children:props:responses:200:content:application/json:schema:items:properties:authentication_challenge:oneOf:0:properties:type:enum","description":"Type of the authentication challenge the payment triggers.","descriptionNode":"$Ld0f"},"acs_url":{"type":"string","format":"url","description":"The URL of the authentication challenge.","descriptionNode":"$Ld10"}},"required":"$21:props:children:0:props:children:props:responses:200:content:application/json:schema:items:properties:authentication_challenge:oneOf:0:required","descriptionNode":"$Ld11"},{"title":"three_ds_fingerprint","type":"object","description":"Information about the 3DS fingerprint challenge.","properties":{"type":{"type":"string","enum":"$21:props:children:0:props:children:props:responses:200:content:application/json:schema:items:properties:authentication_challenge:oneOf:0:properties:type:enum","description":"Type of the authentication challenge the payment triggers.","descriptionNode":"$Ld12"},"fingerprint_url":{"type":"string","format":"url","description":"The URL of the fingerprint. (Used only internally by Revolut.)","descriptionNode":"$Ld13"},"fingerprint_data":{"type":"string","format":"JSON","description":"Data about the fingerprint used for authentication. (Used only internally\nby Revolut.)","descriptionNode":"$Ld14"}},"required":"$21:props:children:0:props:children:props:responses:200:content:application/json:schema:items:properties:authentication_challenge:oneOf:1:required","descriptionNode":"$Ld15"}],"descriptionNode":"$Ld16"}},"required":"$21:props:children:0:props:children:props:responses:200:content:application/json:schema:items:required"},"examples":{"successful_payment_card":{"summary":"Payment authorised (card)","value":{"id":"63c55e04-4208-a43d-9c96-eaee848ffbaf","order_id":"63c55df6-1461-a886-b90f-f49d3c370253","payment_method":{"type":"card","id":"2b83c23a-650e-40c3-8989-00ee24478738","brand":"mastercard_credit","last_four":"1234"},"state":"authorisation_passed"}},"successful_payment_revolut_pay_account":{"summary":"Payment authorised (Revolut Pay - Revolut account)","value":{"id":"63c55e04-4208-a43d-9c96-eaee848ffbaf","order_id":"63c55df6-1461-a886-b90f-f49d3c370253","payment_method":{"type":"revolut_pay","subtype":"revolut_account","id":"2b83c23a-650e-40c3-8989-00ee24478738"},"state":"authorisation_passed"}},"successful_payment_revolut_pay_card":{"summary":"Payment authorised (Revolut Pay - card)","value":{"id":"63c55e04-4208-a43d-9c96-eaee848ffbaf","order_id":"63c55df6-1461-a886-b90f-f49d3c370253","payment_method":{"type":"revolut_pay","subtype":"card","id":"2b83c23a-650e-40c3-8989-00ee24478738","brand":"visa","last_four":"1234"},"state":"authorisation_passed"}},"three_ds":{"summary":"Saved card payment (3DS challenge)","value":{"id":"5e96b328-4054-41ed-b089-595ccc4d0870","order_id":"a16718e0-077a-4942-89bc-23ac17a2e14c","payment_method":{"type":"card","id":"2b83c23a-650e-40c3-8989-00ee24478738","brand":"mastercard_credit","last_four":"1234"},"state":"authentication_challenge","authentication_challenge":{"type":"three_ds","acs_url":"https://example.com"}}},"three_ds_fingerprint":{"summary":"Saved card payment (3DS fingerprint challenge)","value":{"id":"5e96b328-4054-41ed-b089-595ccc4d0870","order_id":"a16718e0-077a-4942-89bc-23ac17a2e14c","payment_method":{"type":"card","id":"2b83c23a-650e-40c3-8989-00ee24478738","brand":"mastercard_credit","last_four":"1234"},"state":"authentication_challenge","authentication_challenge":{"type":"three_ds_fingerprint","fingerprint_url":"https://example.com","fingerprint_data":"string"}}}}}},"descriptionNode":"$Ld17"},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"errorId":{"type":"string","description":"The ID of the error. You can share this ID with Revolut\nsupport for troubleshooting.","descriptionNode":"$Ld18"},"timestamp":{"type":"integer","description":"The date and time the error happened.","descriptionNode":"$Ld19"}}},"examples":{"example-1":{"value":{"errorId":"94b27660-fdda-49ec-8b85-cd46a068ade0","timestamp":1601296792533}}}}},"descriptionNode":"$Ld1a"},"401":{"description":"Unauthorized","descriptionNode":"$Ld1b"},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"errorId":{"type":"string","description":"The ID of the error. You can share this ID with Revolut\nsupport for troubleshooting.","descriptionNode":"$Ld1c"},"timestamp":{"type":"integer","description":"The date and time the error happened.","descriptionNode":"$Ld1d"},"code":{"type":"integer"}}},"examples":{"example-1":{"value":{"errorId":"94b27660-fdda-49ec-8b85-cd46a068ade0","timestamp":1601296792533,"code":1024}}}}},"descriptionNode":"$Ld1e"}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"saved_payment_method":{"type":"object","description":"Object containing information about the saved payment method used to pay for the order.","properties":{"type":{"type":"string","enum":["card","revolut_pay"],"description":"Type of saved payment method.","examples":["card"],"descriptionNode":"$Ld1f"},"id":{"type":"string","description":"Saved payment method ID.","descriptionNode":"$Ld20"},"initiator":{"type":"string","description":"Indicates who is allowed to initiate the payment. \n\n:::note\nUsing this endpoint, only merchant initiated payments are supported with Revolut Pay.\n:::","enum":["customer","merchant"],"examples":["customer"],"descriptionNode":"$Ld21"},"environment":{"description":"Environment object, indicating in which environment the payment was made.\n\n:::warning\nOnly required if `initiator: customer`.\n:::\n\n:::note\nOnly `browser` is available at the moment.\n:::","type":"object","discriminator":{"propertyName":"type","mapping":{"browser":"#/components/schemas/Browser-Environment"}},"oneOf":[{"type":"object","description":"Browser environment","properties":{"type":{"type":"string","enum":["browser"],"description":"Type of environment where the payment was made.","examples":["browser"],"descriptionNode":"$Ld22"},"time_zone_utc_offset":{"type":"integer","description":"Defines the offset to UTC in minutes.","examples":[180],"descriptionNode":"$Ld23"},"color_depth":{"type":"integer","description":"The browser's available colour depth.","examples":[32],"descriptionNode":"$Ld24"},"screen_width":{"type":"integer","description":"The browser's screen width in pixels.","examples":[1920],"descriptionNode":"$Ld25"},"screen_height":{"type":"integer","description":"The browser's screen height in pixels.","examples":[1080],"descriptionNode":"$Ld26"},"java_enabled":{"type":"boolean","description":"Indicates if the browser has Java enabled.","examples":[false],"descriptionNode":"$Ld27"},"challenge_window_width":{"type":"integer","description":"Defines the width of the pop-up window where the authentication challenge appears.","examples":[640],"descriptionNode":"$Ld28"},"browser_url":{"type":"string","format":"url","description":"The URL of the page where the payment was initiated.","examples":["https://business.revolut.com"],"descriptionNode":"$Ld29"}},"required":["type","time_zone_utc_offset","color_depth","screen_width","screen_height","java_enabled"],"descriptionNode":"$Ld2a"}],"descriptionNode":"$Ld2b"}},"required":["type","id","initiator","environment"],"descriptionNode":"$Ld2c"}},"required":["saved_payment_method"]},"examples":{"saved_card_customer":{"summary":"Saved card (customer initiator)","value":{"saved_payment_method":{"type":"card","id":"2b83c23a-650e-40c3-8989-00ee24478738","initiator":"customer","environment":{"type":"browser","time_zone_utc_offset":180,"color_depth":48,"screen_width":1920,"screen_height":1080,"java_enabled":true,"challenge_window_width":640,"browser_url":"https://business.revolut.com"}}}},"saved_card_merchant":{"summary":"Saved card (merchant initiator)","value":{"saved_payment_method":{"type":"card","id":"2b83c23a-650e-40c3-8989-00ee24478738","initiator":"merchant"}}},"revolut_pay":{"summary":"Saved Revolut Pay (merchant initiator)","value":{"saved_payment_method":{"type":"revolut_pay","id":"2b83c23a-650e-40c3-8989-00ee24478738","initiator":"merchant"}}}}}}},"variantLabels":["Payment authorised (card)","Payment authorised (Revolut Pay - Revolut account)","Payment authorised (Revolut Pay - card)","Saved card payment (3DS challenge)","Saved card payment (3DS fingerprint challenge)"],"children":["$Ld2d","$Ld2e"]}]}],false]}] d2d:["$","div",null,{"className":"ezz1n30","children":[["$","div",null,{"data-header":"$undefined","className":"ezz1n31","children":["$","div",null,{"className":"y9a0do1","children":[["$","h2",null,{"id":"pay-order","children":[["$Ld2f","$undefined"],["$","$L15",null,{"id":"pay-order"}]]}],["$","$L16",null,{"url":"/docs/api/merchant/2025-10-16/operations/pay-order.md"}]]}]}],"$undefined"]}] d34:Tb59,
curl -X POST "https://merchant.revolut.com/api/orders/__RP_TOK_0__/payments" \
  -H "Content-Type: application/json" \
  -H "Authorization: __RP_TOK_1__" \
  -d '{
  "saved_payment_method": {
    "type": "card",
    "id": "2b83c23a-650e-40c3-8989-00ee24478738",
    "initiator": "customer",
    "environment": {
      "type": "browser",
      "time_zone_utc_offset": 180,
      "color_depth": 48,
      "screen_width": 1920,
      "screen_height": 1080,
      "java_enabled": true,
      "challenge_window_width": 640,
      "browser_url": "https://business.revolut.com"
    }
  }
}'
d35:T1a6a,
const payload = {
  "saved_payment_method": {
    "type": "card",
    "id": "2b83c23a-650e-40c3-8989-00ee24478738",
    "initiator": "customer",
    "environment": {
      "type": "browser",
      "time_zone_utc_offset": 180,
      "color_depth": 48,
      "screen_width": 1920,
      "screen_height": 1080,
      "java_enabled": true,
      "challenge_window_width": 640,
      "browser_url": "https://business.revolut.com"
    }
  }
};
fetch("https://merchant.revolut.com/api/orders/__RP_TOK_0__/payments", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "__RP_TOK_1__"
  },
  body: JSON.stringify(payload)
})
  .then(response => response.json())
  .then(data => console.log(data));
d36:T1a51,
package main

import (
  "fmt"
  "net/http"
  "bytes"
  "encoding/json"
)

func main() {
  url := "https://merchant.revolut.com/api/orders/__RP_TOK_0__/payments"
  jsonData := []byte(`
{
  "saved_payment_method": {
    "type": "card",
    "id": "2b83c23a-650e-40c3-8989-00ee24478738",
    "initiator": "customer",
    "environment": {
      "type": "browser",
      "time_zone_utc_offset": 180,
      "color_depth": 48,
      "screen_width": 1920,
      "screen_height": 1080,
      "java_enabled": true,
      "challenge_window_width": 640,
      "browser_url": "https://business.revolut.com"
    }
  }
}
  `)
  req, _ := http.NewRequest("POST", url, bytes.NewBuffer(jsonData))
  req.Header.Add("Content-Type", "application/json")
  req.Header.Add("Authorization", "__RP_TOK_1__")

  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  fmt.Println(res)
}
d37:T1730,
import requests

url = "https://merchant.revolut.com/api/orders/__RP_TOK_0__/payments"
headers = {
  "Content-Type": "application/json",
  "Authorization": "__RP_TOK_1__"
}
payload = {
  "saved_payment_method": {
    "type": "card",
    "id": "2b83c23a-650e-40c3-8989-00ee24478738",
    "initiator": "customer",
    "environment": {
      "type": "browser",
      "time_zone_utc_offset": 180,
      "color_depth": 48,
      "screen_width": 1920,
      "screen_height": 1080,
      "java_enabled": true,
      "challenge_window_width": 640,
      "browser_url": "https://business.revolut.com"
    }
  }
}

response = requests.post(url, headers=headers, json=payload)
print(response.json())
d38:T48c,import java.net.http.HttpClient; import java.net.http.HttpRequest; import java.net.http.HttpResponse; import java.net.URI; public class Main { public static void main(String[] args) { HttpClient client = HttpClient.newHttpClient(); String body = """ { "saved_payment_method": { "type": "card", "id": "2b83c23a-650e-40c3-8989-00ee24478738", "initiator": "customer", "environment": { "type": "browser", "time_zone_utc_offset": 180, "color_depth": 48, "screen_width": 1920, "screen_height": 1080, "java_enabled": true, "challenge_window_width": 640, "browser_url": "https://business.revolut.com" } } } """; HttpRequest request = HttpRequest.newBuilder() .uri(URI.create("https://merchant.revolut.com/api/orders/__RP_TOK_0__/payments")) .header("Content-Type", "application/json") .header("Authorization", "__RP_TOK_1__") .POST(HttpRequest.BodyPublishers.ofString(body)) .build(); client.sendAsync(request, HttpResponse.BodyHandlers.ofString()) .thenApply(HttpResponse::body) .thenAccept(System.out::println) .join(); } }d39:T1fb8,
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;

public class Main {
  public static void main(String[] args) {
    HttpClient client = HttpClient.newHttpClient();
    String body = """
{
  "saved_payment_method": {
    "type": "card",
    "id": "2b83c23a-650e-40c3-8989-00ee24478738",
    "initiator": "customer",
    "environment": {
      "type": "browser",
      "time_zone_utc_offset": 180,
      "color_depth": 48,
      "screen_width": 1920,
      "screen_height": 1080,
      "java_enabled": true,
      "challenge_window_width": 640,
      "browser_url": "https://business.revolut.com"
    }
  }
}
    """;

    HttpRequest request = HttpRequest.newBuilder()
      .uri(URI.create("https://merchant.revolut.com/api/orders/__RP_TOK_0__/payments"))
      .header("Content-Type", "application/json")
      .header("Authorization", "__RP_TOK_1__")
      .POST(HttpRequest.BodyPublishers.ofString(body))
      .build();

    client.sendAsync(request, HttpResponse.BodyHandlers.ofString())
      .thenApply(HttpResponse::body)
      .thenAccept(System.out::println)
      .join();
  }
}
d3a:T436,using System.Net.Http; using System.Net.Http.Headers; var client = new HttpClient(); var request = new HttpRequestMessage { Method = HttpMethod.Post, RequestUri = new Uri("https://merchant.revolut.com/api/orders/__RP_TOK_0__/payments"), Headers = { { "Authorization", "__RP_TOK_1__" }, }, Content = new StringContent(@"{ ""saved_payment_method"": { ""type"": ""card"", ""id"": ""2b83c23a-650e-40c3-8989-00ee24478738"", ""initiator"": ""customer"", ""environment"": { ""type"": ""browser"", ""time_zone_utc_offset"": 180, ""color_depth"": 48, ""screen_width"": 1920, ""screen_height"": 1080, ""java_enabled"": true, ""challenge_window_width"": 640, ""browser_url"": ""https://business.revolut.com"" } } }") { Headers = { ContentType = new MediaTypeHeaderValue("application/json") } } }; using (var response = await client.SendAsync(request)) { response.EnsureSuccessStatusCode(); var body = await response.Content.ReadAsStringAsync(); Console.WriteLine(body); }d3b:T2d96,
using System.Net.Http;
using System.Net.Http.Headers;

var client = new HttpClient();
var request = new HttpRequestMessage
{
  Method = HttpMethod.Post,
  RequestUri = new Uri("https://merchant.revolut.com/api/orders/__RP_TOK_0__/payments"),
  Headers =
  {
    { "Authorization", "__RP_TOK_1__" },
  },
  Content = new StringContent(@"{
  ""saved_payment_method"": {
    ""type"": ""card"",
    ""id"": ""2b83c23a-650e-40c3-8989-00ee24478738"",
    ""initiator"": ""customer"",
    ""environment"": {
      ""type"": ""browser"",
      ""time_zone_utc_offset"": 180,
      ""color_depth"": 48,
      ""screen_width"": 1920,
      ""screen_height"": 1080,
      ""java_enabled"": true,
      ""challenge_window_width"": 640,
      ""browser_url"": ""https://business.revolut.com""
    }
  }
}")
  {
    Headers =
    {
      ContentType = new MediaTypeHeaderValue("application/json")
    }
  }
};

using (var response = await client.SendAsync(request))
{
  response.EnsureSuccessStatusCode();
  var body = await response.Content.ReadAsStringAsync();
  Console.WriteLine(body);
}
d3c:Tb61,
curl -X POST "https://sandbox-merchant.revolut.com/api/orders/__RP_TOK_0__/payments" \
  -H "Content-Type: application/json" \
  -H "Authorization: __RP_TOK_1__" \
  -d '{
  "saved_payment_method": {
    "type": "card",
    "id": "2b83c23a-650e-40c3-8989-00ee24478738",
    "initiator": "customer",
    "environment": {
      "type": "browser",
      "time_zone_utc_offset": 180,
      "color_depth": 48,
      "screen_width": 1920,
      "screen_height": 1080,
      "java_enabled": true,
      "challenge_window_width": 640,
      "browser_url": "https://business.revolut.com"
    }
  }
}'
d3d:T1a72,
const payload = {
  "saved_payment_method": {
    "type": "card",
    "id": "2b83c23a-650e-40c3-8989-00ee24478738",
    "initiator": "customer",
    "environment": {
      "type": "browser",
      "time_zone_utc_offset": 180,
      "color_depth": 48,
      "screen_width": 1920,
      "screen_height": 1080,
      "java_enabled": true,
      "challenge_window_width": 640,
      "browser_url": "https://business.revolut.com"
    }
  }
};
fetch("https://sandbox-merchant.revolut.com/api/orders/__RP_TOK_0__/payments", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "__RP_TOK_1__"
  },
  body: JSON.stringify(payload)
})
  .then(response => response.json())
  .then(data => console.log(data));
d3e:T1a59,
package main

import (
  "fmt"
  "net/http"
  "bytes"
  "encoding/json"
)

func main() {
  url := "https://sandbox-merchant.revolut.com/api/orders/__RP_TOK_0__/payments"
  jsonData := []byte(`
{
  "saved_payment_method": {
    "type": "card",
    "id": "2b83c23a-650e-40c3-8989-00ee24478738",
    "initiator": "customer",
    "environment": {
      "type": "browser",
      "time_zone_utc_offset": 180,
      "color_depth": 48,
      "screen_width": 1920,
      "screen_height": 1080,
      "java_enabled": true,
      "challenge_window_width": 640,
      "browser_url": "https://business.revolut.com"
    }
  }
}
  `)
  req, _ := http.NewRequest("POST", url, bytes.NewBuffer(jsonData))
  req.Header.Add("Content-Type", "application/json")
  req.Header.Add("Authorization", "__RP_TOK_1__")

  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  fmt.Println(res)
}
d3f:T1738,
import requests

url = "https://sandbox-merchant.revolut.com/api/orders/__RP_TOK_0__/payments"
headers = {
  "Content-Type": "application/json",
  "Authorization": "__RP_TOK_1__"
}
payload = {
  "saved_payment_method": {
    "type": "card",
    "id": "2b83c23a-650e-40c3-8989-00ee24478738",
    "initiator": "customer",
    "environment": {
      "type": "browser",
      "time_zone_utc_offset": 180,
      "color_depth": 48,
      "screen_width": 1920,
      "screen_height": 1080,
      "java_enabled": true,
      "challenge_window_width": 640,
      "browser_url": "https://business.revolut.com"
    }
  }
}

response = requests.post(url, headers=headers, json=payload)
print(response.json())
d40:T494,import java.net.http.HttpClient; import java.net.http.HttpRequest; import java.net.http.HttpResponse; import java.net.URI; public class Main { public static void main(String[] args) { HttpClient client = HttpClient.newHttpClient(); String body = """ { "saved_payment_method": { "type": "card", "id": "2b83c23a-650e-40c3-8989-00ee24478738", "initiator": "customer", "environment": { "type": "browser", "time_zone_utc_offset": 180, "color_depth": 48, "screen_width": 1920, "screen_height": 1080, "java_enabled": true, "challenge_window_width": 640, "browser_url": "https://business.revolut.com" } } } """; HttpRequest request = HttpRequest.newBuilder() .uri(URI.create("https://sandbox-merchant.revolut.com/api/orders/__RP_TOK_0__/payments")) .header("Content-Type", "application/json") .header("Authorization", "__RP_TOK_1__") .POST(HttpRequest.BodyPublishers.ofString(body)) .build(); client.sendAsync(request, HttpResponse.BodyHandlers.ofString()) .thenApply(HttpResponse::body) .thenAccept(System.out::println) .join(); } }d41:T1fc0,
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;

public class Main {
  public static void main(String[] args) {
    HttpClient client = HttpClient.newHttpClient();
    String body = """
{
  "saved_payment_method": {
    "type": "card",
    "id": "2b83c23a-650e-40c3-8989-00ee24478738",
    "initiator": "customer",
    "environment": {
      "type": "browser",
      "time_zone_utc_offset": 180,
      "color_depth": 48,
      "screen_width": 1920,
      "screen_height": 1080,
      "java_enabled": true,
      "challenge_window_width": 640,
      "browser_url": "https://business.revolut.com"
    }
  }
}
    """;

    HttpRequest request = HttpRequest.newBuilder()
      .uri(URI.create("https://sandbox-merchant.revolut.com/api/orders/__RP_TOK_0__/payments"))
      .header("Content-Type", "application/json")
      .header("Authorization", "__RP_TOK_1__")
      .POST(HttpRequest.BodyPublishers.ofString(body))
      .build();

    client.sendAsync(request, HttpResponse.BodyHandlers.ofString())
      .thenApply(HttpResponse::body)
      .thenAccept(System.out::println)
      .join();
  }
}
d42:T43e,using System.Net.Http; using System.Net.Http.Headers; var client = new HttpClient(); var request = new HttpRequestMessage { Method = HttpMethod.Post, RequestUri = new Uri("https://sandbox-merchant.revolut.com/api/orders/__RP_TOK_0__/payments"), Headers = { { "Authorization", "__RP_TOK_1__" }, }, Content = new StringContent(@"{ ""saved_payment_method"": { ""type"": ""card"", ""id"": ""2b83c23a-650e-40c3-8989-00ee24478738"", ""initiator"": ""customer"", ""environment"": { ""type"": ""browser"", ""time_zone_utc_offset"": 180, ""color_depth"": 48, ""screen_width"": 1920, ""screen_height"": 1080, ""java_enabled"": true, ""challenge_window_width"": 640, ""browser_url"": ""https://business.revolut.com"" } } }") { Headers = { ContentType = new MediaTypeHeaderValue("application/json") } } }; using (var response = await client.SendAsync(request)) { response.EnsureSuccessStatusCode(); var body = await response.Content.ReadAsStringAsync(); Console.WriteLine(body); }d43:T2d9e,
using System.Net.Http;
using System.Net.Http.Headers;

var client = new HttpClient();
var request = new HttpRequestMessage
{
  Method = HttpMethod.Post,
  RequestUri = new Uri("https://sandbox-merchant.revolut.com/api/orders/__RP_TOK_0__/payments"),
  Headers =
  {
    { "Authorization", "__RP_TOK_1__" },
  },
  Content = new StringContent(@"{
  ""saved_payment_method"": {
    ""type"": ""card"",
    ""id"": ""2b83c23a-650e-40c3-8989-00ee24478738"",
    ""initiator"": ""customer"",
    ""environment"": {
      ""type"": ""browser"",
      ""time_zone_utc_offset"": 180,
      ""color_depth"": 48,
      ""screen_width"": 1920,
      ""screen_height"": 1080,
      ""java_enabled"": true,
      ""challenge_window_width"": 640,
      ""browser_url"": ""https://business.revolut.com""
    }
  }
}")
  {
    Headers =
    {
      ContentType = new MediaTypeHeaderValue("application/json")
    }
  }
};

using (var response = await client.SendAsync(request))
{
  response.EnsureSuccessStatusCode();
  var body = await response.Content.ReadAsStringAsync();
  Console.WriteLine(body);
}
d2e:["$","div",null,{"className":"ezz1n30","children":[["$","div",null,{"data-header":"$undefined","className":"ezz1n31","children":["$Ld30",["$","$L85",null,{"parameters":[{"name":"Authorization","in":"header","schema":{"type":"string","format":"Bearer ","examples":"$62:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:0:schema:examples"},"required":true,"description":"This parameter accepts the [Merchant API Secret key](https://business.revolut.com/settings/apis?tab=merchant-api) to authorise requests coming from the merchant's backend. \n\nIt ensures that ensures that each request is authenticated and authorised by verifying the secret key. The secret key should be included in all request headers as a `Bearer` token.\n\n:::info\nFor more information, see: [Authentication](https://developer.revolut.com/docs/api/merchant#authentication)\n:::","descriptionNode":"$Ld31"},{"name":"order_id","in":"path","schema":{"type":"string","format":"uuid","description":"A UUID string, typically used to identify resources.","descriptionNode":"$Ld32"},"required":true,"description":"The ID of the `Order` object.","descriptionNode":"$Ld33"}],"requestBody":"$20:props:children:0:props:children:props:requestBody","heading":"Request","requestBodySchemaTitle":"Request body","headingAs":"h3"}],["$","$L89",null,{"responses":"$20:props:children:0:props:children:props:responses","headingAs":"h3"}]]}],["$","div",null,{"className":"ezz1n32","children":[[["$","$L8a",null,{"itemsByServer":{"https://merchant.revolut.com":[{"id":"curl","label":"cURL","templateCode":"curl -X POST \"https://merchant.revolut.com/api/orders/__RP_TOK_0__/payments\" \\\n -H \"Content-Type: application/json\" \\\n -H \"Authorization: __RP_TOK_1__\" \\\n -d '{\n \"saved_payment_method\": {\n \"type\": \"card\",\n \"id\": \"2b83c23a-650e-40c3-8989-00ee24478738\",\n \"initiator\": \"customer\",\n \"environment\": {\n \"type\": \"browser\",\n \"time_zone_utc_offset\": 180,\n \"color_depth\": 48,\n \"screen_width\": 1920,\n \"screen_height\": 1080,\n \"java_enabled\": true,\n \"challenge_window_width\": 640,\n \"browser_url\": \"https://business.revolut.com\"\n }\n }\n}'","templateHtml":"$d34","tokens":[{"marker":"__RP_TOK_0__","paramName":"order_id","paramIn":"path","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["shell-double-inner"]}],"defaults":{"header:Authorization":"Bearer ","path:order_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"javascript","label":"JavaScript","templateCode":"const payload = {\n \"saved_payment_method\": {\n \"type\": \"card\",\n \"id\": \"2b83c23a-650e-40c3-8989-00ee24478738\",\n \"initiator\": \"customer\",\n \"environment\": {\n \"type\": \"browser\",\n \"time_zone_utc_offset\": 180,\n \"color_depth\": 48,\n \"screen_width\": 1920,\n \"screen_height\": 1080,\n \"java_enabled\": true,\n \"challenge_window_width\": 640,\n \"browser_url\": \"https://business.revolut.com\"\n }\n }\n};\nfetch(\"https://merchant.revolut.com/api/orders/__RP_TOK_0__/payments\", {\n method: \"POST\",\n headers: {\n \"Content-Type\": \"application/json\",\n \"Authorization\": \"__RP_TOK_1__\"\n },\n body: JSON.stringify(payload)\n})\n .then(response => response.json())\n .then(data => console.log(data));","templateHtml":"$d35","tokens":[{"marker":"__RP_TOK_0__","paramName":"order_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","path:order_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"go","label":"Go","templateCode":"package main\n\nimport (\n \"fmt\"\n \"net/http\"\n \"bytes\"\n \"encoding/json\"\n)\n\nfunc main() {\n url := \"https://merchant.revolut.com/api/orders/__RP_TOK_0__/payments\"\n jsonData := []byte(`\n{\n \"saved_payment_method\": {\n \"type\": \"card\",\n \"id\": \"2b83c23a-650e-40c3-8989-00ee24478738\",\n \"initiator\": \"customer\",\n \"environment\": {\n \"type\": \"browser\",\n \"time_zone_utc_offset\": 180,\n \"color_depth\": 48,\n \"screen_width\": 1920,\n \"screen_height\": 1080,\n \"java_enabled\": true,\n \"challenge_window_width\": 640,\n \"browser_url\": \"https://business.revolut.com\"\n }\n }\n}\n `)\n req, _ := http.NewRequest(\"POST\", url, bytes.NewBuffer(jsonData))\n req.Header.Add(\"Content-Type\", \"application/json\")\n req.Header.Add(\"Authorization\", \"__RP_TOK_1__\")\n\n res, _ := http.DefaultClient.Do(req)\n defer res.Body.Close()\n fmt.Println(res)\n}","templateHtml":"$d36","tokens":[{"marker":"__RP_TOK_0__","paramName":"order_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","path:order_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"python","label":"Python","templateCode":"import requests\n\nurl = \"https://merchant.revolut.com/api/orders/__RP_TOK_0__/payments\"\nheaders = {\n \"Content-Type\": \"application/json\",\n \"Authorization\": \"__RP_TOK_1__\"\n}\npayload = {\n \"saved_payment_method\": {\n \"type\": \"card\",\n \"id\": \"2b83c23a-650e-40c3-8989-00ee24478738\",\n \"initiator\": \"customer\",\n \"environment\": {\n \"type\": \"browser\",\n \"time_zone_utc_offset\": 180,\n \"color_depth\": 48,\n \"screen_width\": 1920,\n \"screen_height\": 1080,\n \"java_enabled\": true,\n \"challenge_window_width\": 640,\n \"browser_url\": \"https://business.revolut.com\"\n }\n }\n}\n\nresponse = requests.post(url, headers=headers, json=payload)\nprint(response.json())","templateHtml":"$d37","tokens":[{"marker":"__RP_TOK_0__","paramName":"order_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","path:order_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"java","label":"Java","templateCode":"$d38","templateHtml":"$d39","tokens":[{"marker":"__RP_TOK_0__","paramName":"order_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","path:order_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"csharp","label":"C#","templateCode":"$d3a","templateHtml":"$d3b","tokens":[{"marker":"__RP_TOK_0__","paramName":"order_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","path:order_id":"123e4567-e89b-12d3-a456-426614174000"}}],"https://sandbox-merchant.revolut.com":[{"id":"curl","label":"cURL","templateCode":"curl -X POST \"https://sandbox-merchant.revolut.com/api/orders/__RP_TOK_0__/payments\" \\\n -H \"Content-Type: application/json\" \\\n -H \"Authorization: __RP_TOK_1__\" \\\n -d '{\n \"saved_payment_method\": {\n \"type\": \"card\",\n \"id\": \"2b83c23a-650e-40c3-8989-00ee24478738\",\n \"initiator\": \"customer\",\n \"environment\": {\n \"type\": \"browser\",\n \"time_zone_utc_offset\": 180,\n \"color_depth\": 48,\n \"screen_width\": 1920,\n \"screen_height\": 1080,\n \"java_enabled\": true,\n \"challenge_window_width\": 640,\n \"browser_url\": \"https://business.revolut.com\"\n }\n }\n}'","templateHtml":"$d3c","tokens":[{"marker":"__RP_TOK_0__","paramName":"order_id","paramIn":"path","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["shell-double-inner"]}],"defaults":{"header:Authorization":"Bearer ","path:order_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"javascript","label":"JavaScript","templateCode":"const payload = {\n \"saved_payment_method\": {\n \"type\": \"card\",\n \"id\": \"2b83c23a-650e-40c3-8989-00ee24478738\",\n \"initiator\": \"customer\",\n \"environment\": {\n \"type\": \"browser\",\n \"time_zone_utc_offset\": 180,\n \"color_depth\": 48,\n \"screen_width\": 1920,\n \"screen_height\": 1080,\n \"java_enabled\": true,\n \"challenge_window_width\": 640,\n \"browser_url\": \"https://business.revolut.com\"\n }\n }\n};\nfetch(\"https://sandbox-merchant.revolut.com/api/orders/__RP_TOK_0__/payments\", {\n method: \"POST\",\n headers: {\n \"Content-Type\": \"application/json\",\n \"Authorization\": \"__RP_TOK_1__\"\n },\n body: JSON.stringify(payload)\n})\n .then(response => response.json())\n .then(data => console.log(data));","templateHtml":"$d3d","tokens":[{"marker":"__RP_TOK_0__","paramName":"order_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","path:order_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"go","label":"Go","templateCode":"package main\n\nimport (\n \"fmt\"\n \"net/http\"\n \"bytes\"\n \"encoding/json\"\n)\n\nfunc main() {\n url := \"https://sandbox-merchant.revolut.com/api/orders/__RP_TOK_0__/payments\"\n jsonData := []byte(`\n{\n \"saved_payment_method\": {\n \"type\": \"card\",\n \"id\": \"2b83c23a-650e-40c3-8989-00ee24478738\",\n \"initiator\": \"customer\",\n \"environment\": {\n \"type\": \"browser\",\n \"time_zone_utc_offset\": 180,\n \"color_depth\": 48,\n \"screen_width\": 1920,\n \"screen_height\": 1080,\n \"java_enabled\": true,\n \"challenge_window_width\": 640,\n \"browser_url\": \"https://business.revolut.com\"\n }\n }\n}\n `)\n req, _ := http.NewRequest(\"POST\", url, bytes.NewBuffer(jsonData))\n req.Header.Add(\"Content-Type\", \"application/json\")\n req.Header.Add(\"Authorization\", \"__RP_TOK_1__\")\n\n res, _ := http.DefaultClient.Do(req)\n defer res.Body.Close()\n fmt.Println(res)\n}","templateHtml":"$d3e","tokens":[{"marker":"__RP_TOK_0__","paramName":"order_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","path:order_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"python","label":"Python","templateCode":"import requests\n\nurl = \"https://sandbox-merchant.revolut.com/api/orders/__RP_TOK_0__/payments\"\nheaders = {\n \"Content-Type\": \"application/json\",\n \"Authorization\": \"__RP_TOK_1__\"\n}\npayload = {\n \"saved_payment_method\": {\n \"type\": \"card\",\n \"id\": \"2b83c23a-650e-40c3-8989-00ee24478738\",\n \"initiator\": \"customer\",\n \"environment\": {\n \"type\": \"browser\",\n \"time_zone_utc_offset\": 180,\n \"color_depth\": 48,\n \"screen_width\": 1920,\n \"screen_height\": 1080,\n \"java_enabled\": true,\n \"challenge_window_width\": 640,\n \"browser_url\": \"https://business.revolut.com\"\n }\n }\n}\n\nresponse = requests.post(url, headers=headers, json=payload)\nprint(response.json())","templateHtml":"$d3f","tokens":[{"marker":"__RP_TOK_0__","paramName":"order_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","path:order_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"java","label":"Java","templateCode":"$d40","templateHtml":"$d41","tokens":[{"marker":"__RP_TOK_0__","paramName":"order_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","path:order_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"csharp","label":"C#","templateCode":"$d42","templateHtml":"$d43","tokens":[{"marker":"__RP_TOK_0__","paramName":"order_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","path:order_id":"123e4567-e89b-12d3-a456-426614174000"}}]},"method":"post","servers":"$62:props:children:0:props:children:props:children:1:props:children:1:props:children:0:0:props:servers","path":"/api/orders/{order_id}/payments","parameters":["$d2e:props:children:0:props:children:1:props:parameters:0","$d2e:props:children:0:props:children:1:props:parameters:1"]}],"$Ld44"],"$Ld45","$Ld46"]}]]}] c72:["$","div","CodeBlock-0",{"className":"wzy01m0 _18b50nc0","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"
'Authorization: Bearer <yourSecretApiKey>'
"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"'Authorization: Bearer '\n"}]}]]}] cd5:"Update a customer" d44:["$","$L10d",null,{"security":[{"Api-Key":[]}],"authorization":{"Api-Key":{"type":"apiKey","in":"header","name":"Authorization","description":"Each Merchant API request must contain an authorization header in the following format:\n\n```\n'Authorization: Bearer '\n```\n\nTo use this API, you need to generate API keys from your Revolut Business account. The Secret key is used in the authorization header for all server calls, while the Public key is provided with payment methods at checkout.\n\n:::info\nFor detailed instructions on generating your API keys, see: [Generate API keys](https://developer.revolut.com/docs/guides/merchant/get-started#generate-api-keys).\n:::","descriptionNode":"$Ld47"}}}] d45:["$","$L10f",null,{"exampleBlocks":{"application/json":{"variants":[{"key":"saved_card_customer","label":"Saved card (customer initiator)","rawValue":"$20:props:children:0:props:children:props:requestBody:content:application/json:examples:saved_card_customer:value","block":"$Ld48"},{"key":"saved_card_merchant","label":"Saved card (merchant initiator)","rawValue":"$20:props:children:0:props:children:props:requestBody:content:application/json:examples:saved_card_merchant:value","block":"$Ld49"},{"key":"revolut_pay","label":"Saved Revolut Pay (merchant initiator)","rawValue":"$20:props:children:0:props:children:props:requestBody:content:application/json:examples:revolut_pay:value","block":"$Ld4a"}],"syncedPropertyName":"$undefined"}},"title":"Request body samples","headingAs":"h4"}] d46:["$","$L110",null,{"exampleBlocks":{"200":{"application/json":{"variants":[{"key":"successful_payment_card","label":"Payment authorised (card)","rawValue":"$20:props:children:0:props:children:props:responses:200:content:application/json:examples:successful_payment_card:value","block":"$Ld4b"},{"key":"successful_payment_revolut_pay_account","label":"Payment authorised (Revolut Pay - Revolut account)","rawValue":"$20:props:children:0:props:children:props:responses:200:content:application/json:examples:successful_payment_revolut_pay_account:value","block":"$Ld4c"},{"key":"successful_payment_revolut_pay_card","label":"Payment authorised (Revolut Pay - card)","rawValue":"$20:props:children:0:props:children:props:responses:200:content:application/json:examples:successful_payment_revolut_pay_card:value","block":"$Ld4d"},{"key":"three_ds","label":"Saved card payment (3DS challenge)","rawValue":"$20:props:children:0:props:children:props:responses:200:content:application/json:examples:three_ds:value","block":"$Ld4e"},{"key":"three_ds_fingerprint","label":"Saved card payment (3DS fingerprint challenge)","rawValue":"$20:props:children:0:props:children:props:responses:200:content:application/json:examples:three_ds_fingerprint:value","block":"$Ld4f"}],"syncedPropertyName":"$undefined"}},"400":{"application/json":{"variants":[{"key":"example-1","label":"example-1","rawValue":"$20:props:children:0:props:children:props:responses:400:content:application/json:examples:example-1:value","block":"$Ld50"}],"syncedPropertyName":"$undefined"}},"401":{},"404":{"application/json":{"variants":[{"key":"example-1","label":"example-1","rawValue":"$20:props:children:0:props:children:props:responses:404:content:application/json:examples:example-1:value","block":"$Ld51"}],"syncedPropertyName":"$undefined"}}},"headingAs":"h4"}] c94:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unique identifier for the customer."}]]}] c95:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The full name of the customer."}]]}] c96:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The email address of the customer."}]]}] c97:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The phone number of the customer in ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/E.164","target":"_blank","rel":"noreferrer","children":"E.164 format"}],"."]}]]}] c98:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The date and time the customer was created."}]]}] c99:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The date and time the customer was last updated."}]]}] c9a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unique identifier for the payment method."}]]}] c9b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of the payment method."}]]}] c9c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Indicates in which case this saved payment method can be used for payments."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Value","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"customer"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"This payment method can be used only when the customer is on the checkout page.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"merchant"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"This payment method can be used without the customer being on the checkout page, and the merchant can initiate transactions, for example, to take payments for recurring transactions.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] c9d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The date and time the payment method was added."}]]}] c9e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The BIN (Bank Identification Number) of the payment card, typically the first 6-8 digits."}]]}] c9f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The last four digits of the payment card number."}]]}] ca0:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The expiry month of the payment card."}]]}] ca1:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The expiry year of the payment card."}]]}] c7d:["$","div","CodeBlock-0",{"className":"wzy01m0 _18b50nc0","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"
'Authorization: Bearer <yourSecretApiKey>'
"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"'Authorization: Bearer '\n"}]}]]}] ca2:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The name of the cardholder as it appears on the card."}]]}] ca3:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The brand of the payment card."}]]}] ca4:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The funding type of the payment card."}]]}] ca5:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The name of the card-issuing bank or institution."}]]}] ca6:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The ISO 3166-1 alpha-2 country code of the country where the payment card was issued."}]]}] ca7:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Primary address line."}]]}] ca8:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Secondary address line, such as floor and apartment number."}]]}] ca9:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"State or province of the address."}]]}] caa:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"City of the address."}]]}] cab:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"ISO 2-letter country code."}]]}] cac:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Postal code of the address."}]]}] cad:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The billing address associated with the payment method."}]]}] cae:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The hardware identifier of the Revolut Terminal device used to process the payment."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":"Only present for card-present transactions processed via Revolut Terminal."}]}]]}]]}] caf:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A saved card payment method."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["The ",["$","code","code-0",{"children":"checks"}]," object (3DS, CVV, address verification) is not included as it is specific to the transactional payment context."]}]}]]}]]}] cb0:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unique identifier for the payment method."}]]}] cb1:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of the payment method."}]]}] cb2:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Indicates in which case this saved payment method can be used for payments."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Value","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"customer"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"This payment method can be used only when the customer is on the checkout page.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"merchant"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"This payment method can be used without the customer being on the checkout page, and the merchant can initiate transactions, for example, to take payments for recurring transactions.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] cb3:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The date and time the payment method was added."}]]}] cb4:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A saved Revolut Pay payment method on a customer profile."}],"\n",["$","p","p-1",{"children":["Both Revolut Pay card-backed and account-to-account (A2A) variants are\nrepresented by this single type at the saved payment method level.\nNo underlying card details are exposed here; use the order-level\n",["$","code","code-0",{"children":"payments[].payment_method"}]," object (types ",["$","code","code-1",{"children":"revolut_pay_card"}]," /\n",["$","code","code-2",{"children":"revolut_pay_account"}],") for per-transaction details."]}]]}] cb5:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unique identifier for the payment method."}]]}] cb6:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of the payment method."}]]}] cb7:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Indicates in which case this saved payment method can be used for payments."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Value","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"customer"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"This payment method can be used only when the customer is on the checkout page.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"merchant"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"This payment method can be used without the customer being on the checkout page, and the merchant can initiate transactions, for example, to take payments for recurring transactions.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] cb8:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The last four digits of the debtor's IBAN."}]]}] cb9:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The full name of the debtor as provided in the mandate."}]]}] cba:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The unique mandate reference generated by Revolut. Include this in pre-debit notifications sent to your customers."}]]}] cbb:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The billing address associated with the payment method."}]]}] cbc:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The date and time the payment method was added."}]]}] cbd:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A saved SEPA Direct Debit payment method on a customer profile."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/accept-payments/payment-methods/sepa-direct-debit/server-to-server","target":"_blank","rel":"noreferrer","children":"SEPA Direct Debit server-to-server integration"}]]}]}]]}]]}] cbe:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A saved payment method on a customer profile."}],"\n",["$","p","p-1",{"children":["Use the ",["$","code","code-0",{"children":"type"}]," field to determine the specific payment method variant."]}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":["This schema represents a stored credential available for future charges and supports three types: ",["$","code","code-0",{"children":"card"}],", ",["$","code","code-1",{"children":"revolut_pay"}],", and ",["$","code","code-2",{"children":"sepa_direct_debit"}],"."]}],["$","p","p-1",{"children":["It differs from the ",["$","code","code-0",{"children":"payment_method"}]," object on a Payment, which is a transactional snapshot of how a specific charge was executed and includes additional detail such as wallet wrappers (",["$","code","code-1",{"children":"apple_pay"}],", ",["$","code","code-2",{"children":"google_pay"}],") and Revolut Pay funding source (",["$","code","code-3",{"children":"revolut_pay_card"}]," vs ",["$","code","code-4",{"children":"revolut_pay_account"}],")."]}]]}]]}]]}] cbf:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["Saved payment methods associated with this customer. Each entry represents a\npayment method authorised for future charges. Two types are supported: ",["$","code","code-0",{"children":"card"}],"\n(with full card details) and ",["$","code","code-1",{"children":"revolut_pay"}]," (covers both card-backed and\naccount-to-account Revolut Pay variants). Use the ",["$","code","code-2",{"children":"type"}]," field on each item\nto identify the variant."]}]]}] cc0:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A customer object."}]]}] cc1:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"OK"}]]}] cc2:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An identifier that can be used to determine what went wrong."}],"\n",["$","p","p-1",{"children":"Error codes are not globally unique, but uniqueness is guaranteed within endpoints."}]]}] cc3:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Some human readable text describing what went wrong."}]]}] cc4:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://www.unixtimestamp.com/","target":"_blank","rel":"noreferrer","children":"UNIX timestamp"}]," of the date and time the error happened."]}]]}] cc5:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Bad Request"}]]}] cc6:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An identifier that can be used to determine what went wrong."}],"\n",["$","p","p-1",{"children":"Error codes are not globally unique, but uniqueness is guaranteed within endpoints."}]]}] cc7:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Some human readable text describing what went wrong."}]]}] cc8:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://www.unixtimestamp.com/","target":"_blank","rel":"noreferrer","children":"UNIX timestamp"}]," of the date and time the error happened."]}]]}] cc9:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unauthorized"}]]}] cca:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An identifier that can be used to determine what went wrong."}],"\n",["$","p","p-1",{"children":"Error codes are not globally unique, but uniqueness is guaranteed within endpoints."}]]}] ccb:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Some human readable text describing what went wrong."}]]}] ccc:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://www.unixtimestamp.com/","target":"_blank","rel":"noreferrer","children":"UNIX timestamp"}]," of the date and time the error happened."]}]]}] ccd:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Not Found"}]]}] cce:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The full name of the customer."}]]}] ccf:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The email address of the customer."}]]}] cd0:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The phone number of the customer in ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/E.164","target":"_blank","rel":"noreferrer","children":"E.164 format"}],"."]}]]}] cd1:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The birth date of the customer."}]]}] cd2:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The request body for updating a customer."}],"\n",["$","p","p-1",{"children":"All fields are optional. Only the fields provided in the request will be updated."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":[["$","code","code-0",{"children":"business_name"}]," is not supported in this version of the API."]}]}]]}]]}] cd6:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Update the attributes of a specific customer."}],"\n",["$","p","p-1",{"children":"All request body fields are optional. Only the fields provided will be updated."}],"\n",["$","$L5f9","Expandable-0",{"title":"AFT processing requirements","children":["\n","\n",["$","p","p-0",{"children":["For merchants in the following industries, ",["$","code","code-0",{"children":"full_name"}]," and ",["$","code","code-1",{"children":"date_of_birth"}]," are required for Account Funding Transaction (AFT) processing:"]}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Industry","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Required fields","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":"Crypto","className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":[["$","code","code-0",{"children":"full_name"}],", ",["$","code","code-1",{"children":"date_of_birth"}]],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":"Financial Institutions","className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":[["$","code","code-0",{"children":"full_name"}],", ",["$","code","code-1",{"children":"date_of_birth"}]],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":"Stored Value / Wallets","className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":[["$","code","code-0",{"children":"full_name"}],", ",["$","code","code-1",{"children":"date_of_birth"}]],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}],"\n"]}]]}] cd7:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["This parameter accepts the ",["$","a","a-0",{"href":"https://business.revolut.com/settings/apis?tab=merchant-api","target":"_blank","rel":"noreferrer","children":"Merchant API Secret key"}]," to authorise requests coming from the merchant's backend."]}],"\n",["$","p","p-1",{"children":["It ensures that ensures that each request is authenticated and authorised by verifying the secret key. The secret key should be included in all request headers as a ",["$","code","code-0",{"children":"Bearer"}]," token."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#authentication","target":"_blank","rel":"noreferrer","children":"Authentication"}]]}]}]]}]]}] cd8:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The version of the Merchant API, specified in ",["$","code","code-0",{"children":"YYYY-MM-DD"}]," format."]}],"\n",["$","p","p-1",{"children":["This endpoint is available from version ",["$","code","code-0",{"children":"2024-09-01"}],". If a version earlier than ",["$","code","code-1",{"children":"2024-09-01"}]," is provided, the endpoint returns a ",["$","code","code-2",{"children":"404"}]," response."]}],"\n",["$","p","p-2",{"children":"If not specified, you will receive an error."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information about API versioning, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/reference/versioning/api-versions","target":"_blank","rel":"noreferrer","children":"API versions"}],"."]}]}]]}]]}] cd9:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A UUID string, typically used to identify resources."}]]}] cda:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ID of the ",["$","code","code-0",{"children":"Customer"}]," object."]}]]}] d2f:"Pay for an order" cee:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Each Merchant API request must contain an authorization header in the following format:"}],"\n","$Ld52","\n",["$","p","p-1",{"children":"To use this API, you need to generate API keys from your Revolut Business account. The Secret key is used in the authorization header for all server calls, while the Public key is provided with payment methods at checkout."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For detailed instructions on generating your API keys, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/get-started#generate-api-keys","target":"_blank","rel":"noreferrer","children":"Generate API keys"}],"."]}]}]]}]]}] cf5:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The ID of the payment."}]]}] cf6:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Permanent order ID used to retrieve, capture, cancel, or refund an order after authorization."}]]}] cf7:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of payment method used to pay for the order."}]]}] cf8:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Indicates whether the customer used their card or Revolut account via Revolut Pay."}]]}] cf9:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"ID of the saved payment method."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["The ",["$","code","code-0",{"children":"id"}]," parameter is only returned if the payment method is saved."]}]}]]}]]}] cfa:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of payment method used to pay for the order."}]]}] cfb:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Indicates whether the customer used their card or Revolut account via Revolut Pay."}]]}] cfc:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"ID of the saved payment method."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["The ",["$","code","code-0",{"children":"id"}]," parameter is only returned if the payment method is saved."]}]}]]}]]}] cfd:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of the card."}]]}] cfe:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The last four digits of the card number."}]]}] cff:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of payment method used to pay for the order."}]]}] d00:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of the card."}]]}] d01:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The last four digits of the card number."}]]}] d02:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"ID of the saved payment method."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["The ",["$","code","code-0",{"children":"id"}]," parameter is only returned if the payment method is saved."]}]}]]}]]}] d03:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"ID of the saved payment method."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["The ",["$","code","code-0",{"children":"id"}]," parameter is only returned when the payment method is saved for the merchant."]}]}]]}]]}] d04:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of payment method used to pay for the order."}],"\n",["$","p","p-1",{"children":"Available values:"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":["Payment method ",["$","code","code-0",{"children":"type"}]],"className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"apple_pay"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using Apple Pay.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"card"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using their credit or debit card.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"google_pay"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using Google Pay.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"revolut_pay_card"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order via Revolut Pay using their credit or debit card.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-4",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"revolut_pay_account"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order via Revolut Pay using their Revolut account.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-5",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"sepa_direct_debit"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using SEPA Direct Debit.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] d05:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The last four digits of the debtor's IBAN."}]]}] d06:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The full name of the debtor as provided in the mandate."}]]}] d07:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The unique mandate reference generated by Revolut. Include this in pre-debit notifications sent to your customers."}]]}] d08:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object containing details of a SEPA Direct Debit payment."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/accept-payments/payment-methods/sepa-direct-debit/server-to-server","target":"_blank","rel":"noreferrer","children":"SEPA Direct Debit server-to-server integration"}]]}]}]]}]]}] d09:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The payment method used to pay for the order."}]]}] d0a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Temporary token of the payment used to fetch the reward offer during checkout and link user registrations to the given offers."}],"\n",["$","p","p-1",{"children":"The token is only valid for a limited time."}]]}] d0b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The payment amount in minor units (e.g., cents). The value of this field depends on the payment type and state."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Payment type","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"State","className":"eowryt6","ref":"$undefined"}],["$","th","th-2",{"children":"Amount value","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":"Standard payment","className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Any","className":"eowryt7","ref":"$undefined"}],["$","td","td-2",{"children":"Total payment amount","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":"Pre-authorised payment","className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["$","code","code-0",{"children":"authorisation_started"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-2",{"children":"New amount being authorised (during increment processing)","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":"Pre-authorised payment","className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["$","code","code-0",{"children":"authorised"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-2",{"children":["Currently authorised amount (equals ",["$","code","code-0",{"children":"authorised_amount"}],")"],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For pre-authorised payments, see the ",["$","code","code-0",{"children":"authorised_amount"}]," field for tracking the currently authorised amount separately."]}]}]]}]]}] d0c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":[["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_4217","target":"_blank","rel":"noreferrer","children":"ISO 4217"}]," currency code in upper case."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information about the supported currencies, see: ",["$","a","a-0",{"href":"https://help.revolut.com/business/help/merchant-accounts/payments/in-which-currencies-can-i-accept-payments/","target":"_blank","rel":"noreferrer","children":"Help Center"}],"."]}]}]]}]]}] d0d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The status of the payment."}]]}] d0e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The reason for a ",["$","code","code-0",{"children":"failed"}]," or ",["$","code","code-1",{"children":"declined"}]," payment."]}],"\n",["$","p","p-1",{"children":["A failed or declined payment can result from multiple reasons. To learn more, check our ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/reference/error-codes/decline-reasons","target":"_blank","rel":"noreferrer","children":"failure reasons"}],"."]}]]}] d0f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Type of the authentication challenge the payment triggers."}]]}] d10:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The URL of the authentication challenge."}]]}] d11:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Information about the 3DS challenge."}]]}] d12:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Type of the authentication challenge the payment triggers."}]]}] d13:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The URL of the fingerprint. (Used only internally by Revolut.)"}]]}] d14:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Data about the fingerprint used for authentication. (Used only internally\nby Revolut.)"}]]}] d15:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Information about the 3DS fingerprint challenge."}]]}] d16:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["Details about the authentication challenge that should be performed to complete the authentication process. For more information about Revolut's 3DS solution, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/reference/3d-secure","target":"_blank","rel":"noreferrer","children":"3D Secure overview"}],"."]}],"\n",["$","p","p-1",{"children":["Only returned if the payment's state is ",["$","code","code-0",{"children":"authentication_challenge"}],"."]}]]}] d17:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Payment initiated"}]]}] d18:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The ID of the error. You can share this ID with Revolut\nsupport for troubleshooting."}]]}] d19:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The date and time the error happened."}]]}] d1a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Bad Request"}]]}] d1b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unauthorized"}]]}] d1c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The ID of the error. You can share this ID with Revolut\nsupport for troubleshooting."}]]}] d1d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The date and time the error happened."}]]}] d1e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Not Found"}]]}] d1f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Type of saved payment method."}]]}] d20:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Saved payment method ID."}]]}] d21:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Indicates who is allowed to initiate the payment."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":"Using this endpoint, only merchant initiated payments are supported with Revolut Pay."}]}]]}]]}] d22:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Type of environment where the payment was made."}]]}] d23:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Defines the offset to UTC in minutes."}]]}] d24:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The browser's available colour depth."}]]}] d25:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The browser's screen width in pixels."}]]}] d26:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The browser's screen height in pixels."}]]}] d27:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Indicates if the browser has Java enabled."}]]}] d28:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Defines the width of the pop-up window where the authentication challenge appears."}]]}] d29:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The URL of the page where the payment was initiated."}]]}] d2a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Browser environment"}]]}] d2b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Environment object, indicating in which environment the payment was made."}],"\n",["$","div","inlinealert-0",{"data-type":"warning","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMark","color":"var(--rui-color-warning)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["Only required if ",["$","code","code-0",{"children":"initiator: customer"}],"."]}]}]]}],"\n",["$","div","inlinealert-1",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["Only ",["$","code","code-0",{"children":"browser"}]," is available at the moment."]}]}]]}]]}] d2c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object containing information about the saved payment method used to pay for the order."}]]}] d30:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Initiate a payment to pay full amount for an order using a customer's saved payment method."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["The ",["$","code","code-0",{"children":"/orders/{order_id}/confirm"}]," endpoint has been deprecated. It will be only supported for already existing implementations."]}]}]]}],"\n",["$","div","inlinealert-1",{"data-type":"warning","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMark","color":"var(--rui-color-warning)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":"This endpoint is part of a new API, pay attention to the different endpoint URL."}]}]]}],"\n",["$","p","p-1",{"children":["For more information about how to save and charge payment methods, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/optimise-checkout/save-payment-methods/charge-saved-payment-method","target":"_blank","rel":"noreferrer","children":"Charge a customer's saved payment method"}],"."]}],"\n",["$","p","p-2",{"children":["The following table shows who can initiate payments on saved payment methods (",["$","code","code-0",{"children":"initiator"}]," parameter), depending on if the payment method was saved for the customer or the merchant (",["$","code","code-1",{"children":"savedPaymentMethodFor"}]," parameter):"]}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":["$","code","code-0",{"children":"savePaymentMethodFor: customer"}],"className":"eowryt6","ref":"$undefined"}],["$","th","th-2",{"children":["$","code","code-0",{"children":"savePaymentMethodFor: merchant"}],"className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","strong","strong-0",{"children":["$","code","code-0",{"children":"initiator: customer"}]}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Allowed","className":"eowryt7","ref":"$undefined"}],["$","td","td-2",{"children":"Allowed","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","strong","strong-0",{"children":["$","code","code-0",{"children":"initiator: merchant"}]}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Not allowed","className":"eowryt7","ref":"$undefined"}],["$","td","td-2",{"children":"Allowed","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}],"\n",["$","div","inlinealert-2",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":"Using this endpoint, only merchant initiated payments are supported with Revolut Pay."}]}]]}],"\n",["$","p","p-3",{"children":["For more information about customers' payment methods, see the ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#retrieve-payment-method-list","target":"_blank","rel":"noreferrer","children":"Retrieve payment method list of a customer"}]," operation."]}]]}] d31:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["This parameter accepts the ",["$","a","a-0",{"href":"https://business.revolut.com/settings/apis?tab=merchant-api","target":"_blank","rel":"noreferrer","children":"Merchant API Secret key"}]," to authorise requests coming from the merchant's backend."]}],"\n",["$","p","p-1",{"children":["It ensures that ensures that each request is authenticated and authorised by verifying the secret key. The secret key should be included in all request headers as a ",["$","code","code-0",{"children":"Bearer"}]," token."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#authentication","target":"_blank","rel":"noreferrer","children":"Authentication"}]]}]}]]}]]}] d32:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A UUID string, typically used to identify resources."}]]}] d33:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ID of the ",["$","code","code-0",{"children":"Order"}]," object."]}]]}] d47:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Each Merchant API request must contain an authorization header in the following format:"}],"\n","$Ld53","\n",["$","p","p-1",{"children":"To use this API, you need to generate API keys from your Revolut Business account. The Secret key is used in the authorization header for all server calls, while the Public key is provided with payment methods at checkout."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For detailed instructions on generating your API keys, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/get-started#generate-api-keys","target":"_blank","rel":"noreferrer","children":"Generate API keys"}],"."]}]}]]}]]}] d89:T4c1,Automatic cancellation period for uncaptured orders, specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. After this period, the authorised payment is automatically cancelled and the order is cancelled. Maximum: 7 days = `P7D`. :::note The following limitations apply: - Cannot be a negative value. - Cannot be updated if the new value is less than or equal to the elapsed time since authorisation. **Failing scenario:** - Original value: 7 days - Time since authorisation: 3 days - Update value: 2 days In this scenario, an error is returned. **Successful scenario:** - Original value: 7 days - Time since authorisation: 3 days - Update value: 4 days In this scenario, the parameter can be updated. - Cannot be updated if cancellation is ≤ 30 minutes away. **Failing scenario:** - Original value: 12 hours - Time since authorisation: 11 hours 40 minutes In this scenario, an error is returned. **Successful scenario:** - Original value: 12 hours - Time since authorisation: 11 hours 20 minutes In this scenario, the parameter can be updated. :::d8b:T480,You can set a dynamic statement descriptor for your orders by providing a custom suffix. A statement descriptor is the text shown on cardholders' bank or card statements, helping them recognise a transaction or merchant. This field can be used to send extra information with the statement descriptor for card transactions. The complete descriptor is built using the following format: `{base}*{suffix}`, where: - **`{base}`** is the existing descriptor configured in the Revolut Business dashboard (**Settings > Business account > Merchant profile > Statement descriptor**). - **`{suffix}`** is defined by the `statement_descriptor_suffix` field. :::note - If the combined descriptor's length (base + suffix) exceeds the character limits of card scheme providers, the final value will be truncated. For example if the limit is 22 characters, the base descriptor is `"base"` and the suffix is `"testdescriptorsuffix"`, the final descriptor becomes `"base*testdescriptorsuf"`. - The final statement descriptor shown on a cardholder's statement may vary by issuing bank, as some banks apply their own custom formatting or truncation rules. :::19:["$","$7a","retrieve-order-list",{"children":[["$","section",null,{"className":"y9a0do0","data-variant":"endpoint","children":["$","$L7b",null,{"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","required":["orders"],"properties":{"orders":{"type":"array","description":"List of orders.","items":{"title":"Simplified order","type":"object","description":"A simplified order object returned in list responses.\n\nTo get the full details of an order, use the [Retrieve an order](https://developer.revolut.com/docs/api/merchant#retrieve-order) endpoint.","properties":{"id":{"type":"string","format":"uuid","description":"Permanent order ID used to retrieve, capture, cancel, or refund an order after authorization.","descriptionNode":"$Ld54"},"token":{"type":"string","description":"Temporary ID for the order, which expires when the payment is authorised.\n\nThe order `token` is used for [token-based initialisation](https://developer.revolut.com/docs/sdks/merchant-web-sdk/initialisation/token-based), and is returned by the `createOrder` callback in the following payment methods:\n\n- [Embedded Checkout](https://developer.revolut.com/docs/sdks/merchant-web-sdk/payment-methods/embedded-checkout#embedded-checkout-options-interface)\n- [Revolut Pay](https://developer.revolut.com/docs/sdks/merchant-web-sdk/payment-methods/revolut-pay#widget-payments-revolut-pay-options)\n- [Apple Pay and Google Pay](https://developer.revolut.com/docs/sdks/merchant-web-sdk/payment-methods/apple-pay-google-pay#payment-request-options-interface)\n- [Pay by Bank](https://developer.revolut.com/docs/sdks/merchant-web-sdk/payment-methods/pay-by-bank#pay-by-bank-options-interface)","descriptionNode":"$Ld55"},"type":{"type":"string","description":"The type of the order.","enum":["payment","payment_request","refund","chargeback","chargeback_reversal","credit_reimbursement"],"descriptionNode":"$Ld56"},"state":{"type":"string","description":"The state of the order in its lifecycle.\n\n| State | Description |\n|-------|-------------|\n| `pending` | Order created, awaiting payment |\n| `processing` | Payment is being processed |\n| `authorised` | Payment authorised but not yet captured (for manual capture) |\n| `completed` | Payment successfully captured and settled |\n| `cancelled` | Order was cancelled |\n| `failed` | Payment failed |\n\n:::info\nFor more information, see: [Order and payment lifecycle](https://developer.revolut.com/docs/guides/merchant/reference/order-lifecycle)\n:::","enum":["pending","processing","authorised","completed","cancelled","failed"],"examples":["authorised"],"descriptionNode":"$Ld57"},"created_at":{"type":"string","format":"date-time","description":"The date and time the order was created.","descriptionNode":"$Ld58"},"updated_at":{"type":"string","format":"date-time","description":"The date and time the order was last updated.","descriptionNode":"$Ld59"},"amount":{"type":"integer","description":"The order total expressed in minor currency units, according to the [ISO 4217 standard](https://en.wikipedia.org/wiki/ISO_4217). For example, `7034` in `EUR` corresponds to €70.34.\n\n:::info\n- Conversion between major and minor units varies by currency. For instance, `100` minor units equal £1.00 in `GBP`, whereas in `ISK` they represent 100 units. For more details, see the [ISO 4217 standard](https://en.wikipedia.org/wiki/ISO_4217).\n- If `line_items` are provided, the order `amount` must equal the sum of all line items' `total_amount`.\n- For card payments with a non-zero amount, the order `amount` must be at least **$0.005** (or equivalent in different currencies, calculated using Revolut's exchange rate on the payment date). Otherwise, card payments can't be performed.\n:::","descriptionNode":"$Ld5a"},"currency":{"type":"string","format":"ISO 4217","minLength":3,"maxLength":3,"description":"[ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) currency code in upper case.\n\n:::info\nFor more information about the supported currencies, see: [Help Center](https://help.revolut.com/business/help/merchant-accounts/payments/in-which-currencies-can-i-accept-payments/).\n:::","descriptionNode":"$Ld5b"},"outstanding_amount":{"type":"integer","description":"The amount not yet paid for a given order (in minor currency units). For example, `7034` represents €70.34. \n\nThe value in this field may differ from `amount` if there are partial payments associated with the order.","descriptionNode":"$Ld5c"},"capture_mode":{"type":"string","description":"The capture mode of the order. `automatic` is used by default.\n\n| Parameter value | Description |\n| --------------- | ----------- |\n| `automatic` | The order is captured automatically after payment authorisation. |\n| `manual` | The order is not captured automatically. You must manually capture the order later. |\n\n:::info\nFor more information, see [Capture an order](https://developer.revolut.com/docs/api/merchant#capture-order).\n:::","default":"automatic","enum":["automatic","manual"],"descriptionNode":"$Ld5d"},"enforce_challenge":{"type":"string","description":"The enforce challenge mode. `automatic` is used by default.\n\n| Parameter value | Description |\n| --------------- | ----------- |\n| `automatic` | The payments created for an order will have challenge requirement calculated by our fraud mechanisms. Not all payments will trigger a 3DS challenge. |\n| `forced` | The payments created for an order will always require a 3DS challenge. Currently only supported for card payments. |","default":"automatic","enum":["automatic","forced"],"descriptionNode":"$Ld5e"},"authorisation_type":{"type":"string","description":"The type of authorisation for the order. Used with manual capture mode. If omitted, `final` is used by default.\n\n### Pre-authorisation\n\nPre-authorisation allows you to reserve funds on a customer's card without immediately capturing them. This is useful for scenarios like:\n\n- Hotel bookings where the final amount may vary\n- Car rentals where additional charges may apply\n- Deposits that need to be held temporarily\n\n| Parameter value | Description |\n| --------------- | ----------- |\n| `final` | Standard authorisation for immediate or near-immediate capture. |\n| `pre_authorisation` | Reserve funds for later capture, used with manual capture mode. |\n\n:::note\nPre-authorisation must be used with `capture_mode: manual`. For more information, see [Capture an order](https://developer.revolut.com/docs/api/merchant#capture-order).\n:::","default":"final","enum":["final","pre_authorisation"],"descriptionNode":"$Ld5f"},"description":{"type":"string","description":"The description of the order.","descriptionNode":"$Ld60"},"metadata":{"type":"object","description":"Additional information to track your orders in your system, by providing custom metadata using `\"\" : \"\"` pairs.\n\n:::warning\n**Restrictions:**\n\n- Both keys and values must be `string`s\n- Values cannot be `null`.\n- Max number of key-value pairs: `50`\n- Max length of values: `500` characters\n- Format of keys: Must start with a letter and contain only letters, digits, and underscores. Max 40 characters. Pattern: `^[a-zA-Z][a-zA-Z\\\\d_]{0,39}$`\n:::","maxProperties":50,"additionalProperties":{"type":"string","maxLength":500,"description":"Additional metadata value provided with the corresponding metadata key.","descriptionNode":"$Ld61"},"examples":[{"order_reference":"ORD-12345","customer_segment":"premium","internal_note":"VIP customer - priority handling"}],"descriptionNode":"$Ld62"},"related_order_id":{"type":"string","format":"uuid","description":"The unique ID of the original order that was refunded and this refund is associated with. You can use this ID to get more information about the related order using the [Retrieve an order](https://developer.revolut.com/docs/api/merchant#retrieve-order) operation.\n\n:::note\nThis field is only returned for orders with `type: refund`.\n:::","descriptionNode":"$Ld63"},"subscription_data":{"title":"Subscription data","type":"object","required":["subscription_id","billing_reason"],"description":"Subscription details linked to the order. Use this object to match an order with its underlying subscription and understand the billing context in which the order was created.\n\nOnly present on orders created by a subscription.","properties":{"subscription_id":{"type":"string","format":"uuid","description":"Unique identifier for the subscription.","descriptionNode":"$Ld64"},"active_cycle_id":{"type":"string","format":"uuid","description":"The unique identifier of the active (pre-paid) subscription cycle that this order collects payment for.\n\nThis is the current billing cycle whose recurring charges are being collected in advance by this order. For example, if a subscription cycle covers 1-31 July and the order is generated on 1 July, this field identifies that July cycle.","descriptionNode":"$Ld65"},"settled_cycle_id":{"type":"string","format":"uuid","description":"The unique identifier of the settled (post-paid) subscription cycle whose usage-based charges this order collects.\n\nThis is the previous billing cycle whose usage is being settled by this order. For example, if a subscription cycle covers usage from 1-30 June and the order is generated on 10 July, this field identifies that June cycle.","descriptionNode":"$Ld66"},"billing_reason":{"type":"string","enum":["cycle_billing","final_settlement","setup_intent"],"description":"The reason this subscription order was created.\n\n| Value | Description |\n| ----- | ----------- |\n| `cycle_billing` | The order was automatically generated to collect payment for an ongoing subscription cycle. `active_cycle_id` is present; `settled_cycle_id` is present if the previous cycle included usage-based products. |\n| `final_settlement` | The order was automatically generated after the subscription ended to collect outstanding usage-based charges. `active_cycle_id` is absent; `settled_cycle_id` is present. |\n| `setup_intent` | The order was manually created by the merchant or customer to update the payment method on file. `active_cycle_id` is absent; `settled_cycle_id` is absent. |","descriptionNode":"$Ld67"}},"descriptionNode":"$Ld68"},"customer":{"title":"Order customer","type":"object","description":"A lightweight customer object embedded in an order.\n\nThis is a simplified representation intended for the order context. For the full customer object including all payment methods, use the [Retrieve a customer](https://developer.revolut.com/docs/api/merchant#retrieve-customer) endpoint.","properties":{"id":{"type":"string","format":"uuid","description":"Unique identifier for the customer.","descriptionNode":"$Ld69"},"email":{"type":"string","format":"email","description":"The email address of the customer.","descriptionNode":"$Ld6a"},"phone":{"type":"string","description":"The phone number of the customer in [E.164 format](https://en.wikipedia.org/wiki/E.164).","descriptionNode":"$Ld6b"},"full_name":{"type":"string","description":"The full name of the customer.","descriptionNode":"$Ld6c"},"date_of_birth":{"type":"string","format":"date","description":"The birth date of the customer.","descriptionNode":"$Ld6d"}},"required":["id"],"descriptionNode":"$Ld6e"},"line_items":{"type":"array","maxItems":250,"description":"An array of line items included in the order. Each line item represents an individual product or service, along with its quantity, price, taxes, and discounts.\n\n:::info\nRequired for merchants collecting payment for one or multiple products/services in one transaction. Omitting this information may trigger additional scrutiny and risk mitigation actions by Revolut.\n:::","items":{"type":"object","properties":{"name":{"type":"string","maxLength":250,"description":"Name of the line item.","descriptionNode":"$Ld6f"},"type":{"type":"string","enum":["physical","service"],"description":"Type of the line item.","descriptionNode":"$Ld70"},"quantity":{"type":"object","description":"Object representing the quantity details of a line item, including the amount and its associated unit of measurement.","properties":{"value":{"type":"number","format":"double","minimum":0,"description":"The number of units of the line item.","descriptionNode":"$Ld71"},"unit":{"type":"string","maxLength":100,"description":"The measurement unit for the quantity, such as `cm`, or `kg`.","descriptionNode":"$Ld72"}},"required":["value"],"descriptionNode":"$Ld73"},"unit_price_amount":{"type":"integer","format":"int64","minimum":0,"description":"The unit price of the line item.","descriptionNode":"$Ld74"},"total_amount":{"type":"integer","format":"int64","description":"The total amount to be paid for the line item, including taxes and discounts.","descriptionNode":"$Ld75"},"external_id":{"type":"string","maxLength":250,"description":"Unique identifier of line item in the merchant's system.","descriptionNode":"$Ld76"},"discounts":{"type":"array","maxItems":50,"description":"A list of discounts applied to the line item. Each discount should be subtracted from the total amount payable for the item.","items":{"type":"object","description":"Details of a discount applied to the line item, including its name and monetary value.","properties":{"name":{"type":"string","maxLength":100,"description":"The specific name or label of the discount applied to the line item.","descriptionNode":"$Ld77"},"amount":{"type":"integer","format":"int64","minimum":0,"description":"The monetary value of the discount. ","descriptionNode":"$Ld78"}},"required":["name","amount"],"descriptionNode":"$Ld79"},"descriptionNode":"$Ld7a"},"taxes":{"type":"array","maxItems":50,"description":"A list of taxes applied to the line item. Each tax should be added to the total amount payable for the item.","items":{"type":"object","description":"Details about a tax applied to the line item, including its name and the corresponding amount.","properties":{"name":{"type":"string","description":"The specific name or designation of the tax applied to the line item.","maxLength":100,"descriptionNode":"$Ld7b"},"amount":{"type":"integer","format":"int64","description":"The monetary value of the tax in minor currency units (e.g., cents for EUR).","minimum":0,"descriptionNode":"$Ld7c"}},"required":["name","amount"],"descriptionNode":"$Ld7d"},"descriptionNode":"$Ld7e"},"image_urls":{"type":"array","maxItems":50,"description":"A list of URLs pointing to images related to the line item. These images can provide visual details or representations of the item.","items":{"type":"string","format":"uri","pattern":"^https?:\\/{2}.+/gi","maxLength":2000,"description":"URL to an image associated with the line item.\n\n:::warning\nRestrictions:\n- Must be a valid URI as defined by [RFC 3986](https://datatracker.ietf.org/doc/html/rfc3986)\n- URI scheme is required and must be either `http` or `https`\n- URI host is required and cannot be `localhost` or an IP address\n- Max length: `2000`\n- Reserved or invalid characters must be percent-encoded (for example, use `%20` instead of a space)\n:::","descriptionNode":"$Ld7f"},"descriptionNode":"$Ld80"},"description":{"type":"string","maxLength":1024,"description":"Description of the line item.","descriptionNode":"$Ld81"},"url":{"type":"string","format":"uri","pattern":"^https?:\\/{2}.+/gi","maxLength":2000,"description":"An HTTP/HTTPS URL that links to more information about the line item, such as a product page or details.\n\n:::warning\nRestrictions:\n- Must be a valid URI as defined by [RFC 3986](https://datatracker.ietf.org/doc/html/rfc3986)\n- URI scheme is required and must be either `http` or `https`\n- URI host is required and cannot be `localhost` or an IP address\n- Max length: `2000`\n- Reserved or invalid characters must be percent-encoded (for example, use `%20` instead of a space)\n:::","descriptionNode":"$Ld82"}},"required":["name","unit_price_amount","total_amount","quantity","type"]},"descriptionNode":"$Ld83"},"merchant_order_data":{"type":"object","description":"Object for providing additional information stored in the merchant's order management system. ","properties":{"url":{"type":"string","format":"uri","pattern":"^https?:\\/{2}.+/gi","maxLength":2000,"description":"The URL of the order stored in the merchant's order management system.\n\nThis URL will be included in the order confirmation email for payments made via Revolut Pay. If specified, this URL will override the default link to the merchant's **Business website** configured in the Revolut Business account.\n\n:::warning\nRestrictions:\n- Must be a valid URI as defined by [RFC 3986](https://datatracker.ietf.org/doc/html/rfc3986)\n- URI scheme is required and must be either `http` or `https`\n- URI host is required and cannot be `localhost` or an IP address\n- Max length: `2000`\n- Reserved or invalid characters must be percent-encoded (for example, use `%20` instead of a space)\n:::","descriptionNode":"$Ld84"},"reference":{"type":"string","description":"Merchant order ID for external reference.\n\nUse this field to set the ID that your own system can use to easily track orders.","descriptionNode":"$Ld85"}},"descriptionNode":"$Ld86"},"location_id":{"type":"string","format":"uuid","description":"Unique ID representing the location where merchants sells products.\n\n:::info\nFor more information, see: [Locations](https://developer.revolut.com/docs/api/merchant#tag-locations).\n::: ","descriptionNode":"$Ld87"},"redirect_url":{"type":"string","format":"uri","pattern":"^https?:\\/{2}.+/gi","maxLength":2000,"description":"The URL your customer will be redirected to after a successful payment on the hosted checkout page (`checkout_url` parameter's value of the order).\n\n:::warning\nRestrictions:\n- Must be a valid URI as defined by [RFC 3986](https://datatracker.ietf.org/doc/html/rfc3986)\n- URI scheme is required and must be either `http` or `https`\n- URI host is required and cannot be `localhost` or an IP address\n- Max length: `2000`\n- Reserved or invalid characters must be percent-encoded (for example, use `%20` instead of a space)\n:::\n\n:::info\nFor more information on how to use the `redirect_url`, see: [Custom redirection via the API](https://developer.revolut.com/docs/guides/merchant/accept-payments/online-payments/hosted-checkout-page/api#custom-post-payment-redirection-optional)\n:::","descriptionNode":"$Ld88"},"cancel_authorised_after":{"type":"string","format":"duration","description":"$d89","descriptionNode":"$Ld8a"},"statement_descriptor_suffix":{"type":"string","description":"$d8b","minLength":1,"maxLength":19,"pattern":"^[^*\\n\\r\\\\]+$","descriptionNode":"$Ld8c"}},"required":["id","type","state","created_at","updated_at","amount","currency","outstanding_amount","capture_mode","enforce_challenge"],"descriptionNode":"$Ld8d"},"descriptionNode":"$Ld8e"}}},"examples":{"list_of_orders":{"summary":"List of orders","value":{"orders":[{"id":"a1b2c3d4-0001-0000-0000-000000000001","token":"b2c3d4e5-0001-0000-0000-000000000001","type":"payment","state":"completed","created_at":"2025-03-10T08:30:00Z","updated_at":"2025-03-10T08:32:15Z","amount":4999,"currency":"GBP","outstanding_amount":0,"capture_mode":"automatic","enforce_challenge":"automatic","description":"Premium subscription","customer":{"id":"c3d4e5f6-0001-0000-0000-000000000001","email":"jane.doe@example.com","full_name":"Jane Doe","phone":"+441234567890"}},{"id":"a1b2c3d4-0002-0000-0000-000000000002","token":"b2c3d4e5-0002-0000-0000-000000000002","type":"payment","state":"completed","created_at":"2025-03-11T09:00:00Z","updated_at":"2025-03-11T09:01:45Z","amount":12500,"currency":"EUR","outstanding_amount":0,"capture_mode":"automatic","enforce_challenge":"automatic","description":"Shopping cart","customer":{"id":"c3d4e5f6-0002-0000-0000-000000000002","email":"john.smith@example.com","full_name":"John Smith"},"line_items":[{"name":"Wireless headphones","quantity":1,"unit_price":9900,"total_amount":9900},{"name":"Phone case","quantity":2,"unit_price":1300,"total_amount":2600}]},{"id":"a1b2c3d4-0003-0000-0000-000000000003","type":"refund","state":"completed","created_at":"2025-03-12T11:15:00Z","updated_at":"2025-03-12T11:16:30Z","amount":4999,"currency":"GBP","outstanding_amount":0,"capture_mode":"automatic","enforce_challenge":"automatic","related_order_id":"a1b2c3d4-0001-0000-0000-000000000001","merchant_order_data":{"order_id":"ORD-2025-001","description":"Customer-requested refund"}},{"id":"a1b2c3d4-0004-0000-0000-000000000004","token":"b2c3d4e5-0004-0000-0000-000000000004","type":"payment","state":"authorised","created_at":"2025-03-13T14:00:00Z","updated_at":"2025-03-13T14:00:30Z","amount":35000,"currency":"USD","outstanding_amount":35000,"capture_mode":"manual","enforce_challenge":"automatic","description":"Enterprise software licence","cancel_authorised_after":"2025-03-20T14:00:00Z","customer":{"id":"c3d4e5f6-0003-0000-0000-000000000003","email":"alex.johnson@example.com","full_name":"Alex Johnson"}},{"id":"a1b2c3d4-0005-0000-0000-000000000005","token":"b2c3d4e5-0005-0000-0000-000000000005","type":"payment","state":"completed","created_at":"2025-03-14T16:45:00Z","updated_at":"2025-03-14T16:46:00Z","amount":799,"currency":"GBP","outstanding_amount":0,"capture_mode":"automatic","enforce_challenge":"automatic","description":"Coffee and pastry","location_id":"d4e5f6a7-0001-0000-0000-000000000001"},{"id":"a1b2c3d4-0006-0000-0000-000000000006","token":"b2c3d4e5-0006-0000-0000-000000000006","type":"payment","state":"completed","created_at":"2025-03-15T09:00:00Z","updated_at":"2025-03-15T09:01:00Z","amount":1999,"currency":"GBP","outstanding_amount":0,"capture_mode":"automatic","enforce_challenge":"automatic","subscription_data":{"subscription_id":"e2862e0e-66e8-4623-bdd6-7da59b85365d","active_cycle_id":"a1b2c3d4-5678-9012-abcd-ef1234567890","billing_reason":"cycle_billing"}}]}}}}},"descriptionNode":"$Ld8f"},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"code":{"type":"string","description":"An identifier that can be used to determine what went wrong.\n\nError codes are not globally unique, but uniqueness is guaranteed within endpoints.","descriptionNode":"$Ld90"},"message":{"type":"string","description":"Some human readable text describing what went wrong.","descriptionNode":"$Ld91"},"timestamp":{"type":"integer","description":"The [UNIX timestamp](https://www.unixtimestamp.com/) of the date and time the error happened.","descriptionNode":"$Ld92"}}}}},"descriptionNode":"$Ld93"},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"code":{"type":"string","description":"An identifier that can be used to determine what went wrong.\n\nError codes are not globally unique, but uniqueness is guaranteed within endpoints.","descriptionNode":"$Ld94"},"message":{"type":"string","description":"Some human readable text describing what went wrong.","descriptionNode":"$Ld95"},"timestamp":{"type":"integer","description":"The [UNIX timestamp](https://www.unixtimestamp.com/) of the date and time the error happened.","descriptionNode":"$Ld96"}}}}},"descriptionNode":"$Ld97"}},"requestBody":"$undefined","variantLabels":[],"children":["$Ld98","$Ld99"]}]}],false]}] d98:["$","div",null,{"className":"ezz1n30","children":[["$","div",null,{"data-header":"$undefined","className":"ezz1n31","children":["$","div",null,{"className":"y9a0do1","children":[["$","h2",null,{"id":"retrieve-order-list","children":[["$Ld9a","$undefined"],["$","$L15",null,{"id":"retrieve-order-list"}]]}],["$","$L16",null,{"url":"/docs/api/merchant/2025-10-16/operations/retrieve-order-list.md"}]]}]}],"$undefined"]}] da8:T478,
curl -X GET "https://merchant.revolut.com/api/orders?limit=__RP_TOK_0__&from=__RP_TOK_1__&to=__RP_TOK_2__&customer_id=__RP_TOK_3__&merchant_order_data_reference=__RP_TOK_4__&state=__RP_TOK_5__&location_id=__RP_TOK_6__" \
  -H "Authorization: __RP_TOK_7__" \
  -H "Revolut-Api-Version: __RP_TOK_8__"
da9:Ta86,
fetch("https://merchant.revolut.com/api/orders?limit=__RP_TOK_0__&from=__RP_TOK_1__&to=__RP_TOK_2__&customer_id=__RP_TOK_3__&merchant_order_data_reference=__RP_TOK_4__&state=__RP_TOK_5__&location_id=__RP_TOK_6__", {
  method: "GET",
  headers: {
    "Authorization": "__RP_TOK_7__",
    "Revolut-Api-Version": "__RP_TOK_8__"
  }
})
  .then(response => response.json())
  .then(data => console.log(data));
daa:T1023,
package main

import (
  "fmt"
  "net/http"
)

func main() {
  url := "https://merchant.revolut.com/api/orders?limit=__RP_TOK_0__&from=__RP_TOK_1__&to=__RP_TOK_2__&customer_id=__RP_TOK_3__&merchant_order_data_reference=__RP_TOK_4__&state=__RP_TOK_5__&location_id=__RP_TOK_6__"
  req, _ := http.NewRequest("GET", url, nil)
  req.Header.Add("Authorization", "__RP_TOK_7__")
  req.Header.Add("Revolut-Api-Version", "__RP_TOK_8__")

  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  fmt.Println(res)
}
dab:T898,
import requests

url = "https://merchant.revolut.com/api/orders?limit=__RP_TOK_0__&from=__RP_TOK_1__&to=__RP_TOK_2__&customer_id=__RP_TOK_3__&merchant_order_data_reference=__RP_TOK_4__&state=__RP_TOK_5__&location_id=__RP_TOK_6__"
headers = {
  "Authorization": "__RP_TOK_7__",
  "Revolut-Api-Version": "__RP_TOK_8__"
}

response = requests.get(url, headers=headers)
print(response.json())
dac:T17c4,
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;

public class Main {
  public static void main(String[] args) {
    HttpClient client = HttpClient.newHttpClient();
    HttpRequest request = HttpRequest.newBuilder()
      .uri(URI.create("https://merchant.revolut.com/api/orders?limit=__RP_TOK_0__&from=__RP_TOK_1__&to=__RP_TOK_2__&customer_id=__RP_TOK_3__&merchant_order_data_reference=__RP_TOK_4__&state=__RP_TOK_5__&location_id=__RP_TOK_6__"))
      .header("Authorization", "__RP_TOK_7__")
      .header("Revolut-Api-Version", "__RP_TOK_8__")
      .GET(HttpRequest.BodyPublishers.noBody())
      .build();

    client.sendAsync(request, HttpResponse.BodyHandlers.ofString())
      .thenApply(HttpResponse::body)
      .thenAccept(System.out::println)
      .join();
  }
}
dad:T166e,
using System.Net.Http;
using System.Net.Http.Headers;

var client = new HttpClient();
var request = new HttpRequestMessage
{
  Method = HttpMethod.Get,
  RequestUri = new Uri("https://merchant.revolut.com/api/orders?limit=__RP_TOK_0__&from=__RP_TOK_1__&to=__RP_TOK_2__&customer_id=__RP_TOK_3__&merchant_order_data_reference=__RP_TOK_4__&state=__RP_TOK_5__&location_id=__RP_TOK_6__"),
  Headers =
  {
    { "Authorization", "__RP_TOK_7__" },
    { "Revolut-Api-Version", "__RP_TOK_8__" },
  }
};

using (var response = await client.SendAsync(request))
{
  response.EnsureSuccessStatusCode();
  var body = await response.Content.ReadAsStringAsync();
  Console.WriteLine(body);
}
dae:T480,
curl -X GET "https://sandbox-merchant.revolut.com/api/orders?limit=__RP_TOK_0__&from=__RP_TOK_1__&to=__RP_TOK_2__&customer_id=__RP_TOK_3__&merchant_order_data_reference=__RP_TOK_4__&state=__RP_TOK_5__&location_id=__RP_TOK_6__" \
  -H "Authorization: __RP_TOK_7__" \
  -H "Revolut-Api-Version: __RP_TOK_8__"
daf:Ta8e,
fetch("https://sandbox-merchant.revolut.com/api/orders?limit=__RP_TOK_0__&from=__RP_TOK_1__&to=__RP_TOK_2__&customer_id=__RP_TOK_3__&merchant_order_data_reference=__RP_TOK_4__&state=__RP_TOK_5__&location_id=__RP_TOK_6__", {
  method: "GET",
  headers: {
    "Authorization": "__RP_TOK_7__",
    "Revolut-Api-Version": "__RP_TOK_8__"
  }
})
  .then(response => response.json())
  .then(data => console.log(data));
db0:T102b,
package main

import (
  "fmt"
  "net/http"
)

func main() {
  url := "https://sandbox-merchant.revolut.com/api/orders?limit=__RP_TOK_0__&from=__RP_TOK_1__&to=__RP_TOK_2__&customer_id=__RP_TOK_3__&merchant_order_data_reference=__RP_TOK_4__&state=__RP_TOK_5__&location_id=__RP_TOK_6__"
  req, _ := http.NewRequest("GET", url, nil)
  req.Header.Add("Authorization", "__RP_TOK_7__")
  req.Header.Add("Revolut-Api-Version", "__RP_TOK_8__")

  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  fmt.Println(res)
}
db1:T8a0,
import requests

url = "https://sandbox-merchant.revolut.com/api/orders?limit=__RP_TOK_0__&from=__RP_TOK_1__&to=__RP_TOK_2__&customer_id=__RP_TOK_3__&merchant_order_data_reference=__RP_TOK_4__&state=__RP_TOK_5__&location_id=__RP_TOK_6__"
headers = {
  "Authorization": "__RP_TOK_7__",
  "Revolut-Api-Version": "__RP_TOK_8__"
}

response = requests.get(url, headers=headers)
print(response.json())
db2:T17cc,
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;

public class Main {
  public static void main(String[] args) {
    HttpClient client = HttpClient.newHttpClient();
    HttpRequest request = HttpRequest.newBuilder()
      .uri(URI.create("https://sandbox-merchant.revolut.com/api/orders?limit=__RP_TOK_0__&from=__RP_TOK_1__&to=__RP_TOK_2__&customer_id=__RP_TOK_3__&merchant_order_data_reference=__RP_TOK_4__&state=__RP_TOK_5__&location_id=__RP_TOK_6__"))
      .header("Authorization", "__RP_TOK_7__")
      .header("Revolut-Api-Version", "__RP_TOK_8__")
      .GET(HttpRequest.BodyPublishers.noBody())
      .build();

    client.sendAsync(request, HttpResponse.BodyHandlers.ofString())
      .thenApply(HttpResponse::body)
      .thenAccept(System.out::println)
      .join();
  }
}
db3:T1676,
using System.Net.Http;
using System.Net.Http.Headers;

var client = new HttpClient();
var request = new HttpRequestMessage
{
  Method = HttpMethod.Get,
  RequestUri = new Uri("https://sandbox-merchant.revolut.com/api/orders?limit=__RP_TOK_0__&from=__RP_TOK_1__&to=__RP_TOK_2__&customer_id=__RP_TOK_3__&merchant_order_data_reference=__RP_TOK_4__&state=__RP_TOK_5__&location_id=__RP_TOK_6__"),
  Headers =
  {
    { "Authorization", "__RP_TOK_7__" },
    { "Revolut-Api-Version", "__RP_TOK_8__" },
  }
};

using (var response = await client.SendAsync(request))
{
  response.EnsureSuccessStatusCode();
  var body = await response.Content.ReadAsStringAsync();
  Console.WriteLine(body);
}
d99:["$","div",null,{"className":"ezz1n30","children":[["$","div",null,{"data-header":"$undefined","className":"ezz1n31","children":["$Ld9b",["$","$L85",null,{"parameters":[{"name":"Authorization","in":"header","schema":{"type":"string","format":"Bearer ","examples":"$62:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:0:schema:examples"},"required":true,"description":"This parameter accepts the [Merchant API Secret key](https://business.revolut.com/settings/apis?tab=merchant-api) to authorise requests coming from the merchant's backend. \n\nIt ensures that ensures that each request is authenticated and authorised by verifying the secret key. The secret key should be included in all request headers as a `Bearer` token.\n\n:::info\nFor more information, see: [Authentication](https://developer.revolut.com/docs/api/merchant#authentication)\n:::","descriptionNode":"$Ld9c"},{"name":"Revolut-Api-Version","in":"header","schema":{"type":"string","format":"date","enum":"$36:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:1:schema:enum","examples":"$36:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:1:schema:examples"},"required":true,"description":"The version of the Merchant API, specified in `YYYY-MM-DD` format.\n\nIf not specified, you will receive an error.\n\n\n:::info\nFor more information about API versioning, see: [API versions](https://developer.revolut.com/docs/guides/merchant/reference/versioning/api-versions).\n:::","x-config-always-visible-in-example":true,"example":"2025-10-16","descriptionNode":"$Ld9d"},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":500,"default":100},"description":"Maximum number of records to return. Used for **pagination**.","required":false,"descriptionNode":"$Ld9e"},{"name":"from","in":"query","schema":{"type":"string","format":"date-time"},"description":"Filter records created from this date/time. Used for **filtering**.","required":false,"descriptionNode":"$Ld9f"},{"name":"to","in":"query","schema":{"type":"string","format":"date-time"},"description":"Filter records created until this date/time. Used for **filtering**.","required":false,"descriptionNode":"$Lda0"},{"name":"customer_id","in":"query","schema":{"type":"string","format":"uuid"},"description":"Filter orders by the ID of the customer.","required":false,"descriptionNode":"$Lda1"},{"name":"merchant_order_data_reference","in":"query","schema":{"type":"string","description":"Merchant order ID for external reference.\n\nUse this field to set the ID that your own system can use to easily track orders.","descriptionNode":"$Lda2"},"description":"Filter orders by your own order reference set in `merchant_order_data.reference`.","required":false,"descriptionNode":"$Lda3"},{"name":"state","in":"query","required":false,"explode":true,"description":"Filter orders by state. Repeat the parameter to filter by multiple states.","schema":{"type":"array","items":{"type":"string","description":"The state of the order in its lifecycle.\n\n| State | Description |\n|-------|-------------|\n| `pending` | Order created, awaiting payment |\n| `processing` | Payment is being processed |\n| `authorised` | Payment authorised but not yet captured (for manual capture) |\n| `completed` | Payment successfully captured and settled |\n| `cancelled` | Order was cancelled |\n| `failed` | Payment failed |\n\n:::info\nFor more information, see: [Order and payment lifecycle](https://developer.revolut.com/docs/guides/merchant/reference/order-lifecycle)\n:::","enum":"$19:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:orders:items:properties:state:enum","examples":"$19:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:orders:items:properties:state:examples","descriptionNode":"$Lda4"}},"descriptionNode":"$Lda5"},{"name":"location_id","schema":{"type":"string","format":"uuid","description":"A UUID string, typically used to identify resources.","descriptionNode":"$Lda6"},"in":"query","required":false,"description":"Filter results by location ID.","descriptionNode":"$Lda7"}],"requestBody":"$undefined","heading":"Request","requestBodySchemaTitle":"Request body","headingAs":"h3"}],["$","$L89",null,{"responses":"$19:props:children:0:props:children:props:responses","headingAs":"h3"}]]}],["$","div",null,{"className":"ezz1n32","children":[[["$","$L8a",null,{"itemsByServer":{"https://merchant.revolut.com":[{"id":"curl","label":"cURL","templateCode":"curl -X GET \"https://merchant.revolut.com/api/orders?limit=__RP_TOK_0__&from=__RP_TOK_1__&to=__RP_TOK_2__&customer_id=__RP_TOK_3__&merchant_order_data_reference=__RP_TOK_4__&state=__RP_TOK_5__&location_id=__RP_TOK_6__\" \\\n -H \"Authorization: __RP_TOK_7__\" \\\n -H \"Revolut-Api-Version: __RP_TOK_8__\"","templateHtml":"$da8","tokens":[{"marker":"__RP_TOK_0__","paramName":"limit","paramIn":"query","pipeline":["url-component","shell-double-inner"]},{"marker":"__RP_TOK_1__","paramName":"from","paramIn":"query","pipeline":["url-component","shell-double-inner"]},{"marker":"__RP_TOK_2__","paramName":"to","paramIn":"query","pipeline":["url-component","shell-double-inner"]},{"marker":"__RP_TOK_3__","paramName":"customer_id","paramIn":"query","pipeline":["url-component","shell-double-inner"]},{"marker":"__RP_TOK_4__","paramName":"merchant_order_data_reference","paramIn":"query","pipeline":["url-component","shell-double-inner"]},{"marker":"__RP_TOK_5__","paramName":"state","paramIn":"query","pipeline":["url-component","shell-double-inner"]},{"marker":"__RP_TOK_6__","paramName":"location_id","paramIn":"query","pipeline":["url-component","shell-double-inner"]},{"marker":"__RP_TOK_7__","paramName":"Authorization","paramIn":"header","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_8__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["shell-double-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","query:limit":"100","query:from":"2024-01-01T00:00:00Z","query:to":"2024-01-01T00:00:00Z","query:customer_id":"123e4567-e89b-12d3-a456-426614174000","query:merchant_order_data_reference":"string","query:state":"[]","query:location_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"javascript","label":"JavaScript","templateCode":"fetch(\"https://merchant.revolut.com/api/orders?limit=__RP_TOK_0__&from=__RP_TOK_1__&to=__RP_TOK_2__&customer_id=__RP_TOK_3__&merchant_order_data_reference=__RP_TOK_4__&state=__RP_TOK_5__&location_id=__RP_TOK_6__\", {\n method: \"GET\",\n headers: {\n \"Authorization\": \"__RP_TOK_7__\",\n \"Revolut-Api-Version\": \"__RP_TOK_8__\"\n }\n})\n .then(response => response.json())\n .then(data => console.log(data));","templateHtml":"$da9","tokens":[{"marker":"__RP_TOK_0__","paramName":"limit","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"from","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"to","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_3__","paramName":"customer_id","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_4__","paramName":"merchant_order_data_reference","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_5__","paramName":"state","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_6__","paramName":"location_id","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_7__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_8__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","query:limit":"100","query:from":"2024-01-01T00:00:00Z","query:to":"2024-01-01T00:00:00Z","query:customer_id":"123e4567-e89b-12d3-a456-426614174000","query:merchant_order_data_reference":"string","query:state":"[]","query:location_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"go","label":"Go","templateCode":"package main\n\nimport (\n \"fmt\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://merchant.revolut.com/api/orders?limit=__RP_TOK_0__&from=__RP_TOK_1__&to=__RP_TOK_2__&customer_id=__RP_TOK_3__&merchant_order_data_reference=__RP_TOK_4__&state=__RP_TOK_5__&location_id=__RP_TOK_6__\"\n req, _ := http.NewRequest(\"GET\", url, nil)\n req.Header.Add(\"Authorization\", \"__RP_TOK_7__\")\n req.Header.Add(\"Revolut-Api-Version\", \"__RP_TOK_8__\")\n\n res, _ := http.DefaultClient.Do(req)\n defer res.Body.Close()\n fmt.Println(res)\n}","templateHtml":"$daa","tokens":[{"marker":"__RP_TOK_0__","paramName":"limit","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"from","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"to","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_3__","paramName":"customer_id","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_4__","paramName":"merchant_order_data_reference","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_5__","paramName":"state","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_6__","paramName":"location_id","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_7__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_8__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","query:limit":"100","query:from":"2024-01-01T00:00:00Z","query:to":"2024-01-01T00:00:00Z","query:customer_id":"123e4567-e89b-12d3-a456-426614174000","query:merchant_order_data_reference":"string","query:state":"[]","query:location_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"python","label":"Python","templateCode":"import requests\n\nurl = \"https://merchant.revolut.com/api/orders?limit=__RP_TOK_0__&from=__RP_TOK_1__&to=__RP_TOK_2__&customer_id=__RP_TOK_3__&merchant_order_data_reference=__RP_TOK_4__&state=__RP_TOK_5__&location_id=__RP_TOK_6__\"\nheaders = {\n \"Authorization\": \"__RP_TOK_7__\",\n \"Revolut-Api-Version\": \"__RP_TOK_8__\"\n}\n\nresponse = requests.get(url, headers=headers)\nprint(response.json())","templateHtml":"$dab","tokens":[{"marker":"__RP_TOK_0__","paramName":"limit","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"from","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"to","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_3__","paramName":"customer_id","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_4__","paramName":"merchant_order_data_reference","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_5__","paramName":"state","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_6__","paramName":"location_id","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_7__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_8__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","query:limit":"100","query:from":"2024-01-01T00:00:00Z","query:to":"2024-01-01T00:00:00Z","query:customer_id":"123e4567-e89b-12d3-a456-426614174000","query:merchant_order_data_reference":"string","query:state":"[]","query:location_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"java","label":"Java","templateCode":"import java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\nimport java.net.URI;\n\npublic class Main {\n public static void main(String[] args) {\n HttpClient client = HttpClient.newHttpClient();\n HttpRequest request = HttpRequest.newBuilder()\n .uri(URI.create(\"https://merchant.revolut.com/api/orders?limit=__RP_TOK_0__&from=__RP_TOK_1__&to=__RP_TOK_2__&customer_id=__RP_TOK_3__&merchant_order_data_reference=__RP_TOK_4__&state=__RP_TOK_5__&location_id=__RP_TOK_6__\"))\n .header(\"Authorization\", \"__RP_TOK_7__\")\n .header(\"Revolut-Api-Version\", \"__RP_TOK_8__\")\n .GET(HttpRequest.BodyPublishers.noBody())\n .build();\n\n client.sendAsync(request, HttpResponse.BodyHandlers.ofString())\n .thenApply(HttpResponse::body)\n .thenAccept(System.out::println)\n .join();\n }\n}","templateHtml":"$dac","tokens":[{"marker":"__RP_TOK_0__","paramName":"limit","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"from","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"to","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_3__","paramName":"customer_id","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_4__","paramName":"merchant_order_data_reference","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_5__","paramName":"state","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_6__","paramName":"location_id","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_7__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_8__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","query:limit":"100","query:from":"2024-01-01T00:00:00Z","query:to":"2024-01-01T00:00:00Z","query:customer_id":"123e4567-e89b-12d3-a456-426614174000","query:merchant_order_data_reference":"string","query:state":"[]","query:location_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"csharp","label":"C#","templateCode":"using System.Net.Http;\nusing System.Net.Http.Headers;\n\nvar client = new HttpClient();\nvar request = new HttpRequestMessage\n{\n Method = HttpMethod.Get,\n RequestUri = new Uri(\"https://merchant.revolut.com/api/orders?limit=__RP_TOK_0__&from=__RP_TOK_1__&to=__RP_TOK_2__&customer_id=__RP_TOK_3__&merchant_order_data_reference=__RP_TOK_4__&state=__RP_TOK_5__&location_id=__RP_TOK_6__\"),\n Headers =\n {\n { \"Authorization\", \"__RP_TOK_7__\" },\n { \"Revolut-Api-Version\", \"__RP_TOK_8__\" },\n }\n};\n\nusing (var response = await client.SendAsync(request))\n{\n response.EnsureSuccessStatusCode();\n var body = await response.Content.ReadAsStringAsync();\n Console.WriteLine(body);\n}","templateHtml":"$dad","tokens":[{"marker":"__RP_TOK_0__","paramName":"limit","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"from","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"to","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_3__","paramName":"customer_id","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_4__","paramName":"merchant_order_data_reference","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_5__","paramName":"state","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_6__","paramName":"location_id","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_7__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_8__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","query:limit":"100","query:from":"2024-01-01T00:00:00Z","query:to":"2024-01-01T00:00:00Z","query:customer_id":"123e4567-e89b-12d3-a456-426614174000","query:merchant_order_data_reference":"string","query:state":"[]","query:location_id":"123e4567-e89b-12d3-a456-426614174000"}}],"https://sandbox-merchant.revolut.com":[{"id":"curl","label":"cURL","templateCode":"curl -X GET \"https://sandbox-merchant.revolut.com/api/orders?limit=__RP_TOK_0__&from=__RP_TOK_1__&to=__RP_TOK_2__&customer_id=__RP_TOK_3__&merchant_order_data_reference=__RP_TOK_4__&state=__RP_TOK_5__&location_id=__RP_TOK_6__\" \\\n -H \"Authorization: __RP_TOK_7__\" \\\n -H \"Revolut-Api-Version: __RP_TOK_8__\"","templateHtml":"$dae","tokens":[{"marker":"__RP_TOK_0__","paramName":"limit","paramIn":"query","pipeline":["url-component","shell-double-inner"]},{"marker":"__RP_TOK_1__","paramName":"from","paramIn":"query","pipeline":["url-component","shell-double-inner"]},{"marker":"__RP_TOK_2__","paramName":"to","paramIn":"query","pipeline":["url-component","shell-double-inner"]},{"marker":"__RP_TOK_3__","paramName":"customer_id","paramIn":"query","pipeline":["url-component","shell-double-inner"]},{"marker":"__RP_TOK_4__","paramName":"merchant_order_data_reference","paramIn":"query","pipeline":["url-component","shell-double-inner"]},{"marker":"__RP_TOK_5__","paramName":"state","paramIn":"query","pipeline":["url-component","shell-double-inner"]},{"marker":"__RP_TOK_6__","paramName":"location_id","paramIn":"query","pipeline":["url-component","shell-double-inner"]},{"marker":"__RP_TOK_7__","paramName":"Authorization","paramIn":"header","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_8__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["shell-double-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","query:limit":"100","query:from":"2024-01-01T00:00:00Z","query:to":"2024-01-01T00:00:00Z","query:customer_id":"123e4567-e89b-12d3-a456-426614174000","query:merchant_order_data_reference":"string","query:state":"[]","query:location_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"javascript","label":"JavaScript","templateCode":"fetch(\"https://sandbox-merchant.revolut.com/api/orders?limit=__RP_TOK_0__&from=__RP_TOK_1__&to=__RP_TOK_2__&customer_id=__RP_TOK_3__&merchant_order_data_reference=__RP_TOK_4__&state=__RP_TOK_5__&location_id=__RP_TOK_6__\", {\n method: \"GET\",\n headers: {\n \"Authorization\": \"__RP_TOK_7__\",\n \"Revolut-Api-Version\": \"__RP_TOK_8__\"\n }\n})\n .then(response => response.json())\n .then(data => console.log(data));","templateHtml":"$daf","tokens":[{"marker":"__RP_TOK_0__","paramName":"limit","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"from","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"to","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_3__","paramName":"customer_id","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_4__","paramName":"merchant_order_data_reference","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_5__","paramName":"state","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_6__","paramName":"location_id","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_7__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_8__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","query:limit":"100","query:from":"2024-01-01T00:00:00Z","query:to":"2024-01-01T00:00:00Z","query:customer_id":"123e4567-e89b-12d3-a456-426614174000","query:merchant_order_data_reference":"string","query:state":"[]","query:location_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"go","label":"Go","templateCode":"package main\n\nimport (\n \"fmt\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://sandbox-merchant.revolut.com/api/orders?limit=__RP_TOK_0__&from=__RP_TOK_1__&to=__RP_TOK_2__&customer_id=__RP_TOK_3__&merchant_order_data_reference=__RP_TOK_4__&state=__RP_TOK_5__&location_id=__RP_TOK_6__\"\n req, _ := http.NewRequest(\"GET\", url, nil)\n req.Header.Add(\"Authorization\", \"__RP_TOK_7__\")\n req.Header.Add(\"Revolut-Api-Version\", \"__RP_TOK_8__\")\n\n res, _ := http.DefaultClient.Do(req)\n defer res.Body.Close()\n fmt.Println(res)\n}","templateHtml":"$db0","tokens":[{"marker":"__RP_TOK_0__","paramName":"limit","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"from","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"to","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_3__","paramName":"customer_id","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_4__","paramName":"merchant_order_data_reference","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_5__","paramName":"state","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_6__","paramName":"location_id","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_7__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_8__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","query:limit":"100","query:from":"2024-01-01T00:00:00Z","query:to":"2024-01-01T00:00:00Z","query:customer_id":"123e4567-e89b-12d3-a456-426614174000","query:merchant_order_data_reference":"string","query:state":"[]","query:location_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"python","label":"Python","templateCode":"import requests\n\nurl = \"https://sandbox-merchant.revolut.com/api/orders?limit=__RP_TOK_0__&from=__RP_TOK_1__&to=__RP_TOK_2__&customer_id=__RP_TOK_3__&merchant_order_data_reference=__RP_TOK_4__&state=__RP_TOK_5__&location_id=__RP_TOK_6__\"\nheaders = {\n \"Authorization\": \"__RP_TOK_7__\",\n \"Revolut-Api-Version\": \"__RP_TOK_8__\"\n}\n\nresponse = requests.get(url, headers=headers)\nprint(response.json())","templateHtml":"$db1","tokens":[{"marker":"__RP_TOK_0__","paramName":"limit","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"from","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"to","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_3__","paramName":"customer_id","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_4__","paramName":"merchant_order_data_reference","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_5__","paramName":"state","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_6__","paramName":"location_id","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_7__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_8__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","query:limit":"100","query:from":"2024-01-01T00:00:00Z","query:to":"2024-01-01T00:00:00Z","query:customer_id":"123e4567-e89b-12d3-a456-426614174000","query:merchant_order_data_reference":"string","query:state":"[]","query:location_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"java","label":"Java","templateCode":"import java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\nimport java.net.URI;\n\npublic class Main {\n public static void main(String[] args) {\n HttpClient client = HttpClient.newHttpClient();\n HttpRequest request = HttpRequest.newBuilder()\n .uri(URI.create(\"https://sandbox-merchant.revolut.com/api/orders?limit=__RP_TOK_0__&from=__RP_TOK_1__&to=__RP_TOK_2__&customer_id=__RP_TOK_3__&merchant_order_data_reference=__RP_TOK_4__&state=__RP_TOK_5__&location_id=__RP_TOK_6__\"))\n .header(\"Authorization\", \"__RP_TOK_7__\")\n .header(\"Revolut-Api-Version\", \"__RP_TOK_8__\")\n .GET(HttpRequest.BodyPublishers.noBody())\n .build();\n\n client.sendAsync(request, HttpResponse.BodyHandlers.ofString())\n .thenApply(HttpResponse::body)\n .thenAccept(System.out::println)\n .join();\n }\n}","templateHtml":"$db2","tokens":[{"marker":"__RP_TOK_0__","paramName":"limit","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"from","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"to","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_3__","paramName":"customer_id","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_4__","paramName":"merchant_order_data_reference","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_5__","paramName":"state","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_6__","paramName":"location_id","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_7__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_8__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","query:limit":"100","query:from":"2024-01-01T00:00:00Z","query:to":"2024-01-01T00:00:00Z","query:customer_id":"123e4567-e89b-12d3-a456-426614174000","query:merchant_order_data_reference":"string","query:state":"[]","query:location_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"csharp","label":"C#","templateCode":"using System.Net.Http;\nusing System.Net.Http.Headers;\n\nvar client = new HttpClient();\nvar request = new HttpRequestMessage\n{\n Method = HttpMethod.Get,\n RequestUri = new Uri(\"https://sandbox-merchant.revolut.com/api/orders?limit=__RP_TOK_0__&from=__RP_TOK_1__&to=__RP_TOK_2__&customer_id=__RP_TOK_3__&merchant_order_data_reference=__RP_TOK_4__&state=__RP_TOK_5__&location_id=__RP_TOK_6__\"),\n Headers =\n {\n { \"Authorization\", \"__RP_TOK_7__\" },\n { \"Revolut-Api-Version\", \"__RP_TOK_8__\" },\n }\n};\n\nusing (var response = await client.SendAsync(request))\n{\n response.EnsureSuccessStatusCode();\n var body = await response.Content.ReadAsStringAsync();\n Console.WriteLine(body);\n}","templateHtml":"$db3","tokens":[{"marker":"__RP_TOK_0__","paramName":"limit","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"from","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"to","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_3__","paramName":"customer_id","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_4__","paramName":"merchant_order_data_reference","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_5__","paramName":"state","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_6__","paramName":"location_id","paramIn":"query","pipeline":["url-component","json-string-inner"]},{"marker":"__RP_TOK_7__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_8__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","query:limit":"100","query:from":"2024-01-01T00:00:00Z","query:to":"2024-01-01T00:00:00Z","query:customer_id":"123e4567-e89b-12d3-a456-426614174000","query:merchant_order_data_reference":"string","query:state":"[]","query:location_id":"123e4567-e89b-12d3-a456-426614174000"}}]},"method":"get","servers":"$62:props:children:0:props:children:props:children:1:props:children:1:props:children:0:0:props:servers","path":"/api/orders","parameters":["$d99:props:children:0:props:children:1:props:parameters:0","$d99:props:children:0:props:children:1:props:parameters:1","$d99:props:children:0:props:children:1:props:parameters:2","$d99:props:children:0:props:children:1:props:parameters:3","$d99:props:children:0:props:children:1:props:parameters:4","$d99:props:children:0:props:children:1:props:parameters:5","$d99:props:children:0:props:children:1:props:parameters:6","$d99:props:children:0:props:children:1:props:parameters:7","$d99:props:children:0:props:children:1:props:parameters:8"]}],"$Ldb4"],"$Ldb5","$Ldb6"]}]]}] db4:["$","$L10d",null,{"security":[{"Api-Key":[]}],"authorization":{"Api-Key":{"type":"apiKey","in":"header","name":"Authorization","description":"Each Merchant API request must contain an authorization header in the following format:\n\n```\n'Authorization: Bearer '\n```\n\nTo use this API, you need to generate API keys from your Revolut Business account. The Secret key is used in the authorization header for all server calls, while the Public key is provided with payment methods at checkout.\n\n:::info\nFor detailed instructions on generating your API keys, see: [Generate API keys](https://developer.revolut.com/docs/guides/merchant/get-started#generate-api-keys).\n:::","descriptionNode":"$Ldb7"}}}] db5:["$","$L10f",null,{"exampleBlocks":{},"title":"Request body samples","headingAs":"h4"}] db6:["$","$L110",null,{"exampleBlocks":{"200":{"application/json":{"variants":[{"key":"list_of_orders","label":"List of orders","rawValue":"$19:props:children:0:props:children:props:responses:200:content:application/json:examples:list_of_orders:value","block":"$Ldb8"}],"syncedPropertyName":"$undefined"}},"400":{"application/json":{"variants":[{"key":"default","label":"Example","rawValue":{"code":"string","message":"string","timestamp":123},"block":"$Ldb9"}],"syncedPropertyName":"$undefined"}},"401":{"application/json":{"variants":[{"key":"default","label":"Example","rawValue":{"code":"string","message":"string","timestamp":123},"block":"$Ldba"}],"syncedPropertyName":"$undefined"}}},"headingAs":"h4"}] d9a:"Retrieve an order list" cef:["$","div","request-application/json-example_customer_update",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"
{\n  \"email\": \"updated.customer@example.com\"\n}
"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"email\": \"updated.customer@example.com\"\n}"}]}]]}] dbb:T34c8,
{
  "id": "6c7c97a8-cfc1-4cf3-8b38-26a74fdf1fae",
  "full_name": "Example Customer",
  "email": "example.customer@example.com",
  "phone": "+441234567890",
  "created_at": "2020-06-24T12:03:39.979397Z",
  "updated_at": "2020-06-25T10:03:39.134417Z",
  "payment_methods": [
    {
      "id": "648334a8-9546-a983-a81a-efc6d5bdd0be",
      "type": "revolut_pay",
      "saved_for": "merchant",
      "created_at": "2023-06-09T14:18:16.577888Z"
    },
    {
      "id": "edef3ba4-60a0-4df3-8f12-e5fc858c2420",
      "type": "card",
      "saved_for": "customer",
      "created_at": "2023-03-24T14:15:22Z",
      "bin": "459765",
      "last_four": "6578",
      "expiry_month": 2,
      "expiry_year": 2025,
      "cardholder_name": "Example Customer",
      "brand": "visa",
      "funding": "debit",
      "issuer": "EXAMPLE ISSUER",
      "issuer_country": "GB",
      "billing_address": {
        "street_line_1": "7 Westferry Circus",
        "street_line_2": "Columbus Building",
        "postcode": "E144HD",
        "city": "London",
        "region": "Greater London",
        "country_code": "GB"
      }
    },
    {
      "id": "6a0fe961-a961-a8b6-ad17-ab2779165a82",
      "type": "sepa_direct_debit",
      "saved_for": "merchant",
      "created_at": "2026-05-22T05:28:01.887482Z",
      "debtor_iban_last_four": "3273",
      "debtor_name": "John Doe",
      "mandate_reference": "69F1CB61BD99A32C8E20D7FB9E21E146",
      "billing_address": {
        "street_line_1": "Bank of England",
        "street_line_2": "Threadneedle St",
        "postcode": "EC2R 8AH",
        "city": "London",
        "region": "Greater London",
        "country_code": "GB"
      }
    }
  ]
}
cf0:["$","div","200-application/json-updated_customer",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$dbb"}}]}]],"$Ldbc"]}] dbd:T44d,
{
  "code": "string",
  "message": "string",
  "timestamp": 123
}
cf1:["$","div","400-application/json-default",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$dbd"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"code\": \"string\",\n \"message\": \"string\",\n \"timestamp\": 123\n}"}]}]]}] dbe:T44d,
{
  "code": "string",
  "message": "string",
  "timestamp": 123
}
cf2:["$","div","401-application/json-default",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$dbe"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"code\": \"string\",\n \"message\": \"string\",\n \"timestamp\": 123\n}"}]}]]}] dbf:T44d,
{
  "code": "string",
  "message": "string",
  "timestamp": 123
}
cf3:["$","div","404-application/json-default",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$dbf"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"code\": \"string\",\n \"message\": \"string\",\n \"timestamp\": 123\n}"}]}]]}] d54:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Permanent order ID used to retrieve, capture, cancel, or refund an order after authorization."}]]}] d55:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Temporary ID for the order, which expires when the payment is authorised."}],"\n",["$","p","p-1",{"children":["The order ",["$","code","code-0",{"children":"token"}]," is used for ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/sdks/merchant-web-sdk/initialisation/token-based","target":"_blank","rel":"noreferrer","children":"token-based initialisation"}],", and is returned by the ",["$","code","code-1",{"children":"createOrder"}]," callback in the following payment methods:"]}],"\n",["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["$","a","a-0",{"href":"https://developer.revolut.com/docs/sdks/merchant-web-sdk/payment-methods/embedded-checkout#embedded-checkout-options-interface","target":"_blank","rel":"noreferrer","children":"Embedded Checkout"}]}],"\n",["$","li","li-1",{"children":["$","a","a-0",{"href":"https://developer.revolut.com/docs/sdks/merchant-web-sdk/payment-methods/revolut-pay#widget-payments-revolut-pay-options","target":"_blank","rel":"noreferrer","children":"Revolut Pay"}]}],"\n",["$","li","li-2",{"children":["$","a","a-0",{"href":"https://developer.revolut.com/docs/sdks/merchant-web-sdk/payment-methods/apple-pay-google-pay#payment-request-options-interface","target":"_blank","rel":"noreferrer","children":"Apple Pay and Google Pay"}]}],"\n",["$","li","li-3",{"children":["$","a","a-0",{"href":"https://developer.revolut.com/docs/sdks/merchant-web-sdk/payment-methods/pay-by-bank#pay-by-bank-options-interface","target":"_blank","rel":"noreferrer","children":"Pay by Bank"}]}],"\n"]}]]}] d56:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of the order."}]]}] d57:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The state of the order in its lifecycle."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"State","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"pending"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Order created, awaiting payment","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"processing"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Payment is being processed","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"authorised"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Payment authorised but not yet captured (for manual capture)","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"completed"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Payment successfully captured and settled","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-4",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"cancelled"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Order was cancelled","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-5",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"failed"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Payment failed","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/reference/order-lifecycle","target":"_blank","rel":"noreferrer","children":"Order and payment lifecycle"}]]}]}]]}]]}] d58:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The date and time the order was created."}]]}] d59:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The date and time the order was last updated."}]]}] dc0:T696,{ "id": "6c7c97a8-cfc1-4cf3-8b38-26a74fdf1fae", "full_name": "Example Customer", "email": "example.customer@example.com", "phone": "+441234567890", "created_at": "2020-06-24T12:03:39.979397Z", "updated_at": "2020-06-25T10:03:39.134417Z", "payment_methods": [ { "id": "648334a8-9546-a983-a81a-efc6d5bdd0be", "type": "revolut_pay", "saved_for": "merchant", "created_at": "2023-06-09T14:18:16.577888Z" }, { "id": "edef3ba4-60a0-4df3-8f12-e5fc858c2420", "type": "card", "saved_for": "customer", "created_at": "2023-03-24T14:15:22Z", "bin": "459765", "last_four": "6578", "expiry_month": 2, "expiry_year": 2025, "cardholder_name": "Example Customer", "brand": "visa", "funding": "debit", "issuer": "EXAMPLE ISSUER", "issuer_country": "GB", "billing_address": { "street_line_1": "7 Westferry Circus", "street_line_2": "Columbus Building", "postcode": "E144HD", "city": "London", "region": "Greater London", "country_code": "GB" } }, { "id": "6a0fe961-a961-a8b6-ad17-ab2779165a82", "type": "sepa_direct_debit", "saved_for": "merchant", "created_at": "2026-05-22T05:28:01.887482Z", "debtor_iban_last_four": "3273", "debtor_name": "John Doe", "mandate_reference": "69F1CB61BD99A32C8E20D7FB9E21E146", "billing_address": { "street_line_1": "Bank of England", "street_line_2": "Threadneedle St", "postcode": "EC2R 8AH", "city": "London", "region": "Greater London", "country_code": "GB" } } ] }dbc:["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"$dc0"}]}] d5a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The order total expressed in minor currency units, according to the ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_4217","target":"_blank","rel":"noreferrer","children":"ISO 4217 standard"}],". For example, ",["$","code","code-0",{"children":"7034"}]," in ",["$","code","code-1",{"children":"EUR"}]," corresponds to €70.34."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["Conversion between major and minor units varies by currency. For instance, ",["$","code","code-0",{"children":"100"}]," minor units equal £1.00 in ",["$","code","code-1",{"children":"GBP"}],", whereas in ",["$","code","code-2",{"children":"ISK"}]," they represent 100 units. For more details, see the ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_4217","target":"_blank","rel":"noreferrer","children":"ISO 4217 standard"}],"."]}],"\n",["$","li","li-1",{"children":["If ",["$","code","code-0",{"children":"line_items"}]," are provided, the order ",["$","code","code-1",{"children":"amount"}]," must equal the sum of all line items' ",["$","code","code-2",{"children":"total_amount"}],"."]}],"\n",["$","li","li-2",{"children":["For card payments with a non-zero amount, the order ",["$","code","code-0",{"children":"amount"}]," must be at least ",["$","strong","strong-0",{"children":"$$0.005"}]," (or equivalent in different currencies, calculated using Revolut's exchange rate on the payment date). Otherwise, card payments can't be performed."]}],"\n"]}]}]]}]]}] d5b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":[["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_4217","target":"_blank","rel":"noreferrer","children":"ISO 4217"}]," currency code in upper case."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information about the supported currencies, see: ",["$","a","a-0",{"href":"https://help.revolut.com/business/help/merchant-accounts/payments/in-which-currencies-can-i-accept-payments/","target":"_blank","rel":"noreferrer","children":"Help Center"}],"."]}]}]]}]]}] d5c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The amount not yet paid for a given order (in minor currency units). For example, ",["$","code","code-0",{"children":"7034"}]," represents €70.34."]}],"\n",["$","p","p-1",{"children":["The value in this field may differ from ",["$","code","code-0",{"children":"amount"}]," if there are partial payments associated with the order."]}]]}] d5d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The capture mode of the order. ",["$","code","code-0",{"children":"automatic"}]," is used by default."]}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Parameter value","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"automatic"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The order is captured automatically after payment authorisation.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"manual"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The order is not captured automatically. You must manually capture the order later.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information, see ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#capture-order","target":"_blank","rel":"noreferrer","children":"Capture an order"}],"."]}]}]]}]]}] d5e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The enforce challenge mode. ",["$","code","code-0",{"children":"automatic"}]," is used by default."]}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Parameter value","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"automatic"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The payments created for an order will have challenge requirement calculated by our fraud mechanisms. Not all payments will trigger a 3DS challenge.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"forced"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The payments created for an order will always require a 3DS challenge. Currently only supported for card payments.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] d5f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The type of authorisation for the order. Used with manual capture mode. If omitted, ",["$","code","code-0",{"children":"final"}]," is used by default."]}],"\n",["$","h1","h1-0",{"children":"Pre-authorisation"}],"\n",["$","p","p-1",{"children":"Pre-authorisation allows you to reserve funds on a customer's card without immediately capturing them. This is useful for scenarios like:"}],"\n",["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":"Hotel bookings where the final amount may vary"}],"\n",["$","li","li-1",{"children":"Car rentals where additional charges may apply"}],"\n",["$","li","li-2",{"children":"Deposits that need to be held temporarily"}],"\n"]}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Parameter value","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"final"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Standard authorisation for immediate or near-immediate capture.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"pre_authorisation"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Reserve funds for later capture, used with manual capture mode.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["Pre-authorisation must be used with ",["$","code","code-0",{"children":"capture_mode: manual"}],". For more information, see ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#capture-order","target":"_blank","rel":"noreferrer","children":"Capture an order"}],"."]}]}]]}]]}] d60:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The description of the order."}]]}] d61:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Additional metadata value provided with the corresponding metadata key."}]]}] d62:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["Additional information to track your orders in your system, by providing custom metadata using ",["$","code","code-0",{"children":"\"\" : \"\""}]," pairs."]}],"\n",["$","div","inlinealert-0",{"data-type":"warning","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMark","color":"var(--rui-color-warning)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":["$","strong","strong-0",{"children":"Restrictions:"}]}],["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["Both keys and values must be ",["$","code","code-0",{"children":"string"}],"s"]}],"\n",["$","li","li-1",{"children":["Values cannot be ",["$","code","code-0",{"children":"null"}],"."]}],"\n",["$","li","li-2",{"children":["Max number of key-value pairs: ",["$","code","code-0",{"children":"50"}]]}],"\n",["$","li","li-3",{"children":["Max length of values: ",["$","code","code-0",{"children":"500"}]," characters"]}],"\n",["$","li","li-4",{"children":["Format of keys: Must start with a letter and contain only letters, digits, and underscores. Max 40 characters. Pattern: ",["$","code","code-0",{"children":"^[a-zA-Z][a-zA-Z\\\\d_]{0,39}$"}]]}],"\n"]}]]}]]}]]}] d63:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The unique ID of the original order that was refunded and this refund is associated with. You can use this ID to get more information about the related order using the ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#retrieve-order","target":"_blank","rel":"noreferrer","children":"Retrieve an order"}]," operation."]}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["This field is only returned for orders with ",["$","code","code-0",{"children":"type: refund"}],"."]}]}]]}]]}] d64:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unique identifier for the subscription."}]]}] d65:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The unique identifier of the active (pre-paid) subscription cycle that this order collects payment for."}],"\n",["$","p","p-1",{"children":"This is the current billing cycle whose recurring charges are being collected in advance by this order. For example, if a subscription cycle covers 1-31 July and the order is generated on 1 July, this field identifies that July cycle."}]]}] d66:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The unique identifier of the settled (post-paid) subscription cycle whose usage-based charges this order collects."}],"\n",["$","p","p-1",{"children":"This is the previous billing cycle whose usage is being settled by this order. For example, if a subscription cycle covers usage from 1-30 June and the order is generated on 10 July, this field identifies that June cycle."}]]}] d67:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The reason this subscription order was created."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Value","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"cycle_billing"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["The order was automatically generated to collect payment for an ongoing subscription cycle. ",["$","code","code-0",{"children":"active_cycle_id"}]," is present; ",["$","code","code-1",{"children":"settled_cycle_id"}]," is present if the previous cycle included usage-based products."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"final_settlement"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["The order was automatically generated after the subscription ended to collect outstanding usage-based charges. ",["$","code","code-0",{"children":"active_cycle_id"}]," is absent; ",["$","code","code-1",{"children":"settled_cycle_id"}]," is present."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"setup_intent"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["The order was manually created by the merchant or customer to update the payment method on file. ",["$","code","code-0",{"children":"active_cycle_id"}]," is absent; ",["$","code","code-1",{"children":"settled_cycle_id"}]," is absent."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] d68:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Subscription details linked to the order. Use this object to match an order with its underlying subscription and understand the billing context in which the order was created."}],"\n",["$","p","p-1",{"children":"Only present on orders created by a subscription."}]]}] d69:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unique identifier for the customer."}]]}] d6a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The email address of the customer."}]]}] d6b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The phone number of the customer in ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/E.164","target":"_blank","rel":"noreferrer","children":"E.164 format"}],"."]}]]}] d6c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The full name of the customer."}]]}] d6d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The birth date of the customer."}]]}] d6e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A lightweight customer object embedded in an order."}],"\n",["$","p","p-1",{"children":["This is a simplified representation intended for the order context. For the full customer object including all payment methods, use the ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#retrieve-customer","target":"_blank","rel":"noreferrer","children":"Retrieve a customer"}]," endpoint."]}]]}] d6f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Name of the line item."}]]}] d70:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Type of the line item."}]]}] d71:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The number of units of the line item."}]]}] d72:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The measurement unit for the quantity, such as ",["$","code","code-0",{"children":"cm"}],", or ",["$","code","code-1",{"children":"kg"}],"."]}]]}] d73:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object representing the quantity details of a line item, including the amount and its associated unit of measurement."}]]}] d74:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The unit price of the line item."}]]}] d75:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The total amount to be paid for the line item, including taxes and discounts."}]]}] d76:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unique identifier of line item in the merchant's system."}]]}] d77:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The specific name or label of the discount applied to the line item."}]]}] d78:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The monetary value of the discount."}]]}] d79:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Details of a discount applied to the line item, including its name and monetary value."}]]}] d7a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A list of discounts applied to the line item. Each discount should be subtracted from the total amount payable for the item."}]]}] d7b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The specific name or designation of the tax applied to the line item."}]]}] d7c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The monetary value of the tax in minor currency units (e.g., cents for EUR)."}]]}] d7d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Details about a tax applied to the line item, including its name and the corresponding amount."}]]}] d7e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A list of taxes applied to the line item. Each tax should be added to the total amount payable for the item."}]]}] d7f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"URL to an image associated with the line item."}],"\n",["$","div","inlinealert-0",{"data-type":"warning","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMark","color":"var(--rui-color-warning)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"Restrictions:"}],["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["Must be a valid URI as defined by ",["$","a","a-0",{"href":"https://datatracker.ietf.org/doc/html/rfc3986","target":"_blank","rel":"noreferrer","children":"RFC 3986"}]]}],"\n",["$","li","li-1",{"children":["URI scheme is required and must be either ",["$","code","code-0",{"children":"http"}]," or ",["$","code","code-1",{"children":"https"}]]}],"\n",["$","li","li-2",{"children":["URI host is required and cannot be ",["$","code","code-0",{"children":"localhost"}]," or an IP address"]}],"\n",["$","li","li-3",{"children":["Max length: ",["$","code","code-0",{"children":"2000"}]]}],"\n",["$","li","li-4",{"children":["Reserved or invalid characters must be percent-encoded (for example, use ",["$","code","code-0",{"children":"%20"}]," instead of a space)"]}],"\n"]}]]}]]}]]}] d80:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A list of URLs pointing to images related to the line item. These images can provide visual details or representations of the item."}]]}] d81:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Description of the line item."}]]}] d82:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An HTTP/HTTPS URL that links to more information about the line item, such as a product page or details."}],"\n",["$","div","inlinealert-0",{"data-type":"warning","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMark","color":"var(--rui-color-warning)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"Restrictions:"}],["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["Must be a valid URI as defined by ",["$","a","a-0",{"href":"https://datatracker.ietf.org/doc/html/rfc3986","target":"_blank","rel":"noreferrer","children":"RFC 3986"}]]}],"\n",["$","li","li-1",{"children":["URI scheme is required and must be either ",["$","code","code-0",{"children":"http"}]," or ",["$","code","code-1",{"children":"https"}]]}],"\n",["$","li","li-2",{"children":["URI host is required and cannot be ",["$","code","code-0",{"children":"localhost"}]," or an IP address"]}],"\n",["$","li","li-3",{"children":["Max length: ",["$","code","code-0",{"children":"2000"}]]}],"\n",["$","li","li-4",{"children":["Reserved or invalid characters must be percent-encoded (for example, use ",["$","code","code-0",{"children":"%20"}]," instead of a space)"]}],"\n"]}]]}]]}]]}] d83:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An array of line items included in the order. Each line item represents an individual product or service, along with its quantity, price, taxes, and discounts."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":"Required for merchants collecting payment for one or multiple products/services in one transaction. Omitting this information may trigger additional scrutiny and risk mitigation actions by Revolut."}]}]]}]]}] d84:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The URL of the order stored in the merchant's order management system."}],"\n",["$","p","p-1",{"children":["This URL will be included in the order confirmation email for payments made via Revolut Pay. If specified, this URL will override the default link to the merchant's ",["$","strong","strong-0",{"children":"Business website"}]," configured in the Revolut Business account."]}],"\n",["$","div","inlinealert-0",{"data-type":"warning","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMark","color":"var(--rui-color-warning)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"Restrictions:"}],["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["Must be a valid URI as defined by ",["$","a","a-0",{"href":"https://datatracker.ietf.org/doc/html/rfc3986","target":"_blank","rel":"noreferrer","children":"RFC 3986"}]]}],"\n",["$","li","li-1",{"children":["URI scheme is required and must be either ",["$","code","code-0",{"children":"http"}]," or ",["$","code","code-1",{"children":"https"}]]}],"\n",["$","li","li-2",{"children":["URI host is required and cannot be ",["$","code","code-0",{"children":"localhost"}]," or an IP address"]}],"\n",["$","li","li-3",{"children":["Max length: ",["$","code","code-0",{"children":"2000"}]]}],"\n",["$","li","li-4",{"children":["Reserved or invalid characters must be percent-encoded (for example, use ",["$","code","code-0",{"children":"%20"}]," instead of a space)"]}],"\n"]}]]}]]}]]}] d85:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Merchant order ID for external reference."}],"\n",["$","p","p-1",{"children":"Use this field to set the ID that your own system can use to easily track orders."}]]}] d86:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object for providing additional information stored in the merchant's order management system."}]]}] d87:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unique ID representing the location where merchants sells products."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#tag-locations","target":"_blank","rel":"noreferrer","children":"Locations"}],"."]}]}]]}]]}] d88:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The URL your customer will be redirected to after a successful payment on the hosted checkout page (",["$","code","code-0",{"children":"checkout_url"}]," parameter's value of the order)."]}],"\n",["$","div","inlinealert-0",{"data-type":"warning","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMark","color":"var(--rui-color-warning)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"Restrictions:"}],["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["Must be a valid URI as defined by ",["$","a","a-0",{"href":"https://datatracker.ietf.org/doc/html/rfc3986","target":"_blank","rel":"noreferrer","children":"RFC 3986"}]]}],"\n",["$","li","li-1",{"children":["URI scheme is required and must be either ",["$","code","code-0",{"children":"http"}]," or ",["$","code","code-1",{"children":"https"}]]}],"\n",["$","li","li-2",{"children":["URI host is required and cannot be ",["$","code","code-0",{"children":"localhost"}]," or an IP address"]}],"\n",["$","li","li-3",{"children":["Max length: ",["$","code","code-0",{"children":"2000"}]]}],"\n",["$","li","li-4",{"children":["Reserved or invalid characters must be percent-encoded (for example, use ",["$","code","code-0",{"children":"%20"}]," instead of a space)"]}],"\n"]}]]}]]}],"\n",["$","div","inlinealert-1",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information on how to use the ",["$","code","code-0",{"children":"redirect_url"}],", see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/accept-payments/online-payments/hosted-checkout-page/api#custom-post-payment-redirection-optional","target":"_blank","rel":"noreferrer","children":"Custom redirection via the API"}]]}]}]]}]]}] d8a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["Automatic cancellation period for uncaptured orders, specified in ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_8601","target":"_blank","rel":"noreferrer","children":"ISO 8601"}]," format."]}],"\n",["$","p","p-1",{"children":["After this period, the authorised payment is automatically cancelled and the order is cancelled. Maximum: 7 days = ",["$","code","code-0",{"children":"P7D"}],"."]}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"The following limitations apply:"}],["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["\n",["$","p","p-0",{"children":"Cannot be a negative value."}],"\n"]}],"\n",["$","li","li-1",{"children":["\n",["$","p","p-0",{"children":"Cannot be updated if the new value is less than or equal to the elapsed time since authorisation."}],"\n",["$","p","p-1",{"children":["$","strong","strong-0",{"children":"Failing scenario:"}]}],"\n",["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":"Original value: 7 days"}],"\n",["$","li","li-1",{"children":"Time since authorisation: 3 days"}],"\n",["$","li","li-2",{"children":"Update value: 2 days"}],"\n"]}],"\n",["$","p","p-2",{"children":"In this scenario, an error is returned."}],"\n",["$","p","p-3",{"children":["$","strong","strong-0",{"children":"Successful scenario:"}]}],"\n",["$","ul","ul-1",{"children":["\n",["$","li","li-0",{"children":"Original value: 7 days"}],"\n",["$","li","li-1",{"children":"Time since authorisation: 3 days"}],"\n",["$","li","li-2",{"children":"Update value: 4 days"}],"\n"]}],"\n",["$","p","p-4",{"children":"In this scenario, the parameter can be updated."}],"\n"]}],"\n",["$","li","li-2",{"children":["\n",["$","p","p-0",{"children":"Cannot be updated if cancellation is ≤ 30 minutes away."}],"\n",["$","p","p-1",{"children":["$","strong","strong-0",{"children":"Failing scenario:"}]}],"\n",["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":"Original value: 12 hours"}],"\n",["$","li","li-1",{"children":"Time since authorisation: 11 hours 40 minutes"}],"\n"]}],"\n",["$","p","p-2",{"children":"In this scenario, an error is returned."}],"\n",["$","p","p-3",{"children":["$","strong","strong-0",{"children":"Successful scenario:"}]}],"\n",["$","ul","ul-1",{"children":["\n",["$","li","li-0",{"children":"Original value: 12 hours"}],"\n",["$","li","li-1",{"children":"Time since authorisation: 11 hours 20 minutes"}],"\n"]}],"\n",["$","p","p-4",{"children":"In this scenario, the parameter can be updated."}],"\n"]}],"\n"]}]]}]]}]]}] d8c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"You can set a dynamic statement descriptor for your orders by providing a custom suffix."}],"\n",["$","p","p-1",{"children":"A statement descriptor is the text shown on cardholders' bank or card statements, helping them recognise a transaction or merchant. This field can be used to send extra information with the statement descriptor for card transactions."}],"\n",["$","p","p-2",{"children":["The complete descriptor is built using the following format: ",["$","code","code-0",{"children":"{base}*{suffix}"}],", where:"]}],"\n",["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":[["$","strong","strong-0",{"children":["$","code","code-0",{"children":"{base}"}]}]," is the existing descriptor configured in the Revolut Business dashboard (",["$","strong","strong-1",{"children":"Settings > Business account > Merchant profile > Statement descriptor"}],")."]}],"\n",["$","li","li-1",{"children":[["$","strong","strong-0",{"children":["$","code","code-0",{"children":"{suffix}"}]}]," is defined by the ",["$","code","code-0",{"children":"statement_descriptor_suffix"}]," field."]}],"\n"]}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["If the combined descriptor's length (base + suffix) exceeds the character limits of card scheme providers, the final value will be truncated. For example if the limit is 22 characters, the base descriptor is ",["$","code","code-0",{"children":"\"base\""}]," and the suffix is ",["$","code","code-1",{"children":"\"testdescriptorsuffix\""}],", the final descriptor becomes ",["$","code","code-2",{"children":"\"base*testdescriptorsuf\""}],"."]}],"\n",["$","li","li-1",{"children":"The final statement descriptor shown on a cardholder's statement may vary by issuing bank, as some banks apply their own custom formatting or truncation rules."}],"\n"]}]}]]}]]}] d8d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A simplified order object returned in list responses."}],"\n",["$","p","p-1",{"children":["To get the full details of an order, use the ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#retrieve-order","target":"_blank","rel":"noreferrer","children":"Retrieve an order"}]," endpoint."]}]]}] d8e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"List of orders."}]]}] d8f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"OK"}]]}] d90:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An identifier that can be used to determine what went wrong."}],"\n",["$","p","p-1",{"children":"Error codes are not globally unique, but uniqueness is guaranteed within endpoints."}]]}] d91:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Some human readable text describing what went wrong."}]]}] d92:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://www.unixtimestamp.com/","target":"_blank","rel":"noreferrer","children":"UNIX timestamp"}]," of the date and time the error happened."]}]]}] d93:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Bad Request"}]]}] d94:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An identifier that can be used to determine what went wrong."}],"\n",["$","p","p-1",{"children":"Error codes are not globally unique, but uniqueness is guaranteed within endpoints."}]]}] d95:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Some human readable text describing what went wrong."}]]}] d96:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://www.unixtimestamp.com/","target":"_blank","rel":"noreferrer","children":"UNIX timestamp"}]," of the date and time the error happened."]}]]}] d97:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unauthorized"}]]}] d9b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["Get a paginated list of your orders, returned as a wrapped ",["$","code","code-0",{"children":"orders"}]," array."]}],"\n",["$","p","p-1",{"children":["The response contains simplified ",["$","code","code-0",{"children":"Order"}]," objects. To get the full details of a specific order, use the ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant/2025-10-16#retrieve-order","target":"_blank","rel":"noreferrer","children":"Retrieve an order"}]," endpoint."]}]]}] d9c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["This parameter accepts the ",["$","a","a-0",{"href":"https://business.revolut.com/settings/apis?tab=merchant-api","target":"_blank","rel":"noreferrer","children":"Merchant API Secret key"}]," to authorise requests coming from the merchant's backend."]}],"\n",["$","p","p-1",{"children":["It ensures that ensures that each request is authenticated and authorised by verifying the secret key. The secret key should be included in all request headers as a ",["$","code","code-0",{"children":"Bearer"}]," token."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#authentication","target":"_blank","rel":"noreferrer","children":"Authentication"}]]}]}]]}]]}] d9d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The version of the Merchant API, specified in ",["$","code","code-0",{"children":"YYYY-MM-DD"}]," format."]}],"\n",["$","p","p-1",{"children":"If not specified, you will receive an error."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information about API versioning, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/reference/versioning/api-versions","target":"_blank","rel":"noreferrer","children":"API versions"}],"."]}]}]]}]]}] d9e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["Maximum number of records to return. Used for ",["$","strong","strong-0",{"children":"pagination"}],"."]}]]}] d9f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["Filter records created from this date/time. Used for ",["$","strong","strong-0",{"children":"filtering"}],"."]}]]}] da0:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["Filter records created until this date/time. Used for ",["$","strong","strong-0",{"children":"filtering"}],"."]}]]}] da1:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Filter orders by the ID of the customer."}]]}] da2:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Merchant order ID for external reference."}],"\n",["$","p","p-1",{"children":"Use this field to set the ID that your own system can use to easily track orders."}]]}] da3:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["Filter orders by your own order reference set in ",["$","code","code-0",{"children":"merchant_order_data.reference"}],"."]}]]}] da4:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The state of the order in its lifecycle."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"State","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"pending"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Order created, awaiting payment","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"processing"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Payment is being processed","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"authorised"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Payment authorised but not yet captured (for manual capture)","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"completed"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Payment successfully captured and settled","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-4",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"cancelled"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Order was cancelled","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-5",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"failed"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Payment failed","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/reference/order-lifecycle","target":"_blank","rel":"noreferrer","children":"Order and payment lifecycle"}]]}]}]]}]]}] da5:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Filter orders by state. Repeat the parameter to filter by multiple states."}]]}] da6:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A UUID string, typically used to identify resources."}]]}] da7:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Filter results by location ID."}]]}] dc1:Tf38,
{
  "saved_payment_method": {
    "type": "card",
    "id": "2b83c23a-650e-40c3-8989-00ee24478738",
    "initiator": "customer",
    "environment": {
      "type": "browser",
      "time_zone_utc_offset": 180,
      "color_depth": 48,
      "screen_width": 1920,
      "screen_height": 1080,
      "java_enabled": true,
      "challenge_window_width": 640,
      "browser_url": "https://business.revolut.com"
    }
  }
}
d48:["$","div","request-application/json-saved_card_customer",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$dc1"}}]}]],"$Ldc2"]}] dc3:T56d,
{
  "saved_payment_method": {
    "type": "card",
    "id": "2b83c23a-650e-40c3-8989-00ee24478738",
    "initiator": "merchant"
  }
}
d49:["$","div","request-application/json-saved_card_merchant",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$dc3"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"saved_payment_method\": {\n \"type\": \"card\",\n \"id\": \"2b83c23a-650e-40c3-8989-00ee24478738\",\n \"initiator\": \"merchant\"\n }\n}"}]}]]}] dc4:T574,
{
  "saved_payment_method": {
    "type": "revolut_pay",
    "id": "2b83c23a-650e-40c3-8989-00ee24478738",
    "initiator": "merchant"
  }
}
d4a:["$","div","request-application/json-revolut_pay",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$dc4"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"saved_payment_method\": {\n \"type\": \"revolut_pay\",\n \"id\": \"2b83c23a-650e-40c3-8989-00ee24478738\",\n \"initiator\": \"merchant\"\n }\n}"}]}]]}] dc5:T9be,
{
  "id": "63c55e04-4208-a43d-9c96-eaee848ffbaf",
  "order_id": "63c55df6-1461-a886-b90f-f49d3c370253",
  "payment_method": {
    "type": "card",
    "id": "2b83c23a-650e-40c3-8989-00ee24478738",
    "brand": "mastercard_credit",
    "last_four": "1234"
  },
  "state": "authorisation_passed"
}
d4b:["$","div","200-application/json-successful_payment_card",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$dc5"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"id\": \"63c55e04-4208-a43d-9c96-eaee848ffbaf\",\n \"order_id\": \"63c55df6-1461-a886-b90f-f49d3c370253\",\n \"payment_method\": {\n \"type\": \"card\",\n \"id\": \"2b83c23a-650e-40c3-8989-00ee24478738\",\n \"brand\": \"mastercard_credit\",\n \"last_four\": \"1234\"\n },\n \"state\": \"authorisation_passed\"\n}"}]}]]}] dc6:T8b2,
{
  "id": "63c55e04-4208-a43d-9c96-eaee848ffbaf",
  "order_id": "63c55df6-1461-a886-b90f-f49d3c370253",
  "payment_method": {
    "type": "revolut_pay",
    "subtype": "revolut_account",
    "id": "2b83c23a-650e-40c3-8989-00ee24478738"
  },
  "state": "authorisation_passed"
}
d4c:["$","div","200-application/json-successful_payment_revolut_pay_account",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$dc6"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"id\": \"63c55e04-4208-a43d-9c96-eaee848ffbaf\",\n \"order_id\": \"63c55df6-1461-a886-b90f-f49d3c370253\",\n \"payment_method\": {\n \"type\": \"revolut_pay\",\n \"subtype\": \"revolut_account\",\n \"id\": \"2b83c23a-650e-40c3-8989-00ee24478738\"\n },\n \"state\": \"authorisation_passed\"\n}"}]}]]}] dc7:Tac9,
{
  "id": "63c55e04-4208-a43d-9c96-eaee848ffbaf",
  "order_id": "63c55df6-1461-a886-b90f-f49d3c370253",
  "payment_method": {
    "type": "revolut_pay",
    "subtype": "card",
    "id": "2b83c23a-650e-40c3-8989-00ee24478738",
    "brand": "visa",
    "last_four": "1234"
  },
  "state": "authorisation_passed"
}
d4d:["$","div","200-application/json-successful_payment_revolut_pay_card",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$dc7"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"id\": \"63c55e04-4208-a43d-9c96-eaee848ffbaf\",\n \"order_id\": \"63c55df6-1461-a886-b90f-f49d3c370253\",\n \"payment_method\": {\n \"type\": \"revolut_pay\",\n \"subtype\": \"card\",\n \"id\": \"2b83c23a-650e-40c3-8989-00ee24478738\",\n \"brand\": \"visa\",\n \"last_four\": \"1234\"\n },\n \"state\": \"authorisation_passed\"\n}"}]}]]}] dc8:Tcf4,
{
  "id": "5e96b328-4054-41ed-b089-595ccc4d0870",
  "order_id": "a16718e0-077a-4942-89bc-23ac17a2e14c",
  "payment_method": {
    "type": "card",
    "id": "2b83c23a-650e-40c3-8989-00ee24478738",
    "brand": "mastercard_credit",
    "last_four": "1234"
  },
  "state": "authentication_challenge",
  "authentication_challenge": {
    "type": "three_ds",
    "acs_url": "https://example.com"
  }
}
d4e:["$","div","200-application/json-three_ds",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$dc8"}}]}]],"$Ldc9"]}] dca:Te24,
{
  "id": "5e96b328-4054-41ed-b089-595ccc4d0870",
  "order_id": "a16718e0-077a-4942-89bc-23ac17a2e14c",
  "payment_method": {
    "type": "card",
    "id": "2b83c23a-650e-40c3-8989-00ee24478738",
    "brand": "mastercard_credit",
    "last_four": "1234"
  },
  "state": "authentication_challenge",
  "authentication_challenge": {
    "type": "three_ds_fingerprint",
    "fingerprint_url": "https://example.com",
    "fingerprint_data": "string"
  }
}
d4f:["$","div","200-application/json-three_ds_fingerprint",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$dca"}}]}]],"$Ldcb"]}] d50:["$","div","400-application/json-example-1",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"
{\n  \"errorId\": \"94b27660-fdda-49ec-8b85-cd46a068ade0\",\n  \"timestamp\": 1601296792533\n}
"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"errorId\": \"94b27660-fdda-49ec-8b85-cd46a068ade0\",\n \"timestamp\": 1601296792533\n}"}]}]]}] dcc:T471,
{
  "errorId": "94b27660-fdda-49ec-8b85-cd46a068ade0",
  "timestamp": 1601296792533,
  "code": 1024
}
d51:["$","div","404-application/json-example-1",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$dcc"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"errorId\": \"94b27660-fdda-49ec-8b85-cd46a068ade0\",\n \"timestamp\": 1601296792533,\n \"code\": 1024\n}"}]}]]}] dc2:["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"saved_payment_method\": {\n \"type\": \"card\",\n \"id\": \"2b83c23a-650e-40c3-8989-00ee24478738\",\n \"initiator\": \"customer\",\n \"environment\": {\n \"type\": \"browser\",\n \"time_zone_utc_offset\": 180,\n \"color_depth\": 48,\n \"screen_width\": 1920,\n \"screen_height\": 1080,\n \"java_enabled\": true,\n \"challenge_window_width\": 640,\n \"browser_url\": \"https://business.revolut.com\"\n }\n }\n}"}]}] dc9:["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"id\": \"5e96b328-4054-41ed-b089-595ccc4d0870\",\n \"order_id\": \"a16718e0-077a-4942-89bc-23ac17a2e14c\",\n \"payment_method\": {\n \"type\": \"card\",\n \"id\": \"2b83c23a-650e-40c3-8989-00ee24478738\",\n \"brand\": \"mastercard_credit\",\n \"last_four\": \"1234\"\n },\n \"state\": \"authentication_challenge\",\n \"authentication_challenge\": {\n \"type\": \"three_ds\",\n \"acs_url\": \"https://example.com\"\n }\n}"}]}] dcb:["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"id\": \"5e96b328-4054-41ed-b089-595ccc4d0870\",\n \"order_id\": \"a16718e0-077a-4942-89bc-23ac17a2e14c\",\n \"payment_method\": {\n \"type\": \"card\",\n \"id\": \"2b83c23a-650e-40c3-8989-00ee24478738\",\n \"brand\": \"mastercard_credit\",\n \"last_four\": \"1234\"\n },\n \"state\": \"authentication_challenge\",\n \"authentication_challenge\": {\n \"type\": \"three_ds_fingerprint\",\n \"fingerprint_url\": \"https://example.com\",\n \"fingerprint_data\": \"string\"\n }\n}"}]}] db7:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Each Merchant API request must contain an authorization header in the following format:"}],"\n","$Ldcd","\n",["$","p","p-1",{"children":"To use this API, you need to generate API keys from your Revolut Business account. The Secret key is used in the authorization header for all server calls, while the Public key is provided with payment methods at checkout."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For detailed instructions on generating your API keys, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/get-started#generate-api-keys","target":"_blank","rel":"noreferrer","children":"Generate API keys"}],"."]}]}]]}]]}] d52:["$","div","CodeBlock-0",{"className":"wzy01m0 _18b50nc0","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"
'Authorization: Bearer <yourSecretApiKey>'
"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"'Authorization: Bearer '\n"}]}]]}] de7:T593,Type of the report. | Report type | Description | | -------------- | ----------- | | `settlement_report` | All settled transactions associated with a Merchant account, with a configurable set of columns. | | `custom_report` | Settled and processing transactions associated with a Merchant account, with a configurable set of columns. | | `payments_report` | Payments report provides details of all payments associated with a Merchant account, including failed and declined payments. Supports filtering by `from` and `to` creation timestamps, and optionally by `entity_states`. | | `payout_statement_report` | Payout statement Reports provide a detailed breakdown of all transactions contributing to a specific payout amount. It requires the additional parameter `filter.payout_id`, which should be obtained from the payout ID retrieved via the [payout list endpoint](https://developer.revolut.com/docs/api/merchant#retrieve-payout-list) or from [webhook events](https://developer.revolut.com/docs/api/merchant#create-webhook#callbacks). | | `icpp_fee_breakdown_report` | IC++ fee breakdown reports provide a detailed breakdown of fees for each IC++ transaction related to a payout. It requires the additional parameter `filter.icpp_charge_id`, which should be obtained from the `related_icpp_charge_id` column in the Payout statement report. A separate report should be generated for each IC++ transaction. |dea:Td2c,Names of the columns to be included in the report. If the `columns` parameter is not defined in the request, all available columns will be included in the report. An empty array will return an error. Available columns: | Column name | Description | | ----------- | ----------- | | `transaction_id` | Unique identifier of the ledger transaction related to an order. | | `order_id` | Unique identifier of the order. | | `original_order_id` | Unique identifier of the original order. For refunds and chargebacks, references the order being reversed. | | `started_date` | Start timestamp shown on the row. For payment rows, this is the payment start timestamp. For non-payment rows such as refunds and chargebacks, this is the transaction start timestamp. Separate from the report filter timeframe. | | `updated_date` | Last update timestamp shown on the row. For payment rows, this is the payment update timestamp. For non-payment rows such as refunds and chargebacks, this is the transaction update timestamp. Separate from the report filter timeframe. | | `completed_date` | Completion timestamp shown on the row. For payment rows, this is the payment completion timestamp. For non-payment rows such as refunds and chargebacks, this is the transaction completion timestamp. Separate from the report filter timeframe. | | `payment_created_date` | Payment authorisation or creation timestamp for rows linked to a payment. Empty for refunds and non-payment-related rows where no payment timestamp applies. This is returned data, not the report filter key. | | `payment_captured_date` | Payment capture timestamp for rows linked to a captured payment. Empty for refunds, non-payment-related rows, or payments not captured. This is returned data, not the report filter key. | | `type` | Settlement report row type. A partial-settlement is represented by separate `SETTLEMENT` and `REFUND` rows, not a dedicated type. | | `state` | State of the transaction. | | `description` | Description of the order. | | `merchant_order_ext_ref` | Merchant's order reference. The value of the `merchant_order_data.reference` field set when the order was created. | | `customer_id` | Unique identifier of the customer. | | `amount` | Total amount of the order. | | `currency` | The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) currency code of the order. | | `settlement_amount` | Total amount settled on the merchant's account. | | `settlement_currency` | The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) currency code of the settled amount. | | `payment_method` | Type of the payment method the customer used to pay for the order. | | `fee_amount` | Total fee amount applied to the order, aggregated across all fee components (acquiring markup + interchange + scheme fees). | | `fee_currency` | The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) currency code of the total fee. | | `processing_fee_amount` | Acquiring markup fee only — a subset of `fee_amount`. Represents Revolut's service fee, excluding interchange and scheme fees. | | `processing_fee_currency` | The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) currency code of the acquiring markup fee. | | `browser_url` | The URL where the customer initiated the payment. | | `location_id` | Unique identifier of the location related to the transaction. |df0:T593,Type of the report. | Report type | Description | | -------------- | ----------- | | `settlement_report` | All settled transactions associated with a Merchant account, with a configurable set of columns. | | `custom_report` | Settled and processing transactions associated with a Merchant account, with a configurable set of columns. | | `payments_report` | Payments report provides details of all payments associated with a Merchant account, including failed and declined payments. Supports filtering by `from` and `to` creation timestamps, and optionally by `entity_states`. | | `payout_statement_report` | Payout statement Reports provide a detailed breakdown of all transactions contributing to a specific payout amount. It requires the additional parameter `filter.payout_id`, which should be obtained from the payout ID retrieved via the [payout list endpoint](https://developer.revolut.com/docs/api/merchant#retrieve-payout-list) or from [webhook events](https://developer.revolut.com/docs/api/merchant#create-webhook#callbacks). | | `icpp_fee_breakdown_report` | IC++ fee breakdown reports provide a detailed breakdown of fees for each IC++ transaction related to a payout. It requires the additional parameter `filter.icpp_charge_id`, which should be obtained from the `related_icpp_charge_id` column in the Payout statement report. A separate report should be generated for each IC++ transaction. |df3:T1cf6,Names of the columns to include in the report. If not specified, all available columns are included. An empty array returns an error. To include custom order metadata, use `metadata.*` with the attribute name, for example `metadata.my_attribute`. Available columns: | Column name | Description | | ----------- | ----------- | | `transaction_id` | Unique identifier of the ledger transaction. Matches `transaction_id` in the settlement and payout reports. Use `order_id` to cross-reference with the payments report. | | `related_transaction_id` | For refund and chargeback transactions, the ledger transaction ID of the original payment. Corresponds to `original_transaction_id` in the payout report. | | `transaction_description` | Description of the transaction. | | `payout_id` | Unique identifier of the payout that this transaction contributed to. | | `dispute_id` | Unique identifier of the dispute associated with this transaction, if applicable. | | `account_id` | Unique identifier of the merchant account. | | `account_balance` | Account balance at the time of the transaction. | | `order_id` | Unique identifier of the order. Use to cross-reference with the payments or payout reports. | | `original_order_id` | For refunds and chargebacks, the order ID of the original payment. For settlement transactions, matches `order_id`. | | `original_order_ext_ref` | Merchant's order identifier of the original order for external reference. | | `order_description` | Description of the order. | | `order_channel` | Channel through which the order was created. | | `order_customer_note` | Note added by the customer at the time of the order. | | `order_tip_amount` | Tip amount set at the order level. | | `order_created_by` | Identifier of the user who created the order. | | `payment_initiated_by` | Identifier of who initiated the payment. | | `order_line_items` | Line items included in the order, if any. | | `payout_reference` | Reference of the payout transfer associated with the transaction. | | `invoice_reference` | Invoice reference associated with the order, if any. | | `started_date` | Start timestamp shown on the row. For payment rows, this is the payment start timestamp. For non-payment rows such as refunds and chargebacks, this is the transaction start timestamp. Separate from the report filter timeframe. | | `created_date` | Date and time the order was created. | | `updated_date` | Last update timestamp shown on the row. For payment rows, this is the payment update timestamp. For non-payment rows such as refunds and chargebacks, this is the transaction update timestamp. Separate from the report filter timeframe. | | `completed_date` | Completion timestamp shown on the row. For payment rows, this is the payment completion timestamp. For non-payment rows such as refunds and chargebacks, this is the transaction completion timestamp. Separate from the report filter timeframe. | | `payment_created_date` | Payment authorisation or creation timestamp for rows linked to a payment. Empty for refunds and non-payment-related rows where no payment timestamp applies. This is returned data, not the report filter key. | | `payment_captured_date` | Payment capture timestamp for rows linked to a captured payment. Empty for refunds, non-payment-related rows, or payments not captured. This is returned data, not the report filter key. | | `type` | Category of the reported transaction row, indicating what kind of balance-affecting event the row represents. For the full list of returned values, see [Download report file](https://developer.revolut.com/docs/api/merchant#download-report-file). | | `legacy_type` | Legacy type value for backwards compatibility. | | `state` | State of the transaction. | | `description` | Description of the transaction. | | `merchant_order_ext_ref` | Merchant's order reference. The value of the `merchant_order_data.reference` field set when the order was created. | | `customer_id` | Unique identifier of the customer. | | `amount` | Total amount of the order. | | `currency` | The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) currency code of the order. | | `settlement_amount` | Total amount settled on the merchant's account. | | `settlement_currency` | The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) currency code of the settled amount. | | `exchange_rate` | Exchange rate applied if currency conversion occurred. | | `refunded_amount` | Amount refunded for the order. | | `statement_descriptor` | Statement descriptor shown on the customer's bank statement. | | `tip_amount` | Tip amount included in the transaction. | | `terminal_hardware_id` | Identifier of the card reader hardware used, for in-person payments. | | `customer_name` | Name of the customer. | | `customer_email` | Email address of the customer. | | `customer_card_number` | Masked card number used for the payment. | | `customer_card_brand` | Card brand used for the payment. Derived from BIN data. Example values: `VISA`, `MASTERCARD`, `MASTERCARD_DEBIT`, `MAESTRO`, `AMEX`, `DINERS`, `DISCOVER`, `JCB`. | | `customer_card_type` | Card funding type of the card used for the payment, for example debit, credit, prepaid, deferred debit, or charge. For the full list of returned values, see [Download report file](https://developer.revolut.com/docs/api/merchant#download-report-file). | | `customer_card_category` | Card commercial category. Values: `consumer` (personal card) and `commercial` (business or corporate card). | | `payment_method` | Payment method the customer used to pay for the order. | | `fee_amount` | Total fee amount applied to the order, aggregated across all fee components (acquiring markup + interchange + scheme fees). | | `fee_currency` | The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) currency code of the total fee. | | `processing_fee_amount` | Acquiring markup fee only — a subset of `fee_amount`. Represents Revolut's service fee, excluding interchange and scheme fees. | | `processing_fee_currency` | The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) currency code of the acquiring markup fee. | | `fx_fee_amount` | Foreign exchange fee amount, if applicable. | | `fx_fee_currency` | The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) currency code of the FX fee. | | `browser_url` | The URL where the customer initiated the payment. | | `beneficiary_name` | Name of the beneficiary, for bank transfer payments. | | `beneficiary_account_number` | Account number of the beneficiary, for bank transfer payments. | | `location_id` | Unique identifier of the location related to the transaction. | | `location_name` | Name of the location related to the transaction. | | `surcharge_amount` | Surcharge amount applied to the transaction. Omitted when no surcharge applies. | | `order_surcharge_amount` | Surcharge amount set at the order level. | | `order_custom_field_name` | Name of a custom field set on the order. | | `order_custom_field_value` | Value of a custom field set on the order. | | `offline_payment_state` | State of an offline payment, if applicable. | | `order_authorisation_type` | Authorisation type of the order, for example `FULL` or `PRE_AUTH`. | | `metadata.*` | Custom order metadata. Replace `*` with the attribute name, for example `metadata.my_attribute`. |dfc:T593,Type of the report. | Report type | Description | | -------------- | ----------- | | `settlement_report` | All settled transactions associated with a Merchant account, with a configurable set of columns. | | `custom_report` | Settled and processing transactions associated with a Merchant account, with a configurable set of columns. | | `payments_report` | Payments report provides details of all payments associated with a Merchant account, including failed and declined payments. Supports filtering by `from` and `to` creation timestamps, and optionally by `entity_states`. | | `payout_statement_report` | Payout statement Reports provide a detailed breakdown of all transactions contributing to a specific payout amount. It requires the additional parameter `filter.payout_id`, which should be obtained from the payout ID retrieved via the [payout list endpoint](https://developer.revolut.com/docs/api/merchant#retrieve-payout-list) or from [webhook events](https://developer.revolut.com/docs/api/merchant#create-webhook#callbacks). | | `icpp_fee_breakdown_report` | IC++ fee breakdown reports provide a detailed breakdown of fees for each IC++ transaction related to a payout. It requires the additional parameter `filter.icpp_charge_id`, which should be obtained from the `related_icpp_charge_id` column in the Payout statement report. A separate report should be generated for each IC++ transaction. |dff:Tb55,Names of the columns to be included in the report. If the `columns` parameter is not defined in the request, all available columns will be included in the report. An empty array will return an error. Available columns: | Column name | Description | | ----------- | ----------- | | `payment_id` | Unique identifier of the payment. | | `type` | Category of the payment row, indicating whether the row represents a payment attempt or a refund. For the full list of returned values, see [Download report file](https://developer.revolut.com/docs/api/merchant#download-report-file). | | `description` | Description of the payment. | | `original_payment_id` | For refunds, the unique identifier of the original payment. | | `order_id` | Unique identifier of the order associated with the payment. | | `state` | Lifecycle state of the payment. For the full list of returned values, see [Download report file](https://developer.revolut.com/docs/api/merchant#download-report-file). | | `reason` | Reason for a failed or declined payment, for example: `Insufficient Funds`. | | `amount` | Total amount of the payment. | | `currency` | The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) currency code of the payment. | | `surcharge_amount` | Surcharge amount applied to the payment, if any. | | `tip_amount` | Tip amount included in the payment, if any. | | `refunded_amount` | Amount refunded for the payment. | | `created_date` | Date and time the payment was created. | | `captured_date` | Date and time the payment was captured. Empty when the payment has not been captured. | | `merchant_order_ext_ref` | Merchant's order reference. The value of the `merchant_order_data.reference` field set when the order was created. | | `payment_method` | Payment method used, for example: `CARD` or `PAY_WITH_REVOLUT`. | | `location_id` | Unique identifier of the location where the payment was made. | | `customer_id` | Unique identifier of the customer. | | `customer_card_number` | Masked card number used for the payment. | | `customer_card_country` | Country of the card used for the payment, as an [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) code. | | `customer_card_brand` | Card brand used for the payment, for example: `VISA` or `MASTERCARD_DEBIT`. | | `customer_card_type` | Card funding type of the card used for the payment. For the full list of returned values, see [Download report file](https://developer.revolut.com/docs/api/merchant#download-report-file). | | `customer_card_category` | Card commercial category. Values: `consumer` (personal card) and `commercial` (business or corporate card). | | `customer_email` | Email address of the customer. | | `fee_amount` | Total fee amount charged for the payment. | | `fee_currency` | The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) currency code of the fee. |e06:T593,Type of the report. | Report type | Description | | -------------- | ----------- | | `settlement_report` | All settled transactions associated with a Merchant account, with a configurable set of columns. | | `custom_report` | Settled and processing transactions associated with a Merchant account, with a configurable set of columns. | | `payments_report` | Payments report provides details of all payments associated with a Merchant account, including failed and declined payments. Supports filtering by `from` and `to` creation timestamps, and optionally by `entity_states`. | | `payout_statement_report` | Payout statement Reports provide a detailed breakdown of all transactions contributing to a specific payout amount. It requires the additional parameter `filter.payout_id`, which should be obtained from the payout ID retrieved via the [payout list endpoint](https://developer.revolut.com/docs/api/merchant#retrieve-payout-list) or from [webhook events](https://developer.revolut.com/docs/api/merchant#create-webhook#callbacks). | | `icpp_fee_breakdown_report` | IC++ fee breakdown reports provide a detailed breakdown of fees for each IC++ transaction related to a payout. It requires the additional parameter `filter.icpp_charge_id`, which should be obtained from the `related_icpp_charge_id` column in the Payout statement report. A separate report should be generated for each IC++ transaction. |e09:Tef6,Names of the columns to be included in the report. If the `columns` parameter is not defined in the request, all available columns will be included in the report. An empty array will return an error. Available columns: | Column name | Description | | ----------- | ----------- | | `created_date` | Date and time the transaction was created. | | `completed_date` | Date and time the transaction was completed. | | `payout_affected_date` | Date and time the payout was affected by this transaction. | | `affected_payout_amount` | Boolean flag indicating whether this transaction contributed to the payout amount (`true`) or not (`false`). Despite the name, this is not a monetary value. | | `transaction_id` | Unique identifier of the transaction. | | `order_id` | Unique identifier of the order associated with the transaction. | | `dispute_id` | Unique identifier of the dispute associated with a chargeback or chargeback reversal transaction. Empty for rows not related to a dispute. | | `merchant_order_reference` | Merchant's order reference. The value of the `merchant_order_data.reference` field set when the order was created. | | `type` | Type of the payout-related ledger event the row represents. For the full list of returned values, see [Download report file](https://developer.revolut.com/docs/api/merchant#download-report-file). | | `related_icpp_charge_id` | Unique identifier of the IC++ charge related to the transaction, if applicable. | | `transaction_amount` | Amount of the transaction in the transaction currency. | | `transaction_currency` | The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) currency code of the transaction. | | `billing_amount` | Amount of the transaction in the billing currency. | | `billing_currency` | The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) currency code of the billing amount. | | `state` | State of the transaction, for example: `COMPLETED`. | | `original_transaction_id` | Unique identifier of the original transaction. For refunds, references the transaction being refunded. | | `original_transaction_amount` | Amount of the original transaction. | | `original_transaction_currency` | The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) currency code of the original transaction. | | `original_order_id` | Unique identifier of the original order. For refunds, references the order being refunded. | | `original_order_channel` | Channel through which the original order was created. | | `original_merchant_order_reference` | Merchant's order reference for the original order. The value of the `merchant_order_data.reference` field set when the original order was created. | | `fee_amount` | Total fee amount charged for the transaction. | | `fee_currency` | The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) currency code of the fee. | | `settlement_amount` | Total amount settled on the merchant's account. | | `settlement_currency` | The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) currency code of the settled amount. | | `location_id` | Unique identifier of the location associated with the transaction. | | `location_name` | Name of the location associated with the transaction. | | `submerchant_id` | Unique identifier of the submerchant associated with the transaction. | | `payout_transfer_reference` | Reference of the bank transfer for this payout. This value is the same across all rows in the report, as each report covers a single payout. | | `payout_total_amount` | Total amount of this payout. This value is the same across all rows in the report, as each report covers a single payout. | | `payout_date` | Date and time the payout covered by this report was created. This value is the same across all rows in the report, as each report covers a single payout. |e10:T593,Type of the report. | Report type | Description | | -------------- | ----------- | | `settlement_report` | All settled transactions associated with a Merchant account, with a configurable set of columns. | | `custom_report` | Settled and processing transactions associated with a Merchant account, with a configurable set of columns. | | `payments_report` | Payments report provides details of all payments associated with a Merchant account, including failed and declined payments. Supports filtering by `from` and `to` creation timestamps, and optionally by `entity_states`. | | `payout_statement_report` | Payout statement Reports provide a detailed breakdown of all transactions contributing to a specific payout amount. It requires the additional parameter `filter.payout_id`, which should be obtained from the payout ID retrieved via the [payout list endpoint](https://developer.revolut.com/docs/api/merchant#retrieve-payout-list) or from [webhook events](https://developer.revolut.com/docs/api/merchant#create-webhook#callbacks). | | `icpp_fee_breakdown_report` | IC++ fee breakdown reports provide a detailed breakdown of fees for each IC++ transaction related to a payout. It requires the additional parameter `filter.icpp_charge_id`, which should be obtained from the `related_icpp_charge_id` column in the Payout statement report. A separate report should be generated for each IC++ transaction. |e13:T7eb,Names of the columns to be included in the report. If the `columns` parameter is not defined in the request, all available columns will be included in the report. An empty array will return an error. Available columns: | Column name | Description | | ----------- | ----------- | | `id` | Unique identifier of the payment. | | `created_at` | Date and time the payment was created. | | `operation` | IC++ transaction type. Values: `SALE` (payment sale), `REFUND` (refund), and `DISPUTE` (dispute-related transaction). | | `amount` | Transaction amount. | | `currency` | The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) currency code of the transaction. | | `settlement_amount` | Amount settled on the merchant's account. | | `settlement_currency` | The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) currency code of the settled amount. | | `payment_method` | Payment method used for the transaction. Returns `REVOLUT_PAY` for Revolut Pay payments, or the card scheme name for card payments. | | `card_scheme` | Card BIN scheme. | | `card_funding` | Card funding type, for example: `DEBIT` or `PREPAID`. | | `order_description` | Description of the order. | | `order_merchant_external_ref` | Merchant's order reference. The value of the `merchant_order_data.reference` field set when the order was created. | | `original_operation_id` | Unique identifier of the related original transaction. | | `acquiring_fee_amount` | IC++ acquiring markup fee component. | | `card_interchange_fee_amount` | Interchange fee component. Omitted for Revolut Pay transactions. | | `card_scheme_fee_amount` | Card scheme fee component. Omitted for Revolut Pay transactions. | | `card_type` | Card commercial category. Values: `COMMERCIAL` (business or corporate card) and `CONSUMER` (personal card). | | `order_channel` | Channel through which the order was created. | | `card_country` | Country of the card, as an [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) code. |53:["$","$7a","create-report-run",{"children":[["$","section",null,{"className":"y9a0do0","data-variant":"endpoint","children":["$","$L7b",null,{"responses":{"201":{"description":"Report run created, report started generating","content":{"application/json":{"schema":{"title":"ReportRunDetails","type":"object","description":"The `ReportRunDetails` object contains all information associated with a specific report run, identified by the `report_run_id`.","properties":{"report_run_id":{"type":"string","format":"uuid","description":"Unique ID used for accessing report details. Use this to check report generation status.","descriptionNode":"$Ldce"},"status":{"type":"string","description":"Current status of the report run.\n\n| Value | Description |\n| ----- | ----------- |\n| `processing` | Report generation is still in progress. |\n| `completed` | Report generation finished successfully and the file is available to download for 24 hours via `file_url`. |\n| `failed` | Report generation failed and no report file is available. |\n| `expired` | Report generation previously completed, but the 24-hour file availability window has elapsed and the file can no longer be downloaded. |","enum":"$54:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:status:enum","descriptionNode":"$Ldcf"},"file_url":{"type":"string","description":"Use this link to download the report file. Available only when `status` is `completed`, and only for 24 hours after report generation finishes.","descriptionNode":"$Ldd0"}},"required":"$54:props:children:0:props:children:props:responses:200:content:application/json:schema:required","descriptionNode":"$Ldd1"},"examples":{"report_run_processing":{"summary":"Report run processing","value":{"report_run_id":"d6f6ef64-f668-4e64-8967-1cdf8afb2561","status":"processing"}},"report_run_completed":{"summary":"Report run completed, report file ready","value":{"report_run_id":"d6f6ef64-f668-4e64-8967-1cdf8afb2561","status":"completed","file_url":"https://merchant.revolut.com/api/report-runs/d6f6ef64-f668-4e64-8967-1cdf8afb2561/file"}}}}},"descriptionNode":"$Ldd2"},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"code":{"type":"string","description":"An identifier that can be used to determine what went wrong.\n\nError codes are not globally unique, but uniqueness is guaranteed within endpoints.","descriptionNode":"$Ldd3"},"message":{"type":"string","description":"Some human readable text describing what went wrong.","descriptionNode":"$Ldd4"},"timestamp":{"type":"integer","description":"The [UNIX timestamp](https://www.unixtimestamp.com/) of the date and time the error happened.","descriptionNode":"$Ldd5"}}}}},"descriptionNode":"$Ldd6"},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"code":{"type":"string","description":"An identifier that can be used to determine what went wrong.\n\nError codes are not globally unique, but uniqueness is guaranteed within endpoints.","descriptionNode":"$Ldd7"},"message":{"type":"string","description":"Some human readable text describing what went wrong.","descriptionNode":"$Ldd8"},"timestamp":{"type":"integer","description":"The [UNIX timestamp](https://www.unixtimestamp.com/) of the date and time the error happened.","descriptionNode":"$Ldd9"}}}}},"descriptionNode":"$Ldda"},"404":{"description":"Not Found","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"code":{"type":"string","description":"An identifier that can be used to determine what went wrong.\n\nError codes are not globally unique, but uniqueness is guaranteed within endpoints.","descriptionNode":"$Lddb"},"message":{"type":"string","description":"Some human readable text describing what went wrong.","descriptionNode":"$Lddc"},"timestamp":{"type":"integer","description":"The [UNIX timestamp](https://www.unixtimestamp.com/) of the date and time the error happened.","descriptionNode":"$Lddd"}}}}},"descriptionNode":"$Ldde"}},"requestBody":{"content":{"application/json":{"schema":{"discriminator":{"propertyName":"type","mapping":{"settlement_report":"#/components/schemas/Report-Run-Settlement-Report","custom_report":"#/components/schemas/Report-Run-Custom-Report","payments_report":"#/components/schemas/Report-Run-Payments-Report","payout_statement_report":"#/components/schemas/Report-Run-Payout-Report","icpp_fee_breakdown_report":"#/components/schemas/Report-Run-Icpp-Report"}},"oneOf":[{"title":"Settlement report","type":"object","description":"A settlement report contains all the query information for generating reports of settled transactions associated with a Merchant account.","properties":{"filter":{"type":"object","description":"Filtering parameters to be applied to the report.\n\n:::note\nFor `settlement_report` and `custom_report`, `from` and `to` are evaluated against the transaction `created_date`, not the original payment-start timeframe or the `payment_created_date` and `payment_captured_date` columns.\n:::","properties":{"from":{"type":"string","format":"date-time","description":"This parameter specifies the start boundary for filtering report data. It accepts ETC/UTC date and time in [ISO 8601 format](https://en.wikipedia.org/wiki/ISO_8601) and includes all matching records on or after this timestamp.\n\nCombined with the `to` parameter, this determines the report's timeframe, including all matching records between the two values.\n\nFor example, by setting the `from` parameter to `2021-01-01T00:00:00Z`, the report will include matching records from the first second of January 1, 2021, UTC, and onwards.","descriptionNode":"$Lddf"},"to":{"type":"string","format":"date-time","description":"This parameter specifies the end boundary for filtering report data. It accepts ETC/UTC date and time in [ISO 8601 format](https://en.wikipedia.org/wiki/ISO_8601) and includes all matching records before this timestamp (exclusive).\n\nCombined with the `from` parameter, this determines the timeframe for the report, including all matching records between the two values.\n\nFor example, setting the `to` parameter to `2021-12-31T23:59:59Z` will include all matching records in the report up to, but not including, the last second of December 31, 2021, UTC.","descriptionNode":"$Lde0"},"entity_types":{"type":"array","items":{"type":"string","enum":["payment","refund","dispute"]},"description":"Select source entity families to be included in the report.\n\n| Value | Description |\n| ----- | ----------- |\n| `payment` | Include rows originating from payment settlement activity. |\n| `refund` | Include rows originating from refund activity. |\n| `dispute` | Include rows originating from dispute and chargeback activity. |\n\n:::note\nThese values are filter input categories. They do not map 1:1 to the CSV `type` output column. For example, a settlement report filtered with `payment`, `refund`, and `dispute` can still return CSV `type` values such as `SETTLEMENT`, `REFUND`, `CHARGEBACK`, and `CHARGEBACK_REVERSAL`.\n:::","descriptionNode":"$Lde1"},"entity_states":{"type":"array","items":{"type":"string","enum":["completed","processing","cancelled","reverted"]},"description":"Select transactions by state to be included in the report.\n\n| Value | Description |\n| ----- | ----------- |\n| `completed` | Include transactions that reached their final successful state. |\n| `processing` | Include transactions that are still being processed. |\n| `cancelled` | Include transactions that were cancelled before final completion. |\n| `reverted` | Include transactions that were reversed after initial creation. |\n\nIf not provided, only `completed` transactions will be included in the report.","descriptionNode":"$Lde2"},"currency":{"type":"string","description":"Select transactions with specific currencies to include in the report. Provide [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) currency code in upper case.\n\n:::info\nFor more information about the supported currencies, see: [Help Center](https://help.revolut.com/business/help/merchant-accounts/payments/in-which-currencies-can-i-accept-payments/).\n:::","minLength":3,"maxLength":3,"examples":["GBP"],"descriptionNode":"$Lde3"},"location_id":{"type":"string","format":"uuid","description":"Select transactions by location ID to be included in the report.\n\n:::info\nFor more information, see: [Locations](https://developer.revolut.com/docs/api/merchant#tag-locations).\n::: ","descriptionNode":"$Lde4"}},"required":["from","to"],"descriptionNode":"$Lde5"},"format":{"type":"string","enum":["csv"],"description":"Format of the generated report file.","examples":["csv"],"descriptionNode":"$Lde6"},"type":{"type":"string","description":"$de7","enum":["settlement_report","custom_report","payments_report","payout_statement_report","icpp_fee_breakdown_report"],"examples":["settlement_report"],"descriptionNode":"$Lde8"},"options":{"type":"object","description":"Further options to customise the report.","properties":{"timezone":{"type":"string","description":"Defaults to `ETC/UTC`. Defines the output timezone for all timestamps displayed in the report.\n\nHas no effect on `from` or `to` parameters.","examples":["Europe/London"],"descriptionNode":"$Lde9"},"columns":{"type":"array","items":{"type":"string","enum":["transaction_id","order_id","original_order_id","started_date","updated_date","completed_date","payment_created_date","payment_captured_date","type","state","description","merchant_order_ext_ref","customer_id","amount","currency","settlement_amount","settlement_currency","payment_method","fee_amount","fee_currency","processing_fee_amount","processing_fee_currency","browser_url","location_id"]},"description":"$dea","examples":[["transaction_id","type","amount","currency","settlement_amount","settlement_currency"]],"descriptionNode":"$Ldeb"}},"descriptionNode":"$Ldec"}},"required":["filter","format","type"],"descriptionNode":"$Lded"},{"title":"Custom report","type":"object","description":"A custom report contains all the query information for generating reports of selected transactions associated with a Merchant account.","properties":{"filter":{"type":"object","description":"Filtering parameters to be applied to the report.\n\n:::note\nFor `settlement_report` and `custom_report`, `from` and `to` are evaluated against the transaction `created_date`, not the original payment-start timeframe or the `payment_created_date` and `payment_captured_date` columns.\n:::","properties":{"from":"$53:props:children:0:props:children:props:requestBody:content:application/json:schema:oneOf:0:properties:filter:properties:from","to":"$53:props:children:0:props:children:props:requestBody:content:application/json:schema:oneOf:0:properties:filter:properties:to","entity_types":"$53:props:children:0:props:children:props:requestBody:content:application/json:schema:oneOf:0:properties:filter:properties:entity_types","entity_states":"$53:props:children:0:props:children:props:requestBody:content:application/json:schema:oneOf:0:properties:filter:properties:entity_states","currency":"$53:props:children:0:props:children:props:requestBody:content:application/json:schema:oneOf:0:properties:filter:properties:currency","location_id":"$53:props:children:0:props:children:props:requestBody:content:application/json:schema:oneOf:0:properties:filter:properties:location_id"},"required":"$53:props:children:0:props:children:props:requestBody:content:application/json:schema:oneOf:0:properties:filter:required","descriptionNode":"$Ldee"},"format":{"type":"string","enum":"$53:props:children:0:props:children:props:requestBody:content:application/json:schema:oneOf:0:properties:format:enum","description":"Format of the generated report file.","examples":"$53:props:children:0:props:children:props:requestBody:content:application/json:schema:oneOf:0:properties:format:examples","descriptionNode":"$Ldef"},"type":{"type":"string","description":"$df0","enum":"$53:props:children:0:props:children:props:requestBody:content:application/json:schema:oneOf:0:properties:type:enum","examples":"$53:props:children:0:props:children:props:requestBody:content:application/json:schema:oneOf:0:properties:type:examples","descriptionNode":"$Ldf1"},"options":{"type":"object","description":"Further options to customise the report.","properties":{"timezone":{"type":"string","description":"Defaults to `ETC/UTC`. Defines the output timezone for all timestamps displayed in the report.\n\nHas no effect on `from` or `to` parameters.","examples":"$53:props:children:0:props:children:props:requestBody:content:application/json:schema:oneOf:0:properties:options:properties:timezone:examples","descriptionNode":"$Ldf2"},"columns":{"type":"array","description":"$df3","items":{"type":"string","enum":["transaction_id","related_transaction_id","transaction_description","payout_id","dispute_id","account_id","account_balance","order_id","original_order_id","original_order_ext_ref","order_description","order_channel","order_customer_note","order_tip_amount","order_created_by","payment_initiated_by","order_line_items","payout_reference","invoice_reference","started_date","created_date","updated_date","completed_date","payment_created_date","payment_captured_date","type","legacy_type","state","description","merchant_order_ext_ref","customer_id","amount","currency","settlement_amount","settlement_currency","exchange_rate","refunded_amount","statement_descriptor","tip_amount","terminal_hardware_id","customer_name","customer_email","customer_card_number","customer_card_brand","customer_card_type","customer_card_category","payment_method","fee_amount","fee_currency","processing_fee_amount","processing_fee_currency","fx_fee_amount","fx_fee_currency","browser_url","beneficiary_name","beneficiary_account_number","location_id","location_name","surcharge_amount","order_surcharge_amount","order_custom_field_name","order_custom_field_value","offline_payment_state","order_authorisation_type","metadata.*"]},"examples":[["transaction_id","amount","currency","metadata.my_attribute"]],"descriptionNode":"$Ldf4"}},"descriptionNode":"$Ldf5"}},"required":["filter","format","type"],"descriptionNode":"$Ldf6"},{"title":"Payments report","type":"object","description":"A payments report contains all the query information for generating reports of payments associated with a Merchant account, including failed and declined payments.","properties":{"filter":{"type":"object","description":"Filtering parameters to be applied to the report.\n\n:::note\nFor `payments_report`, `from` and `to` are evaluated against the payment `created_date`. The `captured_date` column is returned data and does not change the filter key.\n:::","properties":{"from":{"type":"string","format":"date-time","description":"This parameter specifies the start boundary for filtering report data. It accepts ETC/UTC date and time in [ISO 8601 format](https://en.wikipedia.org/wiki/ISO_8601) and includes all matching records on or after this timestamp.\n\nCombined with the `to` parameter, this determines the report's timeframe, including all matching records between the two values.\n\nFor example, by setting the `from` parameter to `2021-01-01T00:00:00Z`, the report will include matching records from the first second of January 1, 2021, UTC, and onwards.","descriptionNode":"$Ldf7"},"to":{"type":"string","format":"date-time","description":"This parameter specifies the end boundary for filtering report data. It accepts ETC/UTC date and time in [ISO 8601 format](https://en.wikipedia.org/wiki/ISO_8601) and includes all matching records before this timestamp (exclusive).\n\nCombined with the `from` parameter, this determines the timeframe for the report, including all matching records between the two values.\n\nFor example, setting the `to` parameter to `2021-12-31T23:59:59Z` will include all matching records in the report up to, but not including, the last second of December 31, 2021, UTC.","descriptionNode":"$Ldf8"},"entity_states":{"type":"array","items":{"type":"string","enum":["completed","failed","declined","cancelled"]},"description":"Select payments by state to be included in the report.\n\n| Value | Description |\n| ----- | ----------- |\n| `completed` | Include payments that completed successfully. |\n| `failed` | Include payments that failed during processing. |\n| `declined` | Include payments rejected by the issuer or payment flow. |\n| `cancelled` | Include payments cancelled before completion. |\n\nIf not provided, payments in all states will be included in the report.","descriptionNode":"$Ldf9"}},"required":["from","to"],"descriptionNode":"$Ldfa"},"format":{"type":"string","enum":"$53:props:children:0:props:children:props:requestBody:content:application/json:schema:oneOf:0:properties:format:enum","description":"Format of the generated report file.","examples":"$53:props:children:0:props:children:props:requestBody:content:application/json:schema:oneOf:0:properties:format:examples","descriptionNode":"$Ldfb"},"type":{"type":"string","description":"$dfc","enum":"$53:props:children:0:props:children:props:requestBody:content:application/json:schema:oneOf:0:properties:type:enum","examples":"$53:props:children:0:props:children:props:requestBody:content:application/json:schema:oneOf:0:properties:type:examples","descriptionNode":"$Ldfd"},"options":{"type":"object","description":"Further options to customise the report.","properties":{"timezone":{"type":"string","description":"Defaults to `ETC/UTC`. Defines the output timezone for all timestamps displayed in the report.\n\nHas no effect on `from` or `to` parameters.","examples":"$53:props:children:0:props:children:props:requestBody:content:application/json:schema:oneOf:0:properties:options:properties:timezone:examples","descriptionNode":"$Ldfe"},"columns":{"type":"array","items":{"type":"string","enum":["payment_id","type","description","original_payment_id","order_id","state","reason","amount","currency","surcharge_amount","tip_amount","refunded_amount","created_date","captured_date","merchant_order_ext_ref","payment_method","location_id","customer_id","customer_card_number","customer_card_country","customer_card_brand","customer_card_type","customer_card_category","customer_email","fee_amount","fee_currency"]},"description":"$dff","examples":[["payment_id","type","state","amount","currency"]],"descriptionNode":"$Le00"}},"descriptionNode":"$Le01"}},"required":["filter","format","type"],"descriptionNode":"$Le02"},{"title":"Payout statement report","type":"object","description":"A payout statement report contains all the query information for generating reports of a selected payout associated with a Merchant account.","properties":{"filter":{"type":"object","description":"Filtering parameters to be applied to the report.","properties":{"payout_id":{"type":"string","format":"uuid","description":"Permanent payout ID used for payouts operations.","descriptionNode":"$Le03"}},"required":["payout_id"],"descriptionNode":"$Le04"},"format":{"type":"string","enum":"$53:props:children:0:props:children:props:requestBody:content:application/json:schema:oneOf:0:properties:format:enum","description":"Format of the generated report file.","examples":"$53:props:children:0:props:children:props:requestBody:content:application/json:schema:oneOf:0:properties:format:examples","descriptionNode":"$Le05"},"type":{"type":"string","description":"$e06","enum":"$53:props:children:0:props:children:props:requestBody:content:application/json:schema:oneOf:0:properties:type:enum","examples":"$53:props:children:0:props:children:props:requestBody:content:application/json:schema:oneOf:0:properties:type:examples","descriptionNode":"$Le07"},"options":{"type":"object","description":"Further options to customise the report.","properties":{"timezone":{"type":"string","description":"Defaults to `ETC/UTC`. Defines the output timezone for all timestamps displayed in the report.\n\nHas no effect on `from` or `to` parameters.","examples":"$53:props:children:0:props:children:props:requestBody:content:application/json:schema:oneOf:0:properties:options:properties:timezone:examples","descriptionNode":"$Le08"},"columns":{"type":"array","items":{"type":"string","enum":["created_date","completed_date","payout_affected_date","affected_payout_amount","transaction_id","order_id","dispute_id","merchant_order_reference","type","related_icpp_charge_id","transaction_amount","transaction_currency","billing_amount","billing_currency","state","original_transaction_id","original_transaction_amount","original_transaction_currency","original_order_id","original_order_channel","original_merchant_order_reference","fee_amount","fee_currency","settlement_amount","settlement_currency","location_id","location_name","submerchant_id","payout_transfer_reference","payout_total_amount","payout_date"]},"description":"$e09","examples":[["transaction_id","type","transaction_amount","transaction_currency"]],"descriptionNode":"$Le0a"}},"descriptionNode":"$Le0b"}},"required":["filter","format","type"],"descriptionNode":"$Le0c"},{"title":"IC++ fee breakdown report","type":"object","description":"A IC++ fee breakdown report contains all the query information for generating reports of fees for each IC++ transaction related to a payout.","properties":{"filter":{"type":"object","description":"Filtering parameters to be applied to the report.","properties":{"icpp_charge_id":{"type":"string","format":"uuid","description":"Permanent ID of of the IC++ fee related to a payout transaction.\n\nThis ID can be obtained from the `related_icpp_charge_id` column of a payout statement report.","descriptionNode":"$Le0d"}},"required":["icpp_charge_id"],"descriptionNode":"$Le0e"},"format":{"type":"string","enum":"$53:props:children:0:props:children:props:requestBody:content:application/json:schema:oneOf:0:properties:format:enum","description":"Format of the generated report file.","examples":"$53:props:children:0:props:children:props:requestBody:content:application/json:schema:oneOf:0:properties:format:examples","descriptionNode":"$Le0f"},"type":{"type":"string","description":"$e10","enum":"$53:props:children:0:props:children:props:requestBody:content:application/json:schema:oneOf:0:properties:type:enum","examples":"$53:props:children:0:props:children:props:requestBody:content:application/json:schema:oneOf:0:properties:type:examples","descriptionNode":"$Le11"},"options":{"type":"object","description":"Further options to customise the report.","properties":{"timezone":{"type":"string","description":"Defaults to `ETC/UTC`. Defines the output timezone for all timestamps displayed in the report.\n\nHas no effect on `from` or `to` parameters.","examples":"$53:props:children:0:props:children:props:requestBody:content:application/json:schema:oneOf:0:properties:options:properties:timezone:examples","descriptionNode":"$Le12"},"columns":{"type":"array","items":{"type":"string","enum":["id","created_at","operation","amount","currency","settlement_amount","settlement_currency","payment_method","card_scheme","card_funding","order_description","order_merchant_external_ref","original_operation_id","acquiring_fee_amount","card_interchange_fee_amount","card_scheme_fee_amount","card_type","order_channel","card_country"]},"description":"$e13","examples":[["id","operation","acquiring_fee_amount","card_interchange_fee_amount","card_scheme_fee_amount"]],"descriptionNode":"$Le14"}},"descriptionNode":"$Le15"}},"required":["filter","format","type"],"descriptionNode":"$Le16"}]},"examples":{"custom_report":{"summary":"Custom report","value":{"filter":{"from":"2020-01-01T00:00:00Z","to":"2020-01-02T00:00:00Z","entity_types":["payment"],"entity_states":["completed","processing"]},"format":"csv","type":"custom_report","options":{"timezone":"Europe/London","columns":["transaction_id","amount","currency","metadata.custom_attribute"]}}},"settlement_report":{"summary":"Settlement report","value":{"filter":{"from":"2020-01-01T00:00:00Z","to":"2020-01-02T00:00:00Z","entity_types":["payment"]},"format":"csv","type":"settlement_report"}},"payments_report":{"summary":"Payments report","value":{"filter":{"from":"2020-01-01T00:00:00Z","to":"2020-01-02T00:00:00Z","entity_states":["completed","failed","declined"]},"format":"csv","type":"payments_report"}},"payout_statement_report":{"summary":"Payout statement report","value":{"filter":{"payout_id":"a830020e-090c-4717-836d-37941a27ad12"},"format":"csv","type":"payout_statement_report"}},"icpp_fee_breakdown_report":{"summary":"IC++ fee breakdown report","value":{"filter":{"icpp_charge_id":"41d6c699-744a-4994-91c0-9227539c587f"},"format":"csv","type":"icpp_fee_breakdown_report"}}}}}},"variantLabels":["Report run processing","Report run completed, report file ready"],"children":["$Le17","$Le18"]}]}],false]}] e17:["$","div",null,{"className":"ezz1n30","children":[["$","div",null,{"data-header":"$undefined","className":"ezz1n31","children":["$","div",null,{"className":"y9a0do1","children":[["$","h2",null,{"id":"create-report-run","children":[["$Le19","$undefined"],["$","$L15",null,{"id":"create-report-run"}]]}],["$","$L16",null,{"url":"/docs/api/merchant/2025-10-16/operations/create-report-run.md"}]]}]}],"$undefined"]}] e1c:Td83,
curl -X POST "https://merchant.revolut.com/api/report-runs" \
  -H "Content-Type: application/json" \
  -H "Authorization: __RP_TOK_0__" \
  -d '{
  "filter": {
    "from": "2020-01-01T00:00:00Z",
    "to": "2020-01-02T00:00:00Z",
    "entity_types": [
      "payment"
    ],
    "entity_states": [
      "completed",
      "processing"
    ]
  },
  "format": "csv",
  "type": "custom_report",
  "options": {
    "timezone": "Europe/London",
    "columns": [
      "transaction_id",
      "amount",
      "currency",
      "metadata.custom_attribute"
    ]
  }
}'
e1d:T1a64,
const payload = {
  "filter": {
    "from": "2020-01-01T00:00:00Z",
    "to": "2020-01-02T00:00:00Z",
    "entity_types": [
      "payment"
    ],
    "entity_states": [
      "completed",
      "processing"
    ]
  },
  "format": "csv",
  "type": "custom_report",
  "options": {
    "timezone": "Europe/London",
    "columns": [
      "transaction_id",
      "amount",
      "currency",
      "metadata.custom_attribute"
    ]
  }
};
fetch("https://merchant.revolut.com/api/report-runs", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "__RP_TOK_0__"
  },
  body: JSON.stringify(payload)
})
  .then(response => response.json())
  .then(data => console.log(data));
e1e:T1c7b,
package main

import (
  "fmt"
  "net/http"
  "bytes"
  "encoding/json"
)

func main() {
  url := "https://merchant.revolut.com/api/report-runs"
  jsonData := []byte(`
{
  "filter": {
    "from": "2020-01-01T00:00:00Z",
    "to": "2020-01-02T00:00:00Z",
    "entity_types": [
      "payment"
    ],
    "entity_states": [
      "completed",
      "processing"
    ]
  },
  "format": "csv",
  "type": "custom_report",
  "options": {
    "timezone": "Europe/London",
    "columns": [
      "transaction_id",
      "amount",
      "currency",
      "metadata.custom_attribute"
    ]
  }
}
  `)
  req, _ := http.NewRequest("POST", url, bytes.NewBuffer(jsonData))
  req.Header.Add("Content-Type", "application/json")
  req.Header.Add("Authorization", "__RP_TOK_0__")

  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  fmt.Println(res)
}
e1f:T179a,
import requests

url = "https://merchant.revolut.com/api/report-runs"
headers = {
  "Content-Type": "application/json",
  "Authorization": "__RP_TOK_0__"
}
payload = {
  "filter": {
    "from": "2020-01-01T00:00:00Z",
    "to": "2020-01-02T00:00:00Z",
    "entity_types": [
      "payment"
    ],
    "entity_states": [
      "completed",
      "processing"
    ]
  },
  "format": "csv",
  "type": "custom_report",
  "options": {
    "timezone": "Europe/London",
    "columns": [
      "transaction_id",
      "amount",
      "currency",
      "metadata.custom_attribute"
    ]
  }
}

response = requests.post(url, headers=headers, json=payload)
print(response.json())
e20:T478,import java.net.http.HttpClient; import java.net.http.HttpRequest; import java.net.http.HttpResponse; import java.net.URI; public class Main { public static void main(String[] args) { HttpClient client = HttpClient.newHttpClient(); String body = """ { "filter": { "from": "2020-01-01T00:00:00Z", "to": "2020-01-02T00:00:00Z", "entity_types": [ "payment" ], "entity_states": [ "completed", "processing" ] }, "format": "csv", "type": "custom_report", "options": { "timezone": "Europe/London", "columns": [ "transaction_id", "amount", "currency", "metadata.custom_attribute" ] } } """; HttpRequest request = HttpRequest.newBuilder() .uri(URI.create("https://merchant.revolut.com/api/report-runs")) .header("Content-Type", "application/json") .header("Authorization", "__RP_TOK_0__") .POST(HttpRequest.BodyPublishers.ofString(body)) .build(); client.sendAsync(request, HttpResponse.BodyHandlers.ofString()) .thenApply(HttpResponse::body) .thenAccept(System.out::println) .join(); } }e21:T21e2,
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;

public class Main {
  public static void main(String[] args) {
    HttpClient client = HttpClient.newHttpClient();
    String body = """
{
  "filter": {
    "from": "2020-01-01T00:00:00Z",
    "to": "2020-01-02T00:00:00Z",
    "entity_types": [
      "payment"
    ],
    "entity_states": [
      "completed",
      "processing"
    ]
  },
  "format": "csv",
  "type": "custom_report",
  "options": {
    "timezone": "Europe/London",
    "columns": [
      "transaction_id",
      "amount",
      "currency",
      "metadata.custom_attribute"
    ]
  }
}
    """;

    HttpRequest request = HttpRequest.newBuilder()
      .uri(URI.create("https://merchant.revolut.com/api/report-runs"))
      .header("Content-Type", "application/json")
      .header("Authorization", "__RP_TOK_0__")
      .POST(HttpRequest.BodyPublishers.ofString(body))
      .build();

    client.sendAsync(request, HttpResponse.BodyHandlers.ofString())
      .thenApply(HttpResponse::body)
      .thenAccept(System.out::println)
      .join();
  }
}
e22:T42a,using System.Net.Http; using System.Net.Http.Headers; var client = new HttpClient(); var request = new HttpRequestMessage { Method = HttpMethod.Post, RequestUri = new Uri("https://merchant.revolut.com/api/report-runs"), Headers = { { "Authorization", "__RP_TOK_0__" }, }, Content = new StringContent(@"{ ""filter"": { ""from"": ""2020-01-01T00:00:00Z"", ""to"": ""2020-01-02T00:00:00Z"", ""entity_types"": [ ""payment"" ], ""entity_states"": [ ""completed"", ""processing"" ] }, ""format"": ""csv"", ""type"": ""custom_report"", ""options"": { ""timezone"": ""Europe/London"", ""columns"": [ ""transaction_id"", ""amount"", ""currency"", ""metadata.custom_attribute"" ] } }") { Headers = { ContentType = new MediaTypeHeaderValue("application/json") } } }; using (var response = await client.SendAsync(request)) { response.EnsureSuccessStatusCode(); var body = await response.Content.ReadAsStringAsync(); Console.WriteLine(body); }e23:T31f8,
using System.Net.Http;
using System.Net.Http.Headers;

var client = new HttpClient();
var request = new HttpRequestMessage
{
  Method = HttpMethod.Post,
  RequestUri = new Uri("https://merchant.revolut.com/api/report-runs"),
  Headers =
  {
    { "Authorization", "__RP_TOK_0__" },
  },
  Content = new StringContent(@"{
  ""filter"": {
    ""from"": ""2020-01-01T00:00:00Z"",
    ""to"": ""2020-01-02T00:00:00Z"",
    ""entity_types"": [
      ""payment""
    ],
    ""entity_states"": [
      ""completed"",
      ""processing""
    ]
  },
  ""format"": ""csv"",
  ""type"": ""custom_report"",
  ""options"": {
    ""timezone"": ""Europe/London"",
    ""columns"": [
      ""transaction_id"",
      ""amount"",
      ""currency"",
      ""metadata.custom_attribute""
    ]
  }
}")
  {
    Headers =
    {
      ContentType = new MediaTypeHeaderValue("application/json")
    }
  }
};

using (var response = await client.SendAsync(request))
{
  response.EnsureSuccessStatusCode();
  var body = await response.Content.ReadAsStringAsync();
  Console.WriteLine(body);
}
e24:Td8b,
curl -X POST "https://sandbox-merchant.revolut.com/api/report-runs" \
  -H "Content-Type: application/json" \
  -H "Authorization: __RP_TOK_0__" \
  -d '{
  "filter": {
    "from": "2020-01-01T00:00:00Z",
    "to": "2020-01-02T00:00:00Z",
    "entity_types": [
      "payment"
    ],
    "entity_states": [
      "completed",
      "processing"
    ]
  },
  "format": "csv",
  "type": "custom_report",
  "options": {
    "timezone": "Europe/London",
    "columns": [
      "transaction_id",
      "amount",
      "currency",
      "metadata.custom_attribute"
    ]
  }
}'
e25:T1a6c,
const payload = {
  "filter": {
    "from": "2020-01-01T00:00:00Z",
    "to": "2020-01-02T00:00:00Z",
    "entity_types": [
      "payment"
    ],
    "entity_states": [
      "completed",
      "processing"
    ]
  },
  "format": "csv",
  "type": "custom_report",
  "options": {
    "timezone": "Europe/London",
    "columns": [
      "transaction_id",
      "amount",
      "currency",
      "metadata.custom_attribute"
    ]
  }
};
fetch("https://sandbox-merchant.revolut.com/api/report-runs", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "__RP_TOK_0__"
  },
  body: JSON.stringify(payload)
})
  .then(response => response.json())
  .then(data => console.log(data));
e26:T1c83,
package main

import (
  "fmt"
  "net/http"
  "bytes"
  "encoding/json"
)

func main() {
  url := "https://sandbox-merchant.revolut.com/api/report-runs"
  jsonData := []byte(`
{
  "filter": {
    "from": "2020-01-01T00:00:00Z",
    "to": "2020-01-02T00:00:00Z",
    "entity_types": [
      "payment"
    ],
    "entity_states": [
      "completed",
      "processing"
    ]
  },
  "format": "csv",
  "type": "custom_report",
  "options": {
    "timezone": "Europe/London",
    "columns": [
      "transaction_id",
      "amount",
      "currency",
      "metadata.custom_attribute"
    ]
  }
}
  `)
  req, _ := http.NewRequest("POST", url, bytes.NewBuffer(jsonData))
  req.Header.Add("Content-Type", "application/json")
  req.Header.Add("Authorization", "__RP_TOK_0__")

  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  fmt.Println(res)
}
e27:T17a2,
import requests

url = "https://sandbox-merchant.revolut.com/api/report-runs"
headers = {
  "Content-Type": "application/json",
  "Authorization": "__RP_TOK_0__"
}
payload = {
  "filter": {
    "from": "2020-01-01T00:00:00Z",
    "to": "2020-01-02T00:00:00Z",
    "entity_types": [
      "payment"
    ],
    "entity_states": [
      "completed",
      "processing"
    ]
  },
  "format": "csv",
  "type": "custom_report",
  "options": {
    "timezone": "Europe/London",
    "columns": [
      "transaction_id",
      "amount",
      "currency",
      "metadata.custom_attribute"
    ]
  }
}

response = requests.post(url, headers=headers, json=payload)
print(response.json())
e28:T480,import java.net.http.HttpClient; import java.net.http.HttpRequest; import java.net.http.HttpResponse; import java.net.URI; public class Main { public static void main(String[] args) { HttpClient client = HttpClient.newHttpClient(); String body = """ { "filter": { "from": "2020-01-01T00:00:00Z", "to": "2020-01-02T00:00:00Z", "entity_types": [ "payment" ], "entity_states": [ "completed", "processing" ] }, "format": "csv", "type": "custom_report", "options": { "timezone": "Europe/London", "columns": [ "transaction_id", "amount", "currency", "metadata.custom_attribute" ] } } """; HttpRequest request = HttpRequest.newBuilder() .uri(URI.create("https://sandbox-merchant.revolut.com/api/report-runs")) .header("Content-Type", "application/json") .header("Authorization", "__RP_TOK_0__") .POST(HttpRequest.BodyPublishers.ofString(body)) .build(); client.sendAsync(request, HttpResponse.BodyHandlers.ofString()) .thenApply(HttpResponse::body) .thenAccept(System.out::println) .join(); } }e29:T21ea,
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;

public class Main {
  public static void main(String[] args) {
    HttpClient client = HttpClient.newHttpClient();
    String body = """
{
  "filter": {
    "from": "2020-01-01T00:00:00Z",
    "to": "2020-01-02T00:00:00Z",
    "entity_types": [
      "payment"
    ],
    "entity_states": [
      "completed",
      "processing"
    ]
  },
  "format": "csv",
  "type": "custom_report",
  "options": {
    "timezone": "Europe/London",
    "columns": [
      "transaction_id",
      "amount",
      "currency",
      "metadata.custom_attribute"
    ]
  }
}
    """;

    HttpRequest request = HttpRequest.newBuilder()
      .uri(URI.create("https://sandbox-merchant.revolut.com/api/report-runs"))
      .header("Content-Type", "application/json")
      .header("Authorization", "__RP_TOK_0__")
      .POST(HttpRequest.BodyPublishers.ofString(body))
      .build();

    client.sendAsync(request, HttpResponse.BodyHandlers.ofString())
      .thenApply(HttpResponse::body)
      .thenAccept(System.out::println)
      .join();
  }
}
e2a:T432,using System.Net.Http; using System.Net.Http.Headers; var client = new HttpClient(); var request = new HttpRequestMessage { Method = HttpMethod.Post, RequestUri = new Uri("https://sandbox-merchant.revolut.com/api/report-runs"), Headers = { { "Authorization", "__RP_TOK_0__" }, }, Content = new StringContent(@"{ ""filter"": { ""from"": ""2020-01-01T00:00:00Z"", ""to"": ""2020-01-02T00:00:00Z"", ""entity_types"": [ ""payment"" ], ""entity_states"": [ ""completed"", ""processing"" ] }, ""format"": ""csv"", ""type"": ""custom_report"", ""options"": { ""timezone"": ""Europe/London"", ""columns"": [ ""transaction_id"", ""amount"", ""currency"", ""metadata.custom_attribute"" ] } }") { Headers = { ContentType = new MediaTypeHeaderValue("application/json") } } }; using (var response = await client.SendAsync(request)) { response.EnsureSuccessStatusCode(); var body = await response.Content.ReadAsStringAsync(); Console.WriteLine(body); }e2b:T3200,
using System.Net.Http;
using System.Net.Http.Headers;

var client = new HttpClient();
var request = new HttpRequestMessage
{
  Method = HttpMethod.Post,
  RequestUri = new Uri("https://sandbox-merchant.revolut.com/api/report-runs"),
  Headers =
  {
    { "Authorization", "__RP_TOK_0__" },
  },
  Content = new StringContent(@"{
  ""filter"": {
    ""from"": ""2020-01-01T00:00:00Z"",
    ""to"": ""2020-01-02T00:00:00Z"",
    ""entity_types"": [
      ""payment""
    ],
    ""entity_states"": [
      ""completed"",
      ""processing""
    ]
  },
  ""format"": ""csv"",
  ""type"": ""custom_report"",
  ""options"": {
    ""timezone"": ""Europe/London"",
    ""columns"": [
      ""transaction_id"",
      ""amount"",
      ""currency"",
      ""metadata.custom_attribute""
    ]
  }
}")
  {
    Headers =
    {
      ContentType = new MediaTypeHeaderValue("application/json")
    }
  }
};

using (var response = await client.SendAsync(request))
{
  response.EnsureSuccessStatusCode();
  var body = await response.Content.ReadAsStringAsync();
  Console.WriteLine(body);
}
e18:["$","div",null,{"className":"ezz1n30","children":[["$","div",null,{"data-header":"$undefined","className":"ezz1n31","children":["$Le1a",["$","$L85",null,{"parameters":[{"name":"Authorization","in":"header","schema":{"type":"string","format":"Bearer ","examples":"$62:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:0:schema:examples"},"required":true,"description":"This parameter accepts the [Merchant API Secret key](https://business.revolut.com/settings/apis?tab=merchant-api) to authorise requests coming from the merchant's backend. \n\nIt ensures that ensures that each request is authenticated and authorised by verifying the secret key. The secret key should be included in all request headers as a `Bearer` token.\n\n:::info\nFor more information, see: [Authentication](https://developer.revolut.com/docs/api/merchant#authentication)\n:::","descriptionNode":"$Le1b"}],"requestBody":"$53:props:children:0:props:children:props:requestBody","heading":"Request","requestBodySchemaTitle":"Request body","headingAs":"h3"}],["$","$L89",null,{"responses":"$53:props:children:0:props:children:props:responses","headingAs":"h3"}]]}],["$","div",null,{"className":"ezz1n32","children":[[["$","$L8a",null,{"itemsByServer":{"https://merchant.revolut.com":[{"id":"curl","label":"cURL","templateCode":"curl -X POST \"https://merchant.revolut.com/api/report-runs\" \\\n -H \"Content-Type: application/json\" \\\n -H \"Authorization: __RP_TOK_0__\" \\\n -d '{\n \"filter\": {\n \"from\": \"2020-01-01T00:00:00Z\",\n \"to\": \"2020-01-02T00:00:00Z\",\n \"entity_types\": [\n \"payment\"\n ],\n \"entity_states\": [\n \"completed\",\n \"processing\"\n ]\n },\n \"format\": \"csv\",\n \"type\": \"custom_report\",\n \"options\": {\n \"timezone\": \"Europe/London\",\n \"columns\": [\n \"transaction_id\",\n \"amount\",\n \"currency\",\n \"metadata.custom_attribute\"\n ]\n }\n}'","templateHtml":"$e1c","tokens":[{"marker":"__RP_TOK_0__","paramName":"Authorization","paramIn":"header","pipeline":["shell-double-inner"]}],"defaults":{"header:Authorization":"Bearer "}},{"id":"javascript","label":"JavaScript","templateCode":"const payload = {\n \"filter\": {\n \"from\": \"2020-01-01T00:00:00Z\",\n \"to\": \"2020-01-02T00:00:00Z\",\n \"entity_types\": [\n \"payment\"\n ],\n \"entity_states\": [\n \"completed\",\n \"processing\"\n ]\n },\n \"format\": \"csv\",\n \"type\": \"custom_report\",\n \"options\": {\n \"timezone\": \"Europe/London\",\n \"columns\": [\n \"transaction_id\",\n \"amount\",\n \"currency\",\n \"metadata.custom_attribute\"\n ]\n }\n};\nfetch(\"https://merchant.revolut.com/api/report-runs\", {\n method: \"POST\",\n headers: {\n \"Content-Type\": \"application/json\",\n \"Authorization\": \"__RP_TOK_0__\"\n },\n body: JSON.stringify(payload)\n})\n .then(response => response.json())\n .then(data => console.log(data));","templateHtml":"$e1d","tokens":[{"marker":"__RP_TOK_0__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer "}},{"id":"go","label":"Go","templateCode":"package main\n\nimport (\n \"fmt\"\n \"net/http\"\n \"bytes\"\n \"encoding/json\"\n)\n\nfunc main() {\n url := \"https://merchant.revolut.com/api/report-runs\"\n jsonData := []byte(`\n{\n \"filter\": {\n \"from\": \"2020-01-01T00:00:00Z\",\n \"to\": \"2020-01-02T00:00:00Z\",\n \"entity_types\": [\n \"payment\"\n ],\n \"entity_states\": [\n \"completed\",\n \"processing\"\n ]\n },\n \"format\": \"csv\",\n \"type\": \"custom_report\",\n \"options\": {\n \"timezone\": \"Europe/London\",\n \"columns\": [\n \"transaction_id\",\n \"amount\",\n \"currency\",\n \"metadata.custom_attribute\"\n ]\n }\n}\n `)\n req, _ := http.NewRequest(\"POST\", url, bytes.NewBuffer(jsonData))\n req.Header.Add(\"Content-Type\", \"application/json\")\n req.Header.Add(\"Authorization\", \"__RP_TOK_0__\")\n\n res, _ := http.DefaultClient.Do(req)\n defer res.Body.Close()\n fmt.Println(res)\n}","templateHtml":"$e1e","tokens":[{"marker":"__RP_TOK_0__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer "}},{"id":"python","label":"Python","templateCode":"import requests\n\nurl = \"https://merchant.revolut.com/api/report-runs\"\nheaders = {\n \"Content-Type\": \"application/json\",\n \"Authorization\": \"__RP_TOK_0__\"\n}\npayload = {\n \"filter\": {\n \"from\": \"2020-01-01T00:00:00Z\",\n \"to\": \"2020-01-02T00:00:00Z\",\n \"entity_types\": [\n \"payment\"\n ],\n \"entity_states\": [\n \"completed\",\n \"processing\"\n ]\n },\n \"format\": \"csv\",\n \"type\": \"custom_report\",\n \"options\": {\n \"timezone\": \"Europe/London\",\n \"columns\": [\n \"transaction_id\",\n \"amount\",\n \"currency\",\n \"metadata.custom_attribute\"\n ]\n }\n}\n\nresponse = requests.post(url, headers=headers, json=payload)\nprint(response.json())","templateHtml":"$e1f","tokens":[{"marker":"__RP_TOK_0__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer "}},{"id":"java","label":"Java","templateCode":"$e20","templateHtml":"$e21","tokens":[{"marker":"__RP_TOK_0__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer "}},{"id":"csharp","label":"C#","templateCode":"$e22","templateHtml":"$e23","tokens":[{"marker":"__RP_TOK_0__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer "}}],"https://sandbox-merchant.revolut.com":[{"id":"curl","label":"cURL","templateCode":"curl -X POST \"https://sandbox-merchant.revolut.com/api/report-runs\" \\\n -H \"Content-Type: application/json\" \\\n -H \"Authorization: __RP_TOK_0__\" \\\n -d '{\n \"filter\": {\n \"from\": \"2020-01-01T00:00:00Z\",\n \"to\": \"2020-01-02T00:00:00Z\",\n \"entity_types\": [\n \"payment\"\n ],\n \"entity_states\": [\n \"completed\",\n \"processing\"\n ]\n },\n \"format\": \"csv\",\n \"type\": \"custom_report\",\n \"options\": {\n \"timezone\": \"Europe/London\",\n \"columns\": [\n \"transaction_id\",\n \"amount\",\n \"currency\",\n \"metadata.custom_attribute\"\n ]\n }\n}'","templateHtml":"$e24","tokens":[{"marker":"__RP_TOK_0__","paramName":"Authorization","paramIn":"header","pipeline":["shell-double-inner"]}],"defaults":{"header:Authorization":"Bearer "}},{"id":"javascript","label":"JavaScript","templateCode":"const payload = {\n \"filter\": {\n \"from\": \"2020-01-01T00:00:00Z\",\n \"to\": \"2020-01-02T00:00:00Z\",\n \"entity_types\": [\n \"payment\"\n ],\n \"entity_states\": [\n \"completed\",\n \"processing\"\n ]\n },\n \"format\": \"csv\",\n \"type\": \"custom_report\",\n \"options\": {\n \"timezone\": \"Europe/London\",\n \"columns\": [\n \"transaction_id\",\n \"amount\",\n \"currency\",\n \"metadata.custom_attribute\"\n ]\n }\n};\nfetch(\"https://sandbox-merchant.revolut.com/api/report-runs\", {\n method: \"POST\",\n headers: {\n \"Content-Type\": \"application/json\",\n \"Authorization\": \"__RP_TOK_0__\"\n },\n body: JSON.stringify(payload)\n})\n .then(response => response.json())\n .then(data => console.log(data));","templateHtml":"$e25","tokens":[{"marker":"__RP_TOK_0__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer "}},{"id":"go","label":"Go","templateCode":"package main\n\nimport (\n \"fmt\"\n \"net/http\"\n \"bytes\"\n \"encoding/json\"\n)\n\nfunc main() {\n url := \"https://sandbox-merchant.revolut.com/api/report-runs\"\n jsonData := []byte(`\n{\n \"filter\": {\n \"from\": \"2020-01-01T00:00:00Z\",\n \"to\": \"2020-01-02T00:00:00Z\",\n \"entity_types\": [\n \"payment\"\n ],\n \"entity_states\": [\n \"completed\",\n \"processing\"\n ]\n },\n \"format\": \"csv\",\n \"type\": \"custom_report\",\n \"options\": {\n \"timezone\": \"Europe/London\",\n \"columns\": [\n \"transaction_id\",\n \"amount\",\n \"currency\",\n \"metadata.custom_attribute\"\n ]\n }\n}\n `)\n req, _ := http.NewRequest(\"POST\", url, bytes.NewBuffer(jsonData))\n req.Header.Add(\"Content-Type\", \"application/json\")\n req.Header.Add(\"Authorization\", \"__RP_TOK_0__\")\n\n res, _ := http.DefaultClient.Do(req)\n defer res.Body.Close()\n fmt.Println(res)\n}","templateHtml":"$e26","tokens":[{"marker":"__RP_TOK_0__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer "}},{"id":"python","label":"Python","templateCode":"import requests\n\nurl = \"https://sandbox-merchant.revolut.com/api/report-runs\"\nheaders = {\n \"Content-Type\": \"application/json\",\n \"Authorization\": \"__RP_TOK_0__\"\n}\npayload = {\n \"filter\": {\n \"from\": \"2020-01-01T00:00:00Z\",\n \"to\": \"2020-01-02T00:00:00Z\",\n \"entity_types\": [\n \"payment\"\n ],\n \"entity_states\": [\n \"completed\",\n \"processing\"\n ]\n },\n \"format\": \"csv\",\n \"type\": \"custom_report\",\n \"options\": {\n \"timezone\": \"Europe/London\",\n \"columns\": [\n \"transaction_id\",\n \"amount\",\n \"currency\",\n \"metadata.custom_attribute\"\n ]\n }\n}\n\nresponse = requests.post(url, headers=headers, json=payload)\nprint(response.json())","templateHtml":"$e27","tokens":[{"marker":"__RP_TOK_0__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer "}},{"id":"java","label":"Java","templateCode":"$e28","templateHtml":"$e29","tokens":[{"marker":"__RP_TOK_0__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer "}},{"id":"csharp","label":"C#","templateCode":"$e2a","templateHtml":"$e2b","tokens":[{"marker":"__RP_TOK_0__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer "}}]},"method":"post","servers":"$62:props:children:0:props:children:props:children:1:props:children:1:props:children:0:0:props:servers","path":"/api/report-runs","parameters":["$e18:props:children:0:props:children:1:props:parameters:0"]}],"$Le2c"],"$Le2d","$Le2e"]}]]}] e2c:["$","$L10d",null,{"security":[{"Api-Key":[]}],"authorization":{"Api-Key":{"type":"apiKey","in":"header","name":"Authorization","description":"Each Merchant API request must contain an authorization header in the following format:\n\n```\n'Authorization: Bearer '\n```\n\nTo use this API, you need to generate API keys from your Revolut Business account. The Secret key is used in the authorization header for all server calls, while the Public key is provided with payment methods at checkout.\n\n:::info\nFor detailed instructions on generating your API keys, see: [Generate API keys](https://developer.revolut.com/docs/guides/merchant/get-started#generate-api-keys).\n:::","descriptionNode":"$Le2f"}}}] e2d:["$","$L10f",null,{"exampleBlocks":{"application/json":{"variants":[{"key":"custom_report","label":"Custom report","rawValue":"$53:props:children:0:props:children:props:requestBody:content:application/json:examples:custom_report:value","block":"$Le30"},{"key":"settlement_report","label":"Settlement report","rawValue":"$53:props:children:0:props:children:props:requestBody:content:application/json:examples:settlement_report:value","block":"$Le31"},{"key":"payments_report","label":"Payments report","rawValue":"$53:props:children:0:props:children:props:requestBody:content:application/json:examples:payments_report:value","block":"$Le32"},{"key":"payout_statement_report","label":"Payout statement report","rawValue":"$53:props:children:0:props:children:props:requestBody:content:application/json:examples:payout_statement_report:value","block":"$Le33"},{"key":"icpp_fee_breakdown_report","label":"IC++ fee breakdown report","rawValue":"$53:props:children:0:props:children:props:requestBody:content:application/json:examples:icpp_fee_breakdown_report:value","block":"$Le34"}],"syncedPropertyName":"type"}},"title":"Request body samples","headingAs":"h4"}] e2e:["$","$L110",null,{"exampleBlocks":{"201":{"application/json":{"variants":[{"key":"report_run_processing","label":"Report run processing","rawValue":"$53:props:children:0:props:children:props:responses:201:content:application/json:examples:report_run_processing:value","block":"$Le35"},{"key":"report_run_completed","label":"Report run completed, report file ready","rawValue":"$53:props:children:0:props:children:props:responses:201:content:application/json:examples:report_run_completed:value","block":"$Le36"}],"syncedPropertyName":"$undefined"}},"400":{"application/json":{"variants":[{"key":"default","label":"Example","rawValue":{"code":"string","message":"string","timestamp":123},"block":"$Le37"}],"syncedPropertyName":"$undefined"}},"401":{"application/json":{"variants":[{"key":"default","label":"Example","rawValue":{"code":"string","message":"string","timestamp":123},"block":"$Le38"}],"syncedPropertyName":"$undefined"}},"404":{"application/json":{"variants":[{"key":"default","label":"Example","rawValue":{"code":"string","message":"string","timestamp":123},"block":"$Le39"}],"syncedPropertyName":"$undefined"}}},"headingAs":"h4"}] d53:["$","div","CodeBlock-0",{"className":"wzy01m0 _18b50nc0","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"
'Authorization: Bearer <yourSecretApiKey>'
"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"'Authorization: Bearer '\n"}]}]]}] e19:"Create a report run" dce:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unique ID used for accessing report details. Use this to check report generation status."}]]}] dcf:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Current status of the report run."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Value","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"processing"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Report generation is still in progress.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"completed"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["Report generation finished successfully and the file is available to download for 24 hours via ",["$","code","code-0",{"children":"file_url"}],"."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"failed"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Report generation failed and no report file is available.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"expired"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Report generation previously completed, but the 24-hour file availability window has elapsed and the file can no longer be downloaded.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] dd0:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["Use this link to download the report file. Available only when ",["$","code","code-0",{"children":"status"}]," is ",["$","code","code-1",{"children":"completed"}],", and only for 24 hours after report generation finishes."]}]]}] dd1:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","code","code-0",{"children":"ReportRunDetails"}]," object contains all information associated with a specific report run, identified by the ",["$","code","code-1",{"children":"report_run_id"}],"."]}]]}] dd2:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Report run created, report started generating"}]]}] dd3:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An identifier that can be used to determine what went wrong."}],"\n",["$","p","p-1",{"children":"Error codes are not globally unique, but uniqueness is guaranteed within endpoints."}]]}] dd4:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Some human readable text describing what went wrong."}]]}] dd5:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://www.unixtimestamp.com/","target":"_blank","rel":"noreferrer","children":"UNIX timestamp"}]," of the date and time the error happened."]}]]}] dd6:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Bad Request"}]]}] dd7:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An identifier that can be used to determine what went wrong."}],"\n",["$","p","p-1",{"children":"Error codes are not globally unique, but uniqueness is guaranteed within endpoints."}]]}] dd8:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Some human readable text describing what went wrong."}]]}] dd9:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://www.unixtimestamp.com/","target":"_blank","rel":"noreferrer","children":"UNIX timestamp"}]," of the date and time the error happened."]}]]}] dda:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unauthorized"}]]}] ddb:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An identifier that can be used to determine what went wrong."}],"\n",["$","p","p-1",{"children":"Error codes are not globally unique, but uniqueness is guaranteed within endpoints."}]]}] ddc:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Some human readable text describing what went wrong."}]]}] ddd:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://www.unixtimestamp.com/","target":"_blank","rel":"noreferrer","children":"UNIX timestamp"}]," of the date and time the error happened."]}]]}] dde:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Not Found"}]]}] e3a:T770a,
{
  "orders": [
    {
      "id": "a1b2c3d4-0001-0000-0000-000000000001",
      "token": "b2c3d4e5-0001-0000-0000-000000000001",
      "type": "payment",
      "state": "completed",
      "created_at": "2025-03-10T08:30:00Z",
      "updated_at": "2025-03-10T08:32:15Z",
      "amount": 4999,
      "currency": "GBP",
      "outstanding_amount": 0,
      "capture_mode": "automatic",
      "enforce_challenge": "automatic",
      "description": "Premium subscription",
      "customer": {
        "id": "c3d4e5f6-0001-0000-0000-000000000001",
        "email": "jane.doe@example.com",
        "full_name": "Jane Doe",
        "phone": "+441234567890"
      }
    },
    {
      "id": "a1b2c3d4-0002-0000-0000-000000000002",
      "token": "b2c3d4e5-0002-0000-0000-000000000002",
      "type": "payment",
      "state": "completed",
      "created_at": "2025-03-11T09:00:00Z",
      "updated_at": "2025-03-11T09:01:45Z",
      "amount": 12500,
      "currency": "EUR",
      "outstanding_amount": 0,
      "capture_mode": "automatic",
      "enforce_challenge": "automatic",
      "description": "Shopping cart",
      "customer": {
        "id": "c3d4e5f6-0002-0000-0000-000000000002",
        "email": "john.smith@example.com",
        "full_name": "John Smith"
      },
      "line_items": [
        {
          "name": "Wireless headphones",
          "quantity": 1,
          "unit_price": 9900,
          "total_amount": 9900
        },
        {
          "name": "Phone case",
          "quantity": 2,
          "unit_price": 1300,
          "total_amount": 2600
        }
      ]
    },
    {
      "id": "a1b2c3d4-0003-0000-0000-000000000003",
      "type": "refund",
      "state": "completed",
      "created_at": "2025-03-12T11:15:00Z",
      "updated_at": "2025-03-12T11:16:30Z",
      "amount": 4999,
      "currency": "GBP",
      "outstanding_amount": 0,
      "capture_mode": "automatic",
      "enforce_challenge": "automatic",
      "related_order_id": "a1b2c3d4-0001-0000-0000-000000000001",
      "merchant_order_data": {
        "order_id": "ORD-2025-001",
        "description": "Customer-requested refund"
      }
    },
    {
      "id": "a1b2c3d4-0004-0000-0000-000000000004",
      "token": "b2c3d4e5-0004-0000-0000-000000000004",
      "type": "payment",
      "state": "authorised",
      "created_at": "2025-03-13T14:00:00Z",
      "updated_at": "2025-03-13T14:00:30Z",
      "amount": 35000,
      "currency": "USD",
      "outstanding_amount": 35000,
      "capture_mode": "manual",
      "enforce_challenge": "automatic",
      "description": "Enterprise software licence",
      "cancel_authorised_after": "2025-03-20T14:00:00Z",
      "customer": {
        "id": "c3d4e5f6-0003-0000-0000-000000000003",
        "email": "alex.johnson@example.com",
        "full_name": "Alex Johnson"
      }
    },
    {
      "id": "a1b2c3d4-0005-0000-0000-000000000005",
      "token": "b2c3d4e5-0005-0000-0000-000000000005",
      "type": "payment",
      "state": "completed",
      "created_at": "2025-03-14T16:45:00Z",
      "updated_at": "2025-03-14T16:46:00Z",
      "amount": 799,
      "currency": "GBP",
      "outstanding_amount": 0,
      "capture_mode": "automatic",
      "enforce_challenge": "automatic",
      "description": "Coffee and pastry",
      "location_id": "d4e5f6a7-0001-0000-0000-000000000001"
    },
    {
      "id": "a1b2c3d4-0006-0000-0000-000000000006",
      "token": "b2c3d4e5-0006-0000-0000-000000000006",
      "type": "payment",
      "state": "completed",
      "created_at": "2025-03-15T09:00:00Z",
      "updated_at": "2025-03-15T09:01:00Z",
      "amount": 1999,
      "currency": "GBP",
      "outstanding_amount": 0,
      "capture_mode": "automatic",
      "enforce_challenge": "automatic",
      "subscription_data": {
        "subscription_id": "e2862e0e-66e8-4623-bdd6-7da59b85365d",
        "active_cycle_id": "a1b2c3d4-5678-9012-abcd-ef1234567890",
        "billing_reason": "cycle_billing"
      }
    }
  ]
}
db8:["$","div","200-application/json-list_of_orders",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$e3a"}}]}]],"$Le3b"]}] e3c:T44d,
{
  "code": "string",
  "message": "string",
  "timestamp": 123
}
db9:["$","div","400-application/json-default",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$e3c"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"code\": \"string\",\n \"message\": \"string\",\n \"timestamp\": 123\n}"}]}]]}] e3d:T44d,
{
  "code": "string",
  "message": "string",
  "timestamp": 123
}
dba:["$","div","401-application/json-default",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$e3d"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"code\": \"string\",\n \"message\": \"string\",\n \"timestamp\": 123\n}"}]}]]}] ddf:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["This parameter specifies the start boundary for filtering report data. It accepts ETC/UTC date and time in ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_8601","target":"_blank","rel":"noreferrer","children":"ISO 8601 format"}]," and includes all matching records on or after this timestamp."]}],"\n",["$","p","p-1",{"children":["Combined with the ",["$","code","code-0",{"children":"to"}]," parameter, this determines the report's timeframe, including all matching records between the two values."]}],"\n",["$","p","p-2",{"children":["For example, by setting the ",["$","code","code-0",{"children":"from"}]," parameter to ",["$","code","code-1",{"children":"2021-01-01T00:00:00Z"}],", the report will include matching records from the first second of January 1, 2021, UTC, and onwards."]}]]}] de0:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["This parameter specifies the end boundary for filtering report data. It accepts ETC/UTC date and time in ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_8601","target":"_blank","rel":"noreferrer","children":"ISO 8601 format"}]," and includes all matching records before this timestamp (exclusive)."]}],"\n",["$","p","p-1",{"children":["Combined with the ",["$","code","code-0",{"children":"from"}]," parameter, this determines the timeframe for the report, including all matching records between the two values."]}],"\n",["$","p","p-2",{"children":["For example, setting the ",["$","code","code-0",{"children":"to"}]," parameter to ",["$","code","code-1",{"children":"2021-12-31T23:59:59Z"}]," will include all matching records in the report up to, but not including, the last second of December 31, 2021, UTC."]}]]}] de1:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Select source entity families to be included in the report."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Value","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"payment"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Include rows originating from payment settlement activity.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"refund"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Include rows originating from refund activity.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"dispute"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Include rows originating from dispute and chargeback activity.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["These values are filter input categories. They do not map 1:1 to the CSV ",["$","code","code-0",{"children":"type"}]," output column. For example, a settlement report filtered with ",["$","code","code-1",{"children":"payment"}],", ",["$","code","code-2",{"children":"refund"}],", and ",["$","code","code-3",{"children":"dispute"}]," can still return CSV ",["$","code","code-4",{"children":"type"}]," values such as ",["$","code","code-5",{"children":"SETTLEMENT"}],", ",["$","code","code-6",{"children":"REFUND"}],", ",["$","code","code-7",{"children":"CHARGEBACK"}],", and ",["$","code","code-8",{"children":"CHARGEBACK_REVERSAL"}],"."]}]}]]}]]}] de2:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Select transactions by state to be included in the report."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Value","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"completed"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Include transactions that reached their final successful state.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"processing"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Include transactions that are still being processed.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"cancelled"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Include transactions that were cancelled before final completion.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"reverted"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Include transactions that were reversed after initial creation.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}],"\n",["$","p","p-1",{"children":["If not provided, only ",["$","code","code-0",{"children":"completed"}]," transactions will be included in the report."]}]]}] de3:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["Select transactions with specific currencies to include in the report. Provide ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_4217","target":"_blank","rel":"noreferrer","children":"ISO 4217"}]," currency code in upper case."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information about the supported currencies, see: ",["$","a","a-0",{"href":"https://help.revolut.com/business/help/merchant-accounts/payments/in-which-currencies-can-i-accept-payments/","target":"_blank","rel":"noreferrer","children":"Help Center"}],"."]}]}]]}]]}] de4:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Select transactions by location ID to be included in the report."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#tag-locations","target":"_blank","rel":"noreferrer","children":"Locations"}],"."]}]}]]}]]}] de5:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Filtering parameters to be applied to the report."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For ",["$","code","code-0",{"children":"settlement_report"}]," and ",["$","code","code-1",{"children":"custom_report"}],", ",["$","code","code-2",{"children":"from"}]," and ",["$","code","code-3",{"children":"to"}]," are evaluated against the transaction ",["$","code","code-4",{"children":"created_date"}],", not the original payment-start timeframe or the ",["$","code","code-5",{"children":"payment_created_date"}]," and ",["$","code","code-6",{"children":"payment_captured_date"}]," columns."]}]}]]}]]}] de6:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Format of the generated report file."}]]}] de8:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Type of the report."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Report type","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"settlement_report"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"All settled transactions associated with a Merchant account, with a configurable set of columns.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"custom_report"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Settled and processing transactions associated with a Merchant account, with a configurable set of columns.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"payments_report"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["Payments report provides details of all payments associated with a Merchant account, including failed and declined payments. Supports filtering by ",["$","code","code-0",{"children":"from"}]," and ",["$","code","code-1",{"children":"to"}]," creation timestamps, and optionally by ",["$","code","code-2",{"children":"entity_states"}],"."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"payout_statement_report"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["Payout statement Reports provide a detailed breakdown of all transactions contributing to a specific payout amount. It requires the additional parameter ",["$","code","code-0",{"children":"filter.payout_id"}],", which should be obtained from the payout ID retrieved via the ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#retrieve-payout-list","target":"_blank","rel":"noreferrer","children":"payout list endpoint"}]," or from ",["$","a","a-1",{"href":"https://developer.revolut.com/docs/api/merchant#create-webhook#callbacks","target":"_blank","rel":"noreferrer","children":"webhook events"}],"."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-4",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"icpp_fee_breakdown_report"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["IC++ fee breakdown reports provide a detailed breakdown of fees for each IC++ transaction related to a payout. It requires the additional parameter ",["$","code","code-0",{"children":"filter.icpp_charge_id"}],", which should be obtained from the ",["$","code","code-1",{"children":"related_icpp_charge_id"}]," column in the Payout statement report. A separate report should be generated for each IC++ transaction."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] de9:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["Defaults to ",["$","code","code-0",{"children":"ETC/UTC"}],". Defines the output timezone for all timestamps displayed in the report."]}],"\n",["$","p","p-1",{"children":["Has no effect on ",["$","code","code-0",{"children":"from"}]," or ",["$","code","code-1",{"children":"to"}]," parameters."]}]]}] deb:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Names of the columns to be included in the report."}],"\n",["$","p","p-1",{"children":["If the ",["$","code","code-0",{"children":"columns"}]," parameter is not defined in the request, all available columns will be included in the report. An empty array will return an error."]}],"\n",["$","p","p-2",{"children":"Available columns:"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Column name","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"transaction_id"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Unique identifier of the ledger transaction related to an order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"order_id"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Unique identifier of the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"original_order_id"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Unique identifier of the original order. For refunds and chargebacks, references the order being reversed.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"started_date"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Start timestamp shown on the row. For payment rows, this is the payment start timestamp. For non-payment rows such as refunds and chargebacks, this is the transaction start timestamp. Separate from the report filter timeframe.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-4",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"updated_date"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Last update timestamp shown on the row. For payment rows, this is the payment update timestamp. For non-payment rows such as refunds and chargebacks, this is the transaction update timestamp. Separate from the report filter timeframe.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-5",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"completed_date"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Completion timestamp shown on the row. For payment rows, this is the payment completion timestamp. For non-payment rows such as refunds and chargebacks, this is the transaction completion timestamp. Separate from the report filter timeframe.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-6",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"payment_created_date"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Payment authorisation or creation timestamp for rows linked to a payment. Empty for refunds and non-payment-related rows where no payment timestamp applies. This is returned data, not the report filter key.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-7",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"payment_captured_date"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Payment capture timestamp for rows linked to a captured payment. Empty for refunds, non-payment-related rows, or payments not captured. This is returned data, not the report filter key.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"$Le3e","$Le3f","$Le40","$Le41","$Le42","$Le43","$Le44","$Le45","$Le46","$Le47","$Le48","$Le49","$Le4a","$Le4b","$Le4c","$Le4d"],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] dec:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Further options to customise the report."}]]}] ded:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A settlement report contains all the query information for generating reports of settled transactions associated with a Merchant account."}]]}] dee:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Filtering parameters to be applied to the report."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For ",["$","code","code-0",{"children":"settlement_report"}]," and ",["$","code","code-1",{"children":"custom_report"}],", ",["$","code","code-2",{"children":"from"}]," and ",["$","code","code-3",{"children":"to"}]," are evaluated against the transaction ",["$","code","code-4",{"children":"created_date"}],", not the original payment-start timeframe or the ",["$","code","code-5",{"children":"payment_created_date"}]," and ",["$","code","code-6",{"children":"payment_captured_date"}]," columns."]}]}]]}]]}] def:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Format of the generated report file."}]]}] df1:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Type of the report."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Report type","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"settlement_report"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"All settled transactions associated with a Merchant account, with a configurable set of columns.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"custom_report"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Settled and processing transactions associated with a Merchant account, with a configurable set of columns.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"payments_report"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["Payments report provides details of all payments associated with a Merchant account, including failed and declined payments. Supports filtering by ",["$","code","code-0",{"children":"from"}]," and ",["$","code","code-1",{"children":"to"}]," creation timestamps, and optionally by ",["$","code","code-2",{"children":"entity_states"}],"."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"payout_statement_report"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["Payout statement Reports provide a detailed breakdown of all transactions contributing to a specific payout amount. It requires the additional parameter ",["$","code","code-0",{"children":"filter.payout_id"}],", which should be obtained from the payout ID retrieved via the ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#retrieve-payout-list","target":"_blank","rel":"noreferrer","children":"payout list endpoint"}]," or from ",["$","a","a-1",{"href":"https://developer.revolut.com/docs/api/merchant#create-webhook#callbacks","target":"_blank","rel":"noreferrer","children":"webhook events"}],"."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-4",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"icpp_fee_breakdown_report"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["IC++ fee breakdown reports provide a detailed breakdown of fees for each IC++ transaction related to a payout. It requires the additional parameter ",["$","code","code-0",{"children":"filter.icpp_charge_id"}],", which should be obtained from the ",["$","code","code-1",{"children":"related_icpp_charge_id"}]," column in the Payout statement report. A separate report should be generated for each IC++ transaction."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] df2:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["Defaults to ",["$","code","code-0",{"children":"ETC/UTC"}],". Defines the output timezone for all timestamps displayed in the report."]}],"\n",["$","p","p-1",{"children":["Has no effect on ",["$","code","code-0",{"children":"from"}]," or ",["$","code","code-1",{"children":"to"}]," parameters."]}]]}] df4:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Names of the columns to include in the report."}],"\n",["$","p","p-1",{"children":"If not specified, all available columns are included. An empty array returns an error."}],"\n",["$","p","p-2",{"children":["To include custom order metadata, use ",["$","code","code-0",{"children":"metadata.*"}]," with the attribute name, for example ",["$","code","code-1",{"children":"metadata.my_attribute"}],"."]}],"\n",["$","p","p-3",{"children":"Available columns:"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Column name","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"transaction_id"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["Unique identifier of the ledger transaction. Matches ",["$","code","code-0",{"children":"transaction_id"}]," in the settlement and payout reports. Use ",["$","code","code-1",{"children":"order_id"}]," to cross-reference with the payments report."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"related_transaction_id"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["For refund and chargeback transactions, the ledger transaction ID of the original payment. Corresponds to ",["$","code","code-0",{"children":"original_transaction_id"}]," in the payout report."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"transaction_description"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Description of the transaction.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"payout_id"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Unique identifier of the payout that this transaction contributed to.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-4",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"dispute_id"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Unique identifier of the dispute associated with this transaction, if applicable.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-5",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"account_id"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Unique identifier of the merchant account.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-6",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"account_balance"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Account balance at the time of the transaction.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-7",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"order_id"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Unique identifier of the order. Use to cross-reference with the payments or payout reports.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-8",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"original_order_id"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["For refunds and chargebacks, the order ID of the original payment. For settlement transactions, matches ",["$","code","code-0",{"children":"order_id"}],"."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"$Le4e","$Le4f","$Le50","$Le51","$Le52","$Le53","$Le54","$Le55","$Le56","$Le57","$Le58","$Le59","$Le5a","$Le5b","$Le5c","$Le5d","$Le5e","$Le5f","$Le60","$Le61","$Le62","$Le63","$Le64","$Le65","$Le66","$Le67","$Le68","$Le69","$Le6a","$Le6b","$Le6c","$Le6d","$Le6e","$Le6f","$Le70","$Le71","$Le72","$Le73","$Le74","$Le75","$Le76","$Le77","$Le78","$Le79","$Le7a","$Le7b","$Le7c","$Le7d","$Le7e","$Le7f","$Le80","$Le81","$Le82","$Le83","$Le84","$Le85"],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] df5:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Further options to customise the report."}]]}] df6:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A custom report contains all the query information for generating reports of selected transactions associated with a Merchant account."}]]}] df7:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["This parameter specifies the start boundary for filtering report data. It accepts ETC/UTC date and time in ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_8601","target":"_blank","rel":"noreferrer","children":"ISO 8601 format"}]," and includes all matching records on or after this timestamp."]}],"\n",["$","p","p-1",{"children":["Combined with the ",["$","code","code-0",{"children":"to"}]," parameter, this determines the report's timeframe, including all matching records between the two values."]}],"\n",["$","p","p-2",{"children":["For example, by setting the ",["$","code","code-0",{"children":"from"}]," parameter to ",["$","code","code-1",{"children":"2021-01-01T00:00:00Z"}],", the report will include matching records from the first second of January 1, 2021, UTC, and onwards."]}]]}] df8:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["This parameter specifies the end boundary for filtering report data. It accepts ETC/UTC date and time in ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_8601","target":"_blank","rel":"noreferrer","children":"ISO 8601 format"}]," and includes all matching records before this timestamp (exclusive)."]}],"\n",["$","p","p-1",{"children":["Combined with the ",["$","code","code-0",{"children":"from"}]," parameter, this determines the timeframe for the report, including all matching records between the two values."]}],"\n",["$","p","p-2",{"children":["For example, setting the ",["$","code","code-0",{"children":"to"}]," parameter to ",["$","code","code-1",{"children":"2021-12-31T23:59:59Z"}]," will include all matching records in the report up to, but not including, the last second of December 31, 2021, UTC."]}]]}] df9:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Select payments by state to be included in the report."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Value","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"completed"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Include payments that completed successfully.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"failed"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Include payments that failed during processing.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"declined"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Include payments rejected by the issuer or payment flow.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"cancelled"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Include payments cancelled before completion.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}],"\n",["$","p","p-1",{"children":"If not provided, payments in all states will be included in the report."}]]}] dfa:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Filtering parameters to be applied to the report."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For ",["$","code","code-0",{"children":"payments_report"}],", ",["$","code","code-1",{"children":"from"}]," and ",["$","code","code-2",{"children":"to"}]," are evaluated against the payment ",["$","code","code-3",{"children":"created_date"}],". The ",["$","code","code-4",{"children":"captured_date"}]," column is returned data and does not change the filter key."]}]}]]}]]}] dfb:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Format of the generated report file."}]]}] dfd:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Type of the report."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Report type","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"settlement_report"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"All settled transactions associated with a Merchant account, with a configurable set of columns.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"custom_report"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Settled and processing transactions associated with a Merchant account, with a configurable set of columns.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"payments_report"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["Payments report provides details of all payments associated with a Merchant account, including failed and declined payments. Supports filtering by ",["$","code","code-0",{"children":"from"}]," and ",["$","code","code-1",{"children":"to"}]," creation timestamps, and optionally by ",["$","code","code-2",{"children":"entity_states"}],"."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"payout_statement_report"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["Payout statement Reports provide a detailed breakdown of all transactions contributing to a specific payout amount. It requires the additional parameter ",["$","code","code-0",{"children":"filter.payout_id"}],", which should be obtained from the payout ID retrieved via the ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#retrieve-payout-list","target":"_blank","rel":"noreferrer","children":"payout list endpoint"}]," or from ",["$","a","a-1",{"href":"https://developer.revolut.com/docs/api/merchant#create-webhook#callbacks","target":"_blank","rel":"noreferrer","children":"webhook events"}],"."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-4",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"icpp_fee_breakdown_report"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["IC++ fee breakdown reports provide a detailed breakdown of fees for each IC++ transaction related to a payout. It requires the additional parameter ",["$","code","code-0",{"children":"filter.icpp_charge_id"}],", which should be obtained from the ",["$","code","code-1",{"children":"related_icpp_charge_id"}]," column in the Payout statement report. A separate report should be generated for each IC++ transaction."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] dfe:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["Defaults to ",["$","code","code-0",{"children":"ETC/UTC"}],". Defines the output timezone for all timestamps displayed in the report."]}],"\n",["$","p","p-1",{"children":["Has no effect on ",["$","code","code-0",{"children":"from"}]," or ",["$","code","code-1",{"children":"to"}]," parameters."]}]]}] e00:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Names of the columns to be included in the report."}],"\n",["$","p","p-1",{"children":["If the ",["$","code","code-0",{"children":"columns"}]," parameter is not defined in the request, all available columns will be included in the report. An empty array will return an error."]}],"\n",["$","p","p-2",{"children":"Available columns:"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Column name","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"payment_id"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Unique identifier of the payment.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"type"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["Category of the payment row, indicating whether the row represents a payment attempt or a refund. For the full list of returned values, see ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#download-report-file","target":"_blank","rel":"noreferrer","children":"Download report file"}],"."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"description"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Description of the payment.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"original_payment_id"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"For refunds, the unique identifier of the original payment.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-4",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"order_id"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Unique identifier of the order associated with the payment.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-5",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"state"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["Lifecycle state of the payment. For the full list of returned values, see ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#download-report-file","target":"_blank","rel":"noreferrer","children":"Download report file"}],"."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-6",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"reason"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["Reason for a failed or declined payment, for example: ",["$","code","code-0",{"children":"Insufficient Funds"}],"."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-7",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"amount"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Total amount of the payment.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-8",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"currency"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["The ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_4217","target":"_blank","rel":"noreferrer","children":"ISO 4217"}]," currency code of the payment."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-9",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"surcharge_amount"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Surcharge amount applied to the payment, if any.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-10",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"tip_amount"}],"className":"eowryt7","ref":"$undefined"}],"$Le86"],"className":"eowryt5","ref":"$undefined"}],"$Le87","$Le88","$Le89","$Le8a","$Le8b","$Le8c","$Le8d","$Le8e","$Le8f","$Le90","$Le91","$Le92","$Le93","$Le94","$Le95"],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] e01:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Further options to customise the report."}]]}] e02:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A payments report contains all the query information for generating reports of payments associated with a Merchant account, including failed and declined payments."}]]}] e03:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Permanent payout ID used for payouts operations."}]]}] e04:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Filtering parameters to be applied to the report."}]]}] e05:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Format of the generated report file."}]]}] e07:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Type of the report."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Report type","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"settlement_report"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"All settled transactions associated with a Merchant account, with a configurable set of columns.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"custom_report"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Settled and processing transactions associated with a Merchant account, with a configurable set of columns.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"payments_report"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["Payments report provides details of all payments associated with a Merchant account, including failed and declined payments. Supports filtering by ",["$","code","code-0",{"children":"from"}]," and ",["$","code","code-1",{"children":"to"}]," creation timestamps, and optionally by ",["$","code","code-2",{"children":"entity_states"}],"."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"payout_statement_report"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["Payout statement Reports provide a detailed breakdown of all transactions contributing to a specific payout amount. It requires the additional parameter ",["$","code","code-0",{"children":"filter.payout_id"}],", which should be obtained from the payout ID retrieved via the ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#retrieve-payout-list","target":"_blank","rel":"noreferrer","children":"payout list endpoint"}]," or from ",["$","a","a-1",{"href":"https://developer.revolut.com/docs/api/merchant#create-webhook#callbacks","target":"_blank","rel":"noreferrer","children":"webhook events"}],"."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-4",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"icpp_fee_breakdown_report"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["IC++ fee breakdown reports provide a detailed breakdown of fees for each IC++ transaction related to a payout. It requires the additional parameter ",["$","code","code-0",{"children":"filter.icpp_charge_id"}],", which should be obtained from the ",["$","code","code-1",{"children":"related_icpp_charge_id"}]," column in the Payout statement report. A separate report should be generated for each IC++ transaction."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] e08:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["Defaults to ",["$","code","code-0",{"children":"ETC/UTC"}],". Defines the output timezone for all timestamps displayed in the report."]}],"\n",["$","p","p-1",{"children":["Has no effect on ",["$","code","code-0",{"children":"from"}]," or ",["$","code","code-1",{"children":"to"}]," parameters."]}]]}] e0a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Names of the columns to be included in the report."}],"\n",["$","p","p-1",{"children":["If the ",["$","code","code-0",{"children":"columns"}]," parameter is not defined in the request, all available columns will be included in the report. An empty array will return an error."]}],"\n",["$","p","p-2",{"children":"Available columns:"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Column name","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"created_date"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Date and time the transaction was created.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"completed_date"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Date and time the transaction was completed.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"payout_affected_date"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Date and time the payout was affected by this transaction.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"affected_payout_amount"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["Boolean flag indicating whether this transaction contributed to the payout amount (",["$","code","code-0",{"children":"true"}],") or not (",["$","code","code-1",{"children":"false"}],"). Despite the name, this is not a monetary value."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-4",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"transaction_id"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Unique identifier of the transaction.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-5",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"order_id"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Unique identifier of the order associated with the transaction.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-6",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"dispute_id"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Unique identifier of the dispute associated with a chargeback or chargeback reversal transaction. Empty for rows not related to a dispute.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-7",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"merchant_order_reference"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["Merchant's order reference. The value of the ",["$","code","code-0",{"children":"merchant_order_data.reference"}]," field set when the order was created."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-8",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"type"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["Type of the payout-related ledger event the row represents. For the full list of returned values, see ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#download-report-file","target":"_blank","rel":"noreferrer","children":"Download report file"}],"."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-9",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"related_icpp_charge_id"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Unique identifier of the IC++ charge related to the transaction, if applicable.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"$Le96","$Le97","$Le98","$Le99","$Le9a","$Le9b","$Le9c","$Le9d","$Le9e","$Le9f","$Lea0","$Lea1","$Lea2","$Lea3","$Lea4","$Lea5","$Lea6","$Lea7","$Lea8","$Lea9","$Leaa"],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] e0b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Further options to customise the report."}]]}] e0c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A payout statement report contains all the query information for generating reports of a selected payout associated with a Merchant account."}]]}] e0d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Permanent ID of of the IC++ fee related to a payout transaction."}],"\n",["$","p","p-1",{"children":["This ID can be obtained from the ",["$","code","code-0",{"children":"related_icpp_charge_id"}]," column of a payout statement report."]}]]}] e0e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Filtering parameters to be applied to the report."}]]}] e0f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Format of the generated report file."}]]}] e11:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Type of the report."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Report type","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"settlement_report"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"All settled transactions associated with a Merchant account, with a configurable set of columns.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"custom_report"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Settled and processing transactions associated with a Merchant account, with a configurable set of columns.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"payments_report"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["Payments report provides details of all payments associated with a Merchant account, including failed and declined payments. Supports filtering by ",["$","code","code-0",{"children":"from"}]," and ",["$","code","code-1",{"children":"to"}]," creation timestamps, and optionally by ",["$","code","code-2",{"children":"entity_states"}],"."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"payout_statement_report"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["Payout statement Reports provide a detailed breakdown of all transactions contributing to a specific payout amount. It requires the additional parameter ",["$","code","code-0",{"children":"filter.payout_id"}],", which should be obtained from the payout ID retrieved via the ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#retrieve-payout-list","target":"_blank","rel":"noreferrer","children":"payout list endpoint"}]," or from ",["$","a","a-1",{"href":"https://developer.revolut.com/docs/api/merchant#create-webhook#callbacks","target":"_blank","rel":"noreferrer","children":"webhook events"}],"."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-4",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"icpp_fee_breakdown_report"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["IC++ fee breakdown reports provide a detailed breakdown of fees for each IC++ transaction related to a payout. It requires the additional parameter ",["$","code","code-0",{"children":"filter.icpp_charge_id"}],", which should be obtained from the ",["$","code","code-1",{"children":"related_icpp_charge_id"}]," column in the Payout statement report. A separate report should be generated for each IC++ transaction."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] e12:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["Defaults to ",["$","code","code-0",{"children":"ETC/UTC"}],". Defines the output timezone for all timestamps displayed in the report."]}],"\n",["$","p","p-1",{"children":["Has no effect on ",["$","code","code-0",{"children":"from"}]," or ",["$","code","code-1",{"children":"to"}]," parameters."]}]]}] e14:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Names of the columns to be included in the report."}],"\n",["$","p","p-1",{"children":["If the ",["$","code","code-0",{"children":"columns"}]," parameter is not defined in the request, all available columns will be included in the report. An empty array will return an error."]}],"\n",["$","p","p-2",{"children":"Available columns:"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Column name","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"id"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Unique identifier of the payment.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"created_at"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Date and time the payment was created.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"operation"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["IC++ transaction type. Values: ",["$","code","code-0",{"children":"SALE"}]," (payment sale), ",["$","code","code-1",{"children":"REFUND"}]," (refund), and ",["$","code","code-2",{"children":"DISPUTE"}]," (dispute-related transaction)."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"amount"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Transaction amount.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-4",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"currency"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["The ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_4217","target":"_blank","rel":"noreferrer","children":"ISO 4217"}]," currency code of the transaction."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-5",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"settlement_amount"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Amount settled on the merchant's account.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-6",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"settlement_currency"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["The ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_4217","target":"_blank","rel":"noreferrer","children":"ISO 4217"}]," currency code of the settled amount."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-7",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"payment_method"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["Payment method used for the transaction. Returns ",["$","code","code-0",{"children":"REVOLUT_PAY"}]," for Revolut Pay payments, or the card scheme name for card payments."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-8",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"card_scheme"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Card BIN scheme.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-9",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"card_funding"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["Card funding type, for example: ",["$","code","code-0",{"children":"DEBIT"}]," or ",["$","code","code-1",{"children":"PREPAID"}],"."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-10",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"order_description"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Description of the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-11",{"children":["$Leab","$Leac"],"className":"eowryt5","ref":"$undefined"}],"$Lead","$Leae","$Leaf","$Leb0","$Leb1","$Leb2","$Leb3"],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] e15:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Further options to customise the report."}]]}] e16:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A IC++ fee breakdown report contains all the query information for generating reports of fees for each IC++ transaction related to a payout."}]]}] e1a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Start generating a report of all transactions that match the filter and options specified in the request body."}],"\n",["$","p","p-1",{"children":["Use the returned ",["$","code","code-0",{"children":"report_run_id"}]," and the ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#retrieve-report-run","target":"_blank","rel":"noreferrer","children":"Retrieve report run details"}]," operation to check the status of the generation."]}],"\n",["$","p","p-2",{"children":["After generation is done, use the ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#download-report-file","target":"_blank","rel":"noreferrer","children":"Download report file"}]," operation to retrieve the CSV. The ",["$","code","code-0",{"children":"file_url"}]," in the completed report run object is the request URL for that endpoint and requires the same authorisation as any other Merchant API request."]}],"\n",["$","h3","h3-0",{"children":"Report types"}],"\n",["$","p","p-3",{"children":"The table below helps to choose the right report type for your use case:"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Report type","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"What it covers","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"custom_report"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Settled and processing transactions with configurable columns","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"settlement_report"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"All settled transactions, with a configurable set of columns","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"payments_report"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"All payments including failed and declined ones","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"payout_statement_report"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"All transactions contributing to a specific payout","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-4",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"icpp_fee_breakdown_report"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"IC++ fees per transaction for a specific IC++ charge","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}],"\n",["$","h5","h5-0",{"children":"IDs across report types"}],"\n",["$","p","p-4",{"children":"Each report type uses a different primary ID, depending on which system the data comes from:"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-1",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"ID column","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"System","className":"eowryt6","ref":"$undefined"}],["$","th","th-2",{"children":"Report types","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":[["$","code","code-0",{"children":"payment_id"}],", ",["$","code","code-1",{"children":"id"}]],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":[["$","strong","strong-0",{"children":"Acquiring system"}]," - identifies a payment attempt"],"className":"eowryt7","ref":"$undefined"}],["$","td","td-2",{"children":[["$","code","code-0",{"children":"payments_report"}],", ",["$","code","code-1",{"children":"icpp_fee_breakdown_report"}]],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"$Leb4","$Leb5"],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] e1b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["This parameter accepts the ",["$","a","a-0",{"href":"https://business.revolut.com/settings/apis?tab=merchant-api","target":"_blank","rel":"noreferrer","children":"Merchant API Secret key"}]," to authorise requests coming from the merchant's backend."]}],"\n",["$","p","p-1",{"children":["It ensures that ensures that each request is authenticated and authorised by verifying the secret key. The secret key should be included in all request headers as a ",["$","code","code-0",{"children":"Bearer"}]," token."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#authentication","target":"_blank","rel":"noreferrer","children":"Authentication"}]]}]}]]}]]}] eb6:Tf8a,{ "orders": [ { "id": "a1b2c3d4-0001-0000-0000-000000000001", "token": "b2c3d4e5-0001-0000-0000-000000000001", "type": "payment", "state": "completed", "created_at": "2025-03-10T08:30:00Z", "updated_at": "2025-03-10T08:32:15Z", "amount": 4999, "currency": "GBP", "outstanding_amount": 0, "capture_mode": "automatic", "enforce_challenge": "automatic", "description": "Premium subscription", "customer": { "id": "c3d4e5f6-0001-0000-0000-000000000001", "email": "jane.doe@example.com", "full_name": "Jane Doe", "phone": "+441234567890" } }, { "id": "a1b2c3d4-0002-0000-0000-000000000002", "token": "b2c3d4e5-0002-0000-0000-000000000002", "type": "payment", "state": "completed", "created_at": "2025-03-11T09:00:00Z", "updated_at": "2025-03-11T09:01:45Z", "amount": 12500, "currency": "EUR", "outstanding_amount": 0, "capture_mode": "automatic", "enforce_challenge": "automatic", "description": "Shopping cart", "customer": { "id": "c3d4e5f6-0002-0000-0000-000000000002", "email": "john.smith@example.com", "full_name": "John Smith" }, "line_items": [ { "name": "Wireless headphones", "quantity": 1, "unit_price": 9900, "total_amount": 9900 }, { "name": "Phone case", "quantity": 2, "unit_price": 1300, "total_amount": 2600 } ] }, { "id": "a1b2c3d4-0003-0000-0000-000000000003", "type": "refund", "state": "completed", "created_at": "2025-03-12T11:15:00Z", "updated_at": "2025-03-12T11:16:30Z", "amount": 4999, "currency": "GBP", "outstanding_amount": 0, "capture_mode": "automatic", "enforce_challenge": "automatic", "related_order_id": "a1b2c3d4-0001-0000-0000-000000000001", "merchant_order_data": { "order_id": "ORD-2025-001", "description": "Customer-requested refund" } }, { "id": "a1b2c3d4-0004-0000-0000-000000000004", "token": "b2c3d4e5-0004-0000-0000-000000000004", "type": "payment", "state": "authorised", "created_at": "2025-03-13T14:00:00Z", "updated_at": "2025-03-13T14:00:30Z", "amount": 35000, "currency": "USD", "outstanding_amount": 35000, "capture_mode": "manual", "enforce_challenge": "automatic", "description": "Enterprise software licence", "cancel_authorised_after": "2025-03-20T14:00:00Z", "customer": { "id": "c3d4e5f6-0003-0000-0000-000000000003", "email": "alex.johnson@example.com", "full_name": "Alex Johnson" } }, { "id": "a1b2c3d4-0005-0000-0000-000000000005", "token": "b2c3d4e5-0005-0000-0000-000000000005", "type": "payment", "state": "completed", "created_at": "2025-03-14T16:45:00Z", "updated_at": "2025-03-14T16:46:00Z", "amount": 799, "currency": "GBP", "outstanding_amount": 0, "capture_mode": "automatic", "enforce_challenge": "automatic", "description": "Coffee and pastry", "location_id": "d4e5f6a7-0001-0000-0000-000000000001" }, { "id": "a1b2c3d4-0006-0000-0000-000000000006", "token": "b2c3d4e5-0006-0000-0000-000000000006", "type": "payment", "state": "completed", "created_at": "2025-03-15T09:00:00Z", "updated_at": "2025-03-15T09:01:00Z", "amount": 1999, "currency": "GBP", "outstanding_amount": 0, "capture_mode": "automatic", "enforce_challenge": "automatic", "subscription_data": { "subscription_id": "e2862e0e-66e8-4623-bdd6-7da59b85365d", "active_cycle_id": "a1b2c3d4-5678-9012-abcd-ef1234567890", "billing_reason": "cycle_billing" } } ] }e3b:["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"$eb6"}]}] e3e:["$","tr","tr-8",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"type"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["Settlement report row type. A partial-settlement is represented by separate ",["$","code","code-0",{"children":"SETTLEMENT"}]," and ",["$","code","code-1",{"children":"REFUND"}]," rows, not a dedicated type."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}] e3f:["$","tr","tr-9",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"state"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"State of the transaction.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}] e40:["$","tr","tr-10",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"description"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Description of the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}] e41:["$","tr","tr-11",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"merchant_order_ext_ref"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["Merchant's order reference. The value of the ",["$","code","code-0",{"children":"merchant_order_data.reference"}]," field set when the order was created."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}] e42:["$","tr","tr-12",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"customer_id"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Unique identifier of the customer.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}] e43:["$","tr","tr-13",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"amount"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Total amount of the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}] e44:["$","tr","tr-14",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"currency"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["The ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_4217","target":"_blank","rel":"noreferrer","children":"ISO 4217"}]," currency code of the order."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}] e45:["$","tr","tr-15",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"settlement_amount"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Total amount settled on the merchant's account.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}] e46:["$","tr","tr-16",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"settlement_currency"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["The ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_4217","target":"_blank","rel":"noreferrer","children":"ISO 4217"}]," currency code of the settled amount."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}] e47:["$","tr","tr-17",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"payment_method"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Type of the payment method the customer used to pay for the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}] e48:["$","tr","tr-18",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"fee_amount"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Total fee amount applied to the order, aggregated across all fee components (acquiring markup + interchange + scheme fees).","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}] e49:["$","tr","tr-19",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"fee_currency"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["The ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_4217","target":"_blank","rel":"noreferrer","children":"ISO 4217"}]," currency code of the total fee."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}] e4a:["$","tr","tr-20",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"processing_fee_amount"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["Acquiring markup fee only — a subset of ",["$","code","code-0",{"children":"fee_amount"}],". Represents Revolut's service fee, excluding interchange and scheme fees."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}] e4b:["$","tr","tr-21",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"processing_fee_currency"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["The ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_4217","target":"_blank","rel":"noreferrer","children":"ISO 4217"}]," currency code of the acquiring markup fee."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}] e4c:["$","tr","tr-22",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"browser_url"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The URL where the customer initiated the payment.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}] e4d:["$","tr","tr-23",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"location_id"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Unique identifier of the location related to the transaction.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}] e4e:["$","tr","tr-9",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"original_order_ext_ref"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Merchant's order identifier of the original order for external reference.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}] e4f:["$","tr","tr-10",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"order_description"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Description of the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}] e50:["$","tr","tr-11",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"order_channel"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Channel through which the order was created.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}] e51:["$","tr","tr-12",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"order_customer_note"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Note added by the customer at the time of the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}] e52:["$","tr","tr-13",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"order_tip_amount"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Tip amount set at the order level.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}] e53:["$","tr","tr-14",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"order_created_by"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Identifier of the user who created the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}] e54:["$","tr","tr-15",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"payment_initiated_by"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Identifier of who initiated the payment.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}] e55:["$","tr","tr-16",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"order_line_items"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Line items included in the order, if any.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}] e56:["$","tr","tr-17",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"payout_reference"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Reference of the payout transfer associated with the transaction.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}] e57:["$","tr","tr-18",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"invoice_reference"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Invoice reference associated with the order, if any.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}] e58:["$","tr","tr-19",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"started_date"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Start timestamp shown on the row. For payment rows, this is the payment start timestamp. For non-payment rows such as refunds and chargebacks, this is the transaction start timestamp. Separate from the report filter timeframe.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}] e59:["$","tr","tr-20",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"created_date"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Date and time the order was created.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}] e5a:["$","tr","tr-21",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"updated_date"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Last update timestamp shown on the row. For payment rows, this is the payment update timestamp. For non-payment rows such as refunds and chargebacks, this is the transaction update timestamp. Separate from the report filter timeframe.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}] e5b:["$","tr","tr-22",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"completed_date"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Completion timestamp shown on the row. For payment rows, this is the payment completion timestamp. For non-payment rows such as refunds and chargebacks, this is the transaction completion timestamp. Separate from the report filter timeframe.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}] e5c:["$","tr","tr-23",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"payment_created_date"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Payment authorisation or creation timestamp for rows linked to a payment. Empty for refunds and non-payment-related rows where no payment timestamp applies. This is returned data, not the report filter key.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}] e5d:["$","tr","tr-24",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"payment_captured_date"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Payment capture timestamp for rows linked to a captured payment. Empty for refunds, non-payment-related rows, or payments not captured. This is returned data, not the report filter key.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}] e5e:["$","tr","tr-25",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"type"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["Category of the reported transaction row, indicating what kind of balance-affecting event the row represents. For the full list of returned values, see ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#download-report-file","target":"_blank","rel":"noreferrer","children":"Download report file"}],"."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}] e5f:["$","tr","tr-26",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"legacy_type"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Legacy type value for backwards compatibility.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}] e60:["$","tr","tr-27",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"state"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"State of the transaction.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}] e61:["$","tr","tr-28",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"description"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Description of the transaction.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}] e62:["$","tr","tr-29",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"merchant_order_ext_ref"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["Merchant's order reference. The value of the ",["$","code","code-0",{"children":"merchant_order_data.reference"}]," field set when the order was created."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}] e63:["$","tr","tr-30",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"customer_id"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Unique identifier of the customer.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}] e64:["$","tr","tr-31",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"amount"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Total amount of the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}] e65:["$","tr","tr-32",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"currency"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["The ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_4217","target":"_blank","rel":"noreferrer","children":"ISO 4217"}]," currency code of the order."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}] e66:["$","tr","tr-33",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"settlement_amount"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Total amount settled on the merchant's account.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}] e67:["$","tr","tr-34",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"settlement_currency"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["The ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_4217","target":"_blank","rel":"noreferrer","children":"ISO 4217"}]," currency code of the settled amount."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}] e68:["$","tr","tr-35",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"exchange_rate"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Exchange rate applied if currency conversion occurred.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}] e69:["$","tr","tr-36",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"refunded_amount"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Amount refunded for the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}] e6a:["$","tr","tr-37",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"statement_descriptor"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Statement descriptor shown on the customer's bank statement.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}] e6b:["$","tr","tr-38",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"tip_amount"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Tip amount included in the transaction.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}] e6c:["$","tr","tr-39",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"terminal_hardware_id"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Identifier of the card reader hardware used, for in-person payments.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}] e6d:["$","tr","tr-40",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"customer_name"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Name of the customer.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}] e6e:["$","tr","tr-41",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"customer_email"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Email address of the customer.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}] e6f:["$","tr","tr-42",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"customer_card_number"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Masked card number used for the payment.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}] e70:["$","tr","tr-43",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"customer_card_brand"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["Card brand used for the payment. Derived from BIN data. Example values: ",["$","code","code-0",{"children":"VISA"}],", ",["$","code","code-1",{"children":"MASTERCARD"}],", ",["$","code","code-2",{"children":"MASTERCARD_DEBIT"}],", ",["$","code","code-3",{"children":"MAESTRO"}],", ",["$","code","code-4",{"children":"AMEX"}],", ",["$","code","code-5",{"children":"DINERS"}],", ",["$","code","code-6",{"children":"DISCOVER"}],", ",["$","code","code-7",{"children":"JCB"}],"."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}] e71:["$","tr","tr-44",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"customer_card_type"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["Card funding type of the card used for the payment, for example debit, credit, prepaid, deferred debit, or charge. For the full list of returned values, see ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#download-report-file","target":"_blank","rel":"noreferrer","children":"Download report file"}],"."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}] e72:["$","tr","tr-45",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"customer_card_category"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["Card commercial category. Values: ",["$","code","code-0",{"children":"consumer"}]," (personal card) and ",["$","code","code-1",{"children":"commercial"}]," (business or corporate card)."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}] e73:["$","tr","tr-46",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"payment_method"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Payment method the customer used to pay for the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}] e74:["$","tr","tr-47",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"fee_amount"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Total fee amount applied to the order, aggregated across all fee components (acquiring markup + interchange + scheme fees).","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}] e75:["$","tr","tr-48",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"fee_currency"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["The ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_4217","target":"_blank","rel":"noreferrer","children":"ISO 4217"}]," currency code of the total fee."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}] e76:["$","tr","tr-49",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"processing_fee_amount"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["Acquiring markup fee only — a subset of ",["$","code","code-0",{"children":"fee_amount"}],". Represents Revolut's service fee, excluding interchange and scheme fees."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}] e77:["$","tr","tr-50",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"processing_fee_currency"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["The ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_4217","target":"_blank","rel":"noreferrer","children":"ISO 4217"}]," currency code of the acquiring markup fee."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}] e78:["$","tr","tr-51",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"fx_fee_amount"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Foreign exchange fee amount, if applicable.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}] e79:["$","tr","tr-52",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"fx_fee_currency"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["The ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_4217","target":"_blank","rel":"noreferrer","children":"ISO 4217"}]," currency code of the FX fee."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}] e7a:["$","tr","tr-53",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"browser_url"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The URL where the customer initiated the payment.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}] e7b:["$","tr","tr-54",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"beneficiary_name"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Name of the beneficiary, for bank transfer payments.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}] e7c:["$","tr","tr-55",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"beneficiary_account_number"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Account number of the beneficiary, for bank transfer payments.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}] e7d:["$","tr","tr-56",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"location_id"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Unique identifier of the location related to the transaction.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}] e7e:["$","tr","tr-57",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"location_name"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Name of the location related to the transaction.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}] e7f:["$","tr","tr-58",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"surcharge_amount"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Surcharge amount applied to the transaction. Omitted when no surcharge applies.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}] e80:["$","tr","tr-59",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"order_surcharge_amount"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Surcharge amount set at the order level.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}] e81:["$","tr","tr-60",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"order_custom_field_name"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Name of a custom field set on the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}] e82:["$","tr","tr-61",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"order_custom_field_value"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Value of a custom field set on the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}] e83:["$","tr","tr-62",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"offline_payment_state"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"State of an offline payment, if applicable.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}] e84:["$","tr","tr-63",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"order_authorisation_type"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["Authorisation type of the order, for example ",["$","code","code-0",{"children":"FULL"}]," or ",["$","code","code-1",{"children":"PRE_AUTH"}],"."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}] e85:["$","tr","tr-64",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"metadata.*"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["Custom order metadata. Replace ",["$","code","code-0",{"children":"*"}]," with the attribute name, for example ",["$","code","code-1",{"children":"metadata.my_attribute"}],"."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}] e86:["$","td","td-1",{"children":"Tip amount included in the payment, if any.","className":"eowryt7","ref":"$undefined"}] e87:["$","tr","tr-11",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"refunded_amount"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Amount refunded for the payment.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}] e88:["$","tr","tr-12",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"created_date"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Date and time the payment was created.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}] e89:["$","tr","tr-13",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"captured_date"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Date and time the payment was captured. Empty when the payment has not been captured.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}] e8a:["$","tr","tr-14",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"merchant_order_ext_ref"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["Merchant's order reference. The value of the ",["$","code","code-0",{"children":"merchant_order_data.reference"}]," field set when the order was created."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}] e8b:["$","tr","tr-15",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"payment_method"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["Payment method used, for example: ",["$","code","code-0",{"children":"CARD"}]," or ",["$","code","code-1",{"children":"PAY_WITH_REVOLUT"}],"."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}] e8c:["$","tr","tr-16",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"location_id"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Unique identifier of the location where the payment was made.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}] e8d:["$","tr","tr-17",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"customer_id"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Unique identifier of the customer.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}] e8e:["$","tr","tr-18",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"customer_card_number"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Masked card number used for the payment.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}] e8f:["$","tr","tr-19",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"customer_card_country"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["Country of the card used for the payment, as an ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2","target":"_blank","rel":"noreferrer","children":"ISO 3166-1 alpha-2"}]," code."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}] e90:["$","tr","tr-20",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"customer_card_brand"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["Card brand used for the payment, for example: ",["$","code","code-0",{"children":"VISA"}]," or ",["$","code","code-1",{"children":"MASTERCARD_DEBIT"}],"."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}] e91:["$","tr","tr-21",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"customer_card_type"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["Card funding type of the card used for the payment. For the full list of returned values, see ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#download-report-file","target":"_blank","rel":"noreferrer","children":"Download report file"}],"."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}] e92:["$","tr","tr-22",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"customer_card_category"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["Card commercial category. Values: ",["$","code","code-0",{"children":"consumer"}]," (personal card) and ",["$","code","code-1",{"children":"commercial"}]," (business or corporate card)."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}] e93:["$","tr","tr-23",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"customer_email"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Email address of the customer.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}] e94:["$","tr","tr-24",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"fee_amount"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Total fee amount charged for the payment.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}] e95:["$","tr","tr-25",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"fee_currency"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["The ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_4217","target":"_blank","rel":"noreferrer","children":"ISO 4217"}]," currency code of the fee."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}] e96:["$","tr","tr-10",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"transaction_amount"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Amount of the transaction in the transaction currency.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}] e97:["$","tr","tr-11",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"transaction_currency"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["The ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_4217","target":"_blank","rel":"noreferrer","children":"ISO 4217"}]," currency code of the transaction."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}] e98:["$","tr","tr-12",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"billing_amount"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Amount of the transaction in the billing currency.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}] e99:["$","tr","tr-13",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"billing_currency"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["The ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_4217","target":"_blank","rel":"noreferrer","children":"ISO 4217"}]," currency code of the billing amount."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}] e9a:["$","tr","tr-14",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"state"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["State of the transaction, for example: ",["$","code","code-0",{"children":"COMPLETED"}],"."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}] e9b:["$","tr","tr-15",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"original_transaction_id"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Unique identifier of the original transaction. For refunds, references the transaction being refunded.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}] e9c:["$","tr","tr-16",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"original_transaction_amount"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Amount of the original transaction.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}] e9d:["$","tr","tr-17",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"original_transaction_currency"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["The ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_4217","target":"_blank","rel":"noreferrer","children":"ISO 4217"}]," currency code of the original transaction."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}] e9e:["$","tr","tr-18",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"original_order_id"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Unique identifier of the original order. For refunds, references the order being refunded.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}] e9f:["$","tr","tr-19",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"original_order_channel"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Channel through which the original order was created.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}] ea0:["$","tr","tr-20",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"original_merchant_order_reference"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["Merchant's order reference for the original order. The value of the ",["$","code","code-0",{"children":"merchant_order_data.reference"}]," field set when the original order was created."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}] ea1:["$","tr","tr-21",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"fee_amount"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Total fee amount charged for the transaction.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}] ea2:["$","tr","tr-22",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"fee_currency"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["The ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_4217","target":"_blank","rel":"noreferrer","children":"ISO 4217"}]," currency code of the fee."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}] ea3:["$","tr","tr-23",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"settlement_amount"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Total amount settled on the merchant's account.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}] ea4:["$","tr","tr-24",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"settlement_currency"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["The ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_4217","target":"_blank","rel":"noreferrer","children":"ISO 4217"}]," currency code of the settled amount."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}] ea5:["$","tr","tr-25",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"location_id"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Unique identifier of the location associated with the transaction.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}] ea6:["$","tr","tr-26",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"location_name"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Name of the location associated with the transaction.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}] ea7:["$","tr","tr-27",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"submerchant_id"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Unique identifier of the submerchant associated with the transaction.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}] ea8:["$","tr","tr-28",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"payout_transfer_reference"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Reference of the bank transfer for this payout. This value is the same across all rows in the report, as each report covers a single payout.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}] ea9:["$","tr","tr-29",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"payout_total_amount"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Total amount of this payout. This value is the same across all rows in the report, as each report covers a single payout.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}] eaa:["$","tr","tr-30",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"payout_date"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Date and time the payout covered by this report was created. This value is the same across all rows in the report, as each report covers a single payout.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}] eab:["$","td","td-0",{"children":["$","code","code-0",{"children":"order_merchant_external_ref"}],"className":"eowryt7","ref":"$undefined"}] eac:["$","td","td-1",{"children":["Merchant's order reference. The value of the ",["$","code","code-0",{"children":"merchant_order_data.reference"}]," field set when the order was created."],"className":"eowryt7","ref":"$undefined"}] ead:["$","tr","tr-12",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"original_operation_id"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Unique identifier of the related original transaction.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}] eae:["$","tr","tr-13",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"acquiring_fee_amount"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"IC++ acquiring markup fee component.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}] eaf:["$","tr","tr-14",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"card_interchange_fee_amount"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Interchange fee component. Omitted for Revolut Pay transactions.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}] eb0:["$","tr","tr-15",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"card_scheme_fee_amount"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Card scheme fee component. Omitted for Revolut Pay transactions.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}] eb1:["$","tr","tr-16",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"card_type"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["Card commercial category. Values: ",["$","code","code-0",{"children":"COMMERCIAL"}]," (business or corporate card) and ",["$","code","code-1",{"children":"CONSUMER"}]," (personal card)."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}] eb2:["$","tr","tr-17",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"order_channel"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Channel through which the order was created.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}] eb3:["$","tr","tr-18",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"card_country"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["Country of the card, as an ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2","target":"_blank","rel":"noreferrer","children":"ISO 3166-1 alpha-2"}]," code."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}] eb4:["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"transaction_id"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":[["$","strong","strong-0",{"children":"Core ledger"}]," - identifies the settlement entry created when a payment is captured"],"className":"eowryt7","ref":"$undefined"}],["$","td","td-2",{"children":[["$","code","code-0",{"children":"settlement_report"}],", ",["$","code","code-1",{"children":"payout_statement_report"}],", ",["$","code","code-2",{"children":"custom_report"}]],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}] eb5:["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"order_id"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":[["$","strong","strong-0",{"children":"Both systems"}]," - bridges the acquiring and ledger perspectives"],"className":"eowryt7","ref":"$undefined"}],["$","td","td-2",{"children":[["$","code","code-0",{"children":"settlement_report"}],", ",["$","code","code-1",{"children":"payments_report"}],", ",["$","code","code-2",{"children":"payout_statement_report"}],", ",["$","code","code-3",{"children":"custom_report"}]],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}] e2f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Each Merchant API request must contain an authorization header in the following format:"}],"\n","$Leb7","\n",["$","p","p-1",{"children":"To use this API, you need to generate API keys from your Revolut Business account. The Secret key is used in the authorization header for all server calls, while the Public key is provided with payment methods at checkout."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For detailed instructions on generating your API keys, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/get-started#generate-api-keys","target":"_blank","rel":"noreferrer","children":"Generate API keys"}],"."]}]}]]}]]}] dcd:["$","div","CodeBlock-0",{"className":"wzy01m0 _18b50nc0","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"
'Authorization: Bearer <yourSecretApiKey>'
"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"'Authorization: Bearer '\n"}]}]]}] eb8:Tf43,
{
  "filter": {
    "from": "2020-01-01T00:00:00Z",
    "to": "2020-01-02T00:00:00Z",
    "entity_types": [
      "payment"
    ],
    "entity_states": [
      "completed",
      "processing"
    ]
  },
  "format": "csv",
  "type": "custom_report",
  "options": {
    "timezone": "Europe/London",
    "columns": [
      "transaction_id",
      "amount",
      "currency",
      "metadata.custom_attribute"
    ]
  }
}
e30:["$","div","request-application/json-custom_report",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$eb8"}}]}]],"$Leb9"]}] eba:T7c9,
{
  "filter": {
    "from": "2020-01-01T00:00:00Z",
    "to": "2020-01-02T00:00:00Z",
    "entity_types": [
      "payment"
    ]
  },
  "format": "csv",
  "type": "settlement_report"
}
e31:["$","div","request-application/json-settlement_report",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$eba"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"filter\": {\n \"from\": \"2020-01-01T00:00:00Z\",\n \"to\": \"2020-01-02T00:00:00Z\",\n \"entity_types\": [\n \"payment\"\n ]\n },\n \"format\": \"csv\",\n \"type\": \"settlement_report\"\n}"}]}]]}] ebb:T900,
{
  "filter": {
    "from": "2020-01-01T00:00:00Z",
    "to": "2020-01-02T00:00:00Z",
    "entity_states": [
      "completed",
      "failed",
      "declined"
    ]
  },
  "format": "csv",
  "type": "payments_report"
}
e32:["$","div","request-application/json-payments_report",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$ebb"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"filter\": {\n \"from\": \"2020-01-01T00:00:00Z\",\n \"to\": \"2020-01-02T00:00:00Z\",\n \"entity_states\": [\n \"completed\",\n \"failed\",\n \"declined\"\n ]\n },\n \"format\": \"csv\",\n \"type\": \"payments_report\"\n}"}]}]]}] ebc:T535,
{
  "filter": {
    "payout_id": "a830020e-090c-4717-836d-37941a27ad12"
  },
  "format": "csv",
  "type": "payout_statement_report"
}
e33:["$","div","request-application/json-payout_statement_report",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$ebc"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"filter\": {\n \"payout_id\": \"a830020e-090c-4717-836d-37941a27ad12\"\n },\n \"format\": \"csv\",\n \"type\": \"payout_statement_report\"\n}"}]}]]}] ebd:T53c,
{
  "filter": {
    "icpp_charge_id": "41d6c699-744a-4994-91c0-9227539c587f"
  },
  "format": "csv",
  "type": "icpp_fee_breakdown_report"
}
e34:["$","div","request-application/json-icpp_fee_breakdown_report",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$ebd"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"filter\": {\n \"icpp_charge_id\": \"41d6c699-744a-4994-91c0-9227539c587f\"\n },\n \"format\": \"csv\",\n \"type\": \"icpp_fee_breakdown_report\"\n}"}]}]]}] e35:["$","div","201-application/json-report_run_processing",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"
{\n  \"report_run_id\": \"d6f6ef64-f668-4e64-8967-1cdf8afb2561\",\n  \"status\": \"processing\"\n}
"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"report_run_id\": \"d6f6ef64-f668-4e64-8967-1cdf8afb2561\",\n \"status\": \"processing\"\n}"}]}]]}] ebe:T4ca,
{
  "report_run_id": "d6f6ef64-f668-4e64-8967-1cdf8afb2561",
  "status": "completed",
  "file_url": "https://merchant.revolut.com/api/report-runs/d6f6ef64-f668-4e64-8967-1cdf8afb2561/file"
}
e36:["$","div","201-application/json-report_run_completed",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$ebe"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"report_run_id\": \"d6f6ef64-f668-4e64-8967-1cdf8afb2561\",\n \"status\": \"completed\",\n \"file_url\": \"https://merchant.revolut.com/api/report-runs/d6f6ef64-f668-4e64-8967-1cdf8afb2561/file\"\n}"}]}]]}] ebf:T44d,
{
  "code": "string",
  "message": "string",
  "timestamp": 123
}
e37:["$","div","400-application/json-default",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$ebf"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"code\": \"string\",\n \"message\": \"string\",\n \"timestamp\": 123\n}"}]}]]}] ec0:T44d,
{
  "code": "string",
  "message": "string",
  "timestamp": 123
}
e38:["$","div","401-application/json-default",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$ec0"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"code\": \"string\",\n \"message\": \"string\",\n \"timestamp\": 123\n}"}]}]]}] ec1:T44d,
{
  "code": "string",
  "message": "string",
  "timestamp": 123
}
e39:["$","div","404-application/json-default",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$ec1"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"code\": \"string\",\n \"message\": \"string\",\n \"timestamp\": 123\n}"}]}]]}] eb9:["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"filter\": {\n \"from\": \"2020-01-01T00:00:00Z\",\n \"to\": \"2020-01-02T00:00:00Z\",\n \"entity_types\": [\n \"payment\"\n ],\n \"entity_states\": [\n \"completed\",\n \"processing\"\n ]\n },\n \"format\": \"csv\",\n \"type\": \"custom_report\",\n \"options\": {\n \"timezone\": \"Europe/London\",\n \"columns\": [\n \"transaction_id\",\n \"amount\",\n \"currency\",\n \"metadata.custom_attribute\"\n ]\n }\n}"}]}] 5e:["$","$7a","create-location",{"children":[["$","section",null,{"className":"y9a0do0","data-variant":"endpoint","children":["$","$L7b",null,{"responses":{"201":{"description":"Location created","content":{"application/json":{"schema":{"title":"Location","type":"object","description":"Location object represents merchant locations depending on type.","oneOf":[{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Unique ID representing the location where merchants sells products.\n\n:::info\nFor more information, see: [Locations](https://developer.revolut.com/docs/api/merchant#tag-locations).\n::: ","descriptionNode":"$Lec2"},"name":{"type":"string","description":"Name of the location. \n\n:::warning\nThe `name` parameter's value must be unique across all locations.\n:::","descriptionNode":"$Lec3"},"type":{"type":"string","description":"Type of the location.\n\n| Value | Description |\n| ----- | ----------- |\n| `online` | Represents an online store. |\n| `physical` | Represents a physical point of sale. |","enum":"$60:props:children:0:props:children:props:responses:200:content:application/json:schema:oneOf:0:properties:type:enum","descriptionNode":"$Lec4"},"details":{"type":"object","description":"Additional details of the location.","properties":{"domain":{"type":"string","description":"Domain address of the location. Required for online locations.\n\n:::warning\nThe `domain` parameter's value must be unique across all locations.\n:::","descriptionNode":"$Lec5"}},"required":"$60:props:children:0:props:children:props:responses:200:content:application/json:schema:oneOf:0:properties:details:required","descriptionNode":"$Lec6"}},"required":"$60:props:children:0:props:children:props:responses:200:content:application/json:schema:oneOf:0:required"},{"title":"Location","type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Unique ID representing the location where merchants sells products.\n\n:::info\nFor more information, see: [Locations](https://developer.revolut.com/docs/api/merchant#tag-locations).\n::: ","descriptionNode":"$Lec7"},"name":{"type":"string","description":"Name of the location. \n\n:::warning\nThe `name` parameter's value must be unique across all locations.\n:::","descriptionNode":"$Lec8"},"type":{"type":"string","description":"Type of the location.\n\n| Value | Description |\n| ----- | ----------- |\n| `online` | Represents an online store. |\n| `physical` | Represents a physical point of sale. |","enum":"$60:props:children:0:props:children:props:responses:200:content:application/json:schema:oneOf:0:properties:type:enum","descriptionNode":"$Lec9"},"details":{"type":"object","description":"Additional details of the location.","properties":{"address":{"type":"object","description":"Details of a physical address.","properties":{"street_line_1":{"type":"string","description":"Primary address line.","maxLength":100,"descriptionNode":"$Leca"},"street_line_2":{"type":"string","description":"Secondary address line, such as floor and apartment number.","maxLength":100,"descriptionNode":"$Lecb"},"region":{"type":"string","description":"State or province of the address.","maxLength":100,"descriptionNode":"$Lecc"},"city":{"type":"string","description":"City of the address.","maxLength":100,"descriptionNode":"$Lecd"},"country_code":{"type":"string","pattern":"^[A-Z]{2}$","description":"ISO 2-letter country code.","minLength":2,"maxLength":2,"descriptionNode":"$Lece"},"postcode":{"type":"string","description":"Postal code of the address.","maxLength":100,"descriptionNode":"$Lecf"}},"required":"$60:props:children:0:props:children:props:responses:200:content:application/json:schema:oneOf:1:properties:details:properties:address:required","descriptionNode":"$Led0"},"geo_location":{"type":"object","description":"Coordinates of the location.","properties":{"lat":{"type":"number","format":"double","description":"The latitude of the location, in decimal degrees.","minimum":-90,"maximum":90,"descriptionNode":"$Led1"},"lon":{"type":"number","format":"double","description":"To longitude of the location, in decimal degrees.","minimum":-180,"maximum":180,"descriptionNode":"$Led2"}},"required":"$60:props:children:0:props:children:props:responses:200:content:application/json:schema:oneOf:1:properties:details:properties:geo_location:required","descriptionNode":"$Led3"},"opening_hours":{"type":"object","description":"An object containing the opening hours for each day of the week.\n\nA day can have multiple intervals (e.g., closing for a lunch break).","properties":{"monday":{"description":"Opening hours for Monday.","type":"array","items":{"type":"object","properties":{"from":{"type":"string","format":"time","description":"The local time when the interval begins.\n\n:::note\nThe format is `hh:mm[:ss]`; seconds are optional and must be `00` if provided.\n:::","examples":"$60:props:children:0:props:children:props:responses:200:content:application/json:schema:oneOf:1:properties:details:properties:opening_hours:properties:monday:items:properties:from:examples","descriptionNode":"$Led4"},"to":{"type":"string","format":"time","description":"The local time when the interval ends.\n\n:::note\nThe format is `hh:mm[:ss]`; seconds are optional and must be `00` if provided.\n:::","examples":"$60:props:children:0:props:children:props:responses:200:content:application/json:schema:oneOf:1:properties:details:properties:opening_hours:properties:monday:items:properties:to:examples","descriptionNode":"$Led5"}},"required":"$60:props:children:0:props:children:props:responses:200:content:application/json:schema:oneOf:1:properties:details:properties:opening_hours:properties:monday:items:required"},"descriptionNode":"$Led6"},"tuesday":{"description":"Opening hours for Tuesday.","type":"array","items":"$5e:props:children:0:props:children:props:responses:201:content:application/json:schema:oneOf:1:properties:details:properties:opening_hours:properties:monday:items","descriptionNode":"$Led7"},"wednesday":{"description":"Opening hours for Wednesday.","type":"array","items":"$5e:props:children:0:props:children:props:responses:201:content:application/json:schema:oneOf:1:properties:details:properties:opening_hours:properties:monday:items","descriptionNode":"$Led8"},"thursday":{"description":"Opening hours for Thursday.","type":"array","items":"$5e:props:children:0:props:children:props:responses:201:content:application/json:schema:oneOf:1:properties:details:properties:opening_hours:properties:monday:items","descriptionNode":"$Led9"},"friday":{"description":"Opening hours for Friday.","type":"array","items":"$5e:props:children:0:props:children:props:responses:201:content:application/json:schema:oneOf:1:properties:details:properties:opening_hours:properties:monday:items","descriptionNode":"$Leda"},"saturday":{"description":"Opening hours for Saturday.","type":"array","items":"$5e:props:children:0:props:children:props:responses:201:content:application/json:schema:oneOf:1:properties:details:properties:opening_hours:properties:monday:items","descriptionNode":"$Ledb"},"sunday":{"description":"Opening hours for Sunday.","type":"array","items":"$5e:props:children:0:props:children:props:responses:201:content:application/json:schema:oneOf:1:properties:details:properties:opening_hours:properties:monday:items","descriptionNode":"$Ledc"}},"descriptionNode":"$Ledd"}},"required":"$60:props:children:0:props:children:props:responses:200:content:application/json:schema:oneOf:1:properties:details:required","descriptionNode":"$Lede"}},"required":"$60:props:children:0:props:children:props:responses:200:content:application/json:schema:oneOf:1:required"}],"discriminator":"$60:props:children:0:props:children:props:responses:200:content:application/json:schema:discriminator","descriptionNode":"$Ledf"},"examples":{"example_online_location":{"summary":"Online location request example","value":"$60:props:children:0:props:children:props:responses:200:content:application/json:examples:example_online_location:value"},"example_physical_location":{"summary":"Physical location request example","value":"$60:props:children:0:props:children:props:responses:200:content:application/json:examples:example_physical_location:value"}}}},"descriptionNode":"$Lee0"},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"errorId":{"type":"string","description":"The ID of the error. You can share this ID with Revolut support for troubleshooting.","descriptionNode":"$Lee1"},"timestamp":{"type":"integer","description":"The date and time the error happened.","descriptionNode":"$Lee2"}},"required":"$62:props:children:0:props:children:props:responses:401:content:application/json:schema:required"}}},"descriptionNode":"$Lee3"},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"errorId":{"type":"string","description":"The ID of the error. You can share this ID with Revolut support for troubleshooting.","descriptionNode":"$Lee4"},"timestamp":{"type":"integer","description":"The date and time the error happened.","descriptionNode":"$Lee5"}},"required":"$62:props:children:0:props:children:props:responses:401:content:application/json:schema:required"}}},"descriptionNode":"$Lee6"},"404":{"description":"Not Found","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"errorId":{"type":"string","description":"The ID of the error. You can share this ID with Revolut support for troubleshooting.","descriptionNode":"$Lee7"},"timestamp":{"type":"integer","description":"The date and time the error happened.","descriptionNode":"$Lee8"}},"required":"$62:props:children:0:props:children:props:responses:401:content:application/json:schema:required"}}},"descriptionNode":"$Lee9"}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","description":"Request body for creating a location. The structure of the `details` object depends on the `type` of the location.","oneOf":[{"type":"object","properties":{"name":{"type":"string","description":"Name of the location. \n\n:::warning\nThe `name` parameter's value must be unique across all locations.\n:::","descriptionNode":"$Leea"},"type":{"type":"string","description":"Type of the location.\n\n| Value | Description |\n| ----- | ----------- |\n| `online` | Represents an online store. |\n| `physical` | Represents a physical point of sale. |","enum":"$60:props:children:0:props:children:props:responses:200:content:application/json:schema:oneOf:0:properties:type:enum","descriptionNode":"$Leeb"},"details":{"type":"object","description":"Additional details of the location.","properties":{"domain":{"type":"string","description":"Domain address of the location. Required for online locations.\n\n:::warning\nThe `domain` parameter's value must be unique across all locations.\n:::","descriptionNode":"$Leec"}},"required":"$60:props:children:0:props:children:props:responses:200:content:application/json:schema:oneOf:0:properties:details:required","descriptionNode":"$Leed"}},"required":["name","type","details"]},{"type":"object","properties":{"name":{"type":"string","description":"Name of the location. \n\n:::warning\nThe `name` parameter's value must be unique across all locations.\n:::","descriptionNode":"$Leee"},"type":{"type":"string","description":"Type of the location.\n\n| Value | Description |\n| ----- | ----------- |\n| `online` | Represents an online store. |\n| `physical` | Represents a physical point of sale. |","enum":"$60:props:children:0:props:children:props:responses:200:content:application/json:schema:oneOf:0:properties:type:enum","descriptionNode":"$Leef"},"details":{"type":"object","description":"Additional details of the location.","properties":{"address":{"type":"object","description":"Details of a physical address.","properties":{"street_line_1":{"type":"string","description":"Primary address line.","maxLength":100,"descriptionNode":"$Lef0"},"street_line_2":{"type":"string","description":"Secondary address line, such as floor and apartment number.","maxLength":100,"descriptionNode":"$Lef1"},"region":{"type":"string","description":"State or province of the address.","maxLength":100,"descriptionNode":"$Lef2"},"city":{"type":"string","description":"City of the address.","maxLength":100,"descriptionNode":"$Lef3"},"country_code":{"type":"string","pattern":"^[A-Z]{2}$","description":"ISO 2-letter country code.","minLength":2,"maxLength":2,"descriptionNode":"$Lef4"},"postcode":{"type":"string","description":"Postal code of the address.","maxLength":100,"descriptionNode":"$Lef5"}},"required":"$60:props:children:0:props:children:props:responses:200:content:application/json:schema:oneOf:1:properties:details:properties:address:required","descriptionNode":"$Lef6"},"geo_location":{"type":"object","description":"Coordinates of the location.","properties":{"lat":{"type":"number","format":"double","description":"The latitude of the location, in decimal degrees.","minimum":-90,"maximum":90,"descriptionNode":"$Lef7"},"lon":{"type":"number","format":"double","description":"To longitude of the location, in decimal degrees.","minimum":-180,"maximum":180,"descriptionNode":"$Lef8"}},"required":"$60:props:children:0:props:children:props:responses:200:content:application/json:schema:oneOf:1:properties:details:properties:geo_location:required","descriptionNode":"$Lef9"},"opening_hours":{"type":"object","description":"An object containing the opening hours for each day of the week.\n\nA day can have multiple intervals (e.g., closing for a lunch break).","properties":{"monday":{"description":"Opening hours for Monday.","type":"array","items":{"type":"object","properties":{"from":{"type":"string","format":"time","description":"The local time when the interval begins.\n\n:::note\nThe format is `hh:mm[:ss]`; seconds are optional and must be `00` if provided.\n:::","examples":"$60:props:children:0:props:children:props:responses:200:content:application/json:schema:oneOf:1:properties:details:properties:opening_hours:properties:monday:items:properties:from:examples","descriptionNode":"$Lefa"},"to":{"type":"string","format":"time","description":"The local time when the interval ends.\n\n:::note\nThe format is `hh:mm[:ss]`; seconds are optional and must be `00` if provided.\n:::","examples":"$60:props:children:0:props:children:props:responses:200:content:application/json:schema:oneOf:1:properties:details:properties:opening_hours:properties:monday:items:properties:to:examples","descriptionNode":"$Lefb"}},"required":"$60:props:children:0:props:children:props:responses:200:content:application/json:schema:oneOf:1:properties:details:properties:opening_hours:properties:monday:items:required"},"descriptionNode":"$Lefc"},"tuesday":{"description":"Opening hours for Tuesday.","type":"array","items":"$5e:props:children:0:props:children:props:requestBody:content:application/json:schema:oneOf:1:properties:details:properties:opening_hours:properties:monday:items","descriptionNode":"$Lefd"},"wednesday":{"description":"Opening hours for Wednesday.","type":"array","items":"$5e:props:children:0:props:children:props:requestBody:content:application/json:schema:oneOf:1:properties:details:properties:opening_hours:properties:monday:items","descriptionNode":"$Lefe"},"thursday":{"description":"Opening hours for Thursday.","type":"array","items":"$5e:props:children:0:props:children:props:requestBody:content:application/json:schema:oneOf:1:properties:details:properties:opening_hours:properties:monday:items","descriptionNode":"$Leff"},"friday":{"description":"Opening hours for Friday.","type":"array","items":"$5e:props:children:0:props:children:props:requestBody:content:application/json:schema:oneOf:1:properties:details:properties:opening_hours:properties:monday:items","descriptionNode":"$Lf00"},"saturday":{"description":"Opening hours for Saturday.","type":"array","items":"$5e:props:children:0:props:children:props:requestBody:content:application/json:schema:oneOf:1:properties:details:properties:opening_hours:properties:monday:items","descriptionNode":"$Lf01"},"sunday":{"description":"Opening hours for Sunday.","type":"array","items":"$5e:props:children:0:props:children:props:requestBody:content:application/json:schema:oneOf:1:properties:details:properties:opening_hours:properties:monday:items","descriptionNode":"$Lf02"}},"descriptionNode":"$Lf03"}},"required":"$60:props:children:0:props:children:props:responses:200:content:application/json:schema:oneOf:1:properties:details:required","descriptionNode":"$Lf04"}},"required":["name","type","details"]}],"discriminator":{"propertyName":"type","mapping":{"online":"#/components/schemas/Location-Creation-Online","physical":"#/components/schemas/Location-Creation-Physical"}},"descriptionNode":"$Lf05"},"examples":{"example_online_location":{"summary":"Online location request example","value":{"name":"Grocery website","type":"online","details":{"domain":"groceries.example.com"}}},"example_physical_location":{"summary":"Physical location request example","value":{"name":"Example Street Store","type":"physical","details":{"address":{"street_line_1":"123 Example Street","city":"Example city","postcode":"12345","country_code":"GB"},"geo_location":{"lat":12.3456,"lon":-12.3456},"opening_hours":{"monday":[{"from":"09:00","to":"15:00"},{"from":"16:00","to":"18:00"}],"tuesday":[{"from":"10:00","to":"13:00"},{"from":"16:00","to":"18:00"}]}}}}}}}},"variantLabels":["Online location request example","Physical location request example"],"children":["$Lf06","$Lf07"]}]}],false]}] f06:["$","div",null,{"className":"ezz1n30","children":[["$","div",null,{"data-header":"$undefined","className":"ezz1n31","children":["$","div",null,{"className":"y9a0do1","children":[["$","h2",null,{"id":"create-location","children":[["$Lf08","$undefined"],["$","$L15",null,{"id":"create-location"}]]}],["$","$L16",null,{"url":"/docs/api/merchant/2025-10-16/operations/create-location.md"}]]}]}],"$undefined"]}] f0b:T6db,
curl -X POST "https://merchant.revolut.com/api/locations" \
  -H "Content-Type: application/json" \
  -H "Authorization: __RP_TOK_0__" \
  -d '{
  "name": "Grocery website",
  "type": "online",
  "details": {
    "domain": "groceries.example.com"
  }
}'
f0c:T1074,
const payload = {
  "name": "Grocery website",
  "type": "online",
  "details": {
    "domain": "groceries.example.com"
  }
};
fetch("https://merchant.revolut.com/api/locations", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "__RP_TOK_0__"
  },
  body: JSON.stringify(payload)
})
  .then(response => response.json())
  .then(data => console.log(data));
f0d:T15d3,
package main

import (
  "fmt"
  "net/http"
  "bytes"
  "encoding/json"
)

func main() {
  url := "https://merchant.revolut.com/api/locations"
  jsonData := []byte(`
{
  "name": "Grocery website",
  "type": "online",
  "details": {
    "domain": "groceries.example.com"
  }
}
  `)
  req, _ := http.NewRequest("POST", url, bytes.NewBuffer(jsonData))
  req.Header.Add("Content-Type", "application/json")
  req.Header.Add("Authorization", "__RP_TOK_0__")

  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  fmt.Println(res)
}
f0e:Tdaa,
import requests

url = "https://merchant.revolut.com/api/locations"
headers = {
  "Content-Type": "application/json",
  "Authorization": "__RP_TOK_0__"
}
payload = {
  "name": "Grocery website",
  "type": "online",
  "details": {
    "domain": "groceries.example.com"
  }
}

response = requests.post(url, headers=headers, json=payload)
print(response.json())
f0f:T1b3a,
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;

public class Main {
  public static void main(String[] args) {
    HttpClient client = HttpClient.newHttpClient();
    String body = """
{
  "name": "Grocery website",
  "type": "online",
  "details": {
    "domain": "groceries.example.com"
  }
}
    """;

    HttpRequest request = HttpRequest.newBuilder()
      .uri(URI.create("https://merchant.revolut.com/api/locations"))
      .header("Content-Type", "application/json")
      .header("Authorization", "__RP_TOK_0__")
      .POST(HttpRequest.BodyPublishers.ofString(body))
      .build();

    client.sendAsync(request, HttpResponse.BodyHandlers.ofString())
      .thenApply(HttpResponse::body)
      .thenAccept(System.out::println)
      .join();
  }
}
f10:T215a,
using System.Net.Http;
using System.Net.Http.Headers;

var client = new HttpClient();
var request = new HttpRequestMessage
{
  Method = HttpMethod.Post,
  RequestUri = new Uri("https://merchant.revolut.com/api/locations"),
  Headers =
  {
    { "Authorization", "__RP_TOK_0__" },
  },
  Content = new StringContent(@"{
  ""name"": ""Grocery website"",
  ""type"": ""online"",
  ""details"": {
    ""domain"": ""groceries.example.com""
  }
}")
  {
    Headers =
    {
      ContentType = new MediaTypeHeaderValue("application/json")
    }
  }
};

using (var response = await client.SendAsync(request))
{
  response.EnsureSuccessStatusCode();
  var body = await response.Content.ReadAsStringAsync();
  Console.WriteLine(body);
}
f11:T6e3,
curl -X POST "https://sandbox-merchant.revolut.com/api/locations" \
  -H "Content-Type: application/json" \
  -H "Authorization: __RP_TOK_0__" \
  -d '{
  "name": "Grocery website",
  "type": "online",
  "details": {
    "domain": "groceries.example.com"
  }
}'
f12:T107c,
const payload = {
  "name": "Grocery website",
  "type": "online",
  "details": {
    "domain": "groceries.example.com"
  }
};
fetch("https://sandbox-merchant.revolut.com/api/locations", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "__RP_TOK_0__"
  },
  body: JSON.stringify(payload)
})
  .then(response => response.json())
  .then(data => console.log(data));
f13:T15db,
package main

import (
  "fmt"
  "net/http"
  "bytes"
  "encoding/json"
)

func main() {
  url := "https://sandbox-merchant.revolut.com/api/locations"
  jsonData := []byte(`
{
  "name": "Grocery website",
  "type": "online",
  "details": {
    "domain": "groceries.example.com"
  }
}
  `)
  req, _ := http.NewRequest("POST", url, bytes.NewBuffer(jsonData))
  req.Header.Add("Content-Type", "application/json")
  req.Header.Add("Authorization", "__RP_TOK_0__")

  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  fmt.Println(res)
}
f14:Tdb2,
import requests

url = "https://sandbox-merchant.revolut.com/api/locations"
headers = {
  "Content-Type": "application/json",
  "Authorization": "__RP_TOK_0__"
}
payload = {
  "name": "Grocery website",
  "type": "online",
  "details": {
    "domain": "groceries.example.com"
  }
}

response = requests.post(url, headers=headers, json=payload)
print(response.json())
f15:T1b42,
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;

public class Main {
  public static void main(String[] args) {
    HttpClient client = HttpClient.newHttpClient();
    String body = """
{
  "name": "Grocery website",
  "type": "online",
  "details": {
    "domain": "groceries.example.com"
  }
}
    """;

    HttpRequest request = HttpRequest.newBuilder()
      .uri(URI.create("https://sandbox-merchant.revolut.com/api/locations"))
      .header("Content-Type", "application/json")
      .header("Authorization", "__RP_TOK_0__")
      .POST(HttpRequest.BodyPublishers.ofString(body))
      .build();

    client.sendAsync(request, HttpResponse.BodyHandlers.ofString())
      .thenApply(HttpResponse::body)
      .thenAccept(System.out::println)
      .join();
  }
}
f16:T2162,
using System.Net.Http;
using System.Net.Http.Headers;

var client = new HttpClient();
var request = new HttpRequestMessage
{
  Method = HttpMethod.Post,
  RequestUri = new Uri("https://sandbox-merchant.revolut.com/api/locations"),
  Headers =
  {
    { "Authorization", "__RP_TOK_0__" },
  },
  Content = new StringContent(@"{
  ""name"": ""Grocery website"",
  ""type"": ""online"",
  ""details"": {
    ""domain"": ""groceries.example.com""
  }
}")
  {
    Headers =
    {
      ContentType = new MediaTypeHeaderValue("application/json")
    }
  }
};

using (var response = await client.SendAsync(request))
{
  response.EnsureSuccessStatusCode();
  var body = await response.Content.ReadAsStringAsync();
  Console.WriteLine(body);
}
f07:["$","div",null,{"className":"ezz1n30","children":[["$","div",null,{"data-header":"$undefined","className":"ezz1n31","children":["$Lf09",["$","$L85",null,{"parameters":[{"name":"Authorization","in":"header","schema":{"type":"string","format":"Bearer ","examples":"$62:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:0:schema:examples"},"required":true,"description":"This parameter accepts the [Merchant API Secret key](https://business.revolut.com/settings/apis?tab=merchant-api) to authorise requests coming from the merchant's backend. \n\nIt ensures that ensures that each request is authenticated and authorised by verifying the secret key. The secret key should be included in all request headers as a `Bearer` token.\n\n:::info\nFor more information, see: [Authentication](https://developer.revolut.com/docs/api/merchant#authentication)\n:::","descriptionNode":"$Lf0a"}],"requestBody":"$5e:props:children:0:props:children:props:requestBody","heading":"Request","requestBodySchemaTitle":"Request body","headingAs":"h3"}],["$","$L89",null,{"responses":"$5e:props:children:0:props:children:props:responses","headingAs":"h3"}]]}],["$","div",null,{"className":"ezz1n32","children":[[["$","$L8a",null,{"itemsByServer":{"https://merchant.revolut.com":[{"id":"curl","label":"cURL","templateCode":"curl -X POST \"https://merchant.revolut.com/api/locations\" \\\n -H \"Content-Type: application/json\" \\\n -H \"Authorization: __RP_TOK_0__\" \\\n -d '{\n \"name\": \"Grocery website\",\n \"type\": \"online\",\n \"details\": {\n \"domain\": \"groceries.example.com\"\n }\n}'","templateHtml":"$f0b","tokens":[{"marker":"__RP_TOK_0__","paramName":"Authorization","paramIn":"header","pipeline":["shell-double-inner"]}],"defaults":{"header:Authorization":"Bearer "}},{"id":"javascript","label":"JavaScript","templateCode":"const payload = {\n \"name\": \"Grocery website\",\n \"type\": \"online\",\n \"details\": {\n \"domain\": \"groceries.example.com\"\n }\n};\nfetch(\"https://merchant.revolut.com/api/locations\", {\n method: \"POST\",\n headers: {\n \"Content-Type\": \"application/json\",\n \"Authorization\": \"__RP_TOK_0__\"\n },\n body: JSON.stringify(payload)\n})\n .then(response => response.json())\n .then(data => console.log(data));","templateHtml":"$f0c","tokens":[{"marker":"__RP_TOK_0__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer "}},{"id":"go","label":"Go","templateCode":"package main\n\nimport (\n \"fmt\"\n \"net/http\"\n \"bytes\"\n \"encoding/json\"\n)\n\nfunc main() {\n url := \"https://merchant.revolut.com/api/locations\"\n jsonData := []byte(`\n{\n \"name\": \"Grocery website\",\n \"type\": \"online\",\n \"details\": {\n \"domain\": \"groceries.example.com\"\n }\n}\n `)\n req, _ := http.NewRequest(\"POST\", url, bytes.NewBuffer(jsonData))\n req.Header.Add(\"Content-Type\", \"application/json\")\n req.Header.Add(\"Authorization\", \"__RP_TOK_0__\")\n\n res, _ := http.DefaultClient.Do(req)\n defer res.Body.Close()\n fmt.Println(res)\n}","templateHtml":"$f0d","tokens":[{"marker":"__RP_TOK_0__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer "}},{"id":"python","label":"Python","templateCode":"import requests\n\nurl = \"https://merchant.revolut.com/api/locations\"\nheaders = {\n \"Content-Type\": \"application/json\",\n \"Authorization\": \"__RP_TOK_0__\"\n}\npayload = {\n \"name\": \"Grocery website\",\n \"type\": \"online\",\n \"details\": {\n \"domain\": \"groceries.example.com\"\n }\n}\n\nresponse = requests.post(url, headers=headers, json=payload)\nprint(response.json())","templateHtml":"$f0e","tokens":[{"marker":"__RP_TOK_0__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer "}},{"id":"java","label":"Java","templateCode":"import java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\nimport java.net.URI;\n\npublic class Main {\n public static void main(String[] args) {\n HttpClient client = HttpClient.newHttpClient();\n String body = \"\"\"\n{\n \"name\": \"Grocery website\",\n \"type\": \"online\",\n \"details\": {\n \"domain\": \"groceries.example.com\"\n }\n}\n \"\"\";\n\n HttpRequest request = HttpRequest.newBuilder()\n .uri(URI.create(\"https://merchant.revolut.com/api/locations\"))\n .header(\"Content-Type\", \"application/json\")\n .header(\"Authorization\", \"__RP_TOK_0__\")\n .POST(HttpRequest.BodyPublishers.ofString(body))\n .build();\n\n client.sendAsync(request, HttpResponse.BodyHandlers.ofString())\n .thenApply(HttpResponse::body)\n .thenAccept(System.out::println)\n .join();\n }\n}","templateHtml":"$f0f","tokens":[{"marker":"__RP_TOK_0__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer "}},{"id":"csharp","label":"C#","templateCode":"using System.Net.Http;\nusing System.Net.Http.Headers;\n\nvar client = new HttpClient();\nvar request = new HttpRequestMessage\n{\n Method = HttpMethod.Post,\n RequestUri = new Uri(\"https://merchant.revolut.com/api/locations\"),\n Headers =\n {\n { \"Authorization\", \"__RP_TOK_0__\" },\n },\n Content = new StringContent(@\"{\n \"\"name\"\": \"\"Grocery website\"\",\n \"\"type\"\": \"\"online\"\",\n \"\"details\"\": {\n \"\"domain\"\": \"\"groceries.example.com\"\"\n }\n}\")\n {\n Headers =\n {\n ContentType = new MediaTypeHeaderValue(\"application/json\")\n }\n }\n};\n\nusing (var response = await client.SendAsync(request))\n{\n response.EnsureSuccessStatusCode();\n var body = await response.Content.ReadAsStringAsync();\n Console.WriteLine(body);\n}","templateHtml":"$f10","tokens":[{"marker":"__RP_TOK_0__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer "}}],"https://sandbox-merchant.revolut.com":[{"id":"curl","label":"cURL","templateCode":"curl -X POST \"https://sandbox-merchant.revolut.com/api/locations\" \\\n -H \"Content-Type: application/json\" \\\n -H \"Authorization: __RP_TOK_0__\" \\\n -d '{\n \"name\": \"Grocery website\",\n \"type\": \"online\",\n \"details\": {\n \"domain\": \"groceries.example.com\"\n }\n}'","templateHtml":"$f11","tokens":[{"marker":"__RP_TOK_0__","paramName":"Authorization","paramIn":"header","pipeline":["shell-double-inner"]}],"defaults":{"header:Authorization":"Bearer "}},{"id":"javascript","label":"JavaScript","templateCode":"const payload = {\n \"name\": \"Grocery website\",\n \"type\": \"online\",\n \"details\": {\n \"domain\": \"groceries.example.com\"\n }\n};\nfetch(\"https://sandbox-merchant.revolut.com/api/locations\", {\n method: \"POST\",\n headers: {\n \"Content-Type\": \"application/json\",\n \"Authorization\": \"__RP_TOK_0__\"\n },\n body: JSON.stringify(payload)\n})\n .then(response => response.json())\n .then(data => console.log(data));","templateHtml":"$f12","tokens":[{"marker":"__RP_TOK_0__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer "}},{"id":"go","label":"Go","templateCode":"package main\n\nimport (\n \"fmt\"\n \"net/http\"\n \"bytes\"\n \"encoding/json\"\n)\n\nfunc main() {\n url := \"https://sandbox-merchant.revolut.com/api/locations\"\n jsonData := []byte(`\n{\n \"name\": \"Grocery website\",\n \"type\": \"online\",\n \"details\": {\n \"domain\": \"groceries.example.com\"\n }\n}\n `)\n req, _ := http.NewRequest(\"POST\", url, bytes.NewBuffer(jsonData))\n req.Header.Add(\"Content-Type\", \"application/json\")\n req.Header.Add(\"Authorization\", \"__RP_TOK_0__\")\n\n res, _ := http.DefaultClient.Do(req)\n defer res.Body.Close()\n fmt.Println(res)\n}","templateHtml":"$f13","tokens":[{"marker":"__RP_TOK_0__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer "}},{"id":"python","label":"Python","templateCode":"import requests\n\nurl = \"https://sandbox-merchant.revolut.com/api/locations\"\nheaders = {\n \"Content-Type\": \"application/json\",\n \"Authorization\": \"__RP_TOK_0__\"\n}\npayload = {\n \"name\": \"Grocery website\",\n \"type\": \"online\",\n \"details\": {\n \"domain\": \"groceries.example.com\"\n }\n}\n\nresponse = requests.post(url, headers=headers, json=payload)\nprint(response.json())","templateHtml":"$f14","tokens":[{"marker":"__RP_TOK_0__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer "}},{"id":"java","label":"Java","templateCode":"import java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\nimport java.net.URI;\n\npublic class Main {\n public static void main(String[] args) {\n HttpClient client = HttpClient.newHttpClient();\n String body = \"\"\"\n{\n \"name\": \"Grocery website\",\n \"type\": \"online\",\n \"details\": {\n \"domain\": \"groceries.example.com\"\n }\n}\n \"\"\";\n\n HttpRequest request = HttpRequest.newBuilder()\n .uri(URI.create(\"https://sandbox-merchant.revolut.com/api/locations\"))\n .header(\"Content-Type\", \"application/json\")\n .header(\"Authorization\", \"__RP_TOK_0__\")\n .POST(HttpRequest.BodyPublishers.ofString(body))\n .build();\n\n client.sendAsync(request, HttpResponse.BodyHandlers.ofString())\n .thenApply(HttpResponse::body)\n .thenAccept(System.out::println)\n .join();\n }\n}","templateHtml":"$f15","tokens":[{"marker":"__RP_TOK_0__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer "}},{"id":"csharp","label":"C#","templateCode":"using System.Net.Http;\nusing System.Net.Http.Headers;\n\nvar client = new HttpClient();\nvar request = new HttpRequestMessage\n{\n Method = HttpMethod.Post,\n RequestUri = new Uri(\"https://sandbox-merchant.revolut.com/api/locations\"),\n Headers =\n {\n { \"Authorization\", \"__RP_TOK_0__\" },\n },\n Content = new StringContent(@\"{\n \"\"name\"\": \"\"Grocery website\"\",\n \"\"type\"\": \"\"online\"\",\n \"\"details\"\": {\n \"\"domain\"\": \"\"groceries.example.com\"\"\n }\n}\")\n {\n Headers =\n {\n ContentType = new MediaTypeHeaderValue(\"application/json\")\n }\n }\n};\n\nusing (var response = await client.SendAsync(request))\n{\n response.EnsureSuccessStatusCode();\n var body = await response.Content.ReadAsStringAsync();\n Console.WriteLine(body);\n}","templateHtml":"$f16","tokens":[{"marker":"__RP_TOK_0__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer "}}]},"method":"post","servers":"$62:props:children:0:props:children:props:children:1:props:children:1:props:children:0:0:props:servers","path":"/api/locations","parameters":["$f07:props:children:0:props:children:1:props:parameters:0"]}],"$Lf17"],"$Lf18","$Lf19"]}]]}] f17:["$","$L10d",null,{"security":[{"Api-Key":[]}],"authorization":{"Api-Key":{"type":"apiKey","in":"header","name":"Authorization","description":"Each Merchant API request must contain an authorization header in the following format:\n\n```\n'Authorization: Bearer '\n```\n\nTo use this API, you need to generate API keys from your Revolut Business account. The Secret key is used in the authorization header for all server calls, while the Public key is provided with payment methods at checkout.\n\n:::info\nFor detailed instructions on generating your API keys, see: [Generate API keys](https://developer.revolut.com/docs/guides/merchant/get-started#generate-api-keys).\n:::","descriptionNode":"$Lf1a"}}}] f18:["$","$L10f",null,{"exampleBlocks":{"application/json":{"variants":[{"key":"example_online_location","label":"Online location request example","rawValue":"$5e:props:children:0:props:children:props:requestBody:content:application/json:examples:example_online_location:value","block":"$Lf1b"},{"key":"example_physical_location","label":"Physical location request example","rawValue":"$5e:props:children:0:props:children:props:requestBody:content:application/json:examples:example_physical_location:value","block":"$Lf1c"}],"syncedPropertyName":"type"}},"title":"Request body samples","headingAs":"h4"}] f19:["$","$L110",null,{"exampleBlocks":{"201":{"application/json":{"variants":[{"key":"example_online_location","label":"Online location request example","rawValue":"$60:props:children:0:props:children:props:responses:200:content:application/json:examples:example_online_location:value","block":"$Lf1d"},{"key":"example_physical_location","label":"Physical location request example","rawValue":"$60:props:children:0:props:children:props:responses:200:content:application/json:examples:example_physical_location:value","block":"$Lf1e"}],"syncedPropertyName":"type"}},"400":{"application/json":{"variants":[{"key":"default","label":"Example","rawValue":{"errorId":"string","timestamp":123},"block":"$Lf1f"}],"syncedPropertyName":"$undefined"}},"401":{"application/json":{"variants":[{"key":"default","label":"Example","rawValue":{"errorId":"string","timestamp":123},"block":"$Lf20"}],"syncedPropertyName":"$undefined"}},"404":{"application/json":{"variants":[{"key":"default","label":"Example","rawValue":{"errorId":"string","timestamp":123},"block":"$Lf21"}],"syncedPropertyName":"$undefined"}}},"headingAs":"h4"}] eb7:["$","div","CodeBlock-0",{"className":"wzy01m0 _18b50nc0","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"
'Authorization: Bearer <yourSecretApiKey>'
"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"'Authorization: Bearer '\n"}]}]]}] f08:"Create a location" ec2:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unique ID representing the location where merchants sells products."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#tag-locations","target":"_blank","rel":"noreferrer","children":"Locations"}],"."]}]}]]}]]}] ec3:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Name of the location."}],"\n",["$","div","inlinealert-0",{"data-type":"warning","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMark","color":"var(--rui-color-warning)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["The ",["$","code","code-0",{"children":"name"}]," parameter's value must be unique across all locations."]}]}]]}]]}] ec4:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Type of the location."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Value","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"online"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Represents an online store.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"physical"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Represents a physical point of sale.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] ec5:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Domain address of the location. Required for online locations."}],"\n",["$","div","inlinealert-0",{"data-type":"warning","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMark","color":"var(--rui-color-warning)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["The ",["$","code","code-0",{"children":"domain"}]," parameter's value must be unique across all locations."]}]}]]}]]}] ec6:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Additional details of the location."}]]}] ec7:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unique ID representing the location where merchants sells products."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#tag-locations","target":"_blank","rel":"noreferrer","children":"Locations"}],"."]}]}]]}]]}] ec8:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Name of the location."}],"\n",["$","div","inlinealert-0",{"data-type":"warning","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMark","color":"var(--rui-color-warning)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["The ",["$","code","code-0",{"children":"name"}]," parameter's value must be unique across all locations."]}]}]]}]]}] ec9:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Type of the location."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Value","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"online"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Represents an online store.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"physical"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Represents a physical point of sale.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] eca:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Primary address line."}]]}] ecb:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Secondary address line, such as floor and apartment number."}]]}] ecc:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"State or province of the address."}]]}] ecd:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"City of the address."}]]}] ece:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"ISO 2-letter country code."}]]}] ecf:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Postal code of the address."}]]}] ed0:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Details of a physical address."}]]}] ed1:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The latitude of the location, in decimal degrees."}]]}] ed2:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"To longitude of the location, in decimal degrees."}]]}] ed3:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Coordinates of the location."}]]}] ed4:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The local time when the interval begins."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["The format is ",["$","code","code-0",{"children":"hh:mm[:ss]"}],"; seconds are optional and must be ",["$","code","code-1",{"children":"00"}]," if provided."]}]}]]}]]}] ed5:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The local time when the interval ends."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["The format is ",["$","code","code-0",{"children":"hh:mm[:ss]"}],"; seconds are optional and must be ",["$","code","code-1",{"children":"00"}]," if provided."]}]}]]}]]}] ed6:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Opening hours for Monday."}]]}] ed7:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Opening hours for Tuesday."}]]}] ed8:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Opening hours for Wednesday."}]]}] ed9:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Opening hours for Thursday."}]]}] eda:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Opening hours for Friday."}]]}] edb:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Opening hours for Saturday."}]]}] edc:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Opening hours for Sunday."}]]}] edd:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An object containing the opening hours for each day of the week."}],"\n",["$","p","p-1",{"children":"A day can have multiple intervals (e.g., closing for a lunch break)."}]]}] ede:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Additional details of the location."}]]}] edf:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Location object represents merchant locations depending on type."}]]}] ee0:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Location created"}]]}] ee1:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The ID of the error. You can share this ID with Revolut support for troubleshooting."}]]}] ee2:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The date and time the error happened."}]]}] ee3:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Bad Request"}]]}] ee4:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The ID of the error. You can share this ID with Revolut support for troubleshooting."}]]}] ee5:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The date and time the error happened."}]]}] ee6:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unauthorized"}]]}] ee7:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The ID of the error. You can share this ID with Revolut support for troubleshooting."}]]}] ee8:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The date and time the error happened."}]]}] ee9:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Not Found"}]]}] eea:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Name of the location."}],"\n",["$","div","inlinealert-0",{"data-type":"warning","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMark","color":"var(--rui-color-warning)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["The ",["$","code","code-0",{"children":"name"}]," parameter's value must be unique across all locations."]}]}]]}]]}] eeb:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Type of the location."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Value","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"online"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Represents an online store.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"physical"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Represents a physical point of sale.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] eec:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Domain address of the location. Required for online locations."}],"\n",["$","div","inlinealert-0",{"data-type":"warning","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMark","color":"var(--rui-color-warning)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["The ",["$","code","code-0",{"children":"domain"}]," parameter's value must be unique across all locations."]}]}]]}]]}] eed:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Additional details of the location."}]]}] eee:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Name of the location."}],"\n",["$","div","inlinealert-0",{"data-type":"warning","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMark","color":"var(--rui-color-warning)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["The ",["$","code","code-0",{"children":"name"}]," parameter's value must be unique across all locations."]}]}]]}]]}] eef:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Type of the location."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Value","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"online"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Represents an online store.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"physical"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Represents a physical point of sale.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] ef0:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Primary address line."}]]}] ef1:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Secondary address line, such as floor and apartment number."}]]}] ef2:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"State or province of the address."}]]}] ef3:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"City of the address."}]]}] ef4:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"ISO 2-letter country code."}]]}] ef5:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Postal code of the address."}]]}] ef6:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Details of a physical address."}]]}] ef7:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The latitude of the location, in decimal degrees."}]]}] ef8:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"To longitude of the location, in decimal degrees."}]]}] ef9:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Coordinates of the location."}]]}] efa:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The local time when the interval begins."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["The format is ",["$","code","code-0",{"children":"hh:mm[:ss]"}],"; seconds are optional and must be ",["$","code","code-1",{"children":"00"}]," if provided."]}]}]]}]]}] efb:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The local time when the interval ends."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["The format is ",["$","code","code-0",{"children":"hh:mm[:ss]"}],"; seconds are optional and must be ",["$","code","code-1",{"children":"00"}]," if provided."]}]}]]}]]}] efc:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Opening hours for Monday."}]]}] efd:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Opening hours for Tuesday."}]]}] efe:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Opening hours for Wednesday."}]]}] eff:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Opening hours for Thursday."}]]}] f00:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Opening hours for Friday."}]]}] f01:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Opening hours for Saturday."}]]}] f02:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Opening hours for Sunday."}]]}] f03:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An object containing the opening hours for each day of the week."}],"\n",["$","p","p-1",{"children":"A day can have multiple intervals (e.g., closing for a lunch break)."}]]}] f04:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Additional details of the location."}]]}] f05:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["Request body for creating a location. The structure of the ",["$","code","code-0",{"children":"details"}]," object depends on the ",["$","code","code-1",{"children":"type"}]," of the location."]}]]}] f09:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["Create a ",["$","code","code-0",{"children":"Location"}]," object. Supports ",["$","code","code-1",{"children":"online"}]," and ",["$","code","code-2",{"children":"physical"}]," location types."]}]]}] f0a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["This parameter accepts the ",["$","a","a-0",{"href":"https://business.revolut.com/settings/apis?tab=merchant-api","target":"_blank","rel":"noreferrer","children":"Merchant API Secret key"}]," to authorise requests coming from the merchant's backend."]}],"\n",["$","p","p-1",{"children":["It ensures that ensures that each request is authenticated and authorised by verifying the secret key. The secret key should be included in all request headers as a ",["$","code","code-0",{"children":"Bearer"}]," token."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#authentication","target":"_blank","rel":"noreferrer","children":"Authentication"}]]}]}]]}]]}] f1a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Each Merchant API request must contain an authorization header in the following format:"}],"\n","$Lf22","\n",["$","p","p-1",{"children":"To use this API, you need to generate API keys from your Revolut Business account. The Secret key is used in the authorization header for all server calls, while the Public key is provided with payment methods at checkout."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For detailed instructions on generating your API keys, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/get-started#generate-api-keys","target":"_blank","rel":"noreferrer","children":"Generate API keys"}],"."]}]}]]}]]}] 61:["$","$7a","update-location",{"children":[["$","section",null,{"className":"y9a0do0","data-variant":"endpoint","children":["$","$L7b",null,{"responses":{"200":{"description":"Location updated","content":{"application/json":{"schema":{"title":"Location","type":"object","description":"Location object represents merchant locations depending on type.","oneOf":[{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Unique ID representing the location where merchants sells products.\n\n:::info\nFor more information, see: [Locations](https://developer.revolut.com/docs/api/merchant#tag-locations).\n::: ","descriptionNode":"$Lf23"},"name":{"type":"string","description":"Name of the location. \n\n:::warning\nThe `name` parameter's value must be unique across all locations.\n:::","descriptionNode":"$Lf24"},"type":{"type":"string","description":"Type of the location.\n\n| Value | Description |\n| ----- | ----------- |\n| `online` | Represents an online store. |\n| `physical` | Represents a physical point of sale. |","enum":"$60:props:children:0:props:children:props:responses:200:content:application/json:schema:oneOf:0:properties:type:enum","descriptionNode":"$Lf25"},"details":{"type":"object","description":"Additional details of the location.","properties":{"domain":{"type":"string","description":"Domain address of the location. Required for online locations.\n\n:::warning\nThe `domain` parameter's value must be unique across all locations.\n:::","descriptionNode":"$Lf26"}},"required":"$60:props:children:0:props:children:props:responses:200:content:application/json:schema:oneOf:0:properties:details:required","descriptionNode":"$Lf27"}},"required":"$60:props:children:0:props:children:props:responses:200:content:application/json:schema:oneOf:0:required"},{"title":"Location","type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Unique ID representing the location where merchants sells products.\n\n:::info\nFor more information, see: [Locations](https://developer.revolut.com/docs/api/merchant#tag-locations).\n::: ","descriptionNode":"$Lf28"},"name":{"type":"string","description":"Name of the location. \n\n:::warning\nThe `name` parameter's value must be unique across all locations.\n:::","descriptionNode":"$Lf29"},"type":{"type":"string","description":"Type of the location.\n\n| Value | Description |\n| ----- | ----------- |\n| `online` | Represents an online store. |\n| `physical` | Represents a physical point of sale. |","enum":"$60:props:children:0:props:children:props:responses:200:content:application/json:schema:oneOf:0:properties:type:enum","descriptionNode":"$Lf2a"},"details":{"type":"object","description":"Additional details of the location.","properties":{"address":{"type":"object","description":"Details of a physical address.","properties":{"street_line_1":{"type":"string","description":"Primary address line.","maxLength":100,"descriptionNode":"$Lf2b"},"street_line_2":{"type":"string","description":"Secondary address line, such as floor and apartment number.","maxLength":100,"descriptionNode":"$Lf2c"},"region":{"type":"string","description":"State or province of the address.","maxLength":100,"descriptionNode":"$Lf2d"},"city":{"type":"string","description":"City of the address.","maxLength":100,"descriptionNode":"$Lf2e"},"country_code":{"type":"string","pattern":"^[A-Z]{2}$","description":"ISO 2-letter country code.","minLength":2,"maxLength":2,"descriptionNode":"$Lf2f"},"postcode":{"type":"string","description":"Postal code of the address.","maxLength":100,"descriptionNode":"$Lf30"}},"required":"$60:props:children:0:props:children:props:responses:200:content:application/json:schema:oneOf:1:properties:details:properties:address:required","descriptionNode":"$Lf31"},"geo_location":{"type":"object","description":"Coordinates of the location.","properties":{"lat":{"type":"number","format":"double","description":"The latitude of the location, in decimal degrees.","minimum":-90,"maximum":90,"descriptionNode":"$Lf32"},"lon":{"type":"number","format":"double","description":"To longitude of the location, in decimal degrees.","minimum":-180,"maximum":180,"descriptionNode":"$Lf33"}},"required":"$60:props:children:0:props:children:props:responses:200:content:application/json:schema:oneOf:1:properties:details:properties:geo_location:required","descriptionNode":"$Lf34"},"opening_hours":{"type":"object","description":"An object containing the opening hours for each day of the week.\n\nA day can have multiple intervals (e.g., closing for a lunch break).","properties":{"monday":{"description":"Opening hours for Monday.","type":"array","items":{"type":"object","properties":{"from":{"type":"string","format":"time","description":"The local time when the interval begins.\n\n:::note\nThe format is `hh:mm[:ss]`; seconds are optional and must be `00` if provided.\n:::","examples":"$60:props:children:0:props:children:props:responses:200:content:application/json:schema:oneOf:1:properties:details:properties:opening_hours:properties:monday:items:properties:from:examples","descriptionNode":"$Lf35"},"to":{"type":"string","format":"time","description":"The local time when the interval ends.\n\n:::note\nThe format is `hh:mm[:ss]`; seconds are optional and must be `00` if provided.\n:::","examples":"$60:props:children:0:props:children:props:responses:200:content:application/json:schema:oneOf:1:properties:details:properties:opening_hours:properties:monday:items:properties:to:examples","descriptionNode":"$Lf36"}},"required":"$60:props:children:0:props:children:props:responses:200:content:application/json:schema:oneOf:1:properties:details:properties:opening_hours:properties:monday:items:required"},"descriptionNode":"$Lf37"},"tuesday":{"description":"Opening hours for Tuesday.","type":"array","items":"$61:props:children:0:props:children:props:responses:200:content:application/json:schema:oneOf:1:properties:details:properties:opening_hours:properties:monday:items","descriptionNode":"$Lf38"},"wednesday":{"description":"Opening hours for Wednesday.","type":"array","items":"$61:props:children:0:props:children:props:responses:200:content:application/json:schema:oneOf:1:properties:details:properties:opening_hours:properties:monday:items","descriptionNode":"$Lf39"},"thursday":{"description":"Opening hours for Thursday.","type":"array","items":"$61:props:children:0:props:children:props:responses:200:content:application/json:schema:oneOf:1:properties:details:properties:opening_hours:properties:monday:items","descriptionNode":"$Lf3a"},"friday":{"description":"Opening hours for Friday.","type":"array","items":"$61:props:children:0:props:children:props:responses:200:content:application/json:schema:oneOf:1:properties:details:properties:opening_hours:properties:monday:items","descriptionNode":"$Lf3b"},"saturday":{"description":"Opening hours for Saturday.","type":"array","items":"$61:props:children:0:props:children:props:responses:200:content:application/json:schema:oneOf:1:properties:details:properties:opening_hours:properties:monday:items","descriptionNode":"$Lf3c"},"sunday":{"description":"Opening hours for Sunday.","type":"array","items":"$61:props:children:0:props:children:props:responses:200:content:application/json:schema:oneOf:1:properties:details:properties:opening_hours:properties:monday:items","descriptionNode":"$Lf3d"}},"descriptionNode":"$Lf3e"}},"required":"$60:props:children:0:props:children:props:responses:200:content:application/json:schema:oneOf:1:properties:details:required","descriptionNode":"$Lf3f"}},"required":"$60:props:children:0:props:children:props:responses:200:content:application/json:schema:oneOf:1:required"}],"discriminator":"$60:props:children:0:props:children:props:responses:200:content:application/json:schema:discriminator","descriptionNode":"$Lf40"},"examples":{"online_location":{"summary":"Online location example","value":{"id":"8d9a7125-805f-40f3-a405-bc89765db996","name":"Cars website - Name update","type":"online","details":{"domain":"cars.example.com"}}},"physical_location":{"summary":"Physical location example","value":{"name":"Example Street Store","type":"physical","details":{"address":null,"street_line_1":"123 Example Street","city":"Example city","postcode":"12345","country_code":"GB"},"geo_location":{"lat":12.3456,"lon":-12.3456},"opening_hours":{"monday":[{"from":"10:00","to":"18:00"}],"tuesday":[{"from":"10:00","to":"13:00"},{"from":"16:00","to":"18:00"}],"wednesday":[{"from":"11:00","to":"18:00"}]}}}}}},"descriptionNode":"$Lf41"},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"errorId":{"type":"string","description":"The ID of the error. You can share this ID with Revolut support for troubleshooting.","descriptionNode":"$Lf42"},"timestamp":{"type":"integer","description":"The date and time the error happened.","descriptionNode":"$Lf43"}},"required":"$62:props:children:0:props:children:props:responses:401:content:application/json:schema:required"}}},"descriptionNode":"$Lf44"},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"errorId":{"type":"string","description":"The ID of the error. You can share this ID with Revolut support for troubleshooting.","descriptionNode":"$Lf45"},"timestamp":{"type":"integer","description":"The date and time the error happened.","descriptionNode":"$Lf46"}},"required":"$62:props:children:0:props:children:props:responses:401:content:application/json:schema:required"}}},"descriptionNode":"$Lf47"},"404":{"description":"Not Found","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"errorId":{"type":"string","description":"The ID of the error. You can share this ID with Revolut support for troubleshooting.","descriptionNode":"$Lf48"},"timestamp":{"type":"integer","description":"The date and time the error happened.","descriptionNode":"$Lf49"}},"required":"$62:props:children:0:props:children:props:responses:401:content:application/json:schema:required"}}},"descriptionNode":"$Lf4a"}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","description":"Request body for updating a location. The structure of the `details` object depends on the `type` of the location.","oneOf":[{"type":"object","properties":{"name":{"type":"string","description":"Name of the location. \n\n:::warning\nThe `name` parameter's value must be unique across all locations.\n:::","descriptionNode":"$Lf4b"},"details":{"type":"object","description":"Additional details of the location.","properties":{"domain":{"type":"string","description":"Domain address of the location. Required for online locations.\n\n:::warning\nThe `domain` parameter's value must be unique across all locations.\n:::","descriptionNode":"$Lf4c"}},"required":"$60:props:children:0:props:children:props:responses:200:content:application/json:schema:oneOf:0:properties:details:required","descriptionNode":"$Lf4d"}}},{"title":"Location","type":"object","description":"Location object represents merchant locations depending on type.","oneOf":[{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Unique ID representing the location where merchants sells products.\n\n:::info\nFor more information, see: [Locations](https://developer.revolut.com/docs/api/merchant#tag-locations).\n::: ","descriptionNode":"$Lf4e"},"name":{"type":"string","description":"Name of the location. \n\n:::warning\nThe `name` parameter's value must be unique across all locations.\n:::","descriptionNode":"$Lf4f"},"type":{"type":"string","description":"Type of the location.\n\n| Value | Description |\n| ----- | ----------- |\n| `online` | Represents an online store. |\n| `physical` | Represents a physical point of sale. |","enum":"$60:props:children:0:props:children:props:responses:200:content:application/json:schema:oneOf:0:properties:type:enum","descriptionNode":"$Lf50"},"details":{"type":"object","description":"Additional details of the location.","properties":{"domain":"$61:props:children:0:props:children:props:requestBody:content:application/json:schema:oneOf:0:properties:details:properties:domain"},"required":"$60:props:children:0:props:children:props:responses:200:content:application/json:schema:oneOf:0:properties:details:required","descriptionNode":"$Lf51"}},"required":"$60:props:children:0:props:children:props:responses:200:content:application/json:schema:oneOf:0:required"},{"title":"Location","type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Unique ID representing the location where merchants sells products.\n\n:::info\nFor more information, see: [Locations](https://developer.revolut.com/docs/api/merchant#tag-locations).\n::: ","descriptionNode":"$Lf52"},"name":{"type":"string","description":"Name of the location. \n\n:::warning\nThe `name` parameter's value must be unique across all locations.\n:::","descriptionNode":"$Lf53"},"type":{"type":"string","description":"Type of the location.\n\n| Value | Description |\n| ----- | ----------- |\n| `online` | Represents an online store. |\n| `physical` | Represents a physical point of sale. |","enum":"$60:props:children:0:props:children:props:responses:200:content:application/json:schema:oneOf:0:properties:type:enum","descriptionNode":"$Lf54"},"details":{"type":"object","description":"Additional details of the location.","properties":{"address":{"type":"object","description":"Details of a physical address.","properties":{"street_line_1":{"type":"string","description":"Primary address line.","maxLength":100,"descriptionNode":"$Lf55"},"street_line_2":{"type":"string","description":"Secondary address line, such as floor and apartment number.","maxLength":100,"descriptionNode":"$Lf56"},"region":{"type":"string","description":"State or province of the address.","maxLength":100,"descriptionNode":"$Lf57"},"city":{"type":"string","description":"City of the address.","maxLength":100,"descriptionNode":"$Lf58"},"country_code":{"type":"string","pattern":"^[A-Z]{2}$","description":"ISO 2-letter country code.","minLength":2,"maxLength":2,"descriptionNode":"$Lf59"},"postcode":{"type":"string","description":"Postal code of the address.","maxLength":100,"descriptionNode":"$Lf5a"}},"required":"$60:props:children:0:props:children:props:responses:200:content:application/json:schema:oneOf:1:properties:details:properties:address:required","descriptionNode":"$Lf5b"},"geo_location":{"type":"object","description":"Coordinates of the location.","properties":{"lat":{"type":"number","format":"double","description":"The latitude of the location, in decimal degrees.","minimum":-90,"maximum":90,"descriptionNode":"$Lf5c"},"lon":{"type":"number","format":"double","description":"To longitude of the location, in decimal degrees.","minimum":-180,"maximum":180,"descriptionNode":"$Lf5d"}},"required":"$60:props:children:0:props:children:props:responses:200:content:application/json:schema:oneOf:1:properties:details:properties:geo_location:required","descriptionNode":"$Lf5e"},"opening_hours":{"type":"object","description":"An object containing the opening hours for each day of the week.\n\nA day can have multiple intervals (e.g., closing for a lunch break).","properties":{"monday":{"description":"Opening hours for Monday.","type":"array","items":{"type":"object","properties":{"from":{"type":"string","format":"time","description":"The local time when the interval begins.\n\n:::note\nThe format is `hh:mm[:ss]`; seconds are optional and must be `00` if provided.\n:::","examples":"$60:props:children:0:props:children:props:responses:200:content:application/json:schema:oneOf:1:properties:details:properties:opening_hours:properties:monday:items:properties:from:examples","descriptionNode":"$Lf5f"},"to":{"type":"string","format":"time","description":"The local time when the interval ends.\n\n:::note\nThe format is `hh:mm[:ss]`; seconds are optional and must be `00` if provided.\n:::","examples":"$60:props:children:0:props:children:props:responses:200:content:application/json:schema:oneOf:1:properties:details:properties:opening_hours:properties:monday:items:properties:to:examples","descriptionNode":"$Lf60"}},"required":"$60:props:children:0:props:children:props:responses:200:content:application/json:schema:oneOf:1:properties:details:properties:opening_hours:properties:monday:items:required"},"descriptionNode":"$Lf61"},"tuesday":{"description":"Opening hours for Tuesday.","type":"array","items":"$61:props:children:0:props:children:props:requestBody:content:application/json:schema:oneOf:1:oneOf:1:properties:details:properties:opening_hours:properties:monday:items","descriptionNode":"$Lf62"},"wednesday":{"description":"Opening hours for Wednesday.","type":"array","items":"$61:props:children:0:props:children:props:requestBody:content:application/json:schema:oneOf:1:oneOf:1:properties:details:properties:opening_hours:properties:monday:items","descriptionNode":"$Lf63"},"thursday":{"description":"Opening hours for Thursday.","type":"array","items":"$61:props:children:0:props:children:props:requestBody:content:application/json:schema:oneOf:1:oneOf:1:properties:details:properties:opening_hours:properties:monday:items","descriptionNode":"$Lf64"},"friday":{"description":"Opening hours for Friday.","type":"array","items":"$61:props:children:0:props:children:props:requestBody:content:application/json:schema:oneOf:1:oneOf:1:properties:details:properties:opening_hours:properties:monday:items","descriptionNode":"$Lf65"},"saturday":{"description":"Opening hours for Saturday.","type":"array","items":"$61:props:children:0:props:children:props:requestBody:content:application/json:schema:oneOf:1:oneOf:1:properties:details:properties:opening_hours:properties:monday:items","descriptionNode":"$Lf66"},"sunday":{"description":"Opening hours for Sunday.","type":"array","items":"$61:props:children:0:props:children:props:requestBody:content:application/json:schema:oneOf:1:oneOf:1:properties:details:properties:opening_hours:properties:monday:items","descriptionNode":"$Lf67"}},"descriptionNode":"$Lf68"}},"required":"$60:props:children:0:props:children:props:responses:200:content:application/json:schema:oneOf:1:properties:details:required","descriptionNode":"$Lf69"}},"required":"$60:props:children:0:props:children:props:responses:200:content:application/json:schema:oneOf:1:required"}],"discriminator":{"propertyName":"type","mapping":{"online":"#/components/schemas/Location-Online","physical":"#/components/schemas/Location-Physical"}},"descriptionNode":"$Lf6a"}],"discriminator":{"propertyName":"type","mapping":{"online":"#/components/schemas/Location-Update-Online","physical":"#/components/schemas/Location-Update-Physical"}},"descriptionNode":"$Lf6b"},"examples":{"online_location":{"summary":"Online location example","value":{"name":"Cars website - Name update","details":{"domain":"cars.example.com"}}},"physical_location":{"summary":"Physical location example","value":{"name":"Example Street Store","details":{"opening_hours":{"monday":[{"from":"10:00","to":"18:00"}],"wednesday":[{"from":"11:00","to":"18:00"}]}}}}}}}},"variantLabels":["Online location example","Physical location example"],"children":["$Lf6c","$Lf6d"]}]}],false]}] f6c:["$","div",null,{"className":"ezz1n30","children":[["$","div",null,{"data-header":"$undefined","className":"ezz1n31","children":["$","div",null,{"className":"y9a0do1","children":[["$","h2",null,{"id":"update-location","children":[["$Lf6e","$undefined"],["$","$L15",null,{"id":"update-location"}]]}],["$","$L16",null,{"url":"/docs/api/merchant/2025-10-16/operations/update-location.md"}]]}]}],"$undefined"]}] f73:T689,
curl -X PATCH "https://merchant.revolut.com/api/locations/__RP_TOK_0__" \
  -H "Content-Type: application/json" \
  -H "Authorization: __RP_TOK_1__" \
  -d '{
  "name": "Cars website - Name update",
  "details": {
    "domain": "cars.example.com"
  }
}'
f74:Tf7a,
const payload = {
  "name": "Cars website - Name update",
  "details": {
    "domain": "cars.example.com"
  }
};
fetch("https://merchant.revolut.com/api/locations/__RP_TOK_0__", {
  method: "PATCH",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "__RP_TOK_1__"
  },
  body: JSON.stringify(payload)
})
  .then(response => response.json())
  .then(data => console.log(data));
f75:T1581,
package main

import (
  "fmt"
  "net/http"
  "bytes"
  "encoding/json"
)

func main() {
  url := "https://merchant.revolut.com/api/locations/__RP_TOK_0__"
  jsonData := []byte(`
{
  "name": "Cars website - Name update",
  "details": {
    "domain": "cars.example.com"
  }
}
  `)
  req, _ := http.NewRequest("PATCH", url, bytes.NewBuffer(jsonData))
  req.Header.Add("Content-Type", "application/json")
  req.Header.Add("Authorization", "__RP_TOK_1__")

  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  fmt.Println(res)
}
f76:Tcb0,
import requests

url = "https://merchant.revolut.com/api/locations/__RP_TOK_0__"
headers = {
  "Content-Type": "application/json",
  "Authorization": "__RP_TOK_1__"
}
payload = {
  "name": "Cars website - Name update",
  "details": {
    "domain": "cars.example.com"
  }
}

response = requests.patch(url, headers=headers, json=payload)
print(response.json())
f77:T1ae8,
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;

public class Main {
  public static void main(String[] args) {
    HttpClient client = HttpClient.newHttpClient();
    String body = """
{
  "name": "Cars website - Name update",
  "details": {
    "domain": "cars.example.com"
  }
}
    """;

    HttpRequest request = HttpRequest.newBuilder()
      .uri(URI.create("https://merchant.revolut.com/api/locations/__RP_TOK_0__"))
      .header("Content-Type", "application/json")
      .header("Authorization", "__RP_TOK_1__")
      .PATCH(HttpRequest.BodyPublishers.ofString(body))
      .build();

    client.sendAsync(request, HttpResponse.BodyHandlers.ofString())
      .thenApply(HttpResponse::body)
      .thenAccept(System.out::println)
      .join();
  }
}
f78:T1f7c,
using System.Net.Http;
using System.Net.Http.Headers;

var client = new HttpClient();
var request = new HttpRequestMessage
{
  Method = HttpMethod.Patch,
  RequestUri = new Uri("https://merchant.revolut.com/api/locations/__RP_TOK_0__"),
  Headers =
  {
    { "Authorization", "__RP_TOK_1__" },
  },
  Content = new StringContent(@"{
  ""name"": ""Cars website - Name update"",
  ""details"": {
    ""domain"": ""cars.example.com""
  }
}")
  {
    Headers =
    {
      ContentType = new MediaTypeHeaderValue("application/json")
    }
  }
};

using (var response = await client.SendAsync(request))
{
  response.EnsureSuccessStatusCode();
  var body = await response.Content.ReadAsStringAsync();
  Console.WriteLine(body);
}
f79:T691,
curl -X PATCH "https://sandbox-merchant.revolut.com/api/locations/__RP_TOK_0__" \
  -H "Content-Type: application/json" \
  -H "Authorization: __RP_TOK_1__" \
  -d '{
  "name": "Cars website - Name update",
  "details": {
    "domain": "cars.example.com"
  }
}'
f7a:Tf82,
const payload = {
  "name": "Cars website - Name update",
  "details": {
    "domain": "cars.example.com"
  }
};
fetch("https://sandbox-merchant.revolut.com/api/locations/__RP_TOK_0__", {
  method: "PATCH",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "__RP_TOK_1__"
  },
  body: JSON.stringify(payload)
})
  .then(response => response.json())
  .then(data => console.log(data));
f7b:T1589,
package main

import (
  "fmt"
  "net/http"
  "bytes"
  "encoding/json"
)

func main() {
  url := "https://sandbox-merchant.revolut.com/api/locations/__RP_TOK_0__"
  jsonData := []byte(`
{
  "name": "Cars website - Name update",
  "details": {
    "domain": "cars.example.com"
  }
}
  `)
  req, _ := http.NewRequest("PATCH", url, bytes.NewBuffer(jsonData))
  req.Header.Add("Content-Type", "application/json")
  req.Header.Add("Authorization", "__RP_TOK_1__")

  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  fmt.Println(res)
}
f7c:Tcb8,
import requests

url = "https://sandbox-merchant.revolut.com/api/locations/__RP_TOK_0__"
headers = {
  "Content-Type": "application/json",
  "Authorization": "__RP_TOK_1__"
}
payload = {
  "name": "Cars website - Name update",
  "details": {
    "domain": "cars.example.com"
  }
}

response = requests.patch(url, headers=headers, json=payload)
print(response.json())
f7d:T1af0,
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;

public class Main {
  public static void main(String[] args) {
    HttpClient client = HttpClient.newHttpClient();
    String body = """
{
  "name": "Cars website - Name update",
  "details": {
    "domain": "cars.example.com"
  }
}
    """;

    HttpRequest request = HttpRequest.newBuilder()
      .uri(URI.create("https://sandbox-merchant.revolut.com/api/locations/__RP_TOK_0__"))
      .header("Content-Type", "application/json")
      .header("Authorization", "__RP_TOK_1__")
      .PATCH(HttpRequest.BodyPublishers.ofString(body))
      .build();

    client.sendAsync(request, HttpResponse.BodyHandlers.ofString())
      .thenApply(HttpResponse::body)
      .thenAccept(System.out::println)
      .join();
  }
}
f7e:T1f84,
using System.Net.Http;
using System.Net.Http.Headers;

var client = new HttpClient();
var request = new HttpRequestMessage
{
  Method = HttpMethod.Patch,
  RequestUri = new Uri("https://sandbox-merchant.revolut.com/api/locations/__RP_TOK_0__"),
  Headers =
  {
    { "Authorization", "__RP_TOK_1__" },
  },
  Content = new StringContent(@"{
  ""name"": ""Cars website - Name update"",
  ""details"": {
    ""domain"": ""cars.example.com""
  }
}")
  {
    Headers =
    {
      ContentType = new MediaTypeHeaderValue("application/json")
    }
  }
};

using (var response = await client.SendAsync(request))
{
  response.EnsureSuccessStatusCode();
  var body = await response.Content.ReadAsStringAsync();
  Console.WriteLine(body);
}
f6d:["$","div",null,{"className":"ezz1n30","children":[["$","div",null,{"data-header":"$undefined","className":"ezz1n31","children":["$Lf6f",["$","$L85",null,{"parameters":[{"name":"Authorization","in":"header","schema":{"type":"string","format":"Bearer ","examples":"$62:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:0:schema:examples"},"required":true,"description":"This parameter accepts the [Merchant API Secret key](https://business.revolut.com/settings/apis?tab=merchant-api) to authorise requests coming from the merchant's backend. \n\nIt ensures that ensures that each request is authenticated and authorised by verifying the secret key. The secret key should be included in all request headers as a `Bearer` token.\n\n:::info\nFor more information, see: [Authentication](https://developer.revolut.com/docs/api/merchant#authentication)\n:::","descriptionNode":"$Lf70"},{"name":"location_id","schema":{"type":"string","format":"uuid","description":"A UUID string, typically used to identify resources.","descriptionNode":"$Lf71"},"in":"path","required":true,"description":"The ID of the location.","descriptionNode":"$Lf72"}],"requestBody":"$61:props:children:0:props:children:props:requestBody","heading":"Request","requestBodySchemaTitle":"Request body","headingAs":"h3"}],["$","$L89",null,{"responses":"$61:props:children:0:props:children:props:responses","headingAs":"h3"}]]}],["$","div",null,{"className":"ezz1n32","children":[[["$","$L8a",null,{"itemsByServer":{"https://merchant.revolut.com":[{"id":"curl","label":"cURL","templateCode":"curl -X PATCH \"https://merchant.revolut.com/api/locations/__RP_TOK_0__\" \\\n -H \"Content-Type: application/json\" \\\n -H \"Authorization: __RP_TOK_1__\" \\\n -d '{\n \"name\": \"Cars website - Name update\",\n \"details\": {\n \"domain\": \"cars.example.com\"\n }\n}'","templateHtml":"$f73","tokens":[{"marker":"__RP_TOK_0__","paramName":"location_id","paramIn":"path","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["shell-double-inner"]}],"defaults":{"header:Authorization":"Bearer ","path:location_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"javascript","label":"JavaScript","templateCode":"const payload = {\n \"name\": \"Cars website - Name update\",\n \"details\": {\n \"domain\": \"cars.example.com\"\n }\n};\nfetch(\"https://merchant.revolut.com/api/locations/__RP_TOK_0__\", {\n method: \"PATCH\",\n headers: {\n \"Content-Type\": \"application/json\",\n \"Authorization\": \"__RP_TOK_1__\"\n },\n body: JSON.stringify(payload)\n})\n .then(response => response.json())\n .then(data => console.log(data));","templateHtml":"$f74","tokens":[{"marker":"__RP_TOK_0__","paramName":"location_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","path:location_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"go","label":"Go","templateCode":"package main\n\nimport (\n \"fmt\"\n \"net/http\"\n \"bytes\"\n \"encoding/json\"\n)\n\nfunc main() {\n url := \"https://merchant.revolut.com/api/locations/__RP_TOK_0__\"\n jsonData := []byte(`\n{\n \"name\": \"Cars website - Name update\",\n \"details\": {\n \"domain\": \"cars.example.com\"\n }\n}\n `)\n req, _ := http.NewRequest(\"PATCH\", url, bytes.NewBuffer(jsonData))\n req.Header.Add(\"Content-Type\", \"application/json\")\n req.Header.Add(\"Authorization\", \"__RP_TOK_1__\")\n\n res, _ := http.DefaultClient.Do(req)\n defer res.Body.Close()\n fmt.Println(res)\n}","templateHtml":"$f75","tokens":[{"marker":"__RP_TOK_0__","paramName":"location_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","path:location_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"python","label":"Python","templateCode":"import requests\n\nurl = \"https://merchant.revolut.com/api/locations/__RP_TOK_0__\"\nheaders = {\n \"Content-Type\": \"application/json\",\n \"Authorization\": \"__RP_TOK_1__\"\n}\npayload = {\n \"name\": \"Cars website - Name update\",\n \"details\": {\n \"domain\": \"cars.example.com\"\n }\n}\n\nresponse = requests.patch(url, headers=headers, json=payload)\nprint(response.json())","templateHtml":"$f76","tokens":[{"marker":"__RP_TOK_0__","paramName":"location_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","path:location_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"java","label":"Java","templateCode":"import java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\nimport java.net.URI;\n\npublic class Main {\n public static void main(String[] args) {\n HttpClient client = HttpClient.newHttpClient();\n String body = \"\"\"\n{\n \"name\": \"Cars website - Name update\",\n \"details\": {\n \"domain\": \"cars.example.com\"\n }\n}\n \"\"\";\n\n HttpRequest request = HttpRequest.newBuilder()\n .uri(URI.create(\"https://merchant.revolut.com/api/locations/__RP_TOK_0__\"))\n .header(\"Content-Type\", \"application/json\")\n .header(\"Authorization\", \"__RP_TOK_1__\")\n .PATCH(HttpRequest.BodyPublishers.ofString(body))\n .build();\n\n client.sendAsync(request, HttpResponse.BodyHandlers.ofString())\n .thenApply(HttpResponse::body)\n .thenAccept(System.out::println)\n .join();\n }\n}","templateHtml":"$f77","tokens":[{"marker":"__RP_TOK_0__","paramName":"location_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","path:location_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"csharp","label":"C#","templateCode":"using System.Net.Http;\nusing System.Net.Http.Headers;\n\nvar client = new HttpClient();\nvar request = new HttpRequestMessage\n{\n Method = HttpMethod.Patch,\n RequestUri = new Uri(\"https://merchant.revolut.com/api/locations/__RP_TOK_0__\"),\n Headers =\n {\n { \"Authorization\", \"__RP_TOK_1__\" },\n },\n Content = new StringContent(@\"{\n \"\"name\"\": \"\"Cars website - Name update\"\",\n \"\"details\"\": {\n \"\"domain\"\": \"\"cars.example.com\"\"\n }\n}\")\n {\n Headers =\n {\n ContentType = new MediaTypeHeaderValue(\"application/json\")\n }\n }\n};\n\nusing (var response = await client.SendAsync(request))\n{\n response.EnsureSuccessStatusCode();\n var body = await response.Content.ReadAsStringAsync();\n Console.WriteLine(body);\n}","templateHtml":"$f78","tokens":[{"marker":"__RP_TOK_0__","paramName":"location_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","path:location_id":"123e4567-e89b-12d3-a456-426614174000"}}],"https://sandbox-merchant.revolut.com":[{"id":"curl","label":"cURL","templateCode":"curl -X PATCH \"https://sandbox-merchant.revolut.com/api/locations/__RP_TOK_0__\" \\\n -H \"Content-Type: application/json\" \\\n -H \"Authorization: __RP_TOK_1__\" \\\n -d '{\n \"name\": \"Cars website - Name update\",\n \"details\": {\n \"domain\": \"cars.example.com\"\n }\n}'","templateHtml":"$f79","tokens":[{"marker":"__RP_TOK_0__","paramName":"location_id","paramIn":"path","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["shell-double-inner"]}],"defaults":{"header:Authorization":"Bearer ","path:location_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"javascript","label":"JavaScript","templateCode":"const payload = {\n \"name\": \"Cars website - Name update\",\n \"details\": {\n \"domain\": \"cars.example.com\"\n }\n};\nfetch(\"https://sandbox-merchant.revolut.com/api/locations/__RP_TOK_0__\", {\n method: \"PATCH\",\n headers: {\n \"Content-Type\": \"application/json\",\n \"Authorization\": \"__RP_TOK_1__\"\n },\n body: JSON.stringify(payload)\n})\n .then(response => response.json())\n .then(data => console.log(data));","templateHtml":"$f7a","tokens":[{"marker":"__RP_TOK_0__","paramName":"location_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","path:location_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"go","label":"Go","templateCode":"package main\n\nimport (\n \"fmt\"\n \"net/http\"\n \"bytes\"\n \"encoding/json\"\n)\n\nfunc main() {\n url := \"https://sandbox-merchant.revolut.com/api/locations/__RP_TOK_0__\"\n jsonData := []byte(`\n{\n \"name\": \"Cars website - Name update\",\n \"details\": {\n \"domain\": \"cars.example.com\"\n }\n}\n `)\n req, _ := http.NewRequest(\"PATCH\", url, bytes.NewBuffer(jsonData))\n req.Header.Add(\"Content-Type\", \"application/json\")\n req.Header.Add(\"Authorization\", \"__RP_TOK_1__\")\n\n res, _ := http.DefaultClient.Do(req)\n defer res.Body.Close()\n fmt.Println(res)\n}","templateHtml":"$f7b","tokens":[{"marker":"__RP_TOK_0__","paramName":"location_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","path:location_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"python","label":"Python","templateCode":"import requests\n\nurl = \"https://sandbox-merchant.revolut.com/api/locations/__RP_TOK_0__\"\nheaders = {\n \"Content-Type\": \"application/json\",\n \"Authorization\": \"__RP_TOK_1__\"\n}\npayload = {\n \"name\": \"Cars website - Name update\",\n \"details\": {\n \"domain\": \"cars.example.com\"\n }\n}\n\nresponse = requests.patch(url, headers=headers, json=payload)\nprint(response.json())","templateHtml":"$f7c","tokens":[{"marker":"__RP_TOK_0__","paramName":"location_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","path:location_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"java","label":"Java","templateCode":"import java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\nimport java.net.URI;\n\npublic class Main {\n public static void main(String[] args) {\n HttpClient client = HttpClient.newHttpClient();\n String body = \"\"\"\n{\n \"name\": \"Cars website - Name update\",\n \"details\": {\n \"domain\": \"cars.example.com\"\n }\n}\n \"\"\";\n\n HttpRequest request = HttpRequest.newBuilder()\n .uri(URI.create(\"https://sandbox-merchant.revolut.com/api/locations/__RP_TOK_0__\"))\n .header(\"Content-Type\", \"application/json\")\n .header(\"Authorization\", \"__RP_TOK_1__\")\n .PATCH(HttpRequest.BodyPublishers.ofString(body))\n .build();\n\n client.sendAsync(request, HttpResponse.BodyHandlers.ofString())\n .thenApply(HttpResponse::body)\n .thenAccept(System.out::println)\n .join();\n }\n}","templateHtml":"$f7d","tokens":[{"marker":"__RP_TOK_0__","paramName":"location_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","path:location_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"csharp","label":"C#","templateCode":"using System.Net.Http;\nusing System.Net.Http.Headers;\n\nvar client = new HttpClient();\nvar request = new HttpRequestMessage\n{\n Method = HttpMethod.Patch,\n RequestUri = new Uri(\"https://sandbox-merchant.revolut.com/api/locations/__RP_TOK_0__\"),\n Headers =\n {\n { \"Authorization\", \"__RP_TOK_1__\" },\n },\n Content = new StringContent(@\"{\n \"\"name\"\": \"\"Cars website - Name update\"\",\n \"\"details\"\": {\n \"\"domain\"\": \"\"cars.example.com\"\"\n }\n}\")\n {\n Headers =\n {\n ContentType = new MediaTypeHeaderValue(\"application/json\")\n }\n }\n};\n\nusing (var response = await client.SendAsync(request))\n{\n response.EnsureSuccessStatusCode();\n var body = await response.Content.ReadAsStringAsync();\n Console.WriteLine(body);\n}","templateHtml":"$f7e","tokens":[{"marker":"__RP_TOK_0__","paramName":"location_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","path:location_id":"123e4567-e89b-12d3-a456-426614174000"}}]},"method":"patch","servers":"$62:props:children:0:props:children:props:children:1:props:children:1:props:children:0:0:props:servers","path":"/api/locations/{location_id}","parameters":["$f6d:props:children:0:props:children:1:props:parameters:0","$f6d:props:children:0:props:children:1:props:parameters:1"]}],"$Lf7f"],"$Lf80","$Lf81"]}]]}] 2f:["$","$7a","create-subscription-plan",{"children":[["$","section",null,{"className":"y9a0do0","data-variant":"endpoint","children":["$","$L7b",null,{"responses":{"201":{"description":"Subscription plan created successfully","content":{"application/json":{"schema":{"type":"object","required":"$31:props:children:0:props:children:props:responses:200:content:application/json:schema:required","properties":{"id":{"type":"string","format":"uuid","description":"Unique identifier for the subscription plan.","descriptionNode":"$Lf82"},"name":{"type":"string","minLength":1,"maxLength":1024,"description":"The name of the subscription plan.","descriptionNode":"$Lf83"},"trial_duration":{"type":"string","format":"duration","description":"The default trial period duration for this subscription plan in [ISO 8601 duration format](https://en.wikipedia.org/wiki/ISO_8601#Durations) (e.g., \"P14D\" for 14 days).\n\nThis value serves as the default trial duration for all subscriptions created from this plan. Individual subscriptions can override this value at creation time.\n\n:::note\nOnly days (`D`) are allowed. Time components such as hours, minutes, or seconds are not permitted.\n:::","pattern":"^P[0-9]+D$","examples":"$31:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:trial_duration:examples","descriptionNode":"$Lf84"},"state":{"type":"string","enum":"$31:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:state:enum","description":"The state of the subscription plan.\n\n| State | Description |\n| ----- | ----------- |\n| `active` | The plan is active and can be used to create new subscriptions. |\n| `deactivated` | The plan has been deactivated and cannot be used for new subscriptions. |","descriptionNode":"$Lf85"},"created_at":{"type":"string","format":"date-time","description":"The date and time the subscription plan was created in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format.","descriptionNode":"$Lf86"},"updated_at":{"type":"string","format":"date-time","description":"The date and time the subscription plan was last updated in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format.","descriptionNode":"$Lf87"},"variations":{"type":"array","description":"List of subscription plan variations.","items":{"type":"object","required":"$31:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:variations:items:required","properties":{"id":{"type":"string","format":"uuid","description":"Unique identifier for the subscription plan variation.","descriptionNode":"$Lf88"},"phases":{"type":"array","description":"List of billing phases for this variation.","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Unique identifier for the subscription plan phase.","descriptionNode":"$Lf89"},"ordinal":{"type":"integer","minimum":1,"description":"The sequential order of this phase in the subscription billing lifecycle.\n\nPhases execute in ascending order based on this value:\n- Phase with `ordinal=1` executes first\n- Phase with `ordinal=2` executes second, and so on\n\nWhen a phase completes its `cycle_count`, the subscription automatically progresses to the phase with the next `ordinal` value.\n\n**Example**: A subscription with phases ordered as `ordinal=1` (trial), `ordinal=2` (regular), `ordinal=3` (discounted) will progress through them in that sequence.","title":"Subscription-Plan-Ordinal","descriptionNode":"$Lf8a"},"cycle_duration":{"type":"string","format":"duration","description":"The length of each billing cycle for this phase in [ISO 8601 duration format](https://en.wikipedia.org/wiki/ISO_8601#Durations).\n\nThis determines how often the customer is billed during this phase. The total time spent in a phase is `cycle_duration × cycle_count`.\n\n**Common durations**:\n\n| Duration | Description |\n| -------- | ----------- |\n| `P1M` | 1 month |\n| `P1Y` | 1 year |\n| `P15D` | 15 days |\n| `P1W` | 1 week |\n| `PT2H` | 2 hours |\n\n**Example**: If `cycle_duration=P1M` and `cycle_count=12`, the customer will be billed monthly for 12 months (1 year total).","descriptionNode":"$Lf8b"},"cycle_count":{"type":"$31:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:variations:items:properties:phases:items:properties:cycle_count:type","minimum":1,"description":"Number of billing cycles for this phase before moving to the next phase.\n\n| Value | Behavior |\n| ----- | -------- |\n| `null` or omitted | Phase continues indefinitely. The subscription remains in this phase with no automatic progression. |\n| Specific number (e.g., `1`, `3`, `12`) | After completing this many billing cycles, the subscription automatically moves to the next phase as determined by the `ordinal` field. |\n\n**Example**: If `cycle_count=3` and `cycle_duration=P1M`, the subscription will complete 3 monthly cycles then move to the phase with the next highest `ordinal` value.\n\n:::note\nIf no next phase exists in after a cycle with a specific `cycle_count`, the subscription will automatically stop when it completes its cycles.\n:::","title":"Cycle-Count","descriptionNode":"$Lf8c"},"amount":{"type":"integer","minimum":0,"description":"Subscription amount in minor currency units (e.g., cents for USD, pence for GBP).\n\nFor example, `9900` in `GBP` represents £99.00.\n\n:::info\nConversion between major and minor units varies by currency. For instance, `100` minor units equal £1.00 in `GBP`, whereas in `ISK` they represent 100 units. For more details, see the [ISO 4217 standard](https://en.wikipedia.org/wiki/ISO_4217).\n:::","descriptionNode":"$Lf8d"},"currency":{"type":"string","format":"ISO 4217","minLength":3,"maxLength":3,"description":"[ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) currency code in upper case.\n\n:::info\nFor more information about the supported currencies, see: [Help Center](https://help.revolut.com/business/help/merchant-accounts/payments/in-which-currencies-can-i-accept-payments/).\n:::","descriptionNode":"$Lf8e"},"subscription_items":{"type":"array","description":"A list of subscription items for this phase.","items":{"title":"Subscription item","type":"object","description":"A subscription item that defines a billing line within a plan phase. Can be either a fixed-fee (flat) item or a metered (usage) item.","discriminator":"$31:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:variations:items:properties:phases:items:properties:subscription_items:items:discriminator","oneOf":[{"type":"object","description":"Object structure of flat subscription item.","properties":{"id":{"type":"string","format":"uuid","description":"The unique identifier of the subscription item.","descriptionNode":"$Lf8f"},"name":{"type":"string","description":"The name of the subscription item.","maxLength":250,"examples":"$31:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:variations:items:properties:phases:items:properties:subscription_items:items:oneOf:0:properties:name:examples","descriptionNode":"$Lf90"},"type":{"type":"string","description":"The type of subscription item.","enum":"$31:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:variations:items:properties:phases:items:properties:subscription_items:items:oneOf:0:properties:type:enum","examples":"$31:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:variations:items:properties:phases:items:properties:subscription_items:items:oneOf:0:properties:type:examples","descriptionNode":"$Lf91"},"package_size":{"type":"number","description":"The number of units grouped together as a single billable package. Used to enable pricing of items that are too inexpensive to charge individually.\n\nFor example, a `package_size` of `1000` with a unit price of 10 minor units (£0.10 in GBP) lets you sell 1000 tokens for £0.10 — effectively pricing each token at £0.0001, below the minimum chargeable amount.\n\nSet to `1` to price each unit individually.","examples":"$31:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:variations:items:properties:phases:items:properties:subscription_items:items:oneOf:0:properties:package_size:examples","descriptionNode":"$Lf92"},"unit":{"type":"string","description":"The unit of measurement for the item.","maxLength":100,"examples":"$31:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:variations:items:properties:phases:items:properties:subscription_items:items:oneOf:0:properties:unit:examples","descriptionNode":"$Lf93"},"quantity":{"type":"number","description":"The quantity of the item.","examples":"$31:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:variations:items:properties:phases:items:properties:subscription_items:items:oneOf:0:properties:quantity:examples","descriptionNode":"$Lf94"},"amount":{"type":"integer","description":"Amount in minor currency units (e.g., cents for USD).","examples":"$31:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:variations:items:properties:phases:items:properties:subscription_items:items:oneOf:0:properties:amount:examples","descriptionNode":"$Lf95"},"currency":{"type":"string","format":"ISO 4217","minLength":3,"maxLength":3,"description":"[ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) currency code in upper case.\n\n:::info\nFor more information about the supported currencies, see: [Help Center](https://help.revolut.com/business/help/merchant-accounts/payments/in-which-currencies-can-i-accept-payments/).\n:::","descriptionNode":"$Lf96"}},"required":"$31:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:variations:items:properties:phases:items:properties:subscription_items:items:oneOf:0:required","descriptionNode":"$Lf97"},{"type":"object","description":"Object structure of usage subscription item.","properties":{"id":{"type":"string","format":"uuid","description":"The unique identifier of the subscription item.","descriptionNode":"$Lf98"},"name":{"type":"string","description":"The name of the subscription item.","maxLength":250,"examples":"$31:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:variations:items:properties:phases:items:properties:subscription_items:items:oneOf:0:properties:name:examples","descriptionNode":"$Lf99"},"type":{"type":"string","description":"The type of subscription item.","enum":"$31:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:variations:items:properties:phases:items:properties:subscription_items:items:oneOf:0:properties:type:enum","examples":"$31:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:variations:items:properties:phases:items:properties:subscription_items:items:oneOf:0:properties:type:examples","descriptionNode":"$Lf9a"},"package_size":{"type":"number","description":"The number of units grouped together as a single billable package. Used to enable pricing of items that are too inexpensive to charge individually.\n\nFor example, a `package_size` of `1000` with a unit price of 10 minor units (£0.10 in GBP) lets you sell 1000 tokens for £0.10 — effectively pricing each token at £0.0001, below the minimum chargeable amount.\n\nSet to `1` to price each unit individually.","examples":"$31:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:variations:items:properties:phases:items:properties:subscription_items:items:oneOf:0:properties:package_size:examples","descriptionNode":"$Lf9b"},"unit":{"type":"string","description":"The unit of measurement for the item.","maxLength":100,"examples":"$31:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:variations:items:properties:phases:items:properties:subscription_items:items:oneOf:0:properties:unit:examples","descriptionNode":"$Lf9c"},"amount":{"type":"integer","description":"Flat amount per unit in minor currency units. Mutually exclusive with `tiers`.","examples":"$31:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:variations:items:properties:phases:items:properties:subscription_items:items:oneOf:1:properties:amount:examples","descriptionNode":"$Lf9d"},"currency":{"type":"string","format":"ISO 4217","minLength":3,"maxLength":3,"description":"[ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) currency code in upper case.\n\n:::info\nFor more information about the supported currencies, see: [Help Center](https://help.revolut.com/business/help/merchant-accounts/payments/in-which-currencies-can-i-accept-payments/).\n:::","descriptionNode":"$Lf9e"},"tiers":{"type":"array","description":"Graduated pricing tiers. Mutually exclusive with `amount`.","items":{"type":"object","properties":{"upper_quantity_threshold":{"type":"$31:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:variations:items:properties:phases:items:properties:subscription_items:items:oneOf:1:properties:tiers:items:properties:upper_quantity_threshold:type","description":"The upper bound of the tier (exclusive). Null means unlimited.","examples":"$31:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:variations:items:properties:phases:items:properties:subscription_items:items:oneOf:1:properties:tiers:items:properties:upper_quantity_threshold:examples","descriptionNode":"$Lf9f"},"amount":{"type":"integer","description":"Per-unit amount in minor currency units (e.g., cents for USD) charged for usage within this tier's threshold range.","examples":"$31:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:variations:items:properties:phases:items:properties:subscription_items:items:oneOf:1:properties:tiers:items:properties:amount:examples","descriptionNode":"$Lfa0"}},"required":"$31:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:variations:items:properties:phases:items:properties:subscription_items:items:oneOf:1:properties:tiers:items:required"},"descriptionNode":"$Lfa1"},"code":{"type":"string","description":"A merchant-defined identifier for a usage-based subscription item. You set this code on each usage item when creating a subscription plan, and supply it when reporting consumption on [Create a subscription usage endpoint](https://developer.revolut.com/docs/api/merchant#create-subscription-usage) to target the correct metered item.\n\nThis allows a subscription with multiple usage items (e.g., `api_calls` and `storage_gb`) to receive consumption reports against the right item without relying on internal IDs.\n\nThe code must be unique within a plan phase.","maxLength":250,"examples":"$3d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:subscription_item_code:examples","descriptionNode":"$Lfa2"},"usage_aggregation_method":{"type":"string","description":"The method used to aggregate usage events over a billing cycle to calculate the chargeable amount.\n\n| Value | Behaviour |\n| ----- | --------- |\n| `sum` | Totals all reported usage events during the cycle. Use for cumulative metrics (e.g., API calls, data transferred). |\n| `latest` | Uses the most recently reported value at the end of the cycle. If no usage is reported in a cycle, `0` is used — values do not carry over from previous cycles. Use for gauge-style metrics (e.g., active seats). |\n| `max` | Uses the peak value reported during the cycle. Use for capacity-based billing (e.g., max concurrent connections). |","enum":"$31:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:variations:items:properties:phases:items:properties:subscription_items:items:oneOf:1:properties:usage_aggregation_method:enum","examples":"$31:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:variations:items:properties:phases:items:properties:subscription_items:items:oneOf:1:properties:usage_aggregation_method:examples","descriptionNode":"$Lfa3"}},"required":"$31:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:variations:items:properties:phases:items:properties:subscription_items:items:oneOf:1:required","descriptionNode":"$Lfa4"}],"descriptionNode":"$Lfa5"},"descriptionNode":"$Lfa6"}},"required":"$31:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:variations:items:properties:phases:items:required"},"descriptionNode":"$Lfa7"}}},"descriptionNode":"$Lfa8"}}},"examples":{"simple_plan":{"summary":"Simple yearly and monthly plan","value":"$31:props:children:0:props:children:props:responses:200:content:application/json:examples:simple_plan:value"},"trial_plan_with_duration":{"summary":"Plan with trial duration","value":"$31:props:children:0:props:children:props:responses:200:content:application/json:examples:trial_plan_with_duration:value"},"limited_plan":{"summary":"Plan that ends after 12 months","value":"$31:props:children:0:props:children:props:responses:200:content:application/json:examples:limited_plan:value"},"usage_base_plan":{"summary":"Usage-based plan with tiered pricing","value":{"id":"8d2c8872-9e8a-4b1a-827c-3f78e1234abc","name":"API Usage Plan","state":"active","created_at":"2026-04-15T17:58:36.000Z","updated_at":"2026-04-15T17:58:36.000Z","variations":[{"id":"a4e0a171-4f4e-484b-b0a2-22085059df99","phases":[{"id":"ceed2491-c895-4bfa-ba05-a3a088842e11","ordinal":1,"cycle_duration":"P1M","subscription_items":[{"name":"API Calls","type":"usage","currency":"GBP","unit":"calls","code":"api_calls","usage_aggregation_method":"sum","tiers":[{"upper_quantity_threshold":1000,"amount":0},{"upper_quantity_threshold":10000,"amount":10},{"amount":5}]}]}]}]}},"hybrid_plan":{"summary":"Hybrid plan with flat base fee and usage-based items","value":{"id":"b22198c4-724d-4e9e-b9e3-827c3f78e456","name":"Professional Plan","state":"active","created_at":"2026-04-15T18:02:11.000Z","updated_at":"2026-04-15T18:02:11.000Z","variations":[{"id":"d4e0a171-4f4e-484b-b0a2-22085059df77","phases":[{"id":"ffeed491-c895-4bfa-ba05-a3a088842e22","ordinal":1,"cycle_duration":"P1M","subscription_items":[{"name":"Base Subscription","type":"flat","quantity":1,"amount":2900,"currency":"GBP","unit":"subscription"},{"name":"API Calls","type":"usage","currency":"GBP","unit":"calls","code":"api_calls","usage_aggregation_method":"sum","amount":10},{"name":"Storage","type":"usage","currency":"GBP","unit":"gb","code":"storage_gb","usage_aggregation_method":"max","package_size":1,"tiers":[{"upper_quantity_threshold":10,"amount":0},{"upper_quantity_threshold":100,"amount":50},{"amount":30}]}]}]}]}},"package_plan":{"summary":"Usage-based plan with block pricing (price per 1000 units)","value":{"id":"e33198c4-124d-4e9e-b9e3-827c3f78e789","name":"SMS Plan","state":"active","created_at":"2026-04-15T18:05:42.000Z","updated_at":"2026-04-15T18:05:42.000Z","variations":[{"id":"c4e0a171-4f4e-484b-b0a2-22085059df44","phases":[{"id":"ddeed491-c895-4bfa-ba05-a3a088842e33","ordinal":1,"cycle_duration":"P1M","subscription_items":[{"name":"SMS Messages","type":"usage","currency":"GBP","unit":"messages","code":"sms_messages","usage_aggregation_method":"sum","package_size":1000,"amount":500}]}]}]}},"items_plan":{"summary":"Plan with flat and usage-based subscription items","value":{"id":"a1b2c3d4-e5f6-7890-abcd-ef1234567890","name":"Professional Platform Plan","state":"active","created_at":"2026-01-10T09:00:00.000000Z","updated_at":"2026-01-10T09:00:00.000000Z","variations":[{"id":"b2c3d4e5-f6a7-8901-bcde-f12345678901","phases":[{"id":"c3d4e5f6-a7b8-9012-cdef-123456789012","ordinal":1,"cycle_duration":"P1M","amount":4900,"currency":"GBP","subscription_items":[{"id":"d4e5f6a7-b8c9-0123-defa-234567890123","type":"flat","name":"Platform License","unit":"subscription","quantity":1,"amount":4900,"currency":"GBP"},{"id":"e5f6a7b8-c9d0-1234-efab-345678901234","type":"usage","name":"API Calls","unit":"call","code":"api_calls","usage_aggregation_method":"sum","amount":1,"currency":"GBP"}]}]}]}}}}},"descriptionNode":"$Lfa9"},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"code":{"type":"string","description":"An identifier that can be used to determine what went wrong.\n\nError codes are not globally unique, but uniqueness is guaranteed within endpoints.","descriptionNode":"$Lfaa"},"message":{"type":"string","description":"Some human readable text describing what went wrong.","descriptionNode":"$Lfab"},"timestamp":{"type":"integer","description":"The [UNIX timestamp](https://www.unixtimestamp.com/) of the date and time the error happened.","descriptionNode":"$Lfac"}}}}},"descriptionNode":"$Lfad"},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"code":{"type":"string","description":"An identifier that can be used to determine what went wrong.\n\nError codes are not globally unique, but uniqueness is guaranteed within endpoints.","descriptionNode":"$Lfae"},"message":{"type":"string","description":"Some human readable text describing what went wrong.","descriptionNode":"$Lfaf"},"timestamp":{"type":"integer","description":"The [UNIX timestamp](https://www.unixtimestamp.com/) of the date and time the error happened.","descriptionNode":"$Lfb0"}}}}},"descriptionNode":"$Lfb1"},"default":{"description":"Error response","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"code":{"type":"string","description":"An identifier that can be used to determine what went wrong.\n\nError codes are not globally unique, but uniqueness is guaranteed within endpoints.","descriptionNode":"$Lfb2"},"message":{"type":"string","description":"Some human readable text describing what went wrong.","descriptionNode":"$Lfb3"},"timestamp":{"type":"integer","description":"The [UNIX timestamp](https://www.unixtimestamp.com/) of the date and time the error happened.","descriptionNode":"$Lfb4"}}}}},"descriptionNode":"$Lfb5"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["name","variations"],"properties":{"name":{"type":"string","minLength":1,"maxLength":1024,"description":"The name of the subscription plan.","descriptionNode":"$Lfb6"},"trial_duration":{"type":"string","format":"duration","description":"The default trial period duration for this subscription plan in [ISO 8601 duration format](https://en.wikipedia.org/wiki/ISO_8601#Durations) (e.g., \"P14D\" for 14 days).\n\nThis value serves as the default trial duration for all subscriptions created from this plan. Individual subscriptions can override this value at creation time.\n\n:::note\nOnly days (`D`) are allowed. Time components such as hours, minutes, or seconds are not permitted.\n:::","pattern":"^P[0-9]+D$","examples":"$31:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:trial_duration:examples","descriptionNode":"$Lfb7"},"variations":{"type":"array","minItems":1,"description":"List of subscription plan variations (e.g., monthly, yearly pricing options).","items":{"type":"object","required":["phases"],"properties":{"phases":{"type":"array","minItems":1,"description":"List of billing phases for this variation.","items":{"type":"object","properties":{"ordinal":{"type":"integer","minimum":1,"description":"The sequential order of this phase in the subscription billing lifecycle.\n\nPhases execute in ascending order based on this value:\n- Phase with `ordinal=1` executes first\n- Phase with `ordinal=2` executes second, and so on\n\nWhen a phase completes its `cycle_count`, the subscription automatically progresses to the phase with the next `ordinal` value.\n\n**Example**: A subscription with phases ordered as `ordinal=1` (trial), `ordinal=2` (regular), `ordinal=3` (discounted) will progress through them in that sequence.","title":"Subscription-Plan-Ordinal","descriptionNode":"$Lfb8"},"cycle_duration":{"type":"string","format":"duration","description":"The length of each billing cycle for this phase in [ISO 8601 duration format](https://en.wikipedia.org/wiki/ISO_8601#Durations).\n\nThis determines how often the customer is billed during this phase. The total time spent in a phase is `cycle_duration × cycle_count`.\n\n**Common durations**:\n\n| Duration | Description |\n| -------- | ----------- |\n| `P1M` | 1 month |\n| `P1Y` | 1 year |\n| `P15D` | 15 days |\n| `P1W` | 1 week |\n| `PT2H` | 2 hours |\n\n**Example**: If `cycle_duration=P1M` and `cycle_count=12`, the customer will be billed monthly for 12 months (1 year total).","descriptionNode":"$Lfb9"},"cycle_count":{"type":"$31:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:variations:items:properties:phases:items:properties:cycle_count:type","minimum":1,"description":"Number of billing cycles for this phase before moving to the next phase.\n\n| Value | Behavior |\n| ----- | -------- |\n| `null` or omitted | Phase continues indefinitely. The subscription remains in this phase with no automatic progression. |\n| Specific number (e.g., `1`, `3`, `12`) | After completing this many billing cycles, the subscription automatically moves to the next phase as determined by the `ordinal` field. |\n\n**Example**: If `cycle_count=3` and `cycle_duration=P1M`, the subscription will complete 3 monthly cycles then move to the phase with the next highest `ordinal` value.\n\n:::note\nIf no next phase exists in after a cycle with a specific `cycle_count`, the subscription will automatically stop when it completes its cycles.\n:::","title":"Cycle-Count","descriptionNode":"$Lfba"},"amount":{"type":"integer","minimum":0,"description":"Subscription amount in minor currency units (e.g., cents for USD, pence for GBP).\n\nFor example, `9900` in `GBP` represents £99.00.\n\n:::info\nConversion between major and minor units varies by currency. For instance, `100` minor units equal £1.00 in `GBP`, whereas in `ISK` they represent 100 units. For more details, see the [ISO 4217 standard](https://en.wikipedia.org/wiki/ISO_4217).\n:::","descriptionNode":"$Lfbb"},"currency":{"type":"string","format":"ISO 4217","minLength":3,"maxLength":3,"description":"[ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) currency code in upper case.\n\n:::info\nFor more information about the supported currencies, see: [Help Center](https://help.revolut.com/business/help/merchant-accounts/payments/in-which-currencies-can-i-accept-payments/).\n:::","descriptionNode":"$Lfbc"},"subscription_items":{"type":"array","description":"A list of subscription items for this phase.","items":{"title":"Subscription item","type":"object","description":"A subscription item for a plan phase. Can be either a fixed-fee (flat) item or a metered (usage) item.","discriminator":{"propertyName":"type","mapping":{"flat":"#/components/schemas/Subscription-Item-Flat-Creation","usage":"#/components/schemas/Subscription-Item-Usage-Creation"}},"oneOf":[{"type":"object","description":"Object structure of flat subscription item.","properties":{"name":{"type":"string","description":"The name of the subscription item.","maxLength":250,"examples":"$31:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:variations:items:properties:phases:items:properties:subscription_items:items:oneOf:0:properties:name:examples","descriptionNode":"$Lfbd"},"type":{"type":"string","description":"The type of subscription item.","enum":"$31:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:variations:items:properties:phases:items:properties:subscription_items:items:oneOf:0:properties:type:enum","examples":"$31:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:variations:items:properties:phases:items:properties:subscription_items:items:oneOf:0:properties:type:examples","descriptionNode":"$Lfbe"},"package_size":{"type":"number","description":"The number of units grouped together as a single billable package. Used to enable pricing of items that are too inexpensive to charge individually.\n\nFor example, a `package_size` of `1000` with a unit price of 10 minor units (£0.10 in GBP) lets you sell 1000 tokens for £0.10 — effectively pricing each token at £0.0001, below the minimum chargeable amount.\n\nSet to `1` to price each unit individually.","examples":"$31:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:variations:items:properties:phases:items:properties:subscription_items:items:oneOf:0:properties:package_size:examples","descriptionNode":"$Lfbf"},"unit":{"type":"string","description":"The unit of measurement for the item.","maxLength":100,"examples":"$31:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:variations:items:properties:phases:items:properties:subscription_items:items:oneOf:0:properties:unit:examples","descriptionNode":"$Lfc0"},"quantity":{"type":"number","description":"The quantity of the item.","examples":"$31:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:variations:items:properties:phases:items:properties:subscription_items:items:oneOf:0:properties:quantity:examples","descriptionNode":"$Lfc1"},"amount":{"type":"integer","description":"Amount in minor currency units (e.g., cents for USD).","examples":[9900],"descriptionNode":"$Lfc2"},"currency":{"type":"string","format":"ISO 4217","minLength":3,"maxLength":3,"description":"[ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) currency code in upper case.\n\n:::info\nFor more information about the supported currencies, see: [Help Center](https://help.revolut.com/business/help/merchant-accounts/payments/in-which-currencies-can-i-accept-payments/).\n:::","descriptionNode":"$Lfc3"}},"required":["name","type","amount","currency","unit","quantity"],"descriptionNode":"$Lfc4"},{"type":"object","description":"Object structure for usage subscription item.","properties":{"name":{"type":"string","description":"The name of the subscription item.","maxLength":250,"examples":"$31:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:variations:items:properties:phases:items:properties:subscription_items:items:oneOf:0:properties:name:examples","descriptionNode":"$Lfc5"},"type":{"type":"string","description":"The type of subscription item.","enum":"$31:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:variations:items:properties:phases:items:properties:subscription_items:items:oneOf:0:properties:type:enum","examples":"$31:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:variations:items:properties:phases:items:properties:subscription_items:items:oneOf:0:properties:type:examples","descriptionNode":"$Lfc6"},"package_size":{"type":"number","description":"The number of units grouped together as a single billable package. Used to enable pricing of items that are too inexpensive to charge individually.\n\nFor example, a `package_size` of `1000` with a unit price of 10 minor units (£0.10 in GBP) lets you sell 1000 tokens for £0.10 — effectively pricing each token at £0.0001, below the minimum chargeable amount.\n\nSet to `1` to price each unit individually.","examples":"$31:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:variations:items:properties:phases:items:properties:subscription_items:items:oneOf:0:properties:package_size:examples","descriptionNode":"$Lfc7"},"unit":{"type":"string","description":"The unit of measurement for the item.","maxLength":100,"examples":"$31:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:variations:items:properties:phases:items:properties:subscription_items:items:oneOf:0:properties:unit:examples","descriptionNode":"$Lfc8"},"amount":{"type":"integer","description":"Flat amount per unit in minor currency units. Mutually exclusive with `tiers`.","examples":[10],"descriptionNode":"$Lfc9"},"currency":{"type":"string","format":"ISO 4217","minLength":3,"maxLength":3,"description":"[ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) currency code in upper case.\n\n:::info\nFor more information about the supported currencies, see: [Help Center](https://help.revolut.com/business/help/merchant-accounts/payments/in-which-currencies-can-i-accept-payments/).\n:::","descriptionNode":"$Lfca"},"tiers":{"type":"array","description":"Graduated pricing tiers. Mutually exclusive with `amount`.","items":{"type":"object","properties":{"upper_quantity_threshold":{"type":"$31:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:variations:items:properties:phases:items:properties:subscription_items:items:oneOf:1:properties:tiers:items:properties:upper_quantity_threshold:type","description":"The upper bound of the tier (exclusive). Null means unlimited.","examples":"$31:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:variations:items:properties:phases:items:properties:subscription_items:items:oneOf:1:properties:tiers:items:properties:upper_quantity_threshold:examples","descriptionNode":"$Lfcb"},"amount":{"type":"integer","description":"Per-unit amount in minor currency units (e.g., cents for USD) charged for usage within this tier's threshold range.","examples":"$31:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:variations:items:properties:phases:items:properties:subscription_items:items:oneOf:1:properties:tiers:items:properties:amount:examples","descriptionNode":"$Lfcc"}},"required":"$31:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:variations:items:properties:phases:items:properties:subscription_items:items:oneOf:1:properties:tiers:items:required"},"descriptionNode":"$Lfcd"},"code":{"type":"string","description":"A merchant-defined identifier for a usage-based subscription item. You set this code on each usage item when creating a subscription plan, and supply it when reporting consumption on [Create a subscription usage endpoint](https://developer.revolut.com/docs/api/merchant#create-subscription-usage) to target the correct metered item.\n\nThis allows a subscription with multiple usage items (e.g., `api_calls` and `storage_gb`) to receive consumption reports against the right item without relying on internal IDs.\n\nThe code must be unique within a plan phase.","maxLength":250,"examples":"$3d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:subscription_item_code:examples","descriptionNode":"$Lfce"},"usage_aggregation_method":{"type":"string","description":"The method used to aggregate usage events over a billing cycle to calculate the chargeable amount.\n\n| Value | Behaviour |\n| ----- | --------- |\n| `sum` | Totals all reported usage events during the cycle. Use for cumulative metrics (e.g., API calls, data transferred). |\n| `latest` | Uses the most recently reported value at the end of the cycle. If no usage is reported in a cycle, `0` is used — values do not carry over from previous cycles. Use for gauge-style metrics (e.g., active seats). |\n| `max` | Uses the peak value reported during the cycle. Use for capacity-based billing (e.g., max concurrent connections). |","enum":"$31:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:variations:items:properties:phases:items:properties:subscription_items:items:oneOf:1:properties:usage_aggregation_method:enum","examples":"$31:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:variations:items:properties:phases:items:properties:subscription_items:items:oneOf:1:properties:usage_aggregation_method:examples","descriptionNode":"$Lfcf"}},"required":["name","type","currency","unit","code","usage_aggregation_method"],"descriptionNode":"$Lfd0"}],"descriptionNode":"$Lfd1"},"descriptionNode":"$Lfd2"}},"required":["ordinal","cycle_duration","amount","currency"]},"descriptionNode":"$Lfd3"}}},"descriptionNode":"$Lfd4"}}},"examples":{"simple_plan":{"summary":"Simple yearly and monthly plan","value":{"name":"Enterprise Pro Plan","variations":[{"phases":[{"ordinal":1,"cycle_duration":"P1Y","amount":99900,"currency":"GBP"}]},{"phases":[{"ordinal":1,"cycle_duration":"P1M","amount":9900,"currency":"GBP"}]}]}},"trial_plan_with_duration":{"summary":"Plan with trial duration","value":{"name":"Premium Plan with 14-day Trial","trial_duration":"P14D","variations":[{"phases":[{"ordinal":1,"cycle_duration":"P1M","amount":9900,"currency":"GBP"}]}]}},"limited_plan":{"summary":"Plan that ends after 12 months","value":{"name":"12-month Limited Plan","variations":[{"phases":[{"ordinal":1,"cycle_duration":"P1M","cycle_count":12,"amount":1000,"currency":"GBP"}]}]}},"usage_base_plan":{"summary":"Usage-based plan with tiered pricing","value":{"name":"API Usage Plan","variations":[{"phases":[{"ordinal":1,"cycle_duration":"P1M","subscription_items":[{"name":"API Calls","type":"usage","currency":"GBP","unit":"calls","code":"api_calls","usage_aggregation_method":"sum","tiers":[{"upper_quantity_threshold":1000,"amount":0},{"upper_quantity_threshold":10000,"amount":10},{"amount":5}]}]}]}]}},"hybrid_plan":{"summary":"Hybrid plan with flat base fee and usage-based items","value":{"name":"Professional Plan","variations":[{"phases":[{"ordinal":1,"cycle_duration":"P1M","subscription_items":[{"name":"Base Subscription","type":"flat","quantity":1,"amount":2900,"currency":"GBP","unit":"subscription"},{"name":"API Calls","type":"usage","currency":"GBP","unit":"calls","code":"api_calls","usage_aggregation_method":"sum","amount":10},{"name":"Storage","type":"usage","currency":"GBP","unit":"gb","code":"storage_gb","usage_aggregation_method":"max","package_size":1,"tiers":[{"upper_quantity_threshold":10,"amount":0},{"upper_quantity_threshold":100,"amount":50},{"amount":30}]}]}]}]}},"package_plan":{"summary":"Usage-based plan with block pricing (price per 1000 units)","value":{"name":"SMS Plan","variations":[{"phases":[{"ordinal":1,"cycle_duration":"P1M","subscription_items":[{"name":"SMS Messages","type":"usage","currency":"GBP","unit":"messages","code":"sms_messages","usage_aggregation_method":"sum","package_size":1000,"amount":500}]}]}]}},"items_plan":{"summary":"Plan with flat and usage-based subscription items","value":{"name":"Professional Platform Plan","variations":[{"phases":[{"ordinal":1,"cycle_duration":"P1M","amount":4900,"currency":"GBP","subscription_items":[{"type":"flat","name":"Platform License","unit":"subscription","quantity":1,"amount":4900,"currency":"GBP"},{"type":"usage","name":"API Calls","unit":"call","code":"api_calls","usage_aggregation_method":"sum","amount":1,"currency":"GBP"}]}]}]}}}}}},"variantLabels":["Simple yearly and monthly plan","Plan with trial duration","Plan that ends after 12 months","Usage-based plan with tiered pricing","Hybrid plan with flat base fee and usage-based items","Usage-based plan with block pricing (price per 1000 units)","Plan with flat and usage-based subscription items"],"children":["$Lfd5","$Lfd6"]}]}],false]}] fd7:T555,
{
  "name": "Grocery website",
  "type": "online",
  "details": {
    "domain": "groceries.example.com"
  }
}
f1b:["$","div","request-application/json-example_online_location",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$fd7"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"name\": \"Grocery website\",\n \"type\": \"online\",\n \"details\": {\n \"domain\": \"groceries.example.com\"\n }\n}"}]}]]}] fd8:T19ff,
{
  "name": "Example Street Store",
  "type": "physical",
  "details": {
    "address": {
      "street_line_1": "123 Example Street",
      "city": "Example city",
      "postcode": "12345",
      "country_code": "GB"
    },
    "geo_location": {
      "lat": 12.3456,
      "lon": -12.3456
    },
    "opening_hours": {
      "monday": [
        {
          "from": "09:00",
          "to": "15:00"
        },
        {
          "from": "16:00",
          "to": "18:00"
        }
      ],
      "tuesday": [
        {
          "from": "10:00",
          "to": "13:00"
        },
        {
          "from": "16:00",
          "to": "18:00"
        }
      ]
    }
  }
}
f1c:["$","div","request-application/json-example_physical_location",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$fd8"}}]}]],"$Lfd9"]}] fda:T67f,
{
  "id": "8d9a7125-805f-40f3-a405-bc89765db996",
  "name": "Grocery website",
  "type": "online",
  "details": {
    "domain": "groceries.example.com"
  }
}
f1d:["$","div","201-application/json-example_online_location",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$fda"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"id\": \"8d9a7125-805f-40f3-a405-bc89765db996\",\n \"name\": \"Grocery website\",\n \"type\": \"online\",\n \"details\": {\n \"domain\": \"groceries.example.com\"\n }\n}"}]}]]}] fdb:T1b29,
{
  "id": "8d9a7125-805f-40f3-a405-bc89765db996",
  "name": "Example Street Store",
  "type": "physical",
  "details": {
    "address": {
      "street_line_1": "123 Example Street",
      "city": "Example city",
      "postcode": "12345",
      "country_code": "GB"
    },
    "geo_location": {
      "lat": 12.3456,
      "lon": -12.3456
    },
    "opening_hours": {
      "monday": [
        {
          "from": "09:00",
          "to": "15:00"
        },
        {
          "from": "16:00",
          "to": "18:00"
        }
      ],
      "tuesday": [
        {
          "from": "10:00",
          "to": "13:00"
        },
        {
          "from": "16:00",
          "to": "18:00"
        }
      ]
    }
  }
}
f1e:["$","div","201-application/json-example_physical_location",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$fdb"}}]}]],"$Lfdc"]}] f1f:["$","div","400-application/json-default",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"
{\n  \"errorId\": \"string\",\n  \"timestamp\": 123\n}
"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"errorId\": \"string\",\n \"timestamp\": 123\n}"}]}]]}] f20:["$","div","401-application/json-default",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"
{\n  \"errorId\": \"string\",\n  \"timestamp\": 123\n}
"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"errorId\": \"string\",\n \"timestamp\": 123\n}"}]}]]}] f21:["$","div","404-application/json-default",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"
{\n  \"errorId\": \"string\",\n  \"timestamp\": 123\n}
"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"errorId\": \"string\",\n \"timestamp\": 123\n}"}]}]]}] f7f:["$","$L10d",null,{"security":[{"Api-Key":[]}],"authorization":{"Api-Key":{"type":"apiKey","in":"header","name":"Authorization","description":"Each Merchant API request must contain an authorization header in the following format:\n\n```\n'Authorization: Bearer '\n```\n\nTo use this API, you need to generate API keys from your Revolut Business account. The Secret key is used in the authorization header for all server calls, while the Public key is provided with payment methods at checkout.\n\n:::info\nFor detailed instructions on generating your API keys, see: [Generate API keys](https://developer.revolut.com/docs/guides/merchant/get-started#generate-api-keys).\n:::","descriptionNode":"$Lfdd"}}}] f80:["$","$L10f",null,{"exampleBlocks":{"application/json":{"variants":[{"key":"online_location","label":"Online location example","rawValue":"$61:props:children:0:props:children:props:requestBody:content:application/json:examples:online_location:value","block":"$Lfde"},{"key":"physical_location","label":"Physical location example","rawValue":"$61:props:children:0:props:children:props:requestBody:content:application/json:examples:physical_location:value","block":"$Lfdf"}],"syncedPropertyName":"$undefined"}},"title":"Request body samples","headingAs":"h4"}] f81:["$","$L110",null,{"exampleBlocks":{"200":{"application/json":{"variants":[{"key":"online_location","label":"Online location example","rawValue":"$61:props:children:0:props:children:props:responses:200:content:application/json:examples:online_location:value","block":"$Lfe0"},{"key":"physical_location","label":"Physical location example","rawValue":"$61:props:children:0:props:children:props:responses:200:content:application/json:examples:physical_location:value","block":"$Lfe1"}],"syncedPropertyName":"type"}},"400":{"application/json":{"variants":[{"key":"default","label":"Example","rawValue":{"errorId":"string","timestamp":123},"block":"$Lfe2"}],"syncedPropertyName":"$undefined"}},"401":{"application/json":{"variants":[{"key":"default","label":"Example","rawValue":{"errorId":"string","timestamp":123},"block":"$Lfe3"}],"syncedPropertyName":"$undefined"}},"404":{"application/json":{"variants":[{"key":"default","label":"Example","rawValue":{"errorId":"string","timestamp":123},"block":"$Lfe4"}],"syncedPropertyName":"$undefined"}}},"headingAs":"h4"}] fd5:["$","div",null,{"className":"ezz1n30","children":[["$","div",null,{"data-header":"$undefined","className":"ezz1n31","children":["$","div",null,{"className":"y9a0do1","children":[["$","h2",null,{"id":"create-subscription-plan","children":[["$Lfe5","$undefined"],["$","$L15",null,{"id":"create-subscription-plan"}]]}],["$","$L16",null,{"url":"/docs/api/merchant/2025-10-16/operations/create-subscription-plan.md"}]]}]}],"$undefined"]}] fe9:Teba,
curl -X POST "https://merchant.revolut.com/api/subscription-plans" \
  -H "Content-Type: application/json" \
  -H "Authorization: __RP_TOK_0__" \
  -H "Revolut-Api-Version: __RP_TOK_1__" \
  -d '{
  "name": "Enterprise Pro Plan",
  "variations": [
    {
      "phases": [
        {
          "ordinal": 1,
          "cycle_duration": "P1Y",
          "amount": 99900,
          "currency": "GBP"
        }
      ]
    },
    {
      "phases": [
        {
          "ordinal": 1,
          "cycle_duration": "P1M",
          "amount": 9900,
          "currency": "GBP"
        }
      ]
    }
  ]
}'
fea:T1cb3,
const payload = {
  "name": "Enterprise Pro Plan",
  "variations": [
    {
      "phases": [
        {
          "ordinal": 1,
          "cycle_duration": "P1Y",
          "amount": 99900,
          "currency": "GBP"
        }
      ]
    },
    {
      "phases": [
        {
          "ordinal": 1,
          "cycle_duration": "P1M",
          "amount": 9900,
          "currency": "GBP"
        }
      ]
    }
  ]
};
fetch("https://merchant.revolut.com/api/subscription-plans", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "__RP_TOK_0__",
    "Revolut-Api-Version": "__RP_TOK_1__"
  },
  body: JSON.stringify(payload)
})
  .then(response => response.json())
  .then(data => console.log(data));
feb:T1e9f,
package main

import (
  "fmt"
  "net/http"
  "bytes"
  "encoding/json"
)

func main() {
  url := "https://merchant.revolut.com/api/subscription-plans"
  jsonData := []byte(`
{
  "name": "Enterprise Pro Plan",
  "variations": [
    {
      "phases": [
        {
          "ordinal": 1,
          "cycle_duration": "P1Y",
          "amount": 99900,
          "currency": "GBP"
        }
      ]
    },
    {
      "phases": [
        {
          "ordinal": 1,
          "cycle_duration": "P1M",
          "amount": 9900,
          "currency": "GBP"
        }
      ]
    }
  ]
}
  `)
  req, _ := http.NewRequest("POST", url, bytes.NewBuffer(jsonData))
  req.Header.Add("Content-Type", "application/json")
  req.Header.Add("Authorization", "__RP_TOK_0__")
  req.Header.Add("Revolut-Api-Version", "__RP_TOK_1__")

  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  fmt.Println(res)
}
fec:T19e7,
import requests

url = "https://merchant.revolut.com/api/subscription-plans"
headers = {
  "Content-Type": "application/json",
  "Authorization": "__RP_TOK_0__",
  "Revolut-Api-Version": "__RP_TOK_1__"
}
payload = {
  "name": "Enterprise Pro Plan",
  "variations": [
    {
      "phases": [
        {
          "ordinal": 1,
          "cycle_duration": "P1Y",
          "amount": 99900,
          "currency": "GBP"
        }
      ]
    },
    {
      "phases": [
        {
          "ordinal": 1,
          "cycle_duration": "P1M",
          "amount": 9900,
          "currency": "GBP"
        }
      ]
    }
  ]
}

response = requests.post(url, headers=headers, json=payload)
print(response.json())
fed:T4a5,import java.net.http.HttpClient; import java.net.http.HttpRequest; import java.net.http.HttpResponse; import java.net.URI; public class Main { public static void main(String[] args) { HttpClient client = HttpClient.newHttpClient(); String body = """ { "name": "Enterprise Pro Plan", "variations": [ { "phases": [ { "ordinal": 1, "cycle_duration": "P1Y", "amount": 99900, "currency": "GBP" } ] }, { "phases": [ { "ordinal": 1, "cycle_duration": "P1M", "amount": 9900, "currency": "GBP" } ] } ] } """; HttpRequest request = HttpRequest.newBuilder() .uri(URI.create("https://merchant.revolut.com/api/subscription-plans")) .header("Content-Type", "application/json") .header("Authorization", "__RP_TOK_0__") .header("Revolut-Api-Version", "__RP_TOK_1__") .POST(HttpRequest.BodyPublishers.ofString(body)) .build(); client.sendAsync(request, HttpResponse.BodyHandlers.ofString()) .thenApply(HttpResponse::body) .thenAccept(System.out::println) .join(); } }fee:T2403,
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;

public class Main {
  public static void main(String[] args) {
    HttpClient client = HttpClient.newHttpClient();
    String body = """
{
  "name": "Enterprise Pro Plan",
  "variations": [
    {
      "phases": [
        {
          "ordinal": 1,
          "cycle_duration": "P1Y",
          "amount": 99900,
          "currency": "GBP"
        }
      ]
    },
    {
      "phases": [
        {
          "ordinal": 1,
          "cycle_duration": "P1M",
          "amount": 9900,
          "currency": "GBP"
        }
      ]
    }
  ]
}
    """;

    HttpRequest request = HttpRequest.newBuilder()
      .uri(URI.create("https://merchant.revolut.com/api/subscription-plans"))
      .header("Content-Type", "application/json")
      .header("Authorization", "__RP_TOK_0__")
      .header("Revolut-Api-Version", "__RP_TOK_1__")
      .POST(HttpRequest.BodyPublishers.ofString(body))
      .build();

    client.sendAsync(request, HttpResponse.BodyHandlers.ofString())
      .thenApply(HttpResponse::body)
      .thenAccept(System.out::println)
      .join();
  }
}
fef:T447,using System.Net.Http; using System.Net.Http.Headers; var client = new HttpClient(); var request = new HttpRequestMessage { Method = HttpMethod.Post, RequestUri = new Uri("https://merchant.revolut.com/api/subscription-plans"), Headers = { { "Authorization", "__RP_TOK_0__" }, { "Revolut-Api-Version", "__RP_TOK_1__" }, }, Content = new StringContent(@"{ ""name"": ""Enterprise Pro Plan"", ""variations"": [ { ""phases"": [ { ""ordinal"": 1, ""cycle_duration"": ""P1Y"", ""amount"": 99900, ""currency"": ""GBP"" } ] }, { ""phases"": [ { ""ordinal"": 1, ""cycle_duration"": ""P1M"", ""amount"": 9900, ""currency"": ""GBP"" } ] } ] }") { Headers = { ContentType = new MediaTypeHeaderValue("application/json") } } }; using (var response = await client.SendAsync(request)) { response.EnsureSuccessStatusCode(); var body = await response.Content.ReadAsStringAsync(); Console.WriteLine(body); }ff0:T3089,
using System.Net.Http;
using System.Net.Http.Headers;

var client = new HttpClient();
var request = new HttpRequestMessage
{
  Method = HttpMethod.Post,
  RequestUri = new Uri("https://merchant.revolut.com/api/subscription-plans"),
  Headers =
  {
    { "Authorization", "__RP_TOK_0__" },
    { "Revolut-Api-Version", "__RP_TOK_1__" },
  },
  Content = new StringContent(@"{
  ""name"": ""Enterprise Pro Plan"",
  ""variations"": [
    {
      ""phases"": [
        {
          ""ordinal"": 1,
          ""cycle_duration"": ""P1Y"",
          ""amount"": 99900,
          ""currency"": ""GBP""
        }
      ]
    },
    {
      ""phases"": [
        {
          ""ordinal"": 1,
          ""cycle_duration"": ""P1M"",
          ""amount"": 9900,
          ""currency"": ""GBP""
        }
      ]
    }
  ]
}")
  {
    Headers =
    {
      ContentType = new MediaTypeHeaderValue("application/json")
    }
  }
};

using (var response = await client.SendAsync(request))
{
  response.EnsureSuccessStatusCode();
  var body = await response.Content.ReadAsStringAsync();
  Console.WriteLine(body);
}
ff1:Tec2,
curl -X POST "https://sandbox-merchant.revolut.com/api/subscription-plans" \
  -H "Content-Type: application/json" \
  -H "Authorization: __RP_TOK_0__" \
  -H "Revolut-Api-Version: __RP_TOK_1__" \
  -d '{
  "name": "Enterprise Pro Plan",
  "variations": [
    {
      "phases": [
        {
          "ordinal": 1,
          "cycle_duration": "P1Y",
          "amount": 99900,
          "currency": "GBP"
        }
      ]
    },
    {
      "phases": [
        {
          "ordinal": 1,
          "cycle_duration": "P1M",
          "amount": 9900,
          "currency": "GBP"
        }
      ]
    }
  ]
}'
ff2:T1cbb,
const payload = {
  "name": "Enterprise Pro Plan",
  "variations": [
    {
      "phases": [
        {
          "ordinal": 1,
          "cycle_duration": "P1Y",
          "amount": 99900,
          "currency": "GBP"
        }
      ]
    },
    {
      "phases": [
        {
          "ordinal": 1,
          "cycle_duration": "P1M",
          "amount": 9900,
          "currency": "GBP"
        }
      ]
    }
  ]
};
fetch("https://sandbox-merchant.revolut.com/api/subscription-plans", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "__RP_TOK_0__",
    "Revolut-Api-Version": "__RP_TOK_1__"
  },
  body: JSON.stringify(payload)
})
  .then(response => response.json())
  .then(data => console.log(data));
ff3:T1ea7,
package main

import (
  "fmt"
  "net/http"
  "bytes"
  "encoding/json"
)

func main() {
  url := "https://sandbox-merchant.revolut.com/api/subscription-plans"
  jsonData := []byte(`
{
  "name": "Enterprise Pro Plan",
  "variations": [
    {
      "phases": [
        {
          "ordinal": 1,
          "cycle_duration": "P1Y",
          "amount": 99900,
          "currency": "GBP"
        }
      ]
    },
    {
      "phases": [
        {
          "ordinal": 1,
          "cycle_duration": "P1M",
          "amount": 9900,
          "currency": "GBP"
        }
      ]
    }
  ]
}
  `)
  req, _ := http.NewRequest("POST", url, bytes.NewBuffer(jsonData))
  req.Header.Add("Content-Type", "application/json")
  req.Header.Add("Authorization", "__RP_TOK_0__")
  req.Header.Add("Revolut-Api-Version", "__RP_TOK_1__")

  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  fmt.Println(res)
}
ff4:T19ef,
import requests

url = "https://sandbox-merchant.revolut.com/api/subscription-plans"
headers = {
  "Content-Type": "application/json",
  "Authorization": "__RP_TOK_0__",
  "Revolut-Api-Version": "__RP_TOK_1__"
}
payload = {
  "name": "Enterprise Pro Plan",
  "variations": [
    {
      "phases": [
        {
          "ordinal": 1,
          "cycle_duration": "P1Y",
          "amount": 99900,
          "currency": "GBP"
        }
      ]
    },
    {
      "phases": [
        {
          "ordinal": 1,
          "cycle_duration": "P1M",
          "amount": 9900,
          "currency": "GBP"
        }
      ]
    }
  ]
}

response = requests.post(url, headers=headers, json=payload)
print(response.json())
ff5:T4ad,import java.net.http.HttpClient; import java.net.http.HttpRequest; import java.net.http.HttpResponse; import java.net.URI; public class Main { public static void main(String[] args) { HttpClient client = HttpClient.newHttpClient(); String body = """ { "name": "Enterprise Pro Plan", "variations": [ { "phases": [ { "ordinal": 1, "cycle_duration": "P1Y", "amount": 99900, "currency": "GBP" } ] }, { "phases": [ { "ordinal": 1, "cycle_duration": "P1M", "amount": 9900, "currency": "GBP" } ] } ] } """; HttpRequest request = HttpRequest.newBuilder() .uri(URI.create("https://sandbox-merchant.revolut.com/api/subscription-plans")) .header("Content-Type", "application/json") .header("Authorization", "__RP_TOK_0__") .header("Revolut-Api-Version", "__RP_TOK_1__") .POST(HttpRequest.BodyPublishers.ofString(body)) .build(); client.sendAsync(request, HttpResponse.BodyHandlers.ofString()) .thenApply(HttpResponse::body) .thenAccept(System.out::println) .join(); } }ff6:T240b,
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;

public class Main {
  public static void main(String[] args) {
    HttpClient client = HttpClient.newHttpClient();
    String body = """
{
  "name": "Enterprise Pro Plan",
  "variations": [
    {
      "phases": [
        {
          "ordinal": 1,
          "cycle_duration": "P1Y",
          "amount": 99900,
          "currency": "GBP"
        }
      ]
    },
    {
      "phases": [
        {
          "ordinal": 1,
          "cycle_duration": "P1M",
          "amount": 9900,
          "currency": "GBP"
        }
      ]
    }
  ]
}
    """;

    HttpRequest request = HttpRequest.newBuilder()
      .uri(URI.create("https://sandbox-merchant.revolut.com/api/subscription-plans"))
      .header("Content-Type", "application/json")
      .header("Authorization", "__RP_TOK_0__")
      .header("Revolut-Api-Version", "__RP_TOK_1__")
      .POST(HttpRequest.BodyPublishers.ofString(body))
      .build();

    client.sendAsync(request, HttpResponse.BodyHandlers.ofString())
      .thenApply(HttpResponse::body)
      .thenAccept(System.out::println)
      .join();
  }
}
ff7:T44f,using System.Net.Http; using System.Net.Http.Headers; var client = new HttpClient(); var request = new HttpRequestMessage { Method = HttpMethod.Post, RequestUri = new Uri("https://sandbox-merchant.revolut.com/api/subscription-plans"), Headers = { { "Authorization", "__RP_TOK_0__" }, { "Revolut-Api-Version", "__RP_TOK_1__" }, }, Content = new StringContent(@"{ ""name"": ""Enterprise Pro Plan"", ""variations"": [ { ""phases"": [ { ""ordinal"": 1, ""cycle_duration"": ""P1Y"", ""amount"": 99900, ""currency"": ""GBP"" } ] }, { ""phases"": [ { ""ordinal"": 1, ""cycle_duration"": ""P1M"", ""amount"": 9900, ""currency"": ""GBP"" } ] } ] }") { Headers = { ContentType = new MediaTypeHeaderValue("application/json") } } }; using (var response = await client.SendAsync(request)) { response.EnsureSuccessStatusCode(); var body = await response.Content.ReadAsStringAsync(); Console.WriteLine(body); }ff8:T3091,
using System.Net.Http;
using System.Net.Http.Headers;

var client = new HttpClient();
var request = new HttpRequestMessage
{
  Method = HttpMethod.Post,
  RequestUri = new Uri("https://sandbox-merchant.revolut.com/api/subscription-plans"),
  Headers =
  {
    { "Authorization", "__RP_TOK_0__" },
    { "Revolut-Api-Version", "__RP_TOK_1__" },
  },
  Content = new StringContent(@"{
  ""name"": ""Enterprise Pro Plan"",
  ""variations"": [
    {
      ""phases"": [
        {
          ""ordinal"": 1,
          ""cycle_duration"": ""P1Y"",
          ""amount"": 99900,
          ""currency"": ""GBP""
        }
      ]
    },
    {
      ""phases"": [
        {
          ""ordinal"": 1,
          ""cycle_duration"": ""P1M"",
          ""amount"": 9900,
          ""currency"": ""GBP""
        }
      ]
    }
  ]
}")
  {
    Headers =
    {
      ContentType = new MediaTypeHeaderValue("application/json")
    }
  }
};

using (var response = await client.SendAsync(request))
{
  response.EnsureSuccessStatusCode();
  var body = await response.Content.ReadAsStringAsync();
  Console.WriteLine(body);
}
fd6:["$","div",null,{"className":"ezz1n30","children":[["$","div",null,{"data-header":"$undefined","className":"ezz1n31","children":["$Lfe6",["$","$L85",null,{"parameters":[{"name":"Authorization","in":"header","schema":{"type":"string","format":"Bearer ","examples":"$62:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:0:schema:examples"},"required":true,"description":"This parameter accepts the [Merchant API Secret key](https://business.revolut.com/settings/apis?tab=merchant-api) to authorise requests coming from the merchant's backend. \n\nIt ensures that ensures that each request is authenticated and authorised by verifying the secret key. The secret key should be included in all request headers as a `Bearer` token.\n\n:::info\nFor more information, see: [Authentication](https://developer.revolut.com/docs/api/merchant#authentication)\n:::","descriptionNode":"$Lfe7"},{"name":"Revolut-Api-Version","in":"header","schema":{"type":"string","format":"date","enum":"$36:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:1:schema:enum","examples":"$36:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:1:schema:examples"},"required":true,"description":"The version of the Merchant API, specified in `YYYY-MM-DD` format.\n\nIf not specified, you will receive an error.\n\n\n:::info\nFor more information about API versioning, see: [API versions](https://developer.revolut.com/docs/guides/merchant/reference/versioning/api-versions).\n:::","x-config-always-visible-in-example":true,"example":"2025-10-16","descriptionNode":"$Lfe8"}],"requestBody":"$2f:props:children:0:props:children:props:requestBody","heading":"Request","requestBodySchemaTitle":"Request body","headingAs":"h3"}],["$","$L89",null,{"responses":"$2f:props:children:0:props:children:props:responses","headingAs":"h3"}]]}],["$","div",null,{"className":"ezz1n32","children":[[["$","$L8a",null,{"itemsByServer":{"https://merchant.revolut.com":[{"id":"curl","label":"cURL","templateCode":"curl -X POST \"https://merchant.revolut.com/api/subscription-plans\" \\\n -H \"Content-Type: application/json\" \\\n -H \"Authorization: __RP_TOK_0__\" \\\n -H \"Revolut-Api-Version: __RP_TOK_1__\" \\\n -d '{\n \"name\": \"Enterprise Pro Plan\",\n \"variations\": [\n {\n \"phases\": [\n {\n \"ordinal\": 1,\n \"cycle_duration\": \"P1Y\",\n \"amount\": 99900,\n \"currency\": \"GBP\"\n }\n ]\n },\n {\n \"phases\": [\n {\n \"ordinal\": 1,\n \"cycle_duration\": \"P1M\",\n \"amount\": 9900,\n \"currency\": \"GBP\"\n }\n ]\n }\n ]\n}'","templateHtml":"$fe9","tokens":[{"marker":"__RP_TOK_0__","paramName":"Authorization","paramIn":"header","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_1__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["shell-double-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16"}},{"id":"javascript","label":"JavaScript","templateCode":"const payload = {\n \"name\": \"Enterprise Pro Plan\",\n \"variations\": [\n {\n \"phases\": [\n {\n \"ordinal\": 1,\n \"cycle_duration\": \"P1Y\",\n \"amount\": 99900,\n \"currency\": \"GBP\"\n }\n ]\n },\n {\n \"phases\": [\n {\n \"ordinal\": 1,\n \"cycle_duration\": \"P1M\",\n \"amount\": 9900,\n \"currency\": \"GBP\"\n }\n ]\n }\n ]\n};\nfetch(\"https://merchant.revolut.com/api/subscription-plans\", {\n method: \"POST\",\n headers: {\n \"Content-Type\": \"application/json\",\n \"Authorization\": \"__RP_TOK_0__\",\n \"Revolut-Api-Version\": \"__RP_TOK_1__\"\n },\n body: JSON.stringify(payload)\n})\n .then(response => response.json())\n .then(data => console.log(data));","templateHtml":"$fea","tokens":[{"marker":"__RP_TOK_0__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16"}},{"id":"go","label":"Go","templateCode":"package main\n\nimport (\n \"fmt\"\n \"net/http\"\n \"bytes\"\n \"encoding/json\"\n)\n\nfunc main() {\n url := \"https://merchant.revolut.com/api/subscription-plans\"\n jsonData := []byte(`\n{\n \"name\": \"Enterprise Pro Plan\",\n \"variations\": [\n {\n \"phases\": [\n {\n \"ordinal\": 1,\n \"cycle_duration\": \"P1Y\",\n \"amount\": 99900,\n \"currency\": \"GBP\"\n }\n ]\n },\n {\n \"phases\": [\n {\n \"ordinal\": 1,\n \"cycle_duration\": \"P1M\",\n \"amount\": 9900,\n \"currency\": \"GBP\"\n }\n ]\n }\n ]\n}\n `)\n req, _ := http.NewRequest(\"POST\", url, bytes.NewBuffer(jsonData))\n req.Header.Add(\"Content-Type\", \"application/json\")\n req.Header.Add(\"Authorization\", \"__RP_TOK_0__\")\n req.Header.Add(\"Revolut-Api-Version\", \"__RP_TOK_1__\")\n\n res, _ := http.DefaultClient.Do(req)\n defer res.Body.Close()\n fmt.Println(res)\n}","templateHtml":"$feb","tokens":[{"marker":"__RP_TOK_0__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16"}},{"id":"python","label":"Python","templateCode":"import requests\n\nurl = \"https://merchant.revolut.com/api/subscription-plans\"\nheaders = {\n \"Content-Type\": \"application/json\",\n \"Authorization\": \"__RP_TOK_0__\",\n \"Revolut-Api-Version\": \"__RP_TOK_1__\"\n}\npayload = {\n \"name\": \"Enterprise Pro Plan\",\n \"variations\": [\n {\n \"phases\": [\n {\n \"ordinal\": 1,\n \"cycle_duration\": \"P1Y\",\n \"amount\": 99900,\n \"currency\": \"GBP\"\n }\n ]\n },\n {\n \"phases\": [\n {\n \"ordinal\": 1,\n \"cycle_duration\": \"P1M\",\n \"amount\": 9900,\n \"currency\": \"GBP\"\n }\n ]\n }\n ]\n}\n\nresponse = requests.post(url, headers=headers, json=payload)\nprint(response.json())","templateHtml":"$fec","tokens":[{"marker":"__RP_TOK_0__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16"}},{"id":"java","label":"Java","templateCode":"$fed","templateHtml":"$fee","tokens":[{"marker":"__RP_TOK_0__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16"}},{"id":"csharp","label":"C#","templateCode":"$fef","templateHtml":"$ff0","tokens":[{"marker":"__RP_TOK_0__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16"}}],"https://sandbox-merchant.revolut.com":[{"id":"curl","label":"cURL","templateCode":"curl -X POST \"https://sandbox-merchant.revolut.com/api/subscription-plans\" \\\n -H \"Content-Type: application/json\" \\\n -H \"Authorization: __RP_TOK_0__\" \\\n -H \"Revolut-Api-Version: __RP_TOK_1__\" \\\n -d '{\n \"name\": \"Enterprise Pro Plan\",\n \"variations\": [\n {\n \"phases\": [\n {\n \"ordinal\": 1,\n \"cycle_duration\": \"P1Y\",\n \"amount\": 99900,\n \"currency\": \"GBP\"\n }\n ]\n },\n {\n \"phases\": [\n {\n \"ordinal\": 1,\n \"cycle_duration\": \"P1M\",\n \"amount\": 9900,\n \"currency\": \"GBP\"\n }\n ]\n }\n ]\n}'","templateHtml":"$ff1","tokens":[{"marker":"__RP_TOK_0__","paramName":"Authorization","paramIn":"header","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_1__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["shell-double-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16"}},{"id":"javascript","label":"JavaScript","templateCode":"const payload = {\n \"name\": \"Enterprise Pro Plan\",\n \"variations\": [\n {\n \"phases\": [\n {\n \"ordinal\": 1,\n \"cycle_duration\": \"P1Y\",\n \"amount\": 99900,\n \"currency\": \"GBP\"\n }\n ]\n },\n {\n \"phases\": [\n {\n \"ordinal\": 1,\n \"cycle_duration\": \"P1M\",\n \"amount\": 9900,\n \"currency\": \"GBP\"\n }\n ]\n }\n ]\n};\nfetch(\"https://sandbox-merchant.revolut.com/api/subscription-plans\", {\n method: \"POST\",\n headers: {\n \"Content-Type\": \"application/json\",\n \"Authorization\": \"__RP_TOK_0__\",\n \"Revolut-Api-Version\": \"__RP_TOK_1__\"\n },\n body: JSON.stringify(payload)\n})\n .then(response => response.json())\n .then(data => console.log(data));","templateHtml":"$ff2","tokens":[{"marker":"__RP_TOK_0__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16"}},{"id":"go","label":"Go","templateCode":"package main\n\nimport (\n \"fmt\"\n \"net/http\"\n \"bytes\"\n \"encoding/json\"\n)\n\nfunc main() {\n url := \"https://sandbox-merchant.revolut.com/api/subscription-plans\"\n jsonData := []byte(`\n{\n \"name\": \"Enterprise Pro Plan\",\n \"variations\": [\n {\n \"phases\": [\n {\n \"ordinal\": 1,\n \"cycle_duration\": \"P1Y\",\n \"amount\": 99900,\n \"currency\": \"GBP\"\n }\n ]\n },\n {\n \"phases\": [\n {\n \"ordinal\": 1,\n \"cycle_duration\": \"P1M\",\n \"amount\": 9900,\n \"currency\": \"GBP\"\n }\n ]\n }\n ]\n}\n `)\n req, _ := http.NewRequest(\"POST\", url, bytes.NewBuffer(jsonData))\n req.Header.Add(\"Content-Type\", \"application/json\")\n req.Header.Add(\"Authorization\", \"__RP_TOK_0__\")\n req.Header.Add(\"Revolut-Api-Version\", \"__RP_TOK_1__\")\n\n res, _ := http.DefaultClient.Do(req)\n defer res.Body.Close()\n fmt.Println(res)\n}","templateHtml":"$ff3","tokens":[{"marker":"__RP_TOK_0__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16"}},{"id":"python","label":"Python","templateCode":"import requests\n\nurl = \"https://sandbox-merchant.revolut.com/api/subscription-plans\"\nheaders = {\n \"Content-Type\": \"application/json\",\n \"Authorization\": \"__RP_TOK_0__\",\n \"Revolut-Api-Version\": \"__RP_TOK_1__\"\n}\npayload = {\n \"name\": \"Enterprise Pro Plan\",\n \"variations\": [\n {\n \"phases\": [\n {\n \"ordinal\": 1,\n \"cycle_duration\": \"P1Y\",\n \"amount\": 99900,\n \"currency\": \"GBP\"\n }\n ]\n },\n {\n \"phases\": [\n {\n \"ordinal\": 1,\n \"cycle_duration\": \"P1M\",\n \"amount\": 9900,\n \"currency\": \"GBP\"\n }\n ]\n }\n ]\n}\n\nresponse = requests.post(url, headers=headers, json=payload)\nprint(response.json())","templateHtml":"$ff4","tokens":[{"marker":"__RP_TOK_0__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16"}},{"id":"java","label":"Java","templateCode":"$ff5","templateHtml":"$ff6","tokens":[{"marker":"__RP_TOK_0__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16"}},{"id":"csharp","label":"C#","templateCode":"$ff7","templateHtml":"$ff8","tokens":[{"marker":"__RP_TOK_0__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16"}}]},"method":"post","servers":"$62:props:children:0:props:children:props:children:1:props:children:1:props:children:0:0:props:servers","path":"/api/subscription-plans","parameters":["$fd6:props:children:0:props:children:1:props:parameters:0","$fd6:props:children:0:props:children:1:props:parameters:1"]}],"$Lff9"],"$Lffa","$Lffb"]}]]}] fd9:["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"name\": \"Example Street Store\",\n \"type\": \"physical\",\n \"details\": {\n \"address\": {\n \"street_line_1\": \"123 Example Street\",\n \"city\": \"Example city\",\n \"postcode\": \"12345\",\n \"country_code\": \"GB\"\n },\n \"geo_location\": {\n \"lat\": 12.3456,\n \"lon\": -12.3456\n },\n \"opening_hours\": {\n \"monday\": [\n {\n \"from\": \"09:00\",\n \"to\": \"15:00\"\n },\n {\n \"from\": \"16:00\",\n \"to\": \"18:00\"\n }\n ],\n \"tuesday\": [\n {\n \"from\": \"10:00\",\n \"to\": \"13:00\"\n },\n {\n \"from\": \"16:00\",\n \"to\": \"18:00\"\n }\n ]\n }\n }\n}"}]}] fdc:["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"id\": \"8d9a7125-805f-40f3-a405-bc89765db996\",\n \"name\": \"Example Street Store\",\n \"type\": \"physical\",\n \"details\": {\n \"address\": {\n \"street_line_1\": \"123 Example Street\",\n \"city\": \"Example city\",\n \"postcode\": \"12345\",\n \"country_code\": \"GB\"\n },\n \"geo_location\": {\n \"lat\": 12.3456,\n \"lon\": -12.3456\n },\n \"opening_hours\": {\n \"monday\": [\n {\n \"from\": \"09:00\",\n \"to\": \"15:00\"\n },\n {\n \"from\": \"16:00\",\n \"to\": \"18:00\"\n }\n ],\n \"tuesday\": [\n {\n \"from\": \"10:00\",\n \"to\": \"13:00\"\n },\n {\n \"from\": \"16:00\",\n \"to\": \"18:00\"\n }\n ]\n }\n }\n}"}]}] ff9:["$","$L10d",null,{"security":[{"Api-Key":[]}],"authorization":{"Api-Key":{"type":"apiKey","in":"header","name":"Authorization","description":"Each Merchant API request must contain an authorization header in the following format:\n\n```\n'Authorization: Bearer '\n```\n\nTo use this API, you need to generate API keys from your Revolut Business account. The Secret key is used in the authorization header for all server calls, while the Public key is provided with payment methods at checkout.\n\n:::info\nFor detailed instructions on generating your API keys, see: [Generate API keys](https://developer.revolut.com/docs/guides/merchant/get-started#generate-api-keys).\n:::","descriptionNode":"$Lffc"}}}] ffa:["$","$L10f",null,{"exampleBlocks":{"application/json":{"variants":[{"key":"simple_plan","label":"Simple yearly and monthly plan","rawValue":"$2f:props:children:0:props:children:props:requestBody:content:application/json:examples:simple_plan:value","block":"$Lffd"},{"key":"trial_plan_with_duration","label":"Plan with trial duration","rawValue":"$2f:props:children:0:props:children:props:requestBody:content:application/json:examples:trial_plan_with_duration:value","block":"$Lffe"},{"key":"limited_plan","label":"Plan that ends after 12 months","rawValue":"$2f:props:children:0:props:children:props:requestBody:content:application/json:examples:limited_plan:value","block":"$Lfff"},{"key":"usage_base_plan","label":"Usage-based plan with tiered pricing","rawValue":"$2f:props:children:0:props:children:props:requestBody:content:application/json:examples:usage_base_plan:value","block":"$L1000"},{"key":"hybrid_plan","label":"Hybrid plan with flat base fee and usage-based items","rawValue":"$2f:props:children:0:props:children:props:requestBody:content:application/json:examples:hybrid_plan:value","block":"$L1001"},{"key":"package_plan","label":"Usage-based plan with block pricing (price per 1000 units)","rawValue":"$2f:props:children:0:props:children:props:requestBody:content:application/json:examples:package_plan:value","block":"$L1002"},{"key":"items_plan","label":"Plan with flat and usage-based subscription items","rawValue":"$2f:props:children:0:props:children:props:requestBody:content:application/json:examples:items_plan:value","block":"$L1003"}],"syncedPropertyName":"$undefined"}},"title":"Request body samples","headingAs":"h4"}] ffb:["$","$L110",null,{"exampleBlocks":{"201":{"application/json":{"variants":[{"key":"simple_plan","label":"Simple yearly and monthly plan","rawValue":"$31:props:children:0:props:children:props:responses:200:content:application/json:examples:simple_plan:value","block":"$L1004"},{"key":"trial_plan_with_duration","label":"Plan with trial duration","rawValue":"$31:props:children:0:props:children:props:responses:200:content:application/json:examples:trial_plan_with_duration:value","block":"$L1005"},{"key":"limited_plan","label":"Plan that ends after 12 months","rawValue":"$31:props:children:0:props:children:props:responses:200:content:application/json:examples:limited_plan:value","block":"$L1006"},{"key":"usage_base_plan","label":"Usage-based plan with tiered pricing","rawValue":"$2f:props:children:0:props:children:props:responses:201:content:application/json:examples:usage_base_plan:value","block":"$L1007"},{"key":"hybrid_plan","label":"Hybrid plan with flat base fee and usage-based items","rawValue":"$2f:props:children:0:props:children:props:responses:201:content:application/json:examples:hybrid_plan:value","block":"$L1008"},{"key":"package_plan","label":"Usage-based plan with block pricing (price per 1000 units)","rawValue":"$2f:props:children:0:props:children:props:responses:201:content:application/json:examples:package_plan:value","block":"$L1009"},{"key":"items_plan","label":"Plan with flat and usage-based subscription items","rawValue":"$2f:props:children:0:props:children:props:responses:201:content:application/json:examples:items_plan:value","block":"$L100a"}],"syncedPropertyName":"$undefined"}},"400":{"application/json":{"variants":[{"key":"default","label":"Example","rawValue":{"code":"string","message":"string","timestamp":123},"block":"$L100b"}],"syncedPropertyName":"$undefined"}},"401":{"application/json":{"variants":[{"key":"default","label":"Example","rawValue":{"code":"string","message":"string","timestamp":123},"block":"$L100c"}],"syncedPropertyName":"$undefined"}},"default":{"application/json":{"variants":[{"key":"default","label":"Example","rawValue":{"code":"string","message":"string","timestamp":123},"block":"$L100d"}],"syncedPropertyName":"$undefined"}}},"headingAs":"h4"}] f6e:"Update a location" f23:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unique ID representing the location where merchants sells products."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#tag-locations","target":"_blank","rel":"noreferrer","children":"Locations"}],"."]}]}]]}]]}] f24:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Name of the location."}],"\n",["$","div","inlinealert-0",{"data-type":"warning","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMark","color":"var(--rui-color-warning)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["The ",["$","code","code-0",{"children":"name"}]," parameter's value must be unique across all locations."]}]}]]}]]}] f25:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Type of the location."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Value","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"online"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Represents an online store.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"physical"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Represents a physical point of sale.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] f26:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Domain address of the location. Required for online locations."}],"\n",["$","div","inlinealert-0",{"data-type":"warning","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMark","color":"var(--rui-color-warning)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["The ",["$","code","code-0",{"children":"domain"}]," parameter's value must be unique across all locations."]}]}]]}]]}] f27:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Additional details of the location."}]]}] f28:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unique ID representing the location where merchants sells products."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#tag-locations","target":"_blank","rel":"noreferrer","children":"Locations"}],"."]}]}]]}]]}] f29:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Name of the location."}],"\n",["$","div","inlinealert-0",{"data-type":"warning","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMark","color":"var(--rui-color-warning)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["The ",["$","code","code-0",{"children":"name"}]," parameter's value must be unique across all locations."]}]}]]}]]}] f2a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Type of the location."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Value","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"online"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Represents an online store.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"physical"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Represents a physical point of sale.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] f2b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Primary address line."}]]}] f2c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Secondary address line, such as floor and apartment number."}]]}] f2d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"State or province of the address."}]]}] f2e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"City of the address."}]]}] f2f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"ISO 2-letter country code."}]]}] f30:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Postal code of the address."}]]}] f31:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Details of a physical address."}]]}] f32:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The latitude of the location, in decimal degrees."}]]}] f33:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"To longitude of the location, in decimal degrees."}]]}] f34:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Coordinates of the location."}]]}] fe5:"Create a subscription plan" f35:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The local time when the interval begins."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["The format is ",["$","code","code-0",{"children":"hh:mm[:ss]"}],"; seconds are optional and must be ",["$","code","code-1",{"children":"00"}]," if provided."]}]}]]}]]}] f36:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The local time when the interval ends."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["The format is ",["$","code","code-0",{"children":"hh:mm[:ss]"}],"; seconds are optional and must be ",["$","code","code-1",{"children":"00"}]," if provided."]}]}]]}]]}] f37:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Opening hours for Monday."}]]}] f38:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Opening hours for Tuesday."}]]}] f39:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Opening hours for Wednesday."}]]}] f3a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Opening hours for Thursday."}]]}] f3b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Opening hours for Friday."}]]}] f3c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Opening hours for Saturday."}]]}] f3d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Opening hours for Sunday."}]]}] f3e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An object containing the opening hours for each day of the week."}],"\n",["$","p","p-1",{"children":"A day can have multiple intervals (e.g., closing for a lunch break)."}]]}] f3f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Additional details of the location."}]]}] f40:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Location object represents merchant locations depending on type."}]]}] f41:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Location updated"}]]}] f42:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The ID of the error. You can share this ID with Revolut support for troubleshooting."}]]}] f43:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The date and time the error happened."}]]}] f44:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Bad Request"}]]}] f45:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The ID of the error. You can share this ID with Revolut support for troubleshooting."}]]}] f46:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The date and time the error happened."}]]}] f47:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unauthorized"}]]}] f48:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The ID of the error. You can share this ID with Revolut support for troubleshooting."}]]}] f49:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The date and time the error happened."}]]}] f4a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Not Found"}]]}] f4b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Name of the location."}],"\n",["$","div","inlinealert-0",{"data-type":"warning","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMark","color":"var(--rui-color-warning)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["The ",["$","code","code-0",{"children":"name"}]," parameter's value must be unique across all locations."]}]}]]}]]}] f4c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Domain address of the location. Required for online locations."}],"\n",["$","div","inlinealert-0",{"data-type":"warning","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMark","color":"var(--rui-color-warning)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["The ",["$","code","code-0",{"children":"domain"}]," parameter's value must be unique across all locations."]}]}]]}]]}] f4d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Additional details of the location."}]]}] f4e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unique ID representing the location where merchants sells products."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#tag-locations","target":"_blank","rel":"noreferrer","children":"Locations"}],"."]}]}]]}]]}] f4f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Name of the location."}],"\n",["$","div","inlinealert-0",{"data-type":"warning","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMark","color":"var(--rui-color-warning)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["The ",["$","code","code-0",{"children":"name"}]," parameter's value must be unique across all locations."]}]}]]}]]}] f50:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Type of the location."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Value","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"online"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Represents an online store.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"physical"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Represents a physical point of sale.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] f51:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Additional details of the location."}]]}] f52:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unique ID representing the location where merchants sells products."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#tag-locations","target":"_blank","rel":"noreferrer","children":"Locations"}],"."]}]}]]}]]}] f53:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Name of the location."}],"\n",["$","div","inlinealert-0",{"data-type":"warning","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMark","color":"var(--rui-color-warning)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["The ",["$","code","code-0",{"children":"name"}]," parameter's value must be unique across all locations."]}]}]]}]]}] f54:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Type of the location."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Value","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"online"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Represents an online store.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"physical"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Represents a physical point of sale.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] f55:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Primary address line."}]]}] f56:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Secondary address line, such as floor and apartment number."}]]}] f57:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"State or province of the address."}]]}] f58:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"City of the address."}]]}] f59:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"ISO 2-letter country code."}]]}] f5a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Postal code of the address."}]]}] f5b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Details of a physical address."}]]}] f5c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The latitude of the location, in decimal degrees."}]]}] f5d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"To longitude of the location, in decimal degrees."}]]}] f5e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Coordinates of the location."}]]}] f5f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The local time when the interval begins."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["The format is ",["$","code","code-0",{"children":"hh:mm[:ss]"}],"; seconds are optional and must be ",["$","code","code-1",{"children":"00"}]," if provided."]}]}]]}]]}] f60:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The local time when the interval ends."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["The format is ",["$","code","code-0",{"children":"hh:mm[:ss]"}],"; seconds are optional and must be ",["$","code","code-1",{"children":"00"}]," if provided."]}]}]]}]]}] f61:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Opening hours for Monday."}]]}] f62:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Opening hours for Tuesday."}]]}] f63:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Opening hours for Wednesday."}]]}] f64:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Opening hours for Thursday."}]]}] f65:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Opening hours for Friday."}]]}] f66:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Opening hours for Saturday."}]]}] f67:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Opening hours for Sunday."}]]}] f68:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An object containing the opening hours for each day of the week."}],"\n",["$","p","p-1",{"children":"A day can have multiple intervals (e.g., closing for a lunch break)."}]]}] f69:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Additional details of the location."}]]}] f6a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Location object represents merchant locations depending on type."}]]}] f6b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["Request body for updating a location. The structure of the ",["$","code","code-0",{"children":"details"}]," object depends on the ",["$","code","code-1",{"children":"type"}]," of the location."]}]]}] f6f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Update details of a specific location, based on its ID."}],"\n",["$","p","p-1",{"children":"Only the fields provided in the request will be updated. Any omitted fields will retain their current values."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["The value of the location's ",["$","code","code-0",{"children":"type"}]," parameter cannot be updated."]}]}]]}]]}] f70:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["This parameter accepts the ",["$","a","a-0",{"href":"https://business.revolut.com/settings/apis?tab=merchant-api","target":"_blank","rel":"noreferrer","children":"Merchant API Secret key"}]," to authorise requests coming from the merchant's backend."]}],"\n",["$","p","p-1",{"children":["It ensures that ensures that each request is authenticated and authorised by verifying the secret key. The secret key should be included in all request headers as a ",["$","code","code-0",{"children":"Bearer"}]," token."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#authentication","target":"_blank","rel":"noreferrer","children":"Authentication"}]]}]}]]}]]}] f71:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A UUID string, typically used to identify resources."}]]}] f72:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The ID of the location."}]]}] f82:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unique identifier for the subscription plan."}]]}] f83:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The name of the subscription plan."}]]}] f84:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The default trial period duration for this subscription plan in ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_8601#Durations","target":"_blank","rel":"noreferrer","children":"ISO 8601 duration format"}]," (e.g., \"P14D\" for 14 days)."]}],"\n",["$","p","p-1",{"children":"This value serves as the default trial duration for all subscriptions created from this plan. Individual subscriptions can override this value at creation time."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["Only days (",["$","code","code-0",{"children":"D"}],") are allowed. Time components such as hours, minutes, or seconds are not permitted."]}]}]]}]]}] f85:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The state of the subscription plan."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"State","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"active"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The plan is active and can be used to create new subscriptions.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"deactivated"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The plan has been deactivated and cannot be used for new subscriptions.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] f86:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The date and time the subscription plan was created in ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_8601","target":"_blank","rel":"noreferrer","children":"ISO 8601"}]," format."]}]]}] f87:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The date and time the subscription plan was last updated in ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_8601","target":"_blank","rel":"noreferrer","children":"ISO 8601"}]," format."]}]]}] f88:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unique identifier for the subscription plan variation."}]]}] f89:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unique identifier for the subscription plan phase."}]]}] f8a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The sequential order of this phase in the subscription billing lifecycle."}],"\n",["$","p","p-1",{"children":"Phases execute in ascending order based on this value:"}],"\n",["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["Phase with ",["$","code","code-0",{"children":"ordinal=1"}]," executes first"]}],"\n",["$","li","li-1",{"children":["Phase with ",["$","code","code-0",{"children":"ordinal=2"}]," executes second, and so on"]}],"\n"]}],"\n",["$","p","p-2",{"children":["When a phase completes its ",["$","code","code-0",{"children":"cycle_count"}],", the subscription automatically progresses to the phase with the next ",["$","code","code-1",{"children":"ordinal"}]," value."]}],"\n",["$","p","p-3",{"children":[["$","strong","strong-0",{"children":"Example"}],": A subscription with phases ordered as ",["$","code","code-0",{"children":"ordinal=1"}]," (trial), ",["$","code","code-1",{"children":"ordinal=2"}]," (regular), ",["$","code","code-2",{"children":"ordinal=3"}]," (discounted) will progress through them in that sequence."]}]]}] f22:["$","div","CodeBlock-0",{"className":"wzy01m0 _18b50nc0","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"
'Authorization: Bearer <yourSecretApiKey>'
"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"'Authorization: Bearer '\n"}]}]]}] fdd:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Each Merchant API request must contain an authorization header in the following format:"}],"\n","$L100e","\n",["$","p","p-1",{"children":"To use this API, you need to generate API keys from your Revolut Business account. The Secret key is used in the authorization header for all server calls, while the Public key is provided with payment methods at checkout."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For detailed instructions on generating your API keys, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/get-started#generate-api-keys","target":"_blank","rel":"noreferrer","children":"Generate API keys"}],"."]}]}]]}]]}] f8b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The length of each billing cycle for this phase in ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_8601#Durations","target":"_blank","rel":"noreferrer","children":"ISO 8601 duration format"}],"."]}],"\n",["$","p","p-1",{"children":["This determines how often the customer is billed during this phase. The total time spent in a phase is ",["$","code","code-0",{"children":"cycle_duration × cycle_count"}],"."]}],"\n",["$","p","p-2",{"children":[["$","strong","strong-0",{"children":"Common durations"}],":"]}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Duration","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"P1M"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"1 month","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"P1Y"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"1 year","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"P15D"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"15 days","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"P1W"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"1 week","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-4",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"PT2H"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"2 hours","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}],"\n",["$","p","p-3",{"children":[["$","strong","strong-0",{"children":"Example"}],": If ",["$","code","code-0",{"children":"cycle_duration=P1M"}]," and ",["$","code","code-1",{"children":"cycle_count=12"}],", the customer will be billed monthly for 12 months (1 year total)."]}]]}] f8c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Number of billing cycles for this phase before moving to the next phase."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Value","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Behavior","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":[["$","code","code-0",{"children":"null"}]," or omitted"],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Phase continues indefinitely. The subscription remains in this phase with no automatic progression.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["Specific number (e.g., ",["$","code","code-0",{"children":"1"}],", ",["$","code","code-1",{"children":"3"}],", ",["$","code","code-2",{"children":"12"}],")"],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["After completing this many billing cycles, the subscription automatically moves to the next phase as determined by the ",["$","code","code-0",{"children":"ordinal"}]," field."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}],"\n",["$","p","p-1",{"children":[["$","strong","strong-0",{"children":"Example"}],": If ",["$","code","code-0",{"children":"cycle_count=3"}]," and ",["$","code","code-1",{"children":"cycle_duration=P1M"}],", the subscription will complete 3 monthly cycles then move to the phase with the next highest ",["$","code","code-2",{"children":"ordinal"}]," value."]}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["If no next phase exists in after a cycle with a specific ",["$","code","code-0",{"children":"cycle_count"}],", the subscription will automatically stop when it completes its cycles."]}]}]]}]]}] f8d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Subscription amount in minor currency units (e.g., cents for USD, pence for GBP)."}],"\n",["$","p","p-1",{"children":["For example, ",["$","code","code-0",{"children":"9900"}]," in ",["$","code","code-1",{"children":"GBP"}]," represents £99.00."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["Conversion between major and minor units varies by currency. For instance, ",["$","code","code-0",{"children":"100"}]," minor units equal £1.00 in ",["$","code","code-1",{"children":"GBP"}],", whereas in ",["$","code","code-2",{"children":"ISK"}]," they represent 100 units. For more details, see the ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_4217","target":"_blank","rel":"noreferrer","children":"ISO 4217 standard"}],"."]}]}]]}]]}] f8e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":[["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_4217","target":"_blank","rel":"noreferrer","children":"ISO 4217"}]," currency code in upper case."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information about the supported currencies, see: ",["$","a","a-0",{"href":"https://help.revolut.com/business/help/merchant-accounts/payments/in-which-currencies-can-i-accept-payments/","target":"_blank","rel":"noreferrer","children":"Help Center"}],"."]}]}]]}]]}] f8f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The unique identifier of the subscription item."}]]}] f90:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The name of the subscription item."}]]}] f91:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of subscription item."}]]}] f92:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The number of units grouped together as a single billable package. Used to enable pricing of items that are too inexpensive to charge individually."}],"\n",["$","p","p-1",{"children":["For example, a ",["$","code","code-0",{"children":"package_size"}]," of ",["$","code","code-1",{"children":"1000"}]," with a unit price of 10 minor units (£0.10 in GBP) lets you sell 1000 tokens for £0.10 — effectively pricing each token at £0.0001, below the minimum chargeable amount."]}],"\n",["$","p","p-2",{"children":["Set to ",["$","code","code-0",{"children":"1"}]," to price each unit individually."]}]]}] f93:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The unit of measurement for the item."}]]}] f94:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The quantity of the item."}]]}] f95:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Amount in minor currency units (e.g., cents for USD)."}]]}] f96:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":[["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_4217","target":"_blank","rel":"noreferrer","children":"ISO 4217"}]," currency code in upper case."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information about the supported currencies, see: ",["$","a","a-0",{"href":"https://help.revolut.com/business/help/merchant-accounts/payments/in-which-currencies-can-i-accept-payments/","target":"_blank","rel":"noreferrer","children":"Help Center"}],"."]}]}]]}]]}] f97:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object structure of flat subscription item."}]]}] f98:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The unique identifier of the subscription item."}]]}] f99:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The name of the subscription item."}]]}] f9a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of subscription item."}]]}] f9b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The number of units grouped together as a single billable package. Used to enable pricing of items that are too inexpensive to charge individually."}],"\n",["$","p","p-1",{"children":["For example, a ",["$","code","code-0",{"children":"package_size"}]," of ",["$","code","code-1",{"children":"1000"}]," with a unit price of 10 minor units (£0.10 in GBP) lets you sell 1000 tokens for £0.10 — effectively pricing each token at £0.0001, below the minimum chargeable amount."]}],"\n",["$","p","p-2",{"children":["Set to ",["$","code","code-0",{"children":"1"}]," to price each unit individually."]}]]}] f9c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The unit of measurement for the item."}]]}] f9d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["Flat amount per unit in minor currency units. Mutually exclusive with ",["$","code","code-0",{"children":"tiers"}],"."]}]]}] f9e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":[["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_4217","target":"_blank","rel":"noreferrer","children":"ISO 4217"}]," currency code in upper case."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information about the supported currencies, see: ",["$","a","a-0",{"href":"https://help.revolut.com/business/help/merchant-accounts/payments/in-which-currencies-can-i-accept-payments/","target":"_blank","rel":"noreferrer","children":"Help Center"}],"."]}]}]]}]]}] f9f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The upper bound of the tier (exclusive). Null means unlimited."}]]}] fa0:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Per-unit amount in minor currency units (e.g., cents for USD) charged for usage within this tier's threshold range."}]]}] fa1:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["Graduated pricing tiers. Mutually exclusive with ",["$","code","code-0",{"children":"amount"}],"."]}]]}] fa2:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["A merchant-defined identifier for a usage-based subscription item. You set this code on each usage item when creating a subscription plan, and supply it when reporting consumption on ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#create-subscription-usage","target":"_blank","rel":"noreferrer","children":"Create a subscription usage endpoint"}]," to target the correct metered item."]}],"\n",["$","p","p-1",{"children":["This allows a subscription with multiple usage items (e.g., ",["$","code","code-0",{"children":"api_calls"}]," and ",["$","code","code-1",{"children":"storage_gb"}],") to receive consumption reports against the right item without relying on internal IDs."]}],"\n",["$","p","p-2",{"children":"The code must be unique within a plan phase."}]]}] fa3:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The method used to aggregate usage events over a billing cycle to calculate the chargeable amount."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Value","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Behaviour","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"sum"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Totals all reported usage events during the cycle. Use for cumulative metrics (e.g., API calls, data transferred).","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"latest"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["Uses the most recently reported value at the end of the cycle. If no usage is reported in a cycle, ",["$","code","code-0",{"children":"0"}]," is used — values do not carry over from previous cycles. Use for gauge-style metrics (e.g., active seats)."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"max"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Uses the peak value reported during the cycle. Use for capacity-based billing (e.g., max concurrent connections).","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] fa4:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object structure of usage subscription item."}]]}] fa5:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A subscription item that defines a billing line within a plan phase. Can be either a fixed-fee (flat) item or a metered (usage) item."}]]}] fa6:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A list of subscription items for this phase."}]]}] fa7:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"List of billing phases for this variation."}]]}] fa8:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"List of subscription plan variations."}]]}] fa9:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Subscription plan created successfully"}]]}] faa:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An identifier that can be used to determine what went wrong."}],"\n",["$","p","p-1",{"children":"Error codes are not globally unique, but uniqueness is guaranteed within endpoints."}]]}] fab:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Some human readable text describing what went wrong."}]]}] fac:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://www.unixtimestamp.com/","target":"_blank","rel":"noreferrer","children":"UNIX timestamp"}]," of the date and time the error happened."]}]]}] fad:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Bad Request"}]]}] fae:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An identifier that can be used to determine what went wrong."}],"\n",["$","p","p-1",{"children":"Error codes are not globally unique, but uniqueness is guaranteed within endpoints."}]]}] faf:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Some human readable text describing what went wrong."}]]}] fb0:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://www.unixtimestamp.com/","target":"_blank","rel":"noreferrer","children":"UNIX timestamp"}]," of the date and time the error happened."]}]]}] fb1:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unauthorized"}]]}] fb2:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An identifier that can be used to determine what went wrong."}],"\n",["$","p","p-1",{"children":"Error codes are not globally unique, but uniqueness is guaranteed within endpoints."}]]}] fb3:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Some human readable text describing what went wrong."}]]}] fb4:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://www.unixtimestamp.com/","target":"_blank","rel":"noreferrer","children":"UNIX timestamp"}]," of the date and time the error happened."]}]]}] fb5:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Error response"}]]}] fb6:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The name of the subscription plan."}]]}] fb7:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The default trial period duration for this subscription plan in ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_8601#Durations","target":"_blank","rel":"noreferrer","children":"ISO 8601 duration format"}]," (e.g., \"P14D\" for 14 days)."]}],"\n",["$","p","p-1",{"children":"This value serves as the default trial duration for all subscriptions created from this plan. Individual subscriptions can override this value at creation time."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["Only days (",["$","code","code-0",{"children":"D"}],") are allowed. Time components such as hours, minutes, or seconds are not permitted."]}]}]]}]]}] fb8:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The sequential order of this phase in the subscription billing lifecycle."}],"\n",["$","p","p-1",{"children":"Phases execute in ascending order based on this value:"}],"\n",["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["Phase with ",["$","code","code-0",{"children":"ordinal=1"}]," executes first"]}],"\n",["$","li","li-1",{"children":["Phase with ",["$","code","code-0",{"children":"ordinal=2"}]," executes second, and so on"]}],"\n"]}],"\n",["$","p","p-2",{"children":["When a phase completes its ",["$","code","code-0",{"children":"cycle_count"}],", the subscription automatically progresses to the phase with the next ",["$","code","code-1",{"children":"ordinal"}]," value."]}],"\n",["$","p","p-3",{"children":[["$","strong","strong-0",{"children":"Example"}],": A subscription with phases ordered as ",["$","code","code-0",{"children":"ordinal=1"}]," (trial), ",["$","code","code-1",{"children":"ordinal=2"}]," (regular), ",["$","code","code-2",{"children":"ordinal=3"}]," (discounted) will progress through them in that sequence."]}]]}] fb9:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The length of each billing cycle for this phase in ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_8601#Durations","target":"_blank","rel":"noreferrer","children":"ISO 8601 duration format"}],"."]}],"\n",["$","p","p-1",{"children":["This determines how often the customer is billed during this phase. The total time spent in a phase is ",["$","code","code-0",{"children":"cycle_duration × cycle_count"}],"."]}],"\n",["$","p","p-2",{"children":[["$","strong","strong-0",{"children":"Common durations"}],":"]}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Duration","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"P1M"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"1 month","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"P1Y"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"1 year","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"P15D"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"15 days","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"P1W"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"1 week","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-4",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"PT2H"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"2 hours","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}],"\n",["$","p","p-3",{"children":[["$","strong","strong-0",{"children":"Example"}],": If ",["$","code","code-0",{"children":"cycle_duration=P1M"}]," and ",["$","code","code-1",{"children":"cycle_count=12"}],", the customer will be billed monthly for 12 months (1 year total)."]}]]}] fba:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Number of billing cycles for this phase before moving to the next phase."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Value","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Behavior","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":[["$","code","code-0",{"children":"null"}]," or omitted"],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Phase continues indefinitely. The subscription remains in this phase with no automatic progression.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["Specific number (e.g., ",["$","code","code-0",{"children":"1"}],", ",["$","code","code-1",{"children":"3"}],", ",["$","code","code-2",{"children":"12"}],")"],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["After completing this many billing cycles, the subscription automatically moves to the next phase as determined by the ",["$","code","code-0",{"children":"ordinal"}]," field."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}],"\n",["$","p","p-1",{"children":[["$","strong","strong-0",{"children":"Example"}],": If ",["$","code","code-0",{"children":"cycle_count=3"}]," and ",["$","code","code-1",{"children":"cycle_duration=P1M"}],", the subscription will complete 3 monthly cycles then move to the phase with the next highest ",["$","code","code-2",{"children":"ordinal"}]," value."]}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["If no next phase exists in after a cycle with a specific ",["$","code","code-0",{"children":"cycle_count"}],", the subscription will automatically stop when it completes its cycles."]}]}]]}]]}] fbb:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Subscription amount in minor currency units (e.g., cents for USD, pence for GBP)."}],"\n",["$","p","p-1",{"children":["For example, ",["$","code","code-0",{"children":"9900"}]," in ",["$","code","code-1",{"children":"GBP"}]," represents £99.00."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["Conversion between major and minor units varies by currency. For instance, ",["$","code","code-0",{"children":"100"}]," minor units equal £1.00 in ",["$","code","code-1",{"children":"GBP"}],", whereas in ",["$","code","code-2",{"children":"ISK"}]," they represent 100 units. For more details, see the ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_4217","target":"_blank","rel":"noreferrer","children":"ISO 4217 standard"}],"."]}]}]]}]]}] fbc:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":[["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_4217","target":"_blank","rel":"noreferrer","children":"ISO 4217"}]," currency code in upper case."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information about the supported currencies, see: ",["$","a","a-0",{"href":"https://help.revolut.com/business/help/merchant-accounts/payments/in-which-currencies-can-i-accept-payments/","target":"_blank","rel":"noreferrer","children":"Help Center"}],"."]}]}]]}]]}] fbd:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The name of the subscription item."}]]}] fbe:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of subscription item."}]]}] fbf:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The number of units grouped together as a single billable package. Used to enable pricing of items that are too inexpensive to charge individually."}],"\n",["$","p","p-1",{"children":["For example, a ",["$","code","code-0",{"children":"package_size"}]," of ",["$","code","code-1",{"children":"1000"}]," with a unit price of 10 minor units (£0.10 in GBP) lets you sell 1000 tokens for £0.10 — effectively pricing each token at £0.0001, below the minimum chargeable amount."]}],"\n",["$","p","p-2",{"children":["Set to ",["$","code","code-0",{"children":"1"}]," to price each unit individually."]}]]}] fc0:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The unit of measurement for the item."}]]}] fc1:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The quantity of the item."}]]}] fc2:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Amount in minor currency units (e.g., cents for USD)."}]]}] fc3:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":[["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_4217","target":"_blank","rel":"noreferrer","children":"ISO 4217"}]," currency code in upper case."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information about the supported currencies, see: ",["$","a","a-0",{"href":"https://help.revolut.com/business/help/merchant-accounts/payments/in-which-currencies-can-i-accept-payments/","target":"_blank","rel":"noreferrer","children":"Help Center"}],"."]}]}]]}]]}] fc4:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object structure of flat subscription item."}]]}] fc5:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The name of the subscription item."}]]}] fc6:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of subscription item."}]]}] fc7:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The number of units grouped together as a single billable package. Used to enable pricing of items that are too inexpensive to charge individually."}],"\n",["$","p","p-1",{"children":["For example, a ",["$","code","code-0",{"children":"package_size"}]," of ",["$","code","code-1",{"children":"1000"}]," with a unit price of 10 minor units (£0.10 in GBP) lets you sell 1000 tokens for £0.10 — effectively pricing each token at £0.0001, below the minimum chargeable amount."]}],"\n",["$","p","p-2",{"children":["Set to ",["$","code","code-0",{"children":"1"}]," to price each unit individually."]}]]}] fc8:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The unit of measurement for the item."}]]}] fc9:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["Flat amount per unit in minor currency units. Mutually exclusive with ",["$","code","code-0",{"children":"tiers"}],"."]}]]}] fca:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":[["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_4217","target":"_blank","rel":"noreferrer","children":"ISO 4217"}]," currency code in upper case."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information about the supported currencies, see: ",["$","a","a-0",{"href":"https://help.revolut.com/business/help/merchant-accounts/payments/in-which-currencies-can-i-accept-payments/","target":"_blank","rel":"noreferrer","children":"Help Center"}],"."]}]}]]}]]}] fcb:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The upper bound of the tier (exclusive). Null means unlimited."}]]}] fcc:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Per-unit amount in minor currency units (e.g., cents for USD) charged for usage within this tier's threshold range."}]]}] fcd:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["Graduated pricing tiers. Mutually exclusive with ",["$","code","code-0",{"children":"amount"}],"."]}]]}] fce:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["A merchant-defined identifier for a usage-based subscription item. You set this code on each usage item when creating a subscription plan, and supply it when reporting consumption on ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#create-subscription-usage","target":"_blank","rel":"noreferrer","children":"Create a subscription usage endpoint"}]," to target the correct metered item."]}],"\n",["$","p","p-1",{"children":["This allows a subscription with multiple usage items (e.g., ",["$","code","code-0",{"children":"api_calls"}]," and ",["$","code","code-1",{"children":"storage_gb"}],") to receive consumption reports against the right item without relying on internal IDs."]}],"\n",["$","p","p-2",{"children":"The code must be unique within a plan phase."}]]}] fcf:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The method used to aggregate usage events over a billing cycle to calculate the chargeable amount."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Value","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Behaviour","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"sum"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Totals all reported usage events during the cycle. Use for cumulative metrics (e.g., API calls, data transferred).","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"latest"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["Uses the most recently reported value at the end of the cycle. If no usage is reported in a cycle, ",["$","code","code-0",{"children":"0"}]," is used — values do not carry over from previous cycles. Use for gauge-style metrics (e.g., active seats)."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"max"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Uses the peak value reported during the cycle. Use for capacity-based billing (e.g., max concurrent connections).","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] fd0:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object structure for usage subscription item."}]]}] fd1:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A subscription item for a plan phase. Can be either a fixed-fee (flat) item or a metered (usage) item."}]]}] fd2:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A list of subscription items for this phase."}]]}] fd3:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"List of billing phases for this variation."}]]}] fd4:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"List of subscription plan variations (e.g., monthly, yearly pricing options)."}]]}] fe6:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Create a new subscription plan with one or more pricing variations."}],"\n",["$","p","p-1",{"children":"A subscription plan defines the billing structure for subscriptions. Each plan can have multiple variations (e.g., monthly vs. yearly), and each variation can have multiple billing phases (e.g., trial period followed by regular billing). These plans are designed for flexibility, allowing you to combine fixed recurring fees with unit-based or usage-based charges into a single, unified subscription."}],"\n",["$","h3","h3-0",{"children":"How subscription plans work"}],"\n",["$","p","p-2",{"children":"A subscription plan consists of four hierarchical levels:"}],"\n",["$","ol","ol-0",{"children":["\n",["$","li","li-0",{"children":[["$","strong","strong-0",{"children":"Plan"}],": The top-level container (e.g., \"Standard Plan\")"]}],"\n",["$","li","li-1",{"children":[["$","strong","strong-0",{"children":"Variations"}],": Different pricing options (e.g., monthly vs. yearly)"]}],"\n",["$","li","li-2",{"children":[["$","strong","strong-0",{"children":"Phases"}],": Sequential billing stages within each variation"]}],"\n",["$","li","li-3",{"children":[["$","strong","strong-0",{"children":"Subscription items"}],": Individual line items within a phase that define ",["$","strong","strong-1",{"children":"how"}]," to charge (e.g., a base fee plus per-unit charges)"]}],"\n"]}],"\n",["$","h5","h5-0",{"children":"Phases and billing items"}],"\n",["$","p","p-3",{"children":["If a ",["$","code","code-0",{"children":"trial_duration"}]," is defined at the variation level, billing phases begin immediately after the trial ends. Phases execute in sequence based on their ",["$","code","code-1",{"children":"ordinal"}]," value (1, 2, 3, etc.):"]}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Concept","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Behaviour","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","strong","strong-0",{"children":"Cycle control"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["Each phase has a ",["$","code","code-0",{"children":"cycle_duration"}]," (e.g., ",["$","code","code-1",{"children":"P1M"}]," for monthly). Use ",["$","code","code-2",{"children":"cycle_count"}]," to limit how many cycles occur; if ",["$","code","code-3",{"children":"null"}]," or omitted, the phase runs indefinitely."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","strong","strong-0",{"children":"Sequential transition"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["When a phase completes its cycles, the subscription advances to the next ",["$","code","code-0",{"children":"ordinal"}],". If no next phase exists, the subscription stops automatically."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","strong","strong-0",{"children":"Item composition"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["Each phase contains one or more ",["$","code","code-0",{"children":"subscription_items"}]," defining how charges are calculated: ",["$","strong","strong-0",{"children":"flat"}]," items apply a fixed cost multiplied by ",["$","code","code-1",{"children":"quantity"}],"; ",["$","strong","strong-1",{"children":"usage"}]," items are metered at the end of the cycle based on reported consumption."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}],"\n",["$","div","inlinealert-0",{"data-type":"tip","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"Lightbulb","color":"var(--rui-color-success)","inline":true}]}],["$","div",null,{"className":"_25vm6y2","children":"Example: Multi-item billing"}],"$L100f"]}]]}] fe7:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["This parameter accepts the ",["$","a","a-0",{"href":"https://business.revolut.com/settings/apis?tab=merchant-api","target":"_blank","rel":"noreferrer","children":"Merchant API Secret key"}]," to authorise requests coming from the merchant's backend."]}],"\n",["$","p","p-1",{"children":["It ensures that ensures that each request is authenticated and authorised by verifying the secret key. The secret key should be included in all request headers as a ",["$","code","code-0",{"children":"Bearer"}]," token."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#authentication","target":"_blank","rel":"noreferrer","children":"Authentication"}]]}]}]]}]]}] fe8:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The version of the Merchant API, specified in ",["$","code","code-0",{"children":"YYYY-MM-DD"}]," format."]}],"\n",["$","p","p-1",{"children":"If not specified, you will receive an error."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information about API versioning, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/reference/versioning/api-versions","target":"_blank","rel":"noreferrer","children":"API versions"}],"."]}]}]]}]]}] 100f:["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":["A plan combining a ",["$","strong","strong-0",{"children":"base platform fee"}]," and ",["$","strong","strong-1",{"children":"monthly user licenses"}],":"]}],["$","p","p-1",{"children":[["$","strong","strong-0",{"children":"Variation:"}]," ",["$","code","code-0",{"children":"Monthly Team"}]]}],["$","p","p-2",{"children":[["$","strong","strong-0",{"children":"Phase 1"}]," — ",["$","code","code-0",{"children":"ordinal: 1"}],", ",["$","code","code-1",{"children":"cycle_duration: P1M"}]]}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Item","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Type","className":"eowryt6","ref":"$undefined"}],["$","th","th-2",{"children":["$","code","code-0",{"children":"amount"}],"className":"eowryt6","ref":"$undefined"}],["$","th","th-3",{"children":["$","code","code-0",{"children":"quantity"}],"className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","strong","strong-0",{"children":"Base platform fee"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["$","code","code-0",{"children":"flat"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-2",{"children":[["$","code","code-0",{"children":"4900"}]," (£49.00)"],"className":"eowryt7","ref":"$undefined"}],["$","td","td-3",{"children":["$","code","code-0",{"children":"1"}],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","strong","strong-0",{"children":"User licenses"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["$","code","code-0",{"children":"flat"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-2",{"children":[["$","code","code-0",{"children":"1000"}]," (£10.00 per unit)"],"className":"eowryt7","ref":"$undefined"}],["$","td","td-3",{"children":["$","code","code-0",{"children":"5"}],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}],["$","p","p-3",{"children":"The customer is billed a fixed platform fee plus £10.00 for each of their 5 active licenses every month."}]]}] ffc:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Each Merchant API request must contain an authorization header in the following format:"}],"\n","$L1010","\n",["$","p","p-1",{"children":"To use this API, you need to generate API keys from your Revolut Business account. The Secret key is used in the authorization header for all server calls, while the Public key is provided with payment methods at checkout."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For detailed instructions on generating your API keys, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/get-started#generate-api-keys","target":"_blank","rel":"noreferrer","children":"Generate API keys"}],"."]}]}]]}]]}] 1011:T44d,
{
  "name": "Cars website - Name update",
  "details": {
    "domain": "cars.example.com"
  }
}
fde:["$","div","request-application/json-online_location",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$1011"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"name\": \"Cars website - Name update\",\n \"details\": {\n \"domain\": \"cars.example.com\"\n }\n}"}]}]]}] 1012:Tb9b,
{
  "name": "Example Street Store",
  "details": {
    "opening_hours": {
      "monday": [
        {
          "from": "10:00",
          "to": "18:00"
        }
      ],
      "wednesday": [
        {
          "from": "11:00",
          "to": "18:00"
        }
      ]
    }
  }
}
fdf:["$","div","request-application/json-physical_location",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$1012"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"name\": \"Example Street Store\",\n \"details\": {\n \"opening_hours\": {\n \"monday\": [\n {\n \"from\": \"10:00\",\n \"to\": \"18:00\"\n }\n ],\n \"wednesday\": [\n {\n \"from\": \"11:00\",\n \"to\": \"18:00\"\n }\n ]\n }\n }\n}"}]}]]}] 1013:T685,
{
  "id": "8d9a7125-805f-40f3-a405-bc89765db996",
  "name": "Cars website - Name update",
  "type": "online",
  "details": {
    "domain": "cars.example.com"
  }
}
fe0:["$","div","200-application/json-online_location",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$1013"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"id\": \"8d9a7125-805f-40f3-a405-bc89765db996\",\n \"name\": \"Cars website - Name update\",\n \"type\": \"online\",\n \"details\": {\n \"domain\": \"cars.example.com\"\n }\n}"}]}]]}] 1014:T1ad4,
{
  "name": "Example Street Store",
  "type": "physical",
  "details": {
    "address": null,
    "street_line_1": "123 Example Street",
    "city": "Example city",
    "postcode": "12345",
    "country_code": "GB"
  },
  "geo_location": {
    "lat": 12.3456,
    "lon": -12.3456
  },
  "opening_hours": {
    "monday": [
      {
        "from": "10:00",
        "to": "18:00"
      }
    ],
    "tuesday": [
      {
        "from": "10:00",
        "to": "13:00"
      },
      {
        "from": "16:00",
        "to": "18:00"
      }
    ],
    "wednesday": [
      {
        "from": "11:00",
        "to": "18:00"
      }
    ]
  }
}
fe1:["$","div","200-application/json-physical_location",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$1014"}}]}]],"$L1015"]}] fe2:["$","div","400-application/json-default",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"
{\n  \"errorId\": \"string\",\n  \"timestamp\": 123\n}
"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"errorId\": \"string\",\n \"timestamp\": 123\n}"}]}]]}] fe3:["$","div","401-application/json-default",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"
{\n  \"errorId\": \"string\",\n  \"timestamp\": 123\n}
"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"errorId\": \"string\",\n \"timestamp\": 123\n}"}]}]]}] fe4:["$","div","404-application/json-default",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"
{\n  \"errorId\": \"string\",\n  \"timestamp\": 123\n}
"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"errorId\": \"string\",\n \"timestamp\": 123\n}"}]}]]}] 1015:["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"name\": \"Example Street Store\",\n \"type\": \"physical\",\n \"details\": {\n \"address\": null,\n \"street_line_1\": \"123 Example Street\",\n \"city\": \"Example city\",\n \"postcode\": \"12345\",\n \"country_code\": \"GB\"\n },\n \"geo_location\": {\n \"lat\": 12.3456,\n \"lon\": -12.3456\n },\n \"opening_hours\": {\n \"monday\": [\n {\n \"from\": \"10:00\",\n \"to\": \"18:00\"\n }\n ],\n \"tuesday\": [\n {\n \"from\": \"10:00\",\n \"to\": \"13:00\"\n },\n {\n \"from\": \"16:00\",\n \"to\": \"18:00\"\n }\n ],\n \"wednesday\": [\n {\n \"from\": \"11:00\",\n \"to\": \"18:00\"\n }\n ]\n }\n}"}]}] 1016:T1066,
{
  "name": "Enterprise Pro Plan",
  "variations": [
    {
      "phases": [
        {
          "ordinal": 1,
          "cycle_duration": "P1Y",
          "amount": 99900,
          "currency": "GBP"
        }
      ]
    },
    {
      "phases": [
        {
          "ordinal": 1,
          "cycle_duration": "P1M",
          "amount": 9900,
          "currency": "GBP"
        }
      ]
    }
  ]
}
ffd:["$","div","request-application/json-simple_plan",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$1016"}}]}]],"$L1017"]}] 1018:Tb06,
{
  "name": "Premium Plan with 14-day Trial",
  "trial_duration": "P14D",
  "variations": [
    {
      "phases": [
        {
          "ordinal": 1,
          "cycle_duration": "P1M",
          "amount": 9900,
          "currency": "GBP"
        }
      ]
    }
  ]
}
ffe:["$","div","request-application/json-trial_plan_with_duration",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$1018"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"name\": \"Premium Plan with 14-day Trial\",\n \"trial_duration\": \"P14D\",\n \"variations\": [\n {\n \"phases\": [\n {\n \"ordinal\": 1,\n \"cycle_duration\": \"P1M\",\n \"amount\": 9900,\n \"currency\": \"GBP\"\n }\n ]\n }\n ]\n}"}]}]]}] 1019:Tafe,
{
  "name": "12-month Limited Plan",
  "variations": [
    {
      "phases": [
        {
          "ordinal": 1,
          "cycle_duration": "P1M",
          "cycle_count": 12,
          "amount": 1000,
          "currency": "GBP"
        }
      ]
    }
  ]
}
fff:["$","div","request-application/json-limited_plan",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$1019"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"name\": \"12-month Limited Plan\",\n \"variations\": [\n {\n \"phases\": [\n {\n \"ordinal\": 1,\n \"cycle_duration\": \"P1M\",\n \"cycle_count\": 12,\n \"amount\": 1000,\n \"currency\": \"GBP\"\n }\n ]\n }\n ]\n}"}]}]]}] 101a:T18c7,
{
  "name": "API Usage Plan",
  "variations": [
    {
      "phases": [
        {
          "ordinal": 1,
          "cycle_duration": "P1M",
          "subscription_items": [
            {
              "name": "API Calls",
              "type": "usage",
              "currency": "GBP",
              "unit": "calls",
              "code": "api_calls",
              "usage_aggregation_method": "sum",
              "tiers": [
                {
                  "upper_quantity_threshold": 1000,
                  "amount": 0
                },
                {
                  "upper_quantity_threshold": 10000,
                  "amount": 10
                },
                {
                  "amount": 5
                }
              ]
            }
          ]
        }
      ]
    }
  ]
}
1000:["$","div","request-application/json-usage_base_plan",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$101a"}}]}]],"$L101b"]}] 101c:T295d,
{
  "name": "Professional Plan",
  "variations": [
    {
      "phases": [
        {
          "ordinal": 1,
          "cycle_duration": "P1M",
          "subscription_items": [
            {
              "name": "Base Subscription",
              "type": "flat",
              "quantity": 1,
              "amount": 2900,
              "currency": "GBP",
              "unit": "subscription"
            },
            {
              "name": "API Calls",
              "type": "usage",
              "currency": "GBP",
              "unit": "calls",
              "code": "api_calls",
              "usage_aggregation_method": "sum",
              "amount": 10
            },
            {
              "name": "Storage",
              "type": "usage",
              "currency": "GBP",
              "unit": "gb",
              "code": "storage_gb",
              "usage_aggregation_method": "max",
              "package_size": 1,
              "tiers": [
                {
                  "upper_quantity_threshold": 10,
                  "amount": 0
                },
                {
                  "upper_quantity_threshold": 100,
                  "amount": 50
                },
                {
                  "amount": 30
                }
              ]
            }
          ]
        }
      ]
    }
  ]
}
1001:["$","div","request-application/json-hybrid_plan",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$101c"}}]}]],"$L101d"]}] 101e:T1269,
{
  "name": "SMS Plan",
  "variations": [
    {
      "phases": [
        {
          "ordinal": 1,
          "cycle_duration": "P1M",
          "subscription_items": [
            {
              "name": "SMS Messages",
              "type": "usage",
              "currency": "GBP",
              "unit": "messages",
              "code": "sms_messages",
              "usage_aggregation_method": "sum",
              "package_size": 1000,
              "amount": 500
            }
          ]
        }
      ]
    }
  ]
}
1002:["$","div","request-application/json-package_plan",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$101e"}}]}]],"$L101f"]}] 1020:T1aaa,
{
  "name": "Professional Platform Plan",
  "variations": [
    {
      "phases": [
        {
          "ordinal": 1,
          "cycle_duration": "P1M",
          "amount": 4900,
          "currency": "GBP",
          "subscription_items": [
            {
              "type": "flat",
              "name": "Platform License",
              "unit": "subscription",
              "quantity": 1,
              "amount": 4900,
              "currency": "GBP"
            },
            {
              "type": "usage",
              "name": "API Calls",
              "unit": "call",
              "code": "api_calls",
              "usage_aggregation_method": "sum",
              "amount": 1,
              "currency": "GBP"
            }
          ]
        }
      ]
    }
  ]
}
1003:["$","div","request-application/json-items_plan",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$1020"}}]}]],"$L1021"]}] 1022:T19af,
{
  "id": "f757b068-f287-43c8-8d05-9c073fecbe73",
  "name": "Enterprise Pro Plan",
  "state": "active",
  "created_at": "2026-01-26T08:59:09.433527Z",
  "updated_at": "2026-01-26T08:59:09.433527Z",
  "variations": [
    {
      "id": "f4e0a171-4f4e-484b-b0a2-22085059af65",
      "phases": [
        {
          "id": "23319d04-4b23-4ae7-ba54-82112c752683",
          "ordinal": 1,
          "cycle_duration": "P1M",
          "amount": 990,
          "currency": "GBP"
        }
      ]
    },
    {
      "id": "7cf47b0d-3da9-496b-a4e9-fbbe43c33ee3",
      "phases": [
        {
          "id": "feed2491-c895-4bfa-ba05-a3a088842d5c",
          "ordinal": 1,
          "cycle_duration": "P1Y",
          "amount": 9990,
          "currency": "GBP"
        }
      ]
    }
  ]
}
1004:["$","div","201-application/json-simple_plan",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$1022"}}]}]],"$L1023"]}] 1024:T11f1,
{
  "id": "750e8400-e29b-41d4-a716-446655440010",
  "name": "Premium Plan with 14-day Trial",
  "trial_duration": "P14D",
  "state": "active",
  "created_at": "2025-06-04T21:00:00.036001Z",
  "updated_at": "2025-06-04T21:00:00.036001Z",
  "variations": [
    {
      "id": "850e8400-e29b-41d4-a716-446655440011",
      "phases": [
        {
          "id": "950e8400-e29b-41d4-a716-446655440012",
          "ordinal": 1,
          "cycle_duration": "P1M",
          "amount": 9900,
          "currency": "GBP"
        }
      ]
    }
  ]
}
1005:["$","div","201-application/json-trial_plan_with_duration",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$1024"}}]}]],"$L1025"]}] 1026:T11e9,
{
  "id": "550e8400-e29b-41d4-a716-446655440003",
  "name": "12-month Limited Plan",
  "state": "active",
  "created_at": "2025-06-05T21:00:00.036001Z",
  "updated_at": "2025-06-05T21:00:00.036001Z",
  "variations": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440004",
      "phases": [
        {
          "id": "550e8400-e29b-41d4-a716-446655440005",
          "ordinal": 1,
          "cycle_duration": "P1M",
          "cycle_count": 12,
          "amount": 1000,
          "currency": "GBP"
        }
      ]
    }
  ]
}
1006:["$","div","201-application/json-limited_plan",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$1026"}}]}]],"$L1027"]}] 1028:T1fac,
{
  "id": "8d2c8872-9e8a-4b1a-827c-3f78e1234abc",
  "name": "API Usage Plan",
  "state": "active",
  "created_at": "2026-04-15T17:58:36.000Z",
  "updated_at": "2026-04-15T17:58:36.000Z",
  "variations": [
    {
      "id": "a4e0a171-4f4e-484b-b0a2-22085059df99",
      "phases": [
        {
          "id": "ceed2491-c895-4bfa-ba05-a3a088842e11",
          "ordinal": 1,
          "cycle_duration": "P1M",
          "subscription_items": [
            {
              "name": "API Calls",
              "type": "usage",
              "currency": "GBP",
              "unit": "calls",
              "code": "api_calls",
              "usage_aggregation_method": "sum",
              "tiers": [
                {
                  "upper_quantity_threshold": 1000,
                  "amount": 0
                },
                {
                  "upper_quantity_threshold": 10000,
                  "amount": 10
                },
                {
                  "amount": 5
                }
              ]
            }
          ]
        }
      ]
    }
  ]
}
1007:["$","div","201-application/json-usage_base_plan",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$1028"}}]}]],"$L1029"]}] 102a:T3042,
{
  "id": "b22198c4-724d-4e9e-b9e3-827c3f78e456",
  "name": "Professional Plan",
  "state": "active",
  "created_at": "2026-04-15T18:02:11.000Z",
  "updated_at": "2026-04-15T18:02:11.000Z",
  "variations": [
    {
      "id": "d4e0a171-4f4e-484b-b0a2-22085059df77",
      "phases": [
        {
          "id": "ffeed491-c895-4bfa-ba05-a3a088842e22",
          "ordinal": 1,
          "cycle_duration": "P1M",
          "subscription_items": [
            {
              "name": "Base Subscription",
              "type": "flat",
              "quantity": 1,
              "amount": 2900,
              "currency": "GBP",
              "unit": "subscription"
            },
            {
              "name": "API Calls",
              "type": "usage",
              "currency": "GBP",
              "unit": "calls",
              "code": "api_calls",
              "usage_aggregation_method": "sum",
              "amount": 10
            },
            {
              "name": "Storage",
              "type": "usage",
              "currency": "GBP",
              "unit": "gb",
              "code": "storage_gb",
              "usage_aggregation_method": "max",
              "package_size": 1,
              "tiers": [
                {
                  "upper_quantity_threshold": 10,
                  "amount": 0
                },
                {
                  "upper_quantity_threshold": 100,
                  "amount": 50
                },
                {
                  "amount": 30
                }
              ]
            }
          ]
        }
      ]
    }
  ]
}
1008:["$","div","201-application/json-hybrid_plan",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$102a"}}]}]],"$L102b"]}] 102c:T194e,
{
  "id": "e33198c4-124d-4e9e-b9e3-827c3f78e789",
  "name": "SMS Plan",
  "state": "active",
  "created_at": "2026-04-15T18:05:42.000Z",
  "updated_at": "2026-04-15T18:05:42.000Z",
  "variations": [
    {
      "id": "c4e0a171-4f4e-484b-b0a2-22085059df44",
      "phases": [
        {
          "id": "ddeed491-c895-4bfa-ba05-a3a088842e33",
          "ordinal": 1,
          "cycle_duration": "P1M",
          "subscription_items": [
            {
              "name": "SMS Messages",
              "type": "usage",
              "currency": "GBP",
              "unit": "messages",
              "code": "sms_messages",
              "usage_aggregation_method": "sum",
              "package_size": 1000,
              "amount": 500
            }
          ]
        }
      ]
    }
  ]
}
1009:["$","div","201-application/json-package_plan",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$102c"}}]}]],"$L102d"]}] 102e:T2401,
{
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "name": "Professional Platform Plan",
  "state": "active",
  "created_at": "2026-01-10T09:00:00.000000Z",
  "updated_at": "2026-01-10T09:00:00.000000Z",
  "variations": [
    {
      "id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
      "phases": [
        {
          "id": "c3d4e5f6-a7b8-9012-cdef-123456789012",
          "ordinal": 1,
          "cycle_duration": "P1M",
          "amount": 4900,
          "currency": "GBP",
          "subscription_items": [
            {
              "id": "d4e5f6a7-b8c9-0123-defa-234567890123",
              "type": "flat",
              "name": "Platform License",
              "unit": "subscription",
              "quantity": 1,
              "amount": 4900,
              "currency": "GBP"
            },
            {
              "id": "e5f6a7b8-c9d0-1234-efab-345678901234",
              "type": "usage",
              "name": "API Calls",
              "unit": "call",
              "code": "api_calls",
              "usage_aggregation_method": "sum",
              "amount": 1,
              "currency": "GBP"
            }
          ]
        }
      ]
    }
  ]
}
100a:["$","div","201-application/json-items_plan",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$102e"}}]}]],"$L102f"]}] 1030:T44d,
{
  "code": "string",
  "message": "string",
  "timestamp": 123
}
100b:["$","div","400-application/json-default",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$1030"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"code\": \"string\",\n \"message\": \"string\",\n \"timestamp\": 123\n}"}]}]]}] 1031:T44d,
{
  "code": "string",
  "message": "string",
  "timestamp": 123
}
100c:["$","div","401-application/json-default",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$1031"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"code\": \"string\",\n \"message\": \"string\",\n \"timestamp\": 123\n}"}]}]]}] 1032:T44d,
{
  "code": "string",
  "message": "string",
  "timestamp": 123
}
100d:["$","div","default-application/json-default",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$1032"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"code\": \"string\",\n \"message\": \"string\",\n \"timestamp\": 123\n}"}]}]]}] 1017:["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"name\": \"Enterprise Pro Plan\",\n \"variations\": [\n {\n \"phases\": [\n {\n \"ordinal\": 1,\n \"cycle_duration\": \"P1Y\",\n \"amount\": 99900,\n \"currency\": \"GBP\"\n }\n ]\n },\n {\n \"phases\": [\n {\n \"ordinal\": 1,\n \"cycle_duration\": \"P1M\",\n \"amount\": 9900,\n \"currency\": \"GBP\"\n }\n ]\n }\n ]\n}"}]}] 101b:["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"name\": \"API Usage Plan\",\n \"variations\": [\n {\n \"phases\": [\n {\n \"ordinal\": 1,\n \"cycle_duration\": \"P1M\",\n \"subscription_items\": [\n {\n \"name\": \"API Calls\",\n \"type\": \"usage\",\n \"currency\": \"GBP\",\n \"unit\": \"calls\",\n \"code\": \"api_calls\",\n \"usage_aggregation_method\": \"sum\",\n \"tiers\": [\n {\n \"upper_quantity_threshold\": 1000,\n \"amount\": 0\n },\n {\n \"upper_quantity_threshold\": 10000,\n \"amount\": 10\n },\n {\n \"amount\": 5\n }\n ]\n }\n ]\n }\n ]\n }\n ]\n}"}]}] 1033:T537,{ "name": "Professional Plan", "variations": [ { "phases": [ { "ordinal": 1, "cycle_duration": "P1M", "subscription_items": [ { "name": "Base Subscription", "type": "flat", "quantity": 1, "amount": 2900, "currency": "GBP", "unit": "subscription" }, { "name": "API Calls", "type": "usage", "currency": "GBP", "unit": "calls", "code": "api_calls", "usage_aggregation_method": "sum", "amount": 10 }, { "name": "Storage", "type": "usage", "currency": "GBP", "unit": "gb", "code": "storage_gb", "usage_aggregation_method": "max", "package_size": 1, "tiers": [ { "upper_quantity_threshold": 10, "amount": 0 }, { "upper_quantity_threshold": 100, "amount": 50 }, { "amount": 30 } ] } ] } ] } ] }101d:["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"$1033"}]}] 101f:["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"name\": \"SMS Plan\",\n \"variations\": [\n {\n \"phases\": [\n {\n \"ordinal\": 1,\n \"cycle_duration\": \"P1M\",\n \"subscription_items\": [\n {\n \"name\": \"SMS Messages\",\n \"type\": \"usage\",\n \"currency\": \"GBP\",\n \"unit\": \"messages\",\n \"code\": \"sms_messages\",\n \"usage_aggregation_method\": \"sum\",\n \"package_size\": 1000,\n \"amount\": 500\n }\n ]\n }\n ]\n }\n ]\n}"}]}] 1021:["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"name\": \"Professional Platform Plan\",\n \"variations\": [\n {\n \"phases\": [\n {\n \"ordinal\": 1,\n \"cycle_duration\": \"P1M\",\n \"amount\": 4900,\n \"currency\": \"GBP\",\n \"subscription_items\": [\n {\n \"type\": \"flat\",\n \"name\": \"Platform License\",\n \"unit\": \"subscription\",\n \"quantity\": 1,\n \"amount\": 4900,\n \"currency\": \"GBP\"\n },\n {\n \"type\": \"usage\",\n \"name\": \"API Calls\",\n \"unit\": \"call\",\n \"code\": \"api_calls\",\n \"usage_aggregation_method\": \"sum\",\n \"amount\": 1,\n \"currency\": \"GBP\"\n }\n ]\n }\n ]\n }\n ]\n}"}]}] 1023:["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"id\": \"f757b068-f287-43c8-8d05-9c073fecbe73\",\n \"name\": \"Enterprise Pro Plan\",\n \"state\": \"active\",\n \"created_at\": \"2026-01-26T08:59:09.433527Z\",\n \"updated_at\": \"2026-01-26T08:59:09.433527Z\",\n \"variations\": [\n {\n \"id\": \"f4e0a171-4f4e-484b-b0a2-22085059af65\",\n \"phases\": [\n {\n \"id\": \"23319d04-4b23-4ae7-ba54-82112c752683\",\n \"ordinal\": 1,\n \"cycle_duration\": \"P1M\",\n \"amount\": 990,\n \"currency\": \"GBP\"\n }\n ]\n },\n {\n \"id\": \"7cf47b0d-3da9-496b-a4e9-fbbe43c33ee3\",\n \"phases\": [\n {\n \"id\": \"feed2491-c895-4bfa-ba05-a3a088842d5c\",\n \"ordinal\": 1,\n \"cycle_duration\": \"P1Y\",\n \"amount\": 9990,\n \"currency\": \"GBP\"\n }\n ]\n }\n ]\n}"}]}] 1025:["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"id\": \"750e8400-e29b-41d4-a716-446655440010\",\n \"name\": \"Premium Plan with 14-day Trial\",\n \"trial_duration\": \"P14D\",\n \"state\": \"active\",\n \"created_at\": \"2025-06-04T21:00:00.036001Z\",\n \"updated_at\": \"2025-06-04T21:00:00.036001Z\",\n \"variations\": [\n {\n \"id\": \"850e8400-e29b-41d4-a716-446655440011\",\n \"phases\": [\n {\n \"id\": \"950e8400-e29b-41d4-a716-446655440012\",\n \"ordinal\": 1,\n \"cycle_duration\": \"P1M\",\n \"amount\": 9900,\n \"currency\": \"GBP\"\n }\n ]\n }\n ]\n}"}]}] 1027:["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"id\": \"550e8400-e29b-41d4-a716-446655440003\",\n \"name\": \"12-month Limited Plan\",\n \"state\": \"active\",\n \"created_at\": \"2025-06-05T21:00:00.036001Z\",\n \"updated_at\": \"2025-06-05T21:00:00.036001Z\",\n \"variations\": [\n {\n \"id\": \"550e8400-e29b-41d4-a716-446655440004\",\n \"phases\": [\n {\n \"id\": \"550e8400-e29b-41d4-a716-446655440005\",\n \"ordinal\": 1,\n \"cycle_duration\": \"P1M\",\n \"cycle_count\": 12,\n \"amount\": 1000,\n \"currency\": \"GBP\"\n }\n ]\n }\n ]\n}"}]}] 1034:T42e,{ "id": "8d2c8872-9e8a-4b1a-827c-3f78e1234abc", "name": "API Usage Plan", "state": "active", "created_at": "2026-04-15T17:58:36.000Z", "updated_at": "2026-04-15T17:58:36.000Z", "variations": [ { "id": "a4e0a171-4f4e-484b-b0a2-22085059df99", "phases": [ { "id": "ceed2491-c895-4bfa-ba05-a3a088842e11", "ordinal": 1, "cycle_duration": "P1M", "subscription_items": [ { "name": "API Calls", "type": "usage", "currency": "GBP", "unit": "calls", "code": "api_calls", "usage_aggregation_method": "sum", "tiers": [ { "upper_quantity_threshold": 1000, "amount": 0 }, { "upper_quantity_threshold": 10000, "amount": 10 }, { "amount": 5 } ] } ] } ] } ] }1029:["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"$1034"}]}] 1035:T640,{ "id": "b22198c4-724d-4e9e-b9e3-827c3f78e456", "name": "Professional Plan", "state": "active", "created_at": "2026-04-15T18:02:11.000Z", "updated_at": "2026-04-15T18:02:11.000Z", "variations": [ { "id": "d4e0a171-4f4e-484b-b0a2-22085059df77", "phases": [ { "id": "ffeed491-c895-4bfa-ba05-a3a088842e22", "ordinal": 1, "cycle_duration": "P1M", "subscription_items": [ { "name": "Base Subscription", "type": "flat", "quantity": 1, "amount": 2900, "currency": "GBP", "unit": "subscription" }, { "name": "API Calls", "type": "usage", "currency": "GBP", "unit": "calls", "code": "api_calls", "usage_aggregation_method": "sum", "amount": 10 }, { "name": "Storage", "type": "usage", "currency": "GBP", "unit": "gb", "code": "storage_gb", "usage_aggregation_method": "max", "package_size": 1, "tiers": [ { "upper_quantity_threshold": 10, "amount": 0 }, { "upper_quantity_threshold": 100, "amount": 50 }, { "amount": 30 } ] } ] } ] } ] }102b:["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"$1035"}]}] 102d:["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"id\": \"e33198c4-124d-4e9e-b9e3-827c3f78e789\",\n \"name\": \"SMS Plan\",\n \"state\": \"active\",\n \"created_at\": \"2026-04-15T18:05:42.000Z\",\n \"updated_at\": \"2026-04-15T18:05:42.000Z\",\n \"variations\": [\n {\n \"id\": \"c4e0a171-4f4e-484b-b0a2-22085059df44\",\n \"phases\": [\n {\n \"id\": \"ddeed491-c895-4bfa-ba05-a3a088842e33\",\n \"ordinal\": 1,\n \"cycle_duration\": \"P1M\",\n \"subscription_items\": [\n {\n \"name\": \"SMS Messages\",\n \"type\": \"usage\",\n \"currency\": \"GBP\",\n \"unit\": \"messages\",\n \"code\": \"sms_messages\",\n \"usage_aggregation_method\": \"sum\",\n \"package_size\": 1000,\n \"amount\": 500\n }\n ]\n }\n ]\n }\n ]\n}"}]}] 1036:T493,{ "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", "name": "Professional Platform Plan", "state": "active", "created_at": "2026-01-10T09:00:00.000000Z", "updated_at": "2026-01-10T09:00:00.000000Z", "variations": [ { "id": "b2c3d4e5-f6a7-8901-bcde-f12345678901", "phases": [ { "id": "c3d4e5f6-a7b8-9012-cdef-123456789012", "ordinal": 1, "cycle_duration": "P1M", "amount": 4900, "currency": "GBP", "subscription_items": [ { "id": "d4e5f6a7-b8c9-0123-defa-234567890123", "type": "flat", "name": "Platform License", "unit": "subscription", "quantity": 1, "amount": 4900, "currency": "GBP" }, { "id": "e5f6a7b8-c9d0-1234-efab-345678901234", "type": "usage", "name": "API Calls", "unit": "call", "code": "api_calls", "usage_aggregation_method": "sum", "amount": 1, "currency": "GBP" } ] } ] } ] }102f:["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"$1036"}]}] 100e:["$","div","CodeBlock-0",{"className":"wzy01m0 _18b50nc0","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"
'Authorization: Bearer <yourSecretApiKey>'
"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"'Authorization: Bearer '\n"}]}]]}] 1010:["$","div","CodeBlock-0",{"className":"wzy01m0 _18b50nc0","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"
'Authorization: Bearer <yourSecretApiKey>'
"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"'Authorization: Bearer '\n"}]}]]}] 105a:T9bc,A unique identifier for a payment method, always 44 characters long. This fingerprint can be used to uniquely identify various payment methods. #### Fingerprint generation | Payment method | Description | | -------- | ----------- | | **All payment methods** | A fingerprint is generated for all payment methods, including cards, Revolut Pay (card, account-to-account payments), Apple Pay, and Google Pay. | | **Cards (Revolut Pay & Card Gateway)** | For cards, the fingerprint is based on the PAN. Cards processed via Revolut Pay and our card gateway will share the same fingerprint. Renewed cards (new expiry/CVV) retain the same fingerprint for efficient blocking. | | **Apple Pay & Google Pay** | Since Apple Pay and Google Pay provide us Device PANs (DPAN), the fingerprint is based on the DPAN provided by Apple/Google, not the connected card's PAN. This means that a new DPAN (and fingerprint) is generated for cards in case they are re-added to the customer's digital wallet, or added to different devices. | #### Detecting duplicate payment methods Fingerprints are a valuable tool for detecting duplicate payment methods by identifying if a payment method has been seen before. This capability, in turn, helps in preventing various types of misuse (e.g., exploitation of free trials, or association with known problematic accounts, which can be a form of fraud). To effectively use fingerprints for this purpose, you will need to create and maintain your own lists (e.g., blocklists of known problematic fingerprints, allowlists for trusted customers, or tracking frequently used fingerprints). The ideal way to utilise fingerprints is by combining them with a manual capture process. While automatic capture with subsequent refunds for problematic payments is possible, manual capture based on fingerprint validation is recommended. During your manual capture workflow, after a payment was authorised: - Check the fingerprint status by comparing it against your maintained lists and internal business rules. - If you decide to proceed with the payment (e.g., the fingerprint is not on a blocklist, or matches a trusted customer's previous payment method): [Capture the order](https://developer.revolut.com/docs/api/merchant#capture-order). - If you decide not to proceed with the payment (e.g., the fingerprint matches a known fraudulent fingerprint, or exhibits suspicious patterns): [Cancel the order](https://developer.revolut.com/docs/api/merchant#cancel-order).106c:T9bc,A unique identifier for a payment method, always 44 characters long. This fingerprint can be used to uniquely identify various payment methods. #### Fingerprint generation | Payment method | Description | | -------- | ----------- | | **All payment methods** | A fingerprint is generated for all payment methods, including cards, Revolut Pay (card, account-to-account payments), Apple Pay, and Google Pay. | | **Cards (Revolut Pay & Card Gateway)** | For cards, the fingerprint is based on the PAN. Cards processed via Revolut Pay and our card gateway will share the same fingerprint. Renewed cards (new expiry/CVV) retain the same fingerprint for efficient blocking. | | **Apple Pay & Google Pay** | Since Apple Pay and Google Pay provide us Device PANs (DPAN), the fingerprint is based on the DPAN provided by Apple/Google, not the connected card's PAN. This means that a new DPAN (and fingerprint) is generated for cards in case they are re-added to the customer's digital wallet, or added to different devices. | #### Detecting duplicate payment methods Fingerprints are a valuable tool for detecting duplicate payment methods by identifying if a payment method has been seen before. This capability, in turn, helps in preventing various types of misuse (e.g., exploitation of free trials, or association with known problematic accounts, which can be a form of fraud). To effectively use fingerprints for this purpose, you will need to create and maintain your own lists (e.g., blocklists of known problematic fingerprints, allowlists for trusted customers, or tracking frequently used fingerprints). The ideal way to utilise fingerprints is by combining them with a manual capture process. While automatic capture with subsequent refunds for problematic payments is possible, manual capture based on fingerprint validation is recommended. During your manual capture workflow, after a payment was authorised: - Check the fingerprint status by comparing it against your maintained lists and internal business rules. - If you decide to proceed with the payment (e.g., the fingerprint is not on a blocklist, or matches a trusted customer's previous payment method): [Capture the order](https://developer.revolut.com/docs/api/merchant#capture-order). - If you decide not to proceed with the payment (e.g., the fingerprint matches a known fraudulent fingerprint, or exhibits suspicious patterns): [Cancel the order](https://developer.revolut.com/docs/api/merchant#cancel-order).107e:T9bc,A unique identifier for a payment method, always 44 characters long. This fingerprint can be used to uniquely identify various payment methods. #### Fingerprint generation | Payment method | Description | | -------- | ----------- | | **All payment methods** | A fingerprint is generated for all payment methods, including cards, Revolut Pay (card, account-to-account payments), Apple Pay, and Google Pay. | | **Cards (Revolut Pay & Card Gateway)** | For cards, the fingerprint is based on the PAN. Cards processed via Revolut Pay and our card gateway will share the same fingerprint. Renewed cards (new expiry/CVV) retain the same fingerprint for efficient blocking. | | **Apple Pay & Google Pay** | Since Apple Pay and Google Pay provide us Device PANs (DPAN), the fingerprint is based on the DPAN provided by Apple/Google, not the connected card's PAN. This means that a new DPAN (and fingerprint) is generated for cards in case they are re-added to the customer's digital wallet, or added to different devices. | #### Detecting duplicate payment methods Fingerprints are a valuable tool for detecting duplicate payment methods by identifying if a payment method has been seen before. This capability, in turn, helps in preventing various types of misuse (e.g., exploitation of free trials, or association with known problematic accounts, which can be a form of fraud). To effectively use fingerprints for this purpose, you will need to create and maintain your own lists (e.g., blocklists of known problematic fingerprints, allowlists for trusted customers, or tracking frequently used fingerprints). The ideal way to utilise fingerprints is by combining them with a manual capture process. While automatic capture with subsequent refunds for problematic payments is possible, manual capture based on fingerprint validation is recommended. During your manual capture workflow, after a payment was authorised: - Check the fingerprint status by comparing it against your maintained lists and internal business rules. - If you decide to proceed with the payment (e.g., the fingerprint is not on a blocklist, or matches a trusted customer's previous payment method): [Capture the order](https://developer.revolut.com/docs/api/merchant#capture-order). - If you decide not to proceed with the payment (e.g., the fingerprint matches a known fraudulent fingerprint, or exhibits suspicious patterns): [Cancel the order](https://developer.revolut.com/docs/api/merchant#cancel-order).1090:T9bc,A unique identifier for a payment method, always 44 characters long. This fingerprint can be used to uniquely identify various payment methods. #### Fingerprint generation | Payment method | Description | | -------- | ----------- | | **All payment methods** | A fingerprint is generated for all payment methods, including cards, Revolut Pay (card, account-to-account payments), Apple Pay, and Google Pay. | | **Cards (Revolut Pay & Card Gateway)** | For cards, the fingerprint is based on the PAN. Cards processed via Revolut Pay and our card gateway will share the same fingerprint. Renewed cards (new expiry/CVV) retain the same fingerprint for efficient blocking. | | **Apple Pay & Google Pay** | Since Apple Pay and Google Pay provide us Device PANs (DPAN), the fingerprint is based on the DPAN provided by Apple/Google, not the connected card's PAN. This means that a new DPAN (and fingerprint) is generated for cards in case they are re-added to the customer's digital wallet, or added to different devices. | #### Detecting duplicate payment methods Fingerprints are a valuable tool for detecting duplicate payment methods by identifying if a payment method has been seen before. This capability, in turn, helps in preventing various types of misuse (e.g., exploitation of free trials, or association with known problematic accounts, which can be a form of fraud). To effectively use fingerprints for this purpose, you will need to create and maintain your own lists (e.g., blocklists of known problematic fingerprints, allowlists for trusted customers, or tracking frequently used fingerprints). The ideal way to utilise fingerprints is by combining them with a manual capture process. While automatic capture with subsequent refunds for problematic payments is possible, manual capture based on fingerprint validation is recommended. During your manual capture workflow, after a payment was authorised: - Check the fingerprint status by comparing it against your maintained lists and internal business rules. - If you decide to proceed with the payment (e.g., the fingerprint is not on a blocklist, or matches a trusted customer's previous payment method): [Capture the order](https://developer.revolut.com/docs/api/merchant#capture-order). - If you decide not to proceed with the payment (e.g., the fingerprint matches a known fraudulent fingerprint, or exhibits suspicious patterns): [Cancel the order](https://developer.revolut.com/docs/api/merchant#cancel-order).1096:T9bc,A unique identifier for a payment method, always 44 characters long. This fingerprint can be used to uniquely identify various payment methods. #### Fingerprint generation | Payment method | Description | | -------- | ----------- | | **All payment methods** | A fingerprint is generated for all payment methods, including cards, Revolut Pay (card, account-to-account payments), Apple Pay, and Google Pay. | | **Cards (Revolut Pay & Card Gateway)** | For cards, the fingerprint is based on the PAN. Cards processed via Revolut Pay and our card gateway will share the same fingerprint. Renewed cards (new expiry/CVV) retain the same fingerprint for efficient blocking. | | **Apple Pay & Google Pay** | Since Apple Pay and Google Pay provide us Device PANs (DPAN), the fingerprint is based on the DPAN provided by Apple/Google, not the connected card's PAN. This means that a new DPAN (and fingerprint) is generated for cards in case they are re-added to the customer's digital wallet, or added to different devices. | #### Detecting duplicate payment methods Fingerprints are a valuable tool for detecting duplicate payment methods by identifying if a payment method has been seen before. This capability, in turn, helps in preventing various types of misuse (e.g., exploitation of free trials, or association with known problematic accounts, which can be a form of fraud). To effectively use fingerprints for this purpose, you will need to create and maintain your own lists (e.g., blocklists of known problematic fingerprints, allowlists for trusted customers, or tracking frequently used fingerprints). The ideal way to utilise fingerprints is by combining them with a manual capture process. While automatic capture with subsequent refunds for problematic payments is possible, manual capture based on fingerprint validation is recommended. During your manual capture workflow, after a payment was authorised: - Check the fingerprint status by comparing it against your maintained lists and internal business rules. - If you decide to proceed with the payment (e.g., the fingerprint is not on a blocklist, or matches a trusted customer's previous payment method): [Capture the order](https://developer.revolut.com/docs/api/merchant#capture-order). - If you decide not to proceed with the payment (e.g., the fingerprint matches a known fraudulent fingerprint, or exhibits suspicious patterns): [Cancel the order](https://developer.revolut.com/docs/api/merchant#cancel-order).2d:["$","$7a","retrieve-payment-details",{"children":[["$","section",null,{"className":"y9a0do0","data-variant":"endpoint","children":["$","$L7b",null,{"responses":{"200":{"description":"Payment details","content":{"application/json":{"schema":{"type":"object","description":"Represents a payment for an order.\n\nFor pre-authorised payments, the `authorised_amount` field tracks the currently authorised amount, which may differ from `amount` during incremental authorisation processing.","properties":{"order_id":{"type":"string","format":"uuid","description":"The ID of the associated order.","descriptionNode":"$L1037"},"id":{"type":"string","format":"uuid","description":"The ID of the payment.","descriptionNode":"$L1038"},"state":{"type":"string","description":"The status of the payment.","enum":"$21:props:children:0:props:children:props:responses:200:content:application/json:schema:items:properties:state:enum","descriptionNode":"$L1039"},"decline_reason":{"type":"string","description":"The reason for a `failed` or `declined` payment.\n\nA failed or declined payment can result from multiple reasons. To learn more, check our [failure reasons](https://developer.revolut.com/docs/guides/merchant/reference/error-codes/decline-reasons).","enum":"$21:props:children:0:props:children:props:responses:200:content:application/json:schema:items:properties:decline_reason:enum","descriptionNode":"$L103a"},"bank_message":{"type":"string","description":"The reason for a `failed` or `declined` payment, sent by the financial institution processing the payment.","descriptionNode":"$L103b"},"created_at":{"type":"string","format":"date-time","description":"The date and time the payment was created.","descriptionNode":"$L103c"},"updated_at":{"type":"string","format":"date-time","description":"The date and time the payment was last updated.","descriptionNode":"$L103d"},"token":{"type":"string","format":"uuid","description":"Temporary token of the payment used to fetch the reward offer during checkout and link user registrations to the given offers. \n\nThe token is only valid for a limited time.","descriptionNode":"$L103e"},"amount":{"type":"integer","format":"int64","minimum":0,"description":"The payment amount in minor units (e.g., cents). The value of this field depends on the payment type and state.\n\n| Payment type | State | Amount value |\n|--------------|-------|--------------|\n| Standard payment | Any | Total payment amount |\n| Pre-authorised payment | `authorisation_started` | New amount being authorised (during increment processing) |\n| Pre-authorised payment | `authorised` | Currently authorised amount (equals `authorised_amount`) |\n\n:::info\nFor pre-authorised payments, see the `authorised_amount` field for tracking the currently authorised amount separately.\n:::","examples":"$21:props:children:0:props:children:props:responses:200:content:application/json:schema:items:properties:amount:examples","descriptionNode":"$L103f"},"authorised_amount":{"type":"integer","description":"The currently authorised amount for this payment (in minor units).\n\nFor pre-authorised payments with incremental authorization:\n- Initially equals the `amount` field\n- Remains unchanged during increment processing\n- Updates to new amount upon successful increment\n- Remains at original amount if increment is declined\n\nFor standard payments, this field may not be present or will equal the `amount` field.","examples":[600],"descriptionNode":"$L1040"},"currency":{"type":"string","format":"ISO 4217","minLength":3,"maxLength":3,"description":"[ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) currency code in upper case.\n\n:::info\nFor more information about the supported currencies, see: [Help Center](https://help.revolut.com/business/help/merchant-accounts/payments/in-which-currencies-can-i-accept-payments/).\n:::","descriptionNode":"$L1041"},"settled_amount":{"type":"integer","description":"The amount of the settled payment (minor currency unit). For example, `7034` stands for €70.34.","descriptionNode":"$L1042"},"settled_currency":{"type":"string","description":"The currency of the settled payment. [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) currency code in upper case.\n\n:::info\nFor more information about the supported currencies, see: [Help Center](https://help.revolut.com/business/help/merchant-accounts/payments/in-which-currencies-can-i-accept-payments/).\n:::","descriptionNode":"$L1043"},"payment_method":{"type":"object","description":"The details of the payment method used to make the payment.","discriminator":{"propertyName":"type","mapping":{"apple_pay":"#/components/schemas/Apple-Pay","card":"#/components/schemas/Card","google_pay":"#/components/schemas/Google-Pay","revolut_pay_card":"#/components/schemas/Revolut-Pay-Card","revolut_pay_account":"#/components/schemas/Revolut-Pay-Account","sepa_direct_debit":"#/components/schemas/Sepa-Direct-Debit"}},"oneOf":[{"type":"object","description":"Object containing details of a card used via Apple Pay.","properties":{"id":{"type":"string","format":"uuid","description":"ID of the saved payment method.\n\n:::note\nThe `id` parameter is only returned when the payment method is saved.\n:::","descriptionNode":"$L1044"},"type":{"type":"string","enum":"$21:props:children:0:props:children:props:responses:200:content:application/json:schema:items:properties:payment_method:oneOf:2:properties:type:enum","description":"The type of payment method used to pay for the order.\n\nAvailable values:\n\n| Payment method `type` | Description |\n| --------------------- | ----------- |\n| `apple_pay` | The customer paid the order using Apple Pay. |\n| `card` | The customer paid the order using their credit or debit card. |\n| `google_pay` | The customer paid the order using Google Pay. |\n| `revolut_pay_card` | The customer paid the order via Revolut Pay using their credit or debit card. |\n| `revolut_pay_account` | The customer paid the order via Revolut Pay using their Revolut account. |\n| `sepa_direct_debit` | The customer paid the order using SEPA Direct Debit. |","descriptionNode":"$L1045"},"card_brand":{"type":"string","description":"The type of the card.","enum":["visa","mastercard","american_express"],"descriptionNode":"$L1046"},"funding":{"type":"string","description":"The type of card funding.","enum":["credit","debit","prepaid"],"descriptionNode":"$L1047"},"card_country_code":{"type":"string","description":"The 2-letter country code of the country where the card was issued.","descriptionNode":"$L1048"},"card_bin":{"type":"string","description":"The BIN of the card.","minLength":6,"maxLength":6,"descriptionNode":"$L1049"},"card_last_four":{"type":"string","description":"The last four digits of the card number.","minLength":4,"maxLength":4,"descriptionNode":"$L104a"},"card_expiry":{"type":"string","format":"MM/YY","description":"The expiry date of the card in the format of MM/YY.","descriptionNode":"$L104b"},"cardholder_name":{"type":"string","description":"The name of the cardholder.","descriptionNode":"$L104c"},"checks":{"type":"object","description":"The details of the check for card payment. Only for orders with successful payments.","properties":{"three_ds":{"type":"object","description":"The details of the 3D Secure check. Only for orders with successful payments.\n\n:::note\nNot returned for Apple Pay and Google Pay payments.\n:::","properties":{"eci":{"type":"string","description":"The Electronic Commerce Indicator (ECI) value corresponds to the authentication result and indicates the level of security used when the payment information was provided.","descriptionNode":"$L104d"},"state":{"type":"string","description":"The result of 3D Secure check.","enum":["verified","failed","challenge"],"descriptionNode":"$L104e"},"version":{"type":"integer","description":"The 3D Secure version.","descriptionNode":"$L104f"}},"descriptionNode":"$L1050"},"cvv_verification":{"type":"string","description":"The result of CVV verification.\n\n| Parameter value | Description |\n| ----- | ----------- |\n| `match` | CVV matches the card's CVV |\n| `not_match` | CVV does not match the card's CVV |\n| `incorrect` | CVV format is incorrect for this type of card |\n| `not_processed` | CVV verification was not performed |","enum":["match","not_match","incorrect","not_processed"],"descriptionNode":"$L1051"},"address":{"type":"string","description":"The result of address verification.","enum":["match","not_match","n_a","invalid"],"descriptionNode":"$L1052"},"postcode":{"type":"string","description":"The result of postcode verification.","enum":["match","not_match","n_a","invalid"],"descriptionNode":"$L1053"},"cardholder":{"type":"string","description":"The result of cardholder verification.","enum":["match","not_match","n_a","invalid"],"descriptionNode":"$L1054"}},"descriptionNode":"$L1055"},"authorisation_code":{"type":"string","description":"The authorisation code (or auth code) is a short, alphanumeric code returned by the cardholder's issuing bank to the merchant's terminal or payment gateway.\n\nIt serves as confirmation that the transaction has been approved and funds are available.","pattern":"^[a-zA-Z0-9]{2,6}$","minLength":2,"maxLength":6,"examples":["T483XF"],"descriptionNode":"$L1056"},"arn":{"type":"string","description":"Acquirer Reference Number (ARN) of the payment.\n\n:::note\nOnly returned for refund payments made by a card.\n:::","minLength":23,"maxLength":23,"examples":["74839572049583726403928"],"descriptionNode":"$L1057"},"capture_deadline":{"type":"string","format":"date-time","description":"The date and time by which the payment must be captured.\n\nAfter this deadline, the authorised funds may be automatically released by the card issuer.","descriptionNode":"$L1058"},"terminal_hardware_id":{"type":"string","description":"The hardware identifier of the Revolut Terminal device used to process the payment.\n\n:::note\nOnly present for card-present transactions processed via Revolut Terminal.\n:::","descriptionNode":"$L1059"},"fingerprint":{"type":"string","minLength":44,"maxLength":44,"description":"$105a","examples":["1JAllfQY4POhBV8DaddAQ4LC5RbMP8LMLvUdJW4s5JY="],"descriptionNode":"$L105b"},"network_transaction_id":{"type":"string","description":"The Network Transaction ID (NTI) is a unique identifier assigned by the card scheme (e.g., Visa or Mastercard) to a card transaction.\n\nIt can be used to trace the transaction across the payment network, link recurring or instalment payments to the original authorisation, and support dispute resolution.","descriptionNode":"$L105c"}},"required":["type"],"descriptionNode":"$L105d"},{"type":"object","description":"Object containing details of the card used for the payment.","properties":{"id":{"type":"string","format":"uuid","description":"ID of the saved payment method.\n\n:::note\nThe `id` parameter is only returned when the payment method is saved.\n:::","descriptionNode":"$L105e"},"type":{"type":"string","enum":"$21:props:children:0:props:children:props:responses:200:content:application/json:schema:items:properties:payment_method:oneOf:2:properties:type:enum","description":"The type of payment method used to pay for the order.\n\nAvailable values:\n\n| Payment method `type` | Description |\n| --------------------- | ----------- |\n| `apple_pay` | The customer paid the order using Apple Pay. |\n| `card` | The customer paid the order using their credit or debit card. |\n| `google_pay` | The customer paid the order using Google Pay. |\n| `revolut_pay_card` | The customer paid the order via Revolut Pay using their credit or debit card. |\n| `revolut_pay_account` | The customer paid the order via Revolut Pay using their Revolut account. |\n| `sepa_direct_debit` | The customer paid the order using SEPA Direct Debit. |","descriptionNode":"$L105f"},"card_brand":{"type":"string","description":"The type of the card.","enum":["visa","mastercard","american_express"],"descriptionNode":"$L1060"},"funding":{"type":"string","description":"The type of card funding.","enum":["credit","debit","prepaid"],"descriptionNode":"$L1061"},"card_country_code":{"type":"string","description":"The 2-letter country code of the country where the card was issued.","descriptionNode":"$L1062"},"card_bin":{"type":"string","description":"The BIN of the card.","minLength":6,"maxLength":6,"descriptionNode":"$L1063"},"card_last_four":{"type":"string","description":"The last four digits of the card number.","minLength":4,"maxLength":4,"descriptionNode":"$L1064"},"card_expiry":{"type":"string","format":"MM/YY","description":"The expiry date of the card in the format of MM/YY.","descriptionNode":"$L1065"},"cardholder_name":{"type":"string","description":"The name of the cardholder.","descriptionNode":"$L1066"},"checks":{"type":"object","description":"The details of the check for card payment. Only for orders with successful payments.","properties":{"three_ds":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:0:properties:checks:properties:three_ds","cvv_verification":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:0:properties:checks:properties:cvv_verification","address":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:0:properties:checks:properties:address","postcode":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:0:properties:checks:properties:postcode","cardholder":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:0:properties:checks:properties:cardholder"},"descriptionNode":"$L1067"},"authorisation_code":{"type":"string","description":"The authorisation code (or auth code) is a short, alphanumeric code returned by the cardholder's issuing bank to the merchant's terminal or payment gateway.\n\nIt serves as confirmation that the transaction has been approved and funds are available.","pattern":"^[a-zA-Z0-9]{2,6}$","minLength":2,"maxLength":6,"examples":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:0:properties:authorisation_code:examples","descriptionNode":"$L1068"},"arn":{"type":"string","description":"Acquirer Reference Number (ARN) of the payment.\n\n:::note\nOnly returned for refund payments made by a card.\n:::","minLength":23,"maxLength":23,"examples":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:0:properties:arn:examples","descriptionNode":"$L1069"},"capture_deadline":{"type":"string","format":"date-time","description":"The date and time by which the payment must be captured.\n\nAfter this deadline, the authorised funds may be automatically released by the card issuer.","descriptionNode":"$L106a"},"terminal_hardware_id":{"type":"string","description":"The hardware identifier of the Revolut Terminal device used to process the payment.\n\n:::note\nOnly present for card-present transactions processed via Revolut Terminal.\n:::","descriptionNode":"$L106b"},"fingerprint":{"type":"string","minLength":44,"maxLength":44,"description":"$106c","examples":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:0:properties:fingerprint:examples","descriptionNode":"$L106d"},"network_transaction_id":{"type":"string","description":"The Network Transaction ID (NTI) is a unique identifier assigned by the card scheme (e.g., Visa or Mastercard) to a card transaction.\n\nIt can be used to trace the transaction across the payment network, link recurring or instalment payments to the original authorisation, and support dispute resolution.","descriptionNode":"$L106e"}},"required":["type"],"descriptionNode":"$L106f"},{"type":"object","description":"Object containing details of a card used via Google Pay.","properties":{"id":{"type":"string","format":"uuid","description":"ID of the saved payment method.\n\n:::note\nThe `id` parameter is only returned when the payment method is saved.\n:::","descriptionNode":"$L1070"},"type":{"type":"string","enum":"$21:props:children:0:props:children:props:responses:200:content:application/json:schema:items:properties:payment_method:oneOf:2:properties:type:enum","description":"The type of payment method used to pay for the order.\n\nAvailable values:\n\n| Payment method `type` | Description |\n| --------------------- | ----------- |\n| `apple_pay` | The customer paid the order using Apple Pay. |\n| `card` | The customer paid the order using their credit or debit card. |\n| `google_pay` | The customer paid the order using Google Pay. |\n| `revolut_pay_card` | The customer paid the order via Revolut Pay using their credit or debit card. |\n| `revolut_pay_account` | The customer paid the order via Revolut Pay using their Revolut account. |\n| `sepa_direct_debit` | The customer paid the order using SEPA Direct Debit. |","descriptionNode":"$L1071"},"card_brand":{"type":"string","description":"The type of the card.","enum":["visa","mastercard","american_express"],"descriptionNode":"$L1072"},"funding":{"type":"string","description":"The type of card funding.","enum":["credit","debit","prepaid"],"descriptionNode":"$L1073"},"card_country_code":{"type":"string","description":"The 2-letter country code of the country where the card was issued.","descriptionNode":"$L1074"},"card_bin":{"type":"string","description":"The BIN of the card.","minLength":6,"maxLength":6,"descriptionNode":"$L1075"},"card_last_four":{"type":"string","description":"The last four digits of the card number.","minLength":4,"maxLength":4,"descriptionNode":"$L1076"},"card_expiry":{"type":"string","format":"MM/YY","description":"The expiry date of the card in the format of MM/YY.","descriptionNode":"$L1077"},"cardholder_name":{"type":"string","description":"The name of the cardholder.","descriptionNode":"$L1078"},"checks":{"type":"object","description":"The details of the check for card payment. Only for orders with successful payments.","properties":{"three_ds":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:0:properties:checks:properties:three_ds","cvv_verification":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:0:properties:checks:properties:cvv_verification","address":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:0:properties:checks:properties:address","postcode":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:0:properties:checks:properties:postcode","cardholder":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:0:properties:checks:properties:cardholder"},"descriptionNode":"$L1079"},"authorisation_code":{"type":"string","description":"The authorisation code (or auth code) is a short, alphanumeric code returned by the cardholder's issuing bank to the merchant's terminal or payment gateway.\n\nIt serves as confirmation that the transaction has been approved and funds are available.","pattern":"^[a-zA-Z0-9]{2,6}$","minLength":2,"maxLength":6,"examples":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:0:properties:authorisation_code:examples","descriptionNode":"$L107a"},"arn":{"type":"string","description":"Acquirer Reference Number (ARN) of the payment.\n\n:::note\nOnly returned for refund payments made by a card.\n:::","minLength":23,"maxLength":23,"examples":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:0:properties:arn:examples","descriptionNode":"$L107b"},"capture_deadline":{"type":"string","format":"date-time","description":"The date and time by which the payment must be captured.\n\nAfter this deadline, the authorised funds may be automatically released by the card issuer.","descriptionNode":"$L107c"},"terminal_hardware_id":{"type":"string","description":"The hardware identifier of the Revolut Terminal device used to process the payment.\n\n:::note\nOnly present for card-present transactions processed via Revolut Terminal.\n:::","descriptionNode":"$L107d"},"fingerprint":{"type":"string","minLength":44,"maxLength":44,"description":"$107e","examples":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:0:properties:fingerprint:examples","descriptionNode":"$L107f"},"network_transaction_id":{"type":"string","description":"The Network Transaction ID (NTI) is a unique identifier assigned by the card scheme (e.g., Visa or Mastercard) to a card transaction.\n\nIt can be used to trace the transaction across the payment network, link recurring or instalment payments to the original authorisation, and support dispute resolution.","descriptionNode":"$L1080"}},"required":["type"],"descriptionNode":"$L1081"},{"type":"object","description":"Object containing details of a card used via Revolut Pay.","properties":{"id":{"type":"string","format":"uuid","description":"ID of the saved payment method.\n\n:::note\nThe `id` parameter is only returned when the payment method is saved.\n:::","descriptionNode":"$L1082"},"type":{"type":"string","enum":"$21:props:children:0:props:children:props:responses:200:content:application/json:schema:items:properties:payment_method:oneOf:2:properties:type:enum","description":"The type of payment method used to pay for the order.\n\nAvailable values:\n\n| Payment method `type` | Description |\n| --------------------- | ----------- |\n| `apple_pay` | The customer paid the order using Apple Pay. |\n| `card` | The customer paid the order using their credit or debit card. |\n| `google_pay` | The customer paid the order using Google Pay. |\n| `revolut_pay_card` | The customer paid the order via Revolut Pay using their credit or debit card. |\n| `revolut_pay_account` | The customer paid the order via Revolut Pay using their Revolut account. |\n| `sepa_direct_debit` | The customer paid the order using SEPA Direct Debit. |","descriptionNode":"$L1083"},"card_brand":{"type":"string","description":"The type of the card.","enum":["visa","mastercard","american_express"],"descriptionNode":"$L1084"},"funding":{"type":"string","description":"The type of card funding.","enum":["credit","debit","prepaid"],"descriptionNode":"$L1085"},"card_country_code":{"type":"string","description":"The 2-letter country code of the country where the card was issued.","descriptionNode":"$L1086"},"card_bin":{"type":"string","description":"The BIN of the card.","minLength":6,"maxLength":6,"descriptionNode":"$L1087"},"card_last_four":{"type":"string","description":"The last four digits of the card number.","minLength":4,"maxLength":4,"descriptionNode":"$L1088"},"card_expiry":{"type":"string","format":"MM/YY","description":"The expiry date of the card in the format of MM/YY.","descriptionNode":"$L1089"},"cardholder_name":{"type":"string","description":"The name of the cardholder.","descriptionNode":"$L108a"},"checks":{"type":"object","description":"The details of the check for card payment. Only for orders with successful payments.","properties":{"three_ds":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:0:properties:checks:properties:three_ds","cvv_verification":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:0:properties:checks:properties:cvv_verification","address":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:0:properties:checks:properties:address","postcode":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:0:properties:checks:properties:postcode","cardholder":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:0:properties:checks:properties:cardholder"},"descriptionNode":"$L108b"},"authorisation_code":{"type":"string","description":"The authorisation code (or auth code) is a short, alphanumeric code returned by the cardholder's issuing bank to the merchant's terminal or payment gateway.\n\nIt serves as confirmation that the transaction has been approved and funds are available.","pattern":"^[a-zA-Z0-9]{2,6}$","minLength":2,"maxLength":6,"examples":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:0:properties:authorisation_code:examples","descriptionNode":"$L108c"},"arn":{"type":"string","description":"Acquirer Reference Number (ARN) of the payment.\n\n:::note\nOnly returned for refund payments made by a card.\n:::","minLength":23,"maxLength":23,"examples":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:0:properties:arn:examples","descriptionNode":"$L108d"},"capture_deadline":{"type":"string","format":"date-time","description":"The date and time by which the payment must be captured.\n\nAfter this deadline, the authorised funds may be automatically released by the card issuer.","descriptionNode":"$L108e"},"terminal_hardware_id":{"type":"string","description":"The hardware identifier of the Revolut Terminal device used to process the payment.\n\n:::note\nOnly present for card-present transactions processed via Revolut Terminal.\n:::","descriptionNode":"$L108f"},"fingerprint":{"type":"string","minLength":44,"maxLength":44,"description":"$1090","examples":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:0:properties:fingerprint:examples","descriptionNode":"$L1091"},"network_transaction_id":{"type":"string","description":"The Network Transaction ID (NTI) is a unique identifier assigned by the card scheme (e.g., Visa or Mastercard) to a card transaction.\n\nIt can be used to trace the transaction across the payment network, link recurring or instalment payments to the original authorisation, and support dispute resolution.","descriptionNode":"$L1092"}},"required":["type"],"descriptionNode":"$L1093"},{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"ID of the saved payment method.\n\n:::note\nThe `id` parameter is only returned when the payment method is saved.\n:::","descriptionNode":"$L1094"},"type":{"type":"string","enum":"$21:props:children:0:props:children:props:responses:200:content:application/json:schema:items:properties:payment_method:oneOf:2:properties:type:enum","description":"The type of payment method used to pay for the order.\n\nAvailable values:\n\n| Payment method `type` | Description |\n| --------------------- | ----------- |\n| `apple_pay` | The customer paid the order using Apple Pay. |\n| `card` | The customer paid the order using their credit or debit card. |\n| `google_pay` | The customer paid the order using Google Pay. |\n| `revolut_pay_card` | The customer paid the order via Revolut Pay using their credit or debit card. |\n| `revolut_pay_account` | The customer paid the order via Revolut Pay using their Revolut account. |\n| `sepa_direct_debit` | The customer paid the order using SEPA Direct Debit. |","descriptionNode":"$L1095"},"fingerprint":{"type":"string","minLength":44,"maxLength":44,"description":"$1096","examples":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:0:properties:fingerprint:examples","descriptionNode":"$L1097"}},"required":["type"]},{"type":"object","description":"Object containing details of a SEPA Direct Debit payment.\n\n:::info\nFor more information, see: [SEPA Direct Debit server-to-server integration](https://developer.revolut.com/docs/guides/merchant/accept-payments/payment-methods/sepa-direct-debit/server-to-server)\n:::","properties":{"id":{"type":"string","format":"uuid","description":"ID of the saved payment method.\n\n:::note\nThe `id` parameter is only returned when the payment method is saved for the merchant.\n:::","descriptionNode":"$L1098"},"type":{"type":"string","enum":"$21:props:children:0:props:children:props:responses:200:content:application/json:schema:items:properties:payment_method:oneOf:2:properties:type:enum","description":"The type of payment method used to pay for the order.\n\nAvailable values:\n\n| Payment method `type` | Description |\n| --------------------- | ----------- |\n| `apple_pay` | The customer paid the order using Apple Pay. |\n| `card` | The customer paid the order using their credit or debit card. |\n| `google_pay` | The customer paid the order using Google Pay. |\n| `revolut_pay_card` | The customer paid the order via Revolut Pay using their credit or debit card. |\n| `revolut_pay_account` | The customer paid the order via Revolut Pay using their Revolut account. |\n| `sepa_direct_debit` | The customer paid the order using SEPA Direct Debit. |","descriptionNode":"$L1099"},"debtor_iban_last_four":{"type":"string","description":"The last four digits of the debtor's IBAN.","minLength":4,"maxLength":4,"descriptionNode":"$L109a"},"debtor_name":{"type":"string","description":"The full name of the debtor as provided in the mandate.","descriptionNode":"$L109b"},"mandate_reference":{"type":"string","description":"The unique mandate reference generated by Revolut. Include this in pre-debit notifications sent to your customers.","descriptionNode":"$L109c"}},"required":"$21:props:children:0:props:children:props:responses:200:content:application/json:schema:items:properties:payment_method:oneOf:2:required","descriptionNode":"$L109d"}],"descriptionNode":"$L109e"},"authentication_challenge":{"type":"object","description":"Details about the authentication challenge that should be performed to complete the authentication process. For more information about Revolut's 3DS solution, see: [3D Secure overview](https://developer.revolut.com/docs/guides/merchant/reference/3d-secure).\n\nOnly returned if the payment's state is `authentication_challenge`.","discriminator":"$21:props:children:0:props:children:props:responses:200:content:application/json:schema:items:properties:authentication_challenge:discriminator","oneOf":[{"title":"three_ds","type":"object","description":"Information about the 3DS challenge.","properties":{"type":{"type":"string","enum":"$21:props:children:0:props:children:props:responses:200:content:application/json:schema:items:properties:authentication_challenge:oneOf:0:properties:type:enum","description":"Type of the authentication challenge the payment triggers.","descriptionNode":"$L109f"},"acs_url":{"type":"string","format":"url","description":"The URL of the authentication challenge.","descriptionNode":"$L10a0"}},"required":"$21:props:children:0:props:children:props:responses:200:content:application/json:schema:items:properties:authentication_challenge:oneOf:0:required","descriptionNode":"$L10a1"},{"title":"three_ds_fingerprint","type":"object","description":"Information about the 3DS fingerprint challenge.","properties":{"type":{"type":"string","enum":"$21:props:children:0:props:children:props:responses:200:content:application/json:schema:items:properties:authentication_challenge:oneOf:0:properties:type:enum","description":"Type of the authentication challenge the payment triggers.","descriptionNode":"$L10a2"},"fingerprint_url":{"type":"string","format":"url","description":"The URL of the fingerprint. (Used only internally by Revolut.)","descriptionNode":"$L10a3"},"fingerprint_data":{"type":"string","format":"JSON","description":"Data about the fingerprint used for authentication. (Used only internally\nby Revolut.)","descriptionNode":"$L10a4"}},"required":"$21:props:children:0:props:children:props:responses:200:content:application/json:schema:items:properties:authentication_challenge:oneOf:1:required","descriptionNode":"$L10a5"}],"descriptionNode":"$L10a6"},"billing_address":{"type":"object","description":"Object containing address details.","properties":{"street_line_1":{"type":"string","description":"Street line 1 information.","maxLength":100,"descriptionNode":"$L10a7"},"street_line_2":{"type":"string","description":"Street line 2 information.","maxLength":100,"descriptionNode":"$L10a8"},"region":{"type":"string","description":"The region associated with the address.","maxLength":100,"descriptionNode":"$L10a9"},"city":{"type":"string","description":"The city associated with the address.","maxLength":100,"descriptionNode":"$L10aa"},"country_code":{"type":"string","description":"The 2-letter country code of the country associated with the address.","maxLength":2,"descriptionNode":"$L10ab"},"postcode":{"type":"string","description":"The postcode associated with the address.","maxLength":100,"descriptionNode":"$L10ac"}},"required":["country_code","postcode"],"descriptionNode":"$L10ad"},"risk_level":{"type":"string","description":"The risk level of the card.\n\nIf the risk level is `high`, the payment might be declined.","enum":["low","high"],"descriptionNode":"$L10ae"},"fees":{"type":"array","description":"The details of the order fee.","items":{"type":"object","properties":{"type":{"type":"string","description":"The type of the order fee.","enum":["fx","acquiring"],"descriptionNode":"$L10af"},"amount":{"type":"integer","description":"The amount of the payment fee (minor currency unit). For example, enter `7034` for €70.34 in the field.","descriptionNode":"$L10b0"},"currency":{"type":"string","description":"The currency of the payment fee. [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) currency code in upper case.\n\n:::info\nFor more information about the supported currencies, see: [Help Center](https://help.revolut.com/business/help/merchant-accounts/payments/in-which-currencies-can-i-accept-payments/).\n:::","descriptionNode":"$L10b1"}}},"descriptionNode":"$L10b2"},"payer":{"title":"Payer","type":"object","description":"The person who made the payment. This object is present when an email or phone number is provided during the payment flow.\n\nCapturing payer details lets you identify exactly who authorised the charge, reach the right person for receipts or refund queries, and support compliance or fraud-review workflows where the paying identity matters.","properties":{"email":{"description":"The email of the person who made the payment.","type":"string","format":"email","descriptionNode":"$L10b3"},"phone":{"description":"The phone number of the payer in [E.164 format](https://en.wikipedia.org/wiki/E.164).","type":"string","descriptionNode":"$L10b4"}},"descriptionNode":"$L10b5"}},"required":["id","state","created_at","updated_at","amount"],"descriptionNode":"$L10b6"},"examples":{"revolut_pay_saved":{"summary":"Payment completed via Revolut Pay (card, saved details)","value":{"id":"6633855a-0e4f-a768-8b2c-e765d8872505","state":"captured","created_at":"2024-05-02T12:21:46.638369Z","updated_at":"2024-05-02T12:21:55.198089Z","token":"0b277730-8b3c-48d4-ab63-8903f40ee520","amount":100,"currency":"GBP","settled_amount":77,"settled_currency":"GBP","risk_level":"low","fees":[{"type":"acquiring","amount":23,"currency":"GBP"}],"payment_method":{"id":"6633855a-3b39-ad95-9782-cd1327ffa0e7","type":"revolut_pay_card","fingerprint":"1JAllfQY4POhBV8DaddAQ4LC5RbMP8LMLvUdJW4s5JY=","card_brand":"visa","funding":"credit","card_country_code":"MT","card_bin":"123456","card_last_four":"1234","card_expiry":"12/28","cardholder_name":"Example Holder","checks":{"three_ds":{"eci":"06","state":"verified","version":2}}},"order_id":"66338534-28a7-a68e-b312-43722430df1b"}},"revolut_pay_not_saved":{"summary":"Payment completed via Revolut Pay (account, not saved details)","value":{"id":"66338688-fd73-a358-a82d-97da413c5325","state":"captured","created_at":"2024-05-02T12:26:48.134039Z","updated_at":"2024-05-02T12:26:49.514594Z","token":"8061e645-35e0-42bb-8318-603abaeab7b7","amount":100,"currency":"GBP","settled_amount":79,"settled_currency":"GBP","billing_address":{"street_line_1":"123 Example Street","street_line_2":"Building A, 3rd Floor","city":"Example City","region":"Example Region","country_code":"GB","postcode":"E14 4HD"},"risk_level":"low","fees":[{"type":"acquiring","amount":21,"currency":"GBP"}],"payment_method":{"type":"revolut_pay_account","fingerprint":"1JAllfQY4POhBV8DaddAQ4LC5RbMP8LMLvUdJW4s5JY="},"order_id":"6633865d-d911-a98c-8715-425f8731640c"}},"apple_tap_to_pay":{"summary":"Payment declined via Apple Tap to Pay","value":{"id":"66338688-fd73-a358-a82d-97da413c5325","state":"declined","created_at":"2024-05-02T12:26:48.134039Z","updated_at":"2024-05-02T12:26:49.514594Z","token":"8061e645-35e0-42bb-8318-603abaeab7b7","amount":100,"currency":"GBP","settled_amount":79,"settled_currency":"GBP","billing_address":{"street_line_1":"123 Example Street","street_line_2":"Building A, 3rd Floor","city":"Example City","region":"Example Region","country_code":"GB","postcode":"E14 4HD"},"risk_level":"low","fees":[{"type":"acquiring","amount":21,"currency":"GBP"}],"payment_method":{"type":"apple_tap_to_pay","failure_reason":"pin_data_required"},"order_id":"6633865d-d911-a98c-8715-425f8731640c"}},"apple_pay":{"summary":"Payment completed via Apple Pay","value":{"id":"66338688-fd73-a358-a82d-97da413c5325","state":"captured","created_at":"2024-05-02T12:26:48.134039Z","updated_at":"2024-05-02T12:26:49.514594Z","token":"8061e645-35e0-42bb-8318-603abaeab7b7","amount":100,"currency":"GBP","settled_amount":79,"settled_currency":"GBP","billing_address":{"street_line_1":"123 Example Street","street_line_2":"Building A, 3rd Floor","city":"Example City","region":"Example Region","country_code":"GB","postcode":"E14 4HD"},"risk_level":"low","fees":[{"type":"acquiring","amount":21,"currency":"GBP"}],"payment_method":{"type":"apple_pay","fingerprint":"1JAllfQY4POhBV8DaddAQ4LC5RbMP8LMLvUdJW4s5JY="},"order_id":"6633865d-d911-a98c-8715-425f8731640c"}},"google_pay":{"summary":"Payment completed via Google Pay","value":{"id":"66338688-fd73-a358-a82d-97da413c5325","state":"captured","created_at":"2024-05-02T12:26:48.134039Z","updated_at":"2024-05-02T12:26:49.514594Z","token":"8061e645-35e0-42bb-8318-603abaeab7b7","amount":100,"currency":"GBP","settled_amount":79,"settled_currency":"GBP","billing_address":{"street_line_1":"123 Example Street","street_line_2":"Building A, 3rd Floor","city":"Example City","region":"Example Region","country_code":"GB","postcode":"E14 4HD"},"risk_level":"low","fees":[{"type":"acquiring","amount":21,"currency":"GBP"}],"payment_method":{"type":"google_pay","fingerprint":"1JAllfQY4POhBV8DaddAQ4LC5RbMP8LMLvUdJW4s5JY="},"order_id":"6633865d-d911-a98c-8715-425f8731640c"}},"card_payment_saved":{"summary":"Payment completed via card (saved details)","value":{"id":"663387f1-1c2e-a295-b143-9f1fb1eec175","state":"captured","created_at":"2024-05-02T12:32:49.033945Z","updated_at":"2024-05-02T12:32:57.003519Z","token":"294358bf-3818-49b2-aacc-7ca971f52695","amount":100,"currency":"GBP","settled_amount":79,"settled_currency":"GBP","billing_address":{"street_line_1":"123 Example Street","street_line_2":"Building A, 3rd Floor","city":"Example City","region":"Example Region","country_code":"GB","postcode":"E14 4HD"},"risk_level":"low","fees":[{"type":"acquiring","amount":21,"currency":"GBP"}],"payment_method":{"id":"663387f1-c91e-a464-908a-1cc4548ebc6a","type":"card","fingerprint":"1JAllfQY4POhBV8DaddAQ4LC5RbMP8LMLvUdJW4s5JY=","card_brand":"visa","funding":"credit","card_country_code":"GB","card_bin":"123456","card_last_four":"1234","card_expiry":"12/30","cardholder_name":"Test Holder","checks":{"three_ds":{"eci":"06","state":"verified","version":2},"cvv_verification":"match","address":"match","postcode":"match","cardholder":"n_a"}},"order_id":"663387bd-8484-ac57-93a7-3751dc154bbc"}},"sepa_direct_debit":{"summary":"Payment via SEPA Direct Debit (pending)","value":{"id":"63dd0e4a-42c4-a1a6-ab2c-6ac9d255ca4b","state":"pending","created_at":"2024-05-02T12:32:49.033945Z","updated_at":"2024-05-02T12:32:57.003519Z","token":"294358bf-3818-49b2-aacc-7ca971f52695","amount":100,"currency":"EUR","risk_level":"low","payment_method":{"type":"sepa_direct_debit","debtor_iban_last_four":"1234","debtor_name":"John Doe","mandate_reference":"A1B2C3D4E5F6A1B2C3D4E5F6A1B2C3D4"},"order_id":"63dd0e3f-7b84-ab5c-927c-1a06f7c9583a"}},"card_payment_not_saved":{"summary":"Payment completed via card (not saved details)","value":{"id":"663387f1-1c2e-a295-b143-9f1fb1eec175","state":"captured","created_at":"2024-05-02T12:32:49.033945Z","updated_at":"2024-05-02T12:32:57.003519Z","token":"294358bf-3818-49b2-aacc-7ca971f52695","amount":100,"currency":"GBP","settled_amount":79,"settled_currency":"GBP","billing_address":{"street_line_1":"123 Example Street","street_line_2":"Building A, 3rd Floor","city":"Example City","region":"Example Region","country_code":"GB","postcode":"E14 4HD"},"risk_level":"low","fees":[{"type":"acquiring","amount":21,"currency":"GBP"}],"payment_method":{"type":"card","fingerprint":"1JAllfQY4POhBV8DaddAQ4LC5RbMP8LMLvUdJW4s5JY=","card_brand":"visa","funding":"credit","card_country_code":"GB","card_bin":"123456","card_last_four":"1234","card_expiry":"12/30","cardholder_name":"Test Holder","checks":{"three_ds":{"eci":"06","state":"verified","version":2},"cvv_verification":"match","address":"match","postcode":"match","cardholder":"n_a"}},"order_id":"663387bd-8484-ac57-93a7-3751dc154bbc"}}}}},"descriptionNode":"$L10b7"},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"errorId":{"type":"string","description":"The ID of the error. You can share this ID with Revolut\nsupport for troubleshooting.","descriptionNode":"$L10b8"},"timestamp":{"type":"integer","description":"The date and time the error happened.","descriptionNode":"$L10b9"}}},"examples":{"example-1":{"value":{"errorId":"94b27660-fdda-49ec-8b85-cd46a068ade0","timestamp":1601296792533}}}}},"descriptionNode":"$L10ba"},"401":{"description":"Unauthorized","descriptionNode":"$L10bb"},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"errorId":{"type":"string","description":"The ID of the error. You can share this ID with Revolut\nsupport for troubleshooting.","descriptionNode":"$L10bc"},"timestamp":{"type":"integer","description":"The date and time the error happened.","descriptionNode":"$L10bd"},"code":{"type":"integer"}}},"examples":{"example-1":{"value":{"errorId":"94b27660-fdda-49ec-8b85-cd46a068ade0","timestamp":1601296792533,"code":1024}}}}},"descriptionNode":"$L10be"}},"requestBody":"$undefined","variantLabels":["Payment completed via Revolut Pay (card, saved details)","Payment completed via Revolut Pay (account, not saved details)","Payment declined via Apple Tap to Pay","Payment completed via Apple Pay","Payment completed via Google Pay","Payment completed via card (saved details)","Payment via SEPA Direct Debit (pending)","Payment completed via card (not saved details)"],"children":["$L10bf","$L10c0"]}]}],false]}] 10bf:["$","div",null,{"className":"ezz1n30","children":[["$","div",null,{"data-header":"$undefined","className":"ezz1n31","children":["$","div",null,{"className":"y9a0do1","children":[["$","h2",null,{"id":"retrieve-payment-details","children":[["$L10c1","$undefined"],["$","$L15",null,{"id":"retrieve-payment-details"}]]}],["$","$L16",null,{"url":"/docs/api/merchant/2025-10-16/operations/retrieve-payment-details.md"}]]}]}],"$undefined"]}] 10c7:T9d2,
fetch("https://merchant.revolut.com/api/payments/__RP_TOK_0__", {
  method: "GET",
  headers: {
    "Authorization": "__RP_TOK_1__",
    "Revolut-Api-Version": "__RP_TOK_2__"
  }
})
  .then(response => response.json())
  .then(data => console.log(data));
10c8:Tf6f,
package main

import (
  "fmt"
  "net/http"
)

func main() {
  url := "https://merchant.revolut.com/api/payments/__RP_TOK_0__"
  req, _ := http.NewRequest("GET", url, nil)
  req.Header.Add("Authorization", "__RP_TOK_1__")
  req.Header.Add("Revolut-Api-Version", "__RP_TOK_2__")

  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  fmt.Println(res)
}
10c9:T7e4,
import requests

url = "https://merchant.revolut.com/api/payments/__RP_TOK_0__"
headers = {
  "Authorization": "__RP_TOK_1__",
  "Revolut-Api-Version": "__RP_TOK_2__"
}

response = requests.get(url, headers=headers)
print(response.json())
10ca:T1710,
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;

public class Main {
  public static void main(String[] args) {
    HttpClient client = HttpClient.newHttpClient();
    HttpRequest request = HttpRequest.newBuilder()
      .uri(URI.create("https://merchant.revolut.com/api/payments/__RP_TOK_0__"))
      .header("Authorization", "__RP_TOK_1__")
      .header("Revolut-Api-Version", "__RP_TOK_2__")
      .GET(HttpRequest.BodyPublishers.noBody())
      .build();

    client.sendAsync(request, HttpResponse.BodyHandlers.ofString())
      .thenApply(HttpResponse::body)
      .thenAccept(System.out::println)
      .join();
  }
}
10cb:T15ba,
using System.Net.Http;
using System.Net.Http.Headers;

var client = new HttpClient();
var request = new HttpRequestMessage
{
  Method = HttpMethod.Get,
  RequestUri = new Uri("https://merchant.revolut.com/api/payments/__RP_TOK_0__"),
  Headers =
  {
    { "Authorization", "__RP_TOK_1__" },
    { "Revolut-Api-Version", "__RP_TOK_2__" },
  }
};

using (var response = await client.SendAsync(request))
{
  response.EnsureSuccessStatusCode();
  var body = await response.Content.ReadAsStringAsync();
  Console.WriteLine(body);
}
10cc:T9da,
fetch("https://sandbox-merchant.revolut.com/api/payments/__RP_TOK_0__", {
  method: "GET",
  headers: {
    "Authorization": "__RP_TOK_1__",
    "Revolut-Api-Version": "__RP_TOK_2__"
  }
})
  .then(response => response.json())
  .then(data => console.log(data));
10cd:Tf77,
package main

import (
  "fmt"
  "net/http"
)

func main() {
  url := "https://sandbox-merchant.revolut.com/api/payments/__RP_TOK_0__"
  req, _ := http.NewRequest("GET", url, nil)
  req.Header.Add("Authorization", "__RP_TOK_1__")
  req.Header.Add("Revolut-Api-Version", "__RP_TOK_2__")

  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  fmt.Println(res)
}
10ce:T7ec,
import requests

url = "https://sandbox-merchant.revolut.com/api/payments/__RP_TOK_0__"
headers = {
  "Authorization": "__RP_TOK_1__",
  "Revolut-Api-Version": "__RP_TOK_2__"
}

response = requests.get(url, headers=headers)
print(response.json())
10cf:T1718,
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;

public class Main {
  public static void main(String[] args) {
    HttpClient client = HttpClient.newHttpClient();
    HttpRequest request = HttpRequest.newBuilder()
      .uri(URI.create("https://sandbox-merchant.revolut.com/api/payments/__RP_TOK_0__"))
      .header("Authorization", "__RP_TOK_1__")
      .header("Revolut-Api-Version", "__RP_TOK_2__")
      .GET(HttpRequest.BodyPublishers.noBody())
      .build();

    client.sendAsync(request, HttpResponse.BodyHandlers.ofString())
      .thenApply(HttpResponse::body)
      .thenAccept(System.out::println)
      .join();
  }
}
10d0:T15c2,
using System.Net.Http;
using System.Net.Http.Headers;

var client = new HttpClient();
var request = new HttpRequestMessage
{
  Method = HttpMethod.Get,
  RequestUri = new Uri("https://sandbox-merchant.revolut.com/api/payments/__RP_TOK_0__"),
  Headers =
  {
    { "Authorization", "__RP_TOK_1__" },
    { "Revolut-Api-Version", "__RP_TOK_2__" },
  }
};

using (var response = await client.SendAsync(request))
{
  response.EnsureSuccessStatusCode();
  var body = await response.Content.ReadAsStringAsync();
  Console.WriteLine(body);
}
10c0:["$","div",null,{"className":"ezz1n30","children":[["$","div",null,{"data-header":"$undefined","className":"ezz1n31","children":["$L10c2",["$","$L85",null,{"parameters":[{"name":"Authorization","in":"header","schema":{"type":"string","format":"Bearer ","examples":"$62:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:0:schema:examples"},"required":true,"description":"This parameter accepts the [Merchant API Secret key](https://business.revolut.com/settings/apis?tab=merchant-api) to authorise requests coming from the merchant's backend. \n\nIt ensures that ensures that each request is authenticated and authorised by verifying the secret key. The secret key should be included in all request headers as a `Bearer` token.\n\n:::info\nFor more information, see: [Authentication](https://developer.revolut.com/docs/api/merchant#authentication)\n:::","descriptionNode":"$L10c3"},{"name":"payment_id","in":"path","schema":{"type":"string","format":"uuid","description":"A UUID string, typically used to identify resources.","descriptionNode":"$L10c4"},"required":true,"description":"The ID of the `Payment` object.","descriptionNode":"$L10c5"},{"name":"Revolut-Api-Version","in":"header","schema":{"type":"string","format":"date","enum":"$6b:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:1:schema:enum","examples":"$6b:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:1:schema:examples"},"description":"The version of the Merchant API, specified in `YYYY-MM-DD` format.\n\n:::info\nFor more information about API versioning, see: [API versions](https://developer.revolut.com/docs/guides/merchant/reference/versioning/api-versions).\n:::","x-config-always-visible-in-example":true,"descriptionNode":"$L10c6"}],"requestBody":"$undefined","heading":"Request","requestBodySchemaTitle":"Request body","headingAs":"h3"}],["$","$L89",null,{"responses":"$2d:props:children:0:props:children:props:responses","headingAs":"h3"}]]}],["$","div",null,{"className":"ezz1n32","children":[[["$","$L8a",null,{"itemsByServer":{"https://merchant.revolut.com":[{"id":"curl","label":"cURL","templateCode":"curl -X GET \"https://merchant.revolut.com/api/payments/__RP_TOK_0__\" \\\n -H \"Authorization: __RP_TOK_1__\" \\\n -H \"Revolut-Api-Version: __RP_TOK_2__\"","templateHtml":"
curl -X GET \"https://merchant.revolut.com/api/payments/__RP_TOK_0__\" \\\n  -H \"Authorization: __RP_TOK_1__\" \\\n  -H \"Revolut-Api-Version: __RP_TOK_2__\"
","tokens":[{"marker":"__RP_TOK_0__","paramName":"payment_id","paramIn":"path","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["shell-double-inner"]}],"defaults":{"header:Authorization":"Bearer ","path:payment_id":"123e4567-e89b-12d3-a456-426614174000","header:Revolut-Api-Version":"2023-09-01"}},{"id":"javascript","label":"JavaScript","templateCode":"fetch(\"https://merchant.revolut.com/api/payments/__RP_TOK_0__\", {\n method: \"GET\",\n headers: {\n \"Authorization\": \"__RP_TOK_1__\",\n \"Revolut-Api-Version\": \"__RP_TOK_2__\"\n }\n})\n .then(response => response.json())\n .then(data => console.log(data));","templateHtml":"$10c7","tokens":[{"marker":"__RP_TOK_0__","paramName":"payment_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","path:payment_id":"123e4567-e89b-12d3-a456-426614174000","header:Revolut-Api-Version":"2023-09-01"}},{"id":"go","label":"Go","templateCode":"package main\n\nimport (\n \"fmt\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://merchant.revolut.com/api/payments/__RP_TOK_0__\"\n req, _ := http.NewRequest(\"GET\", url, nil)\n req.Header.Add(\"Authorization\", \"__RP_TOK_1__\")\n req.Header.Add(\"Revolut-Api-Version\", \"__RP_TOK_2__\")\n\n res, _ := http.DefaultClient.Do(req)\n defer res.Body.Close()\n fmt.Println(res)\n}","templateHtml":"$10c8","tokens":[{"marker":"__RP_TOK_0__","paramName":"payment_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","path:payment_id":"123e4567-e89b-12d3-a456-426614174000","header:Revolut-Api-Version":"2023-09-01"}},{"id":"python","label":"Python","templateCode":"import requests\n\nurl = \"https://merchant.revolut.com/api/payments/__RP_TOK_0__\"\nheaders = {\n \"Authorization\": \"__RP_TOK_1__\",\n \"Revolut-Api-Version\": \"__RP_TOK_2__\"\n}\n\nresponse = requests.get(url, headers=headers)\nprint(response.json())","templateHtml":"$10c9","tokens":[{"marker":"__RP_TOK_0__","paramName":"payment_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","path:payment_id":"123e4567-e89b-12d3-a456-426614174000","header:Revolut-Api-Version":"2023-09-01"}},{"id":"java","label":"Java","templateCode":"import java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\nimport java.net.URI;\n\npublic class Main {\n public static void main(String[] args) {\n HttpClient client = HttpClient.newHttpClient();\n HttpRequest request = HttpRequest.newBuilder()\n .uri(URI.create(\"https://merchant.revolut.com/api/payments/__RP_TOK_0__\"))\n .header(\"Authorization\", \"__RP_TOK_1__\")\n .header(\"Revolut-Api-Version\", \"__RP_TOK_2__\")\n .GET(HttpRequest.BodyPublishers.noBody())\n .build();\n\n client.sendAsync(request, HttpResponse.BodyHandlers.ofString())\n .thenApply(HttpResponse::body)\n .thenAccept(System.out::println)\n .join();\n }\n}","templateHtml":"$10ca","tokens":[{"marker":"__RP_TOK_0__","paramName":"payment_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","path:payment_id":"123e4567-e89b-12d3-a456-426614174000","header:Revolut-Api-Version":"2023-09-01"}},{"id":"csharp","label":"C#","templateCode":"using System.Net.Http;\nusing System.Net.Http.Headers;\n\nvar client = new HttpClient();\nvar request = new HttpRequestMessage\n{\n Method = HttpMethod.Get,\n RequestUri = new Uri(\"https://merchant.revolut.com/api/payments/__RP_TOK_0__\"),\n Headers =\n {\n { \"Authorization\", \"__RP_TOK_1__\" },\n { \"Revolut-Api-Version\", \"__RP_TOK_2__\" },\n }\n};\n\nusing (var response = await client.SendAsync(request))\n{\n response.EnsureSuccessStatusCode();\n var body = await response.Content.ReadAsStringAsync();\n Console.WriteLine(body);\n}","templateHtml":"$10cb","tokens":[{"marker":"__RP_TOK_0__","paramName":"payment_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","path:payment_id":"123e4567-e89b-12d3-a456-426614174000","header:Revolut-Api-Version":"2023-09-01"}}],"https://sandbox-merchant.revolut.com":[{"id":"curl","label":"cURL","templateCode":"curl -X GET \"https://sandbox-merchant.revolut.com/api/payments/__RP_TOK_0__\" \\\n -H \"Authorization: __RP_TOK_1__\" \\\n -H \"Revolut-Api-Version: __RP_TOK_2__\"","templateHtml":"
curl -X GET \"https://sandbox-merchant.revolut.com/api/payments/__RP_TOK_0__\" \\\n  -H \"Authorization: __RP_TOK_1__\" \\\n  -H \"Revolut-Api-Version: __RP_TOK_2__\"
","tokens":[{"marker":"__RP_TOK_0__","paramName":"payment_id","paramIn":"path","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["shell-double-inner"]}],"defaults":{"header:Authorization":"Bearer ","path:payment_id":"123e4567-e89b-12d3-a456-426614174000","header:Revolut-Api-Version":"2023-09-01"}},{"id":"javascript","label":"JavaScript","templateCode":"fetch(\"https://sandbox-merchant.revolut.com/api/payments/__RP_TOK_0__\", {\n method: \"GET\",\n headers: {\n \"Authorization\": \"__RP_TOK_1__\",\n \"Revolut-Api-Version\": \"__RP_TOK_2__\"\n }\n})\n .then(response => response.json())\n .then(data => console.log(data));","templateHtml":"$10cc","tokens":[{"marker":"__RP_TOK_0__","paramName":"payment_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","path:payment_id":"123e4567-e89b-12d3-a456-426614174000","header:Revolut-Api-Version":"2023-09-01"}},{"id":"go","label":"Go","templateCode":"package main\n\nimport (\n \"fmt\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://sandbox-merchant.revolut.com/api/payments/__RP_TOK_0__\"\n req, _ := http.NewRequest(\"GET\", url, nil)\n req.Header.Add(\"Authorization\", \"__RP_TOK_1__\")\n req.Header.Add(\"Revolut-Api-Version\", \"__RP_TOK_2__\")\n\n res, _ := http.DefaultClient.Do(req)\n defer res.Body.Close()\n fmt.Println(res)\n}","templateHtml":"$10cd","tokens":[{"marker":"__RP_TOK_0__","paramName":"payment_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","path:payment_id":"123e4567-e89b-12d3-a456-426614174000","header:Revolut-Api-Version":"2023-09-01"}},{"id":"python","label":"Python","templateCode":"import requests\n\nurl = \"https://sandbox-merchant.revolut.com/api/payments/__RP_TOK_0__\"\nheaders = {\n \"Authorization\": \"__RP_TOK_1__\",\n \"Revolut-Api-Version\": \"__RP_TOK_2__\"\n}\n\nresponse = requests.get(url, headers=headers)\nprint(response.json())","templateHtml":"$10ce","tokens":[{"marker":"__RP_TOK_0__","paramName":"payment_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","path:payment_id":"123e4567-e89b-12d3-a456-426614174000","header:Revolut-Api-Version":"2023-09-01"}},{"id":"java","label":"Java","templateCode":"import java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\nimport java.net.URI;\n\npublic class Main {\n public static void main(String[] args) {\n HttpClient client = HttpClient.newHttpClient();\n HttpRequest request = HttpRequest.newBuilder()\n .uri(URI.create(\"https://sandbox-merchant.revolut.com/api/payments/__RP_TOK_0__\"))\n .header(\"Authorization\", \"__RP_TOK_1__\")\n .header(\"Revolut-Api-Version\", \"__RP_TOK_2__\")\n .GET(HttpRequest.BodyPublishers.noBody())\n .build();\n\n client.sendAsync(request, HttpResponse.BodyHandlers.ofString())\n .thenApply(HttpResponse::body)\n .thenAccept(System.out::println)\n .join();\n }\n}","templateHtml":"$10cf","tokens":[{"marker":"__RP_TOK_0__","paramName":"payment_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","path:payment_id":"123e4567-e89b-12d3-a456-426614174000","header:Revolut-Api-Version":"2023-09-01"}},{"id":"csharp","label":"C#","templateCode":"using System.Net.Http;\nusing System.Net.Http.Headers;\n\nvar client = new HttpClient();\nvar request = new HttpRequestMessage\n{\n Method = HttpMethod.Get,\n RequestUri = new Uri(\"https://sandbox-merchant.revolut.com/api/payments/__RP_TOK_0__\"),\n Headers =\n {\n { \"Authorization\", \"__RP_TOK_1__\" },\n { \"Revolut-Api-Version\", \"__RP_TOK_2__\" },\n }\n};\n\nusing (var response = await client.SendAsync(request))\n{\n response.EnsureSuccessStatusCode();\n var body = await response.Content.ReadAsStringAsync();\n Console.WriteLine(body);\n}","templateHtml":"$10d0","tokens":[{"marker":"__RP_TOK_0__","paramName":"payment_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","path:payment_id":"123e4567-e89b-12d3-a456-426614174000","header:Revolut-Api-Version":"2023-09-01"}}]},"method":"get","servers":"$62:props:children:0:props:children:props:children:1:props:children:1:props:children:0:0:props:servers","path":"/api/payments/{payment_id}","parameters":["$10c0:props:children:0:props:children:1:props:parameters:0","$10c0:props:children:0:props:children:1:props:parameters:1","$10c0:props:children:0:props:children:1:props:parameters:2"]}],"$L10d1"],"$L10d2","$L10d3"]}]]}] 10d1:["$","$L10d",null,{"security":[{"Api-Key":[]}],"authorization":{"Api-Key":{"type":"apiKey","in":"header","name":"Authorization","description":"Each Merchant API request must contain an authorization header in the following format:\n\n```\n'Authorization: Bearer '\n```\n\nTo use this API, you need to generate API keys from your Revolut Business account. The Secret key is used in the authorization header for all server calls, while the Public key is provided with payment methods at checkout.\n\n:::info\nFor detailed instructions on generating your API keys, see: [Generate API keys](https://developer.revolut.com/docs/guides/merchant/get-started#generate-api-keys).\n:::","descriptionNode":"$L10d4"}}}] 10d2:["$","$L10f",null,{"exampleBlocks":{},"title":"Request body samples","headingAs":"h4"}] 10d3:["$","$L110",null,{"exampleBlocks":{"200":{"application/json":{"variants":[{"key":"revolut_pay_saved","label":"Payment completed via Revolut Pay (card, saved details)","rawValue":"$2d:props:children:0:props:children:props:responses:200:content:application/json:examples:revolut_pay_saved:value","block":"$L10d5"},{"key":"revolut_pay_not_saved","label":"Payment completed via Revolut Pay (account, not saved details)","rawValue":"$2d:props:children:0:props:children:props:responses:200:content:application/json:examples:revolut_pay_not_saved:value","block":"$L10d6"},{"key":"apple_tap_to_pay","label":"Payment declined via Apple Tap to Pay","rawValue":"$2d:props:children:0:props:children:props:responses:200:content:application/json:examples:apple_tap_to_pay:value","block":"$L10d7"},{"key":"apple_pay","label":"Payment completed via Apple Pay","rawValue":"$2d:props:children:0:props:children:props:responses:200:content:application/json:examples:apple_pay:value","block":"$L10d8"},{"key":"google_pay","label":"Payment completed via Google Pay","rawValue":"$2d:props:children:0:props:children:props:responses:200:content:application/json:examples:google_pay:value","block":"$L10d9"},{"key":"card_payment_saved","label":"Payment completed via card (saved details)","rawValue":"$2d:props:children:0:props:children:props:responses:200:content:application/json:examples:card_payment_saved:value","block":"$L10da"},{"key":"sepa_direct_debit","label":"Payment via SEPA Direct Debit (pending)","rawValue":"$2d:props:children:0:props:children:props:responses:200:content:application/json:examples:sepa_direct_debit:value","block":"$L10db"},{"key":"card_payment_not_saved","label":"Payment completed via card (not saved details)","rawValue":"$2d:props:children:0:props:children:props:responses:200:content:application/json:examples:card_payment_not_saved:value","block":"$L10dc"}],"syncedPropertyName":"$undefined"}},"400":{"application/json":{"variants":[{"key":"example-1","label":"example-1","rawValue":"$2d:props:children:0:props:children:props:responses:400:content:application/json:examples:example-1:value","block":"$L10dd"}],"syncedPropertyName":"$undefined"}},"401":{},"404":{"application/json":{"variants":[{"key":"example-1","label":"example-1","rawValue":"$2d:props:children:0:props:children:props:responses:404:content:application/json:examples:example-1:value","block":"$L10de"}],"syncedPropertyName":"$undefined"}}},"headingAs":"h4"}] 10c1:"Retrieve payment details" 1037:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The ID of the associated order."}]]}] 1038:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The ID of the payment."}]]}] 1039:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The status of the payment."}]]}] 103a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The reason for a ",["$","code","code-0",{"children":"failed"}]," or ",["$","code","code-1",{"children":"declined"}]," payment."]}],"\n",["$","p","p-1",{"children":["A failed or declined payment can result from multiple reasons. To learn more, check our ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/reference/error-codes/decline-reasons","target":"_blank","rel":"noreferrer","children":"failure reasons"}],"."]}]]}] 103b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The reason for a ",["$","code","code-0",{"children":"failed"}]," or ",["$","code","code-1",{"children":"declined"}]," payment, sent by the financial institution processing the payment."]}]]}] 103c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The date and time the payment was created."}]]}] 103d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The date and time the payment was last updated."}]]}] 103e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Temporary token of the payment used to fetch the reward offer during checkout and link user registrations to the given offers."}],"\n",["$","p","p-1",{"children":"The token is only valid for a limited time."}]]}] 103f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The payment amount in minor units (e.g., cents). The value of this field depends on the payment type and state."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Payment type","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"State","className":"eowryt6","ref":"$undefined"}],["$","th","th-2",{"children":"Amount value","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":"Standard payment","className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Any","className":"eowryt7","ref":"$undefined"}],["$","td","td-2",{"children":"Total payment amount","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":"Pre-authorised payment","className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["$","code","code-0",{"children":"authorisation_started"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-2",{"children":"New amount being authorised (during increment processing)","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":"Pre-authorised payment","className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["$","code","code-0",{"children":"authorised"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-2",{"children":["Currently authorised amount (equals ",["$","code","code-0",{"children":"authorised_amount"}],")"],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For pre-authorised payments, see the ",["$","code","code-0",{"children":"authorised_amount"}]," field for tracking the currently authorised amount separately."]}]}]]}]]}] 1040:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The currently authorised amount for this payment (in minor units)."}],"\n",["$","p","p-1",{"children":"For pre-authorised payments with incremental authorization:"}],"\n",["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["Initially equals the ",["$","code","code-0",{"children":"amount"}]," field"]}],"\n",["$","li","li-1",{"children":"Remains unchanged during increment processing"}],"\n",["$","li","li-2",{"children":"Updates to new amount upon successful increment"}],"\n",["$","li","li-3",{"children":"Remains at original amount if increment is declined"}],"\n"]}],"\n",["$","p","p-2",{"children":["For standard payments, this field may not be present or will equal the ",["$","code","code-0",{"children":"amount"}]," field."]}]]}] 1041:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":[["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_4217","target":"_blank","rel":"noreferrer","children":"ISO 4217"}]," currency code in upper case."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information about the supported currencies, see: ",["$","a","a-0",{"href":"https://help.revolut.com/business/help/merchant-accounts/payments/in-which-currencies-can-i-accept-payments/","target":"_blank","rel":"noreferrer","children":"Help Center"}],"."]}]}]]}]]}] 1042:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The amount of the settled payment (minor currency unit). For example, ",["$","code","code-0",{"children":"7034"}]," stands for €70.34."]}]]}] 1043:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The currency of the settled payment. ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_4217","target":"_blank","rel":"noreferrer","children":"ISO 4217"}]," currency code in upper case."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information about the supported currencies, see: ",["$","a","a-0",{"href":"https://help.revolut.com/business/help/merchant-accounts/payments/in-which-currencies-can-i-accept-payments/","target":"_blank","rel":"noreferrer","children":"Help Center"}],"."]}]}]]}]]}] 1044:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"ID of the saved payment method."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["The ",["$","code","code-0",{"children":"id"}]," parameter is only returned when the payment method is saved."]}]}]]}]]}] 1045:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of payment method used to pay for the order."}],"\n",["$","p","p-1",{"children":"Available values:"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":["Payment method ",["$","code","code-0",{"children":"type"}]],"className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"apple_pay"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using Apple Pay.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"card"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using their credit or debit card.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"google_pay"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using Google Pay.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"revolut_pay_card"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order via Revolut Pay using their credit or debit card.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-4",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"revolut_pay_account"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order via Revolut Pay using their Revolut account.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-5",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"sepa_direct_debit"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using SEPA Direct Debit.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 1046:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of the card."}]]}] 1047:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of card funding."}]]}] 1048:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The 2-letter country code of the country where the card was issued."}]]}] 1049:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The BIN of the card."}]]}] 104a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The last four digits of the card number."}]]}] 104b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The expiry date of the card in the format of MM/YY."}]]}] 104c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The name of the cardholder."}]]}] 104d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The Electronic Commerce Indicator (ECI) value corresponds to the authentication result and indicates the level of security used when the payment information was provided."}]]}] 104e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The result of 3D Secure check."}]]}] 104f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The 3D Secure version."}]]}] 1050:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The details of the 3D Secure check. Only for orders with successful payments."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":"Not returned for Apple Pay and Google Pay payments."}]}]]}]]}] 1051:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The result of CVV verification."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Parameter value","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"match"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"CVV matches the card's CVV","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"not_match"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"CVV does not match the card's CVV","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"incorrect"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"CVV format is incorrect for this type of card","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"not_processed"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"CVV verification was not performed","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 1052:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The result of address verification."}]]}] 1053:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The result of postcode verification."}]]}] 1054:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The result of cardholder verification."}]]}] 1055:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The details of the check for card payment. Only for orders with successful payments."}]]}] 1056:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The authorisation code (or auth code) is a short, alphanumeric code returned by the cardholder's issuing bank to the merchant's terminal or payment gateway."}],"\n",["$","p","p-1",{"children":"It serves as confirmation that the transaction has been approved and funds are available."}]]}] 1057:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Acquirer Reference Number (ARN) of the payment."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":"Only returned for refund payments made by a card."}]}]]}]]}] 1058:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The date and time by which the payment must be captured."}],"\n",["$","p","p-1",{"children":"After this deadline, the authorised funds may be automatically released by the card issuer."}]]}] 1059:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The hardware identifier of the Revolut Terminal device used to process the payment."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":"Only present for card-present transactions processed via Revolut Terminal."}]}]]}]]}] 105b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A unique identifier for a payment method, always 44 characters long. This fingerprint can be used to uniquely identify various payment methods."}],"\n",["$","h1","h1-0",{"children":"Fingerprint generation"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Payment method","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","strong","strong-0",{"children":"All payment methods"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"A fingerprint is generated for all payment methods, including cards, Revolut Pay (card, account-to-account payments), Apple Pay, and Google Pay.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","strong","strong-0",{"children":"Cards (Revolut Pay & Card Gateway)"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"For cards, the fingerprint is based on the PAN. Cards processed via Revolut Pay and our card gateway will share the same fingerprint. Renewed cards (new expiry/CVV) retain the same fingerprint for efficient blocking.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","strong","strong-0",{"children":"Apple Pay & Google Pay"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Since Apple Pay and Google Pay provide us Device PANs (DPAN), the fingerprint is based on the DPAN provided by Apple/Google, not the connected card's PAN. This means that a new DPAN (and fingerprint) is generated for cards in case they are re-added to the customer's digital wallet, or added to different devices.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}],"\n",["$","h4","h4-0",{"children":"Detecting duplicate payment methods"}],"\n",["$","p","p-1",{"children":"Fingerprints are a valuable tool for detecting duplicate payment methods by identifying if a payment method has been seen before. This capability, in turn, helps in preventing various types of misuse (e.g., exploitation of free trials, or association with known problematic accounts, which can be a form of fraud). To effectively use fingerprints for this purpose, you will need to create and maintain your own lists (e.g., blocklists of known problematic fingerprints, allowlists for trusted customers, or tracking frequently used fingerprints)."}],"\n",["$","p","p-2",{"children":"The ideal way to utilise fingerprints is by combining them with a manual capture process. While automatic capture with subsequent refunds for problematic payments is possible, manual capture based on fingerprint validation is recommended."}],"\n",["$","p","p-3",{"children":"During your manual capture workflow, after a payment was authorised:"}],"\n",["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":"Check the fingerprint status by comparing it against your maintained lists and internal business rules."}],"\n",["$","li","li-1",{"children":["If you decide to proceed with the payment (e.g., the fingerprint is not on a blocklist, or matches a trusted customer's previous payment method): ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#capture-order","target":"_blank","rel":"noreferrer","children":"Capture the order"}],"."]}],"\n",["$","li","li-2",{"children":["If you decide not to proceed with the payment (e.g., the fingerprint matches a known fraudulent fingerprint, or exhibits suspicious patterns): ","$L10df","."]}],"\n"]}]]}] 105c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The Network Transaction ID (NTI) is a unique identifier assigned by the card scheme (e.g., Visa or Mastercard) to a card transaction."}],"\n",["$","p","p-1",{"children":"It can be used to trace the transaction across the payment network, link recurring or instalment payments to the original authorisation, and support dispute resolution."}]]}] 105d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object containing details of a card used via Apple Pay."}]]}] 105e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"ID of the saved payment method."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["The ",["$","code","code-0",{"children":"id"}]," parameter is only returned when the payment method is saved."]}]}]]}]]}] 105f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of payment method used to pay for the order."}],"\n",["$","p","p-1",{"children":"Available values:"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":["Payment method ",["$","code","code-0",{"children":"type"}]],"className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"apple_pay"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using Apple Pay.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"card"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using their credit or debit card.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"google_pay"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using Google Pay.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"revolut_pay_card"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order via Revolut Pay using their credit or debit card.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-4",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"revolut_pay_account"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order via Revolut Pay using their Revolut account.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-5",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"sepa_direct_debit"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using SEPA Direct Debit.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 1060:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of the card."}]]}] 1061:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of card funding."}]]}] 1062:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The 2-letter country code of the country where the card was issued."}]]}] 1063:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The BIN of the card."}]]}] 1064:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The last four digits of the card number."}]]}] 1065:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The expiry date of the card in the format of MM/YY."}]]}] 1066:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The name of the cardholder."}]]}] 1067:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The details of the check for card payment. Only for orders with successful payments."}]]}] 1068:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The authorisation code (or auth code) is a short, alphanumeric code returned by the cardholder's issuing bank to the merchant's terminal or payment gateway."}],"\n",["$","p","p-1",{"children":"It serves as confirmation that the transaction has been approved and funds are available."}]]}] 1069:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Acquirer Reference Number (ARN) of the payment."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":"Only returned for refund payments made by a card."}]}]]}]]}] 106a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The date and time by which the payment must be captured."}],"\n",["$","p","p-1",{"children":"After this deadline, the authorised funds may be automatically released by the card issuer."}]]}] 106b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The hardware identifier of the Revolut Terminal device used to process the payment."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":"Only present for card-present transactions processed via Revolut Terminal."}]}]]}]]}] 106d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A unique identifier for a payment method, always 44 characters long. This fingerprint can be used to uniquely identify various payment methods."}],"\n",["$","h1","h1-0",{"children":"Fingerprint generation"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Payment method","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","strong","strong-0",{"children":"All payment methods"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"A fingerprint is generated for all payment methods, including cards, Revolut Pay (card, account-to-account payments), Apple Pay, and Google Pay.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","strong","strong-0",{"children":"Cards (Revolut Pay & Card Gateway)"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"For cards, the fingerprint is based on the PAN. Cards processed via Revolut Pay and our card gateway will share the same fingerprint. Renewed cards (new expiry/CVV) retain the same fingerprint for efficient blocking.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","strong","strong-0",{"children":"Apple Pay & Google Pay"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Since Apple Pay and Google Pay provide us Device PANs (DPAN), the fingerprint is based on the DPAN provided by Apple/Google, not the connected card's PAN. This means that a new DPAN (and fingerprint) is generated for cards in case they are re-added to the customer's digital wallet, or added to different devices.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}],"\n",["$","h4","h4-0",{"children":"Detecting duplicate payment methods"}],"\n",["$","p","p-1",{"children":"Fingerprints are a valuable tool for detecting duplicate payment methods by identifying if a payment method has been seen before. This capability, in turn, helps in preventing various types of misuse (e.g., exploitation of free trials, or association with known problematic accounts, which can be a form of fraud). To effectively use fingerprints for this purpose, you will need to create and maintain your own lists (e.g., blocklists of known problematic fingerprints, allowlists for trusted customers, or tracking frequently used fingerprints)."}],"\n",["$","p","p-2",{"children":"The ideal way to utilise fingerprints is by combining them with a manual capture process. While automatic capture with subsequent refunds for problematic payments is possible, manual capture based on fingerprint validation is recommended."}],"\n",["$","p","p-3",{"children":"During your manual capture workflow, after a payment was authorised:"}],"\n",["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":"Check the fingerprint status by comparing it against your maintained lists and internal business rules."}],"\n",["$","li","li-1",{"children":["If you decide to proceed with the payment (e.g., the fingerprint is not on a blocklist, or matches a trusted customer's previous payment method): ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#capture-order","target":"_blank","rel":"noreferrer","children":"Capture the order"}],"."]}],"\n",["$","li","li-2",{"children":["If you decide not to proceed with the payment (e.g., the fingerprint matches a known fraudulent fingerprint, or exhibits suspicious patterns): ","$L10e0","."]}],"\n"]}]]}] 106e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The Network Transaction ID (NTI) is a unique identifier assigned by the card scheme (e.g., Visa or Mastercard) to a card transaction."}],"\n",["$","p","p-1",{"children":"It can be used to trace the transaction across the payment network, link recurring or instalment payments to the original authorisation, and support dispute resolution."}]]}] 106f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object containing details of the card used for the payment."}]]}] 1070:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"ID of the saved payment method."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["The ",["$","code","code-0",{"children":"id"}]," parameter is only returned when the payment method is saved."]}]}]]}]]}] 1071:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of payment method used to pay for the order."}],"\n",["$","p","p-1",{"children":"Available values:"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":["Payment method ",["$","code","code-0",{"children":"type"}]],"className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"apple_pay"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using Apple Pay.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"card"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using their credit or debit card.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"google_pay"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using Google Pay.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"revolut_pay_card"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order via Revolut Pay using their credit or debit card.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-4",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"revolut_pay_account"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order via Revolut Pay using their Revolut account.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-5",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"sepa_direct_debit"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using SEPA Direct Debit.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 1072:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of the card."}]]}] 1073:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of card funding."}]]}] 1074:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The 2-letter country code of the country where the card was issued."}]]}] 1075:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The BIN of the card."}]]}] 1076:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The last four digits of the card number."}]]}] 1077:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The expiry date of the card in the format of MM/YY."}]]}] 1078:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The name of the cardholder."}]]}] 1079:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The details of the check for card payment. Only for orders with successful payments."}]]}] 107a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The authorisation code (or auth code) is a short, alphanumeric code returned by the cardholder's issuing bank to the merchant's terminal or payment gateway."}],"\n",["$","p","p-1",{"children":"It serves as confirmation that the transaction has been approved and funds are available."}]]}] 107b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Acquirer Reference Number (ARN) of the payment."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":"Only returned for refund payments made by a card."}]}]]}]]}] 107c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The date and time by which the payment must be captured."}],"\n",["$","p","p-1",{"children":"After this deadline, the authorised funds may be automatically released by the card issuer."}]]}] 107d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The hardware identifier of the Revolut Terminal device used to process the payment."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":"Only present for card-present transactions processed via Revolut Terminal."}]}]]}]]}] 107f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A unique identifier for a payment method, always 44 characters long. This fingerprint can be used to uniquely identify various payment methods."}],"\n",["$","h1","h1-0",{"children":"Fingerprint generation"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Payment method","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","strong","strong-0",{"children":"All payment methods"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"A fingerprint is generated for all payment methods, including cards, Revolut Pay (card, account-to-account payments), Apple Pay, and Google Pay.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","strong","strong-0",{"children":"Cards (Revolut Pay & Card Gateway)"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"For cards, the fingerprint is based on the PAN. Cards processed via Revolut Pay and our card gateway will share the same fingerprint. Renewed cards (new expiry/CVV) retain the same fingerprint for efficient blocking.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","strong","strong-0",{"children":"Apple Pay & Google Pay"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Since Apple Pay and Google Pay provide us Device PANs (DPAN), the fingerprint is based on the DPAN provided by Apple/Google, not the connected card's PAN. This means that a new DPAN (and fingerprint) is generated for cards in case they are re-added to the customer's digital wallet, or added to different devices.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}],"\n",["$","h4","h4-0",{"children":"Detecting duplicate payment methods"}],"\n",["$","p","p-1",{"children":"Fingerprints are a valuable tool for detecting duplicate payment methods by identifying if a payment method has been seen before. This capability, in turn, helps in preventing various types of misuse (e.g., exploitation of free trials, or association with known problematic accounts, which can be a form of fraud). To effectively use fingerprints for this purpose, you will need to create and maintain your own lists (e.g., blocklists of known problematic fingerprints, allowlists for trusted customers, or tracking frequently used fingerprints)."}],"\n",["$","p","p-2",{"children":"The ideal way to utilise fingerprints is by combining them with a manual capture process. While automatic capture with subsequent refunds for problematic payments is possible, manual capture based on fingerprint validation is recommended."}],"\n",["$","p","p-3",{"children":"During your manual capture workflow, after a payment was authorised:"}],"\n",["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":"Check the fingerprint status by comparing it against your maintained lists and internal business rules."}],"\n",["$","li","li-1",{"children":["If you decide to proceed with the payment (e.g., the fingerprint is not on a blocklist, or matches a trusted customer's previous payment method): ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#capture-order","target":"_blank","rel":"noreferrer","children":"Capture the order"}],"."]}],"\n",["$","li","li-2",{"children":["If you decide not to proceed with the payment (e.g., the fingerprint matches a known fraudulent fingerprint, or exhibits suspicious patterns): ","$L10e1","."]}],"\n"]}]]}] 1080:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The Network Transaction ID (NTI) is a unique identifier assigned by the card scheme (e.g., Visa or Mastercard) to a card transaction."}],"\n",["$","p","p-1",{"children":"It can be used to trace the transaction across the payment network, link recurring or instalment payments to the original authorisation, and support dispute resolution."}]]}] 1081:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object containing details of a card used via Google Pay."}]]}] 1082:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"ID of the saved payment method."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["The ",["$","code","code-0",{"children":"id"}]," parameter is only returned when the payment method is saved."]}]}]]}]]}] 1083:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of payment method used to pay for the order."}],"\n",["$","p","p-1",{"children":"Available values:"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":["Payment method ",["$","code","code-0",{"children":"type"}]],"className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"apple_pay"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using Apple Pay.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"card"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using their credit or debit card.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"google_pay"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using Google Pay.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"revolut_pay_card"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order via Revolut Pay using their credit or debit card.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-4",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"revolut_pay_account"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order via Revolut Pay using their Revolut account.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-5",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"sepa_direct_debit"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using SEPA Direct Debit.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 1084:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of the card."}]]}] 1085:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of card funding."}]]}] 1086:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The 2-letter country code of the country where the card was issued."}]]}] 1087:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The BIN of the card."}]]}] 1088:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The last four digits of the card number."}]]}] 1089:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The expiry date of the card in the format of MM/YY."}]]}] 108a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The name of the cardholder."}]]}] 108b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The details of the check for card payment. Only for orders with successful payments."}]]}] 108c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The authorisation code (or auth code) is a short, alphanumeric code returned by the cardholder's issuing bank to the merchant's terminal or payment gateway."}],"\n",["$","p","p-1",{"children":"It serves as confirmation that the transaction has been approved and funds are available."}]]}] 108d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Acquirer Reference Number (ARN) of the payment."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":"Only returned for refund payments made by a card."}]}]]}]]}] 108e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The date and time by which the payment must be captured."}],"\n",["$","p","p-1",{"children":"After this deadline, the authorised funds may be automatically released by the card issuer."}]]}] 108f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The hardware identifier of the Revolut Terminal device used to process the payment."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":"Only present for card-present transactions processed via Revolut Terminal."}]}]]}]]}] 1091:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A unique identifier for a payment method, always 44 characters long. This fingerprint can be used to uniquely identify various payment methods."}],"\n",["$","h1","h1-0",{"children":"Fingerprint generation"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Payment method","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","strong","strong-0",{"children":"All payment methods"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"A fingerprint is generated for all payment methods, including cards, Revolut Pay (card, account-to-account payments), Apple Pay, and Google Pay.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","strong","strong-0",{"children":"Cards (Revolut Pay & Card Gateway)"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"For cards, the fingerprint is based on the PAN. Cards processed via Revolut Pay and our card gateway will share the same fingerprint. Renewed cards (new expiry/CVV) retain the same fingerprint for efficient blocking.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","strong","strong-0",{"children":"Apple Pay & Google Pay"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Since Apple Pay and Google Pay provide us Device PANs (DPAN), the fingerprint is based on the DPAN provided by Apple/Google, not the connected card's PAN. This means that a new DPAN (and fingerprint) is generated for cards in case they are re-added to the customer's digital wallet, or added to different devices.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}],"\n",["$","h4","h4-0",{"children":"Detecting duplicate payment methods"}],"\n",["$","p","p-1",{"children":"Fingerprints are a valuable tool for detecting duplicate payment methods by identifying if a payment method has been seen before. This capability, in turn, helps in preventing various types of misuse (e.g., exploitation of free trials, or association with known problematic accounts, which can be a form of fraud). To effectively use fingerprints for this purpose, you will need to create and maintain your own lists (e.g., blocklists of known problematic fingerprints, allowlists for trusted customers, or tracking frequently used fingerprints)."}],"\n",["$","p","p-2",{"children":"The ideal way to utilise fingerprints is by combining them with a manual capture process. While automatic capture with subsequent refunds for problematic payments is possible, manual capture based on fingerprint validation is recommended."}],"\n",["$","p","p-3",{"children":"During your manual capture workflow, after a payment was authorised:"}],"\n",["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":"Check the fingerprint status by comparing it against your maintained lists and internal business rules."}],"\n",["$","li","li-1",{"children":["If you decide to proceed with the payment (e.g., the fingerprint is not on a blocklist, or matches a trusted customer's previous payment method): ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#capture-order","target":"_blank","rel":"noreferrer","children":"Capture the order"}],"."]}],"\n",["$","li","li-2",{"children":["If you decide not to proceed with the payment (e.g., the fingerprint matches a known fraudulent fingerprint, or exhibits suspicious patterns): ","$L10e2","."]}],"\n"]}]]}] 1092:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The Network Transaction ID (NTI) is a unique identifier assigned by the card scheme (e.g., Visa or Mastercard) to a card transaction."}],"\n",["$","p","p-1",{"children":"It can be used to trace the transaction across the payment network, link recurring or instalment payments to the original authorisation, and support dispute resolution."}]]}] 1093:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object containing details of a card used via Revolut Pay."}]]}] 1094:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"ID of the saved payment method."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["The ",["$","code","code-0",{"children":"id"}]," parameter is only returned when the payment method is saved."]}]}]]}]]}] 1095:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of payment method used to pay for the order."}],"\n",["$","p","p-1",{"children":"Available values:"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":["Payment method ",["$","code","code-0",{"children":"type"}]],"className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"apple_pay"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using Apple Pay.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"card"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using their credit or debit card.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"google_pay"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using Google Pay.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"revolut_pay_card"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order via Revolut Pay using their credit or debit card.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-4",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"revolut_pay_account"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order via Revolut Pay using their Revolut account.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-5",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"sepa_direct_debit"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using SEPA Direct Debit.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 1097:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A unique identifier for a payment method, always 44 characters long. This fingerprint can be used to uniquely identify various payment methods."}],"\n",["$","h1","h1-0",{"children":"Fingerprint generation"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Payment method","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","strong","strong-0",{"children":"All payment methods"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"A fingerprint is generated for all payment methods, including cards, Revolut Pay (card, account-to-account payments), Apple Pay, and Google Pay.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","strong","strong-0",{"children":"Cards (Revolut Pay & Card Gateway)"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"For cards, the fingerprint is based on the PAN. Cards processed via Revolut Pay and our card gateway will share the same fingerprint. Renewed cards (new expiry/CVV) retain the same fingerprint for efficient blocking.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","strong","strong-0",{"children":"Apple Pay & Google Pay"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Since Apple Pay and Google Pay provide us Device PANs (DPAN), the fingerprint is based on the DPAN provided by Apple/Google, not the connected card's PAN. This means that a new DPAN (and fingerprint) is generated for cards in case they are re-added to the customer's digital wallet, or added to different devices.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}],"\n",["$","h4","h4-0",{"children":"Detecting duplicate payment methods"}],"\n",["$","p","p-1",{"children":"Fingerprints are a valuable tool for detecting duplicate payment methods by identifying if a payment method has been seen before. This capability, in turn, helps in preventing various types of misuse (e.g., exploitation of free trials, or association with known problematic accounts, which can be a form of fraud). To effectively use fingerprints for this purpose, you will need to create and maintain your own lists (e.g., blocklists of known problematic fingerprints, allowlists for trusted customers, or tracking frequently used fingerprints)."}],"\n",["$","p","p-2",{"children":"The ideal way to utilise fingerprints is by combining them with a manual capture process. While automatic capture with subsequent refunds for problematic payments is possible, manual capture based on fingerprint validation is recommended."}],"\n",["$","p","p-3",{"children":"During your manual capture workflow, after a payment was authorised:"}],"\n",["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":"Check the fingerprint status by comparing it against your maintained lists and internal business rules."}],"\n",["$","li","li-1",{"children":["If you decide to proceed with the payment (e.g., the fingerprint is not on a blocklist, or matches a trusted customer's previous payment method): ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#capture-order","target":"_blank","rel":"noreferrer","children":"Capture the order"}],"."]}],"\n",["$","li","li-2",{"children":["If you decide not to proceed with the payment (e.g., the fingerprint matches a known fraudulent fingerprint, or exhibits suspicious patterns): ","$L10e3","."]}],"\n"]}]]}] 1098:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"ID of the saved payment method."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["The ",["$","code","code-0",{"children":"id"}]," parameter is only returned when the payment method is saved for the merchant."]}]}]]}]]}] 1099:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of payment method used to pay for the order."}],"\n",["$","p","p-1",{"children":"Available values:"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":["Payment method ",["$","code","code-0",{"children":"type"}]],"className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"apple_pay"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using Apple Pay.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"card"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using their credit or debit card.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"google_pay"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using Google Pay.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"revolut_pay_card"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order via Revolut Pay using their credit or debit card.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-4",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"revolut_pay_account"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order via Revolut Pay using their Revolut account.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-5",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"sepa_direct_debit"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using SEPA Direct Debit.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 109a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The last four digits of the debtor's IBAN."}]]}] 109b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The full name of the debtor as provided in the mandate."}]]}] 109c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The unique mandate reference generated by Revolut. Include this in pre-debit notifications sent to your customers."}]]}] 109d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object containing details of a SEPA Direct Debit payment."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/accept-payments/payment-methods/sepa-direct-debit/server-to-server","target":"_blank","rel":"noreferrer","children":"SEPA Direct Debit server-to-server integration"}]]}]}]]}]]}] 109e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The details of the payment method used to make the payment."}]]}] 109f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Type of the authentication challenge the payment triggers."}]]}] 10a0:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The URL of the authentication challenge."}]]}] 10a1:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Information about the 3DS challenge."}]]}] 10a2:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Type of the authentication challenge the payment triggers."}]]}] 10a3:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The URL of the fingerprint. (Used only internally by Revolut.)"}]]}] 10a4:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Data about the fingerprint used for authentication. (Used only internally\nby Revolut.)"}]]}] 10a5:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Information about the 3DS fingerprint challenge."}]]}] 10a6:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["Details about the authentication challenge that should be performed to complete the authentication process. For more information about Revolut's 3DS solution, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/reference/3d-secure","target":"_blank","rel":"noreferrer","children":"3D Secure overview"}],"."]}],"\n",["$","p","p-1",{"children":["Only returned if the payment's state is ",["$","code","code-0",{"children":"authentication_challenge"}],"."]}]]}] 10a7:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Street line 1 information."}]]}] 10a8:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Street line 2 information."}]]}] 10a9:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The region associated with the address."}]]}] 10aa:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The city associated with the address."}]]}] 10ab:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The 2-letter country code of the country associated with the address."}]]}] 10ac:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The postcode associated with the address."}]]}] 10ad:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object containing address details."}]]}] 10ae:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The risk level of the card."}],"\n",["$","p","p-1",{"children":["If the risk level is ",["$","code","code-0",{"children":"high"}],", the payment might be declined."]}]]}] 10af:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of the order fee."}]]}] 10b0:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The amount of the payment fee (minor currency unit). For example, enter ",["$","code","code-0",{"children":"7034"}]," for €70.34 in the field."]}]]}] 10b1:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The currency of the payment fee. ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_4217","target":"_blank","rel":"noreferrer","children":"ISO 4217"}]," currency code in upper case."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information about the supported currencies, see: ",["$","a","a-0",{"href":"https://help.revolut.com/business/help/merchant-accounts/payments/in-which-currencies-can-i-accept-payments/","target":"_blank","rel":"noreferrer","children":"Help Center"}],"."]}]}]]}]]}] 10b2:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The details of the order fee."}]]}] 10b3:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The email of the person who made the payment."}]]}] 10b4:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The phone number of the payer in ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/E.164","target":"_blank","rel":"noreferrer","children":"E.164 format"}],"."]}]]}] 10b5:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The person who made the payment. This object is present when an email or phone number is provided during the payment flow."}],"\n",["$","p","p-1",{"children":"Capturing payer details lets you identify exactly who authorised the charge, reach the right person for receipts or refund queries, and support compliance or fraud-review workflows where the paying identity matters."}]]}] 10b6:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Represents a payment for an order."}],"\n",["$","p","p-1",{"children":["For pre-authorised payments, the ",["$","code","code-0",{"children":"authorised_amount"}]," field tracks the currently authorised amount, which may differ from ",["$","code","code-1",{"children":"amount"}]," during incremental authorisation processing."]}]]}] 10b7:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Payment details"}]]}] 10b8:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The ID of the error. You can share this ID with Revolut\nsupport for troubleshooting."}]]}] 10b9:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The date and time the error happened."}]]}] 10ba:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Bad Request"}]]}] 10bb:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unauthorized"}]]}] 10bc:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The ID of the error. You can share this ID with Revolut\nsupport for troubleshooting."}]]}] 10bd:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The date and time the error happened."}]]}] 10be:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Not Found"}]]}] 10c2:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Retrieve information about a specific payment, based on the payment's ID."}],"\n",["$","p","p-1",{"children":"Use this endpoint to track a payment's lifecycle, for example:"}],"\n",["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["When you develop a ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/optimise-checkout/save-payment-methods/checkout-with-saved-card","target":"_blank","rel":"noreferrer","children":"1-click checkout process"}]]}],"\n",["$","li","li-1",{"children":["When you build a ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/optimise-checkout/save-payment-methods/subscription-management","target":"_blank","rel":"noreferrer","children":"subscription management system"}]]}],"\n"]}]]}] 10c3:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["This parameter accepts the ",["$","a","a-0",{"href":"https://business.revolut.com/settings/apis?tab=merchant-api","target":"_blank","rel":"noreferrer","children":"Merchant API Secret key"}]," to authorise requests coming from the merchant's backend."]}],"\n",["$","p","p-1",{"children":["It ensures that ensures that each request is authenticated and authorised by verifying the secret key. The secret key should be included in all request headers as a ",["$","code","code-0",{"children":"Bearer"}]," token."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#authentication","target":"_blank","rel":"noreferrer","children":"Authentication"}]]}]}]]}]]}] 10c4:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A UUID string, typically used to identify resources."}]]}] 10c5:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ID of the ",["$","code","code-0",{"children":"Payment"}]," object."]}]]}] 10c6:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The version of the Merchant API, specified in ",["$","code","code-0",{"children":"YYYY-MM-DD"}]," format."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information about API versioning, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/reference/versioning/api-versions","target":"_blank","rel":"noreferrer","children":"API versions"}],"."]}]}]]}]]}] 10df:["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#cancel-order","target":"_blank","rel":"noreferrer","children":"Cancel the order"}] 10e0:["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#cancel-order","target":"_blank","rel":"noreferrer","children":"Cancel the order"}] 10e1:["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#cancel-order","target":"_blank","rel":"noreferrer","children":"Cancel the order"}] 10e2:["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#cancel-order","target":"_blank","rel":"noreferrer","children":"Cancel the order"}] 10e3:["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#cancel-order","target":"_blank","rel":"noreferrer","children":"Cancel the order"}] 10d4:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Each Merchant API request must contain an authorization header in the following format:"}],"\n","$L10e4","\n",["$","p","p-1",{"children":"To use this API, you need to generate API keys from your Revolut Business account. The Secret key is used in the authorization header for all server calls, while the Public key is provided with payment methods at checkout."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For detailed instructions on generating your API keys, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/get-started#generate-api-keys","target":"_blank","rel":"noreferrer","children":"Generate API keys"}],"."]}]}]]}]]}] 10e5:T22fe,
{
  "id": "6633855a-0e4f-a768-8b2c-e765d8872505",
  "state": "captured",
  "created_at": "2024-05-02T12:21:46.638369Z",
  "updated_at": "2024-05-02T12:21:55.198089Z",
  "token": "0b277730-8b3c-48d4-ab63-8903f40ee520",
  "amount": 100,
  "currency": "GBP",
  "settled_amount": 77,
  "settled_currency": "GBP",
  "risk_level": "low",
  "fees": [
    {
      "type": "acquiring",
      "amount": 23,
      "currency": "GBP"
    }
  ],
  "payment_method": {
    "id": "6633855a-3b39-ad95-9782-cd1327ffa0e7",
    "type": "revolut_pay_card",
    "fingerprint": "1JAllfQY4POhBV8DaddAQ4LC5RbMP8LMLvUdJW4s5JY=",
    "card_brand": "visa",
    "funding": "credit",
    "card_country_code": "MT",
    "card_bin": "123456",
    "card_last_four": "1234",
    "card_expiry": "12/28",
    "cardholder_name": "Example Holder",
    "checks": {
      "three_ds": {
        "eci": "06",
        "state": "verified",
        "version": 2
      }
    }
  },
  "order_id": "66338534-28a7-a68e-b312-43722430df1b"
}
10d5:["$","div","200-application/json-revolut_pay_saved",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$10e5"}}]}]],"$L10e6"]}] 10e7:T1c75,
{
  "id": "66338688-fd73-a358-a82d-97da413c5325",
  "state": "captured",
  "created_at": "2024-05-02T12:26:48.134039Z",
  "updated_at": "2024-05-02T12:26:49.514594Z",
  "token": "8061e645-35e0-42bb-8318-603abaeab7b7",
  "amount": 100,
  "currency": "GBP",
  "settled_amount": 79,
  "settled_currency": "GBP",
  "billing_address": {
    "street_line_1": "123 Example Street",
    "street_line_2": "Building A, 3rd Floor",
    "city": "Example City",
    "region": "Example Region",
    "country_code": "GB",
    "postcode": "E14 4HD"
  },
  "risk_level": "low",
  "fees": [
    {
      "type": "acquiring",
      "amount": 21,
      "currency": "GBP"
    }
  ],
  "payment_method": {
    "type": "revolut_pay_account",
    "fingerprint": "1JAllfQY4POhBV8DaddAQ4LC5RbMP8LMLvUdJW4s5JY="
  },
  "order_id": "6633865d-d911-a98c-8715-425f8731640c"
}
10d6:["$","div","200-application/json-revolut_pay_not_saved",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$10e7"}}]}]],"$L10e8"]}] 10e9:T1c5a,
{
  "id": "66338688-fd73-a358-a82d-97da413c5325",
  "state": "declined",
  "created_at": "2024-05-02T12:26:48.134039Z",
  "updated_at": "2024-05-02T12:26:49.514594Z",
  "token": "8061e645-35e0-42bb-8318-603abaeab7b7",
  "amount": 100,
  "currency": "GBP",
  "settled_amount": 79,
  "settled_currency": "GBP",
  "billing_address": {
    "street_line_1": "123 Example Street",
    "street_line_2": "Building A, 3rd Floor",
    "city": "Example City",
    "region": "Example Region",
    "country_code": "GB",
    "postcode": "E14 4HD"
  },
  "risk_level": "low",
  "fees": [
    {
      "type": "acquiring",
      "amount": 21,
      "currency": "GBP"
    }
  ],
  "payment_method": {
    "type": "apple_tap_to_pay",
    "failure_reason": "pin_data_required"
  },
  "order_id": "6633865d-d911-a98c-8715-425f8731640c"
}
10d7:["$","div","200-application/json-apple_tap_to_pay",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$10e9"}}]}]],"$L10ea"]}] 10eb:T1c6b,
{
  "id": "66338688-fd73-a358-a82d-97da413c5325",
  "state": "captured",
  "created_at": "2024-05-02T12:26:48.134039Z",
  "updated_at": "2024-05-02T12:26:49.514594Z",
  "token": "8061e645-35e0-42bb-8318-603abaeab7b7",
  "amount": 100,
  "currency": "GBP",
  "settled_amount": 79,
  "settled_currency": "GBP",
  "billing_address": {
    "street_line_1": "123 Example Street",
    "street_line_2": "Building A, 3rd Floor",
    "city": "Example City",
    "region": "Example Region",
    "country_code": "GB",
    "postcode": "E14 4HD"
  },
  "risk_level": "low",
  "fees": [
    {
      "type": "acquiring",
      "amount": 21,
      "currency": "GBP"
    }
  ],
  "payment_method": {
    "type": "apple_pay",
    "fingerprint": "1JAllfQY4POhBV8DaddAQ4LC5RbMP8LMLvUdJW4s5JY="
  },
  "order_id": "6633865d-d911-a98c-8715-425f8731640c"
}
10d8:["$","div","200-application/json-apple_pay",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$10eb"}}]}]],"$L10ec"]}] 10ed:T1c6c,
{
  "id": "66338688-fd73-a358-a82d-97da413c5325",
  "state": "captured",
  "created_at": "2024-05-02T12:26:48.134039Z",
  "updated_at": "2024-05-02T12:26:49.514594Z",
  "token": "8061e645-35e0-42bb-8318-603abaeab7b7",
  "amount": 100,
  "currency": "GBP",
  "settled_amount": 79,
  "settled_currency": "GBP",
  "billing_address": {
    "street_line_1": "123 Example Street",
    "street_line_2": "Building A, 3rd Floor",
    "city": "Example City",
    "region": "Example Region",
    "country_code": "GB",
    "postcode": "E14 4HD"
  },
  "risk_level": "low",
  "fees": [
    {
      "type": "acquiring",
      "amount": 21,
      "currency": "GBP"
    }
  ],
  "payment_method": {
    "type": "google_pay",
    "fingerprint": "1JAllfQY4POhBV8DaddAQ4LC5RbMP8LMLvUdJW4s5JY="
  },
  "order_id": "6633865d-d911-a98c-8715-425f8731640c"
}
10d9:["$","div","200-application/json-google_pay",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$10ed"}}]}]],"$L10ee"]}] 10ef:T2e77,
{
  "id": "663387f1-1c2e-a295-b143-9f1fb1eec175",
  "state": "captured",
  "created_at": "2024-05-02T12:32:49.033945Z",
  "updated_at": "2024-05-02T12:32:57.003519Z",
  "token": "294358bf-3818-49b2-aacc-7ca971f52695",
  "amount": 100,
  "currency": "GBP",
  "settled_amount": 79,
  "settled_currency": "GBP",
  "billing_address": {
    "street_line_1": "123 Example Street",
    "street_line_2": "Building A, 3rd Floor",
    "city": "Example City",
    "region": "Example Region",
    "country_code": "GB",
    "postcode": "E14 4HD"
  },
  "risk_level": "low",
  "fees": [
    {
      "type": "acquiring",
      "amount": 21,
      "currency": "GBP"
    }
  ],
  "payment_method": {
    "id": "663387f1-c91e-a464-908a-1cc4548ebc6a",
    "type": "card",
    "fingerprint": "1JAllfQY4POhBV8DaddAQ4LC5RbMP8LMLvUdJW4s5JY=",
    "card_brand": "visa",
    "funding": "credit",
    "card_country_code": "GB",
    "card_bin": "123456",
    "card_last_four": "1234",
    "card_expiry": "12/30",
    "cardholder_name": "Test Holder",
    "checks": {
      "three_ds": {
        "eci": "06",
        "state": "verified",
        "version": 2
      },
      "cvv_verification": "match",
      "address": "match",
      "postcode": "match",
      "cardholder": "n_a"
    }
  },
  "order_id": "663387bd-8484-ac57-93a7-3751dc154bbc"
}
10da:["$","div","200-application/json-card_payment_saved",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$10ef"}}]}]],"$L10f0"]}] 10f1:T107c,
{
  "id": "63dd0e4a-42c4-a1a6-ab2c-6ac9d255ca4b",
  "state": "pending",
  "created_at": "2024-05-02T12:32:49.033945Z",
  "updated_at": "2024-05-02T12:32:57.003519Z",
  "token": "294358bf-3818-49b2-aacc-7ca971f52695",
  "amount": 100,
  "currency": "EUR",
  "risk_level": "low",
  "payment_method": {
    "type": "sepa_direct_debit",
    "debtor_iban_last_four": "1234",
    "debtor_name": "John Doe",
    "mandate_reference": "A1B2C3D4E5F6A1B2C3D4E5F6A1B2C3D4"
  },
  "order_id": "63dd0e3f-7b84-ab5c-927c-1a06f7c9583a"
}
10db:["$","div","200-application/json-sepa_direct_debit",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$10f1"}}]}]],"$L10f2"]}] 10f3:T2d4b,
{
  "id": "663387f1-1c2e-a295-b143-9f1fb1eec175",
  "state": "captured",
  "created_at": "2024-05-02T12:32:49.033945Z",
  "updated_at": "2024-05-02T12:32:57.003519Z",
  "token": "294358bf-3818-49b2-aacc-7ca971f52695",
  "amount": 100,
  "currency": "GBP",
  "settled_amount": 79,
  "settled_currency": "GBP",
  "billing_address": {
    "street_line_1": "123 Example Street",
    "street_line_2": "Building A, 3rd Floor",
    "city": "Example City",
    "region": "Example Region",
    "country_code": "GB",
    "postcode": "E14 4HD"
  },
  "risk_level": "low",
  "fees": [
    {
      "type": "acquiring",
      "amount": 21,
      "currency": "GBP"
    }
  ],
  "payment_method": {
    "type": "card",
    "fingerprint": "1JAllfQY4POhBV8DaddAQ4LC5RbMP8LMLvUdJW4s5JY=",
    "card_brand": "visa",
    "funding": "credit",
    "card_country_code": "GB",
    "card_bin": "123456",
    "card_last_four": "1234",
    "card_expiry": "12/30",
    "cardholder_name": "Test Holder",
    "checks": {
      "three_ds": {
        "eci": "06",
        "state": "verified",
        "version": 2
      },
      "cvv_verification": "match",
      "address": "match",
      "postcode": "match",
      "cardholder": "n_a"
    }
  },
  "order_id": "663387bd-8484-ac57-93a7-3751dc154bbc"
}
10dc:["$","div","200-application/json-card_payment_not_saved",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$10f3"}}]}]],"$L10f4"]}] 10dd:["$","div","400-application/json-example-1",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"
{\n  \"errorId\": \"94b27660-fdda-49ec-8b85-cd46a068ade0\",\n  \"timestamp\": 1601296792533\n}
"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"errorId\": \"94b27660-fdda-49ec-8b85-cd46a068ade0\",\n \"timestamp\": 1601296792533\n}"}]}]]}] 10f5:T471,
{
  "errorId": "94b27660-fdda-49ec-8b85-cd46a068ade0",
  "timestamp": 1601296792533,
  "code": 1024
}
10de:["$","div","404-application/json-example-1",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$10f5"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"errorId\": \"94b27660-fdda-49ec-8b85-cd46a068ade0\",\n \"timestamp\": 1601296792533,\n \"code\": 1024\n}"}]}]]}] 10e6:["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"id\": \"6633855a-0e4f-a768-8b2c-e765d8872505\",\n \"state\": \"captured\",\n \"created_at\": \"2024-05-02T12:21:46.638369Z\",\n \"updated_at\": \"2024-05-02T12:21:55.198089Z\",\n \"token\": \"0b277730-8b3c-48d4-ab63-8903f40ee520\",\n \"amount\": 100,\n \"currency\": \"GBP\",\n \"settled_amount\": 77,\n \"settled_currency\": \"GBP\",\n \"risk_level\": \"low\",\n \"fees\": [\n {\n \"type\": \"acquiring\",\n \"amount\": 23,\n \"currency\": \"GBP\"\n }\n ],\n \"payment_method\": {\n \"id\": \"6633855a-3b39-ad95-9782-cd1327ffa0e7\",\n \"type\": \"revolut_pay_card\",\n \"fingerprint\": \"1JAllfQY4POhBV8DaddAQ4LC5RbMP8LMLvUdJW4s5JY=\",\n \"card_brand\": \"visa\",\n \"funding\": \"credit\",\n \"card_country_code\": \"MT\",\n \"card_bin\": \"123456\",\n \"card_last_four\": \"1234\",\n \"card_expiry\": \"12/28\",\n \"cardholder_name\": \"Example Holder\",\n \"checks\": {\n \"three_ds\": {\n \"eci\": \"06\",\n \"state\": \"verified\",\n \"version\": 2\n }\n }\n },\n \"order_id\": \"66338534-28a7-a68e-b312-43722430df1b\"\n}"}]}] 10e8:["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"id\": \"66338688-fd73-a358-a82d-97da413c5325\",\n \"state\": \"captured\",\n \"created_at\": \"2024-05-02T12:26:48.134039Z\",\n \"updated_at\": \"2024-05-02T12:26:49.514594Z\",\n \"token\": \"8061e645-35e0-42bb-8318-603abaeab7b7\",\n \"amount\": 100,\n \"currency\": \"GBP\",\n \"settled_amount\": 79,\n \"settled_currency\": \"GBP\",\n \"billing_address\": {\n \"street_line_1\": \"123 Example Street\",\n \"street_line_2\": \"Building A, 3rd Floor\",\n \"city\": \"Example City\",\n \"region\": \"Example Region\",\n \"country_code\": \"GB\",\n \"postcode\": \"E14 4HD\"\n },\n \"risk_level\": \"low\",\n \"fees\": [\n {\n \"type\": \"acquiring\",\n \"amount\": 21,\n \"currency\": \"GBP\"\n }\n ],\n \"payment_method\": {\n \"type\": \"revolut_pay_account\",\n \"fingerprint\": \"1JAllfQY4POhBV8DaddAQ4LC5RbMP8LMLvUdJW4s5JY=\"\n },\n \"order_id\": \"6633865d-d911-a98c-8715-425f8731640c\"\n}"}]}] 10ea:["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"id\": \"66338688-fd73-a358-a82d-97da413c5325\",\n \"state\": \"declined\",\n \"created_at\": \"2024-05-02T12:26:48.134039Z\",\n \"updated_at\": \"2024-05-02T12:26:49.514594Z\",\n \"token\": \"8061e645-35e0-42bb-8318-603abaeab7b7\",\n \"amount\": 100,\n \"currency\": \"GBP\",\n \"settled_amount\": 79,\n \"settled_currency\": \"GBP\",\n \"billing_address\": {\n \"street_line_1\": \"123 Example Street\",\n \"street_line_2\": \"Building A, 3rd Floor\",\n \"city\": \"Example City\",\n \"region\": \"Example Region\",\n \"country_code\": \"GB\",\n \"postcode\": \"E14 4HD\"\n },\n \"risk_level\": \"low\",\n \"fees\": [\n {\n \"type\": \"acquiring\",\n \"amount\": 21,\n \"currency\": \"GBP\"\n }\n ],\n \"payment_method\": {\n \"type\": \"apple_tap_to_pay\",\n \"failure_reason\": \"pin_data_required\"\n },\n \"order_id\": \"6633865d-d911-a98c-8715-425f8731640c\"\n}"}]}] 10ec:["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"id\": \"66338688-fd73-a358-a82d-97da413c5325\",\n \"state\": \"captured\",\n \"created_at\": \"2024-05-02T12:26:48.134039Z\",\n \"updated_at\": \"2024-05-02T12:26:49.514594Z\",\n \"token\": \"8061e645-35e0-42bb-8318-603abaeab7b7\",\n \"amount\": 100,\n \"currency\": \"GBP\",\n \"settled_amount\": 79,\n \"settled_currency\": \"GBP\",\n \"billing_address\": {\n \"street_line_1\": \"123 Example Street\",\n \"street_line_2\": \"Building A, 3rd Floor\",\n \"city\": \"Example City\",\n \"region\": \"Example Region\",\n \"country_code\": \"GB\",\n \"postcode\": \"E14 4HD\"\n },\n \"risk_level\": \"low\",\n \"fees\": [\n {\n \"type\": \"acquiring\",\n \"amount\": 21,\n \"currency\": \"GBP\"\n }\n ],\n \"payment_method\": {\n \"type\": \"apple_pay\",\n \"fingerprint\": \"1JAllfQY4POhBV8DaddAQ4LC5RbMP8LMLvUdJW4s5JY=\"\n },\n \"order_id\": \"6633865d-d911-a98c-8715-425f8731640c\"\n}"}]}] 10ee:["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"id\": \"66338688-fd73-a358-a82d-97da413c5325\",\n \"state\": \"captured\",\n \"created_at\": \"2024-05-02T12:26:48.134039Z\",\n \"updated_at\": \"2024-05-02T12:26:49.514594Z\",\n \"token\": \"8061e645-35e0-42bb-8318-603abaeab7b7\",\n \"amount\": 100,\n \"currency\": \"GBP\",\n \"settled_amount\": 79,\n \"settled_currency\": \"GBP\",\n \"billing_address\": {\n \"street_line_1\": \"123 Example Street\",\n \"street_line_2\": \"Building A, 3rd Floor\",\n \"city\": \"Example City\",\n \"region\": \"Example Region\",\n \"country_code\": \"GB\",\n \"postcode\": \"E14 4HD\"\n },\n \"risk_level\": \"low\",\n \"fees\": [\n {\n \"type\": \"acquiring\",\n \"amount\": 21,\n \"currency\": \"GBP\"\n }\n ],\n \"payment_method\": {\n \"type\": \"google_pay\",\n \"fingerprint\": \"1JAllfQY4POhBV8DaddAQ4LC5RbMP8LMLvUdJW4s5JY=\"\n },\n \"order_id\": \"6633865d-d911-a98c-8715-425f8731640c\"\n}"}]}] 10f6:T527,{ "id": "663387f1-1c2e-a295-b143-9f1fb1eec175", "state": "captured", "created_at": "2024-05-02T12:32:49.033945Z", "updated_at": "2024-05-02T12:32:57.003519Z", "token": "294358bf-3818-49b2-aacc-7ca971f52695", "amount": 100, "currency": "GBP", "settled_amount": 79, "settled_currency": "GBP", "billing_address": { "street_line_1": "123 Example Street", "street_line_2": "Building A, 3rd Floor", "city": "Example City", "region": "Example Region", "country_code": "GB", "postcode": "E14 4HD" }, "risk_level": "low", "fees": [ { "type": "acquiring", "amount": 21, "currency": "GBP" } ], "payment_method": { "id": "663387f1-c91e-a464-908a-1cc4548ebc6a", "type": "card", "fingerprint": "1JAllfQY4POhBV8DaddAQ4LC5RbMP8LMLvUdJW4s5JY=", "card_brand": "visa", "funding": "credit", "card_country_code": "GB", "card_bin": "123456", "card_last_four": "1234", "card_expiry": "12/30", "cardholder_name": "Test Holder", "checks": { "three_ds": { "eci": "06", "state": "verified", "version": 2 }, "cvv_verification": "match", "address": "match", "postcode": "match", "cardholder": "n_a" } }, "order_id": "663387bd-8484-ac57-93a7-3751dc154bbc" }10f0:["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"$10f6"}]}] 10f2:["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"id\": \"63dd0e4a-42c4-a1a6-ab2c-6ac9d255ca4b\",\n \"state\": \"pending\",\n \"created_at\": \"2024-05-02T12:32:49.033945Z\",\n \"updated_at\": \"2024-05-02T12:32:57.003519Z\",\n \"token\": \"294358bf-3818-49b2-aacc-7ca971f52695\",\n \"amount\": 100,\n \"currency\": \"EUR\",\n \"risk_level\": \"low\",\n \"payment_method\": {\n \"type\": \"sepa_direct_debit\",\n \"debtor_iban_last_four\": \"1234\",\n \"debtor_name\": \"John Doe\",\n \"mandate_reference\": \"A1B2C3D4E5F6A1B2C3D4E5F6A1B2C3D4\"\n },\n \"order_id\": \"63dd0e3f-7b84-ab5c-927c-1a06f7c9583a\"\n}"}]}] 10f7:T4f5,{ "id": "663387f1-1c2e-a295-b143-9f1fb1eec175", "state": "captured", "created_at": "2024-05-02T12:32:49.033945Z", "updated_at": "2024-05-02T12:32:57.003519Z", "token": "294358bf-3818-49b2-aacc-7ca971f52695", "amount": 100, "currency": "GBP", "settled_amount": 79, "settled_currency": "GBP", "billing_address": { "street_line_1": "123 Example Street", "street_line_2": "Building A, 3rd Floor", "city": "Example City", "region": "Example Region", "country_code": "GB", "postcode": "E14 4HD" }, "risk_level": "low", "fees": [ { "type": "acquiring", "amount": 21, "currency": "GBP" } ], "payment_method": { "type": "card", "fingerprint": "1JAllfQY4POhBV8DaddAQ4LC5RbMP8LMLvUdJW4s5JY=", "card_brand": "visa", "funding": "credit", "card_country_code": "GB", "card_bin": "123456", "card_last_four": "1234", "card_expiry": "12/30", "cardholder_name": "Test Holder", "checks": { "three_ds": { "eci": "06", "state": "verified", "version": 2 }, "cvv_verification": "match", "address": "match", "postcode": "match", "cardholder": "n_a" } }, "order_id": "663387bd-8484-ac57-93a7-3751dc154bbc" }10f4:["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"$10f7"}]}] 10e4:["$","div","CodeBlock-0",{"className":"wzy01m0 _18b50nc0","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"
'Authorization: Bearer <yourSecretApiKey>'
"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"'Authorization: Bearer '\n"}]}]]}] 1175:T54c,Type of the transaction. | Value | Description | | ----- | ----------- | | `Settlement` | Settlement of a payment into the merchant balance. | | `Refund` | Refund entry reducing the merchant balance. | | `External transfer money return` | Return of an external transfer entry. | | `Topup` | Balance top-up entry. | | `Topup Return` | Reversal of a top-up entry. | | `Customer dispute - withdrawal` | Chargeback or dispute withdrawal from the merchant balance. | | `Customer dispute - won` | Reversal of a previous dispute withdrawal. | | `Transfer from linked pocket` | Transfer from a linked balance pocket. | | `Automatic negative balance recovery` | Automatic recovery entry for a negative balance. | | `Payout` | Payout-related ledger entry. | | `Payout to an external account` | Transfer of payout funds to an external account. | | `Transfer from linked pocket with FX` | Transfer from a linked pocket involving FX conversion. | | `Payout with FX` | Payout-related entry involving FX conversion. | | `Money reserve block` | Reserve block entry withholding funds. | | `Money reserve unblock` | Release of previously blocked reserve funds. | | `IC++ post-billing fee` | IC++ fee charged after billing. | | `Fee refund` | Reversal of a previously charged fee. | | `Unrecognised transaction` | Transaction that does not map to a more specific category. |11a2:T7af,transaction_id,order_id,original_order_id,started_date,updated_date,completed_date,payment_created_date,payment_captured_date,type,state,description,merchant_order_ext_ref,customer_id,amount,currency,settlement_amount,settlement_currency,payment_method,fee_amount,fee_currency,processing_fee_amount,processing_fee_currency,browser_url,location_id 67f66fa6-200c-aaef-8708-cb78366f8a30,67f66f41-3022-a623-827e-e0616c0d04e7,67f66f41-3022-a623-827e-e0616c0d04e7,2025-04-09T13:01:26.288638Z,2025-04-10T13:02:09.843018Z,2025-04-10T13:02:09.837719Z,2025-04-09T13:01:26.186Z,2025-04-10T13:02:09.837719Z,SETTLEMENT,COMPLETED,Summer hat,ORD-2025-0042,,100.00,GBP,99.00,GBP,CARD,1.00,GBP,1.00,GBP,https://sandbox-checkout.revolut.com/payment-link/1ae44a1c-3ea8-47ac-b736-7d7d4c992bb4, 67f66fb7-300d-bbff-9819-dc89477a9b41,67f67052-4133-b734-938f-f1727d1e15f8,67f66f41-3022-a623-827e-e0616c0d04e7,2025-04-10T09:10:00.000000Z,2025-04-10T09:12:00.000000Z,2025-04-10T09:12:00.000000Z,,,REFUND,COMPLETED,Refund for Summer hat,ORD-2025-0042-R1,,25.00,GBP,-25.00,GBP,CARD,0.00,GBP,0.00,GBP,https://sandbox-checkout.revolut.com/payment-link/1ae44a1c-3ea8-47ac-b736-7d7d4c992bb4, 67f66fc8-411e-cc10-a92a-ed9a588b0c52,67f67063-5244-c845-a49a-a2838e2f26a9,67f66f41-3022-a623-827e-e0616c0d04e7,2025-04-11T08:30:00.000000Z,2025-04-11T08:45:00.000000Z,2025-04-11T08:45:00.000000Z,,,CHARGEBACK,COMPLETED,Chargeback for Summer hat,ORD-2025-0042-CB1,,75.00,GBP,-75.00,GBP,CARD,0.00,GBP,0.00,GBP,https://sandbox-checkout.revolut.com/payment-link/1ae44a1c-3ea8-47ac-b736-7d7d4c992bb4, 67f66fd9-522f-dd21-ba3b-feab699a1d63,67f67074-6355-d956-b50a-a3949f3a37a0,67f66f41-3022-a623-827e-e0616c0d04e7,2025-04-15T10:00:00.000000Z,2025-04-15T10:05:00.000000Z,2025-04-15T10:05:00.000000Z,,,CHARGEBACK_REVERSAL,COMPLETED,Chargeback reversal for Summer hat,ORD-2025-0042-CBR1,,75.00,GBP,75.00,GBP,CARD,0.00,GBP,0.00,GBP,https://sandbox-checkout.revolut.com/payment-link/1ae44a1c-3ea8-47ac-b736-7d7d4c992bb4,11a3:T468,payment_id,type,description,original_payment_id,order_id,state,reason,amount,currency,surcharge_amount,tip_amount,refunded_amount,created_date,captured_date,merchant_order_ext_ref,payment_method,location_id,customer_id,customer_card_number,customer_card_country,customer_card_brand,customer_card_type,customer_card_category,customer_email,fee_amount,fee_currency 67f66fa6-7e98-ae73-9570-50583cec116d,PAYMENT,Payment from customer,,67f66f41-3022-a623-827e-e0616c0d04e7,COMPLETED,,1.00,GBP,,0.00,0.00,2025-04-09T13:01:26.186Z,2025-04-10T13:02:09.837Z,ORD-2025-0042,CARD,,cust-0001-0000-0000-000000000001,528143******4148,GB,VISA,DEBIT,consumer,customer@example.com,0.01,GBP 6807b0a5-a367-afbf-b31f-353730b788b5,PAYMENT,Payment from customer,,6807b09c-c62a-a656-818e-f071ef67ee36,DECLINED,,10.01,GBP,,0.00,0.00,2025-04-22T15:07:17.352Z,,,PAY_WITH_REVOLUT,,,,,,,,customer@example.com,, 67efa316-db8a-aec6-8eb4-46e47b6ebdc4,PAYMENT,Payment from customer,,67efa305-be19-a456-a6a2-154b218ac386,FAILED,INSUFFICIENT_FUNDS,0.57,USD,,0.00,0.00,2025-04-04T09:15:02.13Z,,,CARD,,,222300******9399,GB,VISA,DEBIT,consumer,customer@example.com,,11a4:T5f7,created_date,completed_date,payout_affected_date,affected_payout_amount,transaction_id,order_id,dispute_id,merchant_order_reference,type,related_icpp_charge_id,transaction_amount,transaction_currency,billing_amount,billing_currency,state,original_transaction_id,original_transaction_amount,original_transaction_currency,original_order_id,original_order_channel,original_merchant_order_reference,fee_amount,fee_currency,settlement_amount,settlement_currency,location_id,location_name,submerchant_id,payout_transfer_reference,payout_total_amount,payout_date 2025-03-25T14:34:05.708899Z,2025-03-26T14:34:38.06903Z,2025-03-26T14:34:38.06903Z,true,67e2bedd-0e79-a8ea-ac4c-e9fd13693286,67e2be76-89c5-ae4f-9103-a152ae6f0584,,ORD-2025-0042,Settlement,,0.57,USD,0.57,USD,COMPLETED,67e2bedd-0e79-a8ea-ac4c-e9fd13693286,0.57,USD,67e2be76-89c5-ae4f-9103-a152ae6f0584,API,ORD-2025-0042,0.00,USD,0.57,USD,4a0f98a6-0f61-4e85-9ef0-7e5d0cb92ef0,Store London,,Revolut USD payout 2025-03-26 MerchantName,0.17,2025-03-26T15:00:00Z 2025-03-25T15:38:45.162946Z,2025-03-26T15:39:58.03824Z,2025-03-26T15:39:58.03824Z,true,67e2ce05-1a16-abeb-b05b-5059073bcdaa,67e2ce00-6665-a52b-9f10-368f886054d7,a81bba54-e3f9-450f-aa50-7aea8e4e5b9a,ORD-2025-0042-CB1,Customer dispute - withdrawal,,-0.40,USD,-0.40,USD,COMPLETED,67e2bedd-0e79-a8ea-ac4c-e9fd13693286,0.57,USD,67e2be76-89c5-ae4f-9103-a152ae6f0584,API,ORD-2025-0042,0.00,USD,-0.40,USD,4a0f98a6-0f61-4e85-9ef0-7e5d0cb92ef0,Store London,,Revolut USD payout 2025-03-26 MerchantName,0.17,2025-03-26T15:00:00Z55:["$","$7a","download-report-file",{"children":[["$","section",null,{"className":"y9a0do0","data-variant":"endpoint","children":["$","$L7b",null,{"responses":{"200":{"description":"OK","content":{"text/csv":{"schema":{"oneOf":[{"title":"Settlement report CSV","type":"object","description":"CSV output for `settlement_report`. Contains settled transactions associated with a Merchant account.\n\nThe first row is a header row with column names. Subsequent rows contain transaction data, one row per transaction.\n\nA partial-settlement is represented by separate `SETTLEMENT` and `REFUND` rows instead of a dedicated type.\n\n:::note\nThe actual response is a raw `text/csv` string. The object schema below is a documentation convention only: OpenAPI's schema language (JSON Schema) describes JSON data shapes and has no native construct for typed CSV columns, so each property here corresponds to a CSV column header rather than a JSON field.\n:::","properties":{"transaction_id":{"type":"string","format":"uuid","description":"Unique identifier of the ledger transaction in the core settlement system. Matches `transaction_id` in the payout statement report for the same event. Not the same as `payment_id` in the payments report — a payment and its resulting ledger transaction have different UUIDs. Use `order_id` to cross-reference with the payments report.","descriptionNode":"$L10f8"},"order_id":{"type":"string","format":"uuid","description":"Unique identifier of the order. An order is the top-level entity that groups one or more payment attempts against it. `order_id` is consistent across all report types and can be used to cross-reference between the payments report and the settlement or payout reports.","descriptionNode":"$L10f9"},"original_order_id":{"type":"string","format":"uuid","description":"For refunds and chargebacks, the order ID of the original payment that this transaction reverses. Refunds and chargebacks create their own order in the system, so `order_id` refers to the refund or chargeback order while `original_order_id` points back to the original payment's order. For settlement transactions, matches `order_id`.","descriptionNode":"$L10fa"},"started_date":{"type":"string","format":"date-time","description":"Date and time the row's source record was started. For payment rows, this is the payment start timestamp. For non-payment rows such as refunds and chargebacks, this is the transaction start timestamp. This displayed value is separate from the report filter timeframe.","descriptionNode":"$L10fb"},"updated_date":{"type":"string","format":"date-time","description":"Date and time the row's source record was last updated. For payment rows, this is the payment update timestamp. For non-payment rows such as refunds and chargebacks, this is the transaction update timestamp. This displayed value is separate from the report filter timeframe.","descriptionNode":"$L10fc"},"completed_date":{"type":"string","format":"date-time","description":"Date and time the row's source record was completed. For payment rows, this is the payment completion timestamp. For non-payment rows such as refunds and chargebacks, this is the transaction completion timestamp. This displayed value is separate from the report filter timeframe.","descriptionNode":"$L10fd"},"payment_created_date":{"type":"string","format":"date-time","description":"Payment authorisation or creation timestamp for rows linked to a payment, in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) UTC date-time format. Empty for refunds and non-payment-related rows where no payment timestamp applies. This displayed value is separate from the report filter timeframe.","descriptionNode":"$L10fe"},"payment_captured_date":{"type":"string","format":"date-time","description":"Payment capture timestamp for rows linked to a captured payment, in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) UTC date-time format. Empty for refunds, non-payment-related rows, or payments not captured. This displayed value is separate from the report filter timeframe.","descriptionNode":"$L10ff"},"type":{"type":"string","description":"Type of the settlement report row.\n\nA partial-settlement is represented by separate `SETTLEMENT` and `REFUND` rows instead of a dedicated type.\n\n| Value | Description |\n| ----- | ----------- |\n| `SETTLEMENT` | Settlement of a payment into the merchant balance. |\n| `REFUND` | Refund entry reducing the merchant balance. |\n| `CHARGEBACK` | Dispute withdrawal entry reducing the merchant balance. |\n| `CHARGEBACK_REVERSAL` | Reversal of a previous chargeback, restoring funds to the merchant balance. |","enum":["SETTLEMENT","REFUND","CHARGEBACK","CHARGEBACK_REVERSAL"],"descriptionNode":"$L1100"},"state":{"type":"string","description":"State of the transaction.","descriptionNode":"$L1101"},"description":{"type":"string","description":"Description of the order.","descriptionNode":"$L1102"},"merchant_order_ext_ref":{"type":"string","description":"Merchant's order reference. The value of the `merchant_order_data.reference` field set when the order was created.","descriptionNode":"$L1103"},"customer_id":{"type":"string","format":"uuid","description":"Unique identifier of the customer related to an order.","descriptionNode":"$L1104"},"amount":{"type":"number","description":"Total amount of the order.","descriptionNode":"$L1105"},"currency":{"type":"string","description":"The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) currency code that represents the currency of the order.","examples":["GBP"],"descriptionNode":"$L1106"},"settlement_amount":{"type":"number","description":"Total amount settled on the merchant's account.","descriptionNode":"$L1107"},"settlement_currency":{"type":"string","description":"The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) currency code that represents the currency of the settled amount.","examples":["GBP"],"descriptionNode":"$L1108"},"payment_method":{"type":"string","description":"Type of the payment method the customer used to pay for the order.","examples":["CARD"],"descriptionNode":"$L1109"},"fee_amount":{"type":"number","description":"Total fee amount applied to the order, aggregated across all fee components (acquiring markup + interchange + scheme fees).","descriptionNode":"$L110a"},"fee_currency":{"type":"string","description":"The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) currency code that represents the currency of the total fee.","examples":["GBP"],"descriptionNode":"$L110b"},"processing_fee_amount":{"type":"number","description":"Acquiring markup fee only — a subset of `fee_amount`. Represents Revolut's service fee, excluding interchange and scheme fees.","descriptionNode":"$L110c"},"processing_fee_currency":{"type":"string","description":"The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) currency code that represents the currency of the acquiring markup fee.","examples":["GBP"],"descriptionNode":"$L110d"},"browser_url":{"type":"string","format":"uri","description":"The URL where the customer initiated the payment.","descriptionNode":"$L110e"},"location_id":{"type":"string","format":"uuid","description":"Unique identifier of the location related to the transaction.","descriptionNode":"$L110f"}},"descriptionNode":"$L1110"},{"title":"Custom report CSV","type":"object","description":"CSV output for `custom_report` report type. Contains settled and processing transactions with a configurable set of columns.\n\nThe first row is a header row with column names. Subsequent rows contain transaction data, one row per transaction.\n\nThe columns included in the response depend on the `options.columns` list specified in the request. If no columns list was provided, all available columns are included.\n\nCustom metadata columns can also be requested using the `metadata.` prefix, for example `metadata.custom_attribute`.\n\n:::note\nThe actual response is a raw `text/csv` string. The object schema below is a documentation convention only: OpenAPI's schema language (JSON Schema) describes JSON data shapes and has no native construct for typed CSV columns, so each property here corresponds to a CSV column header rather than a JSON field.\n:::","properties":{"transaction_id":{"type":"string","format":"uuid","description":"Unique identifier of the ledger transaction in the core settlement system. Matches `transaction_id` in the settlement and payout reports for the same event. Not the same as `payment_id` in the payments report — a payment and its resulting ledger transaction have different UUIDs. Use `order_id` to cross-reference with the payments report.","descriptionNode":"$L1111"},"related_transaction_id":{"type":"string","format":"uuid","description":"For refund and chargeback transactions, the ledger transaction ID of the original payment that this transaction reverses. Corresponds to `original_transaction_id` in the payout statement report.","descriptionNode":"$L1112"},"transaction_description":{"type":"string","description":"Description of the transaction.","descriptionNode":"$L1113"},"order_id":{"type":"string","format":"uuid","description":"Unique identifier of the order. An order is the top-level entity that groups one or more payment attempts against it. `order_id` is consistent across all report types and can be used to cross-reference between the payments report and the settlement or payout reports.","descriptionNode":"$L1114"},"original_order_id":{"type":"string","format":"uuid","description":"For refunds and chargebacks, the order ID of the original payment that this transaction reverses. Refunds and chargebacks create their own order in the system, so `order_id` refers to the refund or chargeback order while `original_order_id` points back to the original payment's order. For settlement transactions, matches `order_id`.","descriptionNode":"$L1115"},"original_order_ext_ref":{"type":"string","description":"Merchant's order identifier of the original order for external reference.","descriptionNode":"$L1116"},"order_description":{"type":"string","description":"Description of the order.","descriptionNode":"$L1117"},"order_channel":{"type":"string","description":"Channel through which the order was created.\n\nThe value depends on the order source and integration. It may reflect platform-specific or externally provided values, so the set of returned values should not be treated as a fixed enum.","descriptionNode":"$L1118"},"order_customer_note":{"type":"string","description":"Note added by the customer at the time of the order.","descriptionNode":"$L1119"},"order_tip_amount":{"type":"number","description":"Tip amount set at the order level.","descriptionNode":"$L111a"},"order_created_by":{"type":"string","description":"Identifier of the user who created the order.","descriptionNode":"$L111b"},"payment_initiated_by":{"type":"string","description":"Identifier of who initiated the payment.","descriptionNode":"$L111c"},"order_line_items":{"type":"string","description":"Line items included in the order, if any.","descriptionNode":"$L111d"},"payout_id":{"type":"string","format":"uuid","description":"Unique identifier of the payout that this transaction contributed to. Use to cross-reference with the payout statement report.","descriptionNode":"$L111e"},"payout_reference":{"type":"string","description":"Reference of the payout transfer associated with the transaction.","descriptionNode":"$L111f"},"invoice_reference":{"type":"string","description":"Invoice reference associated with the order, if any.","descriptionNode":"$L1120"},"dispute_id":{"type":"string","format":"uuid","description":"Unique identifier of the dispute, if applicable.","descriptionNode":"$L1121"},"account_id":{"type":"string","format":"uuid","description":"Unique identifier of the merchant account.","descriptionNode":"$L1122"},"account_balance":{"type":"number","description":"Account balance at the time of the transaction.","descriptionNode":"$L1123"},"started_date":{"type":"string","format":"date-time","description":"Date and time the row's source record was started. For payment rows, this is the payment start timestamp. For non-payment rows such as refunds and chargebacks, this is the transaction start timestamp. This displayed value is separate from the report filter timeframe.","descriptionNode":"$L1124"},"created_date":{"type":"string","format":"date-time","description":"Date and time the order was created.","descriptionNode":"$L1125"},"updated_date":{"type":"string","format":"date-time","description":"Date and time the row's source record was last updated. For payment rows, this is the payment update timestamp. For non-payment rows such as refunds and chargebacks, this is the transaction update timestamp. This displayed value is separate from the report filter timeframe.","descriptionNode":"$L1126"},"completed_date":{"type":"string","format":"date-time","description":"Date and time the row's source record was completed. For payment rows, this is the payment completion timestamp. For non-payment rows such as refunds and chargebacks, this is the transaction completion timestamp. This displayed value is separate from the report filter timeframe.","descriptionNode":"$L1127"},"payment_created_date":{"type":"string","format":"date-time","description":"Payment authorisation or creation timestamp for rows linked to a payment, in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) UTC date-time format. Empty for refunds and non-payment-related rows where no payment timestamp applies. This displayed value is separate from the report filter timeframe.","descriptionNode":"$L1128"},"payment_captured_date":{"type":"string","format":"date-time","description":"Payment capture timestamp for rows linked to a captured payment, in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) UTC date-time format. Empty for refunds, non-payment-related rows, or payments not captured. This displayed value is separate from the report filter timeframe.","descriptionNode":"$L1129"},"type":{"type":"string","description":"Type of the transaction.\n\n| Value | Description |\n| ----- | ----------- |\n| `SETTLEMENT` | Settlement of a payment into the merchant balance. |\n| `RESERVE` | Reserve entry holding funds on the merchant balance. |\n| `REFUND` | Refund entry reducing the merchant balance. |\n| `TOPUP` | Balance top-up entry. |\n| `TOPUP_RETURN` | Reversal of a top-up entry. |\n| `CHARGEBACK` | Dispute withdrawal from the merchant balance. |\n| `CHARGEBACK_REVERSAL` | Reversal of a previous chargeback. |\n| `CREDIT_REIMBURSEMENT` | Credit reimbursement entry. |\n| `FEE` | Fee charged against the merchant balance. |\n| `PAYOUT` | Payout-related ledger entry. |\n| `TRANSFER` | Balance transfer entry. |\n| `REVOLUT_REFUND` | Refund-related entry specific to Revolut internal flows. |\n| `REVOLUT_FEE` | Fee-related entry specific to Revolut internal flows. |\n| `WRITE_OFF` | Write-off entry. |\n| `CHARGE` | Charge entry posted to the merchant balance. |","enum":["SETTLEMENT","RESERVE","REFUND","TOPUP","TOPUP_RETURN","CHARGEBACK","CHARGEBACK_REVERSAL","CREDIT_REIMBURSEMENT","FEE","PAYOUT","TRANSFER","REVOLUT_REFUND","REVOLUT_FEE","WRITE_OFF","CHARGE"],"descriptionNode":"$L112a"},"legacy_type":{"type":"string","description":"Legacy type value for backwards compatibility.","descriptionNode":"$L112b"},"state":{"type":"string","description":"State of the transaction.","descriptionNode":"$L112c"},"description":{"type":"string","description":"Description of the transaction.","descriptionNode":"$L112d"},"merchant_order_ext_ref":{"type":"string","description":"Merchant's order reference. The value of the `merchant_order_data.reference` field set when the order was created.","descriptionNode":"$L112e"},"customer_id":{"type":"string","format":"uuid","description":"Unique identifier of the customer related to the order.","descriptionNode":"$L112f"},"amount":{"type":"number","description":"Total amount of the order.","descriptionNode":"$L1130"},"currency":{"type":"string","description":"The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) currency code of the order.","examples":["GBP"],"descriptionNode":"$L1131"},"settlement_amount":{"type":"number","description":"Total amount settled on the merchant's account.","descriptionNode":"$L1132"},"settlement_currency":{"type":"string","description":"The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) currency code of the settled amount.","examples":["GBP"],"descriptionNode":"$L1133"},"exchange_rate":{"type":"number","description":"Exchange rate applied if currency conversion occurred.","descriptionNode":"$L1134"},"refunded_amount":{"type":"number","description":"Amount refunded for the order.","descriptionNode":"$L1135"},"statement_descriptor":{"type":"string","description":"Statement descriptor shown on the customer's bank statement.","descriptionNode":"$L1136"},"tip_amount":{"type":"number","description":"Tip amount included in the transaction.","descriptionNode":"$L1137"},"surcharge_amount":{"type":"number","description":"Surcharge amount applied to the transaction. Omitted when no surcharge applies.","descriptionNode":"$L1138"},"order_surcharge_amount":{"type":"number","description":"Surcharge amount set at the order level.","descriptionNode":"$L1139"},"terminal_hardware_id":{"type":"string","description":"Identifier of the card reader hardware used, for in-person payments.","descriptionNode":"$L113a"},"customer_name":{"type":"string","description":"Name of the customer.","descriptionNode":"$L113b"},"customer_email":{"type":"string","format":"email","description":"Email address of the customer.","descriptionNode":"$L113c"},"customer_card_number":{"type":"string","description":"Masked card number used for the payment.","examples":["492942******5709"],"descriptionNode":"$L113d"},"customer_card_brand":{"type":"string","description":"Card brand used for the payment. Derived from BIN data. Example values include `VISA`, `MASTERCARD`, `MASTERCARD_DEBIT`, `MAESTRO`, `AMEX`, `DINERS`, `DISCOVER`, `JCB`.","examples":["VISA"],"descriptionNode":"$L113e"},"customer_card_type":{"type":"string","description":"Card funding type.\n\n| Value | Description |\n| ----- | ----------- |\n| `DEBIT` | Debit card. |\n| `CREDIT` | Credit card. |\n| `PREPAID` | Prepaid card. |\n| `DEFERRED_DEBIT` | Deferred debit card. |\n| `CHARGE` | Charge card. |","enum":["DEBIT","CREDIT","PREPAID","DEFERRED_DEBIT","CHARGE"],"descriptionNode":"$L113f"},"customer_card_category":{"type":"string","description":"Card commercial category.\n\n| Value | Description |\n| ----- | ----------- |\n| `consumer` | Personal card. |\n| `commercial` | Business or corporate card. |","enum":["consumer","commercial"],"descriptionNode":"$L1140"},"payment_method":{"type":"string","description":"Payment method the customer used to pay for the order.","examples":["CARD"],"descriptionNode":"$L1141"},"fee_amount":{"type":"number","description":"Total fee amount applied to the order, aggregated across all fee components (acquiring markup + interchange + scheme fees).","descriptionNode":"$L1142"},"fee_currency":{"type":"string","description":"The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) currency code of the total fee.","examples":["GBP"],"descriptionNode":"$L1143"},"processing_fee_amount":{"type":"number","description":"Acquiring markup fee only — a subset of `fee_amount`. Represents Revolut's service fee, excluding interchange and scheme fees.","descriptionNode":"$L1144"},"processing_fee_currency":{"type":"string","description":"The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) currency code of the acquiring markup fee.","examples":["GBP"],"descriptionNode":"$L1145"},"fx_fee_amount":{"type":"number","description":"Foreign exchange fee amount, if applicable.","descriptionNode":"$L1146"},"fx_fee_currency":{"type":"string","description":"The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) currency code of the FX fee.","examples":["GBP"],"descriptionNode":"$L1147"},"browser_url":{"type":"string","format":"uri","description":"The URL where the customer initiated the payment.","descriptionNode":"$L1148"},"beneficiary_name":{"type":"string","description":"Name of the beneficiary, for bank transfer payments.","descriptionNode":"$L1149"},"beneficiary_account_number":{"type":"string","description":"Account number of the beneficiary, for bank transfer payments.","descriptionNode":"$L114a"},"location_id":{"type":"string","format":"uuid","description":"Unique identifier of the location related to the transaction.","descriptionNode":"$L114b"},"location_name":{"type":"string","description":"Name of the location related to the transaction.","descriptionNode":"$L114c"},"order_custom_field_name":{"type":"string","description":"Name of a custom field set on the order.","descriptionNode":"$L114d"},"order_custom_field_value":{"type":"string","description":"Value of a custom field set on the order.","descriptionNode":"$L114e"},"offline_payment_state":{"type":"string","description":"State of an offline payment, if applicable.","descriptionNode":"$L114f"},"order_authorisation_type":{"type":"string","description":"Authorisation type of the order, for example `FULL` or `PRE_AUTH`.","descriptionNode":"$L1150"}},"descriptionNode":"$L1151"},{"title":"Payments report CSV","type":"object","description":"CSV output for `payments_report` report type. Contains all payments including failed and declined ones.\n\nThe first row is a header row with column names. Subsequent rows contain payment data, one row per payment.\n\nFor failed and declined payments, `fee_amount` and `fee_currency` are omitted. For payments made without a card, card-related columns are omitted.\n\n:::note\nThe actual response is a raw `text/csv` string. The object schema below is a documentation convention only: OpenAPI's schema language (JSON Schema) describes JSON data shapes and has no native construct for typed CSV columns, so each property here corresponds to a CSV column header rather than a JSON field.\n:::","properties":{"payment_id":{"type":"string","format":"uuid","description":"Unique identifier of the payment attempt in the acquiring system. Corresponds to `id` in the IC++ fee breakdown report for the same payment. Not the same as `transaction_id` in the settlement or payout reports — a payment and its resulting ledger transaction have different UUIDs. Use `order_id` to cross-reference with the settlement or payout reports.","descriptionNode":"$L1152"},"type":{"type":"string","description":"Type of the payment.\n\n| Value | Description |\n| ----- | ----------- |\n| `PAYMENT` | A payment attempt made against the order. |\n| `REFUND` | A refund record reversing a previously completed payment. |","enum":["PAYMENT","REFUND"],"descriptionNode":"$L1153"},"description":{"type":"string","description":"Description of the payment.","descriptionNode":"$L1154"},"original_payment_id":{"type":"string","format":"uuid","description":"For refunds, the acquiring ID of the original payment that this record reverses. Corresponds to `payment_id` on the original payment row. Populated only when `type` is `REFUND`.","descriptionNode":"$L1155"},"order_id":{"type":"string","format":"uuid","description":"Unique identifier of the order associated with this payment. An order can have multiple payment attempts — for example, a retry after a declined payment. Use `order_id` to cross-reference with the settlement or payout reports.","descriptionNode":"$L1156"},"state":{"type":"string","description":"State of the payment.\n\n| Value | Description |\n| ----- | ----------- |\n| `COMPLETED` | The payment completed successfully. |\n| `FAILED` | The payment failed during processing. |\n| `DECLINED` | The payment was rejected by the issuer or payment flow. |\n| `CANCELLED` | The payment was cancelled before completion. |\n| `PROCESSING` | The payment is still being processed. |","enum":["COMPLETED","FAILED","DECLINED","CANCELLED","PROCESSING"],"descriptionNode":"$L1157"},"reason":{"type":"string","description":"Reason code for a failed or declined payment. Present only when `state` is `FAILED` or `DECLINED`.\n\nExample values: `INSUFFICIENT_FUNDS`, `DO_NOT_HONOUR`, `EXPIRED_CARD`, `INVALID_CVV`, `THREE_DS_CHALLENGE_FAILED`, `SUSPECTED_FRAUD`, `LOST_CARD`, `STOLEN_CARD`, `TECHNICAL_ERROR`.","descriptionNode":"$L1158"},"amount":{"type":"number","description":"Total amount of the payment.","descriptionNode":"$L1159"},"currency":{"type":"string","description":"The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) currency code of the payment.","examples":["GBP"],"descriptionNode":"$L115a"},"surcharge_amount":{"type":"number","description":"Surcharge amount applied to the payment. Empty when no surcharge applies — this field is empty, not set to `0`.","descriptionNode":"$L115b"},"tip_amount":{"type":"number","description":"Tip amount included in the payment, if any.","descriptionNode":"$L115c"},"refunded_amount":{"type":"number","description":"Amount refunded for the payment.","descriptionNode":"$L115d"},"created_date":{"type":"string","format":"date-time","description":"Date and time the payment was created.","descriptionNode":"$L115e"},"captured_date":{"type":"string","format":"date-time","description":"Date and time the payment was captured, in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) UTC date-time format. Empty when the payment has not been captured.","descriptionNode":"$L115f"},"merchant_order_ext_ref":{"type":"string","description":"Merchant's order reference. The value of the `merchant_order_data.reference` field set when the order was created.","descriptionNode":"$L1160"},"payment_method":{"type":"string","description":"Payment method used.","examples":["CARD"],"descriptionNode":"$L1161"},"location_id":{"type":"string","format":"uuid","description":"Unique identifier of the location where the payment was made.","descriptionNode":"$L1162"},"customer_id":{"type":"string","format":"uuid","description":"Unique identifier of the customer.","descriptionNode":"$L1163"},"customer_card_number":{"type":"string","description":"Masked card number used for the payment.","examples":["492942******5709"],"descriptionNode":"$L1164"},"customer_card_country":{"type":"string","description":"Country of the card used for the payment, as an [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) code.","examples":["GB"],"descriptionNode":"$L1165"},"customer_card_brand":{"type":"string","description":"Card brand used for the payment. Derived from BIN data. Example values include `VISA`, `MASTERCARD`, `MASTERCARD_DEBIT`, `MAESTRO`, `AMEX`, `DINERS`, `DISCOVER`, `JCB`.","examples":["VISA"],"descriptionNode":"$L1166"},"customer_card_type":{"type":"string","description":"Card funding type.\n\n| Value | Description |\n| ----- | ----------- |\n| `DEBIT` | Debit card. |\n| `CREDIT` | Credit card. |\n| `PREPAID` | Prepaid card. |\n| `DEFERRED_DEBIT` | Deferred debit card. |\n| `CHARGE` | Charge card. |","enum":["DEBIT","CREDIT","PREPAID","DEFERRED_DEBIT","CHARGE"],"descriptionNode":"$L1167"},"customer_card_category":{"type":"string","description":"Card commercial category.\n\n| Value | Description |\n| ----- | ----------- |\n| `consumer` | Personal card. |\n| `commercial` | Business or corporate card. |","enum":["consumer","commercial"],"descriptionNode":"$L1168"},"customer_email":{"type":"string","format":"email","description":"Email address of the customer.","descriptionNode":"$L1169"},"fee_amount":{"type":"number","description":"Total fee amount charged for the payment. Omitted for failed and declined payments.","descriptionNode":"$L116a"},"fee_currency":{"type":"string","description":"The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) currency code of the fee. Omitted for failed and declined payments.","examples":["GBP"],"descriptionNode":"$L116b"}},"descriptionNode":"$L116c"},{"title":"Payout statement report CSV","type":"object","description":"CSV output for `payout_statement_report` report type. Contains all transactions that contributed to a specific payout.\n\nThe first row is a header row with column names. Subsequent rows contain transaction data, one row per transaction.\n\n:::note\nThe actual response is a raw `text/csv` string. The object schema below is a documentation convention only: OpenAPI's schema language (JSON Schema) describes JSON data shapes and has no native construct for typed CSV columns, so each property here corresponds to a CSV column header rather than a JSON field.\n:::","properties":{"created_date":{"type":"string","format":"date-time","description":"Date and time the transaction was created.","descriptionNode":"$L116d"},"completed_date":{"type":"string","format":"date-time","description":"Date and time the transaction was completed.","descriptionNode":"$L116e"},"payout_affected_date":{"type":"string","format":"date-time","description":"Date and time the payout was affected by this transaction.","descriptionNode":"$L116f"},"affected_payout_amount":{"type":"boolean","description":"Indicates whether this transaction contributed to the payout amount (`true`) or not (`false`).\n\nNote: despite the name implying a monetary amount, this field is a boolean flag. A rename is planned for a future API version.","descriptionNode":"$L1170"},"transaction_id":{"type":"string","format":"uuid","description":"Unique identifier of the ledger transaction in the core settlement system. Matches `transaction_id` in the settlement report for the same event. Use `order_id` to cross-reference with the payments report.","descriptionNode":"$L1171"},"order_id":{"type":"string","format":"uuid","description":"Unique identifier of the order associated with this transaction. Use `order_id` to cross-reference with the payments report or settlement report.","descriptionNode":"$L1172"},"dispute_id":{"type":"string","format":"uuid","description":"Unique identifier of the dispute associated with a chargeback or chargeback reversal transaction. Empty for rows not related to a dispute.","descriptionNode":"$L1173"},"merchant_order_reference":{"type":"string","description":"Merchant's order reference. The value of the `merchant_order_data.reference` field set when the order was created.","descriptionNode":"$L1174"},"type":{"type":"string","description":"$1175","enum":["Settlement","Refund","External transfer money return","Topup","Topup Return","Customer dispute - withdrawal","Customer dispute - won","Transfer from linked pocket","Automatic negative balance recovery","Payout","Payout to an external account","Transfer from linked pocket with FX","Payout with FX","Money reserve block","Money reserve unblock","IC++ post-billing fee","Fee refund","Unrecognised transaction"],"descriptionNode":"$L1176"},"related_icpp_charge_id":{"type":"string","format":"uuid","description":"Unique identifier of the IC++ charge related to the transaction, if applicable.","descriptionNode":"$L1177"},"transaction_amount":{"type":"number","description":"Amount of the transaction in the transaction currency.","descriptionNode":"$L1178"},"transaction_currency":{"type":"string","description":"The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) currency code of the transaction.","examples":["GBP"],"descriptionNode":"$L1179"},"billing_amount":{"type":"number","description":"Amount of the transaction in the billing currency.","descriptionNode":"$L117a"},"billing_currency":{"type":"string","description":"The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) currency code of the billing amount.","examples":["GBP"],"descriptionNode":"$L117b"},"state":{"type":"string","description":"State of the transaction.","examples":["COMPLETED"],"descriptionNode":"$L117c"},"original_transaction_id":{"type":"string","format":"uuid","description":"For refunds and chargebacks, the ledger transaction ID of the original payment that this transaction reverses. Corresponds to `transaction_id` on the original settlement row. \n\n:::note\nPopulated only for reversal-type rows — for example, when `type` is `Refund` or `Customer dispute - withdrawal`.\n:::","descriptionNode":"$L117d"},"original_transaction_amount":{"type":"number","description":"Amount of the original transaction.","descriptionNode":"$L117e"},"original_transaction_currency":{"type":"string","description":"The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) currency code of the original transaction.","examples":["GBP"],"descriptionNode":"$L117f"},"original_order_id":{"type":"string","format":"uuid","description":"For refunds and chargebacks, the order ID of the original payment that this transaction reverses. Refunds and chargebacks create their own order in the system, so `order_id` refers to the refund or chargeback order while `original_order_id` points back to the original payment's order. For settlement transactions, matches `order_id`.","descriptionNode":"$L1180"},"original_order_channel":{"type":"string","description":"Channel through which the original order was created.\n\nThe value depends on the original order source and integration. It may reflect platform-specific or externally provided values, so the set of returned values should not be treated as a fixed enum.","examples":["API"],"descriptionNode":"$L1181"},"original_merchant_order_reference":{"type":"string","description":"Merchant's order reference for the original order. The value of the `merchant_order_data.reference` field set when the original order was created.","descriptionNode":"$L1182"},"fee_amount":{"type":"number","description":"Total fee amount charged for the transaction.","descriptionNode":"$L1183"},"fee_currency":{"type":"string","description":"The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) currency code of the fee.","examples":["GBP"],"descriptionNode":"$L1184"},"settlement_amount":{"type":"number","description":"Total amount settled on the merchant's account.","descriptionNode":"$L1185"},"settlement_currency":{"type":"string","description":"The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) currency code of the settled amount.","examples":["GBP"],"descriptionNode":"$L1186"},"location_id":{"type":"string","format":"uuid","description":"Unique identifier of the location associated with the transaction.","descriptionNode":"$L1187"},"location_name":{"type":"string","description":"Name of the location associated with the transaction.","descriptionNode":"$L1188"},"submerchant_id":{"type":"string","format":"uuid","description":"Unique identifier of the submerchant associated with the transaction.","descriptionNode":"$L1189"},"payout_transfer_reference":{"type":"string","description":"Reference of the bank transfer for this payout. This value is the same across all rows in the report, as each report covers a single payout.","descriptionNode":"$L118a"},"payout_total_amount":{"type":"number","description":"Total amount of this payout. This value is the same across all rows in the report, as each report covers a single payout.","descriptionNode":"$L118b"},"payout_date":{"type":"string","format":"date-time","description":"Date and time the payout covered by this report was created, in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) UTC date-time format. This value is the same across all rows in the report, as each report covers a single payout.","descriptionNode":"$L118c"}},"descriptionNode":"$L118d"},{"title":"IC++ fee breakdown report CSV","type":"object","description":"CSV output for `icpp_fee_breakdown_report` report type. Contains IC++ fee components broken down per transaction for a specific IC++ charge.\n\nThe first row is a header row with column names. Subsequent rows contain one row per transaction.\n\n`card_interchange_fee_amount` and `card_scheme_fee_amount` are omitted for Revolut Pay transactions.\n\n:::note\nThe actual response is a raw `text/csv` string. The object schema below is a documentation convention only: OpenAPI's schema language (JSON Schema) describes JSON data shapes and has no native construct for typed CSV columns, so each property here corresponds to a CSV column header rather than a JSON field.\n\n`payment_method` in this report returns `REVOLUT_PAY` for Revolut Pay transactions. Other reports use `PAY_WITH_REVOLUT` for the same payment method.\n:::","properties":{"id":{"type":"string","format":"uuid","description":"Unique identifier of the payment in the acquiring system. Corresponds to `payment_id` in the payments report for the same payment.","descriptionNode":"$L118e"},"created_at":{"type":"string","format":"date-time","description":"Date and time the payment was created.","descriptionNode":"$L118f"},"operation":{"type":"string","description":"Type of the IC++ transaction.\n\n| Value | Description |\n| ----- | ----------- |\n| `SALE` | Fee breakdown for a payment sale. |\n| `REFUND` | Fee breakdown for a refund. |\n| `DISPUTE` | Fee breakdown for a dispute-related transaction. |","enum":["SALE","REFUND","DISPUTE"],"descriptionNode":"$L1190"},"amount":{"type":"number","description":"Transaction amount.","descriptionNode":"$L1191"},"currency":{"type":"string","description":"The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) currency code of the transaction.","examples":["GBP"],"descriptionNode":"$L1192"},"settlement_amount":{"type":"number","description":"Amount settled on the merchant's account.","descriptionNode":"$L1193"},"settlement_currency":{"type":"string","description":"The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) currency code of the settled amount.","examples":["GBP"],"descriptionNode":"$L1194"},"payment_method":{"type":"string","description":"Payment method used. Returns `REVOLUT_PAY` for Revolut Pay, or the card scheme name for card payments.","examples":["REVOLUT_PAY"],"descriptionNode":"$L1195"},"card_scheme":{"type":"string","description":"Card BIN scheme.","examples":["VISA"],"descriptionNode":"$L1196"},"card_funding":{"type":"string","description":"Card funding type.","examples":["DEBIT"],"descriptionNode":"$L1197"},"order_description":{"type":"string","description":"Description of the order.","descriptionNode":"$L1198"},"order_merchant_external_ref":{"type":"string","description":"Merchant's order reference. The value of the `merchant_order_data.reference` field set when the order was created.","descriptionNode":"$L1199"},"original_operation_id":{"type":"string","format":"uuid","description":"For refunds and disputes, the acquiring ID of the original payment. Corresponds to `original_payment_id` in the payments report.","descriptionNode":"$L119a"},"acquiring_fee_amount":{"type":"number","description":"IC++ acquiring markup fee component.","descriptionNode":"$L119b"},"card_interchange_fee_amount":{"type":"number","description":"Interchange fee component. Omitted for Revolut Pay transactions.","descriptionNode":"$L119c"},"card_scheme_fee_amount":{"type":"number","description":"Card scheme fee component. Omitted for Revolut Pay transactions.","descriptionNode":"$L119d"},"card_type":{"type":"string","description":"Card commercial category.\n\n| Value | Description |\n| ----- | ----------- |\n| `COMMERCIAL` | Business or corporate card. |\n| `CONSUMER` | Personal card. |","enum":["COMMERCIAL","CONSUMER"],"descriptionNode":"$L119e"},"order_channel":{"type":"string","description":"Channel through which the order was created.","examples":["API"],"descriptionNode":"$L119f"},"card_country":{"type":"string","description":"Country of the card, as an [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) code.","examples":["GB"],"descriptionNode":"$L11a0"}},"descriptionNode":"$L11a1"}]},"examples":{"settlement_report":{"summary":"Settlement report","value":"$11a2"},"custom_report":{"summary":"Custom report (filtered columns)","value":"transaction_id,order_id,payment_created_date,payment_captured_date,payment_method,amount,currency,state,updated_date\n649ae37f-99ca-a7db-a4fb-5924af14ad7c,649ae35c-2558-adea-bf98-3a7156a764e7,2023-06-28T13:20:46.07498Z,2023-06-28T13:30:46.07498Z,PAY_WITH_REVOLUT,0.05,GBP,COMPLETED,2023-06-28T13:30:46.07498Z\n649ae3de-e945-af9f-98c8-1d6172e350b5,649ae3ab-3998-ab2b-ad95-41b48346be69,2023-06-28T13:22:46.075569Z,2023-06-28T13:30:46.075569Z,PAY_WITH_REVOLUT,0.05,GBP,COMPLETED,2023-06-28T13:30:46.075569Z\n649ae48b-37f6-a097-9cb0-4fc2a89d9e5a,649ae479-d7e8-a139-993b-bf75865c5059,2023-06-28T13:35:46.084289Z,2023-06-28T13:38:46.084289Z,PAY_WITH_REVOLUT,0.05,GBP,COMPLETED,2023-06-28T13:38:46.084289Z"},"payments_report":{"summary":"Payments report","value":"$11a3"},"payout_statement_report":{"summary":"Payout statement report","value":"$11a4"}}}},"descriptionNode":"$L11a5"},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"code":{"type":"string","description":"An identifier that can be used to determine what went wrong.\n\nError codes are not globally unique, but uniqueness is guaranteed within endpoints.","descriptionNode":"$L11a6"},"message":{"type":"string","description":"Some human readable text describing what went wrong.","descriptionNode":"$L11a7"},"timestamp":{"type":"integer","description":"The [UNIX timestamp](https://www.unixtimestamp.com/) of the date and time the error happened.","descriptionNode":"$L11a8"}}}}},"descriptionNode":"$L11a9"},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"code":{"type":"string","description":"An identifier that can be used to determine what went wrong.\n\nError codes are not globally unique, but uniqueness is guaranteed within endpoints.","descriptionNode":"$L11aa"},"message":{"type":"string","description":"Some human readable text describing what went wrong.","descriptionNode":"$L11ab"},"timestamp":{"type":"integer","description":"The [UNIX timestamp](https://www.unixtimestamp.com/) of the date and time the error happened.","descriptionNode":"$L11ac"}}}}},"descriptionNode":"$L11ad"},"404":{"description":"Not Found","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"code":{"type":"string","description":"An identifier that can be used to determine what went wrong.\n\nError codes are not globally unique, but uniqueness is guaranteed within endpoints.","descriptionNode":"$L11ae"},"message":{"type":"string","description":"Some human readable text describing what went wrong.","descriptionNode":"$L11af"},"timestamp":{"type":"integer","description":"The [UNIX timestamp](https://www.unixtimestamp.com/) of the date and time the error happened.","descriptionNode":"$L11b0"}}}}},"descriptionNode":"$L11b1"}},"requestBody":"$undefined","variantLabels":["Settlement report","Custom report (filtered columns)","Payments report","Payout statement report"],"children":["$L11b2","$L11b3"]}]}],false]}] 11b2:["$","div",null,{"className":"ezz1n30","children":[["$","div",null,{"data-header":"$undefined","className":"ezz1n31","children":["$","div",null,{"className":"y9a0do1","children":[["$","h2",null,{"id":"download-report-file","children":[["$L11b4","$undefined"],["$","$L15",null,{"id":"download-report-file"}]]}],["$","$L16",null,{"url":"/docs/api/merchant/2025-10-16/operations/download-report-file.md"}]]}]}],"$undefined"]}] 11b9:T8b5,
fetch("https://merchant.revolut.com/api/report-runs/__RP_TOK_0__/file", {
  method: "GET",
  headers: {
    "Authorization": "__RP_TOK_1__"
  }
})
  .then(response => response.json())
  .then(data => console.log(data));
11ba:Td9d,
package main

import (
  "fmt"
  "net/http"
)

func main() {
  url := "https://merchant.revolut.com/api/report-runs/__RP_TOK_0__/file"
  req, _ := http.NewRequest("GET", url, nil)
  req.Header.Add("Authorization", "__RP_TOK_1__")

  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  fmt.Println(res)
}
11bb:T6c9,
import requests

url = "https://merchant.revolut.com/api/report-runs/__RP_TOK_0__/file"
headers = {
  "Authorization": "__RP_TOK_1__"
}

response = requests.get(url, headers=headers)
print(response.json())
11bc:T1541,
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;

public class Main {
  public static void main(String[] args) {
    HttpClient client = HttpClient.newHttpClient();
    HttpRequest request = HttpRequest.newBuilder()
      .uri(URI.create("https://merchant.revolut.com/api/report-runs/__RP_TOK_0__/file"))
      .header("Authorization", "__RP_TOK_1__")
      .GET(HttpRequest.BodyPublishers.noBody())
      .build();

    client.sendAsync(request, HttpResponse.BodyHandlers.ofString())
      .thenApply(HttpResponse::body)
      .thenAccept(System.out::println)
      .join();
  }
}
11bd:T1461,
using System.Net.Http;
using System.Net.Http.Headers;

var client = new HttpClient();
var request = new HttpRequestMessage
{
  Method = HttpMethod.Get,
  RequestUri = new Uri("https://merchant.revolut.com/api/report-runs/__RP_TOK_0__/file"),
  Headers =
  {
    { "Authorization", "__RP_TOK_1__" },
  }
};

using (var response = await client.SendAsync(request))
{
  response.EnsureSuccessStatusCode();
  var body = await response.Content.ReadAsStringAsync();
  Console.WriteLine(body);
}
11be:T8bd,
fetch("https://sandbox-merchant.revolut.com/api/report-runs/__RP_TOK_0__/file", {
  method: "GET",
  headers: {
    "Authorization": "__RP_TOK_1__"
  }
})
  .then(response => response.json())
  .then(data => console.log(data));
11bf:Tda5,
package main

import (
  "fmt"
  "net/http"
)

func main() {
  url := "https://sandbox-merchant.revolut.com/api/report-runs/__RP_TOK_0__/file"
  req, _ := http.NewRequest("GET", url, nil)
  req.Header.Add("Authorization", "__RP_TOK_1__")

  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  fmt.Println(res)
}
11c0:T6d1,
import requests

url = "https://sandbox-merchant.revolut.com/api/report-runs/__RP_TOK_0__/file"
headers = {
  "Authorization": "__RP_TOK_1__"
}

response = requests.get(url, headers=headers)
print(response.json())
11c1:T1549,
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;

public class Main {
  public static void main(String[] args) {
    HttpClient client = HttpClient.newHttpClient();
    HttpRequest request = HttpRequest.newBuilder()
      .uri(URI.create("https://sandbox-merchant.revolut.com/api/report-runs/__RP_TOK_0__/file"))
      .header("Authorization", "__RP_TOK_1__")
      .GET(HttpRequest.BodyPublishers.noBody())
      .build();

    client.sendAsync(request, HttpResponse.BodyHandlers.ofString())
      .thenApply(HttpResponse::body)
      .thenAccept(System.out::println)
      .join();
  }
}
11c2:T1469,
using System.Net.Http;
using System.Net.Http.Headers;

var client = new HttpClient();
var request = new HttpRequestMessage
{
  Method = HttpMethod.Get,
  RequestUri = new Uri("https://sandbox-merchant.revolut.com/api/report-runs/__RP_TOK_0__/file"),
  Headers =
  {
    { "Authorization", "__RP_TOK_1__" },
  }
};

using (var response = await client.SendAsync(request))
{
  response.EnsureSuccessStatusCode();
  var body = await response.Content.ReadAsStringAsync();
  Console.WriteLine(body);
}
11b3:["$","div",null,{"className":"ezz1n30","children":[["$","div",null,{"data-header":"$undefined","className":"ezz1n31","children":["$L11b5",["$","$L85",null,{"parameters":[{"name":"Authorization","in":"header","schema":{"type":"string","format":"Bearer ","examples":"$62:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:0:schema:examples"},"required":true,"description":"This parameter accepts the [Merchant API Secret key](https://business.revolut.com/settings/apis?tab=merchant-api) to authorise requests coming from the merchant's backend. \n\nIt ensures that ensures that each request is authenticated and authorised by verifying the secret key. The secret key should be included in all request headers as a `Bearer` token.\n\n:::info\nFor more information, see: [Authentication](https://developer.revolut.com/docs/api/merchant#authentication)\n:::","descriptionNode":"$L11b6"},{"name":"report_run_id","in":"path","schema":{"type":"string","format":"uuid","description":"A UUID string, typically used to identify resources.","descriptionNode":"$L11b7"},"required":true,"description":"Unique ID of the report run.","descriptionNode":"$L11b8"}],"requestBody":"$undefined","heading":"Request","requestBodySchemaTitle":"Request body","headingAs":"h3"}],["$","$L89",null,{"responses":"$55:props:children:0:props:children:props:responses","headingAs":"h3"}]]}],["$","div",null,{"className":"ezz1n32","children":[[["$","$L8a",null,{"itemsByServer":{"https://merchant.revolut.com":[{"id":"curl","label":"cURL","templateCode":"curl -X GET \"https://merchant.revolut.com/api/report-runs/__RP_TOK_0__/file\" \\\n -H \"Authorization: __RP_TOK_1__\"","templateHtml":"
curl -X GET \"https://merchant.revolut.com/api/report-runs/__RP_TOK_0__/file\" \\\n  -H \"Authorization: __RP_TOK_1__\"
","tokens":[{"marker":"__RP_TOK_0__","paramName":"report_run_id","paramIn":"path","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["shell-double-inner"]}],"defaults":{"header:Authorization":"Bearer ","path:report_run_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"javascript","label":"JavaScript","templateCode":"fetch(\"https://merchant.revolut.com/api/report-runs/__RP_TOK_0__/file\", {\n method: \"GET\",\n headers: {\n \"Authorization\": \"__RP_TOK_1__\"\n }\n})\n .then(response => response.json())\n .then(data => console.log(data));","templateHtml":"$11b9","tokens":[{"marker":"__RP_TOK_0__","paramName":"report_run_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","path:report_run_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"go","label":"Go","templateCode":"package main\n\nimport (\n \"fmt\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://merchant.revolut.com/api/report-runs/__RP_TOK_0__/file\"\n req, _ := http.NewRequest(\"GET\", url, nil)\n req.Header.Add(\"Authorization\", \"__RP_TOK_1__\")\n\n res, _ := http.DefaultClient.Do(req)\n defer res.Body.Close()\n fmt.Println(res)\n}","templateHtml":"$11ba","tokens":[{"marker":"__RP_TOK_0__","paramName":"report_run_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","path:report_run_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"python","label":"Python","templateCode":"import requests\n\nurl = \"https://merchant.revolut.com/api/report-runs/__RP_TOK_0__/file\"\nheaders = {\n \"Authorization\": \"__RP_TOK_1__\"\n}\n\nresponse = requests.get(url, headers=headers)\nprint(response.json())","templateHtml":"$11bb","tokens":[{"marker":"__RP_TOK_0__","paramName":"report_run_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","path:report_run_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"java","label":"Java","templateCode":"import java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\nimport java.net.URI;\n\npublic class Main {\n public static void main(String[] args) {\n HttpClient client = HttpClient.newHttpClient();\n HttpRequest request = HttpRequest.newBuilder()\n .uri(URI.create(\"https://merchant.revolut.com/api/report-runs/__RP_TOK_0__/file\"))\n .header(\"Authorization\", \"__RP_TOK_1__\")\n .GET(HttpRequest.BodyPublishers.noBody())\n .build();\n\n client.sendAsync(request, HttpResponse.BodyHandlers.ofString())\n .thenApply(HttpResponse::body)\n .thenAccept(System.out::println)\n .join();\n }\n}","templateHtml":"$11bc","tokens":[{"marker":"__RP_TOK_0__","paramName":"report_run_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","path:report_run_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"csharp","label":"C#","templateCode":"using System.Net.Http;\nusing System.Net.Http.Headers;\n\nvar client = new HttpClient();\nvar request = new HttpRequestMessage\n{\n Method = HttpMethod.Get,\n RequestUri = new Uri(\"https://merchant.revolut.com/api/report-runs/__RP_TOK_0__/file\"),\n Headers =\n {\n { \"Authorization\", \"__RP_TOK_1__\" },\n }\n};\n\nusing (var response = await client.SendAsync(request))\n{\n response.EnsureSuccessStatusCode();\n var body = await response.Content.ReadAsStringAsync();\n Console.WriteLine(body);\n}","templateHtml":"$11bd","tokens":[{"marker":"__RP_TOK_0__","paramName":"report_run_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","path:report_run_id":"123e4567-e89b-12d3-a456-426614174000"}}],"https://sandbox-merchant.revolut.com":[{"id":"curl","label":"cURL","templateCode":"curl -X GET \"https://sandbox-merchant.revolut.com/api/report-runs/__RP_TOK_0__/file\" \\\n -H \"Authorization: __RP_TOK_1__\"","templateHtml":"
curl -X GET \"https://sandbox-merchant.revolut.com/api/report-runs/__RP_TOK_0__/file\" \\\n  -H \"Authorization: __RP_TOK_1__\"
","tokens":[{"marker":"__RP_TOK_0__","paramName":"report_run_id","paramIn":"path","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["shell-double-inner"]}],"defaults":{"header:Authorization":"Bearer ","path:report_run_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"javascript","label":"JavaScript","templateCode":"fetch(\"https://sandbox-merchant.revolut.com/api/report-runs/__RP_TOK_0__/file\", {\n method: \"GET\",\n headers: {\n \"Authorization\": \"__RP_TOK_1__\"\n }\n})\n .then(response => response.json())\n .then(data => console.log(data));","templateHtml":"$11be","tokens":[{"marker":"__RP_TOK_0__","paramName":"report_run_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","path:report_run_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"go","label":"Go","templateCode":"package main\n\nimport (\n \"fmt\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://sandbox-merchant.revolut.com/api/report-runs/__RP_TOK_0__/file\"\n req, _ := http.NewRequest(\"GET\", url, nil)\n req.Header.Add(\"Authorization\", \"__RP_TOK_1__\")\n\n res, _ := http.DefaultClient.Do(req)\n defer res.Body.Close()\n fmt.Println(res)\n}","templateHtml":"$11bf","tokens":[{"marker":"__RP_TOK_0__","paramName":"report_run_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","path:report_run_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"python","label":"Python","templateCode":"import requests\n\nurl = \"https://sandbox-merchant.revolut.com/api/report-runs/__RP_TOK_0__/file\"\nheaders = {\n \"Authorization\": \"__RP_TOK_1__\"\n}\n\nresponse = requests.get(url, headers=headers)\nprint(response.json())","templateHtml":"$11c0","tokens":[{"marker":"__RP_TOK_0__","paramName":"report_run_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","path:report_run_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"java","label":"Java","templateCode":"import java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\nimport java.net.URI;\n\npublic class Main {\n public static void main(String[] args) {\n HttpClient client = HttpClient.newHttpClient();\n HttpRequest request = HttpRequest.newBuilder()\n .uri(URI.create(\"https://sandbox-merchant.revolut.com/api/report-runs/__RP_TOK_0__/file\"))\n .header(\"Authorization\", \"__RP_TOK_1__\")\n .GET(HttpRequest.BodyPublishers.noBody())\n .build();\n\n client.sendAsync(request, HttpResponse.BodyHandlers.ofString())\n .thenApply(HttpResponse::body)\n .thenAccept(System.out::println)\n .join();\n }\n}","templateHtml":"$11c1","tokens":[{"marker":"__RP_TOK_0__","paramName":"report_run_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","path:report_run_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"csharp","label":"C#","templateCode":"using System.Net.Http;\nusing System.Net.Http.Headers;\n\nvar client = new HttpClient();\nvar request = new HttpRequestMessage\n{\n Method = HttpMethod.Get,\n RequestUri = new Uri(\"https://sandbox-merchant.revolut.com/api/report-runs/__RP_TOK_0__/file\"),\n Headers =\n {\n { \"Authorization\", \"__RP_TOK_1__\" },\n }\n};\n\nusing (var response = await client.SendAsync(request))\n{\n response.EnsureSuccessStatusCode();\n var body = await response.Content.ReadAsStringAsync();\n Console.WriteLine(body);\n}","templateHtml":"$11c2","tokens":[{"marker":"__RP_TOK_0__","paramName":"report_run_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","path:report_run_id":"123e4567-e89b-12d3-a456-426614174000"}}]},"method":"get","servers":"$62:props:children:0:props:children:props:children:1:props:children:1:props:children:0:0:props:servers","path":"/api/report-runs/{report_run_id}/file","parameters":["$11b3:props:children:0:props:children:1:props:parameters:0","$11b3:props:children:0:props:children:1:props:parameters:1"]}],"$L11c3"],"$L11c4","$L11c5"]}]]}] 11c3:["$","$L10d",null,{"security":[{"Api-Key":[]}],"authorization":{"Api-Key":{"type":"apiKey","in":"header","name":"Authorization","description":"Each Merchant API request must contain an authorization header in the following format:\n\n```\n'Authorization: Bearer '\n```\n\nTo use this API, you need to generate API keys from your Revolut Business account. The Secret key is used in the authorization header for all server calls, while the Public key is provided with payment methods at checkout.\n\n:::info\nFor detailed instructions on generating your API keys, see: [Generate API keys](https://developer.revolut.com/docs/guides/merchant/get-started#generate-api-keys).\n:::","descriptionNode":"$L11c6"}}}] 11c4:["$","$L10f",null,{"exampleBlocks":{},"title":"Request body samples","headingAs":"h4"}] 11c7:T7af,transaction_id,order_id,original_order_id,started_date,updated_date,completed_date,payment_created_date,payment_captured_date,type,state,description,merchant_order_ext_ref,customer_id,amount,currency,settlement_amount,settlement_currency,payment_method,fee_amount,fee_currency,processing_fee_amount,processing_fee_currency,browser_url,location_id 67f66fa6-200c-aaef-8708-cb78366f8a30,67f66f41-3022-a623-827e-e0616c0d04e7,67f66f41-3022-a623-827e-e0616c0d04e7,2025-04-09T13:01:26.288638Z,2025-04-10T13:02:09.843018Z,2025-04-10T13:02:09.837719Z,2025-04-09T13:01:26.186Z,2025-04-10T13:02:09.837719Z,SETTLEMENT,COMPLETED,Summer hat,ORD-2025-0042,,100.00,GBP,99.00,GBP,CARD,1.00,GBP,1.00,GBP,https://sandbox-checkout.revolut.com/payment-link/1ae44a1c-3ea8-47ac-b736-7d7d4c992bb4, 67f66fb7-300d-bbff-9819-dc89477a9b41,67f67052-4133-b734-938f-f1727d1e15f8,67f66f41-3022-a623-827e-e0616c0d04e7,2025-04-10T09:10:00.000000Z,2025-04-10T09:12:00.000000Z,2025-04-10T09:12:00.000000Z,,,REFUND,COMPLETED,Refund for Summer hat,ORD-2025-0042-R1,,25.00,GBP,-25.00,GBP,CARD,0.00,GBP,0.00,GBP,https://sandbox-checkout.revolut.com/payment-link/1ae44a1c-3ea8-47ac-b736-7d7d4c992bb4, 67f66fc8-411e-cc10-a92a-ed9a588b0c52,67f67063-5244-c845-a49a-a2838e2f26a9,67f66f41-3022-a623-827e-e0616c0d04e7,2025-04-11T08:30:00.000000Z,2025-04-11T08:45:00.000000Z,2025-04-11T08:45:00.000000Z,,,CHARGEBACK,COMPLETED,Chargeback for Summer hat,ORD-2025-0042-CB1,,75.00,GBP,-75.00,GBP,CARD,0.00,GBP,0.00,GBP,https://sandbox-checkout.revolut.com/payment-link/1ae44a1c-3ea8-47ac-b736-7d7d4c992bb4, 67f66fd9-522f-dd21-ba3b-feab699a1d63,67f67074-6355-d956-b50a-a3949f3a37a0,67f66f41-3022-a623-827e-e0616c0d04e7,2025-04-15T10:00:00.000000Z,2025-04-15T10:05:00.000000Z,2025-04-15T10:05:00.000000Z,,,CHARGEBACK_REVERSAL,COMPLETED,Chargeback reversal for Summer hat,ORD-2025-0042-CBR1,,75.00,GBP,75.00,GBP,CARD,0.00,GBP,0.00,GBP,https://sandbox-checkout.revolut.com/payment-link/1ae44a1c-3ea8-47ac-b736-7d7d4c992bb4,11ca:T468,payment_id,type,description,original_payment_id,order_id,state,reason,amount,currency,surcharge_amount,tip_amount,refunded_amount,created_date,captured_date,merchant_order_ext_ref,payment_method,location_id,customer_id,customer_card_number,customer_card_country,customer_card_brand,customer_card_type,customer_card_category,customer_email,fee_amount,fee_currency 67f66fa6-7e98-ae73-9570-50583cec116d,PAYMENT,Payment from customer,,67f66f41-3022-a623-827e-e0616c0d04e7,COMPLETED,,1.00,GBP,,0.00,0.00,2025-04-09T13:01:26.186Z,2025-04-10T13:02:09.837Z,ORD-2025-0042,CARD,,cust-0001-0000-0000-000000000001,528143******4148,GB,VISA,DEBIT,consumer,customer@example.com,0.01,GBP 6807b0a5-a367-afbf-b31f-353730b788b5,PAYMENT,Payment from customer,,6807b09c-c62a-a656-818e-f071ef67ee36,DECLINED,,10.01,GBP,,0.00,0.00,2025-04-22T15:07:17.352Z,,,PAY_WITH_REVOLUT,,,,,,,,customer@example.com,, 67efa316-db8a-aec6-8eb4-46e47b6ebdc4,PAYMENT,Payment from customer,,67efa305-be19-a456-a6a2-154b218ac386,FAILED,INSUFFICIENT_FUNDS,0.57,USD,,0.00,0.00,2025-04-04T09:15:02.13Z,,,CARD,,,222300******9399,GB,VISA,DEBIT,consumer,customer@example.com,,11cc:T5f7,created_date,completed_date,payout_affected_date,affected_payout_amount,transaction_id,order_id,dispute_id,merchant_order_reference,type,related_icpp_charge_id,transaction_amount,transaction_currency,billing_amount,billing_currency,state,original_transaction_id,original_transaction_amount,original_transaction_currency,original_order_id,original_order_channel,original_merchant_order_reference,fee_amount,fee_currency,settlement_amount,settlement_currency,location_id,location_name,submerchant_id,payout_transfer_reference,payout_total_amount,payout_date 2025-03-25T14:34:05.708899Z,2025-03-26T14:34:38.06903Z,2025-03-26T14:34:38.06903Z,true,67e2bedd-0e79-a8ea-ac4c-e9fd13693286,67e2be76-89c5-ae4f-9103-a152ae6f0584,,ORD-2025-0042,Settlement,,0.57,USD,0.57,USD,COMPLETED,67e2bedd-0e79-a8ea-ac4c-e9fd13693286,0.57,USD,67e2be76-89c5-ae4f-9103-a152ae6f0584,API,ORD-2025-0042,0.00,USD,0.57,USD,4a0f98a6-0f61-4e85-9ef0-7e5d0cb92ef0,Store London,,Revolut USD payout 2025-03-26 MerchantName,0.17,2025-03-26T15:00:00Z 2025-03-25T15:38:45.162946Z,2025-03-26T15:39:58.03824Z,2025-03-26T15:39:58.03824Z,true,67e2ce05-1a16-abeb-b05b-5059073bcdaa,67e2ce00-6665-a52b-9f10-368f886054d7,a81bba54-e3f9-450f-aa50-7aea8e4e5b9a,ORD-2025-0042-CB1,Customer dispute - withdrawal,,-0.40,USD,-0.40,USD,COMPLETED,67e2bedd-0e79-a8ea-ac4c-e9fd13693286,0.57,USD,67e2be76-89c5-ae4f-9103-a152ae6f0584,API,ORD-2025-0042,0.00,USD,-0.40,USD,4a0f98a6-0f61-4e85-9ef0-7e5d0cb92ef0,Store London,,Revolut USD payout 2025-03-26 MerchantName,0.17,2025-03-26T15:00:00Z11c5:["$","$L110",null,{"exampleBlocks":{"200":{"text/csv":{"variants":[{"key":"settlement_report","label":"Settlement report","rawValue":"$11c7","block":"$L11c8"},{"key":"custom_report","label":"Custom report (filtered columns)","rawValue":"transaction_id,order_id,payment_created_date,payment_captured_date,payment_method,amount,currency,state,updated_date\n649ae37f-99ca-a7db-a4fb-5924af14ad7c,649ae35c-2558-adea-bf98-3a7156a764e7,2023-06-28T13:20:46.07498Z,2023-06-28T13:30:46.07498Z,PAY_WITH_REVOLUT,0.05,GBP,COMPLETED,2023-06-28T13:30:46.07498Z\n649ae3de-e945-af9f-98c8-1d6172e350b5,649ae3ab-3998-ab2b-ad95-41b48346be69,2023-06-28T13:22:46.075569Z,2023-06-28T13:30:46.075569Z,PAY_WITH_REVOLUT,0.05,GBP,COMPLETED,2023-06-28T13:30:46.075569Z\n649ae48b-37f6-a097-9cb0-4fc2a89d9e5a,649ae479-d7e8-a139-993b-bf75865c5059,2023-06-28T13:35:46.084289Z,2023-06-28T13:38:46.084289Z,PAY_WITH_REVOLUT,0.05,GBP,COMPLETED,2023-06-28T13:38:46.084289Z","block":"$L11c9"},{"key":"payments_report","label":"Payments report","rawValue":"$11ca","block":"$L11cb"},{"key":"payout_statement_report","label":"Payout statement report","rawValue":"$11cc","block":"$L11cd"}],"syncedPropertyName":"$undefined"}},"400":{"application/json":{"variants":[{"key":"default","label":"Example","rawValue":{"code":"string","message":"string","timestamp":123},"block":"$L11ce"}],"syncedPropertyName":"$undefined"}},"401":{"application/json":{"variants":[{"key":"default","label":"Example","rawValue":{"code":"string","message":"string","timestamp":123},"block":"$L11cf"}],"syncedPropertyName":"$undefined"}},"404":{"application/json":{"variants":[{"key":"default","label":"Example","rawValue":{"code":"string","message":"string","timestamp":123},"block":"$L11d0"}],"syncedPropertyName":"$undefined"}}},"headingAs":"h4"}] 11b4:"Download report file" 10f8:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["Unique identifier of the ledger transaction in the core settlement system. Matches ",["$","code","code-0",{"children":"transaction_id"}]," in the payout statement report for the same event. Not the same as ",["$","code","code-1",{"children":"payment_id"}]," in the payments report — a payment and its resulting ledger transaction have different UUIDs. Use ",["$","code","code-2",{"children":"order_id"}]," to cross-reference with the payments report."]}]]}] 10f9:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["Unique identifier of the order. An order is the top-level entity that groups one or more payment attempts against it. ",["$","code","code-0",{"children":"order_id"}]," is consistent across all report types and can be used to cross-reference between the payments report and the settlement or payout reports."]}]]}] 10fa:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["For refunds and chargebacks, the order ID of the original payment that this transaction reverses. Refunds and chargebacks create their own order in the system, so ",["$","code","code-0",{"children":"order_id"}]," refers to the refund or chargeback order while ",["$","code","code-1",{"children":"original_order_id"}]," points back to the original payment's order. For settlement transactions, matches ",["$","code","code-2",{"children":"order_id"}],"."]}]]}] 10fb:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Date and time the row's source record was started. For payment rows, this is the payment start timestamp. For non-payment rows such as refunds and chargebacks, this is the transaction start timestamp. This displayed value is separate from the report filter timeframe."}]]}] 10fc:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Date and time the row's source record was last updated. For payment rows, this is the payment update timestamp. For non-payment rows such as refunds and chargebacks, this is the transaction update timestamp. This displayed value is separate from the report filter timeframe."}]]}] 10fd:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Date and time the row's source record was completed. For payment rows, this is the payment completion timestamp. For non-payment rows such as refunds and chargebacks, this is the transaction completion timestamp. This displayed value is separate from the report filter timeframe."}]]}] 10fe:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["Payment authorisation or creation timestamp for rows linked to a payment, in ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_8601","target":"_blank","rel":"noreferrer","children":"ISO 8601"}]," UTC date-time format. Empty for refunds and non-payment-related rows where no payment timestamp applies. This displayed value is separate from the report filter timeframe."]}]]}] 10ff:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["Payment capture timestamp for rows linked to a captured payment, in ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_8601","target":"_blank","rel":"noreferrer","children":"ISO 8601"}]," UTC date-time format. Empty for refunds, non-payment-related rows, or payments not captured. This displayed value is separate from the report filter timeframe."]}]]}] 1100:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Type of the settlement report row."}],"\n",["$","p","p-1",{"children":["A partial-settlement is represented by separate ",["$","code","code-0",{"children":"SETTLEMENT"}]," and ",["$","code","code-1",{"children":"REFUND"}]," rows instead of a dedicated type."]}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Value","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"SETTLEMENT"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Settlement of a payment into the merchant balance.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"REFUND"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Refund entry reducing the merchant balance.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"CHARGEBACK"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Dispute withdrawal entry reducing the merchant balance.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"CHARGEBACK_REVERSAL"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Reversal of a previous chargeback, restoring funds to the merchant balance.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 1101:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"State of the transaction."}]]}] 1102:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Description of the order."}]]}] 1103:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["Merchant's order reference. The value of the ",["$","code","code-0",{"children":"merchant_order_data.reference"}]," field set when the order was created."]}]]}] 1104:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unique identifier of the customer related to an order."}]]}] 1105:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Total amount of the order."}]]}] 1106:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_4217","target":"_blank","rel":"noreferrer","children":"ISO 4217"}]," currency code that represents the currency of the order."]}]]}] 1107:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Total amount settled on the merchant's account."}]]}] 1108:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_4217","target":"_blank","rel":"noreferrer","children":"ISO 4217"}]," currency code that represents the currency of the settled amount."]}]]}] 1109:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Type of the payment method the customer used to pay for the order."}]]}] 110a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Total fee amount applied to the order, aggregated across all fee components (acquiring markup + interchange + scheme fees)."}]]}] 110b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_4217","target":"_blank","rel":"noreferrer","children":"ISO 4217"}]," currency code that represents the currency of the total fee."]}]]}] 110c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["Acquiring markup fee only — a subset of ",["$","code","code-0",{"children":"fee_amount"}],". Represents Revolut's service fee, excluding interchange and scheme fees."]}]]}] 110d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_4217","target":"_blank","rel":"noreferrer","children":"ISO 4217"}]," currency code that represents the currency of the acquiring markup fee."]}]]}] 110e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The URL where the customer initiated the payment."}]]}] 110f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unique identifier of the location related to the transaction."}]]}] 1110:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["CSV output for ",["$","code","code-0",{"children":"settlement_report"}],". Contains settled transactions associated with a Merchant account."]}],"\n",["$","p","p-1",{"children":"The first row is a header row with column names. Subsequent rows contain transaction data, one row per transaction."}],"\n",["$","p","p-2",{"children":["A partial-settlement is represented by separate ",["$","code","code-0",{"children":"SETTLEMENT"}]," and ",["$","code","code-1",{"children":"REFUND"}]," rows instead of a dedicated type."]}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["The actual response is a raw ",["$","code","code-0",{"children":"text/csv"}]," string. The object schema below is a documentation convention only: OpenAPI's schema language (JSON Schema) describes JSON data shapes and has no native construct for typed CSV columns, so each property here corresponds to a CSV column header rather than a JSON field."]}]}]]}]]}] 1111:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["Unique identifier of the ledger transaction in the core settlement system. Matches ",["$","code","code-0",{"children":"transaction_id"}]," in the settlement and payout reports for the same event. Not the same as ",["$","code","code-1",{"children":"payment_id"}]," in the payments report — a payment and its resulting ledger transaction have different UUIDs. Use ",["$","code","code-2",{"children":"order_id"}]," to cross-reference with the payments report."]}]]}] 1112:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["For refund and chargeback transactions, the ledger transaction ID of the original payment that this transaction reverses. Corresponds to ",["$","code","code-0",{"children":"original_transaction_id"}]," in the payout statement report."]}]]}] 1113:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Description of the transaction."}]]}] 1114:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["Unique identifier of the order. An order is the top-level entity that groups one or more payment attempts against it. ",["$","code","code-0",{"children":"order_id"}]," is consistent across all report types and can be used to cross-reference between the payments report and the settlement or payout reports."]}]]}] 1115:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["For refunds and chargebacks, the order ID of the original payment that this transaction reverses. Refunds and chargebacks create their own order in the system, so ",["$","code","code-0",{"children":"order_id"}]," refers to the refund or chargeback order while ",["$","code","code-1",{"children":"original_order_id"}]," points back to the original payment's order. For settlement transactions, matches ",["$","code","code-2",{"children":"order_id"}],"."]}]]}] 1116:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Merchant's order identifier of the original order for external reference."}]]}] 1117:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Description of the order."}]]}] 1118:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Channel through which the order was created."}],"\n",["$","p","p-1",{"children":"The value depends on the order source and integration. It may reflect platform-specific or externally provided values, so the set of returned values should not be treated as a fixed enum."}]]}] 1119:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Note added by the customer at the time of the order."}]]}] 111a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Tip amount set at the order level."}]]}] 111b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Identifier of the user who created the order."}]]}] 111c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Identifier of who initiated the payment."}]]}] 111d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Line items included in the order, if any."}]]}] 111e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unique identifier of the payout that this transaction contributed to. Use to cross-reference with the payout statement report."}]]}] 111f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Reference of the payout transfer associated with the transaction."}]]}] 1120:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Invoice reference associated with the order, if any."}]]}] 1121:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unique identifier of the dispute, if applicable."}]]}] 1122:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unique identifier of the merchant account."}]]}] 1123:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Account balance at the time of the transaction."}]]}] 1124:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Date and time the row's source record was started. For payment rows, this is the payment start timestamp. For non-payment rows such as refunds and chargebacks, this is the transaction start timestamp. This displayed value is separate from the report filter timeframe."}]]}] 1125:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Date and time the order was created."}]]}] 1126:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Date and time the row's source record was last updated. For payment rows, this is the payment update timestamp. For non-payment rows such as refunds and chargebacks, this is the transaction update timestamp. This displayed value is separate from the report filter timeframe."}]]}] 1127:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Date and time the row's source record was completed. For payment rows, this is the payment completion timestamp. For non-payment rows such as refunds and chargebacks, this is the transaction completion timestamp. This displayed value is separate from the report filter timeframe."}]]}] 1128:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["Payment authorisation or creation timestamp for rows linked to a payment, in ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_8601","target":"_blank","rel":"noreferrer","children":"ISO 8601"}]," UTC date-time format. Empty for refunds and non-payment-related rows where no payment timestamp applies. This displayed value is separate from the report filter timeframe."]}]]}] 1129:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["Payment capture timestamp for rows linked to a captured payment, in ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_8601","target":"_blank","rel":"noreferrer","children":"ISO 8601"}]," UTC date-time format. Empty for refunds, non-payment-related rows, or payments not captured. This displayed value is separate from the report filter timeframe."]}]]}] 112a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Type of the transaction."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Value","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"SETTLEMENT"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Settlement of a payment into the merchant balance.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"RESERVE"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Reserve entry holding funds on the merchant balance.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"REFUND"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Refund entry reducing the merchant balance.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"TOPUP"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Balance top-up entry.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-4",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"TOPUP_RETURN"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Reversal of a top-up entry.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-5",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"CHARGEBACK"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Dispute withdrawal from the merchant balance.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-6",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"CHARGEBACK_REVERSAL"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Reversal of a previous chargeback.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-7",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"CREDIT_REIMBURSEMENT"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Credit reimbursement entry.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-8",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"FEE"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Fee charged against the merchant balance.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-9",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"PAYOUT"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Payout-related ledger entry.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-10",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"TRANSFER"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Balance transfer entry.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-11",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"REVOLUT_REFUND"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Refund-related entry specific to Revolut internal flows.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-12",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"REVOLUT_FEE"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Fee-related entry specific to Revolut internal flows.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-13",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"WRITE_OFF"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Write-off entry.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-14",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"CHARGE"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Charge entry posted to the merchant balance.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 112b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Legacy type value for backwards compatibility."}]]}] 112c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"State of the transaction."}]]}] 112d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Description of the transaction."}]]}] 112e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["Merchant's order reference. The value of the ",["$","code","code-0",{"children":"merchant_order_data.reference"}]," field set when the order was created."]}]]}] 112f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unique identifier of the customer related to the order."}]]}] 1130:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Total amount of the order."}]]}] 1131:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_4217","target":"_blank","rel":"noreferrer","children":"ISO 4217"}]," currency code of the order."]}]]}] 1132:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Total amount settled on the merchant's account."}]]}] 1133:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_4217","target":"_blank","rel":"noreferrer","children":"ISO 4217"}]," currency code of the settled amount."]}]]}] 1134:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Exchange rate applied if currency conversion occurred."}]]}] 1135:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Amount refunded for the order."}]]}] 1136:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Statement descriptor shown on the customer's bank statement."}]]}] 1137:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Tip amount included in the transaction."}]]}] 1138:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Surcharge amount applied to the transaction. Omitted when no surcharge applies."}]]}] 1139:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Surcharge amount set at the order level."}]]}] 113a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Identifier of the card reader hardware used, for in-person payments."}]]}] 113b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Name of the customer."}]]}] 113c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Email address of the customer."}]]}] 113d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Masked card number used for the payment."}]]}] 113e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["Card brand used for the payment. Derived from BIN data. Example values include ",["$","code","code-0",{"children":"VISA"}],", ",["$","code","code-1",{"children":"MASTERCARD"}],", ",["$","code","code-2",{"children":"MASTERCARD_DEBIT"}],", ",["$","code","code-3",{"children":"MAESTRO"}],", ",["$","code","code-4",{"children":"AMEX"}],", ",["$","code","code-5",{"children":"DINERS"}],", ",["$","code","code-6",{"children":"DISCOVER"}],", ",["$","code","code-7",{"children":"JCB"}],"."]}]]}] 113f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Card funding type."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Value","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"DEBIT"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Debit card.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"CREDIT"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Credit card.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"PREPAID"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Prepaid card.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"DEFERRED_DEBIT"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Deferred debit card.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-4",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"CHARGE"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Charge card.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 1140:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Card commercial category."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Value","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"consumer"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Personal card.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"commercial"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Business or corporate card.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 1141:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Payment method the customer used to pay for the order."}]]}] 1142:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Total fee amount applied to the order, aggregated across all fee components (acquiring markup + interchange + scheme fees)."}]]}] 1143:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_4217","target":"_blank","rel":"noreferrer","children":"ISO 4217"}]," currency code of the total fee."]}]]}] 1144:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["Acquiring markup fee only — a subset of ",["$","code","code-0",{"children":"fee_amount"}],". Represents Revolut's service fee, excluding interchange and scheme fees."]}]]}] 1145:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_4217","target":"_blank","rel":"noreferrer","children":"ISO 4217"}]," currency code of the acquiring markup fee."]}]]}] 1146:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Foreign exchange fee amount, if applicable."}]]}] 1147:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_4217","target":"_blank","rel":"noreferrer","children":"ISO 4217"}]," currency code of the FX fee."]}]]}] 1148:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The URL where the customer initiated the payment."}]]}] 1149:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Name of the beneficiary, for bank transfer payments."}]]}] 114a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Account number of the beneficiary, for bank transfer payments."}]]}] 114b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unique identifier of the location related to the transaction."}]]}] 114c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Name of the location related to the transaction."}]]}] 114d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Name of a custom field set on the order."}]]}] 114e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Value of a custom field set on the order."}]]}] 114f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"State of an offline payment, if applicable."}]]}] 1150:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["Authorisation type of the order, for example ",["$","code","code-0",{"children":"FULL"}]," or ",["$","code","code-1",{"children":"PRE_AUTH"}],"."]}]]}] 1151:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["CSV output for ",["$","code","code-0",{"children":"custom_report"}]," report type. Contains settled and processing transactions with a configurable set of columns."]}],"\n",["$","p","p-1",{"children":"The first row is a header row with column names. Subsequent rows contain transaction data, one row per transaction."}],"\n",["$","p","p-2",{"children":["The columns included in the response depend on the ",["$","code","code-0",{"children":"options.columns"}]," list specified in the request. If no columns list was provided, all available columns are included."]}],"\n",["$","p","p-3",{"children":["Custom metadata columns can also be requested using the ",["$","code","code-0",{"children":"metadata."}]," prefix, for example ",["$","code","code-1",{"children":"metadata.custom_attribute"}],"."]}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["The actual response is a raw ",["$","code","code-0",{"children":"text/csv"}]," string. The object schema below is a documentation convention only: OpenAPI's schema language (JSON Schema) describes JSON data shapes and has no native construct for typed CSV columns, so each property here corresponds to a CSV column header rather than a JSON field."]}]}]]}]]}] 1152:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["Unique identifier of the payment attempt in the acquiring system. Corresponds to ",["$","code","code-0",{"children":"id"}]," in the IC++ fee breakdown report for the same payment. Not the same as ",["$","code","code-1",{"children":"transaction_id"}]," in the settlement or payout reports — a payment and its resulting ledger transaction have different UUIDs. Use ",["$","code","code-2",{"children":"order_id"}]," to cross-reference with the settlement or payout reports."]}]]}] 1153:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Type of the payment."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Value","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"PAYMENT"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"A payment attempt made against the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"REFUND"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"A refund record reversing a previously completed payment.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 1154:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Description of the payment."}]]}] 1155:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["For refunds, the acquiring ID of the original payment that this record reverses. Corresponds to ",["$","code","code-0",{"children":"payment_id"}]," on the original payment row. Populated only when ",["$","code","code-1",{"children":"type"}]," is ",["$","code","code-2",{"children":"REFUND"}],"."]}]]}] 1156:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["Unique identifier of the order associated with this payment. An order can have multiple payment attempts — for example, a retry after a declined payment. Use ",["$","code","code-0",{"children":"order_id"}]," to cross-reference with the settlement or payout reports."]}]]}] 1157:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"State of the payment."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Value","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"COMPLETED"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The payment completed successfully.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"FAILED"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The payment failed during processing.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"DECLINED"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The payment was rejected by the issuer or payment flow.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"CANCELLED"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The payment was cancelled before completion.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-4",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"PROCESSING"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The payment is still being processed.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 1158:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["Reason code for a failed or declined payment. Present only when ",["$","code","code-0",{"children":"state"}]," is ",["$","code","code-1",{"children":"FAILED"}]," or ",["$","code","code-2",{"children":"DECLINED"}],"."]}],"\n",["$","p","p-1",{"children":["Example values: ",["$","code","code-0",{"children":"INSUFFICIENT_FUNDS"}],", ",["$","code","code-1",{"children":"DO_NOT_HONOUR"}],", ",["$","code","code-2",{"children":"EXPIRED_CARD"}],", ",["$","code","code-3",{"children":"INVALID_CVV"}],", ",["$","code","code-4",{"children":"THREE_DS_CHALLENGE_FAILED"}],", ",["$","code","code-5",{"children":"SUSPECTED_FRAUD"}],", ",["$","code","code-6",{"children":"LOST_CARD"}],", ",["$","code","code-7",{"children":"STOLEN_CARD"}],", ",["$","code","code-8",{"children":"TECHNICAL_ERROR"}],"."]}]]}] 1159:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Total amount of the payment."}]]}] 115a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_4217","target":"_blank","rel":"noreferrer","children":"ISO 4217"}]," currency code of the payment."]}]]}] 115b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["Surcharge amount applied to the payment. Empty when no surcharge applies — this field is empty, not set to ",["$","code","code-0",{"children":"0"}],"."]}]]}] 115c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Tip amount included in the payment, if any."}]]}] 115d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Amount refunded for the payment."}]]}] 115e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Date and time the payment was created."}]]}] 115f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["Date and time the payment was captured, in ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_8601","target":"_blank","rel":"noreferrer","children":"ISO 8601"}]," UTC date-time format. Empty when the payment has not been captured."]}]]}] 1160:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["Merchant's order reference. The value of the ",["$","code","code-0",{"children":"merchant_order_data.reference"}]," field set when the order was created."]}]]}] 1161:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Payment method used."}]]}] 1162:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unique identifier of the location where the payment was made."}]]}] 1163:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unique identifier of the customer."}]]}] 1164:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Masked card number used for the payment."}]]}] 1165:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["Country of the card used for the payment, as an ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2","target":"_blank","rel":"noreferrer","children":"ISO 3166-1 alpha-2"}]," code."]}]]}] 1166:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["Card brand used for the payment. Derived from BIN data. Example values include ",["$","code","code-0",{"children":"VISA"}],", ",["$","code","code-1",{"children":"MASTERCARD"}],", ",["$","code","code-2",{"children":"MASTERCARD_DEBIT"}],", ",["$","code","code-3",{"children":"MAESTRO"}],", ",["$","code","code-4",{"children":"AMEX"}],", ",["$","code","code-5",{"children":"DINERS"}],", ",["$","code","code-6",{"children":"DISCOVER"}],", ",["$","code","code-7",{"children":"JCB"}],"."]}]]}] 1167:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Card funding type."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Value","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"DEBIT"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Debit card.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"CREDIT"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Credit card.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"PREPAID"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Prepaid card.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"DEFERRED_DEBIT"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Deferred debit card.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-4",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"CHARGE"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Charge card.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 1168:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Card commercial category."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Value","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"consumer"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Personal card.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"commercial"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Business or corporate card.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 1169:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Email address of the customer."}]]}] 116a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Total fee amount charged for the payment. Omitted for failed and declined payments."}]]}] 116b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_4217","target":"_blank","rel":"noreferrer","children":"ISO 4217"}]," currency code of the fee. Omitted for failed and declined payments."]}]]}] 116c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["CSV output for ",["$","code","code-0",{"children":"payments_report"}]," report type. Contains all payments including failed and declined ones."]}],"\n",["$","p","p-1",{"children":"The first row is a header row with column names. Subsequent rows contain payment data, one row per payment."}],"\n",["$","p","p-2",{"children":["For failed and declined payments, ",["$","code","code-0",{"children":"fee_amount"}]," and ",["$","code","code-1",{"children":"fee_currency"}]," are omitted. For payments made without a card, card-related columns are omitted."]}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["The actual response is a raw ",["$","code","code-0",{"children":"text/csv"}]," string. The object schema below is a documentation convention only: OpenAPI's schema language (JSON Schema) describes JSON data shapes and has no native construct for typed CSV columns, so each property here corresponds to a CSV column header rather than a JSON field."]}]}]]}]]}] 116d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Date and time the transaction was created."}]]}] 116e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Date and time the transaction was completed."}]]}] 116f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Date and time the payout was affected by this transaction."}]]}] 1170:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["Indicates whether this transaction contributed to the payout amount (",["$","code","code-0",{"children":"true"}],") or not (",["$","code","code-1",{"children":"false"}],")."]}],"\n",["$","p","p-1",{"children":"Note: despite the name implying a monetary amount, this field is a boolean flag. A rename is planned for a future API version."}]]}] 1171:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["Unique identifier of the ledger transaction in the core settlement system. Matches ",["$","code","code-0",{"children":"transaction_id"}]," in the settlement report for the same event. Use ",["$","code","code-1",{"children":"order_id"}]," to cross-reference with the payments report."]}]]}] 1172:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["Unique identifier of the order associated with this transaction. Use ",["$","code","code-0",{"children":"order_id"}]," to cross-reference with the payments report or settlement report."]}]]}] 1173:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unique identifier of the dispute associated with a chargeback or chargeback reversal transaction. Empty for rows not related to a dispute."}]]}] 1174:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["Merchant's order reference. The value of the ",["$","code","code-0",{"children":"merchant_order_data.reference"}]," field set when the order was created."]}]]}] 1176:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Type of the transaction."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Value","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"Settlement"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Settlement of a payment into the merchant balance.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"Refund"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Refund entry reducing the merchant balance.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"External transfer money return"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Return of an external transfer entry.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"Topup"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Balance top-up entry.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-4",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"Topup Return"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Reversal of a top-up entry.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-5",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"Customer dispute - withdrawal"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Chargeback or dispute withdrawal from the merchant balance.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-6",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"Customer dispute - won"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Reversal of a previous dispute withdrawal.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-7",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"Transfer from linked pocket"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Transfer from a linked balance pocket.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-8",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"Automatic negative balance recovery"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Automatic recovery entry for a negative balance.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-9",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"Payout"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Payout-related ledger entry.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-10",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"Payout to an external account"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Transfer of payout funds to an external account.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-11",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"Transfer from linked pocket with FX"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Transfer from a linked pocket involving FX conversion.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-12",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"Payout with FX"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Payout-related entry involving FX conversion.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-13",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"Money reserve block"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Reserve block entry withholding funds.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"$L11d1","$L11d2","$L11d3","$L11d4"],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 1177:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unique identifier of the IC++ charge related to the transaction, if applicable."}]]}] 1178:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Amount of the transaction in the transaction currency."}]]}] 1179:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_4217","target":"_blank","rel":"noreferrer","children":"ISO 4217"}]," currency code of the transaction."]}]]}] 117a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Amount of the transaction in the billing currency."}]]}] 117b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_4217","target":"_blank","rel":"noreferrer","children":"ISO 4217"}]," currency code of the billing amount."]}]]}] 117c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"State of the transaction."}]]}] 117d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["For refunds and chargebacks, the ledger transaction ID of the original payment that this transaction reverses. Corresponds to ",["$","code","code-0",{"children":"transaction_id"}]," on the original settlement row."]}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["Populated only for reversal-type rows — for example, when ",["$","code","code-0",{"children":"type"}]," is ",["$","code","code-1",{"children":"Refund"}]," or ",["$","code","code-2",{"children":"Customer dispute - withdrawal"}],"."]}]}]]}]]}] 117e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Amount of the original transaction."}]]}] 117f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_4217","target":"_blank","rel":"noreferrer","children":"ISO 4217"}]," currency code of the original transaction."]}]]}] 1180:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["For refunds and chargebacks, the order ID of the original payment that this transaction reverses. Refunds and chargebacks create their own order in the system, so ",["$","code","code-0",{"children":"order_id"}]," refers to the refund or chargeback order while ",["$","code","code-1",{"children":"original_order_id"}]," points back to the original payment's order. For settlement transactions, matches ",["$","code","code-2",{"children":"order_id"}],"."]}]]}] 1181:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Channel through which the original order was created."}],"\n",["$","p","p-1",{"children":"The value depends on the original order source and integration. It may reflect platform-specific or externally provided values, so the set of returned values should not be treated as a fixed enum."}]]}] 1182:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["Merchant's order reference for the original order. The value of the ",["$","code","code-0",{"children":"merchant_order_data.reference"}]," field set when the original order was created."]}]]}] 1183:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Total fee amount charged for the transaction."}]]}] 1184:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_4217","target":"_blank","rel":"noreferrer","children":"ISO 4217"}]," currency code of the fee."]}]]}] 1185:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Total amount settled on the merchant's account."}]]}] 1186:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_4217","target":"_blank","rel":"noreferrer","children":"ISO 4217"}]," currency code of the settled amount."]}]]}] 1187:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unique identifier of the location associated with the transaction."}]]}] 1188:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Name of the location associated with the transaction."}]]}] 1189:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unique identifier of the submerchant associated with the transaction."}]]}] 118a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Reference of the bank transfer for this payout. This value is the same across all rows in the report, as each report covers a single payout."}]]}] 118b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Total amount of this payout. This value is the same across all rows in the report, as each report covers a single payout."}]]}] 118c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["Date and time the payout covered by this report was created, in ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_8601","target":"_blank","rel":"noreferrer","children":"ISO 8601"}]," UTC date-time format. This value is the same across all rows in the report, as each report covers a single payout."]}]]}] 118d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["CSV output for ",["$","code","code-0",{"children":"payout_statement_report"}]," report type. Contains all transactions that contributed to a specific payout."]}],"\n",["$","p","p-1",{"children":"The first row is a header row with column names. Subsequent rows contain transaction data, one row per transaction."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["The actual response is a raw ",["$","code","code-0",{"children":"text/csv"}]," string. The object schema below is a documentation convention only: OpenAPI's schema language (JSON Schema) describes JSON data shapes and has no native construct for typed CSV columns, so each property here corresponds to a CSV column header rather than a JSON field."]}]}]]}]]}] 118e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["Unique identifier of the payment in the acquiring system. Corresponds to ",["$","code","code-0",{"children":"payment_id"}]," in the payments report for the same payment."]}]]}] 118f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Date and time the payment was created."}]]}] 1190:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Type of the IC++ transaction."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Value","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"SALE"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Fee breakdown for a payment sale.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"REFUND"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Fee breakdown for a refund.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"DISPUTE"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Fee breakdown for a dispute-related transaction.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 1191:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Transaction amount."}]]}] 1192:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_4217","target":"_blank","rel":"noreferrer","children":"ISO 4217"}]," currency code of the transaction."]}]]}] 1193:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Amount settled on the merchant's account."}]]}] 1194:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_4217","target":"_blank","rel":"noreferrer","children":"ISO 4217"}]," currency code of the settled amount."]}]]}] 1195:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["Payment method used. Returns ",["$","code","code-0",{"children":"REVOLUT_PAY"}]," for Revolut Pay, or the card scheme name for card payments."]}]]}] 1196:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Card BIN scheme."}]]}] 1197:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Card funding type."}]]}] 1198:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Description of the order."}]]}] 1199:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["Merchant's order reference. The value of the ",["$","code","code-0",{"children":"merchant_order_data.reference"}]," field set when the order was created."]}]]}] 119a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["For refunds and disputes, the acquiring ID of the original payment. Corresponds to ",["$","code","code-0",{"children":"original_payment_id"}]," in the payments report."]}]]}] 119b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"IC++ acquiring markup fee component."}]]}] 119c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Interchange fee component. Omitted for Revolut Pay transactions."}]]}] 119d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Card scheme fee component. Omitted for Revolut Pay transactions."}]]}] 119e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Card commercial category."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Value","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"COMMERCIAL"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Business or corporate card.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"CONSUMER"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Personal card.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 119f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Channel through which the order was created."}]]}] 11a0:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["Country of the card, as an ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2","target":"_blank","rel":"noreferrer","children":"ISO 3166-1 alpha-2"}]," code."]}]]}] 11a1:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["CSV output for ",["$","code","code-0",{"children":"icpp_fee_breakdown_report"}]," report type. Contains IC++ fee components broken down per transaction for a specific IC++ charge."]}],"\n",["$","p","p-1",{"children":"The first row is a header row with column names. Subsequent rows contain one row per transaction."}],"\n",["$","p","p-2",{"children":[["$","code","code-0",{"children":"card_interchange_fee_amount"}]," and ",["$","code","code-1",{"children":"card_scheme_fee_amount"}]," are omitted for Revolut Pay transactions."]}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":["The actual response is a raw ",["$","code","code-0",{"children":"text/csv"}]," string. The object schema below is a documentation convention only: OpenAPI's schema language (JSON Schema) describes JSON data shapes and has no native construct for typed CSV columns, so each property here corresponds to a CSV column header rather than a JSON field."]}],["$","p","p-1",{"children":[["$","code","code-0",{"children":"payment_method"}]," in this report returns ",["$","code","code-1",{"children":"REVOLUT_PAY"}]," for Revolut Pay transactions. Other reports use ",["$","code","code-2",{"children":"PAY_WITH_REVOLUT"}]," for the same payment method."]}]]}]]}]]}] 11a5:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"OK"}]]}] 11a6:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An identifier that can be used to determine what went wrong."}],"\n",["$","p","p-1",{"children":"Error codes are not globally unique, but uniqueness is guaranteed within endpoints."}]]}] 11a7:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Some human readable text describing what went wrong."}]]}] 11a8:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://www.unixtimestamp.com/","target":"_blank","rel":"noreferrer","children":"UNIX timestamp"}]," of the date and time the error happened."]}]]}] 11a9:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Bad Request"}]]}] 11aa:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An identifier that can be used to determine what went wrong."}],"\n",["$","p","p-1",{"children":"Error codes are not globally unique, but uniqueness is guaranteed within endpoints."}]]}] 11ab:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Some human readable text describing what went wrong."}]]}] 11ac:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://www.unixtimestamp.com/","target":"_blank","rel":"noreferrer","children":"UNIX timestamp"}]," of the date and time the error happened."]}]]}] 11ad:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unauthorized"}]]}] 11ae:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An identifier that can be used to determine what went wrong."}],"\n",["$","p","p-1",{"children":"Error codes are not globally unique, but uniqueness is guaranteed within endpoints."}]]}] 11af:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Some human readable text describing what went wrong."}]]}] 11b0:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://www.unixtimestamp.com/","target":"_blank","rel":"noreferrer","children":"UNIX timestamp"}]," of the date and time the error happened."]}]]}] 11b1:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Not Found"}]]}] 11b5:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Use this endpoint to download the generated report file."}],"\n",["$","p","p-1",{"children":["A generated report file is available for 24 hours after report generation finishes. After that, the report run becomes ",["$","code","code-0",{"children":"expired"}]," and the file can no longer be downloaded."]}],"\n",["$","p","p-2",{"children":["The response is a raw ",["$","code","code-0",{"children":"text/csv"}]," file. The first row contains the column headers. The columns included depend on the report type used when creating the report run, and the ",["$","code","code-1",{"children":"options.columns"}]," list if specified."]}],"\n",["$","h3","h3-0",{"children":"IDs across report types"}],"\n",["$","p","p-3",{"children":"Revolut uses two separate ID systems across report types:"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"ID column","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"System","className":"eowryt6","ref":"$undefined"}],["$","th","th-2",{"children":"Report types","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":[["$","code","code-0",{"children":"payment_id"}],", ",["$","code","code-1",{"children":"id"}]],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":[["$","strong","strong-0",{"children":"Acquiring system"}]," - identifies a payment attempt"],"className":"eowryt7","ref":"$undefined"}],["$","td","td-2",{"children":[["$","code","code-0",{"children":"payments_report"}],", ",["$","code","code-1",{"children":"icpp_fee_breakdown_report"}]],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"transaction_id"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":[["$","strong","strong-0",{"children":"Core ledger"}]," - identifies the settlement entry created when a payment is captured"],"className":"eowryt7","ref":"$undefined"}],["$","td","td-2",{"children":[["$","code","code-0",{"children":"settlement_report"}],", ",["$","code","code-1",{"children":"payout_statement_report"}],", ",["$","code","code-2",{"children":"custom_report"}]],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"order_id"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":[["$","strong","strong-0",{"children":"Both systems"}]," - bridges the acquiring and ledger perspectives"],"className":"eowryt7","ref":"$undefined"}],["$","td","td-2",{"children":[["$","code","code-0",{"children":"settlement_report"}],", ",["$","code","code-1",{"children":"payments_report"}],", ",["$","code","code-2",{"children":"payout_statement_report"}],", ",["$","code","code-3",{"children":"custom_report"}]],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}],"\n",["$","div","inlinealert-0",{"data-type":"tip","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"Lightbulb","color":"var(--rui-color-success)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["A payment and its resulting ledger transaction represent the same event but have ",["$","strong","strong-0",{"children":"different UUIDs"}],". To reconcile ",["$","code","code-0",{"children":"payments_report"}]," data against ",["$","code","code-1",{"children":"settlement_report"}]," data, join on ",["$","code","code-2",{"children":"order_id"}],"."]}]}]]}],"\n",["$","p","p-4",{"children":"Use the schema selector below to see the available columns for each report type."}]]}] 11b6:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["This parameter accepts the ",["$","a","a-0",{"href":"https://business.revolut.com/settings/apis?tab=merchant-api","target":"_blank","rel":"noreferrer","children":"Merchant API Secret key"}]," to authorise requests coming from the merchant's backend."]}],"\n",["$","p","p-1",{"children":["It ensures that ensures that each request is authenticated and authorised by verifying the secret key. The secret key should be included in all request headers as a ",["$","code","code-0",{"children":"Bearer"}]," token."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#authentication","target":"_blank","rel":"noreferrer","children":"Authentication"}]]}]}]]}]]}] 11b7:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A UUID string, typically used to identify resources."}]]}] 11b8:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unique ID of the report run."}]]}] 11d1:["$","tr","tr-14",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"Money reserve unblock"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Release of previously blocked reserve funds.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}] 11d2:["$","tr","tr-15",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"IC++ post-billing fee"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"IC++ fee charged after billing.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}] 11d3:["$","tr","tr-16",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"Fee refund"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Reversal of a previously charged fee.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}] 11d4:["$","tr","tr-17",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"Unrecognised transaction"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Transaction that does not map to a more specific category.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}] 11c6:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Each Merchant API request must contain an authorization header in the following format:"}],"\n","$L11d5","\n",["$","p","p-1",{"children":"To use this API, you need to generate API keys from your Revolut Business account. The Secret key is used in the authorization header for all server calls, while the Public key is provided with payment methods at checkout."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For detailed instructions on generating your API keys, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/get-started#generate-api-keys","target":"_blank","rel":"noreferrer","children":"Generate API keys"}],"."]}]}]]}]]}] 11d6:T2275,
transaction_id,order_id,original_order_id,started_date,updated_date,completed_date,payment_created_date,payment_captured_date,type,state,description,merchant_order_ext_ref,customer_id,amount,currency,settlement_amount,settlement_currency,payment_method,fee_amount,fee_currency,processing_fee_amount,processing_fee_currency,browser_url,location_id
67f66fa6-200c-aaef-8708-cb78366f8a30,67f66f41-3022-a623-827e-e0616c0d04e7,67f66f41-3022-a623-827e-e0616c0d04e7,2025-04-09T13:01:26.288638Z,2025-04-10T13:02:09.843018Z,2025-04-10T13:02:09.837719Z,2025-04-09T13:01:26.186Z,2025-04-10T13:02:09.837719Z,SETTLEMENT,COMPLETED,Summer hat,ORD-2025-0042,,100.00,GBP,99.00,GBP,CARD,1.00,GBP,1.00,GBP,https://sandbox-checkout.revolut.com/payment-link/1ae44a1c-3ea8-47ac-b736-7d7d4c992bb4,
67f66fb7-300d-bbff-9819-dc89477a9b41,67f67052-4133-b734-938f-f1727d1e15f8,67f66f41-3022-a623-827e-e0616c0d04e7,2025-04-10T09:10:00.000000Z,2025-04-10T09:12:00.000000Z,2025-04-10T09:12:00.000000Z,,,REFUND,COMPLETED,Refund for Summer hat,ORD-2025-0042-R1,,25.00,GBP,-25.00,GBP,CARD,0.00,GBP,0.00,GBP,https://sandbox-checkout.revolut.com/payment-link/1ae44a1c-3ea8-47ac-b736-7d7d4c992bb4,
67f66fc8-411e-cc10-a92a-ed9a588b0c52,67f67063-5244-c845-a49a-a2838e2f26a9,67f66f41-3022-a623-827e-e0616c0d04e7,2025-04-11T08:30:00.000000Z,2025-04-11T08:45:00.000000Z,2025-04-11T08:45:00.000000Z,,,CHARGEBACK,COMPLETED,Chargeback for Summer hat,ORD-2025-0042-CB1,,75.00,GBP,-75.00,GBP,CARD,0.00,GBP,0.00,GBP,https://sandbox-checkout.revolut.com/payment-link/1ae44a1c-3ea8-47ac-b736-7d7d4c992bb4,
67f66fd9-522f-dd21-ba3b-feab699a1d63,67f67074-6355-d956-b50a-a3949f3a37a0,67f66f41-3022-a623-827e-e0616c0d04e7,2025-04-15T10:00:00.000000Z,2025-04-15T10:05:00.000000Z,2025-04-15T10:05:00.000000Z,,,CHARGEBACK_REVERSAL,COMPLETED,Chargeback reversal for Summer hat,ORD-2025-0042-CBR1,,75.00,GBP,75.00,GBP,CARD,0.00,GBP,0.00,GBP,https://sandbox-checkout.revolut.com/payment-link/1ae44a1c-3ea8-47ac-b736-7d7d4c992bb4,
11c8:["$","div","200-text/csv-settlement_report",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$11d6"}}]}]],"$L11d7"]}] 11d8:Tca5,
transaction_id,order_id,payment_created_date,payment_captured_date,payment_method,amount,currency,state,updated_date
649ae37f-99ca-a7db-a4fb-5924af14ad7c,649ae35c-2558-adea-bf98-3a7156a764e7,2023-06-28T13:20:46.07498Z,2023-06-28T13:30:46.07498Z,PAY_WITH_REVOLUT,0.05,GBP,COMPLETED,2023-06-28T13:30:46.07498Z
649ae3de-e945-af9f-98c8-1d6172e350b5,649ae3ab-3998-ab2b-ad95-41b48346be69,2023-06-28T13:22:46.075569Z,2023-06-28T13:30:46.075569Z,PAY_WITH_REVOLUT,0.05,GBP,COMPLETED,2023-06-28T13:30:46.075569Z
649ae48b-37f6-a097-9cb0-4fc2a89d9e5a,649ae479-d7e8-a139-993b-bf75865c5059,2023-06-28T13:35:46.084289Z,2023-06-28T13:38:46.084289Z,PAY_WITH_REVOLUT,0.05,GBP,COMPLETED,2023-06-28T13:38:46.084289Z
11c9:["$","div","200-text/csv-custom_report",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$11d8"}}]}]],"$L11d9"]}] 11da:T7af,transaction_id,order_id,original_order_id,started_date,updated_date,completed_date,payment_created_date,payment_captured_date,type,state,description,merchant_order_ext_ref,customer_id,amount,currency,settlement_amount,settlement_currency,payment_method,fee_amount,fee_currency,processing_fee_amount,processing_fee_currency,browser_url,location_id 67f66fa6-200c-aaef-8708-cb78366f8a30,67f66f41-3022-a623-827e-e0616c0d04e7,67f66f41-3022-a623-827e-e0616c0d04e7,2025-04-09T13:01:26.288638Z,2025-04-10T13:02:09.843018Z,2025-04-10T13:02:09.837719Z,2025-04-09T13:01:26.186Z,2025-04-10T13:02:09.837719Z,SETTLEMENT,COMPLETED,Summer hat,ORD-2025-0042,,100.00,GBP,99.00,GBP,CARD,1.00,GBP,1.00,GBP,https://sandbox-checkout.revolut.com/payment-link/1ae44a1c-3ea8-47ac-b736-7d7d4c992bb4, 67f66fb7-300d-bbff-9819-dc89477a9b41,67f67052-4133-b734-938f-f1727d1e15f8,67f66f41-3022-a623-827e-e0616c0d04e7,2025-04-10T09:10:00.000000Z,2025-04-10T09:12:00.000000Z,2025-04-10T09:12:00.000000Z,,,REFUND,COMPLETED,Refund for Summer hat,ORD-2025-0042-R1,,25.00,GBP,-25.00,GBP,CARD,0.00,GBP,0.00,GBP,https://sandbox-checkout.revolut.com/payment-link/1ae44a1c-3ea8-47ac-b736-7d7d4c992bb4, 67f66fc8-411e-cc10-a92a-ed9a588b0c52,67f67063-5244-c845-a49a-a2838e2f26a9,67f66f41-3022-a623-827e-e0616c0d04e7,2025-04-11T08:30:00.000000Z,2025-04-11T08:45:00.000000Z,2025-04-11T08:45:00.000000Z,,,CHARGEBACK,COMPLETED,Chargeback for Summer hat,ORD-2025-0042-CB1,,75.00,GBP,-75.00,GBP,CARD,0.00,GBP,0.00,GBP,https://sandbox-checkout.revolut.com/payment-link/1ae44a1c-3ea8-47ac-b736-7d7d4c992bb4, 67f66fd9-522f-dd21-ba3b-feab699a1d63,67f67074-6355-d956-b50a-a3949f3a37a0,67f66f41-3022-a623-827e-e0616c0d04e7,2025-04-15T10:00:00.000000Z,2025-04-15T10:05:00.000000Z,2025-04-15T10:05:00.000000Z,,,CHARGEBACK_REVERSAL,COMPLETED,Chargeback reversal for Summer hat,ORD-2025-0042-CBR1,,75.00,GBP,75.00,GBP,CARD,0.00,GBP,0.00,GBP,https://sandbox-checkout.revolut.com/payment-link/1ae44a1c-3ea8-47ac-b736-7d7d4c992bb4,11d7:["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"$11da"}]}] 11d9:["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"transaction_id,order_id,payment_created_date,payment_captured_date,payment_method,amount,currency,state,updated_date\n649ae37f-99ca-a7db-a4fb-5924af14ad7c,649ae35c-2558-adea-bf98-3a7156a764e7,2023-06-28T13:20:46.07498Z,2023-06-28T13:30:46.07498Z,PAY_WITH_REVOLUT,0.05,GBP,COMPLETED,2023-06-28T13:30:46.07498Z\n649ae3de-e945-af9f-98c8-1d6172e350b5,649ae3ab-3998-ab2b-ad95-41b48346be69,2023-06-28T13:22:46.075569Z,2023-06-28T13:30:46.075569Z,PAY_WITH_REVOLUT,0.05,GBP,COMPLETED,2023-06-28T13:30:46.075569Z\n649ae48b-37f6-a097-9cb0-4fc2a89d9e5a,649ae479-d7e8-a139-993b-bf75865c5059,2023-06-28T13:35:46.084289Z,2023-06-28T13:38:46.084289Z,PAY_WITH_REVOLUT,0.05,GBP,COMPLETED,2023-06-28T13:38:46.084289Z"}]}] 11db:T1bfa,
payment_id,type,description,original_payment_id,order_id,state,reason,amount,currency,surcharge_amount,tip_amount,refunded_amount,created_date,captured_date,merchant_order_ext_ref,payment_method,location_id,customer_id,customer_card_number,customer_card_country,customer_card_brand,customer_card_type,customer_card_category,customer_email,fee_amount,fee_currency
67f66fa6-7e98-ae73-9570-50583cec116d,PAYMENT,Payment from customer,,67f66f41-3022-a623-827e-e0616c0d04e7,COMPLETED,,1.00,GBP,,0.00,0.00,2025-04-09T13:01:26.186Z,2025-04-10T13:02:09.837Z,ORD-2025-0042,CARD,,cust-0001-0000-0000-000000000001,528143******4148,GB,VISA,DEBIT,consumer,customer@example.com,0.01,GBP
6807b0a5-a367-afbf-b31f-353730b788b5,PAYMENT,Payment from customer,,6807b09c-c62a-a656-818e-f071ef67ee36,DECLINED,,10.01,GBP,,0.00,0.00,2025-04-22T15:07:17.352Z,,,PAY_WITH_REVOLUT,,,,,,,,customer@example.com,,
67efa316-db8a-aec6-8eb4-46e47b6ebdc4,PAYMENT,Payment from customer,,67efa305-be19-a456-a6a2-154b218ac386,FAILED,INSUFFICIENT_FUNDS,0.57,USD,,0.00,0.00,2025-04-04T09:15:02.13Z,,,CARD,,,222300******9399,GB,VISA,DEBIT,consumer,customer@example.com,,
11cb:["$","div","200-text/csv-payments_report",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$11db"}}]}]],"$L11dc"]}] 11dd:T1b7c,
created_date,completed_date,payout_affected_date,affected_payout_amount,transaction_id,order_id,dispute_id,merchant_order_reference,type,related_icpp_charge_id,transaction_amount,transaction_currency,billing_amount,billing_currency,state,original_transaction_id,original_transaction_amount,original_transaction_currency,original_order_id,original_order_channel,original_merchant_order_reference,fee_amount,fee_currency,settlement_amount,settlement_currency,location_id,location_name,submerchant_id,payout_transfer_reference,payout_total_amount,payout_date
2025-03-25T14:34:05.708899Z,2025-03-26T14:34:38.06903Z,2025-03-26T14:34:38.06903Z,true,67e2bedd-0e79-a8ea-ac4c-e9fd13693286,67e2be76-89c5-ae4f-9103-a152ae6f0584,,ORD-2025-0042,Settlement,,0.57,USD,0.57,USD,COMPLETED,67e2bedd-0e79-a8ea-ac4c-e9fd13693286,0.57,USD,67e2be76-89c5-ae4f-9103-a152ae6f0584,API,ORD-2025-0042,0.00,USD,0.57,USD,4a0f98a6-0f61-4e85-9ef0-7e5d0cb92ef0,Store London,,Revolut USD payout 2025-03-26 MerchantName,0.17,2025-03-26T15:00:00Z
2025-03-25T15:38:45.162946Z,2025-03-26T15:39:58.03824Z,2025-03-26T15:39:58.03824Z,true,67e2ce05-1a16-abeb-b05b-5059073bcdaa,67e2ce00-6665-a52b-9f10-368f886054d7,a81bba54-e3f9-450f-aa50-7aea8e4e5b9a,ORD-2025-0042-CB1,Customer dispute - withdrawal,,-0.40,USD,-0.40,USD,COMPLETED,67e2bedd-0e79-a8ea-ac4c-e9fd13693286,0.57,USD,67e2be76-89c5-ae4f-9103-a152ae6f0584,API,ORD-2025-0042,0.00,USD,-0.40,USD,4a0f98a6-0f61-4e85-9ef0-7e5d0cb92ef0,Store London,,Revolut USD payout 2025-03-26 MerchantName,0.17,2025-03-26T15:00:00Z
11cd:["$","div","200-text/csv-payout_statement_report",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$11dd"}}]}]],"$L11de"]}] 11df:T44d,
{
  "code": "string",
  "message": "string",
  "timestamp": 123
}
11ce:["$","div","400-application/json-default",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$11df"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"code\": \"string\",\n \"message\": \"string\",\n \"timestamp\": 123\n}"}]}]]}] 11e0:T44d,
{
  "code": "string",
  "message": "string",
  "timestamp": 123
}
11cf:["$","div","401-application/json-default",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$11e0"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"code\": \"string\",\n \"message\": \"string\",\n \"timestamp\": 123\n}"}]}]]}] 11e1:T44d,
{
  "code": "string",
  "message": "string",
  "timestamp": 123
}
11d0:["$","div","404-application/json-default",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$11e1"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"code\": \"string\",\n \"message\": \"string\",\n \"timestamp\": 123\n}"}]}]]}] 11e2:T468,payment_id,type,description,original_payment_id,order_id,state,reason,amount,currency,surcharge_amount,tip_amount,refunded_amount,created_date,captured_date,merchant_order_ext_ref,payment_method,location_id,customer_id,customer_card_number,customer_card_country,customer_card_brand,customer_card_type,customer_card_category,customer_email,fee_amount,fee_currency 67f66fa6-7e98-ae73-9570-50583cec116d,PAYMENT,Payment from customer,,67f66f41-3022-a623-827e-e0616c0d04e7,COMPLETED,,1.00,GBP,,0.00,0.00,2025-04-09T13:01:26.186Z,2025-04-10T13:02:09.837Z,ORD-2025-0042,CARD,,cust-0001-0000-0000-000000000001,528143******4148,GB,VISA,DEBIT,consumer,customer@example.com,0.01,GBP 6807b0a5-a367-afbf-b31f-353730b788b5,PAYMENT,Payment from customer,,6807b09c-c62a-a656-818e-f071ef67ee36,DECLINED,,10.01,GBP,,0.00,0.00,2025-04-22T15:07:17.352Z,,,PAY_WITH_REVOLUT,,,,,,,,customer@example.com,, 67efa316-db8a-aec6-8eb4-46e47b6ebdc4,PAYMENT,Payment from customer,,67efa305-be19-a456-a6a2-154b218ac386,FAILED,INSUFFICIENT_FUNDS,0.57,USD,,0.00,0.00,2025-04-04T09:15:02.13Z,,,CARD,,,222300******9399,GB,VISA,DEBIT,consumer,customer@example.com,,11dc:["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"$11e2"}]}] 11e3:T5f7,created_date,completed_date,payout_affected_date,affected_payout_amount,transaction_id,order_id,dispute_id,merchant_order_reference,type,related_icpp_charge_id,transaction_amount,transaction_currency,billing_amount,billing_currency,state,original_transaction_id,original_transaction_amount,original_transaction_currency,original_order_id,original_order_channel,original_merchant_order_reference,fee_amount,fee_currency,settlement_amount,settlement_currency,location_id,location_name,submerchant_id,payout_transfer_reference,payout_total_amount,payout_date 2025-03-25T14:34:05.708899Z,2025-03-26T14:34:38.06903Z,2025-03-26T14:34:38.06903Z,true,67e2bedd-0e79-a8ea-ac4c-e9fd13693286,67e2be76-89c5-ae4f-9103-a152ae6f0584,,ORD-2025-0042,Settlement,,0.57,USD,0.57,USD,COMPLETED,67e2bedd-0e79-a8ea-ac4c-e9fd13693286,0.57,USD,67e2be76-89c5-ae4f-9103-a152ae6f0584,API,ORD-2025-0042,0.00,USD,0.57,USD,4a0f98a6-0f61-4e85-9ef0-7e5d0cb92ef0,Store London,,Revolut USD payout 2025-03-26 MerchantName,0.17,2025-03-26T15:00:00Z 2025-03-25T15:38:45.162946Z,2025-03-26T15:39:58.03824Z,2025-03-26T15:39:58.03824Z,true,67e2ce05-1a16-abeb-b05b-5059073bcdaa,67e2ce00-6665-a52b-9f10-368f886054d7,a81bba54-e3f9-450f-aa50-7aea8e4e5b9a,ORD-2025-0042-CB1,Customer dispute - withdrawal,,-0.40,USD,-0.40,USD,COMPLETED,67e2bedd-0e79-a8ea-ac4c-e9fd13693286,0.57,USD,67e2be76-89c5-ae4f-9103-a152ae6f0584,API,ORD-2025-0042,0.00,USD,-0.40,USD,4a0f98a6-0f61-4e85-9ef0-7e5d0cb92ef0,Store London,,Revolut USD payout 2025-03-26 MerchantName,0.17,2025-03-26T15:00:00Z11de:["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"$11e3"}]}] 11d5:["$","div","CodeBlock-0",{"className":"wzy01m0 _18b50nc0","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"
'Authorization: Bearer <yourSecretApiKey>'
"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"'Authorization: Bearer '\n"}]}]]}] 11ed:T4c1,Automatic cancellation period for uncaptured orders, specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. After this period, the authorised payment is automatically cancelled and the order is cancelled. Maximum: 7 days = `P7D`. :::note The following limitations apply: - Cannot be a negative value. - Cannot be updated if the new value is less than or equal to the elapsed time since authorisation. **Failing scenario:** - Original value: 7 days - Time since authorisation: 3 days - Update value: 2 days In this scenario, an error is returned. **Successful scenario:** - Original value: 7 days - Time since authorisation: 3 days - Update value: 4 days In this scenario, the parameter can be updated. - Cannot be updated if cancellation is ≤ 30 minutes away. **Failing scenario:** - Original value: 12 hours - Time since authorisation: 11 hours 40 minutes In this scenario, an error is returned. **Successful scenario:** - Original value: 12 hours - Time since authorisation: 11 hours 20 minutes In this scenario, the parameter can be updated. :::11f4:T50a,Object containing information about a customer. If you have it, we strongly advise providing at least either `id`, `phone`, or `email`. Using the [Customers operations](https://developer.revolut.com/docs/api/merchant#tag-customers), you can manage customer instances. The following behaviours apply to different use cases: | Use case | API behavior | | -------- | ------------ | | Existing customer | If `id` was provided, we ignore other customer details and associate the customer with the order.

If either `email`, `phone`, or `full_name` was provided (without an existing customer's `id`), we always create a new customer, irrespective of another, existing customer object having the same details. | | New customer | If either `email`, `phone`, or `full_name` was provided, we create a new customer, irrespective of another customer object having the same details.

If `id` of a non-existent customer was provided, we return a `404` error, irrespective of other details provided. | :::note To avoid unintentional duplication of customer records, search for an existing customer by email or phone using the [List customers](https://developer.revolut.com/docs/api/merchant#retrieve-customer-list) endpoint first, then provide `customer.id` in the order. :::121d:T9bc,A unique identifier for a payment method, always 44 characters long. This fingerprint can be used to uniquely identify various payment methods. #### Fingerprint generation | Payment method | Description | | -------- | ----------- | | **All payment methods** | A fingerprint is generated for all payment methods, including cards, Revolut Pay (card, account-to-account payments), Apple Pay, and Google Pay. | | **Cards (Revolut Pay & Card Gateway)** | For cards, the fingerprint is based on the PAN. Cards processed via Revolut Pay and our card gateway will share the same fingerprint. Renewed cards (new expiry/CVV) retain the same fingerprint for efficient blocking. | | **Apple Pay & Google Pay** | Since Apple Pay and Google Pay provide us Device PANs (DPAN), the fingerprint is based on the DPAN provided by Apple/Google, not the connected card's PAN. This means that a new DPAN (and fingerprint) is generated for cards in case they are re-added to the customer's digital wallet, or added to different devices. | #### Detecting duplicate payment methods Fingerprints are a valuable tool for detecting duplicate payment methods by identifying if a payment method has been seen before. This capability, in turn, helps in preventing various types of misuse (e.g., exploitation of free trials, or association with known problematic accounts, which can be a form of fraud). To effectively use fingerprints for this purpose, you will need to create and maintain your own lists (e.g., blocklists of known problematic fingerprints, allowlists for trusted customers, or tracking frequently used fingerprints). The ideal way to utilise fingerprints is by combining them with a manual capture process. While automatic capture with subsequent refunds for problematic payments is possible, manual capture based on fingerprint validation is recommended. During your manual capture workflow, after a payment was authorised: - Check the fingerprint status by comparing it against your maintained lists and internal business rules. - If you decide to proceed with the payment (e.g., the fingerprint is not on a blocklist, or matches a trusted customer's previous payment method): [Capture the order](https://developer.revolut.com/docs/api/merchant#capture-order). - If you decide not to proceed with the payment (e.g., the fingerprint matches a known fraudulent fingerprint, or exhibits suspicious patterns): [Cancel the order](https://developer.revolut.com/docs/api/merchant#cancel-order).122f:T9bc,A unique identifier for a payment method, always 44 characters long. This fingerprint can be used to uniquely identify various payment methods. #### Fingerprint generation | Payment method | Description | | -------- | ----------- | | **All payment methods** | A fingerprint is generated for all payment methods, including cards, Revolut Pay (card, account-to-account payments), Apple Pay, and Google Pay. | | **Cards (Revolut Pay & Card Gateway)** | For cards, the fingerprint is based on the PAN. Cards processed via Revolut Pay and our card gateway will share the same fingerprint. Renewed cards (new expiry/CVV) retain the same fingerprint for efficient blocking. | | **Apple Pay & Google Pay** | Since Apple Pay and Google Pay provide us Device PANs (DPAN), the fingerprint is based on the DPAN provided by Apple/Google, not the connected card's PAN. This means that a new DPAN (and fingerprint) is generated for cards in case they are re-added to the customer's digital wallet, or added to different devices. | #### Detecting duplicate payment methods Fingerprints are a valuable tool for detecting duplicate payment methods by identifying if a payment method has been seen before. This capability, in turn, helps in preventing various types of misuse (e.g., exploitation of free trials, or association with known problematic accounts, which can be a form of fraud). To effectively use fingerprints for this purpose, you will need to create and maintain your own lists (e.g., blocklists of known problematic fingerprints, allowlists for trusted customers, or tracking frequently used fingerprints). The ideal way to utilise fingerprints is by combining them with a manual capture process. While automatic capture with subsequent refunds for problematic payments is possible, manual capture based on fingerprint validation is recommended. During your manual capture workflow, after a payment was authorised: - Check the fingerprint status by comparing it against your maintained lists and internal business rules. - If you decide to proceed with the payment (e.g., the fingerprint is not on a blocklist, or matches a trusted customer's previous payment method): [Capture the order](https://developer.revolut.com/docs/api/merchant#capture-order). - If you decide not to proceed with the payment (e.g., the fingerprint matches a known fraudulent fingerprint, or exhibits suspicious patterns): [Cancel the order](https://developer.revolut.com/docs/api/merchant#cancel-order).1241:T9bc,A unique identifier for a payment method, always 44 characters long. This fingerprint can be used to uniquely identify various payment methods. #### Fingerprint generation | Payment method | Description | | -------- | ----------- | | **All payment methods** | A fingerprint is generated for all payment methods, including cards, Revolut Pay (card, account-to-account payments), Apple Pay, and Google Pay. | | **Cards (Revolut Pay & Card Gateway)** | For cards, the fingerprint is based on the PAN. Cards processed via Revolut Pay and our card gateway will share the same fingerprint. Renewed cards (new expiry/CVV) retain the same fingerprint for efficient blocking. | | **Apple Pay & Google Pay** | Since Apple Pay and Google Pay provide us Device PANs (DPAN), the fingerprint is based on the DPAN provided by Apple/Google, not the connected card's PAN. This means that a new DPAN (and fingerprint) is generated for cards in case they are re-added to the customer's digital wallet, or added to different devices. | #### Detecting duplicate payment methods Fingerprints are a valuable tool for detecting duplicate payment methods by identifying if a payment method has been seen before. This capability, in turn, helps in preventing various types of misuse (e.g., exploitation of free trials, or association with known problematic accounts, which can be a form of fraud). To effectively use fingerprints for this purpose, you will need to create and maintain your own lists (e.g., blocklists of known problematic fingerprints, allowlists for trusted customers, or tracking frequently used fingerprints). The ideal way to utilise fingerprints is by combining them with a manual capture process. While automatic capture with subsequent refunds for problematic payments is possible, manual capture based on fingerprint validation is recommended. During your manual capture workflow, after a payment was authorised: - Check the fingerprint status by comparing it against your maintained lists and internal business rules. - If you decide to proceed with the payment (e.g., the fingerprint is not on a blocklist, or matches a trusted customer's previous payment method): [Capture the order](https://developer.revolut.com/docs/api/merchant#capture-order). - If you decide not to proceed with the payment (e.g., the fingerprint matches a known fraudulent fingerprint, or exhibits suspicious patterns): [Cancel the order](https://developer.revolut.com/docs/api/merchant#cancel-order).1253:T9bc,A unique identifier for a payment method, always 44 characters long. This fingerprint can be used to uniquely identify various payment methods. #### Fingerprint generation | Payment method | Description | | -------- | ----------- | | **All payment methods** | A fingerprint is generated for all payment methods, including cards, Revolut Pay (card, account-to-account payments), Apple Pay, and Google Pay. | | **Cards (Revolut Pay & Card Gateway)** | For cards, the fingerprint is based on the PAN. Cards processed via Revolut Pay and our card gateway will share the same fingerprint. Renewed cards (new expiry/CVV) retain the same fingerprint for efficient blocking. | | **Apple Pay & Google Pay** | Since Apple Pay and Google Pay provide us Device PANs (DPAN), the fingerprint is based on the DPAN provided by Apple/Google, not the connected card's PAN. This means that a new DPAN (and fingerprint) is generated for cards in case they are re-added to the customer's digital wallet, or added to different devices. | #### Detecting duplicate payment methods Fingerprints are a valuable tool for detecting duplicate payment methods by identifying if a payment method has been seen before. This capability, in turn, helps in preventing various types of misuse (e.g., exploitation of free trials, or association with known problematic accounts, which can be a form of fraud). To effectively use fingerprints for this purpose, you will need to create and maintain your own lists (e.g., blocklists of known problematic fingerprints, allowlists for trusted customers, or tracking frequently used fingerprints). The ideal way to utilise fingerprints is by combining them with a manual capture process. While automatic capture with subsequent refunds for problematic payments is possible, manual capture based on fingerprint validation is recommended. During your manual capture workflow, after a payment was authorised: - Check the fingerprint status by comparing it against your maintained lists and internal business rules. - If you decide to proceed with the payment (e.g., the fingerprint is not on a blocklist, or matches a trusted customer's previous payment method): [Capture the order](https://developer.revolut.com/docs/api/merchant#capture-order). - If you decide not to proceed with the payment (e.g., the fingerprint matches a known fraudulent fingerprint, or exhibits suspicious patterns): [Cancel the order](https://developer.revolut.com/docs/api/merchant#cancel-order).1259:T9bc,A unique identifier for a payment method, always 44 characters long. This fingerprint can be used to uniquely identify various payment methods. #### Fingerprint generation | Payment method | Description | | -------- | ----------- | | **All payment methods** | A fingerprint is generated for all payment methods, including cards, Revolut Pay (card, account-to-account payments), Apple Pay, and Google Pay. | | **Cards (Revolut Pay & Card Gateway)** | For cards, the fingerprint is based on the PAN. Cards processed via Revolut Pay and our card gateway will share the same fingerprint. Renewed cards (new expiry/CVV) retain the same fingerprint for efficient blocking. | | **Apple Pay & Google Pay** | Since Apple Pay and Google Pay provide us Device PANs (DPAN), the fingerprint is based on the DPAN provided by Apple/Google, not the connected card's PAN. This means that a new DPAN (and fingerprint) is generated for cards in case they are re-added to the customer's digital wallet, or added to different devices. | #### Detecting duplicate payment methods Fingerprints are a valuable tool for detecting duplicate payment methods by identifying if a payment method has been seen before. This capability, in turn, helps in preventing various types of misuse (e.g., exploitation of free trials, or association with known problematic accounts, which can be a form of fraud). To effectively use fingerprints for this purpose, you will need to create and maintain your own lists (e.g., blocklists of known problematic fingerprints, allowlists for trusted customers, or tracking frequently used fingerprints). The ideal way to utilise fingerprints is by combining them with a manual capture process. While automatic capture with subsequent refunds for problematic payments is possible, manual capture based on fingerprint validation is recommended. During your manual capture workflow, after a payment was authorised: - Check the fingerprint status by comparing it against your maintained lists and internal business rules. - If you decide to proceed with the payment (e.g., the fingerprint is not on a blocklist, or matches a trusted customer's previous payment method): [Capture the order](https://developer.revolut.com/docs/api/merchant#capture-order). - If you decide not to proceed with the payment (e.g., the fingerprint matches a known fraudulent fingerprint, or exhibits suspicious patterns): [Cancel the order](https://developer.revolut.com/docs/api/merchant#cancel-order).129a:T5ef,Object containing additional information about an airline booking associated with the order. Use this object to provide required data to enable **Revolut Flight Alerts**. This feature allows users to receive real-time flight updates such as check-in reminders, boarding alerts, and notifications for cancellations or delays in the Revolut app. To enable **Revolut Flight Alerts** functionalities in the Revolut app, the following fields are **required** on order creation or update, before capturing the order: ``` tickets_purchase, journey_legs, booking_url ``` :::note These are the specific data field requirements for merchants who must provide airline data. Note that these requirements can be extended on a case by case basis as decided by Revolut. | Required for airline/charter merchants | Required for OTA merchants | | -------------------------------------- | -------------------------- | |
  • `booking_id`
  • `fulfillment_date`
  • `passengers[].first_name`
  • `passengers[].last_name`
  • `journey_legs[].pnr`
  • `journey_legs[].sequence`
  • `journey_legs[].flight_number`
  • `journey_legs[].travel_date`
  • `journey_legs[].airline_code`
  • `journey_legs[].departure_airport_code`
  • `journey_legs[].arrival_airport_code`
|
  • `booking_id`
  • `fulfillment_date`
  • `passengers[].first_name`
  • `passengers[].last_name`
  • `journey_legs[].pnr`
  • `journey_legs[].arrival_airport_code`
| :::1325:T480,You can set a dynamic statement descriptor for your orders by providing a custom suffix. A statement descriptor is the text shown on cardholders' bank or card statements, helping them recognise a transaction or merchant. This field can be used to send extra information with the statement descriptor for card transactions. The complete descriptor is built using the following format: `{base}*{suffix}`, where: - **`{base}`** is the existing descriptor configured in the Revolut Business dashboard (**Settings > Business account > Merchant profile > Statement descriptor**). - **`{suffix}`** is defined by the `statement_descriptor_suffix` field. :::note - If the combined descriptor's length (base + suffix) exceeds the character limits of card scheme providers, the final value will be truncated. For example if the limit is 22 characters, the base descriptor is `"base"` and the suffix is `"testdescriptorsuffix"`, the final descriptor becomes `"base*testdescriptorsuf"`. - The final statement descriptor shown on a cardholder's statement may vary by issuing bank, as some banks apply their own custom formatting or truncation rules. :::1a:["$","$7a","retrieve-order",{"children":[["$","section",null,{"className":"y9a0do0","data-variant":"endpoint","children":["$","$L7b",null,{"responses":{"200":{"description":"Order retrieved","content":{"application/json":{"schema":{"title":"Order v5","type":"object","description":"To process the order from a credit or debit card, you create an `Order` object. You can then retrieve, capture, cancel, refund, or pay an order using its unique `id`. Alternatively, you can use its unique `token` to process a card payment with the Revolut Checkout Widget.","properties":{"id":{"type":"string","format":"uuid","description":"Permanent order ID used to retrieve, capture, cancel, or refund an order after authorization.","descriptionNode":"$L11e4"},"token":{"type":"string","description":"Temporary ID for the order, which expires when the payment is authorised.\n\nThe order `token` is used for [token-based initialisation](https://developer.revolut.com/docs/sdks/merchant-web-sdk/initialisation/token-based), and is returned by the `createOrder` callback in the following payment methods:\n\n- [Embedded Checkout](https://developer.revolut.com/docs/sdks/merchant-web-sdk/payment-methods/embedded-checkout#embedded-checkout-options-interface)\n- [Revolut Pay](https://developer.revolut.com/docs/sdks/merchant-web-sdk/payment-methods/revolut-pay#widget-payments-revolut-pay-options)\n- [Apple Pay and Google Pay](https://developer.revolut.com/docs/sdks/merchant-web-sdk/payment-methods/apple-pay-google-pay#payment-request-options-interface)\n- [Pay by Bank](https://developer.revolut.com/docs/sdks/merchant-web-sdk/payment-methods/pay-by-bank#pay-by-bank-options-interface)","descriptionNode":"$L11e5"},"type":{"type":"string","description":"The type of the order.","enum":"$19:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:orders:items:properties:type:enum","descriptionNode":"$L11e6"},"state":{"type":"string","description":"The state of the order in its lifecycle.\n\n| State | Description |\n|-------|-------------|\n| `pending` | Order created, awaiting payment |\n| `processing` | Payment is being processed |\n| `authorised` | Payment authorised but not yet captured (for manual capture) |\n| `completed` | Payment successfully captured and settled |\n| `cancelled` | Order was cancelled |\n| `failed` | Payment failed |\n\n:::info\nFor more information, see: [Order and payment lifecycle](https://developer.revolut.com/docs/guides/merchant/reference/order-lifecycle)\n:::","enum":"$19:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:orders:items:properties:state:enum","examples":"$19:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:orders:items:properties:state:examples","descriptionNode":"$L11e7"},"created_at":{"type":"string","description":"The date and time the order was created.","format":"date-time","descriptionNode":"$L11e8"},"updated_at":{"type":"string","description":"The date and time the order was last updated.","format":"date-time","descriptionNode":"$L11e9"},"description":{"type":"string","description":"The description of the order.","descriptionNode":"$L11ea"},"capture_mode":{"type":"string","description":"The capture mode of the order. `automatic` is used by default.\n\n| Parameter value | Description |\n| --------------- | ----------- |\n| `automatic` | The order is captured automatically after payment authorisation. |\n| `manual` | The order is not captured automatically. You must manually capture the order later. |\n\n:::info\nFor more information, see [Capture an order](https://developer.revolut.com/docs/api/merchant#capture-order).\n:::","default":"automatic","enum":"$19:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:orders:items:properties:capture_mode:enum","descriptionNode":"$L11eb"},"authorisation_type":{"type":"string","description":"The type of authorisation for the order. Used with manual capture mode. If omitted, `final` is used by default.\n\n### Pre-authorisation\n\nPre-authorisation allows you to reserve funds on a customer's card without immediately capturing them. This is useful for scenarios like:\n\n- Hotel bookings where the final amount may vary\n- Car rentals where additional charges may apply\n- Deposits that need to be held temporarily\n\n| Parameter value | Description |\n| --------------- | ----------- |\n| `final` | Standard authorisation for immediate or near-immediate capture. |\n| `pre_authorisation` | Reserve funds for later capture, used with manual capture mode. |\n\n:::note\nPre-authorisation must be used with `capture_mode: manual`. For more information, see [Capture an order](https://developer.revolut.com/docs/api/merchant#capture-order).\n:::","default":"final","enum":"$19:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:orders:items:properties:authorisation_type:enum","descriptionNode":"$L11ec"},"cancel_authorised_after":{"type":"string","format":"duration","description":"$11ed","descriptionNode":"$L11ee"},"amount":{"type":"integer","description":"The order total expressed in minor currency units, according to the [ISO 4217 standard](https://en.wikipedia.org/wiki/ISO_4217). For example, `7034` in `EUR` corresponds to €70.34.\n\n:::info\n- Conversion between major and minor units varies by currency. For instance, `100` minor units equal £1.00 in `GBP`, whereas in `ISK` they represent 100 units. For more details, see the [ISO 4217 standard](https://en.wikipedia.org/wiki/ISO_4217).\n- If `line_items` are provided, the order `amount` must equal the sum of all line items' `total_amount`.\n- For card payments with a non-zero amount, the order `amount` must be at least **$0.005** (or equivalent in different currencies, calculated using Revolut's exchange rate on the payment date). Otherwise, card payments can't be performed.\n:::","descriptionNode":"$L11ef"},"outstanding_amount":{"type":"integer","description":"The amount not yet paid for a given order (in minor currency units). For example, `7034` represents €70.34. \n\nThe value in this field may differ from `amount` if there are partial payments associated with the order.","descriptionNode":"$L11f0"},"refunded_amount":{"type":"integer","description":"The amount that was refunded from the order (in minor currency units). For example, `7034` represents €70.34. \n\nThis applies to orders that have been refunded (i.e., orders of type `payment` that have a related `refund` order).","descriptionNode":"$L11f1"},"currency":{"type":"string","format":"ISO 4217","minLength":3,"maxLength":3,"description":"[ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) currency code in upper case.\n\n:::info\nFor more information about the supported currencies, see: [Help Center](https://help.revolut.com/business/help/merchant-accounts/payments/in-which-currencies-can-i-accept-payments/).\n:::","descriptionNode":"$L11f2"},"settlement_currency":{"type":"string","description":"[ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) currency code in upper case. \n\nIf `settlement_currency` is different from the value of `currency`, the money will be exchanged when the amount is settled to your merchant account. In case of a refund or chargeback, the money will be exchanged to the order's initial `currency`.\n\nIf `settlement_currency` is not specified, this value is taken from `currency`.\n\n:::info\nFor more information about the supported currencies, see: [Help Center](https://help.revolut.com/business/help/merchant-accounts/payments/in-which-currencies-can-i-accept-payments/).\n:::","descriptionNode":"$L11f3"},"customer":{"type":"object","description":"$11f4","properties":{"id":{"type":"string","format":"uuid","description":"Permanent ID of a customer used to retrieve, update, delete a customer. This ID can also be used to link customer to an order.\n\n:::note\nIf you provide the customer's ID during order creation, no other customer data is required, they will be parsed automatically from the referenced customer object.\n:::","descriptionNode":"$L11f5"},"full_name":{"type":"string","description":"The full name of the customer.","descriptionNode":"$L11f6"},"phone":{"type":"string","description":"The phone number of the customer in [E.164 format](https://en.wikipedia.org/wiki/E.164).","descriptionNode":"$L11f7"},"email":{"type":"string","format":"email","description":"The email address of the customer.","descriptionNode":"$L11f8"},"date_of_birth":{"type":"string","format":"date","description":"The birth date of the customer.","descriptionNode":"$L11f9"}},"descriptionNode":"$L11fa"},"payments":{"type":"array","description":"The details of all the payments that have been made towards this order (successful or unsuccessful).","items":{"type":"object","description":"Represents a payment for an order.\n\nFor pre-authorised payments, the `authorised_amount` field tracks the currently authorised amount, which may differ from `amount` during incremental authorisation processing.","properties":{"id":{"type":"string","format":"uuid","description":"The ID of the payment.","descriptionNode":"$L11fb"},"state":{"type":"string","description":"The status of the payment.","enum":"$21:props:children:0:props:children:props:responses:200:content:application/json:schema:items:properties:state:enum","descriptionNode":"$L11fc"},"decline_reason":{"type":"string","description":"The reason for a `failed` or `declined` payment.\n\nA failed or declined payment can result from multiple reasons. To learn more, check our [failure reasons](https://developer.revolut.com/docs/guides/merchant/reference/error-codes/decline-reasons).","enum":"$21:props:children:0:props:children:props:responses:200:content:application/json:schema:items:properties:decline_reason:enum","descriptionNode":"$L11fd"},"bank_message":{"type":"string","description":"The reason for a `failed` or `declined` payment, sent by the financial institution processing the payment.","descriptionNode":"$L11fe"},"created_at":{"type":"string","format":"date-time","description":"The date and time the payment was created.","descriptionNode":"$L11ff"},"updated_at":{"type":"string","format":"date-time","description":"The date and time the payment was last updated.","descriptionNode":"$L1200"},"token":{"type":"string","format":"uuid","description":"Temporary token of the payment used to fetch the reward offer during checkout and link user registrations to the given offers. \n\nThe token is only valid for a limited time.","descriptionNode":"$L1201"},"amount":{"type":"integer","format":"int64","minimum":0,"description":"The payment amount in minor units (e.g., cents). The value of this field depends on the payment type and state.\n\n| Payment type | State | Amount value |\n|--------------|-------|--------------|\n| Standard payment | Any | Total payment amount |\n| Pre-authorised payment | `authorisation_started` | New amount being authorised (during increment processing) |\n| Pre-authorised payment | `authorised` | Currently authorised amount (equals `authorised_amount`) |\n\n:::info\nFor pre-authorised payments, see the `authorised_amount` field for tracking the currently authorised amount separately.\n:::","examples":"$21:props:children:0:props:children:props:responses:200:content:application/json:schema:items:properties:amount:examples","descriptionNode":"$L1202"},"authorised_amount":{"type":"integer","description":"The currently authorised amount for this payment (in minor units).\n\nFor pre-authorised payments with incremental authorization:\n- Initially equals the `amount` field\n- Remains unchanged during increment processing\n- Updates to new amount upon successful increment\n- Remains at original amount if increment is declined\n\nFor standard payments, this field may not be present or will equal the `amount` field.","examples":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:authorised_amount:examples","descriptionNode":"$L1203"},"currency":{"type":"string","format":"ISO 4217","minLength":3,"maxLength":3,"description":"[ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) currency code in upper case.\n\n:::info\nFor more information about the supported currencies, see: [Help Center](https://help.revolut.com/business/help/merchant-accounts/payments/in-which-currencies-can-i-accept-payments/).\n:::","descriptionNode":"$L1204"},"settled_amount":{"type":"integer","description":"The amount of the settled payment (minor currency unit). For example, `7034` stands for €70.34.","descriptionNode":"$L1205"},"settled_currency":{"type":"string","description":"The currency of the settled payment. [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) currency code in upper case.\n\n:::info\nFor more information about the supported currencies, see: [Help Center](https://help.revolut.com/business/help/merchant-accounts/payments/in-which-currencies-can-i-accept-payments/).\n:::","descriptionNode":"$L1206"},"payment_method":{"type":"object","description":"The details of the payment method used to make the payment.","discriminator":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:discriminator","oneOf":[{"type":"object","description":"Object containing details of a card used via Apple Pay.","properties":{"id":{"type":"string","format":"uuid","description":"ID of the saved payment method.\n\n:::note\nThe `id` parameter is only returned when the payment method is saved.\n:::","descriptionNode":"$L1207"},"type":{"type":"string","enum":"$21:props:children:0:props:children:props:responses:200:content:application/json:schema:items:properties:payment_method:oneOf:2:properties:type:enum","description":"The type of payment method used to pay for the order.\n\nAvailable values:\n\n| Payment method `type` | Description |\n| --------------------- | ----------- |\n| `apple_pay` | The customer paid the order using Apple Pay. |\n| `card` | The customer paid the order using their credit or debit card. |\n| `google_pay` | The customer paid the order using Google Pay. |\n| `revolut_pay_card` | The customer paid the order via Revolut Pay using their credit or debit card. |\n| `revolut_pay_account` | The customer paid the order via Revolut Pay using their Revolut account. |\n| `sepa_direct_debit` | The customer paid the order using SEPA Direct Debit. |","descriptionNode":"$L1208"},"card_brand":{"type":"string","description":"The type of the card.","enum":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:0:properties:card_brand:enum","descriptionNode":"$L1209"},"funding":{"type":"string","description":"The type of card funding.","enum":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:0:properties:funding:enum","descriptionNode":"$L120a"},"card_country_code":{"type":"string","description":"The 2-letter country code of the country where the card was issued.","descriptionNode":"$L120b"},"card_bin":{"type":"string","description":"The BIN of the card.","minLength":6,"maxLength":6,"descriptionNode":"$L120c"},"card_last_four":{"type":"string","description":"The last four digits of the card number.","minLength":4,"maxLength":4,"descriptionNode":"$L120d"},"card_expiry":{"type":"string","format":"MM/YY","description":"The expiry date of the card in the format of MM/YY.","descriptionNode":"$L120e"},"cardholder_name":{"type":"string","description":"The name of the cardholder.","descriptionNode":"$L120f"},"checks":{"type":"object","description":"The details of the check for card payment. Only for orders with successful payments.","properties":{"three_ds":{"type":"object","description":"The details of the 3D Secure check. Only for orders with successful payments.\n\n:::note\nNot returned for Apple Pay and Google Pay payments.\n:::","properties":{"eci":{"type":"string","description":"The Electronic Commerce Indicator (ECI) value corresponds to the authentication result and indicates the level of security used when the payment information was provided.","descriptionNode":"$L1210"},"state":{"type":"string","description":"The result of 3D Secure check.","enum":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:0:properties:checks:properties:three_ds:properties:state:enum","descriptionNode":"$L1211"},"version":{"type":"integer","description":"The 3D Secure version.","descriptionNode":"$L1212"}},"descriptionNode":"$L1213"},"cvv_verification":{"type":"string","description":"The result of CVV verification.\n\n| Parameter value | Description |\n| ----- | ----------- |\n| `match` | CVV matches the card's CVV |\n| `not_match` | CVV does not match the card's CVV |\n| `incorrect` | CVV format is incorrect for this type of card |\n| `not_processed` | CVV verification was not performed |","enum":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:0:properties:checks:properties:cvv_verification:enum","descriptionNode":"$L1214"},"address":{"type":"string","description":"The result of address verification.","enum":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:0:properties:checks:properties:address:enum","descriptionNode":"$L1215"},"postcode":{"type":"string","description":"The result of postcode verification.","enum":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:0:properties:checks:properties:postcode:enum","descriptionNode":"$L1216"},"cardholder":{"type":"string","description":"The result of cardholder verification.","enum":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:0:properties:checks:properties:cardholder:enum","descriptionNode":"$L1217"}},"descriptionNode":"$L1218"},"authorisation_code":{"type":"string","description":"The authorisation code (or auth code) is a short, alphanumeric code returned by the cardholder's issuing bank to the merchant's terminal or payment gateway.\n\nIt serves as confirmation that the transaction has been approved and funds are available.","pattern":"^[a-zA-Z0-9]{2,6}$","minLength":2,"maxLength":6,"examples":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:0:properties:authorisation_code:examples","descriptionNode":"$L1219"},"arn":{"type":"string","description":"Acquirer Reference Number (ARN) of the payment.\n\n:::note\nOnly returned for refund payments made by a card.\n:::","minLength":23,"maxLength":23,"examples":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:0:properties:arn:examples","descriptionNode":"$L121a"},"capture_deadline":{"type":"string","format":"date-time","description":"The date and time by which the payment must be captured.\n\nAfter this deadline, the authorised funds may be automatically released by the card issuer.","descriptionNode":"$L121b"},"terminal_hardware_id":{"type":"string","description":"The hardware identifier of the Revolut Terminal device used to process the payment.\n\n:::note\nOnly present for card-present transactions processed via Revolut Terminal.\n:::","descriptionNode":"$L121c"},"fingerprint":{"type":"string","minLength":44,"maxLength":44,"description":"$121d","examples":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:0:properties:fingerprint:examples","descriptionNode":"$L121e"},"network_transaction_id":{"type":"string","description":"The Network Transaction ID (NTI) is a unique identifier assigned by the card scheme (e.g., Visa or Mastercard) to a card transaction.\n\nIt can be used to trace the transaction across the payment network, link recurring or instalment payments to the original authorisation, and support dispute resolution.","descriptionNode":"$L121f"}},"required":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:0:required","descriptionNode":"$L1220"},{"type":"object","description":"Object containing details of the card used for the payment.","properties":{"id":{"type":"string","format":"uuid","description":"ID of the saved payment method.\n\n:::note\nThe `id` parameter is only returned when the payment method is saved.\n:::","descriptionNode":"$L1221"},"type":{"type":"string","enum":"$21:props:children:0:props:children:props:responses:200:content:application/json:schema:items:properties:payment_method:oneOf:2:properties:type:enum","description":"The type of payment method used to pay for the order.\n\nAvailable values:\n\n| Payment method `type` | Description |\n| --------------------- | ----------- |\n| `apple_pay` | The customer paid the order using Apple Pay. |\n| `card` | The customer paid the order using their credit or debit card. |\n| `google_pay` | The customer paid the order using Google Pay. |\n| `revolut_pay_card` | The customer paid the order via Revolut Pay using their credit or debit card. |\n| `revolut_pay_account` | The customer paid the order via Revolut Pay using their Revolut account. |\n| `sepa_direct_debit` | The customer paid the order using SEPA Direct Debit. |","descriptionNode":"$L1222"},"card_brand":{"type":"string","description":"The type of the card.","enum":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:1:properties:card_brand:enum","descriptionNode":"$L1223"},"funding":{"type":"string","description":"The type of card funding.","enum":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:1:properties:funding:enum","descriptionNode":"$L1224"},"card_country_code":{"type":"string","description":"The 2-letter country code of the country where the card was issued.","descriptionNode":"$L1225"},"card_bin":{"type":"string","description":"The BIN of the card.","minLength":6,"maxLength":6,"descriptionNode":"$L1226"},"card_last_four":{"type":"string","description":"The last four digits of the card number.","minLength":4,"maxLength":4,"descriptionNode":"$L1227"},"card_expiry":{"type":"string","format":"MM/YY","description":"The expiry date of the card in the format of MM/YY.","descriptionNode":"$L1228"},"cardholder_name":{"type":"string","description":"The name of the cardholder.","descriptionNode":"$L1229"},"checks":{"type":"object","description":"The details of the check for card payment. Only for orders with successful payments.","properties":{"three_ds":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payments:items:properties:payment_method:oneOf:0:properties:checks:properties:three_ds","cvv_verification":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payments:items:properties:payment_method:oneOf:0:properties:checks:properties:cvv_verification","address":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payments:items:properties:payment_method:oneOf:0:properties:checks:properties:address","postcode":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payments:items:properties:payment_method:oneOf:0:properties:checks:properties:postcode","cardholder":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payments:items:properties:payment_method:oneOf:0:properties:checks:properties:cardholder"},"descriptionNode":"$L122a"},"authorisation_code":{"type":"string","description":"The authorisation code (or auth code) is a short, alphanumeric code returned by the cardholder's issuing bank to the merchant's terminal or payment gateway.\n\nIt serves as confirmation that the transaction has been approved and funds are available.","pattern":"^[a-zA-Z0-9]{2,6}$","minLength":2,"maxLength":6,"examples":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:0:properties:authorisation_code:examples","descriptionNode":"$L122b"},"arn":{"type":"string","description":"Acquirer Reference Number (ARN) of the payment.\n\n:::note\nOnly returned for refund payments made by a card.\n:::","minLength":23,"maxLength":23,"examples":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:0:properties:arn:examples","descriptionNode":"$L122c"},"capture_deadline":{"type":"string","format":"date-time","description":"The date and time by which the payment must be captured.\n\nAfter this deadline, the authorised funds may be automatically released by the card issuer.","descriptionNode":"$L122d"},"terminal_hardware_id":{"type":"string","description":"The hardware identifier of the Revolut Terminal device used to process the payment.\n\n:::note\nOnly present for card-present transactions processed via Revolut Terminal.\n:::","descriptionNode":"$L122e"},"fingerprint":{"type":"string","minLength":44,"maxLength":44,"description":"$122f","examples":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:0:properties:fingerprint:examples","descriptionNode":"$L1230"},"network_transaction_id":{"type":"string","description":"The Network Transaction ID (NTI) is a unique identifier assigned by the card scheme (e.g., Visa or Mastercard) to a card transaction.\n\nIt can be used to trace the transaction across the payment network, link recurring or instalment payments to the original authorisation, and support dispute resolution.","descriptionNode":"$L1231"}},"required":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:1:required","descriptionNode":"$L1232"},{"type":"object","description":"Object containing details of a card used via Google Pay.","properties":{"id":{"type":"string","format":"uuid","description":"ID of the saved payment method.\n\n:::note\nThe `id` parameter is only returned when the payment method is saved.\n:::","descriptionNode":"$L1233"},"type":{"type":"string","enum":"$21:props:children:0:props:children:props:responses:200:content:application/json:schema:items:properties:payment_method:oneOf:2:properties:type:enum","description":"The type of payment method used to pay for the order.\n\nAvailable values:\n\n| Payment method `type` | Description |\n| --------------------- | ----------- |\n| `apple_pay` | The customer paid the order using Apple Pay. |\n| `card` | The customer paid the order using their credit or debit card. |\n| `google_pay` | The customer paid the order using Google Pay. |\n| `revolut_pay_card` | The customer paid the order via Revolut Pay using their credit or debit card. |\n| `revolut_pay_account` | The customer paid the order via Revolut Pay using their Revolut account. |\n| `sepa_direct_debit` | The customer paid the order using SEPA Direct Debit. |","descriptionNode":"$L1234"},"card_brand":{"type":"string","description":"The type of the card.","enum":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:2:properties:card_brand:enum","descriptionNode":"$L1235"},"funding":{"type":"string","description":"The type of card funding.","enum":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:2:properties:funding:enum","descriptionNode":"$L1236"},"card_country_code":{"type":"string","description":"The 2-letter country code of the country where the card was issued.","descriptionNode":"$L1237"},"card_bin":{"type":"string","description":"The BIN of the card.","minLength":6,"maxLength":6,"descriptionNode":"$L1238"},"card_last_four":{"type":"string","description":"The last four digits of the card number.","minLength":4,"maxLength":4,"descriptionNode":"$L1239"},"card_expiry":{"type":"string","format":"MM/YY","description":"The expiry date of the card in the format of MM/YY.","descriptionNode":"$L123a"},"cardholder_name":{"type":"string","description":"The name of the cardholder.","descriptionNode":"$L123b"},"checks":{"type":"object","description":"The details of the check for card payment. Only for orders with successful payments.","properties":{"three_ds":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payments:items:properties:payment_method:oneOf:0:properties:checks:properties:three_ds","cvv_verification":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payments:items:properties:payment_method:oneOf:0:properties:checks:properties:cvv_verification","address":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payments:items:properties:payment_method:oneOf:0:properties:checks:properties:address","postcode":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payments:items:properties:payment_method:oneOf:0:properties:checks:properties:postcode","cardholder":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payments:items:properties:payment_method:oneOf:0:properties:checks:properties:cardholder"},"descriptionNode":"$L123c"},"authorisation_code":{"type":"string","description":"The authorisation code (or auth code) is a short, alphanumeric code returned by the cardholder's issuing bank to the merchant's terminal or payment gateway.\n\nIt serves as confirmation that the transaction has been approved and funds are available.","pattern":"^[a-zA-Z0-9]{2,6}$","minLength":2,"maxLength":6,"examples":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:0:properties:authorisation_code:examples","descriptionNode":"$L123d"},"arn":{"type":"string","description":"Acquirer Reference Number (ARN) of the payment.\n\n:::note\nOnly returned for refund payments made by a card.\n:::","minLength":23,"maxLength":23,"examples":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:0:properties:arn:examples","descriptionNode":"$L123e"},"capture_deadline":{"type":"string","format":"date-time","description":"The date and time by which the payment must be captured.\n\nAfter this deadline, the authorised funds may be automatically released by the card issuer.","descriptionNode":"$L123f"},"terminal_hardware_id":{"type":"string","description":"The hardware identifier of the Revolut Terminal device used to process the payment.\n\n:::note\nOnly present for card-present transactions processed via Revolut Terminal.\n:::","descriptionNode":"$L1240"},"fingerprint":{"type":"string","minLength":44,"maxLength":44,"description":"$1241","examples":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:0:properties:fingerprint:examples","descriptionNode":"$L1242"},"network_transaction_id":{"type":"string","description":"The Network Transaction ID (NTI) is a unique identifier assigned by the card scheme (e.g., Visa or Mastercard) to a card transaction.\n\nIt can be used to trace the transaction across the payment network, link recurring or instalment payments to the original authorisation, and support dispute resolution.","descriptionNode":"$L1243"}},"required":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:2:required","descriptionNode":"$L1244"},{"type":"object","description":"Object containing details of a card used via Revolut Pay.","properties":{"id":{"type":"string","format":"uuid","description":"ID of the saved payment method.\n\n:::note\nThe `id` parameter is only returned when the payment method is saved.\n:::","descriptionNode":"$L1245"},"type":{"type":"string","enum":"$21:props:children:0:props:children:props:responses:200:content:application/json:schema:items:properties:payment_method:oneOf:2:properties:type:enum","description":"The type of payment method used to pay for the order.\n\nAvailable values:\n\n| Payment method `type` | Description |\n| --------------------- | ----------- |\n| `apple_pay` | The customer paid the order using Apple Pay. |\n| `card` | The customer paid the order using their credit or debit card. |\n| `google_pay` | The customer paid the order using Google Pay. |\n| `revolut_pay_card` | The customer paid the order via Revolut Pay using their credit or debit card. |\n| `revolut_pay_account` | The customer paid the order via Revolut Pay using their Revolut account. |\n| `sepa_direct_debit` | The customer paid the order using SEPA Direct Debit. |","descriptionNode":"$L1246"},"card_brand":{"type":"string","description":"The type of the card.","enum":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:3:properties:card_brand:enum","descriptionNode":"$L1247"},"funding":{"type":"string","description":"The type of card funding.","enum":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:3:properties:funding:enum","descriptionNode":"$L1248"},"card_country_code":{"type":"string","description":"The 2-letter country code of the country where the card was issued.","descriptionNode":"$L1249"},"card_bin":{"type":"string","description":"The BIN of the card.","minLength":6,"maxLength":6,"descriptionNode":"$L124a"},"card_last_four":{"type":"string","description":"The last four digits of the card number.","minLength":4,"maxLength":4,"descriptionNode":"$L124b"},"card_expiry":{"type":"string","format":"MM/YY","description":"The expiry date of the card in the format of MM/YY.","descriptionNode":"$L124c"},"cardholder_name":{"type":"string","description":"The name of the cardholder.","descriptionNode":"$L124d"},"checks":{"type":"object","description":"The details of the check for card payment. Only for orders with successful payments.","properties":{"three_ds":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payments:items:properties:payment_method:oneOf:0:properties:checks:properties:three_ds","cvv_verification":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payments:items:properties:payment_method:oneOf:0:properties:checks:properties:cvv_verification","address":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payments:items:properties:payment_method:oneOf:0:properties:checks:properties:address","postcode":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payments:items:properties:payment_method:oneOf:0:properties:checks:properties:postcode","cardholder":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payments:items:properties:payment_method:oneOf:0:properties:checks:properties:cardholder"},"descriptionNode":"$L124e"},"authorisation_code":{"type":"string","description":"The authorisation code (or auth code) is a short, alphanumeric code returned by the cardholder's issuing bank to the merchant's terminal or payment gateway.\n\nIt serves as confirmation that the transaction has been approved and funds are available.","pattern":"^[a-zA-Z0-9]{2,6}$","minLength":2,"maxLength":6,"examples":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:0:properties:authorisation_code:examples","descriptionNode":"$L124f"},"arn":{"type":"string","description":"Acquirer Reference Number (ARN) of the payment.\n\n:::note\nOnly returned for refund payments made by a card.\n:::","minLength":23,"maxLength":23,"examples":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:0:properties:arn:examples","descriptionNode":"$L1250"},"capture_deadline":{"type":"string","format":"date-time","description":"The date and time by which the payment must be captured.\n\nAfter this deadline, the authorised funds may be automatically released by the card issuer.","descriptionNode":"$L1251"},"terminal_hardware_id":{"type":"string","description":"The hardware identifier of the Revolut Terminal device used to process the payment.\n\n:::note\nOnly present for card-present transactions processed via Revolut Terminal.\n:::","descriptionNode":"$L1252"},"fingerprint":{"type":"string","minLength":44,"maxLength":44,"description":"$1253","examples":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:0:properties:fingerprint:examples","descriptionNode":"$L1254"},"network_transaction_id":{"type":"string","description":"The Network Transaction ID (NTI) is a unique identifier assigned by the card scheme (e.g., Visa or Mastercard) to a card transaction.\n\nIt can be used to trace the transaction across the payment network, link recurring or instalment payments to the original authorisation, and support dispute resolution.","descriptionNode":"$L1255"}},"required":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:3:required","descriptionNode":"$L1256"},{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"ID of the saved payment method.\n\n:::note\nThe `id` parameter is only returned when the payment method is saved.\n:::","descriptionNode":"$L1257"},"type":{"type":"string","enum":"$21:props:children:0:props:children:props:responses:200:content:application/json:schema:items:properties:payment_method:oneOf:2:properties:type:enum","description":"The type of payment method used to pay for the order.\n\nAvailable values:\n\n| Payment method `type` | Description |\n| --------------------- | ----------- |\n| `apple_pay` | The customer paid the order using Apple Pay. |\n| `card` | The customer paid the order using their credit or debit card. |\n| `google_pay` | The customer paid the order using Google Pay. |\n| `revolut_pay_card` | The customer paid the order via Revolut Pay using their credit or debit card. |\n| `revolut_pay_account` | The customer paid the order via Revolut Pay using their Revolut account. |\n| `sepa_direct_debit` | The customer paid the order using SEPA Direct Debit. |","descriptionNode":"$L1258"},"fingerprint":{"type":"string","minLength":44,"maxLength":44,"description":"$1259","examples":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:0:properties:fingerprint:examples","descriptionNode":"$L125a"}},"required":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:4:required"},{"type":"object","description":"Object containing details of a SEPA Direct Debit payment.\n\n:::info\nFor more information, see: [SEPA Direct Debit server-to-server integration](https://developer.revolut.com/docs/guides/merchant/accept-payments/payment-methods/sepa-direct-debit/server-to-server)\n:::","properties":{"id":{"type":"string","format":"uuid","description":"ID of the saved payment method.\n\n:::note\nThe `id` parameter is only returned when the payment method is saved for the merchant.\n:::","descriptionNode":"$L125b"},"type":{"type":"string","enum":"$21:props:children:0:props:children:props:responses:200:content:application/json:schema:items:properties:payment_method:oneOf:2:properties:type:enum","description":"The type of payment method used to pay for the order.\n\nAvailable values:\n\n| Payment method `type` | Description |\n| --------------------- | ----------- |\n| `apple_pay` | The customer paid the order using Apple Pay. |\n| `card` | The customer paid the order using their credit or debit card. |\n| `google_pay` | The customer paid the order using Google Pay. |\n| `revolut_pay_card` | The customer paid the order via Revolut Pay using their credit or debit card. |\n| `revolut_pay_account` | The customer paid the order via Revolut Pay using their Revolut account. |\n| `sepa_direct_debit` | The customer paid the order using SEPA Direct Debit. |","descriptionNode":"$L125c"},"debtor_iban_last_four":{"type":"string","description":"The last four digits of the debtor's IBAN.","minLength":4,"maxLength":4,"descriptionNode":"$L125d"},"debtor_name":{"type":"string","description":"The full name of the debtor as provided in the mandate.","descriptionNode":"$L125e"},"mandate_reference":{"type":"string","description":"The unique mandate reference generated by Revolut. Include this in pre-debit notifications sent to your customers.","descriptionNode":"$L125f"}},"required":"$21:props:children:0:props:children:props:responses:200:content:application/json:schema:items:properties:payment_method:oneOf:2:required","descriptionNode":"$L1260"}],"descriptionNode":"$L1261"},"authentication_challenge":{"type":"object","description":"Details about the authentication challenge that should be performed to complete the authentication process. For more information about Revolut's 3DS solution, see: [3D Secure overview](https://developer.revolut.com/docs/guides/merchant/reference/3d-secure).\n\nOnly returned if the payment's state is `authentication_challenge`.","discriminator":"$21:props:children:0:props:children:props:responses:200:content:application/json:schema:items:properties:authentication_challenge:discriminator","oneOf":[{"title":"three_ds","type":"object","description":"Information about the 3DS challenge.","properties":{"type":{"type":"string","enum":"$21:props:children:0:props:children:props:responses:200:content:application/json:schema:items:properties:authentication_challenge:oneOf:0:properties:type:enum","description":"Type of the authentication challenge the payment triggers.","descriptionNode":"$L1262"},"acs_url":{"type":"string","format":"url","description":"The URL of the authentication challenge.","descriptionNode":"$L1263"}},"required":"$21:props:children:0:props:children:props:responses:200:content:application/json:schema:items:properties:authentication_challenge:oneOf:0:required","descriptionNode":"$L1264"},{"title":"three_ds_fingerprint","type":"object","description":"Information about the 3DS fingerprint challenge.","properties":{"type":{"type":"string","enum":"$21:props:children:0:props:children:props:responses:200:content:application/json:schema:items:properties:authentication_challenge:oneOf:0:properties:type:enum","description":"Type of the authentication challenge the payment triggers.","descriptionNode":"$L1265"},"fingerprint_url":{"type":"string","format":"url","description":"The URL of the fingerprint. (Used only internally by Revolut.)","descriptionNode":"$L1266"},"fingerprint_data":{"type":"string","format":"JSON","description":"Data about the fingerprint used for authentication. (Used only internally\nby Revolut.)","descriptionNode":"$L1267"}},"required":"$21:props:children:0:props:children:props:responses:200:content:application/json:schema:items:properties:authentication_challenge:oneOf:1:required","descriptionNode":"$L1268"}],"descriptionNode":"$L1269"},"billing_address":{"type":"object","description":"Object containing address details.","properties":{"street_line_1":{"type":"string","description":"Street line 1 information.","maxLength":100,"descriptionNode":"$L126a"},"street_line_2":{"type":"string","description":"Street line 2 information.","maxLength":100,"descriptionNode":"$L126b"},"region":{"type":"string","description":"The region associated with the address.","maxLength":100,"descriptionNode":"$L126c"},"city":{"type":"string","description":"The city associated with the address.","maxLength":100,"descriptionNode":"$L126d"},"country_code":{"type":"string","description":"The 2-letter country code of the country associated with the address.","maxLength":2,"descriptionNode":"$L126e"},"postcode":{"type":"string","description":"The postcode associated with the address.","maxLength":100,"descriptionNode":"$L126f"}},"required":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:billing_address:required","descriptionNode":"$L1270"},"risk_level":{"type":"string","description":"The risk level of the card.\n\nIf the risk level is `high`, the payment might be declined.","enum":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:risk_level:enum","descriptionNode":"$L1271"},"fees":{"type":"array","description":"The details of the order fee.","items":{"type":"object","properties":{"type":{"type":"string","description":"The type of the order fee.","enum":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:fees:items:properties:type:enum","descriptionNode":"$L1272"},"amount":{"type":"integer","description":"The amount of the payment fee (minor currency unit). For example, enter `7034` for €70.34 in the field.","descriptionNode":"$L1273"},"currency":{"type":"string","description":"The currency of the payment fee. [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) currency code in upper case.\n\n:::info\nFor more information about the supported currencies, see: [Help Center](https://help.revolut.com/business/help/merchant-accounts/payments/in-which-currencies-can-i-accept-payments/).\n:::","descriptionNode":"$L1274"}}},"descriptionNode":"$L1275"},"payer":{"title":"Payer","type":"object","description":"The person who made the payment. This object is present when an email or phone number is provided during the payment flow.\n\nCapturing payer details lets you identify exactly who authorised the charge, reach the right person for receipts or refund queries, and support compliance or fraud-review workflows where the paying identity matters.","properties":{"email":{"description":"The email of the person who made the payment.","type":"string","format":"email","descriptionNode":"$L1276"},"phone":{"description":"The phone number of the payer in [E.164 format](https://en.wikipedia.org/wiki/E.164).","type":"string","descriptionNode":"$L1277"}},"descriptionNode":"$L1278"}},"required":["id","state","created_at","updated_at","amount"],"descriptionNode":"$L1279"},"descriptionNode":"$L127a"},"incremental_authorisations":{"type":"array","description":"History of incremental authorisation attempts for this order.\n\nOnly present for orders with `authorisation_type: pre_authorisation`.\n\nContains all increment attempts in chronological order.","items":{"type":"object","description":"Represents a single incremental authorisation attempt on an order.\n\nThe `incremental_authorisations` array tracks all increment attempts (successful and failed) in chronological order.","properties":{"new_amount":{"type":"integer","description":"The new total amount requested in this increment (in minor units).","examples":[600],"descriptionNode":"$L127b"},"old_amount":{"type":"integer","description":"The previously authorised amount before this increment (in minor units).","examples":[500],"descriptionNode":"$L127c"},"state":{"type":"string","enum":["pending","processing","authorised","declined","failed"],"description":"The state of this incremental authorization attempt.\n\n| State | Description |\n|-------|-------------|\n| `pending` | Increment registered in system, not yet submitted to card network |\n| `processing` | Increment is being processed by card network |\n| `authorised` | Increment was successfully authorised |\n| `declined` | Increment was declined by card issuer |\n| `failed` | Increment failed due to technical error (not an issuer decline) |","descriptionNode":"$L127d"},"reference":{"type":"string","maxLength":255,"description":"External reference for this incremental authorisation.\n\n:::tip\nUse your internal charge or invoice ID. This reference is returned in webhooks for easy matching to your system.\n:::","examples":["CHG-67890"],"descriptionNode":"$L127e"},"line_items":{"type":"array","description":"Line items associated with this increment (if provided).\n\n:::note\nIf the increment is successful, these line items will override the existing order line items.\n:::","items":{"type":"object","properties":{"name":{"type":"string","maxLength":250,"description":"Name of the line item.","descriptionNode":"$L127f"},"type":{"type":"string","enum":"$19:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:orders:items:properties:line_items:items:properties:type:enum","description":"Type of the line item.","descriptionNode":"$L1280"},"quantity":{"type":"object","description":"Object representing the quantity details of a line item, including the amount and its associated unit of measurement.","properties":{"value":{"type":"number","format":"double","minimum":0,"description":"The number of units of the line item.","descriptionNode":"$L1281"},"unit":{"type":"string","maxLength":100,"description":"The measurement unit for the quantity, such as `cm`, or `kg`.","descriptionNode":"$L1282"}},"required":"$19:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:orders:items:properties:line_items:items:properties:quantity:required","descriptionNode":"$L1283"},"unit_price_amount":{"type":"integer","format":"int64","minimum":0,"description":"The unit price of the line item.","descriptionNode":"$L1284"},"total_amount":{"type":"integer","format":"int64","description":"The total amount to be paid for the line item, including taxes and discounts.","descriptionNode":"$L1285"},"external_id":{"type":"string","maxLength":250,"description":"Unique identifier of line item in the merchant's system.","descriptionNode":"$L1286"},"discounts":{"type":"array","maxItems":50,"description":"A list of discounts applied to the line item. Each discount should be subtracted from the total amount payable for the item.","items":{"type":"object","description":"Details of a discount applied to the line item, including its name and monetary value.","properties":{"name":{"type":"string","maxLength":100,"description":"The specific name or label of the discount applied to the line item.","descriptionNode":"$L1287"},"amount":{"type":"integer","format":"int64","minimum":0,"description":"The monetary value of the discount. ","descriptionNode":"$L1288"}},"required":"$19:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:orders:items:properties:line_items:items:properties:discounts:items:required","descriptionNode":"$L1289"},"descriptionNode":"$L128a"},"taxes":{"type":"array","maxItems":50,"description":"A list of taxes applied to the line item. Each tax should be added to the total amount payable for the item.","items":{"type":"object","description":"Details about a tax applied to the line item, including its name and the corresponding amount.","properties":{"name":{"type":"string","description":"The specific name or designation of the tax applied to the line item.","maxLength":100,"descriptionNode":"$L128b"},"amount":{"type":"integer","format":"int64","description":"The monetary value of the tax in minor currency units (e.g., cents for EUR).","minimum":0,"descriptionNode":"$L128c"}},"required":"$19:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:orders:items:properties:line_items:items:properties:taxes:items:required","descriptionNode":"$L128d"},"descriptionNode":"$L128e"},"image_urls":{"type":"array","maxItems":50,"description":"A list of URLs pointing to images related to the line item. These images can provide visual details or representations of the item.","items":{"type":"string","format":"uri","pattern":"^https?:\\/{2}.+/gi","maxLength":2000,"description":"URL to an image associated with the line item.\n\n:::warning\nRestrictions:\n- Must be a valid URI as defined by [RFC 3986](https://datatracker.ietf.org/doc/html/rfc3986)\n- URI scheme is required and must be either `http` or `https`\n- URI host is required and cannot be `localhost` or an IP address\n- Max length: `2000`\n- Reserved or invalid characters must be percent-encoded (for example, use `%20` instead of a space)\n:::","descriptionNode":"$L128f"},"descriptionNode":"$L1290"},"description":{"type":"string","maxLength":1024,"description":"Description of the line item.","descriptionNode":"$L1291"},"url":{"type":"string","format":"uri","pattern":"^https?:\\/{2}.+/gi","maxLength":2000,"description":"An HTTP/HTTPS URL that links to more information about the line item, such as a product page or details.\n\n:::warning\nRestrictions:\n- Must be a valid URI as defined by [RFC 3986](https://datatracker.ietf.org/doc/html/rfc3986)\n- URI scheme is required and must be either `http` or `https`\n- URI host is required and cannot be `localhost` or an IP address\n- Max length: `2000`\n- Reserved or invalid characters must be percent-encoded (for example, use `%20` instead of a space)\n:::","descriptionNode":"$L1292"}},"required":"$19:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:orders:items:properties:line_items:items:required"},"descriptionNode":"$L1293"},"reason":{"type":"string","description":"Reason why increment was declined or failed.\n\n:::note\nOnly present when `state` is `declined` or `failed`.\n:::","examples":["insufficient_funds"],"descriptionNode":"$L1294"}},"descriptionNode":"$L1295"},"descriptionNode":"$L1296"},"location_id":{"type":"string","format":"uuid","description":"Unique ID representing the location where merchants sells products.\n\n:::info\nFor more information, see: [Locations](https://developer.revolut.com/docs/api/merchant#tag-locations).\n::: ","descriptionNode":"$L1297"},"metadata":{"type":"object","description":"Additional information to track your orders in your system, by providing custom metadata using `\"\" : \"\"` pairs.\n\n:::warning\n**Restrictions:**\n\n- Both keys and values must be `string`s\n- Values cannot be `null`.\n- Max number of key-value pairs: `50`\n- Max length of values: `500` characters\n- Format of keys: Must start with a letter and contain only letters, digits, and underscores. Max 40 characters. Pattern: `^[a-zA-Z][a-zA-Z\\\\d_]{0,39}$`\n:::","maxProperties":50,"additionalProperties":{"type":"string","maxLength":500,"description":"Additional metadata value provided with the corresponding metadata key.","descriptionNode":"$L1298"},"examples":"$19:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:orders:items:properties:metadata:examples","descriptionNode":"$L1299"},"industry_data":{"type":"object","description":"Object containing industry-specific information associated with the order.\n\n:::info\nIn the following cases, industry-specific info is required. Omitting this information may trigger additional scrutiny and risk mitigation actions by the Revolut risk team.\n\n | Transaction type | Required for |\n | ---------------- | ----------- |\n | `airline` | Airlines and Online Travel Agencies (OTAs). |\n | `car_rental` | Car Rental Merchants and Online Travel Agencies (OTAs). |\n | `crypto` | Crypto merchants. |\n | `marketplace` | Marketplace merchants. |\n | `event` | Event ticket sellers. |\n | `lodging` | Lodging providers. |\n:::","discriminator":{"propertyName":"type","mapping":{"airline":"#/components/schemas/Airline-Data","car_rental":"#/components/schemas/Car-Rental","crypto":"#/components/schemas/Crypto-Transactions-v2","marketplace":"#/components/schemas/Marketplace-v2","event":"#/components/schemas/Events","lodging":"#/components/schemas/Lodging"}},"oneOf":[{"type":"object","description":"$129a","properties":{"type":{"type":"string","enum":["airline","car_rental","crypto","event","lodging","marketplace"],"description":"Type of the industry-specific data object, determining what additional data is expected.\n\nAvailable types:\n\n | Object type | Description |\n | ------------- | ----------- |\n | `airline` | Object containing information about a specific airline ticket purchase. |\n | `car_rental` | Object containing information about a car rental booking associated with the order. |\n | `crypto` | Object containing information about crypto transactions associated with the order. |\n | `marketplace` | This object is required by Mastercard and Visa for merchants operating as marketplaces under the **Merchant Category Code (MCC):** `5262`. The marketplace object ensures compliance with the card schemes' regulations by providing detailed information about the subseller involved in the transaction. |\n | `event` | Object containing information about event ticket bookings associated with the order. |\n | `lodging` | Object containing information about lodging bookings associated with the order. |","descriptionNode":"$L129b"},"booking_id":{"type":"string","description":"A unique identifier provided by the merchant associated with the order. \n\nThis `booking_id` is used to reference and correlate booking information with the Merchant API and the merchant's internal system.","descriptionNode":"$L129c"},"fulfillment_date":{"type":"string","format":"date-time","description":"The UTC date and time of the final journey leg.\n\n:::warning\nThe following limitations apply:\n - When creating or updating an order, `fulfillment_date` cannot be set to a date in the past.\n - When updating an order, if the current `fulfillment_date` value is already in the past, it cannot be modified. The date must remain as is to maintain data integrity for completed transactions.\n:::","descriptionNode":"$L129d"},"tickets_purchase":{"type":"boolean","description":"Flag indicating whether the order includes actual ticket purchases. Set to `true` if the order contains ticket purchases, and `false` if it does not (e.g., it **only** contains seat reservations, or baggage upgrades). \n\n:::info\nThis field is required for activating **Revolut Flight Alerts** functionalities within the Revolut app.\n\nProvide the info on order creation or update, before capturing the order.\n:::","descriptionNode":"$L129e"},"ticket_type":{"type":"string","enum":["fixed","flexible"],"description":"The type of the ticket.\n\n| Parameter value | Description |\n| --------------- | ----------- |\n| `fixed` | Non-modifiable once confirmed. |\n| `flexible` | Allows modifications or cancellations under specified conditions. |","descriptionNode":"$L129f"},"crs_code":{"type":"string","maxLength":4,"description":"The code of the Computer Reservation System (CRS) used to make the booking and purchase the ticket.","descriptionNode":"$L12a0"},"ticket_change_indicator":{"type":"string","enum":["new","modification"],"description":"Parameter indicating whether this order is related to a new ticket reservation or a modification of an existing one.","descriptionNode":"$L12a1"},"refundability":{"type":"string","enum":["refundable","non_refundable","partially_refundable"],"description":"Parameter indicating whether the booking is refundable, partially refundable, or not refundable.","descriptionNode":"$L12a2"},"passengers":{"type":"array","description":"Array containing information of passengers associated with the booking.","items":{"type":"object","properties":{"first_name":{"type":"string","description":"Passenger's first name.","descriptionNode":"$L12a3"},"last_name":{"type":"string","description":"Passenger's last name.","descriptionNode":"$L12a4"}},"required":["first_name","last_name"]},"descriptionNode":"$L12a5"},"journey_legs":{"type":"array","description":"Array containing information of journey legs associated with the booking.\n\n:::info\nThis field is required for activating **Revolut Flight Alerts** functionalities within the Revolut app. \n\nThis information is used to compile a tracking widget that provides real-time updates on flight status and sends notifications, such as a check-in reminders, boarding alerts, and notifications for cancellations or delays. \n\nTo enable the widget the following fields are required on order creation or update, before capturing the order:\n\n ```\n sequence,\n departure_airport_code,\n arrival_airport_code,\n flight_number,\n travel_date,\n airline_name,\n airline_code,\n ```\n:::","items":{"type":"object","properties":{"sequence":{"type":"integer","description":"Sequence of the journey legs. Increment by 1 for each flight included in the ticket.\n\nFor example: For a `FRA > LHR > DUB > LHR > FRA` journey the sequence will be assigned as:\n - `FRA > LHR`: 1\n - `LHR > DUB`: 2\n - `DUB > LHR`: 3\n - `LHR > FRA`: 4","descriptionNode":"$L12a6"},"departure_airport_code":{"type":"string","description":"The [IATA](https://www.iata.org/en/services/codes) 3-letter airport code for the departure airport.","descriptionNode":"$L12a7"},"arrival_airport_code":{"type":"string","description":"The [IATA](https://www.iata.org/en/services/codes) 3-letter airport code for the arrival airport.","descriptionNode":"$L12a8"},"flight_number":{"type":"string","description":"The flight identifier, without airline code.","descriptionNode":"$L12a9"},"fare_base_code":{"type":"string","description":"The fare base code for the given journey leg.","descriptionNode":"$L12aa"},"travel_date":{"type":"string","format":"date-time","description":"The UTC date and time of the flight departure for the given journey leg.","descriptionNode":"$L12ab"},"airline_name":{"type":"string","description":"The name of the airline associated with the journey leg.","descriptionNode":"$L12ac"},"airline_code":{"type":"string","description":"The IATA 2-letter accounting code identifying the airline associated with the journey leg.","descriptionNode":"$L12ad"},"pnr":{"type":"string","format":"alphanumeric","pattern":"^[a-zA-Z0-9]*$","maxLength":20,"description":"The Passenger Name Record (PNR) for the journey leg issued by the airline. \n\nPNR is a unique identifier for the booking, acting as a digital certificate allowing passengers to retrieve or manage their booking details.\n\n:::warning\nThis is a required field for OTAs.\n:::","descriptionNode":"$L12ae"}},"required":["sequence","departure_airport_code","arrival_airport_code","travel_date","airline_name","airline_code"]},"descriptionNode":"$L12af"},"booking_url":{"type":"string","format":"uri","pattern":"^https?:\\/{2}.+/gi","maxLength":2000,"description":"URL to the online portal for managing the airline booking, which includes check-in functionality. This URL may be a personalised, pre-populated check-in link specific to the user or a generic link, and it is essential for enabling direct access to booking details within the Revolut app.\n\n:::info\nThis field is required for activating **Revolut Flight Alerts** functionalities within the Revolut app. \n\nProvide the info on order creation or update, before capturing the order.\n:::\n\n:::warning\nRestrictions:\n- Must be a valid URI as defined by [RFC 3986](https://datatracker.ietf.org/doc/html/rfc3986)\n- URI scheme is required and must be either `http` or `https`\n- URI host is required and cannot be `localhost` or an IP address\n- Max length: `2000`\n- Reserved or invalid characters must be percent-encoded (for example, use `%20` instead of a space)\n:::","descriptionNode":"$L12b0"}},"required":["type","booking_id"],"descriptionNode":"$L12b1"},{"type":"object","description":"Object containing additional information about a car rental booking associated with the order.\n\n:::info\nThese are the specific data field requirements for merchants offering car rental. Note that these requirements can be extended on a case by case basis as decided by Revolut.\n\n```\nbooking_id\ndrop_off_date\nrefundability\n```\n:::","properties":{"type":{"type":"string","enum":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:0:properties:type:enum","description":"Type of the industry-specific data object, determining what additional data is expected.\n\nAvailable types:\n\n | Object type | Description |\n | ------------- | ----------- |\n | `airline` | Object containing information about a specific airline ticket purchase. |\n | `car_rental` | Object containing information about a car rental booking associated with the order. |\n | `crypto` | Object containing information about crypto transactions associated with the order. |\n | `marketplace` | This object is required by Mastercard and Visa for merchants operating as marketplaces under the **Merchant Category Code (MCC):** `5262`. The marketplace object ensures compliance with the card schemes' regulations by providing detailed information about the subseller involved in the transaction. |\n | `event` | Object containing information about event ticket bookings associated with the order. |\n | `lodging` | Object containing information about lodging bookings associated with the order. |","descriptionNode":"$L12b2"},"booking_id":{"type":"string","description":"A unique identifier provided by the merchant associated with the order. \n\nThis `booking_id` is used to reference and correlate booking information with the Merchant API and the merchant's internal system.","descriptionNode":"$L12b3"},"pick_up_date":{"type":"string","format":"date-time","description":"The UTC date and time of the pick-up.","descriptionNode":"$L12b4"},"pick_up_location":{"type":"object","description":"Object containing address details.","properties":{"street_line_1":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payments:items:properties:billing_address:properties:street_line_1","street_line_2":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payments:items:properties:billing_address:properties:street_line_2","region":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payments:items:properties:billing_address:properties:region","city":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payments:items:properties:billing_address:properties:city","country_code":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payments:items:properties:billing_address:properties:country_code","postcode":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payments:items:properties:billing_address:properties:postcode"},"required":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:billing_address:required","descriptionNode":"$L12b5"},"drop_off_date":{"type":"string","format":"date-time","description":"The UTC date and time of the drop-off.","descriptionNode":"$L12b6"},"drop_off_location":{"type":"object","description":"Object containing address details.","properties":{"street_line_1":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payments:items:properties:billing_address:properties:street_line_1","street_line_2":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payments:items:properties:billing_address:properties:street_line_2","region":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payments:items:properties:billing_address:properties:region","city":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payments:items:properties:billing_address:properties:city","country_code":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payments:items:properties:billing_address:properties:country_code","postcode":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payments:items:properties:billing_address:properties:postcode"},"required":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:billing_address:required","descriptionNode":"$L12b7"},"refundability":{"type":"string","enum":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:0:properties:refundability:enum","description":"Parameter indicating whether the booking is refundable, partially refundable, or not refundable.","descriptionNode":"$L12b8"},"distance_limit":{"type":"object","description":"Object containing distance limit information.","properties":{"limit":{"type":"integer","description":"The maximum distance allowed.","descriptionNode":"$L12b9"},"unit":{"type":"string","description":"The unit of distance.","enum":["miles","km"],"descriptionNode":"$L12ba"},"additional_distance_cost":{"type":"object","description":"Cost for exceeding the distance limit.","properties":{"amount":{"type":"integer","description":"The amount of the cost in minor currency units. For example, enter `7034` for €70.34.","descriptionNode":"$L12bb"},"currency":{"type":"string","format":"ISO 4217","minLength":3,"maxLength":3,"description":"[ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) currency code in upper case.\n\n:::info\nFor more information about the supported currencies, see: [Help Center](https://help.revolut.com/business/help/merchant-accounts/payments/in-which-currencies-can-i-accept-payments/).\n:::","descriptionNode":"$L12bc"}},"descriptionNode":"$L12bd"}},"descriptionNode":"$L12be"}},"required":["type","booking_id","drop_off_date"],"descriptionNode":"$L12bf"},{"type":"object","description":"Object containing information about crypto transactions associated with the order.\n\n:::info\nProcessing crypto on-ramp transactions with Revolut has additional compliance requirements. Please reach out to your account executive for additional details.\n\n**Required data fields for crypto services:**\n\n```\ntransactions[].id\ntransactions[].status\ntransactions[].recipient_wallet_id\nseller.id\nseller.name\nseller.website\nseller.phone\nseller.address\nseller.mcc\ncustomer.full_name\ncustomer.date_of_birth\n```\n\nNote that these requirements can be extended on a case by case basis as decided by Revolut.\n:::","properties":{"type":{"type":"string","enum":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:0:properties:type:enum","description":"Type of the industry-specific data object, determining what additional data is expected.\n\nAvailable types:\n\n | Object type | Description |\n | ------------- | ----------- |\n | `airline` | Object containing information about a specific airline ticket purchase. |\n | `car_rental` | Object containing information about a car rental booking associated with the order. |\n | `crypto` | Object containing information about crypto transactions associated with the order. |\n | `marketplace` | This object is required by Mastercard and Visa for merchants operating as marketplaces under the **Merchant Category Code (MCC):** `5262`. The marketplace object ensures compliance with the card schemes' regulations by providing detailed information about the subseller involved in the transaction. |\n | `event` | Object containing information about event ticket bookings associated with the order. |\n | `lodging` | Object containing information about lodging bookings associated with the order. |","descriptionNode":"$L12c0"},"transactions":{"type":"array","description":"Array of crypto transaction data associated with the order.","items":{"type":"object","properties":{"id":{"type":"string","maxLength":255,"description":"The public transaction hash of the crypto transaction.","descriptionNode":"$L12c1"},"status":{"type":"string","enum":["pending","failed","cancelled","completed"],"description":"The status of the crypto transaction.","descriptionNode":"$L12c2"},"recipient_wallet_id":{"type":"string","maxLength":255,"description":"The wallet ID of the recipient.\n\n:::note\nAt least one of the parameters: `recipient_user_id` or `recipient_wallet_id` is required.\n::: ","descriptionNode":"$L12c3"},"recipient_user_id":{"type":"string","maxLength":255,"description":"The user ID of the recipient.\n\n:::note\nAt least one of the parameters: `recipient_user_id` or `recipient_wallet_id` is required.\n::: ","descriptionNode":"$L12c4"}},"required":["id","status","recipient"]},"minItems":1,"descriptionNode":"$L12c5"},"seller":{"type":"object","description":"Information about the crypto conversion affiliate.\n\nThis should be provided when a customer completes a payment on a subseller's website rather than directly on the merchant's website, providing insight into the type of business conducted by the subseller.\n\n:::note\nThis needs to be provided only by crypto on-ramp providers for payments they are processing for conversion affiliates.\n\nFor their own payments, `seller` can be omitted.\n:::","properties":{"mcc":{"type":"string","description":"A string representing the four-digit [Merchant Category Code (MCC)](https://en.wikipedia.org/wiki/Merchant_category_code) of the conversion affiliate.","maxLength":4,"minLength":4,"pattern":"^\\d{4}$","descriptionNode":"$L12c6"},"id":{"type":"string","description":"The ID of the seller in the merchant's internal system.","minLength":1,"maxLength":15,"descriptionNode":"$L12c7"},"name":{"type":"string","description":"The business or legal name of the seller.","minLength":1,"maxLength":50,"descriptionNode":"$L12c8"},"website":{"type":"string","format":"uri","pattern":"^https?:\\/{2}.+/gi","maxLength":255,"description":"The URL of the website of the seller.\n\n:::warning\nRestrictions:\n- Must be a valid URI as defined by [RFC 3986](https://datatracker.ietf.org/doc/html/rfc3986)\n- URI scheme is required and must be either `http` or `https`\n- URI host is required and cannot be `localhost` or an IP address\n- Max length: `255`\n- Reserved or invalid characters must be percent-encoded (for example, use `%20` instead of a space)\n:::","descriptionNode":"$L12c9"},"phone":{"type":"string","description":"The phone number of the seller.","descriptionNode":"$L12ca"},"address":{"type":"object","description":"Details of a physical address.","properties":{"street_line_1":{"type":"string","description":"Primary address line.","maxLength":100,"descriptionNode":"$L12cb"},"street_line_2":{"type":"string","description":"Secondary address line, such as floor and apartment number.","maxLength":100,"descriptionNode":"$L12cc"},"region":{"type":"string","description":"State or province of the address.","maxLength":100,"descriptionNode":"$L12cd"},"city":{"type":"string","description":"City of the address.","maxLength":100,"descriptionNode":"$L12ce"},"country_code":{"type":"string","pattern":"^[A-Z]{2}$","description":"ISO 2-letter country code.","minLength":2,"maxLength":2,"descriptionNode":"$L12cf"},"country_subdivision_code":{"type":"string","pattern":"^[A-Z]{2}-[A-Z0-9]{1,3}$","description":"The subdivision code represents the state, province, or region within the country, following the [ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2) standard. This code uniquely identifies subdivisions within a country. \n\nFor example, for London in the United Kingdom, use `GB-LND`.\n\n:::warning\nThe parameter is required for countries listed on the [ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2) page.\n:::","minLength":5,"maxLength":6,"descriptionNode":"$L12d0"},"postcode":{"type":"string","description":"Postal code of the address.","maxLength":100,"descriptionNode":"$L12d1"}},"required":["street_line_1","city","country_code","postcode"],"descriptionNode":"$L12d2"}},"required":["id","name","website","phone","address","mcc"],"descriptionNode":"$L12d3"}},"required":["type","transactions"],"descriptionNode":"$L12d4"},{"type":"object","description":"This object is required by Mastercard and Visa for merchants operating as marketplaces under the Merchant Category Code (MCC) `5262`. The marketplace object ensures compliance with the card schemes' regulations by providing detailed information about the seller involved in the transaction.\n\n:::info\nThese are the specific data field requirements for merchants who must provide marketplace data.\n\n```\nseller.id\nseller.name\nseller.website\nseller.phone\nseller.address\n```\n:::","properties":{"type":{"type":"string","enum":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:0:properties:type:enum","description":"Type of the industry-specific data object, determining what additional data is expected.\n\nAvailable types:\n\n | Object type | Description |\n | ------------- | ----------- |\n | `airline` | Object containing information about a specific airline ticket purchase. |\n | `car_rental` | Object containing information about a car rental booking associated with the order. |\n | `crypto` | Object containing information about crypto transactions associated with the order. |\n | `marketplace` | This object is required by Mastercard and Visa for merchants operating as marketplaces under the **Merchant Category Code (MCC):** `5262`. The marketplace object ensures compliance with the card schemes' regulations by providing detailed information about the subseller involved in the transaction. |\n | `event` | Object containing information about event ticket bookings associated with the order. |\n | `lodging` | Object containing information about lodging bookings associated with the order. |","descriptionNode":"$L12d5"},"seller":{"type":"object","description":"Information about the subseller on the marketplace platform.","properties":{"id":{"type":"string","description":"The ID of the seller in the merchant's internal system.","minLength":1,"maxLength":15,"descriptionNode":"$L12d6"},"name":{"type":"string","description":"The business or legal name of the seller.","minLength":1,"maxLength":50,"descriptionNode":"$L12d7"},"website":{"type":"string","format":"uri","pattern":"^https?:\\/{2}.+/gi","maxLength":255,"description":"The URL of the website of the seller.\n\n:::warning\nRestrictions:\n- Must be a valid URI as defined by [RFC 3986](https://datatracker.ietf.org/doc/html/rfc3986)\n- URI scheme is required and must be either `http` or `https`\n- URI host is required and cannot be `localhost` or an IP address\n- Max length: `255`\n- Reserved or invalid characters must be percent-encoded (for example, use `%20` instead of a space)\n:::","descriptionNode":"$L12d8"},"phone":{"type":"string","description":"The phone number of the seller.","descriptionNode":"$L12d9"},"address":{"type":"object","description":"Details of a physical address.","properties":{"street_line_1":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:2:properties:seller:properties:address:properties:street_line_1","street_line_2":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:2:properties:seller:properties:address:properties:street_line_2","region":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:2:properties:seller:properties:address:properties:region","city":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:2:properties:seller:properties:address:properties:city","country_code":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:2:properties:seller:properties:address:properties:country_code","country_subdivision_code":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:2:properties:seller:properties:address:properties:country_subdivision_code","postcode":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:2:properties:seller:properties:address:properties:postcode"},"required":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:2:properties:seller:properties:address:required","descriptionNode":"$L12da"}},"required":["id","name","website","phone","address"],"descriptionNode":"$L12db"}},"required":["type","seller"],"descriptionNode":"$L12dc"},{"type":"object","description":"Object containing booking information for a list of event tickets associated with the order.\n\n:::info\nThese are the specific data field requirements for merchants who must provide event data. Note that these requirements can be extended on a case by case basis as decided by Revolut.\n\n```\nbooking_id\nevents[].start_date\nevents[].end_date\nevents[].supplier\nevents[].tickets[].id\n```\n:::","properties":{"type":{"type":"string","enum":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:0:properties:type:enum","description":"Type of the industry-specific data object, determining what additional data is expected.\n\nAvailable types:\n\n | Object type | Description |\n | ------------- | ----------- |\n | `airline` | Object containing information about a specific airline ticket purchase. |\n | `car_rental` | Object containing information about a car rental booking associated with the order. |\n | `crypto` | Object containing information about crypto transactions associated with the order. |\n | `marketplace` | This object is required by Mastercard and Visa for merchants operating as marketplaces under the **Merchant Category Code (MCC):** `5262`. The marketplace object ensures compliance with the card schemes' regulations by providing detailed information about the subseller involved in the transaction. |\n | `event` | Object containing information about event ticket bookings associated with the order. |\n | `lodging` | Object containing information about lodging bookings associated with the order. |","descriptionNode":"$L12dd"},"booking_id":{"type":"string","description":"A unique identifier provided by the merchant associated with the order. \n\nThis `booking_id` is used to reference and correlate booking information with the Merchant API and the merchant's internal system.","descriptionNode":"$L12de"},"events":{"type":"array","description":"A list of events associated with the booking.","items":{"type":"object","description":"Object containing booking information about a specific event. ","properties":{"start_date":{"type":"string","format":"date-time","description":"[ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time when the event starts.","descriptionNode":"$L12df"},"end_date":{"type":"string","format":"date-time","description":"[ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time when the event ends.","descriptionNode":"$L12e0"},"supplier":{"type":"string","description":"Legal name of the ticket vendor/event organiser.","descriptionNode":"$L12e1"},"supplier_payment_date":{"type":"string","format":"date-time","description":"[ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time when the funds are released to merchants.","descriptionNode":"$L12e2"},"name":{"type":"string","description":"The name of the event.","descriptionNode":"$L12e3"},"location":{"type":"object","description":"The address of the event location.","properties":{"street_line_1":{"type":"string","description":"Primary address line.","maxLength":100,"descriptionNode":"$L12e4"},"street_line_2":{"type":"string","description":"Secondary address line, such as floor and apartment number.","maxLength":100,"descriptionNode":"$L12e5"},"region":{"type":"string","description":"State or province of the address.","maxLength":100,"descriptionNode":"$L12e6"},"city":{"type":"string","description":"City of the address.","maxLength":100,"descriptionNode":"$L12e7"},"country_code":{"type":"string","pattern":"^[A-Z]{2}$","description":"ISO 2-letter country code.","minLength":2,"maxLength":2,"descriptionNode":"$L12e8"},"postcode":{"type":"string","description":"Postal code of the address.","maxLength":100,"descriptionNode":"$L12e9"}},"required":["street_line_1","city","country_code","postcode"],"descriptionNode":"$L12ea"},"category":{"type":"string","enum":["concert","conference","convention","exhibition","festival","party","performance","other"],"description":"The type of the event.","descriptionNode":"$L12eb"},"market":{"type":"string","enum":["primary","secondary"],"description":"Indicates the relationship between the ticket vendor and the event organiser. \n\n| Parameter value | Description |\n| --------------- | ----------- |\n| `primary` | The merchant is the organiser and primary distributor of the tickets. |\n| `secondary` | The merchant is a reseller, only distributing the tickets. |","descriptionNode":"$L12ec"},"tickets":{"type":"array","items":{"type":"object","description":"Object containing information about a ticket associated with the booking.","properties":{"id":{"type":"string","description":"A unique identifier provided by the merchant associated with the ticket.","descriptionNode":"$L12ed"},"transferable":{"type":"boolean","description":"Indicates whether the ticket is transferable to another buyer.","descriptionNode":"$L12ee"},"refundability":{"type":"string","enum":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:0:properties:refundability:enum","description":"Parameter indicating whether the booking is refundable, partially refundable, or not refundable.","descriptionNode":"$L12ef"}},"required":["id"],"descriptionNode":"$L12f0"},"description":"A list of tickets associated with the booking.","descriptionNode":"$L12f1"}},"descriptionNode":"$L12f2"},"descriptionNode":"$L12f3"}},"required":["type","booking_id"],"descriptionNode":"$L12f4"},{"type":"object","description":"Object containing details of a lodging booking.\n\n:::info\nThese are the specific data field requirements for merchants who must provide lodging data. Note that these requirements can be extended on a case by case basis as decided by Revolut.\n\n```\nbooking_id\ncheck_in_date\ncheck_out_date\nsupplier_payment_date\n```\n:::","properties":{"type":{"type":"string","enum":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:0:properties:type:enum","description":"Type of the industry-specific data object, determining what additional data is expected.\n\nAvailable types:\n\n | Object type | Description |\n | ------------- | ----------- |\n | `airline` | Object containing information about a specific airline ticket purchase. |\n | `car_rental` | Object containing information about a car rental booking associated with the order. |\n | `crypto` | Object containing information about crypto transactions associated with the order. |\n | `marketplace` | This object is required by Mastercard and Visa for merchants operating as marketplaces under the **Merchant Category Code (MCC):** `5262`. The marketplace object ensures compliance with the card schemes' regulations by providing detailed information about the subseller involved in the transaction. |\n | `event` | Object containing information about event ticket bookings associated with the order. |\n | `lodging` | Object containing information about lodging bookings associated with the order. |","descriptionNode":"$L12f5"},"booking_id":{"type":"string","description":"A unique identifier provided by the merchant associated with the order. \n\nThis `booking_id` is used to reference and correlate booking information with the Merchant API and the merchant's internal system.","descriptionNode":"$L12f6"},"check_in_date":{"type":"string","format":"date-time","description":"[ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time of the check-in.","descriptionNode":"$L12f7"},"check_out_date":{"type":"string","format":"date-time","description":"[ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time of the check-out.","descriptionNode":"$L12f8"},"supplier_payment_date":{"type":"string","format":"date-time","description":"[ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time when the funds are released to merchants.","descriptionNode":"$L12f9"},"category":{"type":"string","enum":["bed_and_breakfast","hostel","hotel","short_term_rental","other"],"description":"The type of the accommodation associated with the booking.","descriptionNode":"$L12fa"},"booking_type":{"type":"string","enum":["fixed","flexible"],"description":"Indicates whether the booking terms are fixed or flexible.\n\n| Parameter value | Description |\n| --------------- | ----------- |\n| `fixed` | Non-modifiable once confirmed. |\n| `flexible` | Allows modifications or cancellations under specified conditions. |","descriptionNode":"$L12fb"},"refundability":{"type":"string","enum":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:0:properties:refundability:enum","description":"Parameter indicating whether the booking is refundable, partially refundable, or not refundable.","descriptionNode":"$L12fc"},"location":{"type":"object","description":"Address of the accommodation.","properties":{"street_line_1":{"type":"string","description":"Primary address line.","maxLength":100,"descriptionNode":"$L12fd"},"street_line_2":{"type":"string","description":"Secondary address line, such as floor and apartment number.","maxLength":100,"descriptionNode":"$L12fe"},"region":{"type":"string","description":"State or province of the address.","maxLength":100,"descriptionNode":"$L12ff"},"city":{"type":"string","description":"City of the address.","maxLength":100,"descriptionNode":"$L1300"},"country_code":{"type":"string","pattern":"^[A-Z]{2}$","description":"ISO 2-letter country code.","minLength":2,"maxLength":2,"descriptionNode":"$L1301"},"postcode":{"type":"string","description":"Postal code of the address.","maxLength":100,"descriptionNode":"$L1302"}},"required":["street_line_1","city","country_code","postcode"],"descriptionNode":"$L1303"},"guests":{"type":"array","items":{"type":"object","properties":{"first_name":{"type":"string","description":"Guest's first name.","descriptionNode":"$L1304"},"last_name":{"type":"string","description":"Guest's last name.","descriptionNode":"$L1305"}},"required":["first_name","last_name"]},"description":"List of guests associated with the booking.","descriptionNode":"$L1306"}},"required":["type","booking_id"],"descriptionNode":"$L1307"}],"descriptionNode":"$L1308"},"merchant_order_data":{"type":"object","description":"Object for providing additional information stored in the merchant's order management system. ","properties":{"url":{"type":"string","format":"uri","pattern":"^https?:\\/{2}.+/gi","maxLength":2000,"description":"The URL of the order stored in the merchant's order management system.\n\nThis URL will be included in the order confirmation email for payments made via Revolut Pay. If specified, this URL will override the default link to the merchant's **Business website** configured in the Revolut Business account.\n\n:::warning\nRestrictions:\n- Must be a valid URI as defined by [RFC 3986](https://datatracker.ietf.org/doc/html/rfc3986)\n- URI scheme is required and must be either `http` or `https`\n- URI host is required and cannot be `localhost` or an IP address\n- Max length: `2000`\n- Reserved or invalid characters must be percent-encoded (for example, use `%20` instead of a space)\n:::","descriptionNode":"$L1309"},"reference":{"type":"string","description":"Merchant order ID for external reference.\n\nUse this field to set the ID that your own system can use to easily track orders.","descriptionNode":"$L130a"}},"descriptionNode":"$L130b"},"upcoming_payment_data":{"type":"object","description":"Object containing information about upcoming payments associated with the order.","properties":{"date":{"type":"string","format":"date-time","description":"The date and time in [ISO 8601 format](https://en.wikipedia.org/wiki/ISO_8601) when the upcoming payment is scheduled to be executed.","descriptionNode":"$L130c"},"payment_method_id":{"type":"string","description":"The unique ID of the customer's payment method used to complete the scheduled payment.\n\n:::info\nFor more information about operations related to customer's payment methods, see:\n - [Retrieve payment method list of a customer](https://developer.revolut.com/docs/api/merchant#retrieve-payment-method-list)\n - [Retrieve a customer's payment method](https://developer.revolut.com/docs/api/merchant#retrieve-payment-method)\n - [Update a customer's payment method](https://developer.revolut.com/docs/api/merchant#update-payment-method)\n - [Delete a customer's payment method](https://developer.revolut.com/docs/api/merchant#delete-payment-method)\n:::","descriptionNode":"$L130d"}},"required":["date","payment_method_id"],"descriptionNode":"$L130e"},"checkout_url":{"type":"string","description":"Link to a checkout page hosted by Revolut.","format":"uri","descriptionNode":"$L130f"},"redirect_url":{"type":"string","format":"uri","pattern":"^https?:\\/{2}.+/gi","maxLength":2000,"description":"The URL your customer will be redirected to after a successful payment on the hosted checkout page (`checkout_url` parameter's value of the order).\n\n:::warning\nRestrictions:\n- Must be a valid URI as defined by [RFC 3986](https://datatracker.ietf.org/doc/html/rfc3986)\n- URI scheme is required and must be either `http` or `https`\n- URI host is required and cannot be `localhost` or an IP address\n- Max length: `2000`\n- Reserved or invalid characters must be percent-encoded (for example, use `%20` instead of a space)\n:::\n\n:::info\nFor more information on how to use the `redirect_url`, see: [Custom redirection via the API](https://developer.revolut.com/docs/guides/merchant/accept-payments/online-payments/hosted-checkout-page/api#custom-post-payment-redirection-optional)\n:::","descriptionNode":"$L1310"},"shipping":{"type":"object","description":"Details about the shipping related to the order, including address, contact information, and individual shipments.\n\n:::info\nRequired for merchants shipping physical goods. Omitting this information may trigger additional scrutiny and risk mitigation actions by Revolut.\n:::","properties":{"address":{"type":"object","description":"Details of a physical address.","properties":{"street_line_1":{"type":"string","description":"Primary address line.","maxLength":100,"descriptionNode":"$L1311"},"street_line_2":{"type":"string","description":"Secondary address line, such as floor and apartment number.","maxLength":100,"descriptionNode":"$L1312"},"region":{"type":"string","description":"State or province of the address.","maxLength":100,"descriptionNode":"$L1313"},"city":{"type":"string","description":"City of the address.","maxLength":100,"descriptionNode":"$L1314"},"country_code":{"type":"string","pattern":"^[A-Z]{2}$","description":"ISO 2-letter country code.","minLength":2,"maxLength":2,"descriptionNode":"$L1315"},"postcode":{"type":"string","description":"Postal code of the address.","maxLength":100,"descriptionNode":"$L1316"}},"required":"$60:props:children:0:props:children:props:responses:200:content:application/json:schema:oneOf:1:properties:details:properties:address:required","descriptionNode":"$L1317"},"contact":{"type":"object","description":"Contact details for someone responsible for the shipment.\n\n:::warning\nAt least `email` or `phone` is required.\n:::","properties":{"name":{"type":"string","description":"Full name of the contact person.","maxLength":250,"descriptionNode":"$L1318"},"email":{"type":"string","format":"email","description":"Email address of the contact person.","descriptionNode":"$L1319"},"phone":{"type":"string","description":"Phone number of the contact person.","descriptionNode":"$L131a"}},"descriptionNode":"$L131b"},"shipments":{"type":"array","description":"List of individual shipment details.","maxItems":50,"items":{"type":"object","description":"Details of an individual shipment.","properties":{"shipping_company_name":{"type":"string","maxLength":250,"description":"Name of the company handling the shipment.","descriptionNode":"$L131c"},"tracking_number":{"type":"string","maxLength":500,"description":"Unique tracking number for the shipment.","descriptionNode":"$L131d"},"estimated_delivery_date":{"type":"string","format":"date-time","description":"Estimated delivery date and time for the shipment. \nThe time should also include the customer's timezone.","descriptionNode":"$L131e"},"tracking_url":{"type":"string","format":"uri","pattern":"^https?:\\/{2}.+/gi","maxLength":2000,"description":"An HTTP/HTTPS URL where the shipment can be tracked.\n\n:::warning\nRestrictions:\n- Must be a valid URI as defined by [RFC 3986](https://datatracker.ietf.org/doc/html/rfc3986)\n- URI scheme is required and must be either `http` or `https`\n- URI host is required and cannot be `localhost` or an IP address\n- Max length: `2000`\n- Reserved or invalid characters must be percent-encoded (for example, use `%20` instead of a space)\n:::","descriptionNode":"$L131f"}},"required":["shipping_company_name","tracking_number"],"descriptionNode":"$L1320"},"descriptionNode":"$L1321"}},"descriptionNode":"$L1322"},"enforce_challenge":{"type":"string","description":"The enforce challenge mode. `automatic` is used by default.\n\n| Parameter value | Description |\n| --------------- | ----------- |\n| `automatic` | The payments created for an order will have challenge requirement calculated by our fraud mechanisms. Not all payments will trigger a 3DS challenge. |\n| `forced` | The payments created for an order will always require a 3DS challenge. Currently only supported for card payments. |","default":"automatic","enum":"$19:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:orders:items:properties:enforce_challenge:enum","descriptionNode":"$L1323"},"line_items":{"type":"array","maxItems":250,"description":"An array of line items included in the order. Each line item represents an individual product or service, along with its quantity, price, taxes, and discounts.\n\n:::info\nRequired for merchants collecting payment for one or multiple products/services in one transaction. Omitting this information may trigger additional scrutiny and risk mitigation actions by Revolut.\n:::","items":{"type":"object","properties":{"name":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:incremental_authorisations:items:properties:line_items:items:properties:name","type":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:incremental_authorisations:items:properties:line_items:items:properties:type","quantity":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:incremental_authorisations:items:properties:line_items:items:properties:quantity","unit_price_amount":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:incremental_authorisations:items:properties:line_items:items:properties:unit_price_amount","total_amount":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:incremental_authorisations:items:properties:line_items:items:properties:total_amount","external_id":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:incremental_authorisations:items:properties:line_items:items:properties:external_id","discounts":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:incremental_authorisations:items:properties:line_items:items:properties:discounts","taxes":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:incremental_authorisations:items:properties:line_items:items:properties:taxes","image_urls":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:incremental_authorisations:items:properties:line_items:items:properties:image_urls","description":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:incremental_authorisations:items:properties:line_items:items:properties:description","url":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:incremental_authorisations:items:properties:line_items:items:properties:url"},"required":"$19:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:orders:items:properties:line_items:items:required"},"descriptionNode":"$L1324"},"statement_descriptor_suffix":{"type":"string","description":"$1325","minLength":1,"maxLength":19,"pattern":"^[^*\\n\\r\\\\]+$","descriptionNode":"$L1326"},"related_order_id":{"type":"string","format":"uuid","description":"The unique ID of the original order that was refunded and this refund is associated with. You can use this ID to get more information about the related order using the [Retrieve an order](https://developer.revolut.com/docs/api/merchant#retrieve-order) operation.\n\n:::note\nThis field is only returned for orders with `type: refund`.\n:::","descriptionNode":"$L1327"},"subscription_data":{"title":"Subscription data","type":"object","required":"$19:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:orders:items:properties:subscription_data:required","description":"Subscription details linked to the order. Use this object to match an order with its underlying subscription and understand the billing context in which the order was created.\n\nOnly present on orders created by a subscription.","properties":{"subscription_id":{"type":"string","format":"uuid","description":"Unique identifier for the subscription.","descriptionNode":"$L1328"},"active_cycle_id":{"type":"string","format":"uuid","description":"The unique identifier of the active (pre-paid) subscription cycle that this order collects payment for.\n\nThis is the current billing cycle whose recurring charges are being collected in advance by this order. For example, if a subscription cycle covers 1-31 July and the order is generated on 1 July, this field identifies that July cycle.","descriptionNode":"$L1329"},"settled_cycle_id":{"type":"string","format":"uuid","description":"The unique identifier of the settled (post-paid) subscription cycle whose usage-based charges this order collects.\n\nThis is the previous billing cycle whose usage is being settled by this order. For example, if a subscription cycle covers usage from 1-30 June and the order is generated on 10 July, this field identifies that June cycle.","descriptionNode":"$L132a"},"billing_reason":{"type":"string","enum":"$19:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:orders:items:properties:subscription_data:properties:billing_reason:enum","description":"The reason this subscription order was created.\n\n| Value | Description |\n| ----- | ----------- |\n| `cycle_billing` | The order was automatically generated to collect payment for an ongoing subscription cycle. `active_cycle_id` is present; `settled_cycle_id` is present if the previous cycle included usage-based products. |\n| `final_settlement` | The order was automatically generated after the subscription ended to collect outstanding usage-based charges. `active_cycle_id` is absent; `settled_cycle_id` is present. |\n| `setup_intent` | The order was manually created by the merchant or customer to update the payment method on file. `active_cycle_id` is absent; `settled_cycle_id` is absent. |","descriptionNode":"$L132b"}},"descriptionNode":"$L132c"}},"descriptionNode":"$L132d"},"examples":{"example_order_min_params":{"summary":"Example order response with minimal required parameters","value":{"id":"6516e61c-d279-a454-a837-bc52ce55ed49","token":"0adc0e3c-ab44-4f33-bcc0-534ded7354ce","type":"payment","state":"pending","created_at":"2023-09-29T14:58:36.079398Z","updated_at":"2023-09-29T14:58:36.079398Z","amount":500,"currency":"GBP","outstanding_amount":500,"capture_mode":"automatic","authorisation_type":"final","checkout_url":"https://checkout.revolut.com/payment-link/0adc0e3c-ab44-4f33-bcc0-534ded7354ce","enforce_challenge":"automatic"}},"example_order_additional":{"summary":"Example order response with additional parameters","value":{"id":"6516e6ec-c7f7-a0fb-a6d3-add05fa46d2f","token":"1058031d-1e71-4d07-9f97-5ad388a1346c","type":"payment","state":"pending","created_at":"2023-09-29T15:02:04.083787Z","updated_at":"2023-09-29T15:02:04.083787Z","amount":500,"currency":"GBP","outstanding_amount":500,"capture_mode":"manual","authorisation_type":"final","cancel_authorised_after":"PT30M","description":"Example product","checkout_url":"https://checkout.revolut.com/payment-link/1058031d-1e71-4d07-9f97-5ad388a1346c","redirect_url":"https://www.example.com/redirect","shipping":{"address":{"street_line_1":"7 Westferry Circus","city":"London","country_code":"GB","postcode":"E14 4HD"}},"metadata":{"product_type":"Example"},"enforce_challenge":"forced","customer":{"id":"467646d6-e452-4d1e-a401-703f09cd3818","email":"example@example.com","date_of_birth":"1990-01-01"},"merchant_order_data":{"url":"https://example.com/orders/12345"},"statement_descriptor_suffix":"12345"}},"example_order_pre_auth":{"summary":"Example order response with pre-authorisation and card payment","value":{"id":"6516e61c-d279-a454-a837-bc52ce55ed49","token":"0adc0e3c-ab44-4f33-bcc0-534ded7354ce","type":"payment","state":"authorised","created_at":"2023-09-29T14:58:36.079398Z","updated_at":"2023-09-29T14:58:36.079398Z","amount":5000,"currency":"GBP","outstanding_amount":5000,"capture_mode":"manual","authorisation_type":"pre_authorisation","cancel_authorised_after":"PT72H","description":"Hotel reservation deposit","checkout_url":"https://checkout.revolut.com/payment-link/0adc0e3c-ab44-4f33-bcc0-534ded7354ce","enforce_challenge":"automatic","payments":[{"id":"6516f38a-a12b-aca3-83f2-6ed16d6ed246","state":"authorised","created_at":"2023-09-29T14:55:54.579311Z","updated_at":"2023-09-29T14:56:38.403232Z","amount":5000,"currency":"GBP","settled_amount":5000,"settled_currency":"GBP","billing_address":{"country_code":"GB","postcode":"SW1A 1AA"},"risk_level":"low","fees":[],"payer":{"email":"example.payer@example.com","phone":"+447911123456"},"payment_method":{"type":"card","card_brand":"visa","funding":"credit","card_country_code":"GB","card_bin":"411111","card_last_four":"1111","card_expiry":"12/25","cardholder_name":"Example Holder","capture_deadline":"2023-10-06T14:55:54.579311Z","fingerprint":"1JAllfQY4POhBV8DaddAQ4LC5RbMP8LMLvUdJW4s5JY=","network_transaction_id":"1234567890123456"}}]}},"example_order_line_items":{"description":"Example order response with line items","value":{"id":"66bcc998-4209-ac6e-96fe-2910b949c516","token":"0bcfcc1d-9ee9-4476-b36c-cf4abba2e45a","type":"payment","state":"pending","created_at":"2024-08-14T15:13:28.814729Z","updated_at":"2024-08-14T15:13:28.814729Z","amount":770,"currency":"GBP","outstanding_amount":770,"capture_mode":"automatic","authorisation_type":"final","checkout_url":"https://checkout.revolut.com/payment-link/0bcfcc1d-9ee9-4476-b36c-cf4abba2e45a","enforce_challenge":"automatic","line_items":[{"name":"Example item 1","unit_price_amount":100,"quantity":{"value":2,"unit":"kg"},"type":"physical","discounts":[{"name":"Discount 1","amount":50}],"taxes":[{"name":"10% VAT","amount":20}],"total_amount":170,"image_urls":["https://www.example.com/line-item-image1","https://www.example.com/line-item-image2"],"description":"First line item","external_id":"external_id_123","url":"https://www.example.com"},{"name":"Example item 2","unit_price_amount":100,"quantity":{"value":10,"unit":"pieces"},"type":"service","discounts":[{"name":"Discount 2","amount":500}],"taxes":[{"name":"10% VAT","amount":100}],"total_amount":600,"image_urls":["https://www.example.com/line_item_image3","https://www.example.com/line_item_image4"],"description":"Second line item","external_id":"external_id_456","url":"https://www.example.com"}]}},"example_order_subscription":{"summary":"Example order response with subscription data (cycle billing, no usage-based items)","value":{"id":"7a1b2c3d-4e5f-6789-abcd-e1234567890a","token":"9f8e7d6c-5b4a-3210-fedc-ba0987654321","type":"payment","state":"completed","created_at":"2025-06-15T10:30:00.000000Z","updated_at":"2025-06-15T10:31:00.000000Z","amount":1999,"currency":"GBP","outstanding_amount":0,"capture_mode":"automatic","authorisation_type":"final","checkout_url":"https://checkout.revolut.com/payment-link/9f8e7d6c-5b4a-3210-fedc-ba0987654321","enforce_challenge":"automatic","subscription_data":{"subscription_id":"e2862e0e-66e8-4623-bdd6-7da59b85365d","active_cycle_id":"a1b2c3d4-5678-9012-abcd-ef1234567890","billing_reason":"cycle_billing"}}},"example_order_shipping":{"summary":"Example order response with shipping details","value":{"id":"66c5e449-36d3-af78-a832-328150ddc6a3","token":"b1145e3e-30c7-4dd6-b84c-680dccd39dde","type":"payment","state":"pending","created_at":"2024-08-21T12:57:45.793605Z","updated_at":"2024-08-21T12:57:45.793605Z","amount":770,"currency":"GBP","outstanding_amount":770,"capture_mode":"automatic","authorisation_type":"final","checkout_url":"https://checkout.revolut.com/payment-link/b1145e3e-30c7-4dd6-b84c-680dccd39dde","shipping":{"address":{"street_line_1":"Example Street 123","street_line_2":"II/123","region":"London","city":"London","country_code":"GB","postcode":"123456"},"contact":{"name":"Example Contact","email":"example.contact@example.com","phone":"+441234567890"},"shipments":[{"shipping_company_name":"Example Shipping Co.","tracking_number":"123456789","estimated_delivery_date":"2024-12-03T10:15:30+02:00[Europe/Paris]","tracking_url":"https://www.example.com/tracking/123456789"}]},"enforce_challenge":"automatic"}},"example_order_airline":{"summary":"Example order response with additional airline data","value":{"id":"6516ed0c-098f-aa19-80e5-9d92f52b35e0","token":"061f2c63-e36b-421e-9ece-5adfcd580886","type":"payment","state":"pending","created_at":"2023-09-29T15:28:12.114992Z","updated_at":"2023-09-29T15:28:12.114992Z","amount":500,"currency":"GBP","outstanding_amount":500,"settlement_currency":"EUR","capture_mode":"manual","authorisation_type":"final","description":"Example order description","checkout_url":"https://checkout.revolut.com/payment-link/061f2c63-e36b-421e-9ece-5adfcd580886","redirect_url":"https://www.example.com/redirect","cancel_authorised_after":"PT30M","industry_data":{"type":"airline","booking_id":"unique-booking-id-12345","fulfillment_date":"2023-07-10T14:00:00.069624Z","ticket_type":"flexible","crs_code":"DATS","ticket_change_indicator":"new","refundability":"refundable","passengers":[{"first_name":"Example","last_name":"Customer"},{"first_name":"John","last_name":"Doe"}],"journey_legs":[{"sequence":1,"departure_airport_code":"FRA","arrival_airport_code":"LHR","flight_number":"670","fare_base_code":"J","travel_date":"2023-07-10T10:00:00.069624Z","airline_name":"AerLingus","airline_code":"EI"},{"sequence":2,"departure_airport_code":"LHR","arrival_airport_code":"DUB","flight_number":"678","fare_base_code":"J","travel_date":"2023-07-10T15:00:00.069624Z","airline_name":"AerLingus","airline_code":"EI"},{"sequence":3,"departure_airport_code":"DUB","arrival_airport_code":"LHR","flight_number":"679","fare_base_code":"F","travel_date":"2023-07-15T10:00:00.069624Z","airline_name":"AerLingus","airline_code":"EI"},{"sequence":4,"departure_airport_code":"LHR","arrival_airport_code":"FRA","flight_number":"671","fare_base_code":"F","travel_date":"2023-07-10T14:00:00.069624Z","airline_name":"AerLingus","airline_code":"EI"}],"booking_url":"https://example.com/bookings/1234"},"enforce_challenge":"forced","customer":{"id":"db186257-3031-4726-98ea-f2260ea115f0","email":"example@example.com","phone":"+441234567890","full_name":"Example Customer"},"merchant_order_data":{"url":"https://www.example.com/ticketnumber-12345","reference":"example_airline_reference"}}},"example_order_car_rental":{"summary":"Example order response with additional car rental data","value":{"id":"6516ed0c-098f-aa19-80e5-9d92f52b35e0","token":"061f2c63-e36b-421e-9ece-5adfcd580886","type":"payment","state":"pending","created_at":"2025-01-29T15:28:12.114992Z","updated_at":"2025-01-29T15:28:12.114992Z","amount":500,"currency":"GBP","outstanding_amount":500,"settlement_currency":"GBP","capture_mode":"manual","authorisation_type":"final","description":"Example car rental order","checkout_url":"https://checkout.revolut.com/payment-link/061f2c63-e36b-421e-9ece-5adfcd580886","redirect_url":"https://www.example.com/redirect","cancel_authorised_after":"PT30M","industry_data":{"type":"car_rental","booking_id":"example_booking_id","pick_up_date":"2026-03-01T11:00:00Z","drop_off_date":"2026-03-05T16:30:00Z","refundability":"partially_refundable","pick_up_location":{"street_line_1":"1 Example Street","city":"London","country_code":"GB","postcode":"SW1A 1AA"},"drop_off_location":{"street_line_1":"10 Another Road","city":"Manchester","country_code":"GB","postcode":"M1 1AA"},"distance_limit":{"limit":500,"unit":"miles","additional_distance_cost":{"amount":150,"currency":"GBP"}}},"enforce_challenge":"forced","customer":{"id":"db186257-3031-4726-98ea-f2260ea115f0","email":"example@example.com","phone":"+447700900000","full_name":"Example Customer"},"merchant_order_data":{"url":"https://www.example.com/rental/example_booking_id","reference":"example_car_rental_reference"}}},"example_order_crypto":{"summary":"Example order response with additional crypto transaction data","value":{"id":"6516edb9-74af-ae47-829b-1475e807a8d7","token":"1e619c26-d954-4d45-94ab-aba1e407fcee","type":"payment","state":"pending","created_at":"2023-09-29T15:31:05.746826Z","updated_at":"2023-09-29T15:31:05.746826Z","amount":26100,"currency":"EUR","outstanding_amount":26100,"settlement_currency":"EUR","capture_mode":"manual","authorisation_type":"final","description":"Customer wants to buy 0.01 BTC","checkout_url":"https://checkout.revolut.com/payment-link/1e619c26-d954-4d45-94ab-aba1e407fcee","redirect_url":"https://www.example.com/redirect","industry_data":{"type":"crypto","transactions":[{"id":"7b2a8ed4-5889-4c0c-a8cc-299aff1c881b","status":"pending","recipient_wallet_id":"64a6f159-0a60-a446-880e-e449a1f62f7c"}],"seller":{"id":"a13638ab-3e90-4b05-9f69-23abc655775b","name":"Ramp Provider Company Name","website":"https://example.com","phone":"123456789","mcc":"6051","address":{"street_line_1":"456 Crypto Ave","city":"New York","postcode":"10001","country_code":"US"}}},"enforce_challenge":"automatic","customer":{"id":"db186257-3031-4726-98ea-f2260ea115f0","email":"example@example.com","phone":"+44123456789","full_name":"Example Customer"},"merchant_order_data":{"url":"https://www.example.com/cryptotransactionnumber-12345","reference":"example_crypto_reference"}}},"example_order_marketplace":{"summary":"Example order response with additional marketplace data","value":{"id":"670920dc-d343-abf8-963a-68ae1bc8ae58","token":"41aabe45-b444-45e6-8363-f0433452e138","type":"payment","state":"pending","created_at":"2024-10-11T12:58:04.826974Z","updated_at":"2024-10-11T12:58:04.826974Z","amount":10000,"currency":"EUR","outstanding_amount":10000,"capture_mode":"automatic","authorisation_type":"final","checkout_url":"https://checkout.revolut.com/payment-link/41aabe45-b444-45e6-8363-f0433452e138","industry_data":{"type":"marketplace","seller":{"id":"123-45-67","name":"Example Seller","address":{"street_line_1":"1 Canada Square","street_line_2":"Revolut LTD, Level 39","region":"Greater London","city":"London","country_code":"GB","country_subdivision_code":"GB-LND","postcode":"E14 4HD"},"website":"https://example.com/123-45-67","phone":"+441234567890"}},"enforce_challenge":"automatic"}},"example_order_event":{"summary":"Example order response with additional event data","value":{"id":"67bf20c4-59a5-a7a9-81ad-052fda5f80eb","token":"8737a497-9bae-4647-90bf-1abe2fd9162a","type":"payment","state":"pending","created_at":"2025-02-26T14:10:12.804901Z","updated_at":"2025-02-26T14:10:12.804901Z","amount":100,"currency":"GBP","outstanding_amount":100,"capture_mode":"automatic","authorisation_type":"final","checkout_url":"https://checkout.revolut.com/payment-link/8737a497-9bae-4647-90bf-1abe2fd9162a","industry_data":{"type":"event","booking_id":"example_booking_123","events":[{"start_date":"2025-03-04T14:00:00Z","end_date":"2025-03-04T17:00:00Z","supplier":"Example Supplier","supplier_payment_date":"2025-03-03T14:00:15Z","name":"Example Event","location":{"street_line_1":"Example Street 123","street_line_2":"II/123","region":"London","city":"London","country_code":"GB","postcode":"123456"},"category":"exhibition","market":"primary","tickets":[{"id":"example_ticket_1","transferable":false,"refundability":"partially_refundable"},{"id":"example_ticket_2","transferable":true,"refundability":"non_refundable"},{"id":"example_ticket_3"}]}]},"enforce_challenge":"automatic"}},"example_order_lodging":{"summary":"Example order response with additional lodging data","value":{"id":"67c70d42-1545-a73d-a4a5-35b7ac49e1da","token":"9effe2b6-8907-4954-9e9b-696f763f7e08","type":"payment","state":"pending","created_at":"2025-03-04T14:25:06.099782Z","updated_at":"2025-03-04T14:25:06.099782Z","amount":100,"currency":"GBP","outstanding_amount":100,"capture_mode":"automatic","authorisation_type":"final","checkout_url":"https://checkout.revolut.com/payment-link/9effe2b6-8907-4954-9e9b-696f763f7e08","industry_data":{"type":"lodging","booking_id":"example_booking_123","check_out_date":"2025-05-05T11:00:00Z","booking_type":"flexible","refundability":"partially_refundable","location":{"street_line_1":"Example Street 123","street_line_2":"II/123","region":"London","city":"London","country_code":"GB","postcode":"123456"},"guests":[{"first_name":"First","last_name":"Guest"},{"first_name":"Second","last_name":"Guest"}],"check_in_date":"2025-05-01T15:00:00Z","supplier_payment_date":"2025-05-05T11:00:00Z","category":"bed_and_breakfast"},"enforce_challenge":"automatic"}}}}},"descriptionNode":"$L132e"},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"code":{"type":"string","description":"An identifier that can be used to determine what went wrong.\n\nError codes are not globally unique, but uniqueness is guaranteed within endpoints.","descriptionNode":"$L132f"},"message":{"type":"string","description":"Some human readable text describing what went wrong.","descriptionNode":"$L1330"},"timestamp":{"type":"integer","description":"The [UNIX timestamp](https://www.unixtimestamp.com/) of the date and time the error happened.","descriptionNode":"$L1331"}}},"examples":{"example-1":{"value":{"code":"bad_request","message":"Could not parse JSON","timestamp":1601296792533}}}}},"descriptionNode":"$L1332"},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"code":{"type":"string","description":"An identifier that can be used to determine what went wrong.\n\nError codes are not globally unique, but uniqueness is guaranteed within endpoints.","descriptionNode":"$L1333"},"message":{"type":"string","description":"Some human readable text describing what went wrong.","descriptionNode":"$L1334"},"timestamp":{"type":"integer","description":"The [UNIX timestamp](https://www.unixtimestamp.com/) of the date and time the error happened.","descriptionNode":"$L1335"}}},"examples":{"default":{"value":{"code":"unauthenticated","message":"Authentication failed","timestamp":1721049596461}}}}},"descriptionNode":"$L1336"},"404":{"description":"Not Found","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"code":{"type":"string","description":"An identifier that can be used to determine what went wrong.\n\nError codes are not globally unique, but uniqueness is guaranteed within endpoints.","descriptionNode":"$L1337"},"message":{"type":"string","description":"Some human readable text describing what went wrong.","descriptionNode":"$L1338"},"timestamp":{"type":"integer","description":"The [UNIX timestamp](https://www.unixtimestamp.com/) of the date and time the error happened.","descriptionNode":"$L1339"}}},"examples":{"default":{"value":{"code":"not_found","message":"Order with id abfa5bbd-a20c-4a0e-be66-30e733454518 was not found","timestamp":1721050063886}}}}},"descriptionNode":"$L133a"}},"requestBody":"$undefined","variantLabels":["Example order response with minimal required parameters","Example order response with additional parameters","Example order response with pre-authorisation and card payment","example_order_line_items","Example order response with subscription data (cycle billing, no usage-based items)","Example order response with shipping details","Example order response with additional airline data","Example order response with additional car rental data","Example order response with additional crypto transaction data","Example order response with additional marketplace data","Example order response with additional event data","Example order response with additional lodging data"],"children":["$L133b","$L133c"]}]}],false]}] 1346:T4c1,Automatic cancellation period for uncaptured orders, specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. After this period, the authorised payment is automatically cancelled and the order is cancelled. Maximum: 7 days = `P7D`. :::note The following limitations apply: - Cannot be a negative value. - Cannot be updated if the new value is less than or equal to the elapsed time since authorisation. **Failing scenario:** - Original value: 7 days - Time since authorisation: 3 days - Update value: 2 days In this scenario, an error is returned. **Successful scenario:** - Original value: 7 days - Time since authorisation: 3 days - Update value: 4 days In this scenario, the parameter can be updated. - Cannot be updated if cancellation is ≤ 30 minutes away. **Failing scenario:** - Original value: 12 hours - Time since authorisation: 11 hours 40 minutes In this scenario, an error is returned. **Successful scenario:** - Original value: 12 hours - Time since authorisation: 11 hours 20 minutes In this scenario, the parameter can be updated. :::134d:T50a,Object containing information about a customer. If you have it, we strongly advise providing at least either `id`, `phone`, or `email`. Using the [Customers operations](https://developer.revolut.com/docs/api/merchant#tag-customers), you can manage customer instances. The following behaviours apply to different use cases: | Use case | API behavior | | -------- | ------------ | | Existing customer | If `id` was provided, we ignore other customer details and associate the customer with the order.

If either `email`, `phone`, or `full_name` was provided (without an existing customer's `id`), we always create a new customer, irrespective of another, existing customer object having the same details. | | New customer | If either `email`, `phone`, or `full_name` was provided, we create a new customer, irrespective of another customer object having the same details.

If `id` of a non-existent customer was provided, we return a `404` error, irrespective of other details provided. | :::note To avoid unintentional duplication of customer records, search for an existing customer by email or phone using the [List customers](https://developer.revolut.com/docs/api/merchant#retrieve-customer-list) endpoint first, then provide `customer.id` in the order. :::1376:T9bc,A unique identifier for a payment method, always 44 characters long. This fingerprint can be used to uniquely identify various payment methods. #### Fingerprint generation | Payment method | Description | | -------- | ----------- | | **All payment methods** | A fingerprint is generated for all payment methods, including cards, Revolut Pay (card, account-to-account payments), Apple Pay, and Google Pay. | | **Cards (Revolut Pay & Card Gateway)** | For cards, the fingerprint is based on the PAN. Cards processed via Revolut Pay and our card gateway will share the same fingerprint. Renewed cards (new expiry/CVV) retain the same fingerprint for efficient blocking. | | **Apple Pay & Google Pay** | Since Apple Pay and Google Pay provide us Device PANs (DPAN), the fingerprint is based on the DPAN provided by Apple/Google, not the connected card's PAN. This means that a new DPAN (and fingerprint) is generated for cards in case they are re-added to the customer's digital wallet, or added to different devices. | #### Detecting duplicate payment methods Fingerprints are a valuable tool for detecting duplicate payment methods by identifying if a payment method has been seen before. This capability, in turn, helps in preventing various types of misuse (e.g., exploitation of free trials, or association with known problematic accounts, which can be a form of fraud). To effectively use fingerprints for this purpose, you will need to create and maintain your own lists (e.g., blocklists of known problematic fingerprints, allowlists for trusted customers, or tracking frequently used fingerprints). The ideal way to utilise fingerprints is by combining them with a manual capture process. While automatic capture with subsequent refunds for problematic payments is possible, manual capture based on fingerprint validation is recommended. During your manual capture workflow, after a payment was authorised: - Check the fingerprint status by comparing it against your maintained lists and internal business rules. - If you decide to proceed with the payment (e.g., the fingerprint is not on a blocklist, or matches a trusted customer's previous payment method): [Capture the order](https://developer.revolut.com/docs/api/merchant#capture-order). - If you decide not to proceed with the payment (e.g., the fingerprint matches a known fraudulent fingerprint, or exhibits suspicious patterns): [Cancel the order](https://developer.revolut.com/docs/api/merchant#cancel-order).1388:T9bc,A unique identifier for a payment method, always 44 characters long. This fingerprint can be used to uniquely identify various payment methods. #### Fingerprint generation | Payment method | Description | | -------- | ----------- | | **All payment methods** | A fingerprint is generated for all payment methods, including cards, Revolut Pay (card, account-to-account payments), Apple Pay, and Google Pay. | | **Cards (Revolut Pay & Card Gateway)** | For cards, the fingerprint is based on the PAN. Cards processed via Revolut Pay and our card gateway will share the same fingerprint. Renewed cards (new expiry/CVV) retain the same fingerprint for efficient blocking. | | **Apple Pay & Google Pay** | Since Apple Pay and Google Pay provide us Device PANs (DPAN), the fingerprint is based on the DPAN provided by Apple/Google, not the connected card's PAN. This means that a new DPAN (and fingerprint) is generated for cards in case they are re-added to the customer's digital wallet, or added to different devices. | #### Detecting duplicate payment methods Fingerprints are a valuable tool for detecting duplicate payment methods by identifying if a payment method has been seen before. This capability, in turn, helps in preventing various types of misuse (e.g., exploitation of free trials, or association with known problematic accounts, which can be a form of fraud). To effectively use fingerprints for this purpose, you will need to create and maintain your own lists (e.g., blocklists of known problematic fingerprints, allowlists for trusted customers, or tracking frequently used fingerprints). The ideal way to utilise fingerprints is by combining them with a manual capture process. While automatic capture with subsequent refunds for problematic payments is possible, manual capture based on fingerprint validation is recommended. During your manual capture workflow, after a payment was authorised: - Check the fingerprint status by comparing it against your maintained lists and internal business rules. - If you decide to proceed with the payment (e.g., the fingerprint is not on a blocklist, or matches a trusted customer's previous payment method): [Capture the order](https://developer.revolut.com/docs/api/merchant#capture-order). - If you decide not to proceed with the payment (e.g., the fingerprint matches a known fraudulent fingerprint, or exhibits suspicious patterns): [Cancel the order](https://developer.revolut.com/docs/api/merchant#cancel-order).139a:T9bc,A unique identifier for a payment method, always 44 characters long. This fingerprint can be used to uniquely identify various payment methods. #### Fingerprint generation | Payment method | Description | | -------- | ----------- | | **All payment methods** | A fingerprint is generated for all payment methods, including cards, Revolut Pay (card, account-to-account payments), Apple Pay, and Google Pay. | | **Cards (Revolut Pay & Card Gateway)** | For cards, the fingerprint is based on the PAN. Cards processed via Revolut Pay and our card gateway will share the same fingerprint. Renewed cards (new expiry/CVV) retain the same fingerprint for efficient blocking. | | **Apple Pay & Google Pay** | Since Apple Pay and Google Pay provide us Device PANs (DPAN), the fingerprint is based on the DPAN provided by Apple/Google, not the connected card's PAN. This means that a new DPAN (and fingerprint) is generated for cards in case they are re-added to the customer's digital wallet, or added to different devices. | #### Detecting duplicate payment methods Fingerprints are a valuable tool for detecting duplicate payment methods by identifying if a payment method has been seen before. This capability, in turn, helps in preventing various types of misuse (e.g., exploitation of free trials, or association with known problematic accounts, which can be a form of fraud). To effectively use fingerprints for this purpose, you will need to create and maintain your own lists (e.g., blocklists of known problematic fingerprints, allowlists for trusted customers, or tracking frequently used fingerprints). The ideal way to utilise fingerprints is by combining them with a manual capture process. While automatic capture with subsequent refunds for problematic payments is possible, manual capture based on fingerprint validation is recommended. During your manual capture workflow, after a payment was authorised: - Check the fingerprint status by comparing it against your maintained lists and internal business rules. - If you decide to proceed with the payment (e.g., the fingerprint is not on a blocklist, or matches a trusted customer's previous payment method): [Capture the order](https://developer.revolut.com/docs/api/merchant#capture-order). - If you decide not to proceed with the payment (e.g., the fingerprint matches a known fraudulent fingerprint, or exhibits suspicious patterns): [Cancel the order](https://developer.revolut.com/docs/api/merchant#cancel-order).13ac:T9bc,A unique identifier for a payment method, always 44 characters long. This fingerprint can be used to uniquely identify various payment methods. #### Fingerprint generation | Payment method | Description | | -------- | ----------- | | **All payment methods** | A fingerprint is generated for all payment methods, including cards, Revolut Pay (card, account-to-account payments), Apple Pay, and Google Pay. | | **Cards (Revolut Pay & Card Gateway)** | For cards, the fingerprint is based on the PAN. Cards processed via Revolut Pay and our card gateway will share the same fingerprint. Renewed cards (new expiry/CVV) retain the same fingerprint for efficient blocking. | | **Apple Pay & Google Pay** | Since Apple Pay and Google Pay provide us Device PANs (DPAN), the fingerprint is based on the DPAN provided by Apple/Google, not the connected card's PAN. This means that a new DPAN (and fingerprint) is generated for cards in case they are re-added to the customer's digital wallet, or added to different devices. | #### Detecting duplicate payment methods Fingerprints are a valuable tool for detecting duplicate payment methods by identifying if a payment method has been seen before. This capability, in turn, helps in preventing various types of misuse (e.g., exploitation of free trials, or association with known problematic accounts, which can be a form of fraud). To effectively use fingerprints for this purpose, you will need to create and maintain your own lists (e.g., blocklists of known problematic fingerprints, allowlists for trusted customers, or tracking frequently used fingerprints). The ideal way to utilise fingerprints is by combining them with a manual capture process. While automatic capture with subsequent refunds for problematic payments is possible, manual capture based on fingerprint validation is recommended. During your manual capture workflow, after a payment was authorised: - Check the fingerprint status by comparing it against your maintained lists and internal business rules. - If you decide to proceed with the payment (e.g., the fingerprint is not on a blocklist, or matches a trusted customer's previous payment method): [Capture the order](https://developer.revolut.com/docs/api/merchant#capture-order). - If you decide not to proceed with the payment (e.g., the fingerprint matches a known fraudulent fingerprint, or exhibits suspicious patterns): [Cancel the order](https://developer.revolut.com/docs/api/merchant#cancel-order).13b2:T9bc,A unique identifier for a payment method, always 44 characters long. This fingerprint can be used to uniquely identify various payment methods. #### Fingerprint generation | Payment method | Description | | -------- | ----------- | | **All payment methods** | A fingerprint is generated for all payment methods, including cards, Revolut Pay (card, account-to-account payments), Apple Pay, and Google Pay. | | **Cards (Revolut Pay & Card Gateway)** | For cards, the fingerprint is based on the PAN. Cards processed via Revolut Pay and our card gateway will share the same fingerprint. Renewed cards (new expiry/CVV) retain the same fingerprint for efficient blocking. | | **Apple Pay & Google Pay** | Since Apple Pay and Google Pay provide us Device PANs (DPAN), the fingerprint is based on the DPAN provided by Apple/Google, not the connected card's PAN. This means that a new DPAN (and fingerprint) is generated for cards in case they are re-added to the customer's digital wallet, or added to different devices. | #### Detecting duplicate payment methods Fingerprints are a valuable tool for detecting duplicate payment methods by identifying if a payment method has been seen before. This capability, in turn, helps in preventing various types of misuse (e.g., exploitation of free trials, or association with known problematic accounts, which can be a form of fraud). To effectively use fingerprints for this purpose, you will need to create and maintain your own lists (e.g., blocklists of known problematic fingerprints, allowlists for trusted customers, or tracking frequently used fingerprints). The ideal way to utilise fingerprints is by combining them with a manual capture process. While automatic capture with subsequent refunds for problematic payments is possible, manual capture based on fingerprint validation is recommended. During your manual capture workflow, after a payment was authorised: - Check the fingerprint status by comparing it against your maintained lists and internal business rules. - If you decide to proceed with the payment (e.g., the fingerprint is not on a blocklist, or matches a trusted customer's previous payment method): [Capture the order](https://developer.revolut.com/docs/api/merchant#capture-order). - If you decide not to proceed with the payment (e.g., the fingerprint matches a known fraudulent fingerprint, or exhibits suspicious patterns): [Cancel the order](https://developer.revolut.com/docs/api/merchant#cancel-order).13f3:T5ef,Object containing additional information about an airline booking associated with the order. Use this object to provide required data to enable **Revolut Flight Alerts**. This feature allows users to receive real-time flight updates such as check-in reminders, boarding alerts, and notifications for cancellations or delays in the Revolut app. To enable **Revolut Flight Alerts** functionalities in the Revolut app, the following fields are **required** on order creation or update, before capturing the order: ``` tickets_purchase, journey_legs, booking_url ``` :::note These are the specific data field requirements for merchants who must provide airline data. Note that these requirements can be extended on a case by case basis as decided by Revolut. | Required for airline/charter merchants | Required for OTA merchants | | -------------------------------------- | -------------------------- | |
  • `booking_id`
  • `fulfillment_date`
  • `passengers[].first_name`
  • `passengers[].last_name`
  • `journey_legs[].pnr`
  • `journey_legs[].sequence`
  • `journey_legs[].flight_number`
  • `journey_legs[].travel_date`
  • `journey_legs[].airline_code`
  • `journey_legs[].departure_airport_code`
  • `journey_legs[].arrival_airport_code`
|
  • `booking_id`
  • `fulfillment_date`
  • `passengers[].first_name`
  • `passengers[].last_name`
  • `journey_legs[].pnr`
  • `journey_legs[].arrival_airport_code`
| :::147e:T480,You can set a dynamic statement descriptor for your orders by providing a custom suffix. A statement descriptor is the text shown on cardholders' bank or card statements, helping them recognise a transaction or merchant. This field can be used to send extra information with the statement descriptor for card transactions. The complete descriptor is built using the following format: `{base}*{suffix}`, where: - **`{base}`** is the existing descriptor configured in the Revolut Business dashboard (**Settings > Business account > Merchant profile > Statement descriptor**). - **`{suffix}`** is defined by the `statement_descriptor_suffix` field. :::note - If the combined descriptor's length (base + suffix) exceeds the character limits of card scheme providers, the final value will be truncated. For example if the limit is 22 characters, the base descriptor is `"base"` and the suffix is `"testdescriptorsuffix"`, the final descriptor becomes `"base*testdescriptorsuf"`. - The final statement descriptor shown on a cardholder's statement may vary by issuing bank, as some banks apply their own custom formatting or truncation rules. :::1e:["$","$7a","cancel-order",{"children":[["$","section",null,{"className":"y9a0do0","data-variant":"endpoint","children":["$","$L7b",null,{"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"title":"Order v5","type":"object","description":"To process the order from a credit or debit card, you create an `Order` object. You can then retrieve, capture, cancel, refund, or pay an order using its unique `id`. Alternatively, you can use its unique `token` to process a card payment with the Revolut Checkout Widget.","properties":{"id":{"type":"string","format":"uuid","description":"Permanent order ID used to retrieve, capture, cancel, or refund an order after authorization.","descriptionNode":"$L133d"},"token":{"type":"string","description":"Temporary ID for the order, which expires when the payment is authorised.\n\nThe order `token` is used for [token-based initialisation](https://developer.revolut.com/docs/sdks/merchant-web-sdk/initialisation/token-based), and is returned by the `createOrder` callback in the following payment methods:\n\n- [Embedded Checkout](https://developer.revolut.com/docs/sdks/merchant-web-sdk/payment-methods/embedded-checkout#embedded-checkout-options-interface)\n- [Revolut Pay](https://developer.revolut.com/docs/sdks/merchant-web-sdk/payment-methods/revolut-pay#widget-payments-revolut-pay-options)\n- [Apple Pay and Google Pay](https://developer.revolut.com/docs/sdks/merchant-web-sdk/payment-methods/apple-pay-google-pay#payment-request-options-interface)\n- [Pay by Bank](https://developer.revolut.com/docs/sdks/merchant-web-sdk/payment-methods/pay-by-bank#pay-by-bank-options-interface)","descriptionNode":"$L133e"},"type":{"type":"string","description":"The type of the order.","enum":"$19:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:orders:items:properties:type:enum","descriptionNode":"$L133f"},"state":{"type":"string","description":"The state of the order in its lifecycle.\n\n| State | Description |\n|-------|-------------|\n| `pending` | Order created, awaiting payment |\n| `processing` | Payment is being processed |\n| `authorised` | Payment authorised but not yet captured (for manual capture) |\n| `completed` | Payment successfully captured and settled |\n| `cancelled` | Order was cancelled |\n| `failed` | Payment failed |\n\n:::info\nFor more information, see: [Order and payment lifecycle](https://developer.revolut.com/docs/guides/merchant/reference/order-lifecycle)\n:::","enum":"$19:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:orders:items:properties:state:enum","examples":"$19:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:orders:items:properties:state:examples","descriptionNode":"$L1340"},"created_at":{"type":"string","description":"The date and time the order was created.","format":"date-time","descriptionNode":"$L1341"},"updated_at":{"type":"string","description":"The date and time the order was last updated.","format":"date-time","descriptionNode":"$L1342"},"description":{"type":"string","description":"The description of the order.","descriptionNode":"$L1343"},"capture_mode":{"type":"string","description":"The capture mode of the order. `automatic` is used by default.\n\n| Parameter value | Description |\n| --------------- | ----------- |\n| `automatic` | The order is captured automatically after payment authorisation. |\n| `manual` | The order is not captured automatically. You must manually capture the order later. |\n\n:::info\nFor more information, see [Capture an order](https://developer.revolut.com/docs/api/merchant#capture-order).\n:::","default":"automatic","enum":"$19:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:orders:items:properties:capture_mode:enum","descriptionNode":"$L1344"},"authorisation_type":{"type":"string","description":"The type of authorisation for the order. Used with manual capture mode. If omitted, `final` is used by default.\n\n### Pre-authorisation\n\nPre-authorisation allows you to reserve funds on a customer's card without immediately capturing them. This is useful for scenarios like:\n\n- Hotel bookings where the final amount may vary\n- Car rentals where additional charges may apply\n- Deposits that need to be held temporarily\n\n| Parameter value | Description |\n| --------------- | ----------- |\n| `final` | Standard authorisation for immediate or near-immediate capture. |\n| `pre_authorisation` | Reserve funds for later capture, used with manual capture mode. |\n\n:::note\nPre-authorisation must be used with `capture_mode: manual`. For more information, see [Capture an order](https://developer.revolut.com/docs/api/merchant#capture-order).\n:::","default":"final","enum":"$19:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:orders:items:properties:authorisation_type:enum","descriptionNode":"$L1345"},"cancel_authorised_after":{"type":"string","format":"duration","description":"$1346","descriptionNode":"$L1347"},"amount":{"type":"integer","description":"The order total expressed in minor currency units, according to the [ISO 4217 standard](https://en.wikipedia.org/wiki/ISO_4217). For example, `7034` in `EUR` corresponds to €70.34.\n\n:::info\n- Conversion between major and minor units varies by currency. For instance, `100` minor units equal £1.00 in `GBP`, whereas in `ISK` they represent 100 units. For more details, see the [ISO 4217 standard](https://en.wikipedia.org/wiki/ISO_4217).\n- If `line_items` are provided, the order `amount` must equal the sum of all line items' `total_amount`.\n- For card payments with a non-zero amount, the order `amount` must be at least **$0.005** (or equivalent in different currencies, calculated using Revolut's exchange rate on the payment date). Otherwise, card payments can't be performed.\n:::","descriptionNode":"$L1348"},"outstanding_amount":{"type":"integer","description":"The amount not yet paid for a given order (in minor currency units). For example, `7034` represents €70.34. \n\nThe value in this field may differ from `amount` if there are partial payments associated with the order.","descriptionNode":"$L1349"},"refunded_amount":{"type":"integer","description":"The amount that was refunded from the order (in minor currency units). For example, `7034` represents €70.34. \n\nThis applies to orders that have been refunded (i.e., orders of type `payment` that have a related `refund` order).","descriptionNode":"$L134a"},"currency":{"type":"string","format":"ISO 4217","minLength":3,"maxLength":3,"description":"[ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) currency code in upper case.\n\n:::info\nFor more information about the supported currencies, see: [Help Center](https://help.revolut.com/business/help/merchant-accounts/payments/in-which-currencies-can-i-accept-payments/).\n:::","descriptionNode":"$L134b"},"settlement_currency":{"type":"string","description":"[ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) currency code in upper case. \n\nIf `settlement_currency` is different from the value of `currency`, the money will be exchanged when the amount is settled to your merchant account. In case of a refund or chargeback, the money will be exchanged to the order's initial `currency`.\n\nIf `settlement_currency` is not specified, this value is taken from `currency`.\n\n:::info\nFor more information about the supported currencies, see: [Help Center](https://help.revolut.com/business/help/merchant-accounts/payments/in-which-currencies-can-i-accept-payments/).\n:::","descriptionNode":"$L134c"},"customer":{"type":"object","description":"$134d","properties":{"id":{"type":"string","format":"uuid","description":"Permanent ID of a customer used to retrieve, update, delete a customer. This ID can also be used to link customer to an order.\n\n:::note\nIf you provide the customer's ID during order creation, no other customer data is required, they will be parsed automatically from the referenced customer object.\n:::","descriptionNode":"$L134e"},"full_name":{"type":"string","description":"The full name of the customer.","descriptionNode":"$L134f"},"phone":{"type":"string","description":"The phone number of the customer in [E.164 format](https://en.wikipedia.org/wiki/E.164).","descriptionNode":"$L1350"},"email":{"type":"string","format":"email","description":"The email address of the customer.","descriptionNode":"$L1351"},"date_of_birth":{"type":"string","format":"date","description":"The birth date of the customer.","descriptionNode":"$L1352"}},"descriptionNode":"$L1353"},"payments":{"type":"array","description":"The details of all the payments that have been made towards this order (successful or unsuccessful).","items":{"type":"object","description":"Represents a payment for an order.\n\nFor pre-authorised payments, the `authorised_amount` field tracks the currently authorised amount, which may differ from `amount` during incremental authorisation processing.","properties":{"id":{"type":"string","format":"uuid","description":"The ID of the payment.","descriptionNode":"$L1354"},"state":{"type":"string","description":"The status of the payment.","enum":"$21:props:children:0:props:children:props:responses:200:content:application/json:schema:items:properties:state:enum","descriptionNode":"$L1355"},"decline_reason":{"type":"string","description":"The reason for a `failed` or `declined` payment.\n\nA failed or declined payment can result from multiple reasons. To learn more, check our [failure reasons](https://developer.revolut.com/docs/guides/merchant/reference/error-codes/decline-reasons).","enum":"$21:props:children:0:props:children:props:responses:200:content:application/json:schema:items:properties:decline_reason:enum","descriptionNode":"$L1356"},"bank_message":{"type":"string","description":"The reason for a `failed` or `declined` payment, sent by the financial institution processing the payment.","descriptionNode":"$L1357"},"created_at":{"type":"string","format":"date-time","description":"The date and time the payment was created.","descriptionNode":"$L1358"},"updated_at":{"type":"string","format":"date-time","description":"The date and time the payment was last updated.","descriptionNode":"$L1359"},"token":{"type":"string","format":"uuid","description":"Temporary token of the payment used to fetch the reward offer during checkout and link user registrations to the given offers. \n\nThe token is only valid for a limited time.","descriptionNode":"$L135a"},"amount":{"type":"integer","format":"int64","minimum":0,"description":"The payment amount in minor units (e.g., cents). The value of this field depends on the payment type and state.\n\n| Payment type | State | Amount value |\n|--------------|-------|--------------|\n| Standard payment | Any | Total payment amount |\n| Pre-authorised payment | `authorisation_started` | New amount being authorised (during increment processing) |\n| Pre-authorised payment | `authorised` | Currently authorised amount (equals `authorised_amount`) |\n\n:::info\nFor pre-authorised payments, see the `authorised_amount` field for tracking the currently authorised amount separately.\n:::","examples":"$21:props:children:0:props:children:props:responses:200:content:application/json:schema:items:properties:amount:examples","descriptionNode":"$L135b"},"authorised_amount":{"type":"integer","description":"The currently authorised amount for this payment (in minor units).\n\nFor pre-authorised payments with incremental authorization:\n- Initially equals the `amount` field\n- Remains unchanged during increment processing\n- Updates to new amount upon successful increment\n- Remains at original amount if increment is declined\n\nFor standard payments, this field may not be present or will equal the `amount` field.","examples":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:authorised_amount:examples","descriptionNode":"$L135c"},"currency":{"type":"string","format":"ISO 4217","minLength":3,"maxLength":3,"description":"[ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) currency code in upper case.\n\n:::info\nFor more information about the supported currencies, see: [Help Center](https://help.revolut.com/business/help/merchant-accounts/payments/in-which-currencies-can-i-accept-payments/).\n:::","descriptionNode":"$L135d"},"settled_amount":{"type":"integer","description":"The amount of the settled payment (minor currency unit). For example, `7034` stands for €70.34.","descriptionNode":"$L135e"},"settled_currency":{"type":"string","description":"The currency of the settled payment. [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) currency code in upper case.\n\n:::info\nFor more information about the supported currencies, see: [Help Center](https://help.revolut.com/business/help/merchant-accounts/payments/in-which-currencies-can-i-accept-payments/).\n:::","descriptionNode":"$L135f"},"payment_method":{"type":"object","description":"The details of the payment method used to make the payment.","discriminator":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:discriminator","oneOf":[{"type":"object","description":"Object containing details of a card used via Apple Pay.","properties":{"id":{"type":"string","format":"uuid","description":"ID of the saved payment method.\n\n:::note\nThe `id` parameter is only returned when the payment method is saved.\n:::","descriptionNode":"$L1360"},"type":{"type":"string","enum":"$21:props:children:0:props:children:props:responses:200:content:application/json:schema:items:properties:payment_method:oneOf:2:properties:type:enum","description":"The type of payment method used to pay for the order.\n\nAvailable values:\n\n| Payment method `type` | Description |\n| --------------------- | ----------- |\n| `apple_pay` | The customer paid the order using Apple Pay. |\n| `card` | The customer paid the order using their credit or debit card. |\n| `google_pay` | The customer paid the order using Google Pay. |\n| `revolut_pay_card` | The customer paid the order via Revolut Pay using their credit or debit card. |\n| `revolut_pay_account` | The customer paid the order via Revolut Pay using their Revolut account. |\n| `sepa_direct_debit` | The customer paid the order using SEPA Direct Debit. |","descriptionNode":"$L1361"},"card_brand":{"type":"string","description":"The type of the card.","enum":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:0:properties:card_brand:enum","descriptionNode":"$L1362"},"funding":{"type":"string","description":"The type of card funding.","enum":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:0:properties:funding:enum","descriptionNode":"$L1363"},"card_country_code":{"type":"string","description":"The 2-letter country code of the country where the card was issued.","descriptionNode":"$L1364"},"card_bin":{"type":"string","description":"The BIN of the card.","minLength":6,"maxLength":6,"descriptionNode":"$L1365"},"card_last_four":{"type":"string","description":"The last four digits of the card number.","minLength":4,"maxLength":4,"descriptionNode":"$L1366"},"card_expiry":{"type":"string","format":"MM/YY","description":"The expiry date of the card in the format of MM/YY.","descriptionNode":"$L1367"},"cardholder_name":{"type":"string","description":"The name of the cardholder.","descriptionNode":"$L1368"},"checks":{"type":"object","description":"The details of the check for card payment. Only for orders with successful payments.","properties":{"three_ds":{"type":"object","description":"The details of the 3D Secure check. Only for orders with successful payments.\n\n:::note\nNot returned for Apple Pay and Google Pay payments.\n:::","properties":{"eci":{"type":"string","description":"The Electronic Commerce Indicator (ECI) value corresponds to the authentication result and indicates the level of security used when the payment information was provided.","descriptionNode":"$L1369"},"state":{"type":"string","description":"The result of 3D Secure check.","enum":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:0:properties:checks:properties:three_ds:properties:state:enum","descriptionNode":"$L136a"},"version":{"type":"integer","description":"The 3D Secure version.","descriptionNode":"$L136b"}},"descriptionNode":"$L136c"},"cvv_verification":{"type":"string","description":"The result of CVV verification.\n\n| Parameter value | Description |\n| ----- | ----------- |\n| `match` | CVV matches the card's CVV |\n| `not_match` | CVV does not match the card's CVV |\n| `incorrect` | CVV format is incorrect for this type of card |\n| `not_processed` | CVV verification was not performed |","enum":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:0:properties:checks:properties:cvv_verification:enum","descriptionNode":"$L136d"},"address":{"type":"string","description":"The result of address verification.","enum":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:0:properties:checks:properties:address:enum","descriptionNode":"$L136e"},"postcode":{"type":"string","description":"The result of postcode verification.","enum":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:0:properties:checks:properties:postcode:enum","descriptionNode":"$L136f"},"cardholder":{"type":"string","description":"The result of cardholder verification.","enum":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:0:properties:checks:properties:cardholder:enum","descriptionNode":"$L1370"}},"descriptionNode":"$L1371"},"authorisation_code":{"type":"string","description":"The authorisation code (or auth code) is a short, alphanumeric code returned by the cardholder's issuing bank to the merchant's terminal or payment gateway.\n\nIt serves as confirmation that the transaction has been approved and funds are available.","pattern":"^[a-zA-Z0-9]{2,6}$","minLength":2,"maxLength":6,"examples":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:0:properties:authorisation_code:examples","descriptionNode":"$L1372"},"arn":{"type":"string","description":"Acquirer Reference Number (ARN) of the payment.\n\n:::note\nOnly returned for refund payments made by a card.\n:::","minLength":23,"maxLength":23,"examples":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:0:properties:arn:examples","descriptionNode":"$L1373"},"capture_deadline":{"type":"string","format":"date-time","description":"The date and time by which the payment must be captured.\n\nAfter this deadline, the authorised funds may be automatically released by the card issuer.","descriptionNode":"$L1374"},"terminal_hardware_id":{"type":"string","description":"The hardware identifier of the Revolut Terminal device used to process the payment.\n\n:::note\nOnly present for card-present transactions processed via Revolut Terminal.\n:::","descriptionNode":"$L1375"},"fingerprint":{"type":"string","minLength":44,"maxLength":44,"description":"$1376","examples":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:0:properties:fingerprint:examples","descriptionNode":"$L1377"},"network_transaction_id":{"type":"string","description":"The Network Transaction ID (NTI) is a unique identifier assigned by the card scheme (e.g., Visa or Mastercard) to a card transaction.\n\nIt can be used to trace the transaction across the payment network, link recurring or instalment payments to the original authorisation, and support dispute resolution.","descriptionNode":"$L1378"}},"required":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:0:required","descriptionNode":"$L1379"},{"type":"object","description":"Object containing details of the card used for the payment.","properties":{"id":{"type":"string","format":"uuid","description":"ID of the saved payment method.\n\n:::note\nThe `id` parameter is only returned when the payment method is saved.\n:::","descriptionNode":"$L137a"},"type":{"type":"string","enum":"$21:props:children:0:props:children:props:responses:200:content:application/json:schema:items:properties:payment_method:oneOf:2:properties:type:enum","description":"The type of payment method used to pay for the order.\n\nAvailable values:\n\n| Payment method `type` | Description |\n| --------------------- | ----------- |\n| `apple_pay` | The customer paid the order using Apple Pay. |\n| `card` | The customer paid the order using their credit or debit card. |\n| `google_pay` | The customer paid the order using Google Pay. |\n| `revolut_pay_card` | The customer paid the order via Revolut Pay using their credit or debit card. |\n| `revolut_pay_account` | The customer paid the order via Revolut Pay using their Revolut account. |\n| `sepa_direct_debit` | The customer paid the order using SEPA Direct Debit. |","descriptionNode":"$L137b"},"card_brand":{"type":"string","description":"The type of the card.","enum":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:1:properties:card_brand:enum","descriptionNode":"$L137c"},"funding":{"type":"string","description":"The type of card funding.","enum":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:1:properties:funding:enum","descriptionNode":"$L137d"},"card_country_code":{"type":"string","description":"The 2-letter country code of the country where the card was issued.","descriptionNode":"$L137e"},"card_bin":{"type":"string","description":"The BIN of the card.","minLength":6,"maxLength":6,"descriptionNode":"$L137f"},"card_last_four":{"type":"string","description":"The last four digits of the card number.","minLength":4,"maxLength":4,"descriptionNode":"$L1380"},"card_expiry":{"type":"string","format":"MM/YY","description":"The expiry date of the card in the format of MM/YY.","descriptionNode":"$L1381"},"cardholder_name":{"type":"string","description":"The name of the cardholder.","descriptionNode":"$L1382"},"checks":{"type":"object","description":"The details of the check for card payment. Only for orders with successful payments.","properties":{"three_ds":"$1e:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payments:items:properties:payment_method:oneOf:0:properties:checks:properties:three_ds","cvv_verification":"$1e:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payments:items:properties:payment_method:oneOf:0:properties:checks:properties:cvv_verification","address":"$1e:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payments:items:properties:payment_method:oneOf:0:properties:checks:properties:address","postcode":"$1e:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payments:items:properties:payment_method:oneOf:0:properties:checks:properties:postcode","cardholder":"$1e:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payments:items:properties:payment_method:oneOf:0:properties:checks:properties:cardholder"},"descriptionNode":"$L1383"},"authorisation_code":{"type":"string","description":"The authorisation code (or auth code) is a short, alphanumeric code returned by the cardholder's issuing bank to the merchant's terminal or payment gateway.\n\nIt serves as confirmation that the transaction has been approved and funds are available.","pattern":"^[a-zA-Z0-9]{2,6}$","minLength":2,"maxLength":6,"examples":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:0:properties:authorisation_code:examples","descriptionNode":"$L1384"},"arn":{"type":"string","description":"Acquirer Reference Number (ARN) of the payment.\n\n:::note\nOnly returned for refund payments made by a card.\n:::","minLength":23,"maxLength":23,"examples":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:0:properties:arn:examples","descriptionNode":"$L1385"},"capture_deadline":{"type":"string","format":"date-time","description":"The date and time by which the payment must be captured.\n\nAfter this deadline, the authorised funds may be automatically released by the card issuer.","descriptionNode":"$L1386"},"terminal_hardware_id":{"type":"string","description":"The hardware identifier of the Revolut Terminal device used to process the payment.\n\n:::note\nOnly present for card-present transactions processed via Revolut Terminal.\n:::","descriptionNode":"$L1387"},"fingerprint":{"type":"string","minLength":44,"maxLength":44,"description":"$1388","examples":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:0:properties:fingerprint:examples","descriptionNode":"$L1389"},"network_transaction_id":{"type":"string","description":"The Network Transaction ID (NTI) is a unique identifier assigned by the card scheme (e.g., Visa or Mastercard) to a card transaction.\n\nIt can be used to trace the transaction across the payment network, link recurring or instalment payments to the original authorisation, and support dispute resolution.","descriptionNode":"$L138a"}},"required":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:1:required","descriptionNode":"$L138b"},{"type":"object","description":"Object containing details of a card used via Google Pay.","properties":{"id":{"type":"string","format":"uuid","description":"ID of the saved payment method.\n\n:::note\nThe `id` parameter is only returned when the payment method is saved.\n:::","descriptionNode":"$L138c"},"type":{"type":"string","enum":"$21:props:children:0:props:children:props:responses:200:content:application/json:schema:items:properties:payment_method:oneOf:2:properties:type:enum","description":"The type of payment method used to pay for the order.\n\nAvailable values:\n\n| Payment method `type` | Description |\n| --------------------- | ----------- |\n| `apple_pay` | The customer paid the order using Apple Pay. |\n| `card` | The customer paid the order using their credit or debit card. |\n| `google_pay` | The customer paid the order using Google Pay. |\n| `revolut_pay_card` | The customer paid the order via Revolut Pay using their credit or debit card. |\n| `revolut_pay_account` | The customer paid the order via Revolut Pay using their Revolut account. |\n| `sepa_direct_debit` | The customer paid the order using SEPA Direct Debit. |","descriptionNode":"$L138d"},"card_brand":{"type":"string","description":"The type of the card.","enum":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:2:properties:card_brand:enum","descriptionNode":"$L138e"},"funding":{"type":"string","description":"The type of card funding.","enum":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:2:properties:funding:enum","descriptionNode":"$L138f"},"card_country_code":{"type":"string","description":"The 2-letter country code of the country where the card was issued.","descriptionNode":"$L1390"},"card_bin":{"type":"string","description":"The BIN of the card.","minLength":6,"maxLength":6,"descriptionNode":"$L1391"},"card_last_four":{"type":"string","description":"The last four digits of the card number.","minLength":4,"maxLength":4,"descriptionNode":"$L1392"},"card_expiry":{"type":"string","format":"MM/YY","description":"The expiry date of the card in the format of MM/YY.","descriptionNode":"$L1393"},"cardholder_name":{"type":"string","description":"The name of the cardholder.","descriptionNode":"$L1394"},"checks":{"type":"object","description":"The details of the check for card payment. Only for orders with successful payments.","properties":{"three_ds":"$1e:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payments:items:properties:payment_method:oneOf:0:properties:checks:properties:three_ds","cvv_verification":"$1e:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payments:items:properties:payment_method:oneOf:0:properties:checks:properties:cvv_verification","address":"$1e:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payments:items:properties:payment_method:oneOf:0:properties:checks:properties:address","postcode":"$1e:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payments:items:properties:payment_method:oneOf:0:properties:checks:properties:postcode","cardholder":"$1e:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payments:items:properties:payment_method:oneOf:0:properties:checks:properties:cardholder"},"descriptionNode":"$L1395"},"authorisation_code":{"type":"string","description":"The authorisation code (or auth code) is a short, alphanumeric code returned by the cardholder's issuing bank to the merchant's terminal or payment gateway.\n\nIt serves as confirmation that the transaction has been approved and funds are available.","pattern":"^[a-zA-Z0-9]{2,6}$","minLength":2,"maxLength":6,"examples":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:0:properties:authorisation_code:examples","descriptionNode":"$L1396"},"arn":{"type":"string","description":"Acquirer Reference Number (ARN) of the payment.\n\n:::note\nOnly returned for refund payments made by a card.\n:::","minLength":23,"maxLength":23,"examples":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:0:properties:arn:examples","descriptionNode":"$L1397"},"capture_deadline":{"type":"string","format":"date-time","description":"The date and time by which the payment must be captured.\n\nAfter this deadline, the authorised funds may be automatically released by the card issuer.","descriptionNode":"$L1398"},"terminal_hardware_id":{"type":"string","description":"The hardware identifier of the Revolut Terminal device used to process the payment.\n\n:::note\nOnly present for card-present transactions processed via Revolut Terminal.\n:::","descriptionNode":"$L1399"},"fingerprint":{"type":"string","minLength":44,"maxLength":44,"description":"$139a","examples":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:0:properties:fingerprint:examples","descriptionNode":"$L139b"},"network_transaction_id":{"type":"string","description":"The Network Transaction ID (NTI) is a unique identifier assigned by the card scheme (e.g., Visa or Mastercard) to a card transaction.\n\nIt can be used to trace the transaction across the payment network, link recurring or instalment payments to the original authorisation, and support dispute resolution.","descriptionNode":"$L139c"}},"required":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:2:required","descriptionNode":"$L139d"},{"type":"object","description":"Object containing details of a card used via Revolut Pay.","properties":{"id":{"type":"string","format":"uuid","description":"ID of the saved payment method.\n\n:::note\nThe `id` parameter is only returned when the payment method is saved.\n:::","descriptionNode":"$L139e"},"type":{"type":"string","enum":"$21:props:children:0:props:children:props:responses:200:content:application/json:schema:items:properties:payment_method:oneOf:2:properties:type:enum","description":"The type of payment method used to pay for the order.\n\nAvailable values:\n\n| Payment method `type` | Description |\n| --------------------- | ----------- |\n| `apple_pay` | The customer paid the order using Apple Pay. |\n| `card` | The customer paid the order using their credit or debit card. |\n| `google_pay` | The customer paid the order using Google Pay. |\n| `revolut_pay_card` | The customer paid the order via Revolut Pay using their credit or debit card. |\n| `revolut_pay_account` | The customer paid the order via Revolut Pay using their Revolut account. |\n| `sepa_direct_debit` | The customer paid the order using SEPA Direct Debit. |","descriptionNode":"$L139f"},"card_brand":{"type":"string","description":"The type of the card.","enum":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:3:properties:card_brand:enum","descriptionNode":"$L13a0"},"funding":{"type":"string","description":"The type of card funding.","enum":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:3:properties:funding:enum","descriptionNode":"$L13a1"},"card_country_code":{"type":"string","description":"The 2-letter country code of the country where the card was issued.","descriptionNode":"$L13a2"},"card_bin":{"type":"string","description":"The BIN of the card.","minLength":6,"maxLength":6,"descriptionNode":"$L13a3"},"card_last_four":{"type":"string","description":"The last four digits of the card number.","minLength":4,"maxLength":4,"descriptionNode":"$L13a4"},"card_expiry":{"type":"string","format":"MM/YY","description":"The expiry date of the card in the format of MM/YY.","descriptionNode":"$L13a5"},"cardholder_name":{"type":"string","description":"The name of the cardholder.","descriptionNode":"$L13a6"},"checks":{"type":"object","description":"The details of the check for card payment. Only for orders with successful payments.","properties":{"three_ds":"$1e:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payments:items:properties:payment_method:oneOf:0:properties:checks:properties:three_ds","cvv_verification":"$1e:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payments:items:properties:payment_method:oneOf:0:properties:checks:properties:cvv_verification","address":"$1e:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payments:items:properties:payment_method:oneOf:0:properties:checks:properties:address","postcode":"$1e:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payments:items:properties:payment_method:oneOf:0:properties:checks:properties:postcode","cardholder":"$1e:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payments:items:properties:payment_method:oneOf:0:properties:checks:properties:cardholder"},"descriptionNode":"$L13a7"},"authorisation_code":{"type":"string","description":"The authorisation code (or auth code) is a short, alphanumeric code returned by the cardholder's issuing bank to the merchant's terminal or payment gateway.\n\nIt serves as confirmation that the transaction has been approved and funds are available.","pattern":"^[a-zA-Z0-9]{2,6}$","minLength":2,"maxLength":6,"examples":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:0:properties:authorisation_code:examples","descriptionNode":"$L13a8"},"arn":{"type":"string","description":"Acquirer Reference Number (ARN) of the payment.\n\n:::note\nOnly returned for refund payments made by a card.\n:::","minLength":23,"maxLength":23,"examples":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:0:properties:arn:examples","descriptionNode":"$L13a9"},"capture_deadline":{"type":"string","format":"date-time","description":"The date and time by which the payment must be captured.\n\nAfter this deadline, the authorised funds may be automatically released by the card issuer.","descriptionNode":"$L13aa"},"terminal_hardware_id":{"type":"string","description":"The hardware identifier of the Revolut Terminal device used to process the payment.\n\n:::note\nOnly present for card-present transactions processed via Revolut Terminal.\n:::","descriptionNode":"$L13ab"},"fingerprint":{"type":"string","minLength":44,"maxLength":44,"description":"$13ac","examples":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:0:properties:fingerprint:examples","descriptionNode":"$L13ad"},"network_transaction_id":{"type":"string","description":"The Network Transaction ID (NTI) is a unique identifier assigned by the card scheme (e.g., Visa or Mastercard) to a card transaction.\n\nIt can be used to trace the transaction across the payment network, link recurring or instalment payments to the original authorisation, and support dispute resolution.","descriptionNode":"$L13ae"}},"required":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:3:required","descriptionNode":"$L13af"},{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"ID of the saved payment method.\n\n:::note\nThe `id` parameter is only returned when the payment method is saved.\n:::","descriptionNode":"$L13b0"},"type":{"type":"string","enum":"$21:props:children:0:props:children:props:responses:200:content:application/json:schema:items:properties:payment_method:oneOf:2:properties:type:enum","description":"The type of payment method used to pay for the order.\n\nAvailable values:\n\n| Payment method `type` | Description |\n| --------------------- | ----------- |\n| `apple_pay` | The customer paid the order using Apple Pay. |\n| `card` | The customer paid the order using their credit or debit card. |\n| `google_pay` | The customer paid the order using Google Pay. |\n| `revolut_pay_card` | The customer paid the order via Revolut Pay using their credit or debit card. |\n| `revolut_pay_account` | The customer paid the order via Revolut Pay using their Revolut account. |\n| `sepa_direct_debit` | The customer paid the order using SEPA Direct Debit. |","descriptionNode":"$L13b1"},"fingerprint":{"type":"string","minLength":44,"maxLength":44,"description":"$13b2","examples":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:0:properties:fingerprint:examples","descriptionNode":"$L13b3"}},"required":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:4:required"},{"type":"object","description":"Object containing details of a SEPA Direct Debit payment.\n\n:::info\nFor more information, see: [SEPA Direct Debit server-to-server integration](https://developer.revolut.com/docs/guides/merchant/accept-payments/payment-methods/sepa-direct-debit/server-to-server)\n:::","properties":{"id":{"type":"string","format":"uuid","description":"ID of the saved payment method.\n\n:::note\nThe `id` parameter is only returned when the payment method is saved for the merchant.\n:::","descriptionNode":"$L13b4"},"type":{"type":"string","enum":"$21:props:children:0:props:children:props:responses:200:content:application/json:schema:items:properties:payment_method:oneOf:2:properties:type:enum","description":"The type of payment method used to pay for the order.\n\nAvailable values:\n\n| Payment method `type` | Description |\n| --------------------- | ----------- |\n| `apple_pay` | The customer paid the order using Apple Pay. |\n| `card` | The customer paid the order using their credit or debit card. |\n| `google_pay` | The customer paid the order using Google Pay. |\n| `revolut_pay_card` | The customer paid the order via Revolut Pay using their credit or debit card. |\n| `revolut_pay_account` | The customer paid the order via Revolut Pay using their Revolut account. |\n| `sepa_direct_debit` | The customer paid the order using SEPA Direct Debit. |","descriptionNode":"$L13b5"},"debtor_iban_last_four":{"type":"string","description":"The last four digits of the debtor's IBAN.","minLength":4,"maxLength":4,"descriptionNode":"$L13b6"},"debtor_name":{"type":"string","description":"The full name of the debtor as provided in the mandate.","descriptionNode":"$L13b7"},"mandate_reference":{"type":"string","description":"The unique mandate reference generated by Revolut. Include this in pre-debit notifications sent to your customers.","descriptionNode":"$L13b8"}},"required":"$21:props:children:0:props:children:props:responses:200:content:application/json:schema:items:properties:payment_method:oneOf:2:required","descriptionNode":"$L13b9"}],"descriptionNode":"$L13ba"},"authentication_challenge":{"type":"object","description":"Details about the authentication challenge that should be performed to complete the authentication process. For more information about Revolut's 3DS solution, see: [3D Secure overview](https://developer.revolut.com/docs/guides/merchant/reference/3d-secure).\n\nOnly returned if the payment's state is `authentication_challenge`.","discriminator":"$21:props:children:0:props:children:props:responses:200:content:application/json:schema:items:properties:authentication_challenge:discriminator","oneOf":[{"title":"three_ds","type":"object","description":"Information about the 3DS challenge.","properties":{"type":{"type":"string","enum":"$21:props:children:0:props:children:props:responses:200:content:application/json:schema:items:properties:authentication_challenge:oneOf:0:properties:type:enum","description":"Type of the authentication challenge the payment triggers.","descriptionNode":"$L13bb"},"acs_url":{"type":"string","format":"url","description":"The URL of the authentication challenge.","descriptionNode":"$L13bc"}},"required":"$21:props:children:0:props:children:props:responses:200:content:application/json:schema:items:properties:authentication_challenge:oneOf:0:required","descriptionNode":"$L13bd"},{"title":"three_ds_fingerprint","type":"object","description":"Information about the 3DS fingerprint challenge.","properties":{"type":{"type":"string","enum":"$21:props:children:0:props:children:props:responses:200:content:application/json:schema:items:properties:authentication_challenge:oneOf:0:properties:type:enum","description":"Type of the authentication challenge the payment triggers.","descriptionNode":"$L13be"},"fingerprint_url":{"type":"string","format":"url","description":"The URL of the fingerprint. (Used only internally by Revolut.)","descriptionNode":"$L13bf"},"fingerprint_data":{"type":"string","format":"JSON","description":"Data about the fingerprint used for authentication. (Used only internally\nby Revolut.)","descriptionNode":"$L13c0"}},"required":"$21:props:children:0:props:children:props:responses:200:content:application/json:schema:items:properties:authentication_challenge:oneOf:1:required","descriptionNode":"$L13c1"}],"descriptionNode":"$L13c2"},"billing_address":{"type":"object","description":"Object containing address details.","properties":{"street_line_1":{"type":"string","description":"Street line 1 information.","maxLength":100,"descriptionNode":"$L13c3"},"street_line_2":{"type":"string","description":"Street line 2 information.","maxLength":100,"descriptionNode":"$L13c4"},"region":{"type":"string","description":"The region associated with the address.","maxLength":100,"descriptionNode":"$L13c5"},"city":{"type":"string","description":"The city associated with the address.","maxLength":100,"descriptionNode":"$L13c6"},"country_code":{"type":"string","description":"The 2-letter country code of the country associated with the address.","maxLength":2,"descriptionNode":"$L13c7"},"postcode":{"type":"string","description":"The postcode associated with the address.","maxLength":100,"descriptionNode":"$L13c8"}},"required":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:billing_address:required","descriptionNode":"$L13c9"},"risk_level":{"type":"string","description":"The risk level of the card.\n\nIf the risk level is `high`, the payment might be declined.","enum":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:risk_level:enum","descriptionNode":"$L13ca"},"fees":{"type":"array","description":"The details of the order fee.","items":{"type":"object","properties":{"type":{"type":"string","description":"The type of the order fee.","enum":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:fees:items:properties:type:enum","descriptionNode":"$L13cb"},"amount":{"type":"integer","description":"The amount of the payment fee (minor currency unit). For example, enter `7034` for €70.34 in the field.","descriptionNode":"$L13cc"},"currency":{"type":"string","description":"The currency of the payment fee. [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) currency code in upper case.\n\n:::info\nFor more information about the supported currencies, see: [Help Center](https://help.revolut.com/business/help/merchant-accounts/payments/in-which-currencies-can-i-accept-payments/).\n:::","descriptionNode":"$L13cd"}}},"descriptionNode":"$L13ce"},"payer":{"title":"Payer","type":"object","description":"The person who made the payment. This object is present when an email or phone number is provided during the payment flow.\n\nCapturing payer details lets you identify exactly who authorised the charge, reach the right person for receipts or refund queries, and support compliance or fraud-review workflows where the paying identity matters.","properties":{"email":{"description":"The email of the person who made the payment.","type":"string","format":"email","descriptionNode":"$L13cf"},"phone":{"description":"The phone number of the payer in [E.164 format](https://en.wikipedia.org/wiki/E.164).","type":"string","descriptionNode":"$L13d0"}},"descriptionNode":"$L13d1"}},"required":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payments:items:required","descriptionNode":"$L13d2"},"descriptionNode":"$L13d3"},"incremental_authorisations":{"type":"array","description":"History of incremental authorisation attempts for this order.\n\nOnly present for orders with `authorisation_type: pre_authorisation`.\n\nContains all increment attempts in chronological order.","items":{"type":"object","description":"Represents a single incremental authorisation attempt on an order.\n\nThe `incremental_authorisations` array tracks all increment attempts (successful and failed) in chronological order.","properties":{"new_amount":{"type":"integer","description":"The new total amount requested in this increment (in minor units).","examples":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:incremental_authorisations:items:properties:new_amount:examples","descriptionNode":"$L13d4"},"old_amount":{"type":"integer","description":"The previously authorised amount before this increment (in minor units).","examples":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:incremental_authorisations:items:properties:old_amount:examples","descriptionNode":"$L13d5"},"state":{"type":"string","enum":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:incremental_authorisations:items:properties:state:enum","description":"The state of this incremental authorization attempt.\n\n| State | Description |\n|-------|-------------|\n| `pending` | Increment registered in system, not yet submitted to card network |\n| `processing` | Increment is being processed by card network |\n| `authorised` | Increment was successfully authorised |\n| `declined` | Increment was declined by card issuer |\n| `failed` | Increment failed due to technical error (not an issuer decline) |","descriptionNode":"$L13d6"},"reference":{"type":"string","maxLength":255,"description":"External reference for this incremental authorisation.\n\n:::tip\nUse your internal charge or invoice ID. This reference is returned in webhooks for easy matching to your system.\n:::","examples":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:incremental_authorisations:items:properties:reference:examples","descriptionNode":"$L13d7"},"line_items":{"type":"array","description":"Line items associated with this increment (if provided).\n\n:::note\nIf the increment is successful, these line items will override the existing order line items.\n:::","items":{"type":"object","properties":{"name":{"type":"string","maxLength":250,"description":"Name of the line item.","descriptionNode":"$L13d8"},"type":{"type":"string","enum":"$19:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:orders:items:properties:line_items:items:properties:type:enum","description":"Type of the line item.","descriptionNode":"$L13d9"},"quantity":{"type":"object","description":"Object representing the quantity details of a line item, including the amount and its associated unit of measurement.","properties":{"value":{"type":"number","format":"double","minimum":0,"description":"The number of units of the line item.","descriptionNode":"$L13da"},"unit":{"type":"string","maxLength":100,"description":"The measurement unit for the quantity, such as `cm`, or `kg`.","descriptionNode":"$L13db"}},"required":"$19:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:orders:items:properties:line_items:items:properties:quantity:required","descriptionNode":"$L13dc"},"unit_price_amount":{"type":"integer","format":"int64","minimum":0,"description":"The unit price of the line item.","descriptionNode":"$L13dd"},"total_amount":{"type":"integer","format":"int64","description":"The total amount to be paid for the line item, including taxes and discounts.","descriptionNode":"$L13de"},"external_id":{"type":"string","maxLength":250,"description":"Unique identifier of line item in the merchant's system.","descriptionNode":"$L13df"},"discounts":{"type":"array","maxItems":50,"description":"A list of discounts applied to the line item. Each discount should be subtracted from the total amount payable for the item.","items":{"type":"object","description":"Details of a discount applied to the line item, including its name and monetary value.","properties":{"name":{"type":"string","maxLength":100,"description":"The specific name or label of the discount applied to the line item.","descriptionNode":"$L13e0"},"amount":{"type":"integer","format":"int64","minimum":0,"description":"The monetary value of the discount. ","descriptionNode":"$L13e1"}},"required":"$19:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:orders:items:properties:line_items:items:properties:discounts:items:required","descriptionNode":"$L13e2"},"descriptionNode":"$L13e3"},"taxes":{"type":"array","maxItems":50,"description":"A list of taxes applied to the line item. Each tax should be added to the total amount payable for the item.","items":{"type":"object","description":"Details about a tax applied to the line item, including its name and the corresponding amount.","properties":{"name":{"type":"string","description":"The specific name or designation of the tax applied to the line item.","maxLength":100,"descriptionNode":"$L13e4"},"amount":{"type":"integer","format":"int64","description":"The monetary value of the tax in minor currency units (e.g., cents for EUR).","minimum":0,"descriptionNode":"$L13e5"}},"required":"$19:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:orders:items:properties:line_items:items:properties:taxes:items:required","descriptionNode":"$L13e6"},"descriptionNode":"$L13e7"},"image_urls":{"type":"array","maxItems":50,"description":"A list of URLs pointing to images related to the line item. These images can provide visual details or representations of the item.","items":{"type":"string","format":"uri","pattern":"^https?:\\/{2}.+/gi","maxLength":2000,"description":"URL to an image associated with the line item.\n\n:::warning\nRestrictions:\n- Must be a valid URI as defined by [RFC 3986](https://datatracker.ietf.org/doc/html/rfc3986)\n- URI scheme is required and must be either `http` or `https`\n- URI host is required and cannot be `localhost` or an IP address\n- Max length: `2000`\n- Reserved or invalid characters must be percent-encoded (for example, use `%20` instead of a space)\n:::","descriptionNode":"$L13e8"},"descriptionNode":"$L13e9"},"description":{"type":"string","maxLength":1024,"description":"Description of the line item.","descriptionNode":"$L13ea"},"url":{"type":"string","format":"uri","pattern":"^https?:\\/{2}.+/gi","maxLength":2000,"description":"An HTTP/HTTPS URL that links to more information about the line item, such as a product page or details.\n\n:::warning\nRestrictions:\n- Must be a valid URI as defined by [RFC 3986](https://datatracker.ietf.org/doc/html/rfc3986)\n- URI scheme is required and must be either `http` or `https`\n- URI host is required and cannot be `localhost` or an IP address\n- Max length: `2000`\n- Reserved or invalid characters must be percent-encoded (for example, use `%20` instead of a space)\n:::","descriptionNode":"$L13eb"}},"required":"$19:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:orders:items:properties:line_items:items:required"},"descriptionNode":"$L13ec"},"reason":{"type":"string","description":"Reason why increment was declined or failed.\n\n:::note\nOnly present when `state` is `declined` or `failed`.\n:::","examples":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:incremental_authorisations:items:properties:reason:examples","descriptionNode":"$L13ed"}},"descriptionNode":"$L13ee"},"descriptionNode":"$L13ef"},"location_id":{"type":"string","format":"uuid","description":"Unique ID representing the location where merchants sells products.\n\n:::info\nFor more information, see: [Locations](https://developer.revolut.com/docs/api/merchant#tag-locations).\n::: ","descriptionNode":"$L13f0"},"metadata":{"type":"object","description":"Additional information to track your orders in your system, by providing custom metadata using `\"\" : \"\"` pairs.\n\n:::warning\n**Restrictions:**\n\n- Both keys and values must be `string`s\n- Values cannot be `null`.\n- Max number of key-value pairs: `50`\n- Max length of values: `500` characters\n- Format of keys: Must start with a letter and contain only letters, digits, and underscores. Max 40 characters. Pattern: `^[a-zA-Z][a-zA-Z\\\\d_]{0,39}$`\n:::","maxProperties":50,"additionalProperties":{"type":"string","maxLength":500,"description":"Additional metadata value provided with the corresponding metadata key.","descriptionNode":"$L13f1"},"examples":"$19:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:orders:items:properties:metadata:examples","descriptionNode":"$L13f2"},"industry_data":{"type":"object","description":"Object containing industry-specific information associated with the order.\n\n:::info\nIn the following cases, industry-specific info is required. Omitting this information may trigger additional scrutiny and risk mitigation actions by the Revolut risk team.\n\n | Transaction type | Required for |\n | ---------------- | ----------- |\n | `airline` | Airlines and Online Travel Agencies (OTAs). |\n | `car_rental` | Car Rental Merchants and Online Travel Agencies (OTAs). |\n | `crypto` | Crypto merchants. |\n | `marketplace` | Marketplace merchants. |\n | `event` | Event ticket sellers. |\n | `lodging` | Lodging providers. |\n:::","discriminator":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:discriminator","oneOf":[{"type":"object","description":"$13f3","properties":{"type":{"type":"string","enum":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:0:properties:type:enum","description":"Type of the industry-specific data object, determining what additional data is expected.\n\nAvailable types:\n\n | Object type | Description |\n | ------------- | ----------- |\n | `airline` | Object containing information about a specific airline ticket purchase. |\n | `car_rental` | Object containing information about a car rental booking associated with the order. |\n | `crypto` | Object containing information about crypto transactions associated with the order. |\n | `marketplace` | This object is required by Mastercard and Visa for merchants operating as marketplaces under the **Merchant Category Code (MCC):** `5262`. The marketplace object ensures compliance with the card schemes' regulations by providing detailed information about the subseller involved in the transaction. |\n | `event` | Object containing information about event ticket bookings associated with the order. |\n | `lodging` | Object containing information about lodging bookings associated with the order. |","descriptionNode":"$L13f4"},"booking_id":{"type":"string","description":"A unique identifier provided by the merchant associated with the order. \n\nThis `booking_id` is used to reference and correlate booking information with the Merchant API and the merchant's internal system.","descriptionNode":"$L13f5"},"fulfillment_date":{"type":"string","format":"date-time","description":"The UTC date and time of the final journey leg.\n\n:::warning\nThe following limitations apply:\n - When creating or updating an order, `fulfillment_date` cannot be set to a date in the past.\n - When updating an order, if the current `fulfillment_date` value is already in the past, it cannot be modified. The date must remain as is to maintain data integrity for completed transactions.\n:::","descriptionNode":"$L13f6"},"tickets_purchase":{"type":"boolean","description":"Flag indicating whether the order includes actual ticket purchases. Set to `true` if the order contains ticket purchases, and `false` if it does not (e.g., it **only** contains seat reservations, or baggage upgrades). \n\n:::info\nThis field is required for activating **Revolut Flight Alerts** functionalities within the Revolut app.\n\nProvide the info on order creation or update, before capturing the order.\n:::","descriptionNode":"$L13f7"},"ticket_type":{"type":"string","enum":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:0:properties:ticket_type:enum","description":"The type of the ticket.\n\n| Parameter value | Description |\n| --------------- | ----------- |\n| `fixed` | Non-modifiable once confirmed. |\n| `flexible` | Allows modifications or cancellations under specified conditions. |","descriptionNode":"$L13f8"},"crs_code":{"type":"string","maxLength":4,"description":"The code of the Computer Reservation System (CRS) used to make the booking and purchase the ticket.","descriptionNode":"$L13f9"},"ticket_change_indicator":{"type":"string","enum":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:0:properties:ticket_change_indicator:enum","description":"Parameter indicating whether this order is related to a new ticket reservation or a modification of an existing one.","descriptionNode":"$L13fa"},"refundability":{"type":"string","enum":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:0:properties:refundability:enum","description":"Parameter indicating whether the booking is refundable, partially refundable, or not refundable.","descriptionNode":"$L13fb"},"passengers":{"type":"array","description":"Array containing information of passengers associated with the booking.","items":{"type":"object","properties":{"first_name":{"type":"string","description":"Passenger's first name.","descriptionNode":"$L13fc"},"last_name":{"type":"string","description":"Passenger's last name.","descriptionNode":"$L13fd"}},"required":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:0:properties:passengers:items:required"},"descriptionNode":"$L13fe"},"journey_legs":{"type":"array","description":"Array containing information of journey legs associated with the booking.\n\n:::info\nThis field is required for activating **Revolut Flight Alerts** functionalities within the Revolut app. \n\nThis information is used to compile a tracking widget that provides real-time updates on flight status and sends notifications, such as a check-in reminders, boarding alerts, and notifications for cancellations or delays. \n\nTo enable the widget the following fields are required on order creation or update, before capturing the order:\n\n ```\n sequence,\n departure_airport_code,\n arrival_airport_code,\n flight_number,\n travel_date,\n airline_name,\n airline_code,\n ```\n:::","items":{"type":"object","properties":{"sequence":{"type":"integer","description":"Sequence of the journey legs. Increment by 1 for each flight included in the ticket.\n\nFor example: For a `FRA > LHR > DUB > LHR > FRA` journey the sequence will be assigned as:\n - `FRA > LHR`: 1\n - `LHR > DUB`: 2\n - `DUB > LHR`: 3\n - `LHR > FRA`: 4","descriptionNode":"$L13ff"},"departure_airport_code":{"type":"string","description":"The [IATA](https://www.iata.org/en/services/codes) 3-letter airport code for the departure airport.","descriptionNode":"$L1400"},"arrival_airport_code":{"type":"string","description":"The [IATA](https://www.iata.org/en/services/codes) 3-letter airport code for the arrival airport.","descriptionNode":"$L1401"},"flight_number":{"type":"string","description":"The flight identifier, without airline code.","descriptionNode":"$L1402"},"fare_base_code":{"type":"string","description":"The fare base code for the given journey leg.","descriptionNode":"$L1403"},"travel_date":{"type":"string","format":"date-time","description":"The UTC date and time of the flight departure for the given journey leg.","descriptionNode":"$L1404"},"airline_name":{"type":"string","description":"The name of the airline associated with the journey leg.","descriptionNode":"$L1405"},"airline_code":{"type":"string","description":"The IATA 2-letter accounting code identifying the airline associated with the journey leg.","descriptionNode":"$L1406"},"pnr":{"type":"string","format":"alphanumeric","pattern":"^[a-zA-Z0-9]*$","maxLength":20,"description":"The Passenger Name Record (PNR) for the journey leg issued by the airline. \n\nPNR is a unique identifier for the booking, acting as a digital certificate allowing passengers to retrieve or manage their booking details.\n\n:::warning\nThis is a required field for OTAs.\n:::","descriptionNode":"$L1407"}},"required":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:0:properties:journey_legs:items:required"},"descriptionNode":"$L1408"},"booking_url":{"type":"string","format":"uri","pattern":"^https?:\\/{2}.+/gi","maxLength":2000,"description":"URL to the online portal for managing the airline booking, which includes check-in functionality. This URL may be a personalised, pre-populated check-in link specific to the user or a generic link, and it is essential for enabling direct access to booking details within the Revolut app.\n\n:::info\nThis field is required for activating **Revolut Flight Alerts** functionalities within the Revolut app. \n\nProvide the info on order creation or update, before capturing the order.\n:::\n\n:::warning\nRestrictions:\n- Must be a valid URI as defined by [RFC 3986](https://datatracker.ietf.org/doc/html/rfc3986)\n- URI scheme is required and must be either `http` or `https`\n- URI host is required and cannot be `localhost` or an IP address\n- Max length: `2000`\n- Reserved or invalid characters must be percent-encoded (for example, use `%20` instead of a space)\n:::","descriptionNode":"$L1409"}},"required":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:0:required","descriptionNode":"$L140a"},{"type":"object","description":"Object containing additional information about a car rental booking associated with the order.\n\n:::info\nThese are the specific data field requirements for merchants offering car rental. Note that these requirements can be extended on a case by case basis as decided by Revolut.\n\n```\nbooking_id\ndrop_off_date\nrefundability\n```\n:::","properties":{"type":{"type":"string","enum":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:0:properties:type:enum","description":"Type of the industry-specific data object, determining what additional data is expected.\n\nAvailable types:\n\n | Object type | Description |\n | ------------- | ----------- |\n | `airline` | Object containing information about a specific airline ticket purchase. |\n | `car_rental` | Object containing information about a car rental booking associated with the order. |\n | `crypto` | Object containing information about crypto transactions associated with the order. |\n | `marketplace` | This object is required by Mastercard and Visa for merchants operating as marketplaces under the **Merchant Category Code (MCC):** `5262`. The marketplace object ensures compliance with the card schemes' regulations by providing detailed information about the subseller involved in the transaction. |\n | `event` | Object containing information about event ticket bookings associated with the order. |\n | `lodging` | Object containing information about lodging bookings associated with the order. |","descriptionNode":"$L140b"},"booking_id":{"type":"string","description":"A unique identifier provided by the merchant associated with the order. \n\nThis `booking_id` is used to reference and correlate booking information with the Merchant API and the merchant's internal system.","descriptionNode":"$L140c"},"pick_up_date":{"type":"string","format":"date-time","description":"The UTC date and time of the pick-up.","descriptionNode":"$L140d"},"pick_up_location":{"type":"object","description":"Object containing address details.","properties":{"street_line_1":"$1e:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payments:items:properties:billing_address:properties:street_line_1","street_line_2":"$1e:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payments:items:properties:billing_address:properties:street_line_2","region":"$1e:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payments:items:properties:billing_address:properties:region","city":"$1e:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payments:items:properties:billing_address:properties:city","country_code":"$1e:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payments:items:properties:billing_address:properties:country_code","postcode":"$1e:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payments:items:properties:billing_address:properties:postcode"},"required":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:billing_address:required","descriptionNode":"$L140e"},"drop_off_date":{"type":"string","format":"date-time","description":"The UTC date and time of the drop-off.","descriptionNode":"$L140f"},"drop_off_location":{"type":"object","description":"Object containing address details.","properties":{"street_line_1":"$1e:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payments:items:properties:billing_address:properties:street_line_1","street_line_2":"$1e:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payments:items:properties:billing_address:properties:street_line_2","region":"$1e:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payments:items:properties:billing_address:properties:region","city":"$1e:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payments:items:properties:billing_address:properties:city","country_code":"$1e:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payments:items:properties:billing_address:properties:country_code","postcode":"$1e:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payments:items:properties:billing_address:properties:postcode"},"required":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:billing_address:required","descriptionNode":"$L1410"},"refundability":{"type":"string","enum":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:0:properties:refundability:enum","description":"Parameter indicating whether the booking is refundable, partially refundable, or not refundable.","descriptionNode":"$L1411"},"distance_limit":{"type":"object","description":"Object containing distance limit information.","properties":{"limit":{"type":"integer","description":"The maximum distance allowed.","descriptionNode":"$L1412"},"unit":{"type":"string","description":"The unit of distance.","enum":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:1:properties:distance_limit:properties:unit:enum","descriptionNode":"$L1413"},"additional_distance_cost":{"type":"object","description":"Cost for exceeding the distance limit.","properties":{"amount":{"type":"integer","description":"The amount of the cost in minor currency units. For example, enter `7034` for €70.34.","descriptionNode":"$L1414"},"currency":{"type":"string","format":"ISO 4217","minLength":3,"maxLength":3,"description":"[ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) currency code in upper case.\n\n:::info\nFor more information about the supported currencies, see: [Help Center](https://help.revolut.com/business/help/merchant-accounts/payments/in-which-currencies-can-i-accept-payments/).\n:::","descriptionNode":"$L1415"}},"descriptionNode":"$L1416"}},"descriptionNode":"$L1417"}},"required":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:1:required","descriptionNode":"$L1418"},{"type":"object","description":"Object containing information about crypto transactions associated with the order.\n\n:::info\nProcessing crypto on-ramp transactions with Revolut has additional compliance requirements. Please reach out to your account executive for additional details.\n\n**Required data fields for crypto services:**\n\n```\ntransactions[].id\ntransactions[].status\ntransactions[].recipient_wallet_id\nseller.id\nseller.name\nseller.website\nseller.phone\nseller.address\nseller.mcc\ncustomer.full_name\ncustomer.date_of_birth\n```\n\nNote that these requirements can be extended on a case by case basis as decided by Revolut.\n:::","properties":{"type":{"type":"string","enum":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:0:properties:type:enum","description":"Type of the industry-specific data object, determining what additional data is expected.\n\nAvailable types:\n\n | Object type | Description |\n | ------------- | ----------- |\n | `airline` | Object containing information about a specific airline ticket purchase. |\n | `car_rental` | Object containing information about a car rental booking associated with the order. |\n | `crypto` | Object containing information about crypto transactions associated with the order. |\n | `marketplace` | This object is required by Mastercard and Visa for merchants operating as marketplaces under the **Merchant Category Code (MCC):** `5262`. The marketplace object ensures compliance with the card schemes' regulations by providing detailed information about the subseller involved in the transaction. |\n | `event` | Object containing information about event ticket bookings associated with the order. |\n | `lodging` | Object containing information about lodging bookings associated with the order. |","descriptionNode":"$L1419"},"transactions":{"type":"array","description":"Array of crypto transaction data associated with the order.","items":{"type":"object","properties":{"id":{"type":"string","maxLength":255,"description":"The public transaction hash of the crypto transaction.","descriptionNode":"$L141a"},"status":{"type":"string","enum":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:2:properties:transactions:items:properties:status:enum","description":"The status of the crypto transaction.","descriptionNode":"$L141b"},"recipient_wallet_id":{"type":"string","maxLength":255,"description":"The wallet ID of the recipient.\n\n:::note\nAt least one of the parameters: `recipient_user_id` or `recipient_wallet_id` is required.\n::: ","descriptionNode":"$L141c"},"recipient_user_id":{"type":"string","maxLength":255,"description":"The user ID of the recipient.\n\n:::note\nAt least one of the parameters: `recipient_user_id` or `recipient_wallet_id` is required.\n::: ","descriptionNode":"$L141d"}},"required":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:2:properties:transactions:items:required"},"minItems":1,"descriptionNode":"$L141e"},"seller":{"type":"object","description":"Information about the crypto conversion affiliate.\n\nThis should be provided when a customer completes a payment on a subseller's website rather than directly on the merchant's website, providing insight into the type of business conducted by the subseller.\n\n:::note\nThis needs to be provided only by crypto on-ramp providers for payments they are processing for conversion affiliates.\n\nFor their own payments, `seller` can be omitted.\n:::","properties":{"mcc":{"type":"string","description":"A string representing the four-digit [Merchant Category Code (MCC)](https://en.wikipedia.org/wiki/Merchant_category_code) of the conversion affiliate.","maxLength":4,"minLength":4,"pattern":"^\\d{4}$","descriptionNode":"$L141f"},"id":{"type":"string","description":"The ID of the seller in the merchant's internal system.","minLength":1,"maxLength":15,"descriptionNode":"$L1420"},"name":{"type":"string","description":"The business or legal name of the seller.","minLength":1,"maxLength":50,"descriptionNode":"$L1421"},"website":{"type":"string","format":"uri","pattern":"^https?:\\/{2}.+/gi","maxLength":255,"description":"The URL of the website of the seller.\n\n:::warning\nRestrictions:\n- Must be a valid URI as defined by [RFC 3986](https://datatracker.ietf.org/doc/html/rfc3986)\n- URI scheme is required and must be either `http` or `https`\n- URI host is required and cannot be `localhost` or an IP address\n- Max length: `255`\n- Reserved or invalid characters must be percent-encoded (for example, use `%20` instead of a space)\n:::","descriptionNode":"$L1422"},"phone":{"type":"string","description":"The phone number of the seller.","descriptionNode":"$L1423"},"address":{"type":"object","description":"Details of a physical address.","properties":{"street_line_1":{"type":"string","description":"Primary address line.","maxLength":100,"descriptionNode":"$L1424"},"street_line_2":{"type":"string","description":"Secondary address line, such as floor and apartment number.","maxLength":100,"descriptionNode":"$L1425"},"region":{"type":"string","description":"State or province of the address.","maxLength":100,"descriptionNode":"$L1426"},"city":{"type":"string","description":"City of the address.","maxLength":100,"descriptionNode":"$L1427"},"country_code":{"type":"string","pattern":"^[A-Z]{2}$","description":"ISO 2-letter country code.","minLength":2,"maxLength":2,"descriptionNode":"$L1428"},"country_subdivision_code":{"type":"string","pattern":"^[A-Z]{2}-[A-Z0-9]{1,3}$","description":"The subdivision code represents the state, province, or region within the country, following the [ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2) standard. This code uniquely identifies subdivisions within a country. \n\nFor example, for London in the United Kingdom, use `GB-LND`.\n\n:::warning\nThe parameter is required for countries listed on the [ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2) page.\n:::","minLength":5,"maxLength":6,"descriptionNode":"$L1429"},"postcode":{"type":"string","description":"Postal code of the address.","maxLength":100,"descriptionNode":"$L142a"}},"required":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:2:properties:seller:properties:address:required","descriptionNode":"$L142b"}},"required":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:2:properties:seller:required","descriptionNode":"$L142c"}},"required":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:2:required","descriptionNode":"$L142d"},{"type":"object","description":"This object is required by Mastercard and Visa for merchants operating as marketplaces under the Merchant Category Code (MCC) `5262`. The marketplace object ensures compliance with the card schemes' regulations by providing detailed information about the seller involved in the transaction.\n\n:::info\nThese are the specific data field requirements for merchants who must provide marketplace data.\n\n```\nseller.id\nseller.name\nseller.website\nseller.phone\nseller.address\n```\n:::","properties":{"type":{"type":"string","enum":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:0:properties:type:enum","description":"Type of the industry-specific data object, determining what additional data is expected.\n\nAvailable types:\n\n | Object type | Description |\n | ------------- | ----------- |\n | `airline` | Object containing information about a specific airline ticket purchase. |\n | `car_rental` | Object containing information about a car rental booking associated with the order. |\n | `crypto` | Object containing information about crypto transactions associated with the order. |\n | `marketplace` | This object is required by Mastercard and Visa for merchants operating as marketplaces under the **Merchant Category Code (MCC):** `5262`. The marketplace object ensures compliance with the card schemes' regulations by providing detailed information about the subseller involved in the transaction. |\n | `event` | Object containing information about event ticket bookings associated with the order. |\n | `lodging` | Object containing information about lodging bookings associated with the order. |","descriptionNode":"$L142e"},"seller":{"type":"object","description":"Information about the subseller on the marketplace platform.","properties":{"id":{"type":"string","description":"The ID of the seller in the merchant's internal system.","minLength":1,"maxLength":15,"descriptionNode":"$L142f"},"name":{"type":"string","description":"The business or legal name of the seller.","minLength":1,"maxLength":50,"descriptionNode":"$L1430"},"website":{"type":"string","format":"uri","pattern":"^https?:\\/{2}.+/gi","maxLength":255,"description":"The URL of the website of the seller.\n\n:::warning\nRestrictions:\n- Must be a valid URI as defined by [RFC 3986](https://datatracker.ietf.org/doc/html/rfc3986)\n- URI scheme is required and must be either `http` or `https`\n- URI host is required and cannot be `localhost` or an IP address\n- Max length: `255`\n- Reserved or invalid characters must be percent-encoded (for example, use `%20` instead of a space)\n:::","descriptionNode":"$L1431"},"phone":{"type":"string","description":"The phone number of the seller.","descriptionNode":"$L1432"},"address":{"type":"object","description":"Details of a physical address.","properties":{"street_line_1":"$1e:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:2:properties:seller:properties:address:properties:street_line_1","street_line_2":"$1e:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:2:properties:seller:properties:address:properties:street_line_2","region":"$1e:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:2:properties:seller:properties:address:properties:region","city":"$1e:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:2:properties:seller:properties:address:properties:city","country_code":"$1e:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:2:properties:seller:properties:address:properties:country_code","country_subdivision_code":"$1e:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:2:properties:seller:properties:address:properties:country_subdivision_code","postcode":"$1e:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:2:properties:seller:properties:address:properties:postcode"},"required":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:2:properties:seller:properties:address:required","descriptionNode":"$L1433"}},"required":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:3:properties:seller:required","descriptionNode":"$L1434"}},"required":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:3:required","descriptionNode":"$L1435"},{"type":"object","description":"Object containing booking information for a list of event tickets associated with the order.\n\n:::info\nThese are the specific data field requirements for merchants who must provide event data. Note that these requirements can be extended on a case by case basis as decided by Revolut.\n\n```\nbooking_id\nevents[].start_date\nevents[].end_date\nevents[].supplier\nevents[].tickets[].id\n```\n:::","properties":{"type":{"type":"string","enum":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:0:properties:type:enum","description":"Type of the industry-specific data object, determining what additional data is expected.\n\nAvailable types:\n\n | Object type | Description |\n | ------------- | ----------- |\n | `airline` | Object containing information about a specific airline ticket purchase. |\n | `car_rental` | Object containing information about a car rental booking associated with the order. |\n | `crypto` | Object containing information about crypto transactions associated with the order. |\n | `marketplace` | This object is required by Mastercard and Visa for merchants operating as marketplaces under the **Merchant Category Code (MCC):** `5262`. The marketplace object ensures compliance with the card schemes' regulations by providing detailed information about the subseller involved in the transaction. |\n | `event` | Object containing information about event ticket bookings associated with the order. |\n | `lodging` | Object containing information about lodging bookings associated with the order. |","descriptionNode":"$L1436"},"booking_id":{"type":"string","description":"A unique identifier provided by the merchant associated with the order. \n\nThis `booking_id` is used to reference and correlate booking information with the Merchant API and the merchant's internal system.","descriptionNode":"$L1437"},"events":{"type":"array","description":"A list of events associated with the booking.","items":{"type":"object","description":"Object containing booking information about a specific event. ","properties":{"start_date":{"type":"string","format":"date-time","description":"[ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time when the event starts.","descriptionNode":"$L1438"},"end_date":{"type":"string","format":"date-time","description":"[ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time when the event ends.","descriptionNode":"$L1439"},"supplier":{"type":"string","description":"Legal name of the ticket vendor/event organiser.","descriptionNode":"$L143a"},"supplier_payment_date":{"type":"string","format":"date-time","description":"[ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time when the funds are released to merchants.","descriptionNode":"$L143b"},"name":{"type":"string","description":"The name of the event.","descriptionNode":"$L143c"},"location":{"type":"object","description":"The address of the event location.","properties":{"street_line_1":{"type":"string","description":"Primary address line.","maxLength":100,"descriptionNode":"$L143d"},"street_line_2":{"type":"string","description":"Secondary address line, such as floor and apartment number.","maxLength":100,"descriptionNode":"$L143e"},"region":{"type":"string","description":"State or province of the address.","maxLength":100,"descriptionNode":"$L143f"},"city":{"type":"string","description":"City of the address.","maxLength":100,"descriptionNode":"$L1440"},"country_code":{"type":"string","pattern":"^[A-Z]{2}$","description":"ISO 2-letter country code.","minLength":2,"maxLength":2,"descriptionNode":"$L1441"},"postcode":{"type":"string","description":"Postal code of the address.","maxLength":100,"descriptionNode":"$L1442"}},"required":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:4:properties:events:items:properties:location:required","descriptionNode":"$L1443"},"category":{"type":"string","enum":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:4:properties:events:items:properties:category:enum","description":"The type of the event.","descriptionNode":"$L1444"},"market":{"type":"string","enum":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:4:properties:events:items:properties:market:enum","description":"Indicates the relationship between the ticket vendor and the event organiser. \n\n| Parameter value | Description |\n| --------------- | ----------- |\n| `primary` | The merchant is the organiser and primary distributor of the tickets. |\n| `secondary` | The merchant is a reseller, only distributing the tickets. |","descriptionNode":"$L1445"},"tickets":{"type":"array","items":{"type":"object","description":"Object containing information about a ticket associated with the booking.","properties":{"id":{"type":"string","description":"A unique identifier provided by the merchant associated with the ticket.","descriptionNode":"$L1446"},"transferable":{"type":"boolean","description":"Indicates whether the ticket is transferable to another buyer.","descriptionNode":"$L1447"},"refundability":{"type":"string","enum":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:0:properties:refundability:enum","description":"Parameter indicating whether the booking is refundable, partially refundable, or not refundable.","descriptionNode":"$L1448"}},"required":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:4:properties:events:items:properties:tickets:items:required","descriptionNode":"$L1449"},"description":"A list of tickets associated with the booking.","descriptionNode":"$L144a"}},"descriptionNode":"$L144b"},"descriptionNode":"$L144c"}},"required":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:4:required","descriptionNode":"$L144d"},{"type":"object","description":"Object containing details of a lodging booking.\n\n:::info\nThese are the specific data field requirements for merchants who must provide lodging data. Note that these requirements can be extended on a case by case basis as decided by Revolut.\n\n```\nbooking_id\ncheck_in_date\ncheck_out_date\nsupplier_payment_date\n```\n:::","properties":{"type":{"type":"string","enum":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:0:properties:type:enum","description":"Type of the industry-specific data object, determining what additional data is expected.\n\nAvailable types:\n\n | Object type | Description |\n | ------------- | ----------- |\n | `airline` | Object containing information about a specific airline ticket purchase. |\n | `car_rental` | Object containing information about a car rental booking associated with the order. |\n | `crypto` | Object containing information about crypto transactions associated with the order. |\n | `marketplace` | This object is required by Mastercard and Visa for merchants operating as marketplaces under the **Merchant Category Code (MCC):** `5262`. The marketplace object ensures compliance with the card schemes' regulations by providing detailed information about the subseller involved in the transaction. |\n | `event` | Object containing information about event ticket bookings associated with the order. |\n | `lodging` | Object containing information about lodging bookings associated with the order. |","descriptionNode":"$L144e"},"booking_id":{"type":"string","description":"A unique identifier provided by the merchant associated with the order. \n\nThis `booking_id` is used to reference and correlate booking information with the Merchant API and the merchant's internal system.","descriptionNode":"$L144f"},"check_in_date":{"type":"string","format":"date-time","description":"[ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time of the check-in.","descriptionNode":"$L1450"},"check_out_date":{"type":"string","format":"date-time","description":"[ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time of the check-out.","descriptionNode":"$L1451"},"supplier_payment_date":{"type":"string","format":"date-time","description":"[ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time when the funds are released to merchants.","descriptionNode":"$L1452"},"category":{"type":"string","enum":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:5:properties:category:enum","description":"The type of the accommodation associated with the booking.","descriptionNode":"$L1453"},"booking_type":{"type":"string","enum":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:5:properties:booking_type:enum","description":"Indicates whether the booking terms are fixed or flexible.\n\n| Parameter value | Description |\n| --------------- | ----------- |\n| `fixed` | Non-modifiable once confirmed. |\n| `flexible` | Allows modifications or cancellations under specified conditions. |","descriptionNode":"$L1454"},"refundability":{"type":"string","enum":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:0:properties:refundability:enum","description":"Parameter indicating whether the booking is refundable, partially refundable, or not refundable.","descriptionNode":"$L1455"},"location":{"type":"object","description":"Address of the accommodation.","properties":{"street_line_1":{"type":"string","description":"Primary address line.","maxLength":100,"descriptionNode":"$L1456"},"street_line_2":{"type":"string","description":"Secondary address line, such as floor and apartment number.","maxLength":100,"descriptionNode":"$L1457"},"region":{"type":"string","description":"State or province of the address.","maxLength":100,"descriptionNode":"$L1458"},"city":{"type":"string","description":"City of the address.","maxLength":100,"descriptionNode":"$L1459"},"country_code":{"type":"string","pattern":"^[A-Z]{2}$","description":"ISO 2-letter country code.","minLength":2,"maxLength":2,"descriptionNode":"$L145a"},"postcode":{"type":"string","description":"Postal code of the address.","maxLength":100,"descriptionNode":"$L145b"}},"required":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:5:properties:location:required","descriptionNode":"$L145c"},"guests":{"type":"array","items":{"type":"object","properties":{"first_name":{"type":"string","description":"Guest's first name.","descriptionNode":"$L145d"},"last_name":{"type":"string","description":"Guest's last name.","descriptionNode":"$L145e"}},"required":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:5:properties:guests:items:required"},"description":"List of guests associated with the booking.","descriptionNode":"$L145f"}},"required":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:5:required","descriptionNode":"$L1460"}],"descriptionNode":"$L1461"},"merchant_order_data":{"type":"object","description":"Object for providing additional information stored in the merchant's order management system. ","properties":{"url":{"type":"string","format":"uri","pattern":"^https?:\\/{2}.+/gi","maxLength":2000,"description":"The URL of the order stored in the merchant's order management system.\n\nThis URL will be included in the order confirmation email for payments made via Revolut Pay. If specified, this URL will override the default link to the merchant's **Business website** configured in the Revolut Business account.\n\n:::warning\nRestrictions:\n- Must be a valid URI as defined by [RFC 3986](https://datatracker.ietf.org/doc/html/rfc3986)\n- URI scheme is required and must be either `http` or `https`\n- URI host is required and cannot be `localhost` or an IP address\n- Max length: `2000`\n- Reserved or invalid characters must be percent-encoded (for example, use `%20` instead of a space)\n:::","descriptionNode":"$L1462"},"reference":{"type":"string","description":"Merchant order ID for external reference.\n\nUse this field to set the ID that your own system can use to easily track orders.","descriptionNode":"$L1463"}},"descriptionNode":"$L1464"},"upcoming_payment_data":{"type":"object","description":"Object containing information about upcoming payments associated with the order.","properties":{"date":{"type":"string","format":"date-time","description":"The date and time in [ISO 8601 format](https://en.wikipedia.org/wiki/ISO_8601) when the upcoming payment is scheduled to be executed.","descriptionNode":"$L1465"},"payment_method_id":{"type":"string","description":"The unique ID of the customer's payment method used to complete the scheduled payment.\n\n:::info\nFor more information about operations related to customer's payment methods, see:\n - [Retrieve payment method list of a customer](https://developer.revolut.com/docs/api/merchant#retrieve-payment-method-list)\n - [Retrieve a customer's payment method](https://developer.revolut.com/docs/api/merchant#retrieve-payment-method)\n - [Update a customer's payment method](https://developer.revolut.com/docs/api/merchant#update-payment-method)\n - [Delete a customer's payment method](https://developer.revolut.com/docs/api/merchant#delete-payment-method)\n:::","descriptionNode":"$L1466"}},"required":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:upcoming_payment_data:required","descriptionNode":"$L1467"},"checkout_url":{"type":"string","description":"Link to a checkout page hosted by Revolut.","format":"uri","descriptionNode":"$L1468"},"redirect_url":{"type":"string","format":"uri","pattern":"^https?:\\/{2}.+/gi","maxLength":2000,"description":"The URL your customer will be redirected to after a successful payment on the hosted checkout page (`checkout_url` parameter's value of the order).\n\n:::warning\nRestrictions:\n- Must be a valid URI as defined by [RFC 3986](https://datatracker.ietf.org/doc/html/rfc3986)\n- URI scheme is required and must be either `http` or `https`\n- URI host is required and cannot be `localhost` or an IP address\n- Max length: `2000`\n- Reserved or invalid characters must be percent-encoded (for example, use `%20` instead of a space)\n:::\n\n:::info\nFor more information on how to use the `redirect_url`, see: [Custom redirection via the API](https://developer.revolut.com/docs/guides/merchant/accept-payments/online-payments/hosted-checkout-page/api#custom-post-payment-redirection-optional)\n:::","descriptionNode":"$L1469"},"shipping":{"type":"object","description":"Details about the shipping related to the order, including address, contact information, and individual shipments.\n\n:::info\nRequired for merchants shipping physical goods. Omitting this information may trigger additional scrutiny and risk mitigation actions by Revolut.\n:::","properties":{"address":{"type":"object","description":"Details of a physical address.","properties":{"street_line_1":{"type":"string","description":"Primary address line.","maxLength":100,"descriptionNode":"$L146a"},"street_line_2":{"type":"string","description":"Secondary address line, such as floor and apartment number.","maxLength":100,"descriptionNode":"$L146b"},"region":{"type":"string","description":"State or province of the address.","maxLength":100,"descriptionNode":"$L146c"},"city":{"type":"string","description":"City of the address.","maxLength":100,"descriptionNode":"$L146d"},"country_code":{"type":"string","pattern":"^[A-Z]{2}$","description":"ISO 2-letter country code.","minLength":2,"maxLength":2,"descriptionNode":"$L146e"},"postcode":{"type":"string","description":"Postal code of the address.","maxLength":100,"descriptionNode":"$L146f"}},"required":"$60:props:children:0:props:children:props:responses:200:content:application/json:schema:oneOf:1:properties:details:properties:address:required","descriptionNode":"$L1470"},"contact":{"type":"object","description":"Contact details for someone responsible for the shipment.\n\n:::warning\nAt least `email` or `phone` is required.\n:::","properties":{"name":{"type":"string","description":"Full name of the contact person.","maxLength":250,"descriptionNode":"$L1471"},"email":{"type":"string","format":"email","description":"Email address of the contact person.","descriptionNode":"$L1472"},"phone":{"type":"string","description":"Phone number of the contact person.","descriptionNode":"$L1473"}},"descriptionNode":"$L1474"},"shipments":{"type":"array","description":"List of individual shipment details.","maxItems":50,"items":{"type":"object","description":"Details of an individual shipment.","properties":{"shipping_company_name":{"type":"string","maxLength":250,"description":"Name of the company handling the shipment.","descriptionNode":"$L1475"},"tracking_number":{"type":"string","maxLength":500,"description":"Unique tracking number for the shipment.","descriptionNode":"$L1476"},"estimated_delivery_date":{"type":"string","format":"date-time","description":"Estimated delivery date and time for the shipment. \nThe time should also include the customer's timezone.","descriptionNode":"$L1477"},"tracking_url":{"type":"string","format":"uri","pattern":"^https?:\\/{2}.+/gi","maxLength":2000,"description":"An HTTP/HTTPS URL where the shipment can be tracked.\n\n:::warning\nRestrictions:\n- Must be a valid URI as defined by [RFC 3986](https://datatracker.ietf.org/doc/html/rfc3986)\n- URI scheme is required and must be either `http` or `https`\n- URI host is required and cannot be `localhost` or an IP address\n- Max length: `2000`\n- Reserved or invalid characters must be percent-encoded (for example, use `%20` instead of a space)\n:::","descriptionNode":"$L1478"}},"required":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:shipping:properties:shipments:items:required","descriptionNode":"$L1479"},"descriptionNode":"$L147a"}},"descriptionNode":"$L147b"},"enforce_challenge":{"type":"string","description":"The enforce challenge mode. `automatic` is used by default.\n\n| Parameter value | Description |\n| --------------- | ----------- |\n| `automatic` | The payments created for an order will have challenge requirement calculated by our fraud mechanisms. Not all payments will trigger a 3DS challenge. |\n| `forced` | The payments created for an order will always require a 3DS challenge. Currently only supported for card payments. |","default":"automatic","enum":"$19:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:orders:items:properties:enforce_challenge:enum","descriptionNode":"$L147c"},"line_items":{"type":"array","maxItems":250,"description":"An array of line items included in the order. Each line item represents an individual product or service, along with its quantity, price, taxes, and discounts.\n\n:::info\nRequired for merchants collecting payment for one or multiple products/services in one transaction. Omitting this information may trigger additional scrutiny and risk mitigation actions by Revolut.\n:::","items":{"type":"object","properties":{"name":"$1e:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:incremental_authorisations:items:properties:line_items:items:properties:name","type":"$1e:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:incremental_authorisations:items:properties:line_items:items:properties:type","quantity":"$1e:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:incremental_authorisations:items:properties:line_items:items:properties:quantity","unit_price_amount":"$1e:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:incremental_authorisations:items:properties:line_items:items:properties:unit_price_amount","total_amount":"$1e:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:incremental_authorisations:items:properties:line_items:items:properties:total_amount","external_id":"$1e:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:incremental_authorisations:items:properties:line_items:items:properties:external_id","discounts":"$1e:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:incremental_authorisations:items:properties:line_items:items:properties:discounts","taxes":"$1e:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:incremental_authorisations:items:properties:line_items:items:properties:taxes","image_urls":"$1e:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:incremental_authorisations:items:properties:line_items:items:properties:image_urls","description":"$1e:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:incremental_authorisations:items:properties:line_items:items:properties:description","url":"$1e:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:incremental_authorisations:items:properties:line_items:items:properties:url"},"required":"$19:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:orders:items:properties:line_items:items:required"},"descriptionNode":"$L147d"},"statement_descriptor_suffix":{"type":"string","description":"$147e","minLength":1,"maxLength":19,"pattern":"^[^*\\n\\r\\\\]+$","descriptionNode":"$L147f"},"related_order_id":{"type":"string","format":"uuid","description":"The unique ID of the original order that was refunded and this refund is associated with. You can use this ID to get more information about the related order using the [Retrieve an order](https://developer.revolut.com/docs/api/merchant#retrieve-order) operation.\n\n:::note\nThis field is only returned for orders with `type: refund`.\n:::","descriptionNode":"$L1480"},"subscription_data":{"title":"Subscription data","type":"object","required":"$19:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:orders:items:properties:subscription_data:required","description":"Subscription details linked to the order. Use this object to match an order with its underlying subscription and understand the billing context in which the order was created.\n\nOnly present on orders created by a subscription.","properties":{"subscription_id":{"type":"string","format":"uuid","description":"Unique identifier for the subscription.","descriptionNode":"$L1481"},"active_cycle_id":{"type":"string","format":"uuid","description":"The unique identifier of the active (pre-paid) subscription cycle that this order collects payment for.\n\nThis is the current billing cycle whose recurring charges are being collected in advance by this order. For example, if a subscription cycle covers 1-31 July and the order is generated on 1 July, this field identifies that July cycle.","descriptionNode":"$L1482"},"settled_cycle_id":{"type":"string","format":"uuid","description":"The unique identifier of the settled (post-paid) subscription cycle whose usage-based charges this order collects.\n\nThis is the previous billing cycle whose usage is being settled by this order. For example, if a subscription cycle covers usage from 1-30 June and the order is generated on 10 July, this field identifies that June cycle.","descriptionNode":"$L1483"},"billing_reason":{"type":"string","enum":"$19:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:orders:items:properties:subscription_data:properties:billing_reason:enum","description":"The reason this subscription order was created.\n\n| Value | Description |\n| ----- | ----------- |\n| `cycle_billing` | The order was automatically generated to collect payment for an ongoing subscription cycle. `active_cycle_id` is present; `settled_cycle_id` is present if the previous cycle included usage-based products. |\n| `final_settlement` | The order was automatically generated after the subscription ended to collect outstanding usage-based charges. `active_cycle_id` is absent; `settled_cycle_id` is present. |\n| `setup_intent` | The order was manually created by the merchant or customer to update the payment method on file. `active_cycle_id` is absent; `settled_cycle_id` is absent. |","descriptionNode":"$L1484"}},"descriptionNode":"$L1485"}},"descriptionNode":"$L1486"},"examples":{"example_order_min":{"summary":"Example order response with minimal required parameters","value":{"id":"6516f565-c903-ae7d-8582-0bc70468ec29","token":"579462b3-da89-4a46-8690-572d3968573f","type":"payment","state":"cancelled","created_at":"2023-09-29T16:03:49.569437Z","updated_at":"2023-09-29T16:04:30.727004Z","amount":500,"currency":"GBP","refunded_amount":0,"outstanding_amount":0,"capture_mode":"automatic","authorisation_type":"final","enforce_challenge":"automatic"}},"example_order_additional":{"summary":"Example order response with additional parameters","value":{"id":"6516f379-c03f-adf3-a2bf-24b328909731","token":"91533c29-47d1-4ae9-a73f-74225fd4b176","type":"payment","state":"cancelled","created_at":"2023-09-29T15:55:37.201407Z","updated_at":"2023-09-29T15:56:38.398961Z","amount":500,"currency":"GBP","refunded_amount":0,"outstanding_amount":500,"capture_mode":"manual","authorisation_type":"final","cancel_authorised_after":"PT30M","description":"Example product","checkout_url":"https://checkout.revolut.com/payment-link/91533c29-47d1-4ae9-a73f-74225fd4b176","redirect_url":"https://www.example.com/redirect","shipping_address":{"street_line_1":"7 Westferry Circus","city":"London","country_code":"GB","postcode":"E14 4HD"},"metadata":{"product_type":"Example"},"payments":[{"id":"6516f38a-a12b-aca3-83f2-6ed16d6ed246","state":"authorised","created_at":"2023-09-29T15:55:54.579311Z","updated_at":"2023-09-29T15:56:38.403232Z","amount":500,"currency":"GBP","settled_amount":500,"settled_currency":"GBP","billing_address":{"street_line_1":"26 Atkins Avenue","street_line_2":"New York 42233","city":"SentinelFraudLow","country_code":"GB","postcode":"PE3 9UP"},"risk_level":"low","fees":[],"payer":{"email":"example.payer@example.com","phone":"+447911123456"},"payment_method":{"type":"revolut_pay_account","fingerprint":"1JAllfQY4POhBV8DaddAQ4LC5RbMP8LMLvUdJW4s5JY="}}],"enforce_challenge":"forced","customer":{"id":"3c131306-0a0a-4f54-99d7-3fb2e027c6f7","email":"example@example.com","phone":"+441234567890","full_name":"Example Customer"},"merchant_order_data":{"url":"https://example.com/orders/12345"},"statement_descriptor_suffix":"12345"}},"example_order_line_items":{"description":"Example order response with line items","value":{"id":"66bcc998-4209-ac6e-96fe-2910b949c516","token":"0bcfcc1d-9ee9-4476-b36c-cf4abba2e45a","type":"payment","state":"cancelled","created_at":"2024-08-14T15:13:28.814729Z","updated_at":"2024-08-14T15:13:28.814729Z","amount":770,"currency":"GBP","outstanding_amount":770,"capture_mode":"automatic","authorisation_type":"final","checkout_url":"https://checkout.revolut.com/payment-link/0bcfcc1d-9ee9-4476-b36c-cf4abba2e45a","enforce_challenge":"automatic","line_items":[{"name":"Example item 1","unit_price_amount":100,"quantity":{"value":2,"unit":"kg"},"type":"physical","discounts":[{"name":"Discount 1","amount":50}],"taxes":[{"name":"10% VAT","amount":20}],"total_amount":170,"image_urls":["https://www.example.com/line-item-image1","https://www.example.com/line-item-image2"],"description":"First line item","external_id":"external_id_123","url":"https://www.example.com"},{"name":"Example item 2","unit_price_amount":100,"quantity":{"value":10,"unit":"pieces"},"type":"service","discounts":[{"name":"Discount 2","amount":500}],"taxes":[{"name":"10% VAT","amount":100}],"total_amount":600,"image_urls":["https://www.example.com/line_item_image3","https://www.example.com/line_item_image4"],"description":"Second line item","external_id":"external_id_456","url":"https://www.example.com"}]}},"example_order_shipping":{"summary":"Example order response with shipping details","value":{"id":"66c5e449-36d3-af78-a832-328150ddc6a3","token":"b1145e3e-30c7-4dd6-b84c-680dccd39dde","type":"payment","state":"cancelled","created_at":"2024-08-21T12:57:45.793605Z","updated_at":"2024-08-21T12:57:45.793605Z","amount":770,"currency":"GBP","outstanding_amount":770,"capture_mode":"automatic","authorisation_type":"final","checkout_url":"https://checkout.revolut.com/payment-link/b1145e3e-30c7-4dd6-b84c-680dccd39dde","shipping":{"address":{"street_line_1":"Example Street 123","street_line_2":"II/123","region":"London","city":"London","country_code":"GB","postcode":"123456"},"contact":{"name":"Example Contact","email":"example.contact@example.com","phone":"+441234567890"},"shipments":[{"shipping_company_name":"Example Shipping Co.","tracking_number":"123456789","estimated_delivery_date":"2024-12-03T10:15:30+02:00[Europe/Paris]","tracking_url":"https://www.example.com/tracking/123456789"}]},"enforce_challenge":"automatic"}},"example_order_airline":{"summary":"Example order response with additional airline data","value":{"id":"6516f2f3-fd2c-ac2c-9bf2-3e02711dd3fb","token":"245e63f3-1e44-40db-bcd4-4448263d3fa2","type":"payment","state":"cancelled","created_at":"2023-09-29T15:53:23.234913Z","updated_at":"2023-09-29T16:24:39.366956Z","amount":500,"currency":"GBP","outstanding_amount":500,"settlement_currency":"EUR","capture_mode":"manual","authorisation_type":"final","description":"Example order description","checkout_url":"https://checkout.revolut.com/payment-link/245e63f3-1e44-40db-bcd4-4448263d3fa2","redirect_url":"https://www.example.com/redirect","cancel_authorised_after":"PT30M","industry_data":{"type":"airline","booking_id":"unique-booking-id-12345","fulfillment_date":"2023-07-10T14:00:00.069624Z","ticket_type":"flexible","crs_code":"DATS","ticket_change_indicator":"new","refundability":"refundable","passengers":[{"first_name":"Example","last_name":"Customer"},{"first_name":"John","last_name":"Doe"}],"journey_legs":[{"sequence":1,"departure_airport_code":"FRA","arrival_airport_code":"LHR","flight_number":"670","fare_base_code":"J","travel_date":"2023-07-10T10:00:00.069624Z","airline_name":"AerLingus","airline_code":"EI"},{"sequence":2,"departure_airport_code":"LHR","arrival_airport_code":"DUB","flight_number":"678","fare_base_code":"J","travel_date":"2023-07-10T15:00:00.069624Z","airline_name":"AerLingus","airline_code":"EI"},{"sequence":3,"departure_airport_code":"DUB","arrival_airport_code":"LHR","flight_number":"679","fare_base_code":"F","travel_date":"2023-07-15T10:00:00.069624Z","airline_name":"AerLingus","airline_code":"EI"},{"sequence":4,"departure_airport_code":"LHR","arrival_airport_code":"FRA","flight_number":"671","fare_base_code":"F","travel_date":"2023-07-10T14:00:00.069624Z","airline_name":"AerLingus","airline_code":"EI"}],"booking_url":"https://example.com/bookings/1234"},"payments":[{"id":"6516f315-f713-a5fd-8299-f28820937409","state":"failed","created_at":"2023-09-29T15:53:57.268142Z","updated_at":"2023-09-29T16:24:39.374460Z","amount":500,"currency":"GBP","settled_amount":576,"settled_currency":"EUR","risk_level":"low","fees":[],"payer":{"email":"example.payer@example.com","phone":"+447911123456"},"payment_method":{"type":"card","fingerprint":"1JAllfQY4POhBV8DaddAQ4LC5RbMP8LMLvUdJW4s5JY=","network_transaction_id":"1234567890123456","card_brand":"mastercard","funding":"credit","card_country_code":"MT","card_bin":"542071","card_last_four":"0016","card_expiry":"12/28","cardholder_name":"Example Holder","checks":{"three_ds":{"state":"verified","version":2},"cvv_verification":"match"}}}],"enforce_challenge":"forced","customer":{"id":"db186257-3031-4726-98ea-f2260ea115f0","email":"example@example.com","phone":"+441234567890","full_name":"Example Customer"},"merchant_order_data":{"url":"https://www.airline.com/ticketnumber-12345","reference":"example_airline_reference"}}},"example_order_crypto":{"summary":"Example cancelled order response with additional crypto transaction data","value":{"id":"6516edb9-74af-ae47-829b-1475e807a8d7","token":"1e619c26-d954-4d45-94ab-aba1e407fcee","type":"payment","state":"cancelled","created_at":"2023-09-29T15:31:05.746826Z","updated_at":"2023-09-29T15:45:12.352147Z","amount":26100,"currency":"EUR","outstanding_amount":26100,"settlement_currency":"EUR","capture_mode":"manual","authorisation_type":"final","description":"Customer wants to buy 0.01 BTC","checkout_url":"https://checkout.revolut.com/payment-link/1e619c26-d954-4d45-94ab-aba1e407fcee","redirect_url":"https://www.example.com/redirect","industry_data":{"type":"crypto","transactions":[{"id":"7b2a8ed4-5889-4c0c-a8cc-299aff1c881b","status":"cancelled","recipient_wallet_id":"64a6f159-0a60-a446-880e-e449a1f62f7c"}],"seller":{"id":"a13638ab-3e90-4b05-9f69-23abc655775b","name":"Ramp Provider Company Name","website":"https://example.com","phone":"123456789","mcc":"6051","address":{"street_line_1":"456 Crypto Ave","city":"New York","postcode":"10001","country_code":"US"}}},"enforce_challenge":"automatic","customer":{"id":"db186257-3031-4726-98ea-f2260ea115f0","email":"example@example.com","phone":"+44123456789","full_name":"Example Customer"},"merchant_order_data":{"url":"https://www.example.com/cryptotransactionnumber-12345","reference":"example_crypto_reference"}}},"example_order_marketplace":{"summary":"Example cancelled order response with additional marketplace data","value":{"id":"670920dc-d343-abf8-963a-68ae1bc8ae58","token":"41aabe45-b444-45e6-8363-f0433452e138","type":"payment","state":"cancelled","created_at":"2024-10-11T12:58:04.826974Z","updated_at":"2024-10-11T13:15:22.145821Z","amount":10000,"currency":"EUR","outstanding_amount":10000,"capture_mode":"automatic","authorisation_type":"final","checkout_url":"https://checkout.revolut.com/payment-link/41aabe45-b444-45e6-8363-f0433452e138","industry_data":{"type":"marketplace","seller":{"id":"123-45-67","name":"Example Seller","address":{"street_line_1":"1 Canada Square","street_line_2":"Revolut LTD, Level 39","region":"Greater London","city":"London","country_code":"GB","country_subdivision_code":"GB-LND","postcode":"E14 4HD"},"website":"https://example.com/123-45-67","phone":"+441234567890"}},"enforce_challenge":"automatic"}},"example_order_event":{"summary":"Example order response with additional event data","value":{"id":"67bf20c4-59a5-a7a9-81ad-052fda5f80eb","token":"8737a497-9bae-4647-90bf-1abe2fd9162a","type":"payment","state":"cancelled","created_at":"2025-02-26T14:10:12.804901Z","updated_at":"2025-02-26T14:10:12.804901Z","amount":100,"currency":"GBP","outstanding_amount":100,"capture_mode":"automatic","authorisation_type":"final","checkout_url":"https://checkout.revolut.com/payment-link/8737a497-9bae-4647-90bf-1abe2fd9162a","industry_data":{"type":"event","booking_id":"example_booking_123","events":[{"start_date":"2025-03-04T14:00:00Z","end_date":"2025-03-04T17:00:00Z","supplier":"Example Supplier","supplier_payment_date":"2025-03-03T14:00:15Z","name":"Example Event","location":{"street_line_1":"Example Street 123","street_line_2":"II/123","region":"London","city":"London","country_code":"GB","postcode":"123456"},"category":"exhibition","market":"primary","tickets":[{"id":"example_ticket_1","transferable":false,"refundability":"partially_refundable"},{"id":"example_ticket_2","transferable":true,"refundability":"non_refundable"},{"id":"example_ticket_3"}]}]},"enforce_challenge":"automatic"}},"example_order_lodging":{"summary":"Example order response with additional lodging data","value":{"id":"67c70d42-1545-a73d-a4a5-35b7ac49e1da","token":"9effe2b6-8907-4954-9e9b-696f763f7e08","type":"payment","state":"cancelled","created_at":"2025-03-04T14:25:06.099782Z","updated_at":"2025-03-04T14:25:06.099782Z","amount":100,"currency":"GBP","outstanding_amount":100,"capture_mode":"automatic","authorisation_type":"final","checkout_url":"https://checkout.revolut.com/payment-link/9effe2b6-8907-4954-9e9b-696f763f7e08","industry_data":{"type":"lodging","booking_id":"example_booking_123","check_out_date":"2025-05-05T11:00:00Z","booking_type":"flexible","refundability":"partially_refundable","location":{"street_line_1":"Example Street 123","street_line_2":"II/123","region":"London","city":"London","country_code":"GB","postcode":"123456"},"guests":[{"first_name":"First","last_name":"Guest"},{"first_name":"Second","last_name":"Guest"}],"check_in_date":"2025-05-01T15:00:00Z","supplier_payment_date":"2025-05-05T11:00:00Z","category":"bed_and_breakfast"},"enforce_challenge":"automatic"}}}}},"descriptionNode":"$L1487"},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"code":{"type":"string","description":"An identifier that can be used to determine what went wrong.\n\nError codes are not globally unique, but uniqueness is guaranteed within endpoints.","descriptionNode":"$L1488"},"message":{"type":"string","description":"Some human readable text describing what went wrong.","descriptionNode":"$L1489"},"timestamp":{"type":"integer","description":"The [UNIX timestamp](https://www.unixtimestamp.com/) of the date and time the error happened.","descriptionNode":"$L148a"}}},"examples":{"example-1":{"value":{"code":"bad_request","message":"Could not parse JSON","timestamp":1601296792533}}}}},"descriptionNode":"$L148b"},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"code":{"type":"string","description":"An identifier that can be used to determine what went wrong.\n\nError codes are not globally unique, but uniqueness is guaranteed within endpoints.","descriptionNode":"$L148c"},"message":{"type":"string","description":"Some human readable text describing what went wrong.","descriptionNode":"$L148d"},"timestamp":{"type":"integer","description":"The [UNIX timestamp](https://www.unixtimestamp.com/) of the date and time the error happened.","descriptionNode":"$L148e"}}},"examples":{"default":{"value":{"code":"unauthenticated","message":"Authentication failed","timestamp":1721049596461}}}}},"descriptionNode":"$L148f"},"404":{"description":"Not Found","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"code":{"type":"string","description":"An identifier that can be used to determine what went wrong.\n\nError codes are not globally unique, but uniqueness is guaranteed within endpoints.","descriptionNode":"$L1490"},"message":{"type":"string","description":"Some human readable text describing what went wrong.","descriptionNode":"$L1491"},"timestamp":{"type":"integer","description":"The [UNIX timestamp](https://www.unixtimestamp.com/) of the date and time the error happened.","descriptionNode":"$L1492"}}},"examples":{"default":{"value":{"code":"not_found","message":"Order with id abfa5bbd-a20c-4a0e-be66-30e733454518 was not found","timestamp":1721050063886}}}}},"descriptionNode":"$L1493"}},"requestBody":"$undefined","variantLabels":["Example order response with minimal required parameters","Example order response with additional parameters","example_order_line_items","Example order response with shipping details","Example order response with additional airline data","Example cancelled order response with additional crypto transaction data","Example cancelled order response with additional marketplace data","Example order response with additional event data","Example order response with additional lodging data"],"children":["$L1494","$L1495"]}]}],false]}] 133b:["$","div",null,{"className":"ezz1n30","children":[["$","div",null,{"data-header":"$undefined","className":"ezz1n31","children":["$","div",null,{"className":"y9a0do1","children":[["$","h2",null,{"id":"retrieve-order","children":[["$L1496","$undefined"],["$","$L15",null,{"id":"retrieve-order"}]]}],["$","$L16",null,{"url":"/docs/api/merchant/2025-10-16/operations/retrieve-order.md"}]]}]}],"$undefined"]}] 149c:T9d0,
fetch("https://merchant.revolut.com/api/orders/__RP_TOK_0__", {
  method: "GET",
  headers: {
    "Authorization": "__RP_TOK_1__",
    "Revolut-Api-Version": "__RP_TOK_2__"
  }
})
  .then(response => response.json())
  .then(data => console.log(data));
149d:Tf6d,
package main

import (
  "fmt"
  "net/http"
)

func main() {
  url := "https://merchant.revolut.com/api/orders/__RP_TOK_0__"
  req, _ := http.NewRequest("GET", url, nil)
  req.Header.Add("Authorization", "__RP_TOK_1__")
  req.Header.Add("Revolut-Api-Version", "__RP_TOK_2__")

  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  fmt.Println(res)
}
149e:T7e2,
import requests

url = "https://merchant.revolut.com/api/orders/__RP_TOK_0__"
headers = {
  "Authorization": "__RP_TOK_1__",
  "Revolut-Api-Version": "__RP_TOK_2__"
}

response = requests.get(url, headers=headers)
print(response.json())
149f:T170e,
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;

public class Main {
  public static void main(String[] args) {
    HttpClient client = HttpClient.newHttpClient();
    HttpRequest request = HttpRequest.newBuilder()
      .uri(URI.create("https://merchant.revolut.com/api/orders/__RP_TOK_0__"))
      .header("Authorization", "__RP_TOK_1__")
      .header("Revolut-Api-Version", "__RP_TOK_2__")
      .GET(HttpRequest.BodyPublishers.noBody())
      .build();

    client.sendAsync(request, HttpResponse.BodyHandlers.ofString())
      .thenApply(HttpResponse::body)
      .thenAccept(System.out::println)
      .join();
  }
}
14a0:T15b8,
using System.Net.Http;
using System.Net.Http.Headers;

var client = new HttpClient();
var request = new HttpRequestMessage
{
  Method = HttpMethod.Get,
  RequestUri = new Uri("https://merchant.revolut.com/api/orders/__RP_TOK_0__"),
  Headers =
  {
    { "Authorization", "__RP_TOK_1__" },
    { "Revolut-Api-Version", "__RP_TOK_2__" },
  }
};

using (var response = await client.SendAsync(request))
{
  response.EnsureSuccessStatusCode();
  var body = await response.Content.ReadAsStringAsync();
  Console.WriteLine(body);
}
14a1:T9d8,
fetch("https://sandbox-merchant.revolut.com/api/orders/__RP_TOK_0__", {
  method: "GET",
  headers: {
    "Authorization": "__RP_TOK_1__",
    "Revolut-Api-Version": "__RP_TOK_2__"
  }
})
  .then(response => response.json())
  .then(data => console.log(data));
14a2:Tf75,
package main

import (
  "fmt"
  "net/http"
)

func main() {
  url := "https://sandbox-merchant.revolut.com/api/orders/__RP_TOK_0__"
  req, _ := http.NewRequest("GET", url, nil)
  req.Header.Add("Authorization", "__RP_TOK_1__")
  req.Header.Add("Revolut-Api-Version", "__RP_TOK_2__")

  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  fmt.Println(res)
}
14a3:T7ea,
import requests

url = "https://sandbox-merchant.revolut.com/api/orders/__RP_TOK_0__"
headers = {
  "Authorization": "__RP_TOK_1__",
  "Revolut-Api-Version": "__RP_TOK_2__"
}

response = requests.get(url, headers=headers)
print(response.json())
14a4:T1716,
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;

public class Main {
  public static void main(String[] args) {
    HttpClient client = HttpClient.newHttpClient();
    HttpRequest request = HttpRequest.newBuilder()
      .uri(URI.create("https://sandbox-merchant.revolut.com/api/orders/__RP_TOK_0__"))
      .header("Authorization", "__RP_TOK_1__")
      .header("Revolut-Api-Version", "__RP_TOK_2__")
      .GET(HttpRequest.BodyPublishers.noBody())
      .build();

    client.sendAsync(request, HttpResponse.BodyHandlers.ofString())
      .thenApply(HttpResponse::body)
      .thenAccept(System.out::println)
      .join();
  }
}
14a5:T15c0,
using System.Net.Http;
using System.Net.Http.Headers;

var client = new HttpClient();
var request = new HttpRequestMessage
{
  Method = HttpMethod.Get,
  RequestUri = new Uri("https://sandbox-merchant.revolut.com/api/orders/__RP_TOK_0__"),
  Headers =
  {
    { "Authorization", "__RP_TOK_1__" },
    { "Revolut-Api-Version", "__RP_TOK_2__" },
  }
};

using (var response = await client.SendAsync(request))
{
  response.EnsureSuccessStatusCode();
  var body = await response.Content.ReadAsStringAsync();
  Console.WriteLine(body);
}
133c:["$","div",null,{"className":"ezz1n30","children":[["$","div",null,{"data-header":"$undefined","className":"ezz1n31","children":["$L1497",["$","$L85",null,{"parameters":[{"name":"Authorization","in":"header","schema":{"type":"string","format":"Bearer ","examples":"$62:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:0:schema:examples"},"required":true,"description":"This parameter accepts the [Merchant API Secret key](https://business.revolut.com/settings/apis?tab=merchant-api) to authorise requests coming from the merchant's backend. \n\nIt ensures that ensures that each request is authenticated and authorised by verifying the secret key. The secret key should be included in all request headers as a `Bearer` token.\n\n:::info\nFor more information, see: [Authentication](https://developer.revolut.com/docs/api/merchant#authentication)\n:::","descriptionNode":"$L1498"},{"name":"Revolut-Api-Version","in":"header","schema":{"type":"string","format":"date","enum":"$36:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:1:schema:enum","examples":"$36:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:1:schema:examples"},"required":true,"description":"The version of the Merchant API, specified in `YYYY-MM-DD` format.\n\nIf not specified, you will receive an error.\n\n\n:::info\nFor more information about API versioning, see: [API versions](https://developer.revolut.com/docs/guides/merchant/reference/versioning/api-versions).\n:::","x-config-always-visible-in-example":true,"example":"2025-10-16","descriptionNode":"$L1499"},{"name":"order_id","in":"path","schema":{"type":"string","format":"uuid","description":"A UUID string, typically used to identify resources.","descriptionNode":"$L149a"},"required":true,"description":"The ID of the `Order` object.","descriptionNode":"$L149b"}],"requestBody":"$undefined","heading":"Request","requestBodySchemaTitle":"Request body","headingAs":"h3"}],["$","$L89",null,{"responses":"$1a:props:children:0:props:children:props:responses","headingAs":"h3"}]]}],["$","div",null,{"className":"ezz1n32","children":[[["$","$L8a",null,{"itemsByServer":{"https://merchant.revolut.com":[{"id":"curl","label":"cURL","templateCode":"curl -X GET \"https://merchant.revolut.com/api/orders/__RP_TOK_0__\" \\\n -H \"Authorization: __RP_TOK_1__\" \\\n -H \"Revolut-Api-Version: __RP_TOK_2__\"","templateHtml":"
curl -X GET \"https://merchant.revolut.com/api/orders/__RP_TOK_0__\" \\\n  -H \"Authorization: __RP_TOK_1__\" \\\n  -H \"Revolut-Api-Version: __RP_TOK_2__\"
","tokens":[{"marker":"__RP_TOK_0__","paramName":"order_id","paramIn":"path","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["shell-double-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:order_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"javascript","label":"JavaScript","templateCode":"fetch(\"https://merchant.revolut.com/api/orders/__RP_TOK_0__\", {\n method: \"GET\",\n headers: {\n \"Authorization\": \"__RP_TOK_1__\",\n \"Revolut-Api-Version\": \"__RP_TOK_2__\"\n }\n})\n .then(response => response.json())\n .then(data => console.log(data));","templateHtml":"$149c","tokens":[{"marker":"__RP_TOK_0__","paramName":"order_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:order_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"go","label":"Go","templateCode":"package main\n\nimport (\n \"fmt\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://merchant.revolut.com/api/orders/__RP_TOK_0__\"\n req, _ := http.NewRequest(\"GET\", url, nil)\n req.Header.Add(\"Authorization\", \"__RP_TOK_1__\")\n req.Header.Add(\"Revolut-Api-Version\", \"__RP_TOK_2__\")\n\n res, _ := http.DefaultClient.Do(req)\n defer res.Body.Close()\n fmt.Println(res)\n}","templateHtml":"$149d","tokens":[{"marker":"__RP_TOK_0__","paramName":"order_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:order_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"python","label":"Python","templateCode":"import requests\n\nurl = \"https://merchant.revolut.com/api/orders/__RP_TOK_0__\"\nheaders = {\n \"Authorization\": \"__RP_TOK_1__\",\n \"Revolut-Api-Version\": \"__RP_TOK_2__\"\n}\n\nresponse = requests.get(url, headers=headers)\nprint(response.json())","templateHtml":"$149e","tokens":[{"marker":"__RP_TOK_0__","paramName":"order_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:order_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"java","label":"Java","templateCode":"import java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\nimport java.net.URI;\n\npublic class Main {\n public static void main(String[] args) {\n HttpClient client = HttpClient.newHttpClient();\n HttpRequest request = HttpRequest.newBuilder()\n .uri(URI.create(\"https://merchant.revolut.com/api/orders/__RP_TOK_0__\"))\n .header(\"Authorization\", \"__RP_TOK_1__\")\n .header(\"Revolut-Api-Version\", \"__RP_TOK_2__\")\n .GET(HttpRequest.BodyPublishers.noBody())\n .build();\n\n client.sendAsync(request, HttpResponse.BodyHandlers.ofString())\n .thenApply(HttpResponse::body)\n .thenAccept(System.out::println)\n .join();\n }\n}","templateHtml":"$149f","tokens":[{"marker":"__RP_TOK_0__","paramName":"order_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:order_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"csharp","label":"C#","templateCode":"using System.Net.Http;\nusing System.Net.Http.Headers;\n\nvar client = new HttpClient();\nvar request = new HttpRequestMessage\n{\n Method = HttpMethod.Get,\n RequestUri = new Uri(\"https://merchant.revolut.com/api/orders/__RP_TOK_0__\"),\n Headers =\n {\n { \"Authorization\", \"__RP_TOK_1__\" },\n { \"Revolut-Api-Version\", \"__RP_TOK_2__\" },\n }\n};\n\nusing (var response = await client.SendAsync(request))\n{\n response.EnsureSuccessStatusCode();\n var body = await response.Content.ReadAsStringAsync();\n Console.WriteLine(body);\n}","templateHtml":"$14a0","tokens":[{"marker":"__RP_TOK_0__","paramName":"order_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:order_id":"123e4567-e89b-12d3-a456-426614174000"}}],"https://sandbox-merchant.revolut.com":[{"id":"curl","label":"cURL","templateCode":"curl -X GET \"https://sandbox-merchant.revolut.com/api/orders/__RP_TOK_0__\" \\\n -H \"Authorization: __RP_TOK_1__\" \\\n -H \"Revolut-Api-Version: __RP_TOK_2__\"","templateHtml":"
curl -X GET \"https://sandbox-merchant.revolut.com/api/orders/__RP_TOK_0__\" \\\n  -H \"Authorization: __RP_TOK_1__\" \\\n  -H \"Revolut-Api-Version: __RP_TOK_2__\"
","tokens":[{"marker":"__RP_TOK_0__","paramName":"order_id","paramIn":"path","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["shell-double-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:order_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"javascript","label":"JavaScript","templateCode":"fetch(\"https://sandbox-merchant.revolut.com/api/orders/__RP_TOK_0__\", {\n method: \"GET\",\n headers: {\n \"Authorization\": \"__RP_TOK_1__\",\n \"Revolut-Api-Version\": \"__RP_TOK_2__\"\n }\n})\n .then(response => response.json())\n .then(data => console.log(data));","templateHtml":"$14a1","tokens":[{"marker":"__RP_TOK_0__","paramName":"order_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:order_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"go","label":"Go","templateCode":"package main\n\nimport (\n \"fmt\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://sandbox-merchant.revolut.com/api/orders/__RP_TOK_0__\"\n req, _ := http.NewRequest(\"GET\", url, nil)\n req.Header.Add(\"Authorization\", \"__RP_TOK_1__\")\n req.Header.Add(\"Revolut-Api-Version\", \"__RP_TOK_2__\")\n\n res, _ := http.DefaultClient.Do(req)\n defer res.Body.Close()\n fmt.Println(res)\n}","templateHtml":"$14a2","tokens":[{"marker":"__RP_TOK_0__","paramName":"order_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:order_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"python","label":"Python","templateCode":"import requests\n\nurl = \"https://sandbox-merchant.revolut.com/api/orders/__RP_TOK_0__\"\nheaders = {\n \"Authorization\": \"__RP_TOK_1__\",\n \"Revolut-Api-Version\": \"__RP_TOK_2__\"\n}\n\nresponse = requests.get(url, headers=headers)\nprint(response.json())","templateHtml":"$14a3","tokens":[{"marker":"__RP_TOK_0__","paramName":"order_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:order_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"java","label":"Java","templateCode":"import java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\nimport java.net.URI;\n\npublic class Main {\n public static void main(String[] args) {\n HttpClient client = HttpClient.newHttpClient();\n HttpRequest request = HttpRequest.newBuilder()\n .uri(URI.create(\"https://sandbox-merchant.revolut.com/api/orders/__RP_TOK_0__\"))\n .header(\"Authorization\", \"__RP_TOK_1__\")\n .header(\"Revolut-Api-Version\", \"__RP_TOK_2__\")\n .GET(HttpRequest.BodyPublishers.noBody())\n .build();\n\n client.sendAsync(request, HttpResponse.BodyHandlers.ofString())\n .thenApply(HttpResponse::body)\n .thenAccept(System.out::println)\n .join();\n }\n}","templateHtml":"$14a4","tokens":[{"marker":"__RP_TOK_0__","paramName":"order_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:order_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"csharp","label":"C#","templateCode":"using System.Net.Http;\nusing System.Net.Http.Headers;\n\nvar client = new HttpClient();\nvar request = new HttpRequestMessage\n{\n Method = HttpMethod.Get,\n RequestUri = new Uri(\"https://sandbox-merchant.revolut.com/api/orders/__RP_TOK_0__\"),\n Headers =\n {\n { \"Authorization\", \"__RP_TOK_1__\" },\n { \"Revolut-Api-Version\", \"__RP_TOK_2__\" },\n }\n};\n\nusing (var response = await client.SendAsync(request))\n{\n response.EnsureSuccessStatusCode();\n var body = await response.Content.ReadAsStringAsync();\n Console.WriteLine(body);\n}","templateHtml":"$14a5","tokens":[{"marker":"__RP_TOK_0__","paramName":"order_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:order_id":"123e4567-e89b-12d3-a456-426614174000"}}]},"method":"get","servers":"$62:props:children:0:props:children:props:children:1:props:children:1:props:children:0:0:props:servers","path":"/api/orders/{order_id}","parameters":["$133c:props:children:0:props:children:1:props:parameters:0","$133c:props:children:0:props:children:1:props:parameters:1","$133c:props:children:0:props:children:1:props:parameters:2"]}],"$L14a6"],"$L14a7","$L14a8"]}]]}] 1494:["$","div",null,{"className":"ezz1n30","children":[["$","div",null,{"data-header":"$undefined","className":"ezz1n31","children":["$","div",null,{"className":"y9a0do1","children":[["$","h2",null,{"id":"cancel-order","children":[["$L14a9","$undefined"],["$","$L15",null,{"id":"cancel-order"}]]}],["$","$L16",null,{"url":"/docs/api/merchant/2025-10-16/operations/cancel-order.md"}]]}]}],"$undefined"]}] 14af:T9d8,
fetch("https://merchant.revolut.com/api/orders/__RP_TOK_0__/cancel", {
  method: "POST",
  headers: {
    "Authorization": "__RP_TOK_1__",
    "Revolut-Api-Version": "__RP_TOK_2__"
  }
})
  .then(response => response.json())
  .then(data => console.log(data));
14b0:Tf75,
package main

import (
  "fmt"
  "net/http"
)

func main() {
  url := "https://merchant.revolut.com/api/orders/__RP_TOK_0__/cancel"
  req, _ := http.NewRequest("POST", url, nil)
  req.Header.Add("Authorization", "__RP_TOK_1__")
  req.Header.Add("Revolut-Api-Version", "__RP_TOK_2__")

  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  fmt.Println(res)
}
14b1:T7ea,
import requests

url = "https://merchant.revolut.com/api/orders/__RP_TOK_0__/cancel"
headers = {
  "Authorization": "__RP_TOK_1__",
  "Revolut-Api-Version": "__RP_TOK_2__"
}

response = requests.post(url, headers=headers)
print(response.json())
14b2:T1716,
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;

public class Main {
  public static void main(String[] args) {
    HttpClient client = HttpClient.newHttpClient();
    HttpRequest request = HttpRequest.newBuilder()
      .uri(URI.create("https://merchant.revolut.com/api/orders/__RP_TOK_0__/cancel"))
      .header("Authorization", "__RP_TOK_1__")
      .header("Revolut-Api-Version", "__RP_TOK_2__")
      .POST(HttpRequest.BodyPublishers.noBody())
      .build();

    client.sendAsync(request, HttpResponse.BodyHandlers.ofString())
      .thenApply(HttpResponse::body)
      .thenAccept(System.out::println)
      .join();
  }
}
14b3:T15c0,
using System.Net.Http;
using System.Net.Http.Headers;

var client = new HttpClient();
var request = new HttpRequestMessage
{
  Method = HttpMethod.Post,
  RequestUri = new Uri("https://merchant.revolut.com/api/orders/__RP_TOK_0__/cancel"),
  Headers =
  {
    { "Authorization", "__RP_TOK_1__" },
    { "Revolut-Api-Version", "__RP_TOK_2__" },
  }
};

using (var response = await client.SendAsync(request))
{
  response.EnsureSuccessStatusCode();
  var body = await response.Content.ReadAsStringAsync();
  Console.WriteLine(body);
}
14b4:T9e0,
fetch("https://sandbox-merchant.revolut.com/api/orders/__RP_TOK_0__/cancel", {
  method: "POST",
  headers: {
    "Authorization": "__RP_TOK_1__",
    "Revolut-Api-Version": "__RP_TOK_2__"
  }
})
  .then(response => response.json())
  .then(data => console.log(data));
14b5:Tf7d,
package main

import (
  "fmt"
  "net/http"
)

func main() {
  url := "https://sandbox-merchant.revolut.com/api/orders/__RP_TOK_0__/cancel"
  req, _ := http.NewRequest("POST", url, nil)
  req.Header.Add("Authorization", "__RP_TOK_1__")
  req.Header.Add("Revolut-Api-Version", "__RP_TOK_2__")

  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  fmt.Println(res)
}
14b6:T7f2,
import requests

url = "https://sandbox-merchant.revolut.com/api/orders/__RP_TOK_0__/cancel"
headers = {
  "Authorization": "__RP_TOK_1__",
  "Revolut-Api-Version": "__RP_TOK_2__"
}

response = requests.post(url, headers=headers)
print(response.json())
14b7:T171e,
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;

public class Main {
  public static void main(String[] args) {
    HttpClient client = HttpClient.newHttpClient();
    HttpRequest request = HttpRequest.newBuilder()
      .uri(URI.create("https://sandbox-merchant.revolut.com/api/orders/__RP_TOK_0__/cancel"))
      .header("Authorization", "__RP_TOK_1__")
      .header("Revolut-Api-Version", "__RP_TOK_2__")
      .POST(HttpRequest.BodyPublishers.noBody())
      .build();

    client.sendAsync(request, HttpResponse.BodyHandlers.ofString())
      .thenApply(HttpResponse::body)
      .thenAccept(System.out::println)
      .join();
  }
}
14b8:T15c8,
using System.Net.Http;
using System.Net.Http.Headers;

var client = new HttpClient();
var request = new HttpRequestMessage
{
  Method = HttpMethod.Post,
  RequestUri = new Uri("https://sandbox-merchant.revolut.com/api/orders/__RP_TOK_0__/cancel"),
  Headers =
  {
    { "Authorization", "__RP_TOK_1__" },
    { "Revolut-Api-Version", "__RP_TOK_2__" },
  }
};

using (var response = await client.SendAsync(request))
{
  response.EnsureSuccessStatusCode();
  var body = await response.Content.ReadAsStringAsync();
  Console.WriteLine(body);
}
1495:["$","div",null,{"className":"ezz1n30","children":[["$","div",null,{"data-header":"$undefined","className":"ezz1n31","children":["$L14aa",["$","$L85",null,{"parameters":[{"name":"Authorization","in":"header","schema":{"type":"string","format":"Bearer ","examples":"$62:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:0:schema:examples"},"required":true,"description":"This parameter accepts the [Merchant API Secret key](https://business.revolut.com/settings/apis?tab=merchant-api) to authorise requests coming from the merchant's backend. \n\nIt ensures that ensures that each request is authenticated and authorised by verifying the secret key. The secret key should be included in all request headers as a `Bearer` token.\n\n:::info\nFor more information, see: [Authentication](https://developer.revolut.com/docs/api/merchant#authentication)\n:::","descriptionNode":"$L14ab"},{"name":"Revolut-Api-Version","in":"header","schema":{"type":"string","format":"date","enum":"$6b:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:1:schema:enum","examples":"$6b:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:1:schema:examples"},"description":"The version of the Merchant API, specified in `YYYY-MM-DD` format.\n\n:::info\nFor more information about API versioning, see: [API versions](https://developer.revolut.com/docs/guides/merchant/reference/versioning/api-versions).\n:::","x-config-always-visible-in-example":true,"descriptionNode":"$L14ac"},{"name":"order_id","in":"path","schema":{"type":"string","format":"uuid","description":"A UUID string, typically used to identify resources.","descriptionNode":"$L14ad"},"required":true,"description":"The ID of the `Order` object.","descriptionNode":"$L14ae"}],"requestBody":"$undefined","heading":"Request","requestBodySchemaTitle":"Request body","headingAs":"h3"}],["$","$L89",null,{"responses":"$1e:props:children:0:props:children:props:responses","headingAs":"h3"}]]}],["$","div",null,{"className":"ezz1n32","children":[[["$","$L8a",null,{"itemsByServer":{"https://merchant.revolut.com":[{"id":"curl","label":"cURL","templateCode":"curl -X POST \"https://merchant.revolut.com/api/orders/__RP_TOK_0__/cancel\" \\\n -H \"Authorization: __RP_TOK_1__\" \\\n -H \"Revolut-Api-Version: __RP_TOK_2__\"","templateHtml":"
curl -X POST \"https://merchant.revolut.com/api/orders/__RP_TOK_0__/cancel\" \\\n  -H \"Authorization: __RP_TOK_1__\" \\\n  -H \"Revolut-Api-Version: __RP_TOK_2__\"
","tokens":[{"marker":"__RP_TOK_0__","paramName":"order_id","paramIn":"path","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["shell-double-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2023-09-01","path:order_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"javascript","label":"JavaScript","templateCode":"fetch(\"https://merchant.revolut.com/api/orders/__RP_TOK_0__/cancel\", {\n method: \"POST\",\n headers: {\n \"Authorization\": \"__RP_TOK_1__\",\n \"Revolut-Api-Version\": \"__RP_TOK_2__\"\n }\n})\n .then(response => response.json())\n .then(data => console.log(data));","templateHtml":"$14af","tokens":[{"marker":"__RP_TOK_0__","paramName":"order_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2023-09-01","path:order_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"go","label":"Go","templateCode":"package main\n\nimport (\n \"fmt\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://merchant.revolut.com/api/orders/__RP_TOK_0__/cancel\"\n req, _ := http.NewRequest(\"POST\", url, nil)\n req.Header.Add(\"Authorization\", \"__RP_TOK_1__\")\n req.Header.Add(\"Revolut-Api-Version\", \"__RP_TOK_2__\")\n\n res, _ := http.DefaultClient.Do(req)\n defer res.Body.Close()\n fmt.Println(res)\n}","templateHtml":"$14b0","tokens":[{"marker":"__RP_TOK_0__","paramName":"order_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2023-09-01","path:order_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"python","label":"Python","templateCode":"import requests\n\nurl = \"https://merchant.revolut.com/api/orders/__RP_TOK_0__/cancel\"\nheaders = {\n \"Authorization\": \"__RP_TOK_1__\",\n \"Revolut-Api-Version\": \"__RP_TOK_2__\"\n}\n\nresponse = requests.post(url, headers=headers)\nprint(response.json())","templateHtml":"$14b1","tokens":[{"marker":"__RP_TOK_0__","paramName":"order_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2023-09-01","path:order_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"java","label":"Java","templateCode":"import java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\nimport java.net.URI;\n\npublic class Main {\n public static void main(String[] args) {\n HttpClient client = HttpClient.newHttpClient();\n HttpRequest request = HttpRequest.newBuilder()\n .uri(URI.create(\"https://merchant.revolut.com/api/orders/__RP_TOK_0__/cancel\"))\n .header(\"Authorization\", \"__RP_TOK_1__\")\n .header(\"Revolut-Api-Version\", \"__RP_TOK_2__\")\n .POST(HttpRequest.BodyPublishers.noBody())\n .build();\n\n client.sendAsync(request, HttpResponse.BodyHandlers.ofString())\n .thenApply(HttpResponse::body)\n .thenAccept(System.out::println)\n .join();\n }\n}","templateHtml":"$14b2","tokens":[{"marker":"__RP_TOK_0__","paramName":"order_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2023-09-01","path:order_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"csharp","label":"C#","templateCode":"using System.Net.Http;\nusing System.Net.Http.Headers;\n\nvar client = new HttpClient();\nvar request = new HttpRequestMessage\n{\n Method = HttpMethod.Post,\n RequestUri = new Uri(\"https://merchant.revolut.com/api/orders/__RP_TOK_0__/cancel\"),\n Headers =\n {\n { \"Authorization\", \"__RP_TOK_1__\" },\n { \"Revolut-Api-Version\", \"__RP_TOK_2__\" },\n }\n};\n\nusing (var response = await client.SendAsync(request))\n{\n response.EnsureSuccessStatusCode();\n var body = await response.Content.ReadAsStringAsync();\n Console.WriteLine(body);\n}","templateHtml":"$14b3","tokens":[{"marker":"__RP_TOK_0__","paramName":"order_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2023-09-01","path:order_id":"123e4567-e89b-12d3-a456-426614174000"}}],"https://sandbox-merchant.revolut.com":[{"id":"curl","label":"cURL","templateCode":"curl -X POST \"https://sandbox-merchant.revolut.com/api/orders/__RP_TOK_0__/cancel\" \\\n -H \"Authorization: __RP_TOK_1__\" \\\n -H \"Revolut-Api-Version: __RP_TOK_2__\"","templateHtml":"
curl -X POST \"https://sandbox-merchant.revolut.com/api/orders/__RP_TOK_0__/cancel\" \\\n  -H \"Authorization: __RP_TOK_1__\" \\\n  -H \"Revolut-Api-Version: __RP_TOK_2__\"
","tokens":[{"marker":"__RP_TOK_0__","paramName":"order_id","paramIn":"path","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["shell-double-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2023-09-01","path:order_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"javascript","label":"JavaScript","templateCode":"fetch(\"https://sandbox-merchant.revolut.com/api/orders/__RP_TOK_0__/cancel\", {\n method: \"POST\",\n headers: {\n \"Authorization\": \"__RP_TOK_1__\",\n \"Revolut-Api-Version\": \"__RP_TOK_2__\"\n }\n})\n .then(response => response.json())\n .then(data => console.log(data));","templateHtml":"$14b4","tokens":[{"marker":"__RP_TOK_0__","paramName":"order_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2023-09-01","path:order_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"go","label":"Go","templateCode":"package main\n\nimport (\n \"fmt\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://sandbox-merchant.revolut.com/api/orders/__RP_TOK_0__/cancel\"\n req, _ := http.NewRequest(\"POST\", url, nil)\n req.Header.Add(\"Authorization\", \"__RP_TOK_1__\")\n req.Header.Add(\"Revolut-Api-Version\", \"__RP_TOK_2__\")\n\n res, _ := http.DefaultClient.Do(req)\n defer res.Body.Close()\n fmt.Println(res)\n}","templateHtml":"$14b5","tokens":[{"marker":"__RP_TOK_0__","paramName":"order_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2023-09-01","path:order_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"python","label":"Python","templateCode":"import requests\n\nurl = \"https://sandbox-merchant.revolut.com/api/orders/__RP_TOK_0__/cancel\"\nheaders = {\n \"Authorization\": \"__RP_TOK_1__\",\n \"Revolut-Api-Version\": \"__RP_TOK_2__\"\n}\n\nresponse = requests.post(url, headers=headers)\nprint(response.json())","templateHtml":"$14b6","tokens":[{"marker":"__RP_TOK_0__","paramName":"order_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2023-09-01","path:order_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"java","label":"Java","templateCode":"import java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\nimport java.net.URI;\n\npublic class Main {\n public static void main(String[] args) {\n HttpClient client = HttpClient.newHttpClient();\n HttpRequest request = HttpRequest.newBuilder()\n .uri(URI.create(\"https://sandbox-merchant.revolut.com/api/orders/__RP_TOK_0__/cancel\"))\n .header(\"Authorization\", \"__RP_TOK_1__\")\n .header(\"Revolut-Api-Version\", \"__RP_TOK_2__\")\n .POST(HttpRequest.BodyPublishers.noBody())\n .build();\n\n client.sendAsync(request, HttpResponse.BodyHandlers.ofString())\n .thenApply(HttpResponse::body)\n .thenAccept(System.out::println)\n .join();\n }\n}","templateHtml":"$14b7","tokens":[{"marker":"__RP_TOK_0__","paramName":"order_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2023-09-01","path:order_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"csharp","label":"C#","templateCode":"using System.Net.Http;\nusing System.Net.Http.Headers;\n\nvar client = new HttpClient();\nvar request = new HttpRequestMessage\n{\n Method = HttpMethod.Post,\n RequestUri = new Uri(\"https://sandbox-merchant.revolut.com/api/orders/__RP_TOK_0__/cancel\"),\n Headers =\n {\n { \"Authorization\", \"__RP_TOK_1__\" },\n { \"Revolut-Api-Version\", \"__RP_TOK_2__\" },\n }\n};\n\nusing (var response = await client.SendAsync(request))\n{\n response.EnsureSuccessStatusCode();\n var body = await response.Content.ReadAsStringAsync();\n Console.WriteLine(body);\n}","templateHtml":"$14b8","tokens":[{"marker":"__RP_TOK_0__","paramName":"order_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2023-09-01","path:order_id":"123e4567-e89b-12d3-a456-426614174000"}}]},"method":"post","servers":"$62:props:children:0:props:children:props:children:1:props:children:1:props:children:0:0:props:servers","path":"/api/orders/{order_id}/cancel","parameters":["$1495:props:children:0:props:children:1:props:parameters:0","$1495:props:children:0:props:children:1:props:parameters:1","$1495:props:children:0:props:children:1:props:parameters:2"]}],"$L14b9"],"$L14ba","$L14bb"]}]]}] 14a6:["$","$L10d",null,{"security":[{"Api-Key":[]}],"authorization":{"Api-Key":{"type":"apiKey","in":"header","name":"Authorization","description":"Each Merchant API request must contain an authorization header in the following format:\n\n```\n'Authorization: Bearer '\n```\n\nTo use this API, you need to generate API keys from your Revolut Business account. The Secret key is used in the authorization header for all server calls, while the Public key is provided with payment methods at checkout.\n\n:::info\nFor detailed instructions on generating your API keys, see: [Generate API keys](https://developer.revolut.com/docs/guides/merchant/get-started#generate-api-keys).\n:::","descriptionNode":"$L14bc"}}}] 14a7:["$","$L10f",null,{"exampleBlocks":{},"title":"Request body samples","headingAs":"h4"}] 14a8:["$","$L110",null,{"exampleBlocks":{"200":{"application/json":{"variants":[{"key":"example_order_min_params","label":"Example order response with minimal required parameters","rawValue":"$1a:props:children:0:props:children:props:responses:200:content:application/json:examples:example_order_min_params:value","block":"$L14bd"},{"key":"example_order_additional","label":"Example order response with additional parameters","rawValue":"$1a:props:children:0:props:children:props:responses:200:content:application/json:examples:example_order_additional:value","block":"$L14be"},{"key":"example_order_pre_auth","label":"Example order response with pre-authorisation and card payment","rawValue":"$1a:props:children:0:props:children:props:responses:200:content:application/json:examples:example_order_pre_auth:value","block":"$L14bf"},{"key":"example_order_line_items","label":"example_order_line_items","rawValue":"$1a:props:children:0:props:children:props:responses:200:content:application/json:examples:example_order_line_items:value","block":"$L14c0"},{"key":"example_order_subscription","label":"Example order response with subscription data (cycle billing, no usage-based items)","rawValue":"$1a:props:children:0:props:children:props:responses:200:content:application/json:examples:example_order_subscription:value","block":"$L14c1"},{"key":"example_order_shipping","label":"Example order response with shipping details","rawValue":"$1a:props:children:0:props:children:props:responses:200:content:application/json:examples:example_order_shipping:value","block":"$L14c2"},{"key":"example_order_airline","label":"Example order response with additional airline data","rawValue":"$1a:props:children:0:props:children:props:responses:200:content:application/json:examples:example_order_airline:value","block":"$L14c3"},{"key":"example_order_car_rental","label":"Example order response with additional car rental data","rawValue":"$1a:props:children:0:props:children:props:responses:200:content:application/json:examples:example_order_car_rental:value","block":"$L14c4"},{"key":"example_order_crypto","label":"Example order response with additional crypto transaction data","rawValue":"$1a:props:children:0:props:children:props:responses:200:content:application/json:examples:example_order_crypto:value","block":"$L14c5"},{"key":"example_order_marketplace","label":"Example order response with additional marketplace data","rawValue":"$1a:props:children:0:props:children:props:responses:200:content:application/json:examples:example_order_marketplace:value","block":"$L14c6"},{"key":"example_order_event","label":"Example order response with additional event data","rawValue":"$1a:props:children:0:props:children:props:responses:200:content:application/json:examples:example_order_event:value","block":"$L14c7"},{"key":"example_order_lodging","label":"Example order response with additional lodging data","rawValue":"$1a:props:children:0:props:children:props:responses:200:content:application/json:examples:example_order_lodging:value","block":"$L14c8"}],"syncedPropertyName":"$undefined"}},"400":{"application/json":{"variants":[{"key":"example-1","label":"example-1","rawValue":"$1a:props:children:0:props:children:props:responses:400:content:application/json:examples:example-1:value","block":"$L14c9"}],"syncedPropertyName":"$undefined"}},"401":{"application/json":{"variants":[{"key":"default","label":"default","rawValue":"$1a:props:children:0:props:children:props:responses:401:content:application/json:examples:default:value","block":"$L14ca"}],"syncedPropertyName":"$undefined"}},"404":{"application/json":{"variants":[{"key":"default","label":"default","rawValue":"$1a:props:children:0:props:children:props:responses:404:content:application/json:examples:default:value","block":"$L14cb"}],"syncedPropertyName":"$undefined"}}},"headingAs":"h4"}] 14b9:["$","$L10d",null,{"security":[{"Api-Key":[]}],"authorization":{"Api-Key":{"type":"apiKey","in":"header","name":"Authorization","description":"Each Merchant API request must contain an authorization header in the following format:\n\n```\n'Authorization: Bearer '\n```\n\nTo use this API, you need to generate API keys from your Revolut Business account. The Secret key is used in the authorization header for all server calls, while the Public key is provided with payment methods at checkout.\n\n:::info\nFor detailed instructions on generating your API keys, see: [Generate API keys](https://developer.revolut.com/docs/guides/merchant/get-started#generate-api-keys).\n:::","descriptionNode":"$L14cc"}}}] 14ba:["$","$L10f",null,{"exampleBlocks":{},"title":"Request body samples","headingAs":"h4"}] 14bb:["$","$L110",null,{"exampleBlocks":{"200":{"application/json":{"variants":[{"key":"example_order_min","label":"Example order response with minimal required parameters","rawValue":"$1e:props:children:0:props:children:props:responses:200:content:application/json:examples:example_order_min:value","block":"$L14cd"},{"key":"example_order_additional","label":"Example order response with additional parameters","rawValue":"$1e:props:children:0:props:children:props:responses:200:content:application/json:examples:example_order_additional:value","block":"$L14ce"},{"key":"example_order_line_items","label":"example_order_line_items","rawValue":"$1e:props:children:0:props:children:props:responses:200:content:application/json:examples:example_order_line_items:value","block":"$L14cf"},{"key":"example_order_shipping","label":"Example order response with shipping details","rawValue":"$1e:props:children:0:props:children:props:responses:200:content:application/json:examples:example_order_shipping:value","block":"$L14d0"},{"key":"example_order_airline","label":"Example order response with additional airline data","rawValue":"$1e:props:children:0:props:children:props:responses:200:content:application/json:examples:example_order_airline:value","block":"$L14d1"},{"key":"example_order_crypto","label":"Example cancelled order response with additional crypto transaction data","rawValue":"$1e:props:children:0:props:children:props:responses:200:content:application/json:examples:example_order_crypto:value","block":"$L14d2"},{"key":"example_order_marketplace","label":"Example cancelled order response with additional marketplace data","rawValue":"$1e:props:children:0:props:children:props:responses:200:content:application/json:examples:example_order_marketplace:value","block":"$L14d3"},{"key":"example_order_event","label":"Example order response with additional event data","rawValue":"$1e:props:children:0:props:children:props:responses:200:content:application/json:examples:example_order_event:value","block":"$L14d4"},{"key":"example_order_lodging","label":"Example order response with additional lodging data","rawValue":"$1e:props:children:0:props:children:props:responses:200:content:application/json:examples:example_order_lodging:value","block":"$L14d5"}],"syncedPropertyName":"$undefined"}},"400":{"application/json":{"variants":[{"key":"example-1","label":"example-1","rawValue":"$1e:props:children:0:props:children:props:responses:400:content:application/json:examples:example-1:value","block":"$L14d6"}],"syncedPropertyName":"$undefined"}},"401":{"application/json":{"variants":[{"key":"default","label":"default","rawValue":"$1e:props:children:0:props:children:props:responses:401:content:application/json:examples:default:value","block":"$L14d7"}],"syncedPropertyName":"$undefined"}},"404":{"application/json":{"variants":[{"key":"default","label":"default","rawValue":"$1e:props:children:0:props:children:props:responses:404:content:application/json:examples:default:value","block":"$L14d8"}],"syncedPropertyName":"$undefined"}}},"headingAs":"h4"}] 1496:"Retrieve an order" 14a9:"Cancel an order" 11e4:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Permanent order ID used to retrieve, capture, cancel, or refund an order after authorization."}]]}] 11e5:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Temporary ID for the order, which expires when the payment is authorised."}],"\n",["$","p","p-1",{"children":["The order ",["$","code","code-0",{"children":"token"}]," is used for ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/sdks/merchant-web-sdk/initialisation/token-based","target":"_blank","rel":"noreferrer","children":"token-based initialisation"}],", and is returned by the ",["$","code","code-1",{"children":"createOrder"}]," callback in the following payment methods:"]}],"\n",["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["$","a","a-0",{"href":"https://developer.revolut.com/docs/sdks/merchant-web-sdk/payment-methods/embedded-checkout#embedded-checkout-options-interface","target":"_blank","rel":"noreferrer","children":"Embedded Checkout"}]}],"\n",["$","li","li-1",{"children":["$","a","a-0",{"href":"https://developer.revolut.com/docs/sdks/merchant-web-sdk/payment-methods/revolut-pay#widget-payments-revolut-pay-options","target":"_blank","rel":"noreferrer","children":"Revolut Pay"}]}],"\n",["$","li","li-2",{"children":["$","a","a-0",{"href":"https://developer.revolut.com/docs/sdks/merchant-web-sdk/payment-methods/apple-pay-google-pay#payment-request-options-interface","target":"_blank","rel":"noreferrer","children":"Apple Pay and Google Pay"}]}],"\n",["$","li","li-3",{"children":["$","a","a-0",{"href":"https://developer.revolut.com/docs/sdks/merchant-web-sdk/payment-methods/pay-by-bank#pay-by-bank-options-interface","target":"_blank","rel":"noreferrer","children":"Pay by Bank"}]}],"\n"]}]]}] 11e6:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of the order."}]]}] 11e7:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The state of the order in its lifecycle."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"State","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"pending"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Order created, awaiting payment","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"processing"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Payment is being processed","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"authorised"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Payment authorised but not yet captured (for manual capture)","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"completed"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Payment successfully captured and settled","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-4",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"cancelled"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Order was cancelled","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-5",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"failed"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Payment failed","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/reference/order-lifecycle","target":"_blank","rel":"noreferrer","children":"Order and payment lifecycle"}]]}]}]]}]]}] 11e8:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The date and time the order was created."}]]}] 11e9:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The date and time the order was last updated."}]]}] 11ea:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The description of the order."}]]}] 11eb:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The capture mode of the order. ",["$","code","code-0",{"children":"automatic"}]," is used by default."]}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Parameter value","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"automatic"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The order is captured automatically after payment authorisation.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"manual"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The order is not captured automatically. You must manually capture the order later.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information, see ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#capture-order","target":"_blank","rel":"noreferrer","children":"Capture an order"}],"."]}]}]]}]]}] 133d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Permanent order ID used to retrieve, capture, cancel, or refund an order after authorization."}]]}] 133e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Temporary ID for the order, which expires when the payment is authorised."}],"\n",["$","p","p-1",{"children":["The order ",["$","code","code-0",{"children":"token"}]," is used for ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/sdks/merchant-web-sdk/initialisation/token-based","target":"_blank","rel":"noreferrer","children":"token-based initialisation"}],", and is returned by the ",["$","code","code-1",{"children":"createOrder"}]," callback in the following payment methods:"]}],"\n",["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["$","a","a-0",{"href":"https://developer.revolut.com/docs/sdks/merchant-web-sdk/payment-methods/embedded-checkout#embedded-checkout-options-interface","target":"_blank","rel":"noreferrer","children":"Embedded Checkout"}]}],"\n",["$","li","li-1",{"children":["$","a","a-0",{"href":"https://developer.revolut.com/docs/sdks/merchant-web-sdk/payment-methods/revolut-pay#widget-payments-revolut-pay-options","target":"_blank","rel":"noreferrer","children":"Revolut Pay"}]}],"\n",["$","li","li-2",{"children":["$","a","a-0",{"href":"https://developer.revolut.com/docs/sdks/merchant-web-sdk/payment-methods/apple-pay-google-pay#payment-request-options-interface","target":"_blank","rel":"noreferrer","children":"Apple Pay and Google Pay"}]}],"\n",["$","li","li-3",{"children":["$","a","a-0",{"href":"https://developer.revolut.com/docs/sdks/merchant-web-sdk/payment-methods/pay-by-bank#pay-by-bank-options-interface","target":"_blank","rel":"noreferrer","children":"Pay by Bank"}]}],"\n"]}]]}] 133f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of the order."}]]}] 1340:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The state of the order in its lifecycle."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"State","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"pending"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Order created, awaiting payment","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"processing"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Payment is being processed","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"authorised"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Payment authorised but not yet captured (for manual capture)","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"completed"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Payment successfully captured and settled","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-4",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"cancelled"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Order was cancelled","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-5",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"failed"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Payment failed","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/reference/order-lifecycle","target":"_blank","rel":"noreferrer","children":"Order and payment lifecycle"}]]}]}]]}]]}] 1341:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The date and time the order was created."}]]}] 1342:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The date and time the order was last updated."}]]}] 1343:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The description of the order."}]]}] 1344:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The capture mode of the order. ",["$","code","code-0",{"children":"automatic"}]," is used by default."]}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Parameter value","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"automatic"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The order is captured automatically after payment authorisation.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"manual"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The order is not captured automatically. You must manually capture the order later.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information, see ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#capture-order","target":"_blank","rel":"noreferrer","children":"Capture an order"}],"."]}]}]]}]]}] 11ec:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The type of authorisation for the order. Used with manual capture mode. If omitted, ",["$","code","code-0",{"children":"final"}]," is used by default."]}],"\n",["$","h1","h1-0",{"children":"Pre-authorisation"}],"\n",["$","p","p-1",{"children":"Pre-authorisation allows you to reserve funds on a customer's card without immediately capturing them. This is useful for scenarios like:"}],"\n",["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":"Hotel bookings where the final amount may vary"}],"\n",["$","li","li-1",{"children":"Car rentals where additional charges may apply"}],"\n",["$","li","li-2",{"children":"Deposits that need to be held temporarily"}],"\n"]}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Parameter value","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"final"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Standard authorisation for immediate or near-immediate capture.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"pre_authorisation"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Reserve funds for later capture, used with manual capture mode.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["Pre-authorisation must be used with ",["$","code","code-0",{"children":"capture_mode: manual"}],". For more information, see ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#capture-order","target":"_blank","rel":"noreferrer","children":"Capture an order"}],"."]}]}]]}]]}] 11ee:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["Automatic cancellation period for uncaptured orders, specified in ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_8601","target":"_blank","rel":"noreferrer","children":"ISO 8601"}]," format."]}],"\n",["$","p","p-1",{"children":["After this period, the authorised payment is automatically cancelled and the order is cancelled. Maximum: 7 days = ",["$","code","code-0",{"children":"P7D"}],"."]}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"The following limitations apply:"}],["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["\n",["$","p","p-0",{"children":"Cannot be a negative value."}],"\n"]}],"\n",["$","li","li-1",{"children":["\n",["$","p","p-0",{"children":"Cannot be updated if the new value is less than or equal to the elapsed time since authorisation."}],"\n",["$","p","p-1",{"children":["$","strong","strong-0",{"children":"Failing scenario:"}]}],"\n",["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":"Original value: 7 days"}],"\n",["$","li","li-1",{"children":"Time since authorisation: 3 days"}],"\n",["$","li","li-2",{"children":"Update value: 2 days"}],"\n"]}],"\n",["$","p","p-2",{"children":"In this scenario, an error is returned."}],"\n",["$","p","p-3",{"children":["$","strong","strong-0",{"children":"Successful scenario:"}]}],"\n",["$","ul","ul-1",{"children":["\n",["$","li","li-0",{"children":"Original value: 7 days"}],"\n",["$","li","li-1",{"children":"Time since authorisation: 3 days"}],"\n",["$","li","li-2",{"children":"Update value: 4 days"}],"\n"]}],"\n",["$","p","p-4",{"children":"In this scenario, the parameter can be updated."}],"\n"]}],"\n",["$","li","li-2",{"children":["\n",["$","p","p-0",{"children":"Cannot be updated if cancellation is ≤ 30 minutes away."}],"\n",["$","p","p-1",{"children":["$","strong","strong-0",{"children":"Failing scenario:"}]}],"\n",["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":"Original value: 12 hours"}],"\n",["$","li","li-1",{"children":"Time since authorisation: 11 hours 40 minutes"}],"\n"]}],"\n",["$","p","p-2",{"children":"In this scenario, an error is returned."}],"\n",["$","p","p-3",{"children":["$","strong","strong-0",{"children":"Successful scenario:"}]}],"\n",["$","ul","ul-1",{"children":["\n",["$","li","li-0",{"children":"Original value: 12 hours"}],"\n",["$","li","li-1",{"children":"Time since authorisation: 11 hours 20 minutes"}],"\n"]}],"\n",["$","p","p-4",{"children":"In this scenario, the parameter can be updated."}],"\n"]}],"\n"]}]]}]]}]]}] 11ef:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The order total expressed in minor currency units, according to the ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_4217","target":"_blank","rel":"noreferrer","children":"ISO 4217 standard"}],". For example, ",["$","code","code-0",{"children":"7034"}]," in ",["$","code","code-1",{"children":"EUR"}]," corresponds to €70.34."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["Conversion between major and minor units varies by currency. For instance, ",["$","code","code-0",{"children":"100"}]," minor units equal £1.00 in ",["$","code","code-1",{"children":"GBP"}],", whereas in ",["$","code","code-2",{"children":"ISK"}]," they represent 100 units. For more details, see the ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_4217","target":"_blank","rel":"noreferrer","children":"ISO 4217 standard"}],"."]}],"\n",["$","li","li-1",{"children":["If ",["$","code","code-0",{"children":"line_items"}]," are provided, the order ",["$","code","code-1",{"children":"amount"}]," must equal the sum of all line items' ",["$","code","code-2",{"children":"total_amount"}],"."]}],"\n",["$","li","li-2",{"children":["For card payments with a non-zero amount, the order ",["$","code","code-0",{"children":"amount"}]," must be at least ",["$","strong","strong-0",{"children":"$$0.005"}]," (or equivalent in different currencies, calculated using Revolut's exchange rate on the payment date). Otherwise, card payments can't be performed."]}],"\n"]}]}]]}]]}] 11f0:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The amount not yet paid for a given order (in minor currency units). For example, ",["$","code","code-0",{"children":"7034"}]," represents €70.34."]}],"\n",["$","p","p-1",{"children":["The value in this field may differ from ",["$","code","code-0",{"children":"amount"}]," if there are partial payments associated with the order."]}]]}] 11f1:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The amount that was refunded from the order (in minor currency units). For example, ",["$","code","code-0",{"children":"7034"}]," represents €70.34."]}],"\n",["$","p","p-1",{"children":["This applies to orders that have been refunded (i.e., orders of type ",["$","code","code-0",{"children":"payment"}]," that have a related ",["$","code","code-1",{"children":"refund"}]," order)."]}]]}] 11f2:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":[["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_4217","target":"_blank","rel":"noreferrer","children":"ISO 4217"}]," currency code in upper case."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information about the supported currencies, see: ",["$","a","a-0",{"href":"https://help.revolut.com/business/help/merchant-accounts/payments/in-which-currencies-can-i-accept-payments/","target":"_blank","rel":"noreferrer","children":"Help Center"}],"."]}]}]]}]]}] 11f3:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":[["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_4217","target":"_blank","rel":"noreferrer","children":"ISO 4217"}]," currency code in upper case."]}],"\n",["$","p","p-1",{"children":["If ",["$","code","code-0",{"children":"settlement_currency"}]," is different from the value of ",["$","code","code-1",{"children":"currency"}],", the money will be exchanged when the amount is settled to your merchant account. In case of a refund or chargeback, the money will be exchanged to the order's initial ",["$","code","code-2",{"children":"currency"}],"."]}],"\n",["$","p","p-2",{"children":["If ",["$","code","code-0",{"children":"settlement_currency"}]," is not specified, this value is taken from ",["$","code","code-1",{"children":"currency"}],"."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information about the supported currencies, see: ",["$","a","a-0",{"href":"https://help.revolut.com/business/help/merchant-accounts/payments/in-which-currencies-can-i-accept-payments/","target":"_blank","rel":"noreferrer","children":"Help Center"}],"."]}]}]]}]]}] 11f5:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Permanent ID of a customer used to retrieve, update, delete a customer. This ID can also be used to link customer to an order."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":"If you provide the customer's ID during order creation, no other customer data is required, they will be parsed automatically from the referenced customer object."}]}]]}]]}] 11f6:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The full name of the customer."}]]}] 11f7:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The phone number of the customer in ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/E.164","target":"_blank","rel":"noreferrer","children":"E.164 format"}],"."]}]]}] 11f8:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The email address of the customer."}]]}] 11f9:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The birth date of the customer."}]]}] 11fa:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object containing information about a customer."}],"\n",["$","p","p-1",{"children":["If you have it, we strongly advise providing at least either ",["$","code","code-0",{"children":"id"}],", ",["$","code","code-1",{"children":"phone"}],", or ",["$","code","code-2",{"children":"email"}],"."]}],"\n",["$","p","p-2",{"children":["Using the ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#tag-customers","target":"_blank","rel":"noreferrer","children":"Customers operations"}],", you can manage customer instances."]}],"\n",["$","p","p-3",{"children":"The following behaviours apply to different use cases:"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Use case","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"API behavior","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":"Existing customer","className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["If ",["$","code","code-0",{"children":"id"}]," was provided, we ignore other customer details and associate the customer with the order.",["$","br","br-0",{}],["$","br","br-1",{}],"If either ",["$","code","code-1",{"children":"email"}],", ",["$","code","code-2",{"children":"phone"}],", or ",["$","code","code-3",{"children":"full_name"}]," was provided (without an existing customer's ",["$","code","code-4",{"children":"id"}],"), we always create a new customer, irrespective of another, existing customer object having the same details."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":"New customer","className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["If either ",["$","code","code-0",{"children":"email"}],", ",["$","code","code-1",{"children":"phone"}],", or ",["$","code","code-2",{"children":"full_name"}]," was provided, we create a new customer, irrespective of another customer object having the same details. ",["$","br","br-0",{}],["$","br","br-1",{}],"If ",["$","code","code-3",{"children":"id"}]," of a non-existent customer was provided, we return a ",["$","code","code-4",{"children":"404"}]," error, irrespective of other details provided."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["To avoid unintentional duplication of customer records, search for an existing customer by email or phone using the ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#retrieve-customer-list","target":"_blank","rel":"noreferrer","children":"List customers"}]," endpoint first, then provide ",["$","code","code-0",{"children":"customer.id"}]," in the order."]}]}]]}]]}] 11fb:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The ID of the payment."}]]}] 11fc:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The status of the payment."}]]}] 11fd:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The reason for a ",["$","code","code-0",{"children":"failed"}]," or ",["$","code","code-1",{"children":"declined"}]," payment."]}],"\n",["$","p","p-1",{"children":["A failed or declined payment can result from multiple reasons. To learn more, check our ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/reference/error-codes/decline-reasons","target":"_blank","rel":"noreferrer","children":"failure reasons"}],"."]}]]}] 11fe:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The reason for a ",["$","code","code-0",{"children":"failed"}]," or ",["$","code","code-1",{"children":"declined"}]," payment, sent by the financial institution processing the payment."]}]]}] 11ff:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The date and time the payment was created."}]]}] 1200:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The date and time the payment was last updated."}]]}] 1201:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Temporary token of the payment used to fetch the reward offer during checkout and link user registrations to the given offers."}],"\n",["$","p","p-1",{"children":"The token is only valid for a limited time."}]]}] 1202:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The payment amount in minor units (e.g., cents). The value of this field depends on the payment type and state."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Payment type","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"State","className":"eowryt6","ref":"$undefined"}],["$","th","th-2",{"children":"Amount value","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":"Standard payment","className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Any","className":"eowryt7","ref":"$undefined"}],["$","td","td-2",{"children":"Total payment amount","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":"Pre-authorised payment","className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["$","code","code-0",{"children":"authorisation_started"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-2",{"children":"New amount being authorised (during increment processing)","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":"Pre-authorised payment","className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["$","code","code-0",{"children":"authorised"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-2",{"children":["Currently authorised amount (equals ",["$","code","code-0",{"children":"authorised_amount"}],")"],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For pre-authorised payments, see the ",["$","code","code-0",{"children":"authorised_amount"}]," field for tracking the currently authorised amount separately."]}]}]]}]]}] 1203:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The currently authorised amount for this payment (in minor units)."}],"\n",["$","p","p-1",{"children":"For pre-authorised payments with incremental authorization:"}],"\n",["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["Initially equals the ",["$","code","code-0",{"children":"amount"}]," field"]}],"\n",["$","li","li-1",{"children":"Remains unchanged during increment processing"}],"\n",["$","li","li-2",{"children":"Updates to new amount upon successful increment"}],"\n",["$","li","li-3",{"children":"Remains at original amount if increment is declined"}],"\n"]}],"\n",["$","p","p-2",{"children":["For standard payments, this field may not be present or will equal the ",["$","code","code-0",{"children":"amount"}]," field."]}]]}] 1204:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":[["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_4217","target":"_blank","rel":"noreferrer","children":"ISO 4217"}]," currency code in upper case."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information about the supported currencies, see: ",["$","a","a-0",{"href":"https://help.revolut.com/business/help/merchant-accounts/payments/in-which-currencies-can-i-accept-payments/","target":"_blank","rel":"noreferrer","children":"Help Center"}],"."]}]}]]}]]}] 1205:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The amount of the settled payment (minor currency unit). For example, ",["$","code","code-0",{"children":"7034"}]," stands for €70.34."]}]]}] 1206:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The currency of the settled payment. ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_4217","target":"_blank","rel":"noreferrer","children":"ISO 4217"}]," currency code in upper case."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information about the supported currencies, see: ",["$","a","a-0",{"href":"https://help.revolut.com/business/help/merchant-accounts/payments/in-which-currencies-can-i-accept-payments/","target":"_blank","rel":"noreferrer","children":"Help Center"}],"."]}]}]]}]]}] 1207:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"ID of the saved payment method."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["The ",["$","code","code-0",{"children":"id"}]," parameter is only returned when the payment method is saved."]}]}]]}]]}] 1208:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of payment method used to pay for the order."}],"\n",["$","p","p-1",{"children":"Available values:"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":["Payment method ",["$","code","code-0",{"children":"type"}]],"className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"apple_pay"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using Apple Pay.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"card"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using their credit or debit card.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"google_pay"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using Google Pay.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"revolut_pay_card"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order via Revolut Pay using their credit or debit card.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-4",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"revolut_pay_account"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order via Revolut Pay using their Revolut account.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-5",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"sepa_direct_debit"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using SEPA Direct Debit.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 1209:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of the card."}]]}] 120a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of card funding."}]]}] 120b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The 2-letter country code of the country where the card was issued."}]]}] 120c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The BIN of the card."}]]}] 120d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The last four digits of the card number."}]]}] 120e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The expiry date of the card in the format of MM/YY."}]]}] 120f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The name of the cardholder."}]]}] 1210:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The Electronic Commerce Indicator (ECI) value corresponds to the authentication result and indicates the level of security used when the payment information was provided."}]]}] 1211:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The result of 3D Secure check."}]]}] 1212:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The 3D Secure version."}]]}] 1213:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The details of the 3D Secure check. Only for orders with successful payments."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":"Not returned for Apple Pay and Google Pay payments."}]}]]}]]}] 1214:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The result of CVV verification."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Parameter value","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"match"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"CVV matches the card's CVV","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"not_match"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"CVV does not match the card's CVV","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"incorrect"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"CVV format is incorrect for this type of card","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"not_processed"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"CVV verification was not performed","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 1215:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The result of address verification."}]]}] 1216:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The result of postcode verification."}]]}] 1217:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The result of cardholder verification."}]]}] 1218:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The details of the check for card payment. Only for orders with successful payments."}]]}] 1219:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The authorisation code (or auth code) is a short, alphanumeric code returned by the cardholder's issuing bank to the merchant's terminal or payment gateway."}],"\n",["$","p","p-1",{"children":"It serves as confirmation that the transaction has been approved and funds are available."}]]}] 121a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Acquirer Reference Number (ARN) of the payment."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":"Only returned for refund payments made by a card."}]}]]}]]}] 121b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The date and time by which the payment must be captured."}],"\n",["$","p","p-1",{"children":"After this deadline, the authorised funds may be automatically released by the card issuer."}]]}] 121c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The hardware identifier of the Revolut Terminal device used to process the payment."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":"Only present for card-present transactions processed via Revolut Terminal."}]}]]}]]}] 121e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A unique identifier for a payment method, always 44 characters long. This fingerprint can be used to uniquely identify various payment methods."}],"\n",["$","h1","h1-0",{"children":"Fingerprint generation"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Payment method","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","strong","strong-0",{"children":"All payment methods"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"A fingerprint is generated for all payment methods, including cards, Revolut Pay (card, account-to-account payments), Apple Pay, and Google Pay.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","strong","strong-0",{"children":"Cards (Revolut Pay & Card Gateway)"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"For cards, the fingerprint is based on the PAN. Cards processed via Revolut Pay and our card gateway will share the same fingerprint. Renewed cards (new expiry/CVV) retain the same fingerprint for efficient blocking.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","strong","strong-0",{"children":"Apple Pay & Google Pay"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Since Apple Pay and Google Pay provide us Device PANs (DPAN), the fingerprint is based on the DPAN provided by Apple/Google, not the connected card's PAN. This means that a new DPAN (and fingerprint) is generated for cards in case they are re-added to the customer's digital wallet, or added to different devices.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}],"\n",["$","h4","h4-0",{"children":"Detecting duplicate payment methods"}],"\n",["$","p","p-1",{"children":"Fingerprints are a valuable tool for detecting duplicate payment methods by identifying if a payment method has been seen before. This capability, in turn, helps in preventing various types of misuse (e.g., exploitation of free trials, or association with known problematic accounts, which can be a form of fraud). To effectively use fingerprints for this purpose, you will need to create and maintain your own lists (e.g., blocklists of known problematic fingerprints, allowlists for trusted customers, or tracking frequently used fingerprints)."}],"\n",["$","p","p-2",{"children":"The ideal way to utilise fingerprints is by combining them with a manual capture process. While automatic capture with subsequent refunds for problematic payments is possible, manual capture based on fingerprint validation is recommended."}],"\n",["$","p","p-3",{"children":"During your manual capture workflow, after a payment was authorised:"}],"\n",["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":"Check the fingerprint status by comparing it against your maintained lists and internal business rules."}],"\n",["$","li","li-1",{"children":["If you decide to proceed with the payment (e.g., the fingerprint is not on a blocklist, or matches a trusted customer's previous payment method): ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#capture-order","target":"_blank","rel":"noreferrer","children":"Capture the order"}],"."]}],"\n",["$","li","li-2",{"children":["If you decide not to proceed with the payment (e.g., the fingerprint matches a known fraudulent fingerprint, or exhibits suspicious patterns): ","$L14d9","."]}],"\n"]}]]}] 121f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The Network Transaction ID (NTI) is a unique identifier assigned by the card scheme (e.g., Visa or Mastercard) to a card transaction."}],"\n",["$","p","p-1",{"children":"It can be used to trace the transaction across the payment network, link recurring or instalment payments to the original authorisation, and support dispute resolution."}]]}] 1220:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object containing details of a card used via Apple Pay."}]]}] 1221:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"ID of the saved payment method."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["The ",["$","code","code-0",{"children":"id"}]," parameter is only returned when the payment method is saved."]}]}]]}]]}] 1222:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of payment method used to pay for the order."}],"\n",["$","p","p-1",{"children":"Available values:"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":["Payment method ",["$","code","code-0",{"children":"type"}]],"className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"apple_pay"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using Apple Pay.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"card"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using their credit or debit card.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"google_pay"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using Google Pay.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"revolut_pay_card"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order via Revolut Pay using their credit or debit card.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-4",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"revolut_pay_account"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order via Revolut Pay using their Revolut account.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-5",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"sepa_direct_debit"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using SEPA Direct Debit.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 1223:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of the card."}]]}] 1224:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of card funding."}]]}] 1225:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The 2-letter country code of the country where the card was issued."}]]}] 1226:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The BIN of the card."}]]}] 1227:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The last four digits of the card number."}]]}] 1228:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The expiry date of the card in the format of MM/YY."}]]}] 1229:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The name of the cardholder."}]]}] 122a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The details of the check for card payment. Only for orders with successful payments."}]]}] 122b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The authorisation code (or auth code) is a short, alphanumeric code returned by the cardholder's issuing bank to the merchant's terminal or payment gateway."}],"\n",["$","p","p-1",{"children":"It serves as confirmation that the transaction has been approved and funds are available."}]]}] 122c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Acquirer Reference Number (ARN) of the payment."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":"Only returned for refund payments made by a card."}]}]]}]]}] 122d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The date and time by which the payment must be captured."}],"\n",["$","p","p-1",{"children":"After this deadline, the authorised funds may be automatically released by the card issuer."}]]}] 122e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The hardware identifier of the Revolut Terminal device used to process the payment."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":"Only present for card-present transactions processed via Revolut Terminal."}]}]]}]]}] 1230:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A unique identifier for a payment method, always 44 characters long. This fingerprint can be used to uniquely identify various payment methods."}],"\n",["$","h1","h1-0",{"children":"Fingerprint generation"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Payment method","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","strong","strong-0",{"children":"All payment methods"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"A fingerprint is generated for all payment methods, including cards, Revolut Pay (card, account-to-account payments), Apple Pay, and Google Pay.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","strong","strong-0",{"children":"Cards (Revolut Pay & Card Gateway)"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"For cards, the fingerprint is based on the PAN. Cards processed via Revolut Pay and our card gateway will share the same fingerprint. Renewed cards (new expiry/CVV) retain the same fingerprint for efficient blocking.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","strong","strong-0",{"children":"Apple Pay & Google Pay"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Since Apple Pay and Google Pay provide us Device PANs (DPAN), the fingerprint is based on the DPAN provided by Apple/Google, not the connected card's PAN. This means that a new DPAN (and fingerprint) is generated for cards in case they are re-added to the customer's digital wallet, or added to different devices.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}],"\n",["$","h4","h4-0",{"children":"Detecting duplicate payment methods"}],"\n",["$","p","p-1",{"children":"Fingerprints are a valuable tool for detecting duplicate payment methods by identifying if a payment method has been seen before. This capability, in turn, helps in preventing various types of misuse (e.g., exploitation of free trials, or association with known problematic accounts, which can be a form of fraud). To effectively use fingerprints for this purpose, you will need to create and maintain your own lists (e.g., blocklists of known problematic fingerprints, allowlists for trusted customers, or tracking frequently used fingerprints)."}],"\n",["$","p","p-2",{"children":"The ideal way to utilise fingerprints is by combining them with a manual capture process. While automatic capture with subsequent refunds for problematic payments is possible, manual capture based on fingerprint validation is recommended."}],"\n",["$","p","p-3",{"children":"During your manual capture workflow, after a payment was authorised:"}],"\n",["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":"Check the fingerprint status by comparing it against your maintained lists and internal business rules."}],"\n",["$","li","li-1",{"children":["If you decide to proceed with the payment (e.g., the fingerprint is not on a blocklist, or matches a trusted customer's previous payment method): ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#capture-order","target":"_blank","rel":"noreferrer","children":"Capture the order"}],"."]}],"\n",["$","li","li-2",{"children":["If you decide not to proceed with the payment (e.g., the fingerprint matches a known fraudulent fingerprint, or exhibits suspicious patterns): ","$L14da","."]}],"\n"]}]]}] 1231:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The Network Transaction ID (NTI) is a unique identifier assigned by the card scheme (e.g., Visa or Mastercard) to a card transaction."}],"\n",["$","p","p-1",{"children":"It can be used to trace the transaction across the payment network, link recurring or instalment payments to the original authorisation, and support dispute resolution."}]]}] 1232:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object containing details of the card used for the payment."}]]}] 1233:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"ID of the saved payment method."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["The ",["$","code","code-0",{"children":"id"}]," parameter is only returned when the payment method is saved."]}]}]]}]]}] 1234:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of payment method used to pay for the order."}],"\n",["$","p","p-1",{"children":"Available values:"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":["Payment method ",["$","code","code-0",{"children":"type"}]],"className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"apple_pay"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using Apple Pay.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"card"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using their credit or debit card.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"google_pay"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using Google Pay.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"revolut_pay_card"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order via Revolut Pay using their credit or debit card.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-4",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"revolut_pay_account"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order via Revolut Pay using their Revolut account.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-5",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"sepa_direct_debit"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using SEPA Direct Debit.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 1235:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of the card."}]]}] 1236:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of card funding."}]]}] 1237:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The 2-letter country code of the country where the card was issued."}]]}] 1238:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The BIN of the card."}]]}] 1239:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The last four digits of the card number."}]]}] 123a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The expiry date of the card in the format of MM/YY."}]]}] 123b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The name of the cardholder."}]]}] 123c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The details of the check for card payment. Only for orders with successful payments."}]]}] 123d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The authorisation code (or auth code) is a short, alphanumeric code returned by the cardholder's issuing bank to the merchant's terminal or payment gateway."}],"\n",["$","p","p-1",{"children":"It serves as confirmation that the transaction has been approved and funds are available."}]]}] 123e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Acquirer Reference Number (ARN) of the payment."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":"Only returned for refund payments made by a card."}]}]]}]]}] 123f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The date and time by which the payment must be captured."}],"\n",["$","p","p-1",{"children":"After this deadline, the authorised funds may be automatically released by the card issuer."}]]}] 1240:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The hardware identifier of the Revolut Terminal device used to process the payment."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":"Only present for card-present transactions processed via Revolut Terminal."}]}]]}]]}] 1242:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A unique identifier for a payment method, always 44 characters long. This fingerprint can be used to uniquely identify various payment methods."}],"\n",["$","h1","h1-0",{"children":"Fingerprint generation"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Payment method","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","strong","strong-0",{"children":"All payment methods"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"A fingerprint is generated for all payment methods, including cards, Revolut Pay (card, account-to-account payments), Apple Pay, and Google Pay.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","strong","strong-0",{"children":"Cards (Revolut Pay & Card Gateway)"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"For cards, the fingerprint is based on the PAN. Cards processed via Revolut Pay and our card gateway will share the same fingerprint. Renewed cards (new expiry/CVV) retain the same fingerprint for efficient blocking.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","strong","strong-0",{"children":"Apple Pay & Google Pay"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Since Apple Pay and Google Pay provide us Device PANs (DPAN), the fingerprint is based on the DPAN provided by Apple/Google, not the connected card's PAN. This means that a new DPAN (and fingerprint) is generated for cards in case they are re-added to the customer's digital wallet, or added to different devices.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}],"\n",["$","h4","h4-0",{"children":"Detecting duplicate payment methods"}],"\n",["$","p","p-1",{"children":"Fingerprints are a valuable tool for detecting duplicate payment methods by identifying if a payment method has been seen before. This capability, in turn, helps in preventing various types of misuse (e.g., exploitation of free trials, or association with known problematic accounts, which can be a form of fraud). To effectively use fingerprints for this purpose, you will need to create and maintain your own lists (e.g., blocklists of known problematic fingerprints, allowlists for trusted customers, or tracking frequently used fingerprints)."}],"\n",["$","p","p-2",{"children":"The ideal way to utilise fingerprints is by combining them with a manual capture process. While automatic capture with subsequent refunds for problematic payments is possible, manual capture based on fingerprint validation is recommended."}],"\n",["$","p","p-3",{"children":"During your manual capture workflow, after a payment was authorised:"}],"\n",["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":"Check the fingerprint status by comparing it against your maintained lists and internal business rules."}],"\n",["$","li","li-1",{"children":["If you decide to proceed with the payment (e.g., the fingerprint is not on a blocklist, or matches a trusted customer's previous payment method): ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#capture-order","target":"_blank","rel":"noreferrer","children":"Capture the order"}],"."]}],"\n",["$","li","li-2",{"children":["If you decide not to proceed with the payment (e.g., the fingerprint matches a known fraudulent fingerprint, or exhibits suspicious patterns): ","$L14db","."]}],"\n"]}]]}] 1243:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The Network Transaction ID (NTI) is a unique identifier assigned by the card scheme (e.g., Visa or Mastercard) to a card transaction."}],"\n",["$","p","p-1",{"children":"It can be used to trace the transaction across the payment network, link recurring or instalment payments to the original authorisation, and support dispute resolution."}]]}] 1244:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object containing details of a card used via Google Pay."}]]}] 1245:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"ID of the saved payment method."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["The ",["$","code","code-0",{"children":"id"}]," parameter is only returned when the payment method is saved."]}]}]]}]]}] 1246:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of payment method used to pay for the order."}],"\n",["$","p","p-1",{"children":"Available values:"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":["Payment method ",["$","code","code-0",{"children":"type"}]],"className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"apple_pay"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using Apple Pay.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"card"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using their credit or debit card.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"google_pay"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using Google Pay.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"revolut_pay_card"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order via Revolut Pay using their credit or debit card.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-4",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"revolut_pay_account"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order via Revolut Pay using their Revolut account.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-5",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"sepa_direct_debit"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using SEPA Direct Debit.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 1247:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of the card."}]]}] 1248:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of card funding."}]]}] 1249:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The 2-letter country code of the country where the card was issued."}]]}] 124a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The BIN of the card."}]]}] 124b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The last four digits of the card number."}]]}] 124c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The expiry date of the card in the format of MM/YY."}]]}] 124d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The name of the cardholder."}]]}] 124e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The details of the check for card payment. Only for orders with successful payments."}]]}] 124f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The authorisation code (or auth code) is a short, alphanumeric code returned by the cardholder's issuing bank to the merchant's terminal or payment gateway."}],"\n",["$","p","p-1",{"children":"It serves as confirmation that the transaction has been approved and funds are available."}]]}] 1250:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Acquirer Reference Number (ARN) of the payment."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":"Only returned for refund payments made by a card."}]}]]}]]}] 1251:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The date and time by which the payment must be captured."}],"\n",["$","p","p-1",{"children":"After this deadline, the authorised funds may be automatically released by the card issuer."}]]}] 1252:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The hardware identifier of the Revolut Terminal device used to process the payment."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":"Only present for card-present transactions processed via Revolut Terminal."}]}]]}]]}] 1254:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A unique identifier for a payment method, always 44 characters long. This fingerprint can be used to uniquely identify various payment methods."}],"\n",["$","h1","h1-0",{"children":"Fingerprint generation"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Payment method","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","strong","strong-0",{"children":"All payment methods"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"A fingerprint is generated for all payment methods, including cards, Revolut Pay (card, account-to-account payments), Apple Pay, and Google Pay.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","strong","strong-0",{"children":"Cards (Revolut Pay & Card Gateway)"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"For cards, the fingerprint is based on the PAN. Cards processed via Revolut Pay and our card gateway will share the same fingerprint. Renewed cards (new expiry/CVV) retain the same fingerprint for efficient blocking.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","strong","strong-0",{"children":"Apple Pay & Google Pay"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Since Apple Pay and Google Pay provide us Device PANs (DPAN), the fingerprint is based on the DPAN provided by Apple/Google, not the connected card's PAN. This means that a new DPAN (and fingerprint) is generated for cards in case they are re-added to the customer's digital wallet, or added to different devices.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}],"\n",["$","h4","h4-0",{"children":"Detecting duplicate payment methods"}],"\n",["$","p","p-1",{"children":"Fingerprints are a valuable tool for detecting duplicate payment methods by identifying if a payment method has been seen before. This capability, in turn, helps in preventing various types of misuse (e.g., exploitation of free trials, or association with known problematic accounts, which can be a form of fraud). To effectively use fingerprints for this purpose, you will need to create and maintain your own lists (e.g., blocklists of known problematic fingerprints, allowlists for trusted customers, or tracking frequently used fingerprints)."}],"\n",["$","p","p-2",{"children":"The ideal way to utilise fingerprints is by combining them with a manual capture process. While automatic capture with subsequent refunds for problematic payments is possible, manual capture based on fingerprint validation is recommended."}],"\n",["$","p","p-3",{"children":"During your manual capture workflow, after a payment was authorised:"}],"\n",["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":"Check the fingerprint status by comparing it against your maintained lists and internal business rules."}],"\n",["$","li","li-1",{"children":["If you decide to proceed with the payment (e.g., the fingerprint is not on a blocklist, or matches a trusted customer's previous payment method): ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#capture-order","target":"_blank","rel":"noreferrer","children":"Capture the order"}],"."]}],"\n",["$","li","li-2",{"children":["If you decide not to proceed with the payment (e.g., the fingerprint matches a known fraudulent fingerprint, or exhibits suspicious patterns): ","$L14dc","."]}],"\n"]}]]}] 1255:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The Network Transaction ID (NTI) is a unique identifier assigned by the card scheme (e.g., Visa or Mastercard) to a card transaction."}],"\n",["$","p","p-1",{"children":"It can be used to trace the transaction across the payment network, link recurring or instalment payments to the original authorisation, and support dispute resolution."}]]}] 1256:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object containing details of a card used via Revolut Pay."}]]}] 1257:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"ID of the saved payment method."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["The ",["$","code","code-0",{"children":"id"}]," parameter is only returned when the payment method is saved."]}]}]]}]]}] 1258:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of payment method used to pay for the order."}],"\n",["$","p","p-1",{"children":"Available values:"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":["Payment method ",["$","code","code-0",{"children":"type"}]],"className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"apple_pay"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using Apple Pay.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"card"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using their credit or debit card.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"google_pay"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using Google Pay.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"revolut_pay_card"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order via Revolut Pay using their credit or debit card.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-4",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"revolut_pay_account"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order via Revolut Pay using their Revolut account.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-5",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"sepa_direct_debit"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using SEPA Direct Debit.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 125a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A unique identifier for a payment method, always 44 characters long. This fingerprint can be used to uniquely identify various payment methods."}],"\n",["$","h1","h1-0",{"children":"Fingerprint generation"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Payment method","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","strong","strong-0",{"children":"All payment methods"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"A fingerprint is generated for all payment methods, including cards, Revolut Pay (card, account-to-account payments), Apple Pay, and Google Pay.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","strong","strong-0",{"children":"Cards (Revolut Pay & Card Gateway)"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"For cards, the fingerprint is based on the PAN. Cards processed via Revolut Pay and our card gateway will share the same fingerprint. Renewed cards (new expiry/CVV) retain the same fingerprint for efficient blocking.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","strong","strong-0",{"children":"Apple Pay & Google Pay"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Since Apple Pay and Google Pay provide us Device PANs (DPAN), the fingerprint is based on the DPAN provided by Apple/Google, not the connected card's PAN. This means that a new DPAN (and fingerprint) is generated for cards in case they are re-added to the customer's digital wallet, or added to different devices.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}],"\n",["$","h4","h4-0",{"children":"Detecting duplicate payment methods"}],"\n",["$","p","p-1",{"children":"Fingerprints are a valuable tool for detecting duplicate payment methods by identifying if a payment method has been seen before. This capability, in turn, helps in preventing various types of misuse (e.g., exploitation of free trials, or association with known problematic accounts, which can be a form of fraud). To effectively use fingerprints for this purpose, you will need to create and maintain your own lists (e.g., blocklists of known problematic fingerprints, allowlists for trusted customers, or tracking frequently used fingerprints)."}],"\n",["$","p","p-2",{"children":"The ideal way to utilise fingerprints is by combining them with a manual capture process. While automatic capture with subsequent refunds for problematic payments is possible, manual capture based on fingerprint validation is recommended."}],"\n",["$","p","p-3",{"children":"During your manual capture workflow, after a payment was authorised:"}],"\n",["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":"Check the fingerprint status by comparing it against your maintained lists and internal business rules."}],"\n",["$","li","li-1",{"children":["If you decide to proceed with the payment (e.g., the fingerprint is not on a blocklist, or matches a trusted customer's previous payment method): ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#capture-order","target":"_blank","rel":"noreferrer","children":"Capture the order"}],"."]}],"\n",["$","li","li-2",{"children":["If you decide not to proceed with the payment (e.g., the fingerprint matches a known fraudulent fingerprint, or exhibits suspicious patterns): ","$L14dd","."]}],"\n"]}]]}] 125b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"ID of the saved payment method."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["The ",["$","code","code-0",{"children":"id"}]," parameter is only returned when the payment method is saved for the merchant."]}]}]]}]]}] 125c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of payment method used to pay for the order."}],"\n",["$","p","p-1",{"children":"Available values:"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":["Payment method ",["$","code","code-0",{"children":"type"}]],"className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"apple_pay"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using Apple Pay.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"card"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using their credit or debit card.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"google_pay"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using Google Pay.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"revolut_pay_card"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order via Revolut Pay using their credit or debit card.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-4",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"revolut_pay_account"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order via Revolut Pay using their Revolut account.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-5",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"sepa_direct_debit"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using SEPA Direct Debit.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 125d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The last four digits of the debtor's IBAN."}]]}] 125e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The full name of the debtor as provided in the mandate."}]]}] 125f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The unique mandate reference generated by Revolut. Include this in pre-debit notifications sent to your customers."}]]}] 1260:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object containing details of a SEPA Direct Debit payment."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/accept-payments/payment-methods/sepa-direct-debit/server-to-server","target":"_blank","rel":"noreferrer","children":"SEPA Direct Debit server-to-server integration"}]]}]}]]}]]}] 1261:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The details of the payment method used to make the payment."}]]}] 1262:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Type of the authentication challenge the payment triggers."}]]}] 1263:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The URL of the authentication challenge."}]]}] 1264:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Information about the 3DS challenge."}]]}] 1265:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Type of the authentication challenge the payment triggers."}]]}] 1266:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The URL of the fingerprint. (Used only internally by Revolut.)"}]]}] 1267:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Data about the fingerprint used for authentication. (Used only internally\nby Revolut.)"}]]}] 1268:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Information about the 3DS fingerprint challenge."}]]}] 1269:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["Details about the authentication challenge that should be performed to complete the authentication process. For more information about Revolut's 3DS solution, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/reference/3d-secure","target":"_blank","rel":"noreferrer","children":"3D Secure overview"}],"."]}],"\n",["$","p","p-1",{"children":["Only returned if the payment's state is ",["$","code","code-0",{"children":"authentication_challenge"}],"."]}]]}] 126a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Street line 1 information."}]]}] 126b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Street line 2 information."}]]}] 126c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The region associated with the address."}]]}] 126d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The city associated with the address."}]]}] 126e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The 2-letter country code of the country associated with the address."}]]}] 126f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The postcode associated with the address."}]]}] 1270:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object containing address details."}]]}] 1271:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The risk level of the card."}],"\n",["$","p","p-1",{"children":["If the risk level is ",["$","code","code-0",{"children":"high"}],", the payment might be declined."]}]]}] 1272:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of the order fee."}]]}] 1273:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The amount of the payment fee (minor currency unit). For example, enter ",["$","code","code-0",{"children":"7034"}]," for €70.34 in the field."]}]]}] 1274:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The currency of the payment fee. ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_4217","target":"_blank","rel":"noreferrer","children":"ISO 4217"}]," currency code in upper case."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information about the supported currencies, see: ",["$","a","a-0",{"href":"https://help.revolut.com/business/help/merchant-accounts/payments/in-which-currencies-can-i-accept-payments/","target":"_blank","rel":"noreferrer","children":"Help Center"}],"."]}]}]]}]]}] 1275:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The details of the order fee."}]]}] 1276:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The email of the person who made the payment."}]]}] 1277:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The phone number of the payer in ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/E.164","target":"_blank","rel":"noreferrer","children":"E.164 format"}],"."]}]]}] 1278:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The person who made the payment. This object is present when an email or phone number is provided during the payment flow."}],"\n",["$","p","p-1",{"children":"Capturing payer details lets you identify exactly who authorised the charge, reach the right person for receipts or refund queries, and support compliance or fraud-review workflows where the paying identity matters."}]]}] 1279:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Represents a payment for an order."}],"\n",["$","p","p-1",{"children":["For pre-authorised payments, the ",["$","code","code-0",{"children":"authorised_amount"}]," field tracks the currently authorised amount, which may differ from ",["$","code","code-1",{"children":"amount"}]," during incremental authorisation processing."]}]]}] 127a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The details of all the payments that have been made towards this order (successful or unsuccessful)."}]]}] 127b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The new total amount requested in this increment (in minor units)."}]]}] 127c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The previously authorised amount before this increment (in minor units)."}]]}] 127d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The state of this incremental authorization attempt."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"State","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"pending"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Increment registered in system, not yet submitted to card network","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"processing"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Increment is being processed by card network","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"authorised"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Increment was successfully authorised","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"declined"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Increment was declined by card issuer","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-4",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"failed"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Increment failed due to technical error (not an issuer decline)","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 127e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"External reference for this incremental authorisation."}],"\n",["$","div","inlinealert-0",{"data-type":"tip","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"Lightbulb","color":"var(--rui-color-success)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":"Use your internal charge or invoice ID. This reference is returned in webhooks for easy matching to your system."}]}]]}]]}] 127f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Name of the line item."}]]}] 1280:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Type of the line item."}]]}] 1281:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The number of units of the line item."}]]}] 1282:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The measurement unit for the quantity, such as ",["$","code","code-0",{"children":"cm"}],", or ",["$","code","code-1",{"children":"kg"}],"."]}]]}] 1283:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object representing the quantity details of a line item, including the amount and its associated unit of measurement."}]]}] 1284:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The unit price of the line item."}]]}] 1285:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The total amount to be paid for the line item, including taxes and discounts."}]]}] 1286:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unique identifier of line item in the merchant's system."}]]}] 1287:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The specific name or label of the discount applied to the line item."}]]}] 1288:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The monetary value of the discount."}]]}] 1289:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Details of a discount applied to the line item, including its name and monetary value."}]]}] 128a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A list of discounts applied to the line item. Each discount should be subtracted from the total amount payable for the item."}]]}] 128b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The specific name or designation of the tax applied to the line item."}]]}] 128c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The monetary value of the tax in minor currency units (e.g., cents for EUR)."}]]}] 128d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Details about a tax applied to the line item, including its name and the corresponding amount."}]]}] 128e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A list of taxes applied to the line item. Each tax should be added to the total amount payable for the item."}]]}] 128f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"URL to an image associated with the line item."}],"\n",["$","div","inlinealert-0",{"data-type":"warning","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMark","color":"var(--rui-color-warning)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"Restrictions:"}],["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["Must be a valid URI as defined by ",["$","a","a-0",{"href":"https://datatracker.ietf.org/doc/html/rfc3986","target":"_blank","rel":"noreferrer","children":"RFC 3986"}]]}],"\n",["$","li","li-1",{"children":["URI scheme is required and must be either ",["$","code","code-0",{"children":"http"}]," or ",["$","code","code-1",{"children":"https"}]]}],"\n",["$","li","li-2",{"children":["URI host is required and cannot be ",["$","code","code-0",{"children":"localhost"}]," or an IP address"]}],"\n",["$","li","li-3",{"children":["Max length: ",["$","code","code-0",{"children":"2000"}]]}],"\n",["$","li","li-4",{"children":["Reserved or invalid characters must be percent-encoded (for example, use ",["$","code","code-0",{"children":"%20"}]," instead of a space)"]}],"\n"]}]]}]]}]]}] 1290:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A list of URLs pointing to images related to the line item. These images can provide visual details or representations of the item."}]]}] 1291:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Description of the line item."}]]}] 1292:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An HTTP/HTTPS URL that links to more information about the line item, such as a product page or details."}],"\n",["$","div","inlinealert-0",{"data-type":"warning","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMark","color":"var(--rui-color-warning)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"Restrictions:"}],["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["Must be a valid URI as defined by ",["$","a","a-0",{"href":"https://datatracker.ietf.org/doc/html/rfc3986","target":"_blank","rel":"noreferrer","children":"RFC 3986"}]]}],"\n",["$","li","li-1",{"children":["URI scheme is required and must be either ",["$","code","code-0",{"children":"http"}]," or ",["$","code","code-1",{"children":"https"}]]}],"\n",["$","li","li-2",{"children":["URI host is required and cannot be ",["$","code","code-0",{"children":"localhost"}]," or an IP address"]}],"\n",["$","li","li-3",{"children":["Max length: ",["$","code","code-0",{"children":"2000"}]]}],"\n",["$","li","li-4",{"children":["Reserved or invalid characters must be percent-encoded (for example, use ",["$","code","code-0",{"children":"%20"}]," instead of a space)"]}],"\n"]}]]}]]}]]}] 1293:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Line items associated with this increment (if provided)."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":"If the increment is successful, these line items will override the existing order line items."}]}]]}]]}] 1294:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Reason why increment was declined or failed."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["Only present when ",["$","code","code-0",{"children":"state"}]," is ",["$","code","code-1",{"children":"declined"}]," or ",["$","code","code-2",{"children":"failed"}],"."]}]}]]}]]}] 1295:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Represents a single incremental authorisation attempt on an order."}],"\n",["$","p","p-1",{"children":["The ",["$","code","code-0",{"children":"incremental_authorisations"}]," array tracks all increment attempts (successful and failed) in chronological order."]}]]}] 1296:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"History of incremental authorisation attempts for this order."}],"\n",["$","p","p-1",{"children":["Only present for orders with ",["$","code","code-0",{"children":"authorisation_type: pre_authorisation"}],"."]}],"\n",["$","p","p-2",{"children":"Contains all increment attempts in chronological order."}]]}] 1297:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unique ID representing the location where merchants sells products."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#tag-locations","target":"_blank","rel":"noreferrer","children":"Locations"}],"."]}]}]]}]]}] 1298:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Additional metadata value provided with the corresponding metadata key."}]]}] 1299:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["Additional information to track your orders in your system, by providing custom metadata using ",["$","code","code-0",{"children":"\"\" : \"\""}]," pairs."]}],"\n",["$","div","inlinealert-0",{"data-type":"warning","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMark","color":"var(--rui-color-warning)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":["$","strong","strong-0",{"children":"Restrictions:"}]}],["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["Both keys and values must be ",["$","code","code-0",{"children":"string"}],"s"]}],"\n",["$","li","li-1",{"children":["Values cannot be ",["$","code","code-0",{"children":"null"}],"."]}],"\n",["$","li","li-2",{"children":["Max number of key-value pairs: ",["$","code","code-0",{"children":"50"}]]}],"\n",["$","li","li-3",{"children":["Max length of values: ",["$","code","code-0",{"children":"500"}]," characters"]}],"\n",["$","li","li-4",{"children":["Format of keys: Must start with a letter and contain only letters, digits, and underscores. Max 40 characters. Pattern: ",["$","code","code-0",{"children":"^[a-zA-Z][a-zA-Z\\\\d_]{0,39}$"}]]}],"\n"]}]]}]]}]]}] 129b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Type of the industry-specific data object, determining what additional data is expected."}],"\n",["$","p","p-1",{"children":"Available types:"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Object type","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"airline"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about a specific airline ticket purchase.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"car_rental"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about a car rental booking associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"crypto"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about crypto transactions associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"marketplace"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["This object is required by Mastercard and Visa for merchants operating as marketplaces under the ",["$","strong","strong-0",{"children":"Merchant Category Code (MCC):"}]," ",["$","code","code-0",{"children":"5262"}],". The marketplace object ensures compliance with the card schemes' regulations by providing detailed information about the subseller involved in the transaction."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-4",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"event"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about event ticket bookings associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-5",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"lodging"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about lodging bookings associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 129c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A unique identifier provided by the merchant associated with the order."}],"\n",["$","p","p-1",{"children":["This ",["$","code","code-0",{"children":"booking_id"}]," is used to reference and correlate booking information with the Merchant API and the merchant's internal system."]}]]}] 129d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The UTC date and time of the final journey leg."}],"\n",["$","div","inlinealert-0",{"data-type":"warning","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMark","color":"var(--rui-color-warning)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"The following limitations apply:"}],["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["When creating or updating an order, ",["$","code","code-0",{"children":"fulfillment_date"}]," cannot be set to a date in the past."]}],"\n",["$","li","li-1",{"children":["When updating an order, if the current ",["$","code","code-0",{"children":"fulfillment_date"}]," value is already in the past, it cannot be modified. The date must remain as is to maintain data integrity for completed transactions."]}],"\n"]}]]}]]}]]}] 129e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["Flag indicating whether the order includes actual ticket purchases. Set to ",["$","code","code-0",{"children":"true"}]," if the order contains ticket purchases, and ",["$","code","code-1",{"children":"false"}]," if it does not (e.g., it ",["$","strong","strong-0",{"children":"only"}]," contains seat reservations, or baggage upgrades)."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":["This field is required for activating ",["$","strong","strong-0",{"children":"Revolut Flight Alerts"}]," functionalities within the Revolut app."]}],["$","p","p-1",{"children":"Provide the info on order creation or update, before capturing the order."}]]}]]}]]}] 129f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of the ticket."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Parameter value","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"fixed"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Non-modifiable once confirmed.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"flexible"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Allows modifications or cancellations under specified conditions.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 12a0:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The code of the Computer Reservation System (CRS) used to make the booking and purchase the ticket."}]]}] 12a1:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Parameter indicating whether this order is related to a new ticket reservation or a modification of an existing one."}]]}] 12a2:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Parameter indicating whether the booking is refundable, partially refundable, or not refundable."}]]}] 12a3:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Passenger's first name."}]]}] 12a4:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Passenger's last name."}]]}] 12a5:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Array containing information of passengers associated with the booking."}]]}] 12a6:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Sequence of the journey legs. Increment by 1 for each flight included in the ticket."}],"\n",["$","p","p-1",{"children":["For example: For a ",["$","code","code-0",{"children":"FRA > LHR > DUB > LHR > FRA"}]," journey the sequence will be assigned as:"]}],"\n",["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":[["$","code","code-0",{"children":"FRA > LHR"}],": 1"]}],"\n",["$","li","li-1",{"children":[["$","code","code-0",{"children":"LHR > DUB"}],": 2"]}],"\n",["$","li","li-2",{"children":[["$","code","code-0",{"children":"DUB > LHR"}],": 3"]}],"\n",["$","li","li-3",{"children":[["$","code","code-0",{"children":"LHR > FRA"}],": 4"]}],"\n"]}]]}] 12a7:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://www.iata.org/en/services/codes","target":"_blank","rel":"noreferrer","children":"IATA"}]," 3-letter airport code for the departure airport."]}]]}] 12a8:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://www.iata.org/en/services/codes","target":"_blank","rel":"noreferrer","children":"IATA"}]," 3-letter airport code for the arrival airport."]}]]}] 12a9:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The flight identifier, without airline code."}]]}] 12aa:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The fare base code for the given journey leg."}]]}] 12ab:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The UTC date and time of the flight departure for the given journey leg."}]]}] 12ac:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The name of the airline associated with the journey leg."}]]}] 12ad:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The IATA 2-letter accounting code identifying the airline associated with the journey leg."}]]}] 12ae:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The Passenger Name Record (PNR) for the journey leg issued by the airline."}],"\n",["$","p","p-1",{"children":"PNR is a unique identifier for the booking, acting as a digital certificate allowing passengers to retrieve or manage their booking details."}],"\n",["$","div","inlinealert-0",{"data-type":"warning","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMark","color":"var(--rui-color-warning)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":"This is a required field for OTAs."}]}]]}]]}] 12af:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Array containing information of journey legs associated with the booking."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":["This field is required for activating ",["$","strong","strong-0",{"children":"Revolut Flight Alerts"}]," functionalities within the Revolut app."]}],["$","p","p-1",{"children":"This information is used to compile a tracking widget that provides real-time updates on flight status and sends notifications, such as a check-in reminders, boarding alerts, and notifications for cancellations or delays."}],["$","p","p-2",{"children":"To enable the widget the following fields are required on order creation or update, before capturing the order:"}],"$L14de"]}]]}]]}] 12b0:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"URL to the online portal for managing the airline booking, which includes check-in functionality. This URL may be a personalised, pre-populated check-in link specific to the user or a generic link, and it is essential for enabling direct access to booking details within the Revolut app."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":["This field is required for activating ",["$","strong","strong-0",{"children":"Revolut Flight Alerts"}]," functionalities within the Revolut app."]}],["$","p","p-1",{"children":"Provide the info on order creation or update, before capturing the order."}]]}]]}],"\n",["$","div","inlinealert-1",{"data-type":"warning","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMark","color":"var(--rui-color-warning)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"Restrictions:"}],["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["Must be a valid URI as defined by ",["$","a","a-0",{"href":"https://datatracker.ietf.org/doc/html/rfc3986","target":"_blank","rel":"noreferrer","children":"RFC 3986"}]]}],"\n",["$","li","li-1",{"children":["URI scheme is required and must be either ",["$","code","code-0",{"children":"http"}]," or ",["$","code","code-1",{"children":"https"}]]}],"\n",["$","li","li-2",{"children":["URI host is required and cannot be ",["$","code","code-0",{"children":"localhost"}]," or an IP address"]}],"\n",["$","li","li-3",{"children":["Max length: ",["$","code","code-0",{"children":"2000"}]]}],"\n",["$","li","li-4",{"children":["Reserved or invalid characters must be percent-encoded (for example, use ",["$","code","code-0",{"children":"%20"}]," instead of a space)"]}],"\n"]}]]}]]}]]}] 12b1:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object containing additional information about an airline booking associated with the order."}],"\n",["$","p","p-1",{"children":["Use this object to provide required data to enable ",["$","strong","strong-0",{"children":"Revolut Flight Alerts"}],". This feature allows users to receive real-time flight updates such as check-in reminders, boarding alerts, and notifications for cancellations or delays in the Revolut app."]}],"\n",["$","p","p-2",{"children":["To enable ",["$","strong","strong-0",{"children":"Revolut Flight Alerts"}]," functionalities in the Revolut app, the following fields are ",["$","strong","strong-1",{"children":"required"}]," on order creation or update, before capturing the order:"]}],"\n","$L14df","\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"These are the specific data field requirements for merchants who must provide airline data. Note that these requirements can be extended on a case by case basis as decided by Revolut."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Required for airline/charter merchants","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Required for OTA merchants","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","ul","ul-0",{"children":[["$","li","li-0",{"children":["$","code","code-0",{"children":"booking_id"}]}],["$","li","li-1",{"children":["$","code","code-0",{"children":"fulfillment_date"}]}],["$","li","li-2",{"children":["$","code","code-0",{"children":"passengers[].first_name"}]}],["$","li","li-3",{"children":["$","code","code-0",{"children":"passengers[].last_name"}]}],["$","li","li-4",{"children":["$","code","code-0",{"children":"journey_legs[].pnr"}]}],["$","li","li-5",{"children":["$","code","code-0",{"children":"journey_legs[].sequence"}]}],["$","li","li-6",{"children":["$","code","code-0",{"children":"journey_legs[].flight_number"}]}],["$","li","li-7",{"children":["$","code","code-0",{"children":"journey_legs[].travel_date"}]}],["$","li","li-8",{"children":["$","code","code-0",{"children":"journey_legs[].airline_code"}]}],["$","li","li-9",{"children":["$","code","code-0",{"children":"journey_legs[].departure_airport_code"}]}],["$","li","li-10",{"children":["$","code","code-0",{"children":"journey_legs[].arrival_airport_code"}]}]]}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["$","ul","ul-0",{"children":[["$","li","li-0",{"children":["$","code","code-0",{"children":"booking_id"}]}],["$","li","li-1",{"children":["$","code","code-0",{"children":"fulfillment_date"}]}],["$","li","li-2",{"children":["$","code","code-0",{"children":"passengers[].first_name"}]}],["$","li","li-3",{"children":["$","code","code-0",{"children":"passengers[].last_name"}]}],["$","li","li-4",{"children":["$","code","code-0",{"children":"journey_legs[].pnr"}]}],["$","li","li-5",{"children":["$","code","code-0",{"children":"journey_legs[].arrival_airport_code"}]}]]}],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt3","ref":"$undefined"}]]}]}]]}]]}]]}] 12b2:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Type of the industry-specific data object, determining what additional data is expected."}],"\n",["$","p","p-1",{"children":"Available types:"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Object type","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"airline"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about a specific airline ticket purchase.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"car_rental"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about a car rental booking associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"crypto"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about crypto transactions associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"marketplace"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["This object is required by Mastercard and Visa for merchants operating as marketplaces under the ",["$","strong","strong-0",{"children":"Merchant Category Code (MCC):"}]," ",["$","code","code-0",{"children":"5262"}],". The marketplace object ensures compliance with the card schemes' regulations by providing detailed information about the subseller involved in the transaction."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-4",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"event"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about event ticket bookings associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-5",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"lodging"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about lodging bookings associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 12b3:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A unique identifier provided by the merchant associated with the order."}],"\n",["$","p","p-1",{"children":["This ",["$","code","code-0",{"children":"booking_id"}]," is used to reference and correlate booking information with the Merchant API and the merchant's internal system."]}]]}] 12b4:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The UTC date and time of the pick-up."}]]}] 12b5:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object containing address details."}]]}] 12b6:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The UTC date and time of the drop-off."}]]}] 12b7:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object containing address details."}]]}] 12b8:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Parameter indicating whether the booking is refundable, partially refundable, or not refundable."}]]}] 12b9:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The maximum distance allowed."}]]}] 12ba:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The unit of distance."}]]}] 12bb:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The amount of the cost in minor currency units. For example, enter ",["$","code","code-0",{"children":"7034"}]," for €70.34."]}]]}] 12bc:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":[["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_4217","target":"_blank","rel":"noreferrer","children":"ISO 4217"}]," currency code in upper case."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information about the supported currencies, see: ",["$","a","a-0",{"href":"https://help.revolut.com/business/help/merchant-accounts/payments/in-which-currencies-can-i-accept-payments/","target":"_blank","rel":"noreferrer","children":"Help Center"}],"."]}]}]]}]]}] 12bd:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Cost for exceeding the distance limit."}]]}] 12be:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object containing distance limit information."}]]}] 12bf:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object containing additional information about a car rental booking associated with the order."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"These are the specific data field requirements for merchants offering car rental. Note that these requirements can be extended on a case by case basis as decided by Revolut."}],"$L14e0"]}]]}]]}] 12c0:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Type of the industry-specific data object, determining what additional data is expected."}],"\n",["$","p","p-1",{"children":"Available types:"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Object type","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"airline"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about a specific airline ticket purchase.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"car_rental"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about a car rental booking associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"crypto"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about crypto transactions associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"marketplace"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["This object is required by Mastercard and Visa for merchants operating as marketplaces under the ",["$","strong","strong-0",{"children":"Merchant Category Code (MCC):"}]," ",["$","code","code-0",{"children":"5262"}],". The marketplace object ensures compliance with the card schemes' regulations by providing detailed information about the subseller involved in the transaction."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-4",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"event"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about event ticket bookings associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-5",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"lodging"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about lodging bookings associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 12c1:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The public transaction hash of the crypto transaction."}]]}] 12c2:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The status of the crypto transaction."}]]}] 12c3:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The wallet ID of the recipient."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["At least one of the parameters: ",["$","code","code-0",{"children":"recipient_user_id"}]," or ",["$","code","code-1",{"children":"recipient_wallet_id"}]," is required."]}]}]]}]]}] 12c4:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The user ID of the recipient."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["At least one of the parameters: ",["$","code","code-0",{"children":"recipient_user_id"}]," or ",["$","code","code-1",{"children":"recipient_wallet_id"}]," is required."]}]}]]}]]}] 12c5:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Array of crypto transaction data associated with the order."}]]}] 12c6:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["A string representing the four-digit ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/Merchant_category_code","target":"_blank","rel":"noreferrer","children":"Merchant Category Code (MCC)"}]," of the conversion affiliate."]}]]}] 12c7:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The ID of the seller in the merchant's internal system."}]]}] 12c8:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The business or legal name of the seller."}]]}] 12c9:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The URL of the website of the seller."}],"\n",["$","div","inlinealert-0",{"data-type":"warning","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMark","color":"var(--rui-color-warning)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"Restrictions:"}],["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["Must be a valid URI as defined by ",["$","a","a-0",{"href":"https://datatracker.ietf.org/doc/html/rfc3986","target":"_blank","rel":"noreferrer","children":"RFC 3986"}]]}],"\n",["$","li","li-1",{"children":["URI scheme is required and must be either ",["$","code","code-0",{"children":"http"}]," or ",["$","code","code-1",{"children":"https"}]]}],"\n",["$","li","li-2",{"children":["URI host is required and cannot be ",["$","code","code-0",{"children":"localhost"}]," or an IP address"]}],"\n",["$","li","li-3",{"children":["Max length: ",["$","code","code-0",{"children":"255"}]]}],"\n",["$","li","li-4",{"children":["Reserved or invalid characters must be percent-encoded (for example, use ",["$","code","code-0",{"children":"%20"}]," instead of a space)"]}],"\n"]}]]}]]}]]}] 12ca:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The phone number of the seller."}]]}] 12cb:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Primary address line."}]]}] 12cc:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Secondary address line, such as floor and apartment number."}]]}] 12cd:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"State or province of the address."}]]}] 12ce:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"City of the address."}]]}] 12cf:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"ISO 2-letter country code."}]]}] 12d0:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The subdivision code represents the state, province, or region within the country, following the ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_3166-2","target":"_blank","rel":"noreferrer","children":"ISO 3166-2"}]," standard. This code uniquely identifies subdivisions within a country."]}],"\n",["$","p","p-1",{"children":["For example, for London in the United Kingdom, use ",["$","code","code-0",{"children":"GB-LND"}],"."]}],"\n",["$","div","inlinealert-0",{"data-type":"warning","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMark","color":"var(--rui-color-warning)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["The parameter is required for countries listed on the ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_3166-2","target":"_blank","rel":"noreferrer","children":"ISO 3166-2"}]," page."]}]}]]}]]}] 12d1:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Postal code of the address."}]]}] 12d2:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Details of a physical address."}]]}] 12d3:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Information about the crypto conversion affiliate."}],"\n",["$","p","p-1",{"children":"This should be provided when a customer completes a payment on a subseller's website rather than directly on the merchant's website, providing insight into the type of business conducted by the subseller."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"This needs to be provided only by crypto on-ramp providers for payments they are processing for conversion affiliates."}],["$","p","p-1",{"children":["For their own payments, ",["$","code","code-0",{"children":"seller"}]," can be omitted."]}]]}]]}]]}] 12d4:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object containing information about crypto transactions associated with the order."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"Processing crypto on-ramp transactions with Revolut has additional compliance requirements. Please reach out to your account executive for additional details."}],["$","p","p-1",{"children":["$","strong","strong-0",{"children":"Required data fields for crypto services:"}]}],"$L14e1",["$","p","p-2",{"children":"Note that these requirements can be extended on a case by case basis as decided by Revolut."}]]}]]}]]}] 12d5:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Type of the industry-specific data object, determining what additional data is expected."}],"\n",["$","p","p-1",{"children":"Available types:"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Object type","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"airline"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about a specific airline ticket purchase.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"car_rental"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about a car rental booking associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"crypto"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about crypto transactions associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"marketplace"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["This object is required by Mastercard and Visa for merchants operating as marketplaces under the ",["$","strong","strong-0",{"children":"Merchant Category Code (MCC):"}]," ",["$","code","code-0",{"children":"5262"}],". The marketplace object ensures compliance with the card schemes' regulations by providing detailed information about the subseller involved in the transaction."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-4",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"event"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about event ticket bookings associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-5",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"lodging"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about lodging bookings associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 12d6:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The ID of the seller in the merchant's internal system."}]]}] 12d7:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The business or legal name of the seller."}]]}] 12d8:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The URL of the website of the seller."}],"\n",["$","div","inlinealert-0",{"data-type":"warning","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMark","color":"var(--rui-color-warning)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"Restrictions:"}],["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["Must be a valid URI as defined by ",["$","a","a-0",{"href":"https://datatracker.ietf.org/doc/html/rfc3986","target":"_blank","rel":"noreferrer","children":"RFC 3986"}]]}],"\n",["$","li","li-1",{"children":["URI scheme is required and must be either ",["$","code","code-0",{"children":"http"}]," or ",["$","code","code-1",{"children":"https"}]]}],"\n",["$","li","li-2",{"children":["URI host is required and cannot be ",["$","code","code-0",{"children":"localhost"}]," or an IP address"]}],"\n",["$","li","li-3",{"children":["Max length: ",["$","code","code-0",{"children":"255"}]]}],"\n",["$","li","li-4",{"children":["Reserved or invalid characters must be percent-encoded (for example, use ",["$","code","code-0",{"children":"%20"}]," instead of a space)"]}],"\n"]}]]}]]}]]}] 12d9:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The phone number of the seller."}]]}] 12da:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Details of a physical address."}]]}] 12db:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Information about the subseller on the marketplace platform."}]]}] 12dc:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["This object is required by Mastercard and Visa for merchants operating as marketplaces under the Merchant Category Code (MCC) ",["$","code","code-0",{"children":"5262"}],". The marketplace object ensures compliance with the card schemes' regulations by providing detailed information about the seller involved in the transaction."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"These are the specific data field requirements for merchants who must provide marketplace data."}],"$L14e2"]}]]}]]}] 12dd:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Type of the industry-specific data object, determining what additional data is expected."}],"\n",["$","p","p-1",{"children":"Available types:"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Object type","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"airline"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about a specific airline ticket purchase.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"car_rental"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about a car rental booking associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"crypto"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about crypto transactions associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"marketplace"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["This object is required by Mastercard and Visa for merchants operating as marketplaces under the ",["$","strong","strong-0",{"children":"Merchant Category Code (MCC):"}]," ",["$","code","code-0",{"children":"5262"}],". The marketplace object ensures compliance with the card schemes' regulations by providing detailed information about the subseller involved in the transaction."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-4",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"event"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about event ticket bookings associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-5",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"lodging"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about lodging bookings associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 12de:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A unique identifier provided by the merchant associated with the order."}],"\n",["$","p","p-1",{"children":["This ",["$","code","code-0",{"children":"booking_id"}]," is used to reference and correlate booking information with the Merchant API and the merchant's internal system."]}]]}] 12df:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":[["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_8601","target":"_blank","rel":"noreferrer","children":"ISO 8601"}]," date and time when the event starts."]}]]}] 12e0:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":[["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_8601","target":"_blank","rel":"noreferrer","children":"ISO 8601"}]," date and time when the event ends."]}]]}] 12e1:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Legal name of the ticket vendor/event organiser."}]]}] 12e2:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":[["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_8601","target":"_blank","rel":"noreferrer","children":"ISO 8601"}]," date and time when the funds are released to merchants."]}]]}] 12e3:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The name of the event."}]]}] 12e4:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Primary address line."}]]}] 12e5:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Secondary address line, such as floor and apartment number."}]]}] 12e6:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"State or province of the address."}]]}] 12e7:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"City of the address."}]]}] 12e8:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"ISO 2-letter country code."}]]}] 12e9:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Postal code of the address."}]]}] 12ea:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The address of the event location."}]]}] 12eb:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of the event."}]]}] 12ec:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Indicates the relationship between the ticket vendor and the event organiser."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Parameter value","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"primary"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The merchant is the organiser and primary distributor of the tickets.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"secondary"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The merchant is a reseller, only distributing the tickets.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 12ed:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A unique identifier provided by the merchant associated with the ticket."}]]}] 12ee:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Indicates whether the ticket is transferable to another buyer."}]]}] 12ef:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Parameter indicating whether the booking is refundable, partially refundable, or not refundable."}]]}] 12f0:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object containing information about a ticket associated with the booking."}]]}] 12f1:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A list of tickets associated with the booking."}]]}] 12f2:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object containing booking information about a specific event."}]]}] 12f3:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A list of events associated with the booking."}]]}] 12f4:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object containing booking information for a list of event tickets associated with the order."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"These are the specific data field requirements for merchants who must provide event data. Note that these requirements can be extended on a case by case basis as decided by Revolut."}],"$L14e3"]}]]}]]}] 12f5:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Type of the industry-specific data object, determining what additional data is expected."}],"\n",["$","p","p-1",{"children":"Available types:"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Object type","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"airline"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about a specific airline ticket purchase.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"car_rental"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about a car rental booking associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"crypto"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about crypto transactions associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"marketplace"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["This object is required by Mastercard and Visa for merchants operating as marketplaces under the ",["$","strong","strong-0",{"children":"Merchant Category Code (MCC):"}]," ",["$","code","code-0",{"children":"5262"}],". The marketplace object ensures compliance with the card schemes' regulations by providing detailed information about the subseller involved in the transaction."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-4",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"event"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about event ticket bookings associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-5",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"lodging"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about lodging bookings associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 12f6:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A unique identifier provided by the merchant associated with the order."}],"\n",["$","p","p-1",{"children":["This ",["$","code","code-0",{"children":"booking_id"}]," is used to reference and correlate booking information with the Merchant API and the merchant's internal system."]}]]}] 12f7:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":[["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_8601","target":"_blank","rel":"noreferrer","children":"ISO 8601"}]," date and time of the check-in."]}]]}] 12f8:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":[["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_8601","target":"_blank","rel":"noreferrer","children":"ISO 8601"}]," date and time of the check-out."]}]]}] 12f9:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":[["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_8601","target":"_blank","rel":"noreferrer","children":"ISO 8601"}]," date and time when the funds are released to merchants."]}]]}] 12fa:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of the accommodation associated with the booking."}]]}] 12fb:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Indicates whether the booking terms are fixed or flexible."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Parameter value","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"fixed"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Non-modifiable once confirmed.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"flexible"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Allows modifications or cancellations under specified conditions.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 12fc:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Parameter indicating whether the booking is refundable, partially refundable, or not refundable."}]]}] 12fd:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Primary address line."}]]}] 12fe:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Secondary address line, such as floor and apartment number."}]]}] 12ff:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"State or province of the address."}]]}] 1300:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"City of the address."}]]}] 1301:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"ISO 2-letter country code."}]]}] 1302:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Postal code of the address."}]]}] 1303:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Address of the accommodation."}]]}] 1304:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Guest's first name."}]]}] 1305:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Guest's last name."}]]}] 1306:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"List of guests associated with the booking."}]]}] 1307:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object containing details of a lodging booking."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"These are the specific data field requirements for merchants who must provide lodging data. Note that these requirements can be extended on a case by case basis as decided by Revolut."}],"$L14e4"]}]]}]]}] 1308:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object containing industry-specific information associated with the order."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"In the following cases, industry-specific info is required. Omitting this information may trigger additional scrutiny and risk mitigation actions by the Revolut risk team."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Transaction type","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Required for","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"airline"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Airlines and Online Travel Agencies (OTAs).","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"car_rental"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Car Rental Merchants and Online Travel Agencies (OTAs).","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"crypto"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Crypto merchants.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"marketplace"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Marketplace merchants.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-4",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"event"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Event ticket sellers.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-5",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"lodging"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Lodging providers.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}]]}]]}] 1309:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The URL of the order stored in the merchant's order management system."}],"\n",["$","p","p-1",{"children":["This URL will be included in the order confirmation email for payments made via Revolut Pay. If specified, this URL will override the default link to the merchant's ",["$","strong","strong-0",{"children":"Business website"}]," configured in the Revolut Business account."]}],"\n",["$","div","inlinealert-0",{"data-type":"warning","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMark","color":"var(--rui-color-warning)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"Restrictions:"}],["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["Must be a valid URI as defined by ",["$","a","a-0",{"href":"https://datatracker.ietf.org/doc/html/rfc3986","target":"_blank","rel":"noreferrer","children":"RFC 3986"}]]}],"\n",["$","li","li-1",{"children":["URI scheme is required and must be either ",["$","code","code-0",{"children":"http"}]," or ",["$","code","code-1",{"children":"https"}]]}],"\n",["$","li","li-2",{"children":["URI host is required and cannot be ",["$","code","code-0",{"children":"localhost"}]," or an IP address"]}],"\n",["$","li","li-3",{"children":["Max length: ",["$","code","code-0",{"children":"2000"}]]}],"\n",["$","li","li-4",{"children":["Reserved or invalid characters must be percent-encoded (for example, use ",["$","code","code-0",{"children":"%20"}]," instead of a space)"]}],"\n"]}]]}]]}]]}] 130a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Merchant order ID for external reference."}],"\n",["$","p","p-1",{"children":"Use this field to set the ID that your own system can use to easily track orders."}]]}] 130b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object for providing additional information stored in the merchant's order management system."}]]}] 130c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The date and time in ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_8601","target":"_blank","rel":"noreferrer","children":"ISO 8601 format"}]," when the upcoming payment is scheduled to be executed."]}]]}] 130d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The unique ID of the customer's payment method used to complete the scheduled payment."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"For more information about operations related to customer's payment methods, see:"}],["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#retrieve-payment-method-list","target":"_blank","rel":"noreferrer","children":"Retrieve payment method list of a customer"}]}],"\n",["$","li","li-1",{"children":["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#retrieve-payment-method","target":"_blank","rel":"noreferrer","children":"Retrieve a customer's payment method"}]}],"\n",["$","li","li-2",{"children":["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#update-payment-method","target":"_blank","rel":"noreferrer","children":"Update a customer's payment method"}]}],"\n",["$","li","li-3",{"children":["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#delete-payment-method","target":"_blank","rel":"noreferrer","children":"Delete a customer's payment method"}]}],"\n"]}]]}]]}]]}] 130e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object containing information about upcoming payments associated with the order."}]]}] 130f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Link to a checkout page hosted by Revolut."}]]}] 1310:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The URL your customer will be redirected to after a successful payment on the hosted checkout page (",["$","code","code-0",{"children":"checkout_url"}]," parameter's value of the order)."]}],"\n",["$","div","inlinealert-0",{"data-type":"warning","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMark","color":"var(--rui-color-warning)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"Restrictions:"}],["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["Must be a valid URI as defined by ",["$","a","a-0",{"href":"https://datatracker.ietf.org/doc/html/rfc3986","target":"_blank","rel":"noreferrer","children":"RFC 3986"}]]}],"\n",["$","li","li-1",{"children":["URI scheme is required and must be either ",["$","code","code-0",{"children":"http"}]," or ",["$","code","code-1",{"children":"https"}]]}],"\n",["$","li","li-2",{"children":["URI host is required and cannot be ",["$","code","code-0",{"children":"localhost"}]," or an IP address"]}],"\n",["$","li","li-3",{"children":["Max length: ",["$","code","code-0",{"children":"2000"}]]}],"\n",["$","li","li-4",{"children":["Reserved or invalid characters must be percent-encoded (for example, use ",["$","code","code-0",{"children":"%20"}]," instead of a space)"]}],"\n"]}]]}]]}],"\n",["$","div","inlinealert-1",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information on how to use the ",["$","code","code-0",{"children":"redirect_url"}],", see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/accept-payments/online-payments/hosted-checkout-page/api#custom-post-payment-redirection-optional","target":"_blank","rel":"noreferrer","children":"Custom redirection via the API"}]]}]}]]}]]}] 1311:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Primary address line."}]]}] 1312:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Secondary address line, such as floor and apartment number."}]]}] 1313:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"State or province of the address."}]]}] 1314:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"City of the address."}]]}] 1315:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"ISO 2-letter country code."}]]}] 1316:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Postal code of the address."}]]}] 1317:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Details of a physical address."}]]}] 1318:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Full name of the contact person."}]]}] 1319:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Email address of the contact person."}]]}] 131a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Phone number of the contact person."}]]}] 131b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Contact details for someone responsible for the shipment."}],"\n",["$","div","inlinealert-0",{"data-type":"warning","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMark","color":"var(--rui-color-warning)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["At least ",["$","code","code-0",{"children":"email"}]," or ",["$","code","code-1",{"children":"phone"}]," is required."]}]}]]}]]}] 131c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Name of the company handling the shipment."}]]}] 131d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unique tracking number for the shipment."}]]}] 131e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Estimated delivery date and time for the shipment.\nThe time should also include the customer's timezone."}]]}] 131f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An HTTP/HTTPS URL where the shipment can be tracked."}],"\n",["$","div","inlinealert-0",{"data-type":"warning","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMark","color":"var(--rui-color-warning)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"Restrictions:"}],["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["Must be a valid URI as defined by ",["$","a","a-0",{"href":"https://datatracker.ietf.org/doc/html/rfc3986","target":"_blank","rel":"noreferrer","children":"RFC 3986"}]]}],"\n",["$","li","li-1",{"children":["URI scheme is required and must be either ",["$","code","code-0",{"children":"http"}]," or ",["$","code","code-1",{"children":"https"}]]}],"\n",["$","li","li-2",{"children":["URI host is required and cannot be ",["$","code","code-0",{"children":"localhost"}]," or an IP address"]}],"\n",["$","li","li-3",{"children":["Max length: ",["$","code","code-0",{"children":"2000"}]]}],"\n",["$","li","li-4",{"children":["Reserved or invalid characters must be percent-encoded (for example, use ",["$","code","code-0",{"children":"%20"}]," instead of a space)"]}],"\n"]}]]}]]}]]}] 1320:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Details of an individual shipment."}]]}] 1321:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"List of individual shipment details."}]]}] 1322:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Details about the shipping related to the order, including address, contact information, and individual shipments."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":"Required for merchants shipping physical goods. Omitting this information may trigger additional scrutiny and risk mitigation actions by Revolut."}]}]]}]]}] 1323:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The enforce challenge mode. ",["$","code","code-0",{"children":"automatic"}]," is used by default."]}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Parameter value","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"automatic"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The payments created for an order will have challenge requirement calculated by our fraud mechanisms. Not all payments will trigger a 3DS challenge.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"forced"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The payments created for an order will always require a 3DS challenge. Currently only supported for card payments.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 1324:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An array of line items included in the order. Each line item represents an individual product or service, along with its quantity, price, taxes, and discounts."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":"Required for merchants collecting payment for one or multiple products/services in one transaction. Omitting this information may trigger additional scrutiny and risk mitigation actions by Revolut."}]}]]}]]}] 1326:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"You can set a dynamic statement descriptor for your orders by providing a custom suffix."}],"\n",["$","p","p-1",{"children":"A statement descriptor is the text shown on cardholders' bank or card statements, helping them recognise a transaction or merchant. This field can be used to send extra information with the statement descriptor for card transactions."}],"\n",["$","p","p-2",{"children":["The complete descriptor is built using the following format: ",["$","code","code-0",{"children":"{base}*{suffix}"}],", where:"]}],"\n",["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":[["$","strong","strong-0",{"children":["$","code","code-0",{"children":"{base}"}]}]," is the existing descriptor configured in the Revolut Business dashboard (",["$","strong","strong-1",{"children":"Settings > Business account > Merchant profile > Statement descriptor"}],")."]}],"\n",["$","li","li-1",{"children":[["$","strong","strong-0",{"children":["$","code","code-0",{"children":"{suffix}"}]}]," is defined by the ",["$","code","code-0",{"children":"statement_descriptor_suffix"}]," field."]}],"\n"]}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["If the combined descriptor's length (base + suffix) exceeds the character limits of card scheme providers, the final value will be truncated. For example if the limit is 22 characters, the base descriptor is ",["$","code","code-0",{"children":"\"base\""}]," and the suffix is ",["$","code","code-1",{"children":"\"testdescriptorsuffix\""}],", the final descriptor becomes ",["$","code","code-2",{"children":"\"base*testdescriptorsuf\""}],"."]}],"\n",["$","li","li-1",{"children":"The final statement descriptor shown on a cardholder's statement may vary by issuing bank, as some banks apply their own custom formatting or truncation rules."}],"\n"]}]}]]}]]}] 1327:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The unique ID of the original order that was refunded and this refund is associated with. You can use this ID to get more information about the related order using the ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#retrieve-order","target":"_blank","rel":"noreferrer","children":"Retrieve an order"}]," operation."]}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["This field is only returned for orders with ",["$","code","code-0",{"children":"type: refund"}],"."]}]}]]}]]}] 1328:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unique identifier for the subscription."}]]}] 1329:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The unique identifier of the active (pre-paid) subscription cycle that this order collects payment for."}],"\n",["$","p","p-1",{"children":"This is the current billing cycle whose recurring charges are being collected in advance by this order. For example, if a subscription cycle covers 1-31 July and the order is generated on 1 July, this field identifies that July cycle."}]]}] 132a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The unique identifier of the settled (post-paid) subscription cycle whose usage-based charges this order collects."}],"\n",["$","p","p-1",{"children":"This is the previous billing cycle whose usage is being settled by this order. For example, if a subscription cycle covers usage from 1-30 June and the order is generated on 10 July, this field identifies that June cycle."}]]}] 132b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The reason this subscription order was created."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Value","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"cycle_billing"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["The order was automatically generated to collect payment for an ongoing subscription cycle. ",["$","code","code-0",{"children":"active_cycle_id"}]," is present; ",["$","code","code-1",{"children":"settled_cycle_id"}]," is present if the previous cycle included usage-based products."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"final_settlement"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["The order was automatically generated after the subscription ended to collect outstanding usage-based charges. ",["$","code","code-0",{"children":"active_cycle_id"}]," is absent; ",["$","code","code-1",{"children":"settled_cycle_id"}]," is present."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"setup_intent"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["The order was manually created by the merchant or customer to update the payment method on file. ",["$","code","code-0",{"children":"active_cycle_id"}]," is absent; ",["$","code","code-1",{"children":"settled_cycle_id"}]," is absent."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 132c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Subscription details linked to the order. Use this object to match an order with its underlying subscription and understand the billing context in which the order was created."}],"\n",["$","p","p-1",{"children":"Only present on orders created by a subscription."}]]}] 132d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["To process the order from a credit or debit card, you create an ",["$","code","code-0",{"children":"Order"}]," object. You can then retrieve, capture, cancel, refund, or pay an order using its unique ",["$","code","code-1",{"children":"id"}],". Alternatively, you can use its unique ",["$","code","code-2",{"children":"token"}]," to process a card payment with the Revolut Checkout Widget."]}]]}] 132e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Order retrieved"}]]}] 132f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An identifier that can be used to determine what went wrong."}],"\n",["$","p","p-1",{"children":"Error codes are not globally unique, but uniqueness is guaranteed within endpoints."}]]}] 1330:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Some human readable text describing what went wrong."}]]}] 1331:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://www.unixtimestamp.com/","target":"_blank","rel":"noreferrer","children":"UNIX timestamp"}]," of the date and time the error happened."]}]]}] 1332:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Bad Request"}]]}] 1333:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An identifier that can be used to determine what went wrong."}],"\n",["$","p","p-1",{"children":"Error codes are not globally unique, but uniqueness is guaranteed within endpoints."}]]}] 1334:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Some human readable text describing what went wrong."}]]}] 1335:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://www.unixtimestamp.com/","target":"_blank","rel":"noreferrer","children":"UNIX timestamp"}]," of the date and time the error happened."]}]]}] 1336:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unauthorized"}]]}] 1337:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An identifier that can be used to determine what went wrong."}],"\n",["$","p","p-1",{"children":"Error codes are not globally unique, but uniqueness is guaranteed within endpoints."}]]}] 1338:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Some human readable text describing what went wrong."}]]}] 1339:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://www.unixtimestamp.com/","target":"_blank","rel":"noreferrer","children":"UNIX timestamp"}]," of the date and time the error happened."]}]]}] 133a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Not Found"}]]}] 1497:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Retrieve the details of an order that has been created. Provide the unique\norder ID, and the corresponding order information is returned."}]]}] 1498:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["This parameter accepts the ",["$","a","a-0",{"href":"https://business.revolut.com/settings/apis?tab=merchant-api","target":"_blank","rel":"noreferrer","children":"Merchant API Secret key"}]," to authorise requests coming from the merchant's backend."]}],"\n",["$","p","p-1",{"children":["It ensures that ensures that each request is authenticated and authorised by verifying the secret key. The secret key should be included in all request headers as a ",["$","code","code-0",{"children":"Bearer"}]," token."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#authentication","target":"_blank","rel":"noreferrer","children":"Authentication"}]]}]}]]}]]}] 1499:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The version of the Merchant API, specified in ",["$","code","code-0",{"children":"YYYY-MM-DD"}]," format."]}],"\n",["$","p","p-1",{"children":"If not specified, you will receive an error."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information about API versioning, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/reference/versioning/api-versions","target":"_blank","rel":"noreferrer","children":"API versions"}],"."]}]}]]}]]}] 149a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A UUID string, typically used to identify resources."}]]}] 149b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ID of the ",["$","code","code-0",{"children":"Order"}]," object."]}]]}] 1345:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The type of authorisation for the order. Used with manual capture mode. If omitted, ",["$","code","code-0",{"children":"final"}]," is used by default."]}],"\n",["$","h1","h1-0",{"children":"Pre-authorisation"}],"\n",["$","p","p-1",{"children":"Pre-authorisation allows you to reserve funds on a customer's card without immediately capturing them. This is useful for scenarios like:"}],"\n",["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":"Hotel bookings where the final amount may vary"}],"\n",["$","li","li-1",{"children":"Car rentals where additional charges may apply"}],"\n",["$","li","li-2",{"children":"Deposits that need to be held temporarily"}],"\n"]}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Parameter value","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"final"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Standard authorisation for immediate or near-immediate capture.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"pre_authorisation"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Reserve funds for later capture, used with manual capture mode.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["Pre-authorisation must be used with ",["$","code","code-0",{"children":"capture_mode: manual"}],". For more information, see ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#capture-order","target":"_blank","rel":"noreferrer","children":"Capture an order"}],"."]}]}]]}]]}] 1347:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["Automatic cancellation period for uncaptured orders, specified in ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_8601","target":"_blank","rel":"noreferrer","children":"ISO 8601"}]," format."]}],"\n",["$","p","p-1",{"children":["After this period, the authorised payment is automatically cancelled and the order is cancelled. Maximum: 7 days = ",["$","code","code-0",{"children":"P7D"}],"."]}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"The following limitations apply:"}],["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["\n",["$","p","p-0",{"children":"Cannot be a negative value."}],"\n"]}],"\n",["$","li","li-1",{"children":["\n",["$","p","p-0",{"children":"Cannot be updated if the new value is less than or equal to the elapsed time since authorisation."}],"\n",["$","p","p-1",{"children":["$","strong","strong-0",{"children":"Failing scenario:"}]}],"\n",["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":"Original value: 7 days"}],"\n",["$","li","li-1",{"children":"Time since authorisation: 3 days"}],"\n",["$","li","li-2",{"children":"Update value: 2 days"}],"\n"]}],"\n",["$","p","p-2",{"children":"In this scenario, an error is returned."}],"\n",["$","p","p-3",{"children":["$","strong","strong-0",{"children":"Successful scenario:"}]}],"\n",["$","ul","ul-1",{"children":["\n",["$","li","li-0",{"children":"Original value: 7 days"}],"\n",["$","li","li-1",{"children":"Time since authorisation: 3 days"}],"\n",["$","li","li-2",{"children":"Update value: 4 days"}],"\n"]}],"\n",["$","p","p-4",{"children":"In this scenario, the parameter can be updated."}],"\n"]}],"\n",["$","li","li-2",{"children":["\n",["$","p","p-0",{"children":"Cannot be updated if cancellation is ≤ 30 minutes away."}],"\n",["$","p","p-1",{"children":["$","strong","strong-0",{"children":"Failing scenario:"}]}],"\n",["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":"Original value: 12 hours"}],"\n",["$","li","li-1",{"children":"Time since authorisation: 11 hours 40 minutes"}],"\n"]}],"\n",["$","p","p-2",{"children":"In this scenario, an error is returned."}],"\n",["$","p","p-3",{"children":["$","strong","strong-0",{"children":"Successful scenario:"}]}],"\n",["$","ul","ul-1",{"children":["\n",["$","li","li-0",{"children":"Original value: 12 hours"}],"\n",["$","li","li-1",{"children":"Time since authorisation: 11 hours 20 minutes"}],"\n"]}],"\n",["$","p","p-4",{"children":"In this scenario, the parameter can be updated."}],"\n"]}],"\n"]}]]}]]}]]}] 1348:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The order total expressed in minor currency units, according to the ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_4217","target":"_blank","rel":"noreferrer","children":"ISO 4217 standard"}],". For example, ",["$","code","code-0",{"children":"7034"}]," in ",["$","code","code-1",{"children":"EUR"}]," corresponds to €70.34."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["Conversion between major and minor units varies by currency. For instance, ",["$","code","code-0",{"children":"100"}]," minor units equal £1.00 in ",["$","code","code-1",{"children":"GBP"}],", whereas in ",["$","code","code-2",{"children":"ISK"}]," they represent 100 units. For more details, see the ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_4217","target":"_blank","rel":"noreferrer","children":"ISO 4217 standard"}],"."]}],"\n",["$","li","li-1",{"children":["If ",["$","code","code-0",{"children":"line_items"}]," are provided, the order ",["$","code","code-1",{"children":"amount"}]," must equal the sum of all line items' ",["$","code","code-2",{"children":"total_amount"}],"."]}],"\n",["$","li","li-2",{"children":["For card payments with a non-zero amount, the order ",["$","code","code-0",{"children":"amount"}]," must be at least ",["$","strong","strong-0",{"children":"$$0.005"}]," (or equivalent in different currencies, calculated using Revolut's exchange rate on the payment date). Otherwise, card payments can't be performed."]}],"\n"]}]}]]}]]}] 1349:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The amount not yet paid for a given order (in minor currency units). For example, ",["$","code","code-0",{"children":"7034"}]," represents €70.34."]}],"\n",["$","p","p-1",{"children":["The value in this field may differ from ",["$","code","code-0",{"children":"amount"}]," if there are partial payments associated with the order."]}]]}] 134a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The amount that was refunded from the order (in minor currency units). For example, ",["$","code","code-0",{"children":"7034"}]," represents €70.34."]}],"\n",["$","p","p-1",{"children":["This applies to orders that have been refunded (i.e., orders of type ",["$","code","code-0",{"children":"payment"}]," that have a related ",["$","code","code-1",{"children":"refund"}]," order)."]}]]}] 134b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":[["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_4217","target":"_blank","rel":"noreferrer","children":"ISO 4217"}]," currency code in upper case."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information about the supported currencies, see: ",["$","a","a-0",{"href":"https://help.revolut.com/business/help/merchant-accounts/payments/in-which-currencies-can-i-accept-payments/","target":"_blank","rel":"noreferrer","children":"Help Center"}],"."]}]}]]}]]}] 134c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":[["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_4217","target":"_blank","rel":"noreferrer","children":"ISO 4217"}]," currency code in upper case."]}],"\n",["$","p","p-1",{"children":["If ",["$","code","code-0",{"children":"settlement_currency"}]," is different from the value of ",["$","code","code-1",{"children":"currency"}],", the money will be exchanged when the amount is settled to your merchant account. In case of a refund or chargeback, the money will be exchanged to the order's initial ",["$","code","code-2",{"children":"currency"}],"."]}],"\n",["$","p","p-2",{"children":["If ",["$","code","code-0",{"children":"settlement_currency"}]," is not specified, this value is taken from ",["$","code","code-1",{"children":"currency"}],"."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information about the supported currencies, see: ",["$","a","a-0",{"href":"https://help.revolut.com/business/help/merchant-accounts/payments/in-which-currencies-can-i-accept-payments/","target":"_blank","rel":"noreferrer","children":"Help Center"}],"."]}]}]]}]]}] 134e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Permanent ID of a customer used to retrieve, update, delete a customer. This ID can also be used to link customer to an order."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":"If you provide the customer's ID during order creation, no other customer data is required, they will be parsed automatically from the referenced customer object."}]}]]}]]}] 134f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The full name of the customer."}]]}] 1350:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The phone number of the customer in ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/E.164","target":"_blank","rel":"noreferrer","children":"E.164 format"}],"."]}]]}] 1351:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The email address of the customer."}]]}] 1352:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The birth date of the customer."}]]}] 1353:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object containing information about a customer."}],"\n",["$","p","p-1",{"children":["If you have it, we strongly advise providing at least either ",["$","code","code-0",{"children":"id"}],", ",["$","code","code-1",{"children":"phone"}],", or ",["$","code","code-2",{"children":"email"}],"."]}],"\n",["$","p","p-2",{"children":["Using the ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#tag-customers","target":"_blank","rel":"noreferrer","children":"Customers operations"}],", you can manage customer instances."]}],"\n",["$","p","p-3",{"children":"The following behaviours apply to different use cases:"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Use case","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"API behavior","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":"Existing customer","className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["If ",["$","code","code-0",{"children":"id"}]," was provided, we ignore other customer details and associate the customer with the order.",["$","br","br-0",{}],["$","br","br-1",{}],"If either ",["$","code","code-1",{"children":"email"}],", ",["$","code","code-2",{"children":"phone"}],", or ",["$","code","code-3",{"children":"full_name"}]," was provided (without an existing customer's ",["$","code","code-4",{"children":"id"}],"), we always create a new customer, irrespective of another, existing customer object having the same details."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":"New customer","className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["If either ",["$","code","code-0",{"children":"email"}],", ",["$","code","code-1",{"children":"phone"}],", or ",["$","code","code-2",{"children":"full_name"}]," was provided, we create a new customer, irrespective of another customer object having the same details. ",["$","br","br-0",{}],["$","br","br-1",{}],"If ",["$","code","code-3",{"children":"id"}]," of a non-existent customer was provided, we return a ",["$","code","code-4",{"children":"404"}]," error, irrespective of other details provided."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["To avoid unintentional duplication of customer records, search for an existing customer by email or phone using the ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#retrieve-customer-list","target":"_blank","rel":"noreferrer","children":"List customers"}]," endpoint first, then provide ",["$","code","code-0",{"children":"customer.id"}]," in the order."]}]}]]}]]}] 1354:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The ID of the payment."}]]}] 1355:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The status of the payment."}]]}] 1356:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The reason for a ",["$","code","code-0",{"children":"failed"}]," or ",["$","code","code-1",{"children":"declined"}]," payment."]}],"\n",["$","p","p-1",{"children":["A failed or declined payment can result from multiple reasons. To learn more, check our ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/reference/error-codes/decline-reasons","target":"_blank","rel":"noreferrer","children":"failure reasons"}],"."]}]]}] 1357:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The reason for a ",["$","code","code-0",{"children":"failed"}]," or ",["$","code","code-1",{"children":"declined"}]," payment, sent by the financial institution processing the payment."]}]]}] 1358:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The date and time the payment was created."}]]}] 1359:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The date and time the payment was last updated."}]]}] 135a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Temporary token of the payment used to fetch the reward offer during checkout and link user registrations to the given offers."}],"\n",["$","p","p-1",{"children":"The token is only valid for a limited time."}]]}] 135b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The payment amount in minor units (e.g., cents). The value of this field depends on the payment type and state."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Payment type","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"State","className":"eowryt6","ref":"$undefined"}],["$","th","th-2",{"children":"Amount value","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":"Standard payment","className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Any","className":"eowryt7","ref":"$undefined"}],["$","td","td-2",{"children":"Total payment amount","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":"Pre-authorised payment","className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["$","code","code-0",{"children":"authorisation_started"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-2",{"children":"New amount being authorised (during increment processing)","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":"Pre-authorised payment","className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["$","code","code-0",{"children":"authorised"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-2",{"children":["Currently authorised amount (equals ",["$","code","code-0",{"children":"authorised_amount"}],")"],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For pre-authorised payments, see the ",["$","code","code-0",{"children":"authorised_amount"}]," field for tracking the currently authorised amount separately."]}]}]]}]]}] 135c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The currently authorised amount for this payment (in minor units)."}],"\n",["$","p","p-1",{"children":"For pre-authorised payments with incremental authorization:"}],"\n",["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["Initially equals the ",["$","code","code-0",{"children":"amount"}]," field"]}],"\n",["$","li","li-1",{"children":"Remains unchanged during increment processing"}],"\n",["$","li","li-2",{"children":"Updates to new amount upon successful increment"}],"\n",["$","li","li-3",{"children":"Remains at original amount if increment is declined"}],"\n"]}],"\n",["$","p","p-2",{"children":["For standard payments, this field may not be present or will equal the ",["$","code","code-0",{"children":"amount"}]," field."]}]]}] 135d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":[["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_4217","target":"_blank","rel":"noreferrer","children":"ISO 4217"}]," currency code in upper case."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information about the supported currencies, see: ",["$","a","a-0",{"href":"https://help.revolut.com/business/help/merchant-accounts/payments/in-which-currencies-can-i-accept-payments/","target":"_blank","rel":"noreferrer","children":"Help Center"}],"."]}]}]]}]]}] 135e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The amount of the settled payment (minor currency unit). For example, ",["$","code","code-0",{"children":"7034"}]," stands for €70.34."]}]]}] 135f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The currency of the settled payment. ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_4217","target":"_blank","rel":"noreferrer","children":"ISO 4217"}]," currency code in upper case."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information about the supported currencies, see: ",["$","a","a-0",{"href":"https://help.revolut.com/business/help/merchant-accounts/payments/in-which-currencies-can-i-accept-payments/","target":"_blank","rel":"noreferrer","children":"Help Center"}],"."]}]}]]}]]}] 1360:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"ID of the saved payment method."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["The ",["$","code","code-0",{"children":"id"}]," parameter is only returned when the payment method is saved."]}]}]]}]]}] 1361:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of payment method used to pay for the order."}],"\n",["$","p","p-1",{"children":"Available values:"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":["Payment method ",["$","code","code-0",{"children":"type"}]],"className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"apple_pay"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using Apple Pay.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"card"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using their credit or debit card.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"google_pay"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using Google Pay.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"revolut_pay_card"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order via Revolut Pay using their credit or debit card.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-4",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"revolut_pay_account"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order via Revolut Pay using their Revolut account.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-5",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"sepa_direct_debit"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using SEPA Direct Debit.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 1362:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of the card."}]]}] 1363:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of card funding."}]]}] 1364:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The 2-letter country code of the country where the card was issued."}]]}] 1365:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The BIN of the card."}]]}] 1366:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The last four digits of the card number."}]]}] 1367:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The expiry date of the card in the format of MM/YY."}]]}] 1368:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The name of the cardholder."}]]}] 1369:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The Electronic Commerce Indicator (ECI) value corresponds to the authentication result and indicates the level of security used when the payment information was provided."}]]}] 136a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The result of 3D Secure check."}]]}] 136b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The 3D Secure version."}]]}] 136c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The details of the 3D Secure check. Only for orders with successful payments."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":"Not returned for Apple Pay and Google Pay payments."}]}]]}]]}] 136d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The result of CVV verification."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Parameter value","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"match"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"CVV matches the card's CVV","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"not_match"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"CVV does not match the card's CVV","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"incorrect"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"CVV format is incorrect for this type of card","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"not_processed"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"CVV verification was not performed","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 136e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The result of address verification."}]]}] 136f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The result of postcode verification."}]]}] 1370:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The result of cardholder verification."}]]}] 1371:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The details of the check for card payment. Only for orders with successful payments."}]]}] 1372:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The authorisation code (or auth code) is a short, alphanumeric code returned by the cardholder's issuing bank to the merchant's terminal or payment gateway."}],"\n",["$","p","p-1",{"children":"It serves as confirmation that the transaction has been approved and funds are available."}]]}] 1373:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Acquirer Reference Number (ARN) of the payment."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":"Only returned for refund payments made by a card."}]}]]}]]}] 1374:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The date and time by which the payment must be captured."}],"\n",["$","p","p-1",{"children":"After this deadline, the authorised funds may be automatically released by the card issuer."}]]}] 1375:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The hardware identifier of the Revolut Terminal device used to process the payment."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":"Only present for card-present transactions processed via Revolut Terminal."}]}]]}]]}] 1377:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A unique identifier for a payment method, always 44 characters long. This fingerprint can be used to uniquely identify various payment methods."}],"\n",["$","h1","h1-0",{"children":"Fingerprint generation"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Payment method","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","strong","strong-0",{"children":"All payment methods"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"A fingerprint is generated for all payment methods, including cards, Revolut Pay (card, account-to-account payments), Apple Pay, and Google Pay.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","strong","strong-0",{"children":"Cards (Revolut Pay & Card Gateway)"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"For cards, the fingerprint is based on the PAN. Cards processed via Revolut Pay and our card gateway will share the same fingerprint. Renewed cards (new expiry/CVV) retain the same fingerprint for efficient blocking.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","strong","strong-0",{"children":"Apple Pay & Google Pay"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Since Apple Pay and Google Pay provide us Device PANs (DPAN), the fingerprint is based on the DPAN provided by Apple/Google, not the connected card's PAN. This means that a new DPAN (and fingerprint) is generated for cards in case they are re-added to the customer's digital wallet, or added to different devices.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}],"\n",["$","h4","h4-0",{"children":"Detecting duplicate payment methods"}],"\n",["$","p","p-1",{"children":"Fingerprints are a valuable tool for detecting duplicate payment methods by identifying if a payment method has been seen before. This capability, in turn, helps in preventing various types of misuse (e.g., exploitation of free trials, or association with known problematic accounts, which can be a form of fraud). To effectively use fingerprints for this purpose, you will need to create and maintain your own lists (e.g., blocklists of known problematic fingerprints, allowlists for trusted customers, or tracking frequently used fingerprints)."}],"\n",["$","p","p-2",{"children":"The ideal way to utilise fingerprints is by combining them with a manual capture process. While automatic capture with subsequent refunds for problematic payments is possible, manual capture based on fingerprint validation is recommended."}],"\n",["$","p","p-3",{"children":"During your manual capture workflow, after a payment was authorised:"}],"\n",["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":"Check the fingerprint status by comparing it against your maintained lists and internal business rules."}],"\n",["$","li","li-1",{"children":["If you decide to proceed with the payment (e.g., the fingerprint is not on a blocklist, or matches a trusted customer's previous payment method): ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#capture-order","target":"_blank","rel":"noreferrer","children":"Capture the order"}],"."]}],"\n",["$","li","li-2",{"children":["If you decide not to proceed with the payment (e.g., the fingerprint matches a known fraudulent fingerprint, or exhibits suspicious patterns): ","$L14e5","."]}],"\n"]}]]}] 1378:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The Network Transaction ID (NTI) is a unique identifier assigned by the card scheme (e.g., Visa or Mastercard) to a card transaction."}],"\n",["$","p","p-1",{"children":"It can be used to trace the transaction across the payment network, link recurring or instalment payments to the original authorisation, and support dispute resolution."}]]}] 1379:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object containing details of a card used via Apple Pay."}]]}] 137a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"ID of the saved payment method."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["The ",["$","code","code-0",{"children":"id"}]," parameter is only returned when the payment method is saved."]}]}]]}]]}] 137b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of payment method used to pay for the order."}],"\n",["$","p","p-1",{"children":"Available values:"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":["Payment method ",["$","code","code-0",{"children":"type"}]],"className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"apple_pay"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using Apple Pay.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"card"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using their credit or debit card.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"google_pay"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using Google Pay.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"revolut_pay_card"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order via Revolut Pay using their credit or debit card.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-4",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"revolut_pay_account"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order via Revolut Pay using their Revolut account.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-5",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"sepa_direct_debit"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using SEPA Direct Debit.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 137c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of the card."}]]}] 137d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of card funding."}]]}] 137e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The 2-letter country code of the country where the card was issued."}]]}] 137f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The BIN of the card."}]]}] 1380:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The last four digits of the card number."}]]}] 1381:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The expiry date of the card in the format of MM/YY."}]]}] 1382:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The name of the cardholder."}]]}] 1383:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The details of the check for card payment. Only for orders with successful payments."}]]}] 1384:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The authorisation code (or auth code) is a short, alphanumeric code returned by the cardholder's issuing bank to the merchant's terminal or payment gateway."}],"\n",["$","p","p-1",{"children":"It serves as confirmation that the transaction has been approved and funds are available."}]]}] 1385:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Acquirer Reference Number (ARN) of the payment."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":"Only returned for refund payments made by a card."}]}]]}]]}] 1386:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The date and time by which the payment must be captured."}],"\n",["$","p","p-1",{"children":"After this deadline, the authorised funds may be automatically released by the card issuer."}]]}] 1387:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The hardware identifier of the Revolut Terminal device used to process the payment."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":"Only present for card-present transactions processed via Revolut Terminal."}]}]]}]]}] 1389:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A unique identifier for a payment method, always 44 characters long. This fingerprint can be used to uniquely identify various payment methods."}],"\n",["$","h1","h1-0",{"children":"Fingerprint generation"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Payment method","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","strong","strong-0",{"children":"All payment methods"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"A fingerprint is generated for all payment methods, including cards, Revolut Pay (card, account-to-account payments), Apple Pay, and Google Pay.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","strong","strong-0",{"children":"Cards (Revolut Pay & Card Gateway)"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"For cards, the fingerprint is based on the PAN. Cards processed via Revolut Pay and our card gateway will share the same fingerprint. Renewed cards (new expiry/CVV) retain the same fingerprint for efficient blocking.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","strong","strong-0",{"children":"Apple Pay & Google Pay"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Since Apple Pay and Google Pay provide us Device PANs (DPAN), the fingerprint is based on the DPAN provided by Apple/Google, not the connected card's PAN. This means that a new DPAN (and fingerprint) is generated for cards in case they are re-added to the customer's digital wallet, or added to different devices.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}],"\n",["$","h4","h4-0",{"children":"Detecting duplicate payment methods"}],"\n",["$","p","p-1",{"children":"Fingerprints are a valuable tool for detecting duplicate payment methods by identifying if a payment method has been seen before. This capability, in turn, helps in preventing various types of misuse (e.g., exploitation of free trials, or association with known problematic accounts, which can be a form of fraud). To effectively use fingerprints for this purpose, you will need to create and maintain your own lists (e.g., blocklists of known problematic fingerprints, allowlists for trusted customers, or tracking frequently used fingerprints)."}],"\n",["$","p","p-2",{"children":"The ideal way to utilise fingerprints is by combining them with a manual capture process. While automatic capture with subsequent refunds for problematic payments is possible, manual capture based on fingerprint validation is recommended."}],"\n",["$","p","p-3",{"children":"During your manual capture workflow, after a payment was authorised:"}],"\n",["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":"Check the fingerprint status by comparing it against your maintained lists and internal business rules."}],"\n",["$","li","li-1",{"children":["If you decide to proceed with the payment (e.g., the fingerprint is not on a blocklist, or matches a trusted customer's previous payment method): ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#capture-order","target":"_blank","rel":"noreferrer","children":"Capture the order"}],"."]}],"\n",["$","li","li-2",{"children":["If you decide not to proceed with the payment (e.g., the fingerprint matches a known fraudulent fingerprint, or exhibits suspicious patterns): ","$L14e6","."]}],"\n"]}]]}] 138a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The Network Transaction ID (NTI) is a unique identifier assigned by the card scheme (e.g., Visa or Mastercard) to a card transaction."}],"\n",["$","p","p-1",{"children":"It can be used to trace the transaction across the payment network, link recurring or instalment payments to the original authorisation, and support dispute resolution."}]]}] 138b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object containing details of the card used for the payment."}]]}] 138c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"ID of the saved payment method."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["The ",["$","code","code-0",{"children":"id"}]," parameter is only returned when the payment method is saved."]}]}]]}]]}] 138d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of payment method used to pay for the order."}],"\n",["$","p","p-1",{"children":"Available values:"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":["Payment method ",["$","code","code-0",{"children":"type"}]],"className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"apple_pay"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using Apple Pay.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"card"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using their credit or debit card.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"google_pay"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using Google Pay.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"revolut_pay_card"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order via Revolut Pay using their credit or debit card.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-4",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"revolut_pay_account"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order via Revolut Pay using their Revolut account.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-5",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"sepa_direct_debit"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using SEPA Direct Debit.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 138e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of the card."}]]}] 138f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of card funding."}]]}] 1390:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The 2-letter country code of the country where the card was issued."}]]}] 1391:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The BIN of the card."}]]}] 1392:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The last four digits of the card number."}]]}] 1393:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The expiry date of the card in the format of MM/YY."}]]}] 1394:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The name of the cardholder."}]]}] 1395:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The details of the check for card payment. Only for orders with successful payments."}]]}] 1396:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The authorisation code (or auth code) is a short, alphanumeric code returned by the cardholder's issuing bank to the merchant's terminal or payment gateway."}],"\n",["$","p","p-1",{"children":"It serves as confirmation that the transaction has been approved and funds are available."}]]}] 1397:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Acquirer Reference Number (ARN) of the payment."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":"Only returned for refund payments made by a card."}]}]]}]]}] 1398:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The date and time by which the payment must be captured."}],"\n",["$","p","p-1",{"children":"After this deadline, the authorised funds may be automatically released by the card issuer."}]]}] 1399:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The hardware identifier of the Revolut Terminal device used to process the payment."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":"Only present for card-present transactions processed via Revolut Terminal."}]}]]}]]}] 139b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A unique identifier for a payment method, always 44 characters long. This fingerprint can be used to uniquely identify various payment methods."}],"\n",["$","h1","h1-0",{"children":"Fingerprint generation"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Payment method","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","strong","strong-0",{"children":"All payment methods"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"A fingerprint is generated for all payment methods, including cards, Revolut Pay (card, account-to-account payments), Apple Pay, and Google Pay.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","strong","strong-0",{"children":"Cards (Revolut Pay & Card Gateway)"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"For cards, the fingerprint is based on the PAN. Cards processed via Revolut Pay and our card gateway will share the same fingerprint. Renewed cards (new expiry/CVV) retain the same fingerprint for efficient blocking.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","strong","strong-0",{"children":"Apple Pay & Google Pay"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Since Apple Pay and Google Pay provide us Device PANs (DPAN), the fingerprint is based on the DPAN provided by Apple/Google, not the connected card's PAN. This means that a new DPAN (and fingerprint) is generated for cards in case they are re-added to the customer's digital wallet, or added to different devices.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}],"\n",["$","h4","h4-0",{"children":"Detecting duplicate payment methods"}],"\n",["$","p","p-1",{"children":"Fingerprints are a valuable tool for detecting duplicate payment methods by identifying if a payment method has been seen before. This capability, in turn, helps in preventing various types of misuse (e.g., exploitation of free trials, or association with known problematic accounts, which can be a form of fraud). To effectively use fingerprints for this purpose, you will need to create and maintain your own lists (e.g., blocklists of known problematic fingerprints, allowlists for trusted customers, or tracking frequently used fingerprints)."}],"\n",["$","p","p-2",{"children":"The ideal way to utilise fingerprints is by combining them with a manual capture process. While automatic capture with subsequent refunds for problematic payments is possible, manual capture based on fingerprint validation is recommended."}],"\n",["$","p","p-3",{"children":"During your manual capture workflow, after a payment was authorised:"}],"\n",["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":"Check the fingerprint status by comparing it against your maintained lists and internal business rules."}],"\n",["$","li","li-1",{"children":["If you decide to proceed with the payment (e.g., the fingerprint is not on a blocklist, or matches a trusted customer's previous payment method): ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#capture-order","target":"_blank","rel":"noreferrer","children":"Capture the order"}],"."]}],"\n",["$","li","li-2",{"children":["If you decide not to proceed with the payment (e.g., the fingerprint matches a known fraudulent fingerprint, or exhibits suspicious patterns): ","$L14e7","."]}],"\n"]}]]}] 139c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The Network Transaction ID (NTI) is a unique identifier assigned by the card scheme (e.g., Visa or Mastercard) to a card transaction."}],"\n",["$","p","p-1",{"children":"It can be used to trace the transaction across the payment network, link recurring or instalment payments to the original authorisation, and support dispute resolution."}]]}] 139d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object containing details of a card used via Google Pay."}]]}] 139e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"ID of the saved payment method."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["The ",["$","code","code-0",{"children":"id"}]," parameter is only returned when the payment method is saved."]}]}]]}]]}] 139f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of payment method used to pay for the order."}],"\n",["$","p","p-1",{"children":"Available values:"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":["Payment method ",["$","code","code-0",{"children":"type"}]],"className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"apple_pay"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using Apple Pay.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"card"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using their credit or debit card.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"google_pay"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using Google Pay.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"revolut_pay_card"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order via Revolut Pay using their credit or debit card.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-4",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"revolut_pay_account"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order via Revolut Pay using their Revolut account.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-5",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"sepa_direct_debit"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using SEPA Direct Debit.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 13a0:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of the card."}]]}] 13a1:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of card funding."}]]}] 13a2:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The 2-letter country code of the country where the card was issued."}]]}] 13a3:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The BIN of the card."}]]}] 13a4:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The last four digits of the card number."}]]}] 13a5:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The expiry date of the card in the format of MM/YY."}]]}] 13a6:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The name of the cardholder."}]]}] 13a7:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The details of the check for card payment. Only for orders with successful payments."}]]}] 13a8:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The authorisation code (or auth code) is a short, alphanumeric code returned by the cardholder's issuing bank to the merchant's terminal or payment gateway."}],"\n",["$","p","p-1",{"children":"It serves as confirmation that the transaction has been approved and funds are available."}]]}] 13a9:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Acquirer Reference Number (ARN) of the payment."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":"Only returned for refund payments made by a card."}]}]]}]]}] 13aa:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The date and time by which the payment must be captured."}],"\n",["$","p","p-1",{"children":"After this deadline, the authorised funds may be automatically released by the card issuer."}]]}] 13ab:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The hardware identifier of the Revolut Terminal device used to process the payment."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":"Only present for card-present transactions processed via Revolut Terminal."}]}]]}]]}] 13ad:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A unique identifier for a payment method, always 44 characters long. This fingerprint can be used to uniquely identify various payment methods."}],"\n",["$","h1","h1-0",{"children":"Fingerprint generation"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Payment method","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","strong","strong-0",{"children":"All payment methods"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"A fingerprint is generated for all payment methods, including cards, Revolut Pay (card, account-to-account payments), Apple Pay, and Google Pay.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","strong","strong-0",{"children":"Cards (Revolut Pay & Card Gateway)"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"For cards, the fingerprint is based on the PAN. Cards processed via Revolut Pay and our card gateway will share the same fingerprint. Renewed cards (new expiry/CVV) retain the same fingerprint for efficient blocking.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","strong","strong-0",{"children":"Apple Pay & Google Pay"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Since Apple Pay and Google Pay provide us Device PANs (DPAN), the fingerprint is based on the DPAN provided by Apple/Google, not the connected card's PAN. This means that a new DPAN (and fingerprint) is generated for cards in case they are re-added to the customer's digital wallet, or added to different devices.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}],"\n",["$","h4","h4-0",{"children":"Detecting duplicate payment methods"}],"\n",["$","p","p-1",{"children":"Fingerprints are a valuable tool for detecting duplicate payment methods by identifying if a payment method has been seen before. This capability, in turn, helps in preventing various types of misuse (e.g., exploitation of free trials, or association with known problematic accounts, which can be a form of fraud). To effectively use fingerprints for this purpose, you will need to create and maintain your own lists (e.g., blocklists of known problematic fingerprints, allowlists for trusted customers, or tracking frequently used fingerprints)."}],"\n",["$","p","p-2",{"children":"The ideal way to utilise fingerprints is by combining them with a manual capture process. While automatic capture with subsequent refunds for problematic payments is possible, manual capture based on fingerprint validation is recommended."}],"\n",["$","p","p-3",{"children":"During your manual capture workflow, after a payment was authorised:"}],"\n",["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":"Check the fingerprint status by comparing it against your maintained lists and internal business rules."}],"\n",["$","li","li-1",{"children":["If you decide to proceed with the payment (e.g., the fingerprint is not on a blocklist, or matches a trusted customer's previous payment method): ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#capture-order","target":"_blank","rel":"noreferrer","children":"Capture the order"}],"."]}],"\n",["$","li","li-2",{"children":["If you decide not to proceed with the payment (e.g., the fingerprint matches a known fraudulent fingerprint, or exhibits suspicious patterns): ","$L14e8","."]}],"\n"]}]]}] 13ae:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The Network Transaction ID (NTI) is a unique identifier assigned by the card scheme (e.g., Visa or Mastercard) to a card transaction."}],"\n",["$","p","p-1",{"children":"It can be used to trace the transaction across the payment network, link recurring or instalment payments to the original authorisation, and support dispute resolution."}]]}] 13af:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object containing details of a card used via Revolut Pay."}]]}] 13b0:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"ID of the saved payment method."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["The ",["$","code","code-0",{"children":"id"}]," parameter is only returned when the payment method is saved."]}]}]]}]]}] 13b1:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of payment method used to pay for the order."}],"\n",["$","p","p-1",{"children":"Available values:"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":["Payment method ",["$","code","code-0",{"children":"type"}]],"className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"apple_pay"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using Apple Pay.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"card"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using their credit or debit card.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"google_pay"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using Google Pay.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"revolut_pay_card"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order via Revolut Pay using their credit or debit card.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-4",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"revolut_pay_account"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order via Revolut Pay using their Revolut account.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-5",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"sepa_direct_debit"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using SEPA Direct Debit.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 13b3:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A unique identifier for a payment method, always 44 characters long. This fingerprint can be used to uniquely identify various payment methods."}],"\n",["$","h1","h1-0",{"children":"Fingerprint generation"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Payment method","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","strong","strong-0",{"children":"All payment methods"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"A fingerprint is generated for all payment methods, including cards, Revolut Pay (card, account-to-account payments), Apple Pay, and Google Pay.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","strong","strong-0",{"children":"Cards (Revolut Pay & Card Gateway)"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"For cards, the fingerprint is based on the PAN. Cards processed via Revolut Pay and our card gateway will share the same fingerprint. Renewed cards (new expiry/CVV) retain the same fingerprint for efficient blocking.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","strong","strong-0",{"children":"Apple Pay & Google Pay"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Since Apple Pay and Google Pay provide us Device PANs (DPAN), the fingerprint is based on the DPAN provided by Apple/Google, not the connected card's PAN. This means that a new DPAN (and fingerprint) is generated for cards in case they are re-added to the customer's digital wallet, or added to different devices.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}],"\n",["$","h4","h4-0",{"children":"Detecting duplicate payment methods"}],"\n",["$","p","p-1",{"children":"Fingerprints are a valuable tool for detecting duplicate payment methods by identifying if a payment method has been seen before. This capability, in turn, helps in preventing various types of misuse (e.g., exploitation of free trials, or association with known problematic accounts, which can be a form of fraud). To effectively use fingerprints for this purpose, you will need to create and maintain your own lists (e.g., blocklists of known problematic fingerprints, allowlists for trusted customers, or tracking frequently used fingerprints)."}],"\n",["$","p","p-2",{"children":"The ideal way to utilise fingerprints is by combining them with a manual capture process. While automatic capture with subsequent refunds for problematic payments is possible, manual capture based on fingerprint validation is recommended."}],"\n",["$","p","p-3",{"children":"During your manual capture workflow, after a payment was authorised:"}],"\n",["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":"Check the fingerprint status by comparing it against your maintained lists and internal business rules."}],"\n",["$","li","li-1",{"children":["If you decide to proceed with the payment (e.g., the fingerprint is not on a blocklist, or matches a trusted customer's previous payment method): ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#capture-order","target":"_blank","rel":"noreferrer","children":"Capture the order"}],"."]}],"\n",["$","li","li-2",{"children":["If you decide not to proceed with the payment (e.g., the fingerprint matches a known fraudulent fingerprint, or exhibits suspicious patterns): ","$L14e9","."]}],"\n"]}]]}] 13b4:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"ID of the saved payment method."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["The ",["$","code","code-0",{"children":"id"}]," parameter is only returned when the payment method is saved for the merchant."]}]}]]}]]}] 13b5:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of payment method used to pay for the order."}],"\n",["$","p","p-1",{"children":"Available values:"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":["Payment method ",["$","code","code-0",{"children":"type"}]],"className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"apple_pay"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using Apple Pay.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"card"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using their credit or debit card.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"google_pay"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using Google Pay.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"revolut_pay_card"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order via Revolut Pay using their credit or debit card.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-4",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"revolut_pay_account"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order via Revolut Pay using their Revolut account.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-5",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"sepa_direct_debit"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using SEPA Direct Debit.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 13b6:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The last four digits of the debtor's IBAN."}]]}] 13b7:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The full name of the debtor as provided in the mandate."}]]}] 13b8:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The unique mandate reference generated by Revolut. Include this in pre-debit notifications sent to your customers."}]]}] 13b9:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object containing details of a SEPA Direct Debit payment."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/accept-payments/payment-methods/sepa-direct-debit/server-to-server","target":"_blank","rel":"noreferrer","children":"SEPA Direct Debit server-to-server integration"}]]}]}]]}]]}] 13ba:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The details of the payment method used to make the payment."}]]}] 13bb:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Type of the authentication challenge the payment triggers."}]]}] 13bc:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The URL of the authentication challenge."}]]}] 13bd:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Information about the 3DS challenge."}]]}] 13be:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Type of the authentication challenge the payment triggers."}]]}] 13bf:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The URL of the fingerprint. (Used only internally by Revolut.)"}]]}] 13c0:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Data about the fingerprint used for authentication. (Used only internally\nby Revolut.)"}]]}] 13c1:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Information about the 3DS fingerprint challenge."}]]}] 13c2:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["Details about the authentication challenge that should be performed to complete the authentication process. For more information about Revolut's 3DS solution, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/reference/3d-secure","target":"_blank","rel":"noreferrer","children":"3D Secure overview"}],"."]}],"\n",["$","p","p-1",{"children":["Only returned if the payment's state is ",["$","code","code-0",{"children":"authentication_challenge"}],"."]}]]}] 13c3:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Street line 1 information."}]]}] 13c4:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Street line 2 information."}]]}] 13c5:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The region associated with the address."}]]}] 13c6:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The city associated with the address."}]]}] 13c7:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The 2-letter country code of the country associated with the address."}]]}] 13c8:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The postcode associated with the address."}]]}] 13c9:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object containing address details."}]]}] 13ca:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The risk level of the card."}],"\n",["$","p","p-1",{"children":["If the risk level is ",["$","code","code-0",{"children":"high"}],", the payment might be declined."]}]]}] 13cb:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of the order fee."}]]}] 13cc:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The amount of the payment fee (minor currency unit). For example, enter ",["$","code","code-0",{"children":"7034"}]," for €70.34 in the field."]}]]}] 13cd:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The currency of the payment fee. ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_4217","target":"_blank","rel":"noreferrer","children":"ISO 4217"}]," currency code in upper case."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information about the supported currencies, see: ",["$","a","a-0",{"href":"https://help.revolut.com/business/help/merchant-accounts/payments/in-which-currencies-can-i-accept-payments/","target":"_blank","rel":"noreferrer","children":"Help Center"}],"."]}]}]]}]]}] 13ce:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The details of the order fee."}]]}] 13cf:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The email of the person who made the payment."}]]}] 13d0:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The phone number of the payer in ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/E.164","target":"_blank","rel":"noreferrer","children":"E.164 format"}],"."]}]]}] 13d1:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The person who made the payment. This object is present when an email or phone number is provided during the payment flow."}],"\n",["$","p","p-1",{"children":"Capturing payer details lets you identify exactly who authorised the charge, reach the right person for receipts or refund queries, and support compliance or fraud-review workflows where the paying identity matters."}]]}] 13d2:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Represents a payment for an order."}],"\n",["$","p","p-1",{"children":["For pre-authorised payments, the ",["$","code","code-0",{"children":"authorised_amount"}]," field tracks the currently authorised amount, which may differ from ",["$","code","code-1",{"children":"amount"}]," during incremental authorisation processing."]}]]}] 13d3:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The details of all the payments that have been made towards this order (successful or unsuccessful)."}]]}] 13d4:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The new total amount requested in this increment (in minor units)."}]]}] 13d5:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The previously authorised amount before this increment (in minor units)."}]]}] 13d6:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The state of this incremental authorization attempt."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"State","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"pending"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Increment registered in system, not yet submitted to card network","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"processing"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Increment is being processed by card network","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"authorised"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Increment was successfully authorised","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"declined"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Increment was declined by card issuer","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-4",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"failed"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Increment failed due to technical error (not an issuer decline)","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 13d7:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"External reference for this incremental authorisation."}],"\n",["$","div","inlinealert-0",{"data-type":"tip","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"Lightbulb","color":"var(--rui-color-success)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":"Use your internal charge or invoice ID. This reference is returned in webhooks for easy matching to your system."}]}]]}]]}] 13d8:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Name of the line item."}]]}] 13d9:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Type of the line item."}]]}] 13da:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The number of units of the line item."}]]}] 13db:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The measurement unit for the quantity, such as ",["$","code","code-0",{"children":"cm"}],", or ",["$","code","code-1",{"children":"kg"}],"."]}]]}] 13dc:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object representing the quantity details of a line item, including the amount and its associated unit of measurement."}]]}] 13dd:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The unit price of the line item."}]]}] 13de:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The total amount to be paid for the line item, including taxes and discounts."}]]}] 13df:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unique identifier of line item in the merchant's system."}]]}] 13e0:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The specific name or label of the discount applied to the line item."}]]}] 13e1:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The monetary value of the discount."}]]}] 13e2:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Details of a discount applied to the line item, including its name and monetary value."}]]}] 13e3:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A list of discounts applied to the line item. Each discount should be subtracted from the total amount payable for the item."}]]}] 13e4:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The specific name or designation of the tax applied to the line item."}]]}] 13e5:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The monetary value of the tax in minor currency units (e.g., cents for EUR)."}]]}] 13e6:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Details about a tax applied to the line item, including its name and the corresponding amount."}]]}] 13e7:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A list of taxes applied to the line item. Each tax should be added to the total amount payable for the item."}]]}] 13e8:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"URL to an image associated with the line item."}],"\n",["$","div","inlinealert-0",{"data-type":"warning","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMark","color":"var(--rui-color-warning)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"Restrictions:"}],["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["Must be a valid URI as defined by ",["$","a","a-0",{"href":"https://datatracker.ietf.org/doc/html/rfc3986","target":"_blank","rel":"noreferrer","children":"RFC 3986"}]]}],"\n",["$","li","li-1",{"children":["URI scheme is required and must be either ",["$","code","code-0",{"children":"http"}]," or ",["$","code","code-1",{"children":"https"}]]}],"\n",["$","li","li-2",{"children":["URI host is required and cannot be ",["$","code","code-0",{"children":"localhost"}]," or an IP address"]}],"\n",["$","li","li-3",{"children":["Max length: ",["$","code","code-0",{"children":"2000"}]]}],"\n",["$","li","li-4",{"children":["Reserved or invalid characters must be percent-encoded (for example, use ",["$","code","code-0",{"children":"%20"}]," instead of a space)"]}],"\n"]}]]}]]}]]}] 13e9:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A list of URLs pointing to images related to the line item. These images can provide visual details or representations of the item."}]]}] 13ea:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Description of the line item."}]]}] 13eb:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An HTTP/HTTPS URL that links to more information about the line item, such as a product page or details."}],"\n",["$","div","inlinealert-0",{"data-type":"warning","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMark","color":"var(--rui-color-warning)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"Restrictions:"}],["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["Must be a valid URI as defined by ",["$","a","a-0",{"href":"https://datatracker.ietf.org/doc/html/rfc3986","target":"_blank","rel":"noreferrer","children":"RFC 3986"}]]}],"\n",["$","li","li-1",{"children":["URI scheme is required and must be either ",["$","code","code-0",{"children":"http"}]," or ",["$","code","code-1",{"children":"https"}]]}],"\n",["$","li","li-2",{"children":["URI host is required and cannot be ",["$","code","code-0",{"children":"localhost"}]," or an IP address"]}],"\n",["$","li","li-3",{"children":["Max length: ",["$","code","code-0",{"children":"2000"}]]}],"\n",["$","li","li-4",{"children":["Reserved or invalid characters must be percent-encoded (for example, use ",["$","code","code-0",{"children":"%20"}]," instead of a space)"]}],"\n"]}]]}]]}]]}] 13ec:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Line items associated with this increment (if provided)."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":"If the increment is successful, these line items will override the existing order line items."}]}]]}]]}] 13ed:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Reason why increment was declined or failed."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["Only present when ",["$","code","code-0",{"children":"state"}]," is ",["$","code","code-1",{"children":"declined"}]," or ",["$","code","code-2",{"children":"failed"}],"."]}]}]]}]]}] 13ee:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Represents a single incremental authorisation attempt on an order."}],"\n",["$","p","p-1",{"children":["The ",["$","code","code-0",{"children":"incremental_authorisations"}]," array tracks all increment attempts (successful and failed) in chronological order."]}]]}] 13ef:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"History of incremental authorisation attempts for this order."}],"\n",["$","p","p-1",{"children":["Only present for orders with ",["$","code","code-0",{"children":"authorisation_type: pre_authorisation"}],"."]}],"\n",["$","p","p-2",{"children":"Contains all increment attempts in chronological order."}]]}] 13f0:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unique ID representing the location where merchants sells products."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#tag-locations","target":"_blank","rel":"noreferrer","children":"Locations"}],"."]}]}]]}]]}] 13f1:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Additional metadata value provided with the corresponding metadata key."}]]}] 13f2:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["Additional information to track your orders in your system, by providing custom metadata using ",["$","code","code-0",{"children":"\"\" : \"\""}]," pairs."]}],"\n",["$","div","inlinealert-0",{"data-type":"warning","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMark","color":"var(--rui-color-warning)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":["$","strong","strong-0",{"children":"Restrictions:"}]}],["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["Both keys and values must be ",["$","code","code-0",{"children":"string"}],"s"]}],"\n",["$","li","li-1",{"children":["Values cannot be ",["$","code","code-0",{"children":"null"}],"."]}],"\n",["$","li","li-2",{"children":["Max number of key-value pairs: ",["$","code","code-0",{"children":"50"}]]}],"\n",["$","li","li-3",{"children":["Max length of values: ",["$","code","code-0",{"children":"500"}]," characters"]}],"\n",["$","li","li-4",{"children":["Format of keys: Must start with a letter and contain only letters, digits, and underscores. Max 40 characters. Pattern: ",["$","code","code-0",{"children":"^[a-zA-Z][a-zA-Z\\\\d_]{0,39}$"}]]}],"\n"]}]]}]]}]]}] 13f4:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Type of the industry-specific data object, determining what additional data is expected."}],"\n",["$","p","p-1",{"children":"Available types:"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Object type","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"airline"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about a specific airline ticket purchase.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"car_rental"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about a car rental booking associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"crypto"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about crypto transactions associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"marketplace"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["This object is required by Mastercard and Visa for merchants operating as marketplaces under the ",["$","strong","strong-0",{"children":"Merchant Category Code (MCC):"}]," ",["$","code","code-0",{"children":"5262"}],". The marketplace object ensures compliance with the card schemes' regulations by providing detailed information about the subseller involved in the transaction."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-4",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"event"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about event ticket bookings associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-5",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"lodging"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about lodging bookings associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 13f5:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A unique identifier provided by the merchant associated with the order."}],"\n",["$","p","p-1",{"children":["This ",["$","code","code-0",{"children":"booking_id"}]," is used to reference and correlate booking information with the Merchant API and the merchant's internal system."]}]]}] 13f6:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The UTC date and time of the final journey leg."}],"\n",["$","div","inlinealert-0",{"data-type":"warning","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMark","color":"var(--rui-color-warning)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"The following limitations apply:"}],["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["When creating or updating an order, ",["$","code","code-0",{"children":"fulfillment_date"}]," cannot be set to a date in the past."]}],"\n",["$","li","li-1",{"children":["When updating an order, if the current ",["$","code","code-0",{"children":"fulfillment_date"}]," value is already in the past, it cannot be modified. The date must remain as is to maintain data integrity for completed transactions."]}],"\n"]}]]}]]}]]}] 13f7:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["Flag indicating whether the order includes actual ticket purchases. Set to ",["$","code","code-0",{"children":"true"}]," if the order contains ticket purchases, and ",["$","code","code-1",{"children":"false"}]," if it does not (e.g., it ",["$","strong","strong-0",{"children":"only"}]," contains seat reservations, or baggage upgrades)."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":["This field is required for activating ",["$","strong","strong-0",{"children":"Revolut Flight Alerts"}]," functionalities within the Revolut app."]}],["$","p","p-1",{"children":"Provide the info on order creation or update, before capturing the order."}]]}]]}]]}] 13f8:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of the ticket."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Parameter value","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"fixed"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Non-modifiable once confirmed.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"flexible"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Allows modifications or cancellations under specified conditions.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 13f9:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The code of the Computer Reservation System (CRS) used to make the booking and purchase the ticket."}]]}] 13fa:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Parameter indicating whether this order is related to a new ticket reservation or a modification of an existing one."}]]}] 13fb:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Parameter indicating whether the booking is refundable, partially refundable, or not refundable."}]]}] 13fc:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Passenger's first name."}]]}] 13fd:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Passenger's last name."}]]}] 13fe:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Array containing information of passengers associated with the booking."}]]}] 13ff:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Sequence of the journey legs. Increment by 1 for each flight included in the ticket."}],"\n",["$","p","p-1",{"children":["For example: For a ",["$","code","code-0",{"children":"FRA > LHR > DUB > LHR > FRA"}]," journey the sequence will be assigned as:"]}],"\n",["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":[["$","code","code-0",{"children":"FRA > LHR"}],": 1"]}],"\n",["$","li","li-1",{"children":[["$","code","code-0",{"children":"LHR > DUB"}],": 2"]}],"\n",["$","li","li-2",{"children":[["$","code","code-0",{"children":"DUB > LHR"}],": 3"]}],"\n",["$","li","li-3",{"children":[["$","code","code-0",{"children":"LHR > FRA"}],": 4"]}],"\n"]}]]}] 1400:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://www.iata.org/en/services/codes","target":"_blank","rel":"noreferrer","children":"IATA"}]," 3-letter airport code for the departure airport."]}]]}] 1401:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://www.iata.org/en/services/codes","target":"_blank","rel":"noreferrer","children":"IATA"}]," 3-letter airport code for the arrival airport."]}]]}] 1402:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The flight identifier, without airline code."}]]}] 1403:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The fare base code for the given journey leg."}]]}] 1404:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The UTC date and time of the flight departure for the given journey leg."}]]}] 1405:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The name of the airline associated with the journey leg."}]]}] 1406:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The IATA 2-letter accounting code identifying the airline associated with the journey leg."}]]}] 1407:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The Passenger Name Record (PNR) for the journey leg issued by the airline."}],"\n",["$","p","p-1",{"children":"PNR is a unique identifier for the booking, acting as a digital certificate allowing passengers to retrieve or manage their booking details."}],"\n",["$","div","inlinealert-0",{"data-type":"warning","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMark","color":"var(--rui-color-warning)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":"This is a required field for OTAs."}]}]]}]]}] 1408:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Array containing information of journey legs associated with the booking."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":["This field is required for activating ",["$","strong","strong-0",{"children":"Revolut Flight Alerts"}]," functionalities within the Revolut app."]}],["$","p","p-1",{"children":"This information is used to compile a tracking widget that provides real-time updates on flight status and sends notifications, such as a check-in reminders, boarding alerts, and notifications for cancellations or delays."}],["$","p","p-2",{"children":"To enable the widget the following fields are required on order creation or update, before capturing the order:"}],"$L14ea"]}]]}]]}] 1409:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"URL to the online portal for managing the airline booking, which includes check-in functionality. This URL may be a personalised, pre-populated check-in link specific to the user or a generic link, and it is essential for enabling direct access to booking details within the Revolut app."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":["This field is required for activating ",["$","strong","strong-0",{"children":"Revolut Flight Alerts"}]," functionalities within the Revolut app."]}],["$","p","p-1",{"children":"Provide the info on order creation or update, before capturing the order."}]]}]]}],"\n",["$","div","inlinealert-1",{"data-type":"warning","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMark","color":"var(--rui-color-warning)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"Restrictions:"}],["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["Must be a valid URI as defined by ",["$","a","a-0",{"href":"https://datatracker.ietf.org/doc/html/rfc3986","target":"_blank","rel":"noreferrer","children":"RFC 3986"}]]}],"\n",["$","li","li-1",{"children":["URI scheme is required and must be either ",["$","code","code-0",{"children":"http"}]," or ",["$","code","code-1",{"children":"https"}]]}],"\n",["$","li","li-2",{"children":["URI host is required and cannot be ",["$","code","code-0",{"children":"localhost"}]," or an IP address"]}],"\n",["$","li","li-3",{"children":["Max length: ",["$","code","code-0",{"children":"2000"}]]}],"\n",["$","li","li-4",{"children":["Reserved or invalid characters must be percent-encoded (for example, use ",["$","code","code-0",{"children":"%20"}]," instead of a space)"]}],"\n"]}]]}]]}]]}] 140a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object containing additional information about an airline booking associated with the order."}],"\n",["$","p","p-1",{"children":["Use this object to provide required data to enable ",["$","strong","strong-0",{"children":"Revolut Flight Alerts"}],". This feature allows users to receive real-time flight updates such as check-in reminders, boarding alerts, and notifications for cancellations or delays in the Revolut app."]}],"\n",["$","p","p-2",{"children":["To enable ",["$","strong","strong-0",{"children":"Revolut Flight Alerts"}]," functionalities in the Revolut app, the following fields are ",["$","strong","strong-1",{"children":"required"}]," on order creation or update, before capturing the order:"]}],"\n","$L14eb","\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"These are the specific data field requirements for merchants who must provide airline data. Note that these requirements can be extended on a case by case basis as decided by Revolut."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Required for airline/charter merchants","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Required for OTA merchants","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","ul","ul-0",{"children":[["$","li","li-0",{"children":["$","code","code-0",{"children":"booking_id"}]}],["$","li","li-1",{"children":["$","code","code-0",{"children":"fulfillment_date"}]}],["$","li","li-2",{"children":["$","code","code-0",{"children":"passengers[].first_name"}]}],["$","li","li-3",{"children":["$","code","code-0",{"children":"passengers[].last_name"}]}],["$","li","li-4",{"children":["$","code","code-0",{"children":"journey_legs[].pnr"}]}],["$","li","li-5",{"children":["$","code","code-0",{"children":"journey_legs[].sequence"}]}],["$","li","li-6",{"children":["$","code","code-0",{"children":"journey_legs[].flight_number"}]}],["$","li","li-7",{"children":["$","code","code-0",{"children":"journey_legs[].travel_date"}]}],["$","li","li-8",{"children":["$","code","code-0",{"children":"journey_legs[].airline_code"}]}],["$","li","li-9",{"children":["$","code","code-0",{"children":"journey_legs[].departure_airport_code"}]}],["$","li","li-10",{"children":["$","code","code-0",{"children":"journey_legs[].arrival_airport_code"}]}]]}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["$","ul","ul-0",{"children":[["$","li","li-0",{"children":["$","code","code-0",{"children":"booking_id"}]}],["$","li","li-1",{"children":["$","code","code-0",{"children":"fulfillment_date"}]}],["$","li","li-2",{"children":["$","code","code-0",{"children":"passengers[].first_name"}]}],["$","li","li-3",{"children":["$","code","code-0",{"children":"passengers[].last_name"}]}],["$","li","li-4",{"children":["$","code","code-0",{"children":"journey_legs[].pnr"}]}],["$","li","li-5",{"children":["$","code","code-0",{"children":"journey_legs[].arrival_airport_code"}]}]]}],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt3","ref":"$undefined"}]]}]}]]}]]}]]}] 140b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Type of the industry-specific data object, determining what additional data is expected."}],"\n",["$","p","p-1",{"children":"Available types:"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Object type","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"airline"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about a specific airline ticket purchase.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"car_rental"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about a car rental booking associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"crypto"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about crypto transactions associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"marketplace"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["This object is required by Mastercard and Visa for merchants operating as marketplaces under the ",["$","strong","strong-0",{"children":"Merchant Category Code (MCC):"}]," ",["$","code","code-0",{"children":"5262"}],". The marketplace object ensures compliance with the card schemes' regulations by providing detailed information about the subseller involved in the transaction."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-4",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"event"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about event ticket bookings associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-5",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"lodging"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about lodging bookings associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 140c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A unique identifier provided by the merchant associated with the order."}],"\n",["$","p","p-1",{"children":["This ",["$","code","code-0",{"children":"booking_id"}]," is used to reference and correlate booking information with the Merchant API and the merchant's internal system."]}]]}] 140d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The UTC date and time of the pick-up."}]]}] 140e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object containing address details."}]]}] 140f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The UTC date and time of the drop-off."}]]}] 1410:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object containing address details."}]]}] 1411:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Parameter indicating whether the booking is refundable, partially refundable, or not refundable."}]]}] 1412:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The maximum distance allowed."}]]}] 1413:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The unit of distance."}]]}] 1414:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The amount of the cost in minor currency units. For example, enter ",["$","code","code-0",{"children":"7034"}]," for €70.34."]}]]}] 1415:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":[["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_4217","target":"_blank","rel":"noreferrer","children":"ISO 4217"}]," currency code in upper case."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information about the supported currencies, see: ",["$","a","a-0",{"href":"https://help.revolut.com/business/help/merchant-accounts/payments/in-which-currencies-can-i-accept-payments/","target":"_blank","rel":"noreferrer","children":"Help Center"}],"."]}]}]]}]]}] 1416:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Cost for exceeding the distance limit."}]]}] 1417:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object containing distance limit information."}]]}] 1418:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object containing additional information about a car rental booking associated with the order."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"These are the specific data field requirements for merchants offering car rental. Note that these requirements can be extended on a case by case basis as decided by Revolut."}],"$L14ec"]}]]}]]}] 1419:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Type of the industry-specific data object, determining what additional data is expected."}],"\n",["$","p","p-1",{"children":"Available types:"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Object type","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"airline"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about a specific airline ticket purchase.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"car_rental"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about a car rental booking associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"crypto"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about crypto transactions associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"marketplace"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["This object is required by Mastercard and Visa for merchants operating as marketplaces under the ",["$","strong","strong-0",{"children":"Merchant Category Code (MCC):"}]," ",["$","code","code-0",{"children":"5262"}],". The marketplace object ensures compliance with the card schemes' regulations by providing detailed information about the subseller involved in the transaction."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-4",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"event"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about event ticket bookings associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-5",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"lodging"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about lodging bookings associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 141a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The public transaction hash of the crypto transaction."}]]}] 141b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The status of the crypto transaction."}]]}] 141c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The wallet ID of the recipient."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["At least one of the parameters: ",["$","code","code-0",{"children":"recipient_user_id"}]," or ",["$","code","code-1",{"children":"recipient_wallet_id"}]," is required."]}]}]]}]]}] 141d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The user ID of the recipient."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["At least one of the parameters: ",["$","code","code-0",{"children":"recipient_user_id"}]," or ",["$","code","code-1",{"children":"recipient_wallet_id"}]," is required."]}]}]]}]]}] 141e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Array of crypto transaction data associated with the order."}]]}] 141f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["A string representing the four-digit ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/Merchant_category_code","target":"_blank","rel":"noreferrer","children":"Merchant Category Code (MCC)"}]," of the conversion affiliate."]}]]}] 1420:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The ID of the seller in the merchant's internal system."}]]}] 1421:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The business or legal name of the seller."}]]}] 1422:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The URL of the website of the seller."}],"\n",["$","div","inlinealert-0",{"data-type":"warning","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMark","color":"var(--rui-color-warning)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"Restrictions:"}],["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["Must be a valid URI as defined by ",["$","a","a-0",{"href":"https://datatracker.ietf.org/doc/html/rfc3986","target":"_blank","rel":"noreferrer","children":"RFC 3986"}]]}],"\n",["$","li","li-1",{"children":["URI scheme is required and must be either ",["$","code","code-0",{"children":"http"}]," or ",["$","code","code-1",{"children":"https"}]]}],"\n",["$","li","li-2",{"children":["URI host is required and cannot be ",["$","code","code-0",{"children":"localhost"}]," or an IP address"]}],"\n",["$","li","li-3",{"children":["Max length: ",["$","code","code-0",{"children":"255"}]]}],"\n",["$","li","li-4",{"children":["Reserved or invalid characters must be percent-encoded (for example, use ",["$","code","code-0",{"children":"%20"}]," instead of a space)"]}],"\n"]}]]}]]}]]}] 1423:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The phone number of the seller."}]]}] 1424:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Primary address line."}]]}] 1425:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Secondary address line, such as floor and apartment number."}]]}] 1426:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"State or province of the address."}]]}] 1427:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"City of the address."}]]}] 1428:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"ISO 2-letter country code."}]]}] 1429:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The subdivision code represents the state, province, or region within the country, following the ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_3166-2","target":"_blank","rel":"noreferrer","children":"ISO 3166-2"}]," standard. This code uniquely identifies subdivisions within a country."]}],"\n",["$","p","p-1",{"children":["For example, for London in the United Kingdom, use ",["$","code","code-0",{"children":"GB-LND"}],"."]}],"\n",["$","div","inlinealert-0",{"data-type":"warning","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMark","color":"var(--rui-color-warning)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["The parameter is required for countries listed on the ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_3166-2","target":"_blank","rel":"noreferrer","children":"ISO 3166-2"}]," page."]}]}]]}]]}] 142a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Postal code of the address."}]]}] 142b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Details of a physical address."}]]}] 142c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Information about the crypto conversion affiliate."}],"\n",["$","p","p-1",{"children":"This should be provided when a customer completes a payment on a subseller's website rather than directly on the merchant's website, providing insight into the type of business conducted by the subseller."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"This needs to be provided only by crypto on-ramp providers for payments they are processing for conversion affiliates."}],["$","p","p-1",{"children":["For their own payments, ",["$","code","code-0",{"children":"seller"}]," can be omitted."]}]]}]]}]]}] 142d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object containing information about crypto transactions associated with the order."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"Processing crypto on-ramp transactions with Revolut has additional compliance requirements. Please reach out to your account executive for additional details."}],["$","p","p-1",{"children":["$","strong","strong-0",{"children":"Required data fields for crypto services:"}]}],"$L14ed",["$","p","p-2",{"children":"Note that these requirements can be extended on a case by case basis as decided by Revolut."}]]}]]}]]}] 142e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Type of the industry-specific data object, determining what additional data is expected."}],"\n",["$","p","p-1",{"children":"Available types:"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Object type","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"airline"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about a specific airline ticket purchase.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"car_rental"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about a car rental booking associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"crypto"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about crypto transactions associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"marketplace"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["This object is required by Mastercard and Visa for merchants operating as marketplaces under the ",["$","strong","strong-0",{"children":"Merchant Category Code (MCC):"}]," ",["$","code","code-0",{"children":"5262"}],". The marketplace object ensures compliance with the card schemes' regulations by providing detailed information about the subseller involved in the transaction."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-4",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"event"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about event ticket bookings associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-5",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"lodging"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about lodging bookings associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 142f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The ID of the seller in the merchant's internal system."}]]}] 1430:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The business or legal name of the seller."}]]}] 1431:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The URL of the website of the seller."}],"\n",["$","div","inlinealert-0",{"data-type":"warning","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMark","color":"var(--rui-color-warning)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"Restrictions:"}],["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["Must be a valid URI as defined by ",["$","a","a-0",{"href":"https://datatracker.ietf.org/doc/html/rfc3986","target":"_blank","rel":"noreferrer","children":"RFC 3986"}]]}],"\n",["$","li","li-1",{"children":["URI scheme is required and must be either ",["$","code","code-0",{"children":"http"}]," or ",["$","code","code-1",{"children":"https"}]]}],"\n",["$","li","li-2",{"children":["URI host is required and cannot be ",["$","code","code-0",{"children":"localhost"}]," or an IP address"]}],"\n",["$","li","li-3",{"children":["Max length: ",["$","code","code-0",{"children":"255"}]]}],"\n",["$","li","li-4",{"children":["Reserved or invalid characters must be percent-encoded (for example, use ",["$","code","code-0",{"children":"%20"}]," instead of a space)"]}],"\n"]}]]}]]}]]}] 1432:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The phone number of the seller."}]]}] 1433:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Details of a physical address."}]]}] 1434:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Information about the subseller on the marketplace platform."}]]}] 1435:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["This object is required by Mastercard and Visa for merchants operating as marketplaces under the Merchant Category Code (MCC) ",["$","code","code-0",{"children":"5262"}],". The marketplace object ensures compliance with the card schemes' regulations by providing detailed information about the seller involved in the transaction."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"These are the specific data field requirements for merchants who must provide marketplace data."}],"$L14ee"]}]]}]]}] 1436:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Type of the industry-specific data object, determining what additional data is expected."}],"\n",["$","p","p-1",{"children":"Available types:"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Object type","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"airline"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about a specific airline ticket purchase.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"car_rental"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about a car rental booking associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"crypto"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about crypto transactions associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"marketplace"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["This object is required by Mastercard and Visa for merchants operating as marketplaces under the ",["$","strong","strong-0",{"children":"Merchant Category Code (MCC):"}]," ",["$","code","code-0",{"children":"5262"}],". The marketplace object ensures compliance with the card schemes' regulations by providing detailed information about the subseller involved in the transaction."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-4",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"event"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about event ticket bookings associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-5",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"lodging"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about lodging bookings associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 1437:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A unique identifier provided by the merchant associated with the order."}],"\n",["$","p","p-1",{"children":["This ",["$","code","code-0",{"children":"booking_id"}]," is used to reference and correlate booking information with the Merchant API and the merchant's internal system."]}]]}] 1438:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":[["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_8601","target":"_blank","rel":"noreferrer","children":"ISO 8601"}]," date and time when the event starts."]}]]}] 1439:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":[["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_8601","target":"_blank","rel":"noreferrer","children":"ISO 8601"}]," date and time when the event ends."]}]]}] 143a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Legal name of the ticket vendor/event organiser."}]]}] 143b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":[["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_8601","target":"_blank","rel":"noreferrer","children":"ISO 8601"}]," date and time when the funds are released to merchants."]}]]}] 143c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The name of the event."}]]}] 143d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Primary address line."}]]}] 143e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Secondary address line, such as floor and apartment number."}]]}] 143f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"State or province of the address."}]]}] 1440:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"City of the address."}]]}] 1441:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"ISO 2-letter country code."}]]}] 1442:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Postal code of the address."}]]}] 1443:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The address of the event location."}]]}] 1444:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of the event."}]]}] 1445:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Indicates the relationship between the ticket vendor and the event organiser."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Parameter value","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"primary"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The merchant is the organiser and primary distributor of the tickets.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"secondary"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The merchant is a reseller, only distributing the tickets.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 1446:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A unique identifier provided by the merchant associated with the ticket."}]]}] 1447:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Indicates whether the ticket is transferable to another buyer."}]]}] 1448:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Parameter indicating whether the booking is refundable, partially refundable, or not refundable."}]]}] 1449:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object containing information about a ticket associated with the booking."}]]}] 144a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A list of tickets associated with the booking."}]]}] 144b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object containing booking information about a specific event."}]]}] 144c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A list of events associated with the booking."}]]}] 144d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object containing booking information for a list of event tickets associated with the order."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"These are the specific data field requirements for merchants who must provide event data. Note that these requirements can be extended on a case by case basis as decided by Revolut."}],"$L14ef"]}]]}]]}] 144e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Type of the industry-specific data object, determining what additional data is expected."}],"\n",["$","p","p-1",{"children":"Available types:"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Object type","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"airline"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about a specific airline ticket purchase.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"car_rental"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about a car rental booking associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"crypto"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about crypto transactions associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"marketplace"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["This object is required by Mastercard and Visa for merchants operating as marketplaces under the ",["$","strong","strong-0",{"children":"Merchant Category Code (MCC):"}]," ",["$","code","code-0",{"children":"5262"}],". The marketplace object ensures compliance with the card schemes' regulations by providing detailed information about the subseller involved in the transaction."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-4",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"event"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about event ticket bookings associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-5",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"lodging"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about lodging bookings associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 144f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A unique identifier provided by the merchant associated with the order."}],"\n",["$","p","p-1",{"children":["This ",["$","code","code-0",{"children":"booking_id"}]," is used to reference and correlate booking information with the Merchant API and the merchant's internal system."]}]]}] 1450:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":[["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_8601","target":"_blank","rel":"noreferrer","children":"ISO 8601"}]," date and time of the check-in."]}]]}] 1451:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":[["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_8601","target":"_blank","rel":"noreferrer","children":"ISO 8601"}]," date and time of the check-out."]}]]}] 1452:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":[["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_8601","target":"_blank","rel":"noreferrer","children":"ISO 8601"}]," date and time when the funds are released to merchants."]}]]}] 1453:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of the accommodation associated with the booking."}]]}] 1454:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Indicates whether the booking terms are fixed or flexible."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Parameter value","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"fixed"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Non-modifiable once confirmed.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"flexible"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Allows modifications or cancellations under specified conditions.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 1455:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Parameter indicating whether the booking is refundable, partially refundable, or not refundable."}]]}] 1456:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Primary address line."}]]}] 1457:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Secondary address line, such as floor and apartment number."}]]}] 1458:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"State or province of the address."}]]}] 1459:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"City of the address."}]]}] 145a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"ISO 2-letter country code."}]]}] 145b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Postal code of the address."}]]}] 145c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Address of the accommodation."}]]}] 145d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Guest's first name."}]]}] 145e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Guest's last name."}]]}] 145f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"List of guests associated with the booking."}]]}] 1460:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object containing details of a lodging booking."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"These are the specific data field requirements for merchants who must provide lodging data. Note that these requirements can be extended on a case by case basis as decided by Revolut."}],"$L14f0"]}]]}]]}] 1461:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object containing industry-specific information associated with the order."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"In the following cases, industry-specific info is required. Omitting this information may trigger additional scrutiny and risk mitigation actions by the Revolut risk team."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Transaction type","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Required for","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"airline"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Airlines and Online Travel Agencies (OTAs).","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"car_rental"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Car Rental Merchants and Online Travel Agencies (OTAs).","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"crypto"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Crypto merchants.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"marketplace"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Marketplace merchants.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-4",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"event"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Event ticket sellers.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-5",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"lodging"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Lodging providers.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}]]}]]}] 1462:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The URL of the order stored in the merchant's order management system."}],"\n",["$","p","p-1",{"children":["This URL will be included in the order confirmation email for payments made via Revolut Pay. If specified, this URL will override the default link to the merchant's ",["$","strong","strong-0",{"children":"Business website"}]," configured in the Revolut Business account."]}],"\n",["$","div","inlinealert-0",{"data-type":"warning","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMark","color":"var(--rui-color-warning)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"Restrictions:"}],["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["Must be a valid URI as defined by ",["$","a","a-0",{"href":"https://datatracker.ietf.org/doc/html/rfc3986","target":"_blank","rel":"noreferrer","children":"RFC 3986"}]]}],"\n",["$","li","li-1",{"children":["URI scheme is required and must be either ",["$","code","code-0",{"children":"http"}]," or ",["$","code","code-1",{"children":"https"}]]}],"\n",["$","li","li-2",{"children":["URI host is required and cannot be ",["$","code","code-0",{"children":"localhost"}]," or an IP address"]}],"\n",["$","li","li-3",{"children":["Max length: ",["$","code","code-0",{"children":"2000"}]]}],"\n",["$","li","li-4",{"children":["Reserved or invalid characters must be percent-encoded (for example, use ",["$","code","code-0",{"children":"%20"}]," instead of a space)"]}],"\n"]}]]}]]}]]}] 1463:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Merchant order ID for external reference."}],"\n",["$","p","p-1",{"children":"Use this field to set the ID that your own system can use to easily track orders."}]]}] 1464:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object for providing additional information stored in the merchant's order management system."}]]}] 1465:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The date and time in ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_8601","target":"_blank","rel":"noreferrer","children":"ISO 8601 format"}]," when the upcoming payment is scheduled to be executed."]}]]}] 1466:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The unique ID of the customer's payment method used to complete the scheduled payment."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"For more information about operations related to customer's payment methods, see:"}],["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#retrieve-payment-method-list","target":"_blank","rel":"noreferrer","children":"Retrieve payment method list of a customer"}]}],"\n",["$","li","li-1",{"children":["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#retrieve-payment-method","target":"_blank","rel":"noreferrer","children":"Retrieve a customer's payment method"}]}],"\n",["$","li","li-2",{"children":["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#update-payment-method","target":"_blank","rel":"noreferrer","children":"Update a customer's payment method"}]}],"\n",["$","li","li-3",{"children":["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#delete-payment-method","target":"_blank","rel":"noreferrer","children":"Delete a customer's payment method"}]}],"\n"]}]]}]]}]]}] 1467:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object containing information about upcoming payments associated with the order."}]]}] 1468:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Link to a checkout page hosted by Revolut."}]]}] 1469:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The URL your customer will be redirected to after a successful payment on the hosted checkout page (",["$","code","code-0",{"children":"checkout_url"}]," parameter's value of the order)."]}],"\n",["$","div","inlinealert-0",{"data-type":"warning","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMark","color":"var(--rui-color-warning)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"Restrictions:"}],["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["Must be a valid URI as defined by ",["$","a","a-0",{"href":"https://datatracker.ietf.org/doc/html/rfc3986","target":"_blank","rel":"noreferrer","children":"RFC 3986"}]]}],"\n",["$","li","li-1",{"children":["URI scheme is required and must be either ",["$","code","code-0",{"children":"http"}]," or ",["$","code","code-1",{"children":"https"}]]}],"\n",["$","li","li-2",{"children":["URI host is required and cannot be ",["$","code","code-0",{"children":"localhost"}]," or an IP address"]}],"\n",["$","li","li-3",{"children":["Max length: ",["$","code","code-0",{"children":"2000"}]]}],"\n",["$","li","li-4",{"children":["Reserved or invalid characters must be percent-encoded (for example, use ",["$","code","code-0",{"children":"%20"}]," instead of a space)"]}],"\n"]}]]}]]}],"\n",["$","div","inlinealert-1",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information on how to use the ",["$","code","code-0",{"children":"redirect_url"}],", see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/accept-payments/online-payments/hosted-checkout-page/api#custom-post-payment-redirection-optional","target":"_blank","rel":"noreferrer","children":"Custom redirection via the API"}]]}]}]]}]]}] 146a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Primary address line."}]]}] 146b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Secondary address line, such as floor and apartment number."}]]}] 146c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"State or province of the address."}]]}] 146d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"City of the address."}]]}] 146e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"ISO 2-letter country code."}]]}] 146f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Postal code of the address."}]]}] 1470:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Details of a physical address."}]]}] 1471:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Full name of the contact person."}]]}] 1472:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Email address of the contact person."}]]}] 1473:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Phone number of the contact person."}]]}] 1474:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Contact details for someone responsible for the shipment."}],"\n",["$","div","inlinealert-0",{"data-type":"warning","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMark","color":"var(--rui-color-warning)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["At least ",["$","code","code-0",{"children":"email"}]," or ",["$","code","code-1",{"children":"phone"}]," is required."]}]}]]}]]}] 1475:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Name of the company handling the shipment."}]]}] 1476:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unique tracking number for the shipment."}]]}] 1477:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Estimated delivery date and time for the shipment.\nThe time should also include the customer's timezone."}]]}] 1478:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An HTTP/HTTPS URL where the shipment can be tracked."}],"\n",["$","div","inlinealert-0",{"data-type":"warning","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMark","color":"var(--rui-color-warning)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"Restrictions:"}],["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["Must be a valid URI as defined by ",["$","a","a-0",{"href":"https://datatracker.ietf.org/doc/html/rfc3986","target":"_blank","rel":"noreferrer","children":"RFC 3986"}]]}],"\n",["$","li","li-1",{"children":["URI scheme is required and must be either ",["$","code","code-0",{"children":"http"}]," or ",["$","code","code-1",{"children":"https"}]]}],"\n",["$","li","li-2",{"children":["URI host is required and cannot be ",["$","code","code-0",{"children":"localhost"}]," or an IP address"]}],"\n",["$","li","li-3",{"children":["Max length: ",["$","code","code-0",{"children":"2000"}]]}],"\n",["$","li","li-4",{"children":["Reserved or invalid characters must be percent-encoded (for example, use ",["$","code","code-0",{"children":"%20"}]," instead of a space)"]}],"\n"]}]]}]]}]]}] 1479:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Details of an individual shipment."}]]}] 147a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"List of individual shipment details."}]]}] 147b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Details about the shipping related to the order, including address, contact information, and individual shipments."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":"Required for merchants shipping physical goods. Omitting this information may trigger additional scrutiny and risk mitigation actions by Revolut."}]}]]}]]}] 147c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The enforce challenge mode. ",["$","code","code-0",{"children":"automatic"}]," is used by default."]}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Parameter value","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"automatic"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The payments created for an order will have challenge requirement calculated by our fraud mechanisms. Not all payments will trigger a 3DS challenge.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"forced"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The payments created for an order will always require a 3DS challenge. Currently only supported for card payments.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 147d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An array of line items included in the order. Each line item represents an individual product or service, along with its quantity, price, taxes, and discounts."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":"Required for merchants collecting payment for one or multiple products/services in one transaction. Omitting this information may trigger additional scrutiny and risk mitigation actions by Revolut."}]}]]}]]}] 147f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"You can set a dynamic statement descriptor for your orders by providing a custom suffix."}],"\n",["$","p","p-1",{"children":"A statement descriptor is the text shown on cardholders' bank or card statements, helping them recognise a transaction or merchant. This field can be used to send extra information with the statement descriptor for card transactions."}],"\n",["$","p","p-2",{"children":["The complete descriptor is built using the following format: ",["$","code","code-0",{"children":"{base}*{suffix}"}],", where:"]}],"\n",["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":[["$","strong","strong-0",{"children":["$","code","code-0",{"children":"{base}"}]}]," is the existing descriptor configured in the Revolut Business dashboard (",["$","strong","strong-1",{"children":"Settings > Business account > Merchant profile > Statement descriptor"}],")."]}],"\n",["$","li","li-1",{"children":[["$","strong","strong-0",{"children":["$","code","code-0",{"children":"{suffix}"}]}]," is defined by the ",["$","code","code-0",{"children":"statement_descriptor_suffix"}]," field."]}],"\n"]}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["If the combined descriptor's length (base + suffix) exceeds the character limits of card scheme providers, the final value will be truncated. For example if the limit is 22 characters, the base descriptor is ",["$","code","code-0",{"children":"\"base\""}]," and the suffix is ",["$","code","code-1",{"children":"\"testdescriptorsuffix\""}],", the final descriptor becomes ",["$","code","code-2",{"children":"\"base*testdescriptorsuf\""}],"."]}],"\n",["$","li","li-1",{"children":"The final statement descriptor shown on a cardholder's statement may vary by issuing bank, as some banks apply their own custom formatting or truncation rules."}],"\n"]}]}]]}]]}] 1480:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The unique ID of the original order that was refunded and this refund is associated with. You can use this ID to get more information about the related order using the ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#retrieve-order","target":"_blank","rel":"noreferrer","children":"Retrieve an order"}]," operation."]}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["This field is only returned for orders with ",["$","code","code-0",{"children":"type: refund"}],"."]}]}]]}]]}] 1481:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unique identifier for the subscription."}]]}] 1482:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The unique identifier of the active (pre-paid) subscription cycle that this order collects payment for."}],"\n",["$","p","p-1",{"children":"This is the current billing cycle whose recurring charges are being collected in advance by this order. For example, if a subscription cycle covers 1-31 July and the order is generated on 1 July, this field identifies that July cycle."}]]}] 1483:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The unique identifier of the settled (post-paid) subscription cycle whose usage-based charges this order collects."}],"\n",["$","p","p-1",{"children":"This is the previous billing cycle whose usage is being settled by this order. For example, if a subscription cycle covers usage from 1-30 June and the order is generated on 10 July, this field identifies that June cycle."}]]}] 1484:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The reason this subscription order was created."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Value","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"cycle_billing"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["The order was automatically generated to collect payment for an ongoing subscription cycle. ",["$","code","code-0",{"children":"active_cycle_id"}]," is present; ",["$","code","code-1",{"children":"settled_cycle_id"}]," is present if the previous cycle included usage-based products."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"final_settlement"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["The order was automatically generated after the subscription ended to collect outstanding usage-based charges. ",["$","code","code-0",{"children":"active_cycle_id"}]," is absent; ",["$","code","code-1",{"children":"settled_cycle_id"}]," is present."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"setup_intent"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["The order was manually created by the merchant or customer to update the payment method on file. ",["$","code","code-0",{"children":"active_cycle_id"}]," is absent; ",["$","code","code-1",{"children":"settled_cycle_id"}]," is absent."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 1485:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Subscription details linked to the order. Use this object to match an order with its underlying subscription and understand the billing context in which the order was created."}],"\n",["$","p","p-1",{"children":"Only present on orders created by a subscription."}]]}] 1486:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["To process the order from a credit or debit card, you create an ",["$","code","code-0",{"children":"Order"}]," object. You can then retrieve, capture, cancel, refund, or pay an order using its unique ",["$","code","code-1",{"children":"id"}],". Alternatively, you can use its unique ",["$","code","code-2",{"children":"token"}]," to process a card payment with the Revolut Checkout Widget."]}]]}] 1487:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"OK"}]]}] 1488:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An identifier that can be used to determine what went wrong."}],"\n",["$","p","p-1",{"children":"Error codes are not globally unique, but uniqueness is guaranteed within endpoints."}]]}] 1489:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Some human readable text describing what went wrong."}]]}] 148a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://www.unixtimestamp.com/","target":"_blank","rel":"noreferrer","children":"UNIX timestamp"}]," of the date and time the error happened."]}]]}] 148b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Bad Request"}]]}] 148c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An identifier that can be used to determine what went wrong."}],"\n",["$","p","p-1",{"children":"Error codes are not globally unique, but uniqueness is guaranteed within endpoints."}]]}] 148d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Some human readable text describing what went wrong."}]]}] 148e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://www.unixtimestamp.com/","target":"_blank","rel":"noreferrer","children":"UNIX timestamp"}]," of the date and time the error happened."]}]]}] 148f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unauthorized"}]]}] 1490:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An identifier that can be used to determine what went wrong."}],"\n",["$","p","p-1",{"children":"Error codes are not globally unique, but uniqueness is guaranteed within endpoints."}]]}] 1491:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Some human readable text describing what went wrong."}]]}] 1492:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://www.unixtimestamp.com/","target":"_blank","rel":"noreferrer","children":"UNIX timestamp"}]," of the date and time the error happened."]}]]}] 1493:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Not Found"}]]}] 14aa:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Cancel an existing uncaptured order."}],"\n",["$","p","p-1",{"children":"You can only cancel an order that is in one of the following states:"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Order state","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"pending"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The order does not have any successful payment.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"authorised"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["The ",["$","code","code-0",{"children":"capture_mode"}]," of an order is set to ",["$","code","code-1",{"children":"manual"}]," and the customer has made a successful payment."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information about the order lifecycle, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/reference/order-lifecycle","target":"_blank","rel":"noreferrer","children":"Order and payment lifecycle"}],"."]}]}]]}]]}] 14ab:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["This parameter accepts the ",["$","a","a-0",{"href":"https://business.revolut.com/settings/apis?tab=merchant-api","target":"_blank","rel":"noreferrer","children":"Merchant API Secret key"}]," to authorise requests coming from the merchant's backend."]}],"\n",["$","p","p-1",{"children":["It ensures that ensures that each request is authenticated and authorised by verifying the secret key. The secret key should be included in all request headers as a ",["$","code","code-0",{"children":"Bearer"}]," token."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#authentication","target":"_blank","rel":"noreferrer","children":"Authentication"}]]}]}]]}]]}] 14ac:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The version of the Merchant API, specified in ",["$","code","code-0",{"children":"YYYY-MM-DD"}]," format."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information about API versioning, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/reference/versioning/api-versions","target":"_blank","rel":"noreferrer","children":"API versions"}],"."]}]}]]}]]}] 14ad:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A UUID string, typically used to identify resources."}]]}] 14ae:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ID of the ",["$","code","code-0",{"children":"Order"}]," object."]}]]}] 14d9:["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#cancel-order","target":"_blank","rel":"noreferrer","children":"Cancel the order"}] 14da:["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#cancel-order","target":"_blank","rel":"noreferrer","children":"Cancel the order"}] 14db:["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#cancel-order","target":"_blank","rel":"noreferrer","children":"Cancel the order"}] 14dc:["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#cancel-order","target":"_blank","rel":"noreferrer","children":"Cancel the order"}] 14dd:["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#cancel-order","target":"_blank","rel":"noreferrer","children":"Cancel the order"}] 14e5:["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#cancel-order","target":"_blank","rel":"noreferrer","children":"Cancel the order"}] 14e6:["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#cancel-order","target":"_blank","rel":"noreferrer","children":"Cancel the order"}] 14e7:["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#cancel-order","target":"_blank","rel":"noreferrer","children":"Cancel the order"}] 14e8:["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#cancel-order","target":"_blank","rel":"noreferrer","children":"Cancel the order"}] 14e9:["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#cancel-order","target":"_blank","rel":"noreferrer","children":"Cancel the order"}] 14bc:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Each Merchant API request must contain an authorization header in the following format:"}],"\n","$L14f1","\n",["$","p","p-1",{"children":"To use this API, you need to generate API keys from your Revolut Business account. The Secret key is used in the authorization header for all server calls, while the Public key is provided with payment methods at checkout."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For detailed instructions on generating your API keys, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/get-started#generate-api-keys","target":"_blank","rel":"noreferrer","children":"Generate API keys"}],"."]}]}]]}]]}] 14cc:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Each Merchant API request must contain an authorization header in the following format:"}],"\n","$L14f2","\n",["$","p","p-1",{"children":"To use this API, you need to generate API keys from your Revolut Business account. The Secret key is used in the authorization header for all server calls, while the Public key is provided with payment methods at checkout."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For detailed instructions on generating your API keys, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/get-started#generate-api-keys","target":"_blank","rel":"noreferrer","children":"Generate API keys"}],"."]}]}]]}]]}] 14f3:Tfc9,
{
  "id": "6516e61c-d279-a454-a837-bc52ce55ed49",
  "token": "0adc0e3c-ab44-4f33-bcc0-534ded7354ce",
  "type": "payment",
  "state": "pending",
  "created_at": "2023-09-29T14:58:36.079398Z",
  "updated_at": "2023-09-29T14:58:36.079398Z",
  "amount": 500,
  "currency": "GBP",
  "outstanding_amount": 500,
  "capture_mode": "automatic",
  "authorisation_type": "final",
  "checkout_url": "https://checkout.revolut.com/payment-link/0adc0e3c-ab44-4f33-bcc0-534ded7354ce",
  "enforce_challenge": "automatic"
}
14bd:["$","div","200-application/json-example_order_min_params",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$14f3"}}]}]],"$L14f4"]}] 14f5:T2242,
{
  "id": "6516e6ec-c7f7-a0fb-a6d3-add05fa46d2f",
  "token": "1058031d-1e71-4d07-9f97-5ad388a1346c",
  "type": "payment",
  "state": "pending",
  "created_at": "2023-09-29T15:02:04.083787Z",
  "updated_at": "2023-09-29T15:02:04.083787Z",
  "amount": 500,
  "currency": "GBP",
  "outstanding_amount": 500,
  "capture_mode": "manual",
  "authorisation_type": "final",
  "cancel_authorised_after": "PT30M",
  "description": "Example product",
  "checkout_url": "https://checkout.revolut.com/payment-link/1058031d-1e71-4d07-9f97-5ad388a1346c",
  "redirect_url": "https://www.example.com/redirect",
  "shipping": {
    "address": {
      "street_line_1": "7 Westferry Circus",
      "city": "London",
      "country_code": "GB",
      "postcode": "E14 4HD"
    }
  },
  "metadata": {
    "product_type": "Example"
  },
  "enforce_challenge": "forced",
  "customer": {
    "id": "467646d6-e452-4d1e-a401-703f09cd3818",
    "email": "example@example.com",
    "date_of_birth": "1990-01-01"
  },
  "merchant_order_data": {
    "url": "https://example.com/orders/12345"
  },
  "statement_descriptor_suffix": "12345"
}
14be:["$","div","200-application/json-example_order_additional",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$14f5"}}]}]],"$L14f6"]}] 14f7:T31d6,
{
  "id": "6516e61c-d279-a454-a837-bc52ce55ed49",
  "token": "0adc0e3c-ab44-4f33-bcc0-534ded7354ce",
  "type": "payment",
  "state": "authorised",
  "created_at": "2023-09-29T14:58:36.079398Z",
  "updated_at": "2023-09-29T14:58:36.079398Z",
  "amount": 5000,
  "currency": "GBP",
  "outstanding_amount": 5000,
  "capture_mode": "manual",
  "authorisation_type": "pre_authorisation",
  "cancel_authorised_after": "PT72H",
  "description": "Hotel reservation deposit",
  "checkout_url": "https://checkout.revolut.com/payment-link/0adc0e3c-ab44-4f33-bcc0-534ded7354ce",
  "enforce_challenge": "automatic",
  "payments": [
    {
      "id": "6516f38a-a12b-aca3-83f2-6ed16d6ed246",
      "state": "authorised",
      "created_at": "2023-09-29T14:55:54.579311Z",
      "updated_at": "2023-09-29T14:56:38.403232Z",
      "amount": 5000,
      "currency": "GBP",
      "settled_amount": 5000,
      "settled_currency": "GBP",
      "billing_address": {
        "country_code": "GB",
        "postcode": "SW1A 1AA"
      },
      "risk_level": "low",
      "fees": [],
      "payer": {
        "email": "example.payer@example.com",
        "phone": "+447911123456"
      },
      "payment_method": {
        "type": "card",
        "card_brand": "visa",
        "funding": "credit",
        "card_country_code": "GB",
        "card_bin": "411111",
        "card_last_four": "1111",
        "card_expiry": "12/25",
        "cardholder_name": "Example Holder",
        "capture_deadline": "2023-10-06T14:55:54.579311Z",
        "fingerprint": "1JAllfQY4POhBV8DaddAQ4LC5RbMP8LMLvUdJW4s5JY=",
        "network_transaction_id": "1234567890123456"
      }
    }
  ]
}
14bf:["$","div","200-application/json-example_order_pre_auth",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$14f7"}}]}]],"$L14f8"]}] 14f9:T3a2e,
{
  "id": "66bcc998-4209-ac6e-96fe-2910b949c516",
  "token": "0bcfcc1d-9ee9-4476-b36c-cf4abba2e45a",
  "type": "payment",
  "state": "pending",
  "created_at": "2024-08-14T15:13:28.814729Z",
  "updated_at": "2024-08-14T15:13:28.814729Z",
  "amount": 770,
  "currency": "GBP",
  "outstanding_amount": 770,
  "capture_mode": "automatic",
  "authorisation_type": "final",
  "checkout_url": "https://checkout.revolut.com/payment-link/0bcfcc1d-9ee9-4476-b36c-cf4abba2e45a",
  "enforce_challenge": "automatic",
  "line_items": [
    {
      "name": "Example item 1",
      "unit_price_amount": 100,
      "quantity": {
        "value": 2,
        "unit": "kg"
      },
      "type": "physical",
      "discounts": [
        {
          "name": "Discount 1",
          "amount": 50
        }
      ],
      "taxes": [
        {
          "name": "10% VAT",
          "amount": 20
        }
      ],
      "total_amount": 170,
      "image_urls": [
        "https://www.example.com/line-item-image1",
        "https://www.example.com/line-item-image2"
      ],
      "description": "First line item",
      "external_id": "external_id_123",
      "url": "https://www.example.com"
    },
    {
      "name": "Example item 2",
      "unit_price_amount": 100,
      "quantity": {
        "value": 10,
        "unit": "pieces"
      },
      "type": "service",
      "discounts": [
        {
          "name": "Discount 2",
          "amount": 500
        }
      ],
      "taxes": [
        {
          "name": "10% VAT",
          "amount": 100
        }
      ],
      "total_amount": 600,
      "image_urls": [
        "https://www.example.com/line_item_image3",
        "https://www.example.com/line_item_image4"
      ],
      "description": "Second line item",
      "external_id": "external_id_456",
      "url": "https://www.example.com"
    }
  ]
}
14c0:["$","div","200-application/json-example_order_line_items",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$14f9"}}]}]],"$L14fa"]}] 14fb:T1456,
{
  "id": "7a1b2c3d-4e5f-6789-abcd-e1234567890a",
  "token": "9f8e7d6c-5b4a-3210-fedc-ba0987654321",
  "type": "payment",
  "state": "completed",
  "created_at": "2025-06-15T10:30:00.000000Z",
  "updated_at": "2025-06-15T10:31:00.000000Z",
  "amount": 1999,
  "currency": "GBP",
  "outstanding_amount": 0,
  "capture_mode": "automatic",
  "authorisation_type": "final",
  "checkout_url": "https://checkout.revolut.com/payment-link/9f8e7d6c-5b4a-3210-fedc-ba0987654321",
  "enforce_challenge": "automatic",
  "subscription_data": {
    "subscription_id": "e2862e0e-66e8-4623-bdd6-7da59b85365d",
    "active_cycle_id": "a1b2c3d4-5678-9012-abcd-ef1234567890",
    "billing_reason": "cycle_billing"
  }
}
14c1:["$","div","200-application/json-example_order_subscription",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$14fb"}}]}]],"$L14fc"]}] 14fd:T226e,
{
  "id": "66c5e449-36d3-af78-a832-328150ddc6a3",
  "token": "b1145e3e-30c7-4dd6-b84c-680dccd39dde",
  "type": "payment",
  "state": "pending",
  "created_at": "2024-08-21T12:57:45.793605Z",
  "updated_at": "2024-08-21T12:57:45.793605Z",
  "amount": 770,
  "currency": "GBP",
  "outstanding_amount": 770,
  "capture_mode": "automatic",
  "authorisation_type": "final",
  "checkout_url": "https://checkout.revolut.com/payment-link/b1145e3e-30c7-4dd6-b84c-680dccd39dde",
  "shipping": {
    "address": {
      "street_line_1": "Example Street 123",
      "street_line_2": "II/123",
      "region": "London",
      "city": "London",
      "country_code": "GB",
      "postcode": "123456"
    },
    "contact": {
      "name": "Example Contact",
      "email": "example.contact@example.com",
      "phone": "+441234567890"
    },
    "shipments": [
      {
        "shipping_company_name": "Example Shipping Co.",
        "tracking_number": "123456789",
        "estimated_delivery_date": "2024-12-03T10:15:30+02:00[Europe/Paris]",
        "tracking_url": "https://www.example.com/tracking/123456789"
      }
    ]
  },
  "enforce_challenge": "automatic"
}
14c2:["$","div","200-application/json-example_order_shipping",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$14fd"}}]}]],"$L14fe"]}] 14ff:T539a,
{
  "id": "6516ed0c-098f-aa19-80e5-9d92f52b35e0",
  "token": "061f2c63-e36b-421e-9ece-5adfcd580886",
  "type": "payment",
  "state": "pending",
  "created_at": "2023-09-29T15:28:12.114992Z",
  "updated_at": "2023-09-29T15:28:12.114992Z",
  "amount": 500,
  "currency": "GBP",
  "outstanding_amount": 500,
  "settlement_currency": "EUR",
  "capture_mode": "manual",
  "authorisation_type": "final",
  "description": "Example order description",
  "checkout_url": "https://checkout.revolut.com/payment-link/061f2c63-e36b-421e-9ece-5adfcd580886",
  "redirect_url": "https://www.example.com/redirect",
  "cancel_authorised_after": "PT30M",
  "industry_data": {
    "type": "airline",
    "booking_id": "unique-booking-id-12345",
    "fulfillment_date": "2023-07-10T14:00:00.069624Z",
    "ticket_type": "flexible",
    "crs_code": "DATS",
    "ticket_change_indicator": "new",
    "refundability": "refundable",
    "passengers": [
      {
        "first_name": "Example",
        "last_name": "Customer"
      },
      {
        "first_name": "John",
        "last_name": "Doe"
      }
    ],
    "journey_legs": [
      {
        "sequence": 1,
        "departure_airport_code": "FRA",
        "arrival_airport_code": "LHR",
        "flight_number": "670",
        "fare_base_code": "J",
        "travel_date": "2023-07-10T10:00:00.069624Z",
        "airline_name": "AerLingus",
        "airline_code": "EI"
      },
      {
        "sequence": 2,
        "departure_airport_code": "LHR",
        "arrival_airport_code": "DUB",
        "flight_number": "678",
        "fare_base_code": "J",
        "travel_date": "2023-07-10T15:00:00.069624Z",
        "airline_name": "AerLingus",
        "airline_code": "EI"
      },
      {
        "sequence": 3,
        "departure_airport_code": "DUB",
        "arrival_airport_code": "LHR",
        "flight_number": "679",
        "fare_base_code": "F",
        "travel_date": "2023-07-15T10:00:00.069624Z",
        "airline_name": "AerLingus",
        "airline_code": "EI"
      },
      {
        "sequence": 4,
        "departure_airport_code": "LHR",
        "arrival_airport_code": "FRA",
        "flight_number": "671",
        "fare_base_code": "F",
        "travel_date": "2023-07-10T14:00:00.069624Z",
        "airline_name": "AerLingus",
        "airline_code": "EI"
      }
    ],
    "booking_url": "https://example.com/bookings/1234"
  },
  "enforce_challenge": "forced",
  "customer": {
    "id": "db186257-3031-4726-98ea-f2260ea115f0",
    "email": "example@example.com",
    "phone": "+441234567890",
    "full_name": "Example Customer"
  },
  "merchant_order_data": {
    "url": "https://www.example.com/ticketnumber-12345",
    "reference": "example_airline_reference"
  }
}
14c3:["$","div","200-application/json-example_order_airline",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$14ff"}}]}]],"$L1500"]}] 1501:T33ef,
{
  "id": "6516ed0c-098f-aa19-80e5-9d92f52b35e0",
  "token": "061f2c63-e36b-421e-9ece-5adfcd580886",
  "type": "payment",
  "state": "pending",
  "created_at": "2025-01-29T15:28:12.114992Z",
  "updated_at": "2025-01-29T15:28:12.114992Z",
  "amount": 500,
  "currency": "GBP",
  "outstanding_amount": 500,
  "settlement_currency": "GBP",
  "capture_mode": "manual",
  "authorisation_type": "final",
  "description": "Example car rental order",
  "checkout_url": "https://checkout.revolut.com/payment-link/061f2c63-e36b-421e-9ece-5adfcd580886",
  "redirect_url": "https://www.example.com/redirect",
  "cancel_authorised_after": "PT30M",
  "industry_data": {
    "type": "car_rental",
    "booking_id": "example_booking_id",
    "pick_up_date": "2026-03-01T11:00:00Z",
    "drop_off_date": "2026-03-05T16:30:00Z",
    "refundability": "partially_refundable",
    "pick_up_location": {
      "street_line_1": "1 Example Street",
      "city": "London",
      "country_code": "GB",
      "postcode": "SW1A 1AA"
    },
    "drop_off_location": {
      "street_line_1": "10 Another Road",
      "city": "Manchester",
      "country_code": "GB",
      "postcode": "M1 1AA"
    },
    "distance_limit": {
      "limit": 500,
      "unit": "miles",
      "additional_distance_cost": {
        "amount": 150,
        "currency": "GBP"
      }
    }
  },
  "enforce_challenge": "forced",
  "customer": {
    "id": "db186257-3031-4726-98ea-f2260ea115f0",
    "email": "example@example.com",
    "phone": "+447700900000",
    "full_name": "Example Customer"
  },
  "merchant_order_data": {
    "url": "https://www.example.com/rental/example_booking_id",
    "reference": "example_car_rental_reference"
  }
}
14c4:["$","div","200-application/json-example_order_car_rental",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$1501"}}]}]],"$L1502"]}] 1503:T2e90,
{
  "id": "6516edb9-74af-ae47-829b-1475e807a8d7",
  "token": "1e619c26-d954-4d45-94ab-aba1e407fcee",
  "type": "payment",
  "state": "pending",
  "created_at": "2023-09-29T15:31:05.746826Z",
  "updated_at": "2023-09-29T15:31:05.746826Z",
  "amount": 26100,
  "currency": "EUR",
  "outstanding_amount": 26100,
  "settlement_currency": "EUR",
  "capture_mode": "manual",
  "authorisation_type": "final",
  "description": "Customer wants to buy 0.01 BTC",
  "checkout_url": "https://checkout.revolut.com/payment-link/1e619c26-d954-4d45-94ab-aba1e407fcee",
  "redirect_url": "https://www.example.com/redirect",
  "industry_data": {
    "type": "crypto",
    "transactions": [
      {
        "id": "7b2a8ed4-5889-4c0c-a8cc-299aff1c881b",
        "status": "pending",
        "recipient_wallet_id": "64a6f159-0a60-a446-880e-e449a1f62f7c"
      }
    ],
    "seller": {
      "id": "a13638ab-3e90-4b05-9f69-23abc655775b",
      "name": "Ramp Provider Company Name",
      "website": "https://example.com",
      "phone": "123456789",
      "mcc": "6051",
      "address": {
        "street_line_1": "456 Crypto Ave",
        "city": "New York",
        "postcode": "10001",
        "country_code": "US"
      }
    }
  },
  "enforce_challenge": "automatic",
  "customer": {
    "id": "db186257-3031-4726-98ea-f2260ea115f0",
    "email": "example@example.com",
    "phone": "+44123456789",
    "full_name": "Example Customer"
  },
  "merchant_order_data": {
    "url": "https://www.example.com/cryptotransactionnumber-12345",
    "reference": "example_crypto_reference"
  }
}
14c5:["$","div","200-application/json-example_order_crypto",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$1503"}}]}]],"$L1504"]}] 1505:T1fa0,
{
  "id": "670920dc-d343-abf8-963a-68ae1bc8ae58",
  "token": "41aabe45-b444-45e6-8363-f0433452e138",
  "type": "payment",
  "state": "pending",
  "created_at": "2024-10-11T12:58:04.826974Z",
  "updated_at": "2024-10-11T12:58:04.826974Z",
  "amount": 10000,
  "currency": "EUR",
  "outstanding_amount": 10000,
  "capture_mode": "automatic",
  "authorisation_type": "final",
  "checkout_url": "https://checkout.revolut.com/payment-link/41aabe45-b444-45e6-8363-f0433452e138",
  "industry_data": {
    "type": "marketplace",
    "seller": {
      "id": "123-45-67",
      "name": "Example Seller",
      "address": {
        "street_line_1": "1 Canada Square",
        "street_line_2": "Revolut LTD, Level 39",
        "region": "Greater London",
        "city": "London",
        "country_code": "GB",
        "country_subdivision_code": "GB-LND",
        "postcode": "E14 4HD"
      },
      "website": "https://example.com/123-45-67",
      "phone": "+441234567890"
    }
  },
  "enforce_challenge": "automatic"
}
14c6:["$","div","200-application/json-example_order_marketplace",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$1505"}}]}]],"$L1506"]}] 1507:T2e6f,
{
  "id": "67bf20c4-59a5-a7a9-81ad-052fda5f80eb",
  "token": "8737a497-9bae-4647-90bf-1abe2fd9162a",
  "type": "payment",
  "state": "pending",
  "created_at": "2025-02-26T14:10:12.804901Z",
  "updated_at": "2025-02-26T14:10:12.804901Z",
  "amount": 100,
  "currency": "GBP",
  "outstanding_amount": 100,
  "capture_mode": "automatic",
  "authorisation_type": "final",
  "checkout_url": "https://checkout.revolut.com/payment-link/8737a497-9bae-4647-90bf-1abe2fd9162a",
  "industry_data": {
    "type": "event",
    "booking_id": "example_booking_123",
    "events": [
      {
        "start_date": "2025-03-04T14:00:00Z",
        "end_date": "2025-03-04T17:00:00Z",
        "supplier": "Example Supplier",
        "supplier_payment_date": "2025-03-03T14:00:15Z",
        "name": "Example Event",
        "location": {
          "street_line_1": "Example Street 123",
          "street_line_2": "II/123",
          "region": "London",
          "city": "London",
          "country_code": "GB",
          "postcode": "123456"
        },
        "category": "exhibition",
        "market": "primary",
        "tickets": [
          {
            "id": "example_ticket_1",
            "transferable": false,
            "refundability": "partially_refundable"
          },
          {
            "id": "example_ticket_2",
            "transferable": true,
            "refundability": "non_refundable"
          },
          {
            "id": "example_ticket_3"
          }
        ]
      }
    ]
  },
  "enforce_challenge": "automatic"
}
14c7:["$","div","200-application/json-example_order_event",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$1507"}}]}]],"$L1508"]}] 1509:T2735,
{
  "id": "67c70d42-1545-a73d-a4a5-35b7ac49e1da",
  "token": "9effe2b6-8907-4954-9e9b-696f763f7e08",
  "type": "payment",
  "state": "pending",
  "created_at": "2025-03-04T14:25:06.099782Z",
  "updated_at": "2025-03-04T14:25:06.099782Z",
  "amount": 100,
  "currency": "GBP",
  "outstanding_amount": 100,
  "capture_mode": "automatic",
  "authorisation_type": "final",
  "checkout_url": "https://checkout.revolut.com/payment-link/9effe2b6-8907-4954-9e9b-696f763f7e08",
  "industry_data": {
    "type": "lodging",
    "booking_id": "example_booking_123",
    "check_out_date": "2025-05-05T11:00:00Z",
    "booking_type": "flexible",
    "refundability": "partially_refundable",
    "location": {
      "street_line_1": "Example Street 123",
      "street_line_2": "II/123",
      "region": "London",
      "city": "London",
      "country_code": "GB",
      "postcode": "123456"
    },
    "guests": [
      {
        "first_name": "First",
        "last_name": "Guest"
      },
      {
        "first_name": "Second",
        "last_name": "Guest"
      }
    ],
    "check_in_date": "2025-05-01T15:00:00Z",
    "supplier_payment_date": "2025-05-05T11:00:00Z",
    "category": "bed_and_breakfast"
  },
  "enforce_challenge": "automatic"
}
14c8:["$","div","200-application/json-example_order_lodging",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$1509"}}]}]],"$L150a"]}] 150b:T46a,
{
  "code": "bad_request",
  "message": "Could not parse JSON",
  "timestamp": 1601296792533
}
14c9:["$","div","400-application/json-example-1",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$150b"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"code\": \"bad_request\",\n \"message\": \"Could not parse JSON\",\n \"timestamp\": 1601296792533\n}"}]}]]}] 150c:T46f,
{
  "code": "unauthenticated",
  "message": "Authentication failed",
  "timestamp": 1721049596461
}
14ca:["$","div","401-application/json-default",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$150c"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"code\": \"unauthenticated\",\n \"message\": \"Authentication failed\",\n \"timestamp\": 1721049596461\n}"}]}]]}] 150d:T494,
{
  "code": "not_found",
  "message": "Order with id abfa5bbd-a20c-4a0e-be66-30e733454518 was not found",
  "timestamp": 1721050063886
}
14cb:["$","div","404-application/json-default",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$150d"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"code\": \"not_found\",\n \"message\": \"Order with id abfa5bbd-a20c-4a0e-be66-30e733454518 was not found\",\n \"timestamp\": 1721050063886\n}"}]}]]}] 150e:Tf7d,
{
  "id": "6516f565-c903-ae7d-8582-0bc70468ec29",
  "token": "579462b3-da89-4a46-8690-572d3968573f",
  "type": "payment",
  "state": "cancelled",
  "created_at": "2023-09-29T16:03:49.569437Z",
  "updated_at": "2023-09-29T16:04:30.727004Z",
  "amount": 500,
  "currency": "GBP",
  "refunded_amount": 0,
  "outstanding_amount": 0,
  "capture_mode": "automatic",
  "authorisation_type": "final",
  "enforce_challenge": "automatic"
}
14cd:["$","div","200-application/json-example_order_min",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$150e"}}]}]],"$L150f"]}] 1510:T3c4c,
{
  "id": "6516f379-c03f-adf3-a2bf-24b328909731",
  "token": "91533c29-47d1-4ae9-a73f-74225fd4b176",
  "type": "payment",
  "state": "cancelled",
  "created_at": "2023-09-29T15:55:37.201407Z",
  "updated_at": "2023-09-29T15:56:38.398961Z",
  "amount": 500,
  "currency": "GBP",
  "refunded_amount": 0,
  "outstanding_amount": 500,
  "capture_mode": "manual",
  "authorisation_type": "final",
  "cancel_authorised_after": "PT30M",
  "description": "Example product",
  "checkout_url": "https://checkout.revolut.com/payment-link/91533c29-47d1-4ae9-a73f-74225fd4b176",
  "redirect_url": "https://www.example.com/redirect",
  "shipping_address": {
    "street_line_1": "7 Westferry Circus",
    "city": "London",
    "country_code": "GB",
    "postcode": "E14 4HD"
  },
  "metadata": {
    "product_type": "Example"
  },
  "payments": [
    {
      "id": "6516f38a-a12b-aca3-83f2-6ed16d6ed246",
      "state": "authorised",
      "created_at": "2023-09-29T15:55:54.579311Z",
      "updated_at": "2023-09-29T15:56:38.403232Z",
      "amount": 500,
      "currency": "GBP",
      "settled_amount": 500,
      "settled_currency": "GBP",
      "billing_address": {
        "street_line_1": "26 Atkins Avenue",
        "street_line_2": "New York 42233",
        "city": "SentinelFraudLow",
        "country_code": "GB",
        "postcode": "PE3 9UP"
      },
      "risk_level": "low",
      "fees": [],
      "payer": {
        "email": "example.payer@example.com",
        "phone": "+447911123456"
      },
      "payment_method": {
        "type": "revolut_pay_account",
        "fingerprint": "1JAllfQY4POhBV8DaddAQ4LC5RbMP8LMLvUdJW4s5JY="
      }
    }
  ],
  "enforce_challenge": "forced",
  "customer": {
    "id": "3c131306-0a0a-4f54-99d7-3fb2e027c6f7",
    "email": "example@example.com",
    "phone": "+441234567890",
    "full_name": "Example Customer"
  },
  "merchant_order_data": {
    "url": "https://example.com/orders/12345"
  },
  "statement_descriptor_suffix": "12345"
}
14ce:["$","div","200-application/json-example_order_additional",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$1510"}}]}]],"$L1511"]}] 1512:T3a30,
{
  "id": "66bcc998-4209-ac6e-96fe-2910b949c516",
  "token": "0bcfcc1d-9ee9-4476-b36c-cf4abba2e45a",
  "type": "payment",
  "state": "cancelled",
  "created_at": "2024-08-14T15:13:28.814729Z",
  "updated_at": "2024-08-14T15:13:28.814729Z",
  "amount": 770,
  "currency": "GBP",
  "outstanding_amount": 770,
  "capture_mode": "automatic",
  "authorisation_type": "final",
  "checkout_url": "https://checkout.revolut.com/payment-link/0bcfcc1d-9ee9-4476-b36c-cf4abba2e45a",
  "enforce_challenge": "automatic",
  "line_items": [
    {
      "name": "Example item 1",
      "unit_price_amount": 100,
      "quantity": {
        "value": 2,
        "unit": "kg"
      },
      "type": "physical",
      "discounts": [
        {
          "name": "Discount 1",
          "amount": 50
        }
      ],
      "taxes": [
        {
          "name": "10% VAT",
          "amount": 20
        }
      ],
      "total_amount": 170,
      "image_urls": [
        "https://www.example.com/line-item-image1",
        "https://www.example.com/line-item-image2"
      ],
      "description": "First line item",
      "external_id": "external_id_123",
      "url": "https://www.example.com"
    },
    {
      "name": "Example item 2",
      "unit_price_amount": 100,
      "quantity": {
        "value": 10,
        "unit": "pieces"
      },
      "type": "service",
      "discounts": [
        {
          "name": "Discount 2",
          "amount": 500
        }
      ],
      "taxes": [
        {
          "name": "10% VAT",
          "amount": 100
        }
      ],
      "total_amount": 600,
      "image_urls": [
        "https://www.example.com/line_item_image3",
        "https://www.example.com/line_item_image4"
      ],
      "description": "Second line item",
      "external_id": "external_id_456",
      "url": "https://www.example.com"
    }
  ]
}
14cf:["$","div","200-application/json-example_order_line_items",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$1512"}}]}]],"$L1513"]}] 1514:T2270,
{
  "id": "66c5e449-36d3-af78-a832-328150ddc6a3",
  "token": "b1145e3e-30c7-4dd6-b84c-680dccd39dde",
  "type": "payment",
  "state": "cancelled",
  "created_at": "2024-08-21T12:57:45.793605Z",
  "updated_at": "2024-08-21T12:57:45.793605Z",
  "amount": 770,
  "currency": "GBP",
  "outstanding_amount": 770,
  "capture_mode": "automatic",
  "authorisation_type": "final",
  "checkout_url": "https://checkout.revolut.com/payment-link/b1145e3e-30c7-4dd6-b84c-680dccd39dde",
  "shipping": {
    "address": {
      "street_line_1": "Example Street 123",
      "street_line_2": "II/123",
      "region": "London",
      "city": "London",
      "country_code": "GB",
      "postcode": "123456"
    },
    "contact": {
      "name": "Example Contact",
      "email": "example.contact@example.com",
      "phone": "+441234567890"
    },
    "shipments": [
      {
        "shipping_company_name": "Example Shipping Co.",
        "tracking_number": "123456789",
        "estimated_delivery_date": "2024-12-03T10:15:30+02:00[Europe/Paris]",
        "tracking_url": "https://www.example.com/tracking/123456789"
      }
    ]
  },
  "enforce_challenge": "automatic"
}
14d0:["$","div","200-application/json-example_order_shipping",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$1514"}}]}]],"$L1515"]}] 1516:T73ff,
{
  "id": "6516f2f3-fd2c-ac2c-9bf2-3e02711dd3fb",
  "token": "245e63f3-1e44-40db-bcd4-4448263d3fa2",
  "type": "payment",
  "state": "cancelled",
  "created_at": "2023-09-29T15:53:23.234913Z",
  "updated_at": "2023-09-29T16:24:39.366956Z",
  "amount": 500,
  "currency": "GBP",
  "outstanding_amount": 500,
  "settlement_currency": "EUR",
  "capture_mode": "manual",
  "authorisation_type": "final",
  "description": "Example order description",
  "checkout_url": "https://checkout.revolut.com/payment-link/245e63f3-1e44-40db-bcd4-4448263d3fa2",
  "redirect_url": "https://www.example.com/redirect",
  "cancel_authorised_after": "PT30M",
  "industry_data": {
    "type": "airline",
    "booking_id": "unique-booking-id-12345",
    "fulfillment_date": "2023-07-10T14:00:00.069624Z",
    "ticket_type": "flexible",
    "crs_code": "DATS",
    "ticket_change_indicator": "new",
    "refundability": "refundable",
    "passengers": [
      {
        "first_name": "Example",
        "last_name": "Customer"
      },
      {
        "first_name": "John",
        "last_name": "Doe"
      }
    ],
    "journey_legs": [
      {
        "sequence": 1,
        "departure_airport_code": "FRA",
        "arrival_airport_code": "LHR",
        "flight_number": "670",
        "fare_base_code": "J",
        "travel_date": "2023-07-10T10:00:00.069624Z",
        "airline_name": "AerLingus",
        "airline_code": "EI"
      },
      {
        "sequence": 2,
        "departure_airport_code": "LHR",
        "arrival_airport_code": "DUB",
        "flight_number": "678",
        "fare_base_code": "J",
        "travel_date": "2023-07-10T15:00:00.069624Z",
        "airline_name": "AerLingus",
        "airline_code": "EI"
      },
      {
        "sequence": 3,
        "departure_airport_code": "DUB",
        "arrival_airport_code": "LHR",
        "flight_number": "679",
        "fare_base_code": "F",
        "travel_date": "2023-07-15T10:00:00.069624Z",
        "airline_name": "AerLingus",
        "airline_code": "EI"
      },
      {
        "sequence": 4,
        "departure_airport_code": "LHR",
        "arrival_airport_code": "FRA",
        "flight_number": "671",
        "fare_base_code": "F",
        "travel_date": "2023-07-10T14:00:00.069624Z",
        "airline_name": "AerLingus",
        "airline_code": "EI"
      }
    ],
    "booking_url": "https://example.com/bookings/1234"
  },
  "payments": [
    {
      "id": "6516f315-f713-a5fd-8299-f28820937409",
      "state": "failed",
      "created_at": "2023-09-29T15:53:57.268142Z",
      "updated_at": "2023-09-29T16:24:39.374460Z",
      "amount": 500,
      "currency": "GBP",
      "settled_amount": 576,
      "settled_currency": "EUR",
      "risk_level": "low",
      "fees": [],
      "payer": {
        "email": "example.payer@example.com",
        "phone": "+447911123456"
      },
      "payment_method": {
        "type": "card",
        "fingerprint": "1JAllfQY4POhBV8DaddAQ4LC5RbMP8LMLvUdJW4s5JY=",
        "network_transaction_id": "1234567890123456",
        "card_brand": "mastercard",
        "funding": "credit",
        "card_country_code": "MT",
        "card_bin": "542071",
        "card_last_four": "0016",
        "card_expiry": "12/28",
        "cardholder_name": "Example Holder",
        "checks": {
          "three_ds": {
            "state": "verified",
            "version": 2
          },
          "cvv_verification": "match"
        }
      }
    }
  ],
  "enforce_challenge": "forced",
  "customer": {
    "id": "db186257-3031-4726-98ea-f2260ea115f0",
    "email": "example@example.com",
    "phone": "+441234567890",
    "full_name": "Example Customer"
  },
  "merchant_order_data": {
    "url": "https://www.airline.com/ticketnumber-12345",
    "reference": "example_airline_reference"
  }
}
14d1:["$","div","200-application/json-example_order_airline",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$1516"}}]}]],"$L1517"]}] 1518:T2e94,
{
  "id": "6516edb9-74af-ae47-829b-1475e807a8d7",
  "token": "1e619c26-d954-4d45-94ab-aba1e407fcee",
  "type": "payment",
  "state": "cancelled",
  "created_at": "2023-09-29T15:31:05.746826Z",
  "updated_at": "2023-09-29T15:45:12.352147Z",
  "amount": 26100,
  "currency": "EUR",
  "outstanding_amount": 26100,
  "settlement_currency": "EUR",
  "capture_mode": "manual",
  "authorisation_type": "final",
  "description": "Customer wants to buy 0.01 BTC",
  "checkout_url": "https://checkout.revolut.com/payment-link/1e619c26-d954-4d45-94ab-aba1e407fcee",
  "redirect_url": "https://www.example.com/redirect",
  "industry_data": {
    "type": "crypto",
    "transactions": [
      {
        "id": "7b2a8ed4-5889-4c0c-a8cc-299aff1c881b",
        "status": "cancelled",
        "recipient_wallet_id": "64a6f159-0a60-a446-880e-e449a1f62f7c"
      }
    ],
    "seller": {
      "id": "a13638ab-3e90-4b05-9f69-23abc655775b",
      "name": "Ramp Provider Company Name",
      "website": "https://example.com",
      "phone": "123456789",
      "mcc": "6051",
      "address": {
        "street_line_1": "456 Crypto Ave",
        "city": "New York",
        "postcode": "10001",
        "country_code": "US"
      }
    }
  },
  "enforce_challenge": "automatic",
  "customer": {
    "id": "db186257-3031-4726-98ea-f2260ea115f0",
    "email": "example@example.com",
    "phone": "+44123456789",
    "full_name": "Example Customer"
  },
  "merchant_order_data": {
    "url": "https://www.example.com/cryptotransactionnumber-12345",
    "reference": "example_crypto_reference"
  }
}
14d2:["$","div","200-application/json-example_order_crypto",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$1518"}}]}]],"$L1519"]}] 151a:T1fa2,
{
  "id": "670920dc-d343-abf8-963a-68ae1bc8ae58",
  "token": "41aabe45-b444-45e6-8363-f0433452e138",
  "type": "payment",
  "state": "cancelled",
  "created_at": "2024-10-11T12:58:04.826974Z",
  "updated_at": "2024-10-11T13:15:22.145821Z",
  "amount": 10000,
  "currency": "EUR",
  "outstanding_amount": 10000,
  "capture_mode": "automatic",
  "authorisation_type": "final",
  "checkout_url": "https://checkout.revolut.com/payment-link/41aabe45-b444-45e6-8363-f0433452e138",
  "industry_data": {
    "type": "marketplace",
    "seller": {
      "id": "123-45-67",
      "name": "Example Seller",
      "address": {
        "street_line_1": "1 Canada Square",
        "street_line_2": "Revolut LTD, Level 39",
        "region": "Greater London",
        "city": "London",
        "country_code": "GB",
        "country_subdivision_code": "GB-LND",
        "postcode": "E14 4HD"
      },
      "website": "https://example.com/123-45-67",
      "phone": "+441234567890"
    }
  },
  "enforce_challenge": "automatic"
}
14d3:["$","div","200-application/json-example_order_marketplace",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$151a"}}]}]],"$L151b"]}] 151c:T2e71,
{
  "id": "67bf20c4-59a5-a7a9-81ad-052fda5f80eb",
  "token": "8737a497-9bae-4647-90bf-1abe2fd9162a",
  "type": "payment",
  "state": "cancelled",
  "created_at": "2025-02-26T14:10:12.804901Z",
  "updated_at": "2025-02-26T14:10:12.804901Z",
  "amount": 100,
  "currency": "GBP",
  "outstanding_amount": 100,
  "capture_mode": "automatic",
  "authorisation_type": "final",
  "checkout_url": "https://checkout.revolut.com/payment-link/8737a497-9bae-4647-90bf-1abe2fd9162a",
  "industry_data": {
    "type": "event",
    "booking_id": "example_booking_123",
    "events": [
      {
        "start_date": "2025-03-04T14:00:00Z",
        "end_date": "2025-03-04T17:00:00Z",
        "supplier": "Example Supplier",
        "supplier_payment_date": "2025-03-03T14:00:15Z",
        "name": "Example Event",
        "location": {
          "street_line_1": "Example Street 123",
          "street_line_2": "II/123",
          "region": "London",
          "city": "London",
          "country_code": "GB",
          "postcode": "123456"
        },
        "category": "exhibition",
        "market": "primary",
        "tickets": [
          {
            "id": "example_ticket_1",
            "transferable": false,
            "refundability": "partially_refundable"
          },
          {
            "id": "example_ticket_2",
            "transferable": true,
            "refundability": "non_refundable"
          },
          {
            "id": "example_ticket_3"
          }
        ]
      }
    ]
  },
  "enforce_challenge": "automatic"
}
14d4:["$","div","200-application/json-example_order_event",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$151c"}}]}]],"$L151d"]}] 151e:T2737,
{
  "id": "67c70d42-1545-a73d-a4a5-35b7ac49e1da",
  "token": "9effe2b6-8907-4954-9e9b-696f763f7e08",
  "type": "payment",
  "state": "cancelled",
  "created_at": "2025-03-04T14:25:06.099782Z",
  "updated_at": "2025-03-04T14:25:06.099782Z",
  "amount": 100,
  "currency": "GBP",
  "outstanding_amount": 100,
  "capture_mode": "automatic",
  "authorisation_type": "final",
  "checkout_url": "https://checkout.revolut.com/payment-link/9effe2b6-8907-4954-9e9b-696f763f7e08",
  "industry_data": {
    "type": "lodging",
    "booking_id": "example_booking_123",
    "check_out_date": "2025-05-05T11:00:00Z",
    "booking_type": "flexible",
    "refundability": "partially_refundable",
    "location": {
      "street_line_1": "Example Street 123",
      "street_line_2": "II/123",
      "region": "London",
      "city": "London",
      "country_code": "GB",
      "postcode": "123456"
    },
    "guests": [
      {
        "first_name": "First",
        "last_name": "Guest"
      },
      {
        "first_name": "Second",
        "last_name": "Guest"
      }
    ],
    "check_in_date": "2025-05-01T15:00:00Z",
    "supplier_payment_date": "2025-05-05T11:00:00Z",
    "category": "bed_and_breakfast"
  },
  "enforce_challenge": "automatic"
}
14d5:["$","div","200-application/json-example_order_lodging",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$151e"}}]}]],"$L151f"]}] 1520:T46a,
{
  "code": "bad_request",
  "message": "Could not parse JSON",
  "timestamp": 1601296792533
}
14d6:["$","div","400-application/json-example-1",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$1520"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"code\": \"bad_request\",\n \"message\": \"Could not parse JSON\",\n \"timestamp\": 1601296792533\n}"}]}]]}] 1521:T46f,
{
  "code": "unauthenticated",
  "message": "Authentication failed",
  "timestamp": 1721049596461
}
14d7:["$","div","401-application/json-default",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$1521"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"code\": \"unauthenticated\",\n \"message\": \"Authentication failed\",\n \"timestamp\": 1721049596461\n}"}]}]]}] 1522:T494,
{
  "code": "not_found",
  "message": "Order with id abfa5bbd-a20c-4a0e-be66-30e733454518 was not found",
  "timestamp": 1721050063886
}
14d8:["$","div","404-application/json-default",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$1522"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"code\": \"not_found\",\n \"message\": \"Order with id abfa5bbd-a20c-4a0e-be66-30e733454518 was not found\",\n \"timestamp\": 1721050063886\n}"}]}]]}] 14f4:["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"id\": \"6516e61c-d279-a454-a837-bc52ce55ed49\",\n \"token\": \"0adc0e3c-ab44-4f33-bcc0-534ded7354ce\",\n \"type\": \"payment\",\n \"state\": \"pending\",\n \"created_at\": \"2023-09-29T14:58:36.079398Z\",\n \"updated_at\": \"2023-09-29T14:58:36.079398Z\",\n \"amount\": 500,\n \"currency\": \"GBP\",\n \"outstanding_amount\": 500,\n \"capture_mode\": \"automatic\",\n \"authorisation_type\": \"final\",\n \"checkout_url\": \"https://checkout.revolut.com/payment-link/0adc0e3c-ab44-4f33-bcc0-534ded7354ce\",\n \"enforce_challenge\": \"automatic\"\n}"}]}] 1523:T454,{ "id": "6516e6ec-c7f7-a0fb-a6d3-add05fa46d2f", "token": "1058031d-1e71-4d07-9f97-5ad388a1346c", "type": "payment", "state": "pending", "created_at": "2023-09-29T15:02:04.083787Z", "updated_at": "2023-09-29T15:02:04.083787Z", "amount": 500, "currency": "GBP", "outstanding_amount": 500, "capture_mode": "manual", "authorisation_type": "final", "cancel_authorised_after": "PT30M", "description": "Example product", "checkout_url": "https://checkout.revolut.com/payment-link/1058031d-1e71-4d07-9f97-5ad388a1346c", "redirect_url": "https://www.example.com/redirect", "shipping": { "address": { "street_line_1": "7 Westferry Circus", "city": "London", "country_code": "GB", "postcode": "E14 4HD" } }, "metadata": { "product_type": "Example" }, "enforce_challenge": "forced", "customer": { "id": "467646d6-e452-4d1e-a401-703f09cd3818", "email": "example@example.com", "date_of_birth": "1990-01-01" }, "merchant_order_data": { "url": "https://example.com/orders/12345" }, "statement_descriptor_suffix": "12345" }14f6:["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"$1523"}]}] 1524:T674,{ "id": "6516e61c-d279-a454-a837-bc52ce55ed49", "token": "0adc0e3c-ab44-4f33-bcc0-534ded7354ce", "type": "payment", "state": "authorised", "created_at": "2023-09-29T14:58:36.079398Z", "updated_at": "2023-09-29T14:58:36.079398Z", "amount": 5000, "currency": "GBP", "outstanding_amount": 5000, "capture_mode": "manual", "authorisation_type": "pre_authorisation", "cancel_authorised_after": "PT72H", "description": "Hotel reservation deposit", "checkout_url": "https://checkout.revolut.com/payment-link/0adc0e3c-ab44-4f33-bcc0-534ded7354ce", "enforce_challenge": "automatic", "payments": [ { "id": "6516f38a-a12b-aca3-83f2-6ed16d6ed246", "state": "authorised", "created_at": "2023-09-29T14:55:54.579311Z", "updated_at": "2023-09-29T14:56:38.403232Z", "amount": 5000, "currency": "GBP", "settled_amount": 5000, "settled_currency": "GBP", "billing_address": { "country_code": "GB", "postcode": "SW1A 1AA" }, "risk_level": "low", "fees": [], "payer": { "email": "example.payer@example.com", "phone": "+447911123456" }, "payment_method": { "type": "card", "card_brand": "visa", "funding": "credit", "card_country_code": "GB", "card_bin": "411111", "card_last_four": "1111", "card_expiry": "12/25", "cardholder_name": "Example Holder", "capture_deadline": "2023-10-06T14:55:54.579311Z", "fingerprint": "1JAllfQY4POhBV8DaddAQ4LC5RbMP8LMLvUdJW4s5JY=", "network_transaction_id": "1234567890123456" } } ] }14f8:["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"$1524"}]}] 1525:T736,{ "id": "66bcc998-4209-ac6e-96fe-2910b949c516", "token": "0bcfcc1d-9ee9-4476-b36c-cf4abba2e45a", "type": "payment", "state": "pending", "created_at": "2024-08-14T15:13:28.814729Z", "updated_at": "2024-08-14T15:13:28.814729Z", "amount": 770, "currency": "GBP", "outstanding_amount": 770, "capture_mode": "automatic", "authorisation_type": "final", "checkout_url": "https://checkout.revolut.com/payment-link/0bcfcc1d-9ee9-4476-b36c-cf4abba2e45a", "enforce_challenge": "automatic", "line_items": [ { "name": "Example item 1", "unit_price_amount": 100, "quantity": { "value": 2, "unit": "kg" }, "type": "physical", "discounts": [ { "name": "Discount 1", "amount": 50 } ], "taxes": [ { "name": "10% VAT", "amount": 20 } ], "total_amount": 170, "image_urls": [ "https://www.example.com/line-item-image1", "https://www.example.com/line-item-image2" ], "description": "First line item", "external_id": "external_id_123", "url": "https://www.example.com" }, { "name": "Example item 2", "unit_price_amount": 100, "quantity": { "value": 10, "unit": "pieces" }, "type": "service", "discounts": [ { "name": "Discount 2", "amount": 500 } ], "taxes": [ { "name": "10% VAT", "amount": 100 } ], "total_amount": 600, "image_urls": [ "https://www.example.com/line_item_image3", "https://www.example.com/line_item_image4" ], "description": "Second line item", "external_id": "external_id_456", "url": "https://www.example.com" } ] }14fa:["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"$1525"}]}] 14fc:["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"id\": \"7a1b2c3d-4e5f-6789-abcd-e1234567890a\",\n \"token\": \"9f8e7d6c-5b4a-3210-fedc-ba0987654321\",\n \"type\": \"payment\",\n \"state\": \"completed\",\n \"created_at\": \"2025-06-15T10:30:00.000000Z\",\n \"updated_at\": \"2025-06-15T10:31:00.000000Z\",\n \"amount\": 1999,\n \"currency\": \"GBP\",\n \"outstanding_amount\": 0,\n \"capture_mode\": \"automatic\",\n \"authorisation_type\": \"final\",\n \"checkout_url\": \"https://checkout.revolut.com/payment-link/9f8e7d6c-5b4a-3210-fedc-ba0987654321\",\n \"enforce_challenge\": \"automatic\",\n \"subscription_data\": {\n \"subscription_id\": \"e2862e0e-66e8-4623-bdd6-7da59b85365d\",\n \"active_cycle_id\": \"a1b2c3d4-5678-9012-abcd-ef1234567890\",\n \"billing_reason\": \"cycle_billing\"\n }\n}"}]}] 1526:T480,{ "id": "66c5e449-36d3-af78-a832-328150ddc6a3", "token": "b1145e3e-30c7-4dd6-b84c-680dccd39dde", "type": "payment", "state": "pending", "created_at": "2024-08-21T12:57:45.793605Z", "updated_at": "2024-08-21T12:57:45.793605Z", "amount": 770, "currency": "GBP", "outstanding_amount": 770, "capture_mode": "automatic", "authorisation_type": "final", "checkout_url": "https://checkout.revolut.com/payment-link/b1145e3e-30c7-4dd6-b84c-680dccd39dde", "shipping": { "address": { "street_line_1": "Example Street 123", "street_line_2": "II/123", "region": "London", "city": "London", "country_code": "GB", "postcode": "123456" }, "contact": { "name": "Example Contact", "email": "example.contact@example.com", "phone": "+441234567890" }, "shipments": [ { "shipping_company_name": "Example Shipping Co.", "tracking_number": "123456789", "estimated_delivery_date": "2024-12-03T10:15:30+02:00[Europe/Paris]", "tracking_url": "https://www.example.com/tracking/123456789" } ] }, "enforce_challenge": "automatic" }14fe:["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"$1526"}]}] 1527:Taaa,{ "id": "6516ed0c-098f-aa19-80e5-9d92f52b35e0", "token": "061f2c63-e36b-421e-9ece-5adfcd580886", "type": "payment", "state": "pending", "created_at": "2023-09-29T15:28:12.114992Z", "updated_at": "2023-09-29T15:28:12.114992Z", "amount": 500, "currency": "GBP", "outstanding_amount": 500, "settlement_currency": "EUR", "capture_mode": "manual", "authorisation_type": "final", "description": "Example order description", "checkout_url": "https://checkout.revolut.com/payment-link/061f2c63-e36b-421e-9ece-5adfcd580886", "redirect_url": "https://www.example.com/redirect", "cancel_authorised_after": "PT30M", "industry_data": { "type": "airline", "booking_id": "unique-booking-id-12345", "fulfillment_date": "2023-07-10T14:00:00.069624Z", "ticket_type": "flexible", "crs_code": "DATS", "ticket_change_indicator": "new", "refundability": "refundable", "passengers": [ { "first_name": "Example", "last_name": "Customer" }, { "first_name": "John", "last_name": "Doe" } ], "journey_legs": [ { "sequence": 1, "departure_airport_code": "FRA", "arrival_airport_code": "LHR", "flight_number": "670", "fare_base_code": "J", "travel_date": "2023-07-10T10:00:00.069624Z", "airline_name": "AerLingus", "airline_code": "EI" }, { "sequence": 2, "departure_airport_code": "LHR", "arrival_airport_code": "DUB", "flight_number": "678", "fare_base_code": "J", "travel_date": "2023-07-10T15:00:00.069624Z", "airline_name": "AerLingus", "airline_code": "EI" }, { "sequence": 3, "departure_airport_code": "DUB", "arrival_airport_code": "LHR", "flight_number": "679", "fare_base_code": "F", "travel_date": "2023-07-15T10:00:00.069624Z", "airline_name": "AerLingus", "airline_code": "EI" }, { "sequence": 4, "departure_airport_code": "LHR", "arrival_airport_code": "FRA", "flight_number": "671", "fare_base_code": "F", "travel_date": "2023-07-10T14:00:00.069624Z", "airline_name": "AerLingus", "airline_code": "EI" } ], "booking_url": "https://example.com/bookings/1234" }, "enforce_challenge": "forced", "customer": { "id": "db186257-3031-4726-98ea-f2260ea115f0", "email": "example@example.com", "phone": "+441234567890", "full_name": "Example Customer" }, "merchant_order_data": { "url": "https://www.example.com/ticketnumber-12345", "reference": "example_airline_reference" } }1500:["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"$1527"}]}] 1528:T69d,{ "id": "6516ed0c-098f-aa19-80e5-9d92f52b35e0", "token": "061f2c63-e36b-421e-9ece-5adfcd580886", "type": "payment", "state": "pending", "created_at": "2025-01-29T15:28:12.114992Z", "updated_at": "2025-01-29T15:28:12.114992Z", "amount": 500, "currency": "GBP", "outstanding_amount": 500, "settlement_currency": "GBP", "capture_mode": "manual", "authorisation_type": "final", "description": "Example car rental order", "checkout_url": "https://checkout.revolut.com/payment-link/061f2c63-e36b-421e-9ece-5adfcd580886", "redirect_url": "https://www.example.com/redirect", "cancel_authorised_after": "PT30M", "industry_data": { "type": "car_rental", "booking_id": "example_booking_id", "pick_up_date": "2026-03-01T11:00:00Z", "drop_off_date": "2026-03-05T16:30:00Z", "refundability": "partially_refundable", "pick_up_location": { "street_line_1": "1 Example Street", "city": "London", "country_code": "GB", "postcode": "SW1A 1AA" }, "drop_off_location": { "street_line_1": "10 Another Road", "city": "Manchester", "country_code": "GB", "postcode": "M1 1AA" }, "distance_limit": { "limit": 500, "unit": "miles", "additional_distance_cost": { "amount": 150, "currency": "GBP" } } }, "enforce_challenge": "forced", "customer": { "id": "db186257-3031-4726-98ea-f2260ea115f0", "email": "example@example.com", "phone": "+447700900000", "full_name": "Example Customer" }, "merchant_order_data": { "url": "https://www.example.com/rental/example_booking_id", "reference": "example_car_rental_reference" } }1502:["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"$1528"}]}] 1529:T620,{ "id": "6516edb9-74af-ae47-829b-1475e807a8d7", "token": "1e619c26-d954-4d45-94ab-aba1e407fcee", "type": "payment", "state": "pending", "created_at": "2023-09-29T15:31:05.746826Z", "updated_at": "2023-09-29T15:31:05.746826Z", "amount": 26100, "currency": "EUR", "outstanding_amount": 26100, "settlement_currency": "EUR", "capture_mode": "manual", "authorisation_type": "final", "description": "Customer wants to buy 0.01 BTC", "checkout_url": "https://checkout.revolut.com/payment-link/1e619c26-d954-4d45-94ab-aba1e407fcee", "redirect_url": "https://www.example.com/redirect", "industry_data": { "type": "crypto", "transactions": [ { "id": "7b2a8ed4-5889-4c0c-a8cc-299aff1c881b", "status": "pending", "recipient_wallet_id": "64a6f159-0a60-a446-880e-e449a1f62f7c" } ], "seller": { "id": "a13638ab-3e90-4b05-9f69-23abc655775b", "name": "Ramp Provider Company Name", "website": "https://example.com", "phone": "123456789", "mcc": "6051", "address": { "street_line_1": "456 Crypto Ave", "city": "New York", "postcode": "10001", "country_code": "US" } } }, "enforce_challenge": "automatic", "customer": { "id": "db186257-3031-4726-98ea-f2260ea115f0", "email": "example@example.com", "phone": "+44123456789", "full_name": "Example Customer" }, "merchant_order_data": { "url": "https://www.example.com/cryptotransactionnumber-12345", "reference": "example_crypto_reference" } }1504:["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"$1529"}]}] 1506:["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"id\": \"670920dc-d343-abf8-963a-68ae1bc8ae58\",\n \"token\": \"41aabe45-b444-45e6-8363-f0433452e138\",\n \"type\": \"payment\",\n \"state\": \"pending\",\n \"created_at\": \"2024-10-11T12:58:04.826974Z\",\n \"updated_at\": \"2024-10-11T12:58:04.826974Z\",\n \"amount\": 10000,\n \"currency\": \"EUR\",\n \"outstanding_amount\": 10000,\n \"capture_mode\": \"automatic\",\n \"authorisation_type\": \"final\",\n \"checkout_url\": \"https://checkout.revolut.com/payment-link/41aabe45-b444-45e6-8363-f0433452e138\",\n \"industry_data\": {\n \"type\": \"marketplace\",\n \"seller\": {\n \"id\": \"123-45-67\",\n \"name\": \"Example Seller\",\n \"address\": {\n \"street_line_1\": \"1 Canada Square\",\n \"street_line_2\": \"Revolut LTD, Level 39\",\n \"region\": \"Greater London\",\n \"city\": \"London\",\n \"country_code\": \"GB\",\n \"country_subdivision_code\": \"GB-LND\",\n \"postcode\": \"E14 4HD\"\n },\n \"website\": \"https://example.com/123-45-67\",\n \"phone\": \"+441234567890\"\n }\n },\n \"enforce_challenge\": \"automatic\"\n}"}]}] 152a:T603,{ "id": "67bf20c4-59a5-a7a9-81ad-052fda5f80eb", "token": "8737a497-9bae-4647-90bf-1abe2fd9162a", "type": "payment", "state": "pending", "created_at": "2025-02-26T14:10:12.804901Z", "updated_at": "2025-02-26T14:10:12.804901Z", "amount": 100, "currency": "GBP", "outstanding_amount": 100, "capture_mode": "automatic", "authorisation_type": "final", "checkout_url": "https://checkout.revolut.com/payment-link/8737a497-9bae-4647-90bf-1abe2fd9162a", "industry_data": { "type": "event", "booking_id": "example_booking_123", "events": [ { "start_date": "2025-03-04T14:00:00Z", "end_date": "2025-03-04T17:00:00Z", "supplier": "Example Supplier", "supplier_payment_date": "2025-03-03T14:00:15Z", "name": "Example Event", "location": { "street_line_1": "Example Street 123", "street_line_2": "II/123", "region": "London", "city": "London", "country_code": "GB", "postcode": "123456" }, "category": "exhibition", "market": "primary", "tickets": [ { "id": "example_ticket_1", "transferable": false, "refundability": "partially_refundable" }, { "id": "example_ticket_2", "transferable": true, "refundability": "non_refundable" }, { "id": "example_ticket_3" } ] } ] }, "enforce_challenge": "automatic" }1508:["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"$152a"}]}] 152b:T4d5,{ "id": "67c70d42-1545-a73d-a4a5-35b7ac49e1da", "token": "9effe2b6-8907-4954-9e9b-696f763f7e08", "type": "payment", "state": "pending", "created_at": "2025-03-04T14:25:06.099782Z", "updated_at": "2025-03-04T14:25:06.099782Z", "amount": 100, "currency": "GBP", "outstanding_amount": 100, "capture_mode": "automatic", "authorisation_type": "final", "checkout_url": "https://checkout.revolut.com/payment-link/9effe2b6-8907-4954-9e9b-696f763f7e08", "industry_data": { "type": "lodging", "booking_id": "example_booking_123", "check_out_date": "2025-05-05T11:00:00Z", "booking_type": "flexible", "refundability": "partially_refundable", "location": { "street_line_1": "Example Street 123", "street_line_2": "II/123", "region": "London", "city": "London", "country_code": "GB", "postcode": "123456" }, "guests": [ { "first_name": "First", "last_name": "Guest" }, { "first_name": "Second", "last_name": "Guest" } ], "check_in_date": "2025-05-01T15:00:00Z", "supplier_payment_date": "2025-05-05T11:00:00Z", "category": "bed_and_breakfast" }, "enforce_challenge": "automatic" }150a:["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"$152b"}]}] 150f:["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"id\": \"6516f565-c903-ae7d-8582-0bc70468ec29\",\n \"token\": \"579462b3-da89-4a46-8690-572d3968573f\",\n \"type\": \"payment\",\n \"state\": \"cancelled\",\n \"created_at\": \"2023-09-29T16:03:49.569437Z\",\n \"updated_at\": \"2023-09-29T16:04:30.727004Z\",\n \"amount\": 500,\n \"currency\": \"GBP\",\n \"refunded_amount\": 0,\n \"outstanding_amount\": 0,\n \"capture_mode\": \"automatic\",\n \"authorisation_type\": \"final\",\n \"enforce_challenge\": \"automatic\"\n}"}]}] 152c:T7bc,{ "id": "6516f379-c03f-adf3-a2bf-24b328909731", "token": "91533c29-47d1-4ae9-a73f-74225fd4b176", "type": "payment", "state": "cancelled", "created_at": "2023-09-29T15:55:37.201407Z", "updated_at": "2023-09-29T15:56:38.398961Z", "amount": 500, "currency": "GBP", "refunded_amount": 0, "outstanding_amount": 500, "capture_mode": "manual", "authorisation_type": "final", "cancel_authorised_after": "PT30M", "description": "Example product", "checkout_url": "https://checkout.revolut.com/payment-link/91533c29-47d1-4ae9-a73f-74225fd4b176", "redirect_url": "https://www.example.com/redirect", "shipping_address": { "street_line_1": "7 Westferry Circus", "city": "London", "country_code": "GB", "postcode": "E14 4HD" }, "metadata": { "product_type": "Example" }, "payments": [ { "id": "6516f38a-a12b-aca3-83f2-6ed16d6ed246", "state": "authorised", "created_at": "2023-09-29T15:55:54.579311Z", "updated_at": "2023-09-29T15:56:38.403232Z", "amount": 500, "currency": "GBP", "settled_amount": 500, "settled_currency": "GBP", "billing_address": { "street_line_1": "26 Atkins Avenue", "street_line_2": "New York 42233", "city": "SentinelFraudLow", "country_code": "GB", "postcode": "PE3 9UP" }, "risk_level": "low", "fees": [], "payer": { "email": "example.payer@example.com", "phone": "+447911123456" }, "payment_method": { "type": "revolut_pay_account", "fingerprint": "1JAllfQY4POhBV8DaddAQ4LC5RbMP8LMLvUdJW4s5JY=" } } ], "enforce_challenge": "forced", "customer": { "id": "3c131306-0a0a-4f54-99d7-3fb2e027c6f7", "email": "example@example.com", "phone": "+441234567890", "full_name": "Example Customer" }, "merchant_order_data": { "url": "https://example.com/orders/12345" }, "statement_descriptor_suffix": "12345" }1511:["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"$152c"}]}] 152d:T738,{ "id": "66bcc998-4209-ac6e-96fe-2910b949c516", "token": "0bcfcc1d-9ee9-4476-b36c-cf4abba2e45a", "type": "payment", "state": "cancelled", "created_at": "2024-08-14T15:13:28.814729Z", "updated_at": "2024-08-14T15:13:28.814729Z", "amount": 770, "currency": "GBP", "outstanding_amount": 770, "capture_mode": "automatic", "authorisation_type": "final", "checkout_url": "https://checkout.revolut.com/payment-link/0bcfcc1d-9ee9-4476-b36c-cf4abba2e45a", "enforce_challenge": "automatic", "line_items": [ { "name": "Example item 1", "unit_price_amount": 100, "quantity": { "value": 2, "unit": "kg" }, "type": "physical", "discounts": [ { "name": "Discount 1", "amount": 50 } ], "taxes": [ { "name": "10% VAT", "amount": 20 } ], "total_amount": 170, "image_urls": [ "https://www.example.com/line-item-image1", "https://www.example.com/line-item-image2" ], "description": "First line item", "external_id": "external_id_123", "url": "https://www.example.com" }, { "name": "Example item 2", "unit_price_amount": 100, "quantity": { "value": 10, "unit": "pieces" }, "type": "service", "discounts": [ { "name": "Discount 2", "amount": 500 } ], "taxes": [ { "name": "10% VAT", "amount": 100 } ], "total_amount": 600, "image_urls": [ "https://www.example.com/line_item_image3", "https://www.example.com/line_item_image4" ], "description": "Second line item", "external_id": "external_id_456", "url": "https://www.example.com" } ] }1513:["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"$152d"}]}] 152e:T482,{ "id": "66c5e449-36d3-af78-a832-328150ddc6a3", "token": "b1145e3e-30c7-4dd6-b84c-680dccd39dde", "type": "payment", "state": "cancelled", "created_at": "2024-08-21T12:57:45.793605Z", "updated_at": "2024-08-21T12:57:45.793605Z", "amount": 770, "currency": "GBP", "outstanding_amount": 770, "capture_mode": "automatic", "authorisation_type": "final", "checkout_url": "https://checkout.revolut.com/payment-link/b1145e3e-30c7-4dd6-b84c-680dccd39dde", "shipping": { "address": { "street_line_1": "Example Street 123", "street_line_2": "II/123", "region": "London", "city": "London", "country_code": "GB", "postcode": "123456" }, "contact": { "name": "Example Contact", "email": "example.contact@example.com", "phone": "+441234567890" }, "shipments": [ { "shipping_company_name": "Example Shipping Co.", "tracking_number": "123456789", "estimated_delivery_date": "2024-12-03T10:15:30+02:00[Europe/Paris]", "tracking_url": "https://www.example.com/tracking/123456789" } ] }, "enforce_challenge": "automatic" }1515:["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"$152e"}]}] 152f:Tecd,{ "id": "6516f2f3-fd2c-ac2c-9bf2-3e02711dd3fb", "token": "245e63f3-1e44-40db-bcd4-4448263d3fa2", "type": "payment", "state": "cancelled", "created_at": "2023-09-29T15:53:23.234913Z", "updated_at": "2023-09-29T16:24:39.366956Z", "amount": 500, "currency": "GBP", "outstanding_amount": 500, "settlement_currency": "EUR", "capture_mode": "manual", "authorisation_type": "final", "description": "Example order description", "checkout_url": "https://checkout.revolut.com/payment-link/245e63f3-1e44-40db-bcd4-4448263d3fa2", "redirect_url": "https://www.example.com/redirect", "cancel_authorised_after": "PT30M", "industry_data": { "type": "airline", "booking_id": "unique-booking-id-12345", "fulfillment_date": "2023-07-10T14:00:00.069624Z", "ticket_type": "flexible", "crs_code": "DATS", "ticket_change_indicator": "new", "refundability": "refundable", "passengers": [ { "first_name": "Example", "last_name": "Customer" }, { "first_name": "John", "last_name": "Doe" } ], "journey_legs": [ { "sequence": 1, "departure_airport_code": "FRA", "arrival_airport_code": "LHR", "flight_number": "670", "fare_base_code": "J", "travel_date": "2023-07-10T10:00:00.069624Z", "airline_name": "AerLingus", "airline_code": "EI" }, { "sequence": 2, "departure_airport_code": "LHR", "arrival_airport_code": "DUB", "flight_number": "678", "fare_base_code": "J", "travel_date": "2023-07-10T15:00:00.069624Z", "airline_name": "AerLingus", "airline_code": "EI" }, { "sequence": 3, "departure_airport_code": "DUB", "arrival_airport_code": "LHR", "flight_number": "679", "fare_base_code": "F", "travel_date": "2023-07-15T10:00:00.069624Z", "airline_name": "AerLingus", "airline_code": "EI" }, { "sequence": 4, "departure_airport_code": "LHR", "arrival_airport_code": "FRA", "flight_number": "671", "fare_base_code": "F", "travel_date": "2023-07-10T14:00:00.069624Z", "airline_name": "AerLingus", "airline_code": "EI" } ], "booking_url": "https://example.com/bookings/1234" }, "payments": [ { "id": "6516f315-f713-a5fd-8299-f28820937409", "state": "failed", "created_at": "2023-09-29T15:53:57.268142Z", "updated_at": "2023-09-29T16:24:39.374460Z", "amount": 500, "currency": "GBP", "settled_amount": 576, "settled_currency": "EUR", "risk_level": "low", "fees": [], "payer": { "email": "example.payer@example.com", "phone": "+447911123456" }, "payment_method": { "type": "card", "fingerprint": "1JAllfQY4POhBV8DaddAQ4LC5RbMP8LMLvUdJW4s5JY=", "network_transaction_id": "1234567890123456", "card_brand": "mastercard", "funding": "credit", "card_country_code": "MT", "card_bin": "542071", "card_last_four": "0016", "card_expiry": "12/28", "cardholder_name": "Example Holder", "checks": { "three_ds": { "state": "verified", "version": 2 }, "cvv_verification": "match" } } } ], "enforce_challenge": "forced", "customer": { "id": "db186257-3031-4726-98ea-f2260ea115f0", "email": "example@example.com", "phone": "+441234567890", "full_name": "Example Customer" }, "merchant_order_data": { "url": "https://www.airline.com/ticketnumber-12345", "reference": "example_airline_reference" } }1517:["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"$152f"}]}] 1530:T624,{ "id": "6516edb9-74af-ae47-829b-1475e807a8d7", "token": "1e619c26-d954-4d45-94ab-aba1e407fcee", "type": "payment", "state": "cancelled", "created_at": "2023-09-29T15:31:05.746826Z", "updated_at": "2023-09-29T15:45:12.352147Z", "amount": 26100, "currency": "EUR", "outstanding_amount": 26100, "settlement_currency": "EUR", "capture_mode": "manual", "authorisation_type": "final", "description": "Customer wants to buy 0.01 BTC", "checkout_url": "https://checkout.revolut.com/payment-link/1e619c26-d954-4d45-94ab-aba1e407fcee", "redirect_url": "https://www.example.com/redirect", "industry_data": { "type": "crypto", "transactions": [ { "id": "7b2a8ed4-5889-4c0c-a8cc-299aff1c881b", "status": "cancelled", "recipient_wallet_id": "64a6f159-0a60-a446-880e-e449a1f62f7c" } ], "seller": { "id": "a13638ab-3e90-4b05-9f69-23abc655775b", "name": "Ramp Provider Company Name", "website": "https://example.com", "phone": "123456789", "mcc": "6051", "address": { "street_line_1": "456 Crypto Ave", "city": "New York", "postcode": "10001", "country_code": "US" } } }, "enforce_challenge": "automatic", "customer": { "id": "db186257-3031-4726-98ea-f2260ea115f0", "email": "example@example.com", "phone": "+44123456789", "full_name": "Example Customer" }, "merchant_order_data": { "url": "https://www.example.com/cryptotransactionnumber-12345", "reference": "example_crypto_reference" } }1519:["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"$1530"}]}] 151b:["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"id\": \"670920dc-d343-abf8-963a-68ae1bc8ae58\",\n \"token\": \"41aabe45-b444-45e6-8363-f0433452e138\",\n \"type\": \"payment\",\n \"state\": \"cancelled\",\n \"created_at\": \"2024-10-11T12:58:04.826974Z\",\n \"updated_at\": \"2024-10-11T13:15:22.145821Z\",\n \"amount\": 10000,\n \"currency\": \"EUR\",\n \"outstanding_amount\": 10000,\n \"capture_mode\": \"automatic\",\n \"authorisation_type\": \"final\",\n \"checkout_url\": \"https://checkout.revolut.com/payment-link/41aabe45-b444-45e6-8363-f0433452e138\",\n \"industry_data\": {\n \"type\": \"marketplace\",\n \"seller\": {\n \"id\": \"123-45-67\",\n \"name\": \"Example Seller\",\n \"address\": {\n \"street_line_1\": \"1 Canada Square\",\n \"street_line_2\": \"Revolut LTD, Level 39\",\n \"region\": \"Greater London\",\n \"city\": \"London\",\n \"country_code\": \"GB\",\n \"country_subdivision_code\": \"GB-LND\",\n \"postcode\": \"E14 4HD\"\n },\n \"website\": \"https://example.com/123-45-67\",\n \"phone\": \"+441234567890\"\n }\n },\n \"enforce_challenge\": \"automatic\"\n}"}]}] 1531:T605,{ "id": "67bf20c4-59a5-a7a9-81ad-052fda5f80eb", "token": "8737a497-9bae-4647-90bf-1abe2fd9162a", "type": "payment", "state": "cancelled", "created_at": "2025-02-26T14:10:12.804901Z", "updated_at": "2025-02-26T14:10:12.804901Z", "amount": 100, "currency": "GBP", "outstanding_amount": 100, "capture_mode": "automatic", "authorisation_type": "final", "checkout_url": "https://checkout.revolut.com/payment-link/8737a497-9bae-4647-90bf-1abe2fd9162a", "industry_data": { "type": "event", "booking_id": "example_booking_123", "events": [ { "start_date": "2025-03-04T14:00:00Z", "end_date": "2025-03-04T17:00:00Z", "supplier": "Example Supplier", "supplier_payment_date": "2025-03-03T14:00:15Z", "name": "Example Event", "location": { "street_line_1": "Example Street 123", "street_line_2": "II/123", "region": "London", "city": "London", "country_code": "GB", "postcode": "123456" }, "category": "exhibition", "market": "primary", "tickets": [ { "id": "example_ticket_1", "transferable": false, "refundability": "partially_refundable" }, { "id": "example_ticket_2", "transferable": true, "refundability": "non_refundable" }, { "id": "example_ticket_3" } ] } ] }, "enforce_challenge": "automatic" }151d:["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"$1531"}]}] 1532:T4d7,{ "id": "67c70d42-1545-a73d-a4a5-35b7ac49e1da", "token": "9effe2b6-8907-4954-9e9b-696f763f7e08", "type": "payment", "state": "cancelled", "created_at": "2025-03-04T14:25:06.099782Z", "updated_at": "2025-03-04T14:25:06.099782Z", "amount": 100, "currency": "GBP", "outstanding_amount": 100, "capture_mode": "automatic", "authorisation_type": "final", "checkout_url": "https://checkout.revolut.com/payment-link/9effe2b6-8907-4954-9e9b-696f763f7e08", "industry_data": { "type": "lodging", "booking_id": "example_booking_123", "check_out_date": "2025-05-05T11:00:00Z", "booking_type": "flexible", "refundability": "partially_refundable", "location": { "street_line_1": "Example Street 123", "street_line_2": "II/123", "region": "London", "city": "London", "country_code": "GB", "postcode": "123456" }, "guests": [ { "first_name": "First", "last_name": "Guest" }, { "first_name": "Second", "last_name": "Guest" } ], "check_in_date": "2025-05-01T15:00:00Z", "supplier_payment_date": "2025-05-05T11:00:00Z", "category": "bed_and_breakfast" }, "enforce_challenge": "automatic" }151f:["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"$1532"}]}] 14de:["$","div","CodeBlock-0",{"className":"wzy01m0 _18b50nc0","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"
sequence,\ndeparture_airport_code,\narrival_airport_code,\nflight_number,\ntravel_date,\nairline_name,\nairline_code,
"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"sequence,\ndeparture_airport_code,\narrival_airport_code,\nflight_number,\ntravel_date,\nairline_name,\nairline_code,\n"}]}]]}] 14df:["$","div","CodeBlock-0",{"className":"wzy01m0 _18b50nc0","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"
tickets_purchase,\njourney_legs,\nbooking_url
"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"tickets_purchase,\njourney_legs,\nbooking_url\n"}]}]]}] 14e0:["$","div","CodeBlock-0",{"className":"wzy01m0 _18b50nc0","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"
booking_id\ndrop_off_date\nrefundability
"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"booking_id\ndrop_off_date\nrefundability\n"}]}]]}] 14e1:["$","div","CodeBlock-0",{"className":"wzy01m0 _18b50nc0","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"
transactions[].id\ntransactions[].status\ntransactions[].recipient_wallet_id\nseller.id\nseller.name\nseller.website\nseller.phone\nseller.address\nseller.mcc\ncustomer.full_name\ncustomer.date_of_birth
"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"transactions[].id\ntransactions[].status\ntransactions[].recipient_wallet_id\nseller.id\nseller.name\nseller.website\nseller.phone\nseller.address\nseller.mcc\ncustomer.full_name\ncustomer.date_of_birth\n"}]}]]}] 14e2:["$","div","CodeBlock-0",{"className":"wzy01m0 _18b50nc0","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"
seller.id\nseller.name\nseller.website\nseller.phone\nseller.address
"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"seller.id\nseller.name\nseller.website\nseller.phone\nseller.address\n"}]}]]}] 14e3:["$","div","CodeBlock-0",{"className":"wzy01m0 _18b50nc0","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"
booking_id\nevents[].start_date\nevents[].end_date\nevents[].supplier\nevents[].tickets[].id
"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"booking_id\nevents[].start_date\nevents[].end_date\nevents[].supplier\nevents[].tickets[].id\n"}]}]]}] 14e4:["$","div","CodeBlock-0",{"className":"wzy01m0 _18b50nc0","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"
booking_id\ncheck_in_date\ncheck_out_date\nsupplier_payment_date
"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"booking_id\ncheck_in_date\ncheck_out_date\nsupplier_payment_date\n"}]}]]}] 14ea:["$","div","CodeBlock-0",{"className":"wzy01m0 _18b50nc0","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"
sequence,\ndeparture_airport_code,\narrival_airport_code,\nflight_number,\ntravel_date,\nairline_name,\nairline_code,
"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"sequence,\ndeparture_airport_code,\narrival_airport_code,\nflight_number,\ntravel_date,\nairline_name,\nairline_code,\n"}]}]]}] 14eb:["$","div","CodeBlock-0",{"className":"wzy01m0 _18b50nc0","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"
tickets_purchase,\njourney_legs,\nbooking_url
"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"tickets_purchase,\njourney_legs,\nbooking_url\n"}]}]]}] 14ec:["$","div","CodeBlock-0",{"className":"wzy01m0 _18b50nc0","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"
booking_id\ndrop_off_date\nrefundability
"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"booking_id\ndrop_off_date\nrefundability\n"}]}]]}] 14ed:["$","div","CodeBlock-0",{"className":"wzy01m0 _18b50nc0","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"
transactions[].id\ntransactions[].status\ntransactions[].recipient_wallet_id\nseller.id\nseller.name\nseller.website\nseller.phone\nseller.address\nseller.mcc\ncustomer.full_name\ncustomer.date_of_birth
"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"transactions[].id\ntransactions[].status\ntransactions[].recipient_wallet_id\nseller.id\nseller.name\nseller.website\nseller.phone\nseller.address\nseller.mcc\ncustomer.full_name\ncustomer.date_of_birth\n"}]}]]}] 14ee:["$","div","CodeBlock-0",{"className":"wzy01m0 _18b50nc0","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"
seller.id\nseller.name\nseller.website\nseller.phone\nseller.address
"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"seller.id\nseller.name\nseller.website\nseller.phone\nseller.address\n"}]}]]}] 14ef:["$","div","CodeBlock-0",{"className":"wzy01m0 _18b50nc0","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"
booking_id\nevents[].start_date\nevents[].end_date\nevents[].supplier\nevents[].tickets[].id
"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"booking_id\nevents[].start_date\nevents[].end_date\nevents[].supplier\nevents[].tickets[].id\n"}]}]]}] 14f0:["$","div","CodeBlock-0",{"className":"wzy01m0 _18b50nc0","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"
booking_id\ncheck_in_date\ncheck_out_date\nsupplier_payment_date
"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"booking_id\ncheck_in_date\ncheck_out_date\nsupplier_payment_date\n"}]}]]}] 14f1:["$","div","CodeBlock-0",{"className":"wzy01m0 _18b50nc0","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"
'Authorization: Bearer <yourSecretApiKey>'
"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"'Authorization: Bearer '\n"}]}]]}] 14f2:["$","div","CodeBlock-0",{"className":"wzy01m0 _18b50nc0","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"
'Authorization: Bearer <yourSecretApiKey>'
"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"'Authorization: Bearer '\n"}]}]]}] 153c:T4c1,Automatic cancellation period for uncaptured orders, specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. After this period, the authorised payment is automatically cancelled and the order is cancelled. Maximum: 7 days = `P7D`. :::note The following limitations apply: - Cannot be a negative value. - Cannot be updated if the new value is less than or equal to the elapsed time since authorisation. **Failing scenario:** - Original value: 7 days - Time since authorisation: 3 days - Update value: 2 days In this scenario, an error is returned. **Successful scenario:** - Original value: 7 days - Time since authorisation: 3 days - Update value: 4 days In this scenario, the parameter can be updated. - Cannot be updated if cancellation is ≤ 30 minutes away. **Failing scenario:** - Original value: 12 hours - Time since authorisation: 11 hours 40 minutes In this scenario, an error is returned. **Successful scenario:** - Original value: 12 hours - Time since authorisation: 11 hours 20 minutes In this scenario, the parameter can be updated. :::1543:T50a,Object containing information about a customer. If you have it, we strongly advise providing at least either `id`, `phone`, or `email`. Using the [Customers operations](https://developer.revolut.com/docs/api/merchant#tag-customers), you can manage customer instances. The following behaviours apply to different use cases: | Use case | API behavior | | -------- | ------------ | | Existing customer | If `id` was provided, we ignore other customer details and associate the customer with the order.

If either `email`, `phone`, or `full_name` was provided (without an existing customer's `id`), we always create a new customer, irrespective of another, existing customer object having the same details. | | New customer | If either `email`, `phone`, or `full_name` was provided, we create a new customer, irrespective of another customer object having the same details.

If `id` of a non-existent customer was provided, we return a `404` error, irrespective of other details provided. | :::note To avoid unintentional duplication of customer records, search for an existing customer by email or phone using the [List customers](https://developer.revolut.com/docs/api/merchant#retrieve-customer-list) endpoint first, then provide `customer.id` in the order. :::156c:T9bc,A unique identifier for a payment method, always 44 characters long. This fingerprint can be used to uniquely identify various payment methods. #### Fingerprint generation | Payment method | Description | | -------- | ----------- | | **All payment methods** | A fingerprint is generated for all payment methods, including cards, Revolut Pay (card, account-to-account payments), Apple Pay, and Google Pay. | | **Cards (Revolut Pay & Card Gateway)** | For cards, the fingerprint is based on the PAN. Cards processed via Revolut Pay and our card gateway will share the same fingerprint. Renewed cards (new expiry/CVV) retain the same fingerprint for efficient blocking. | | **Apple Pay & Google Pay** | Since Apple Pay and Google Pay provide us Device PANs (DPAN), the fingerprint is based on the DPAN provided by Apple/Google, not the connected card's PAN. This means that a new DPAN (and fingerprint) is generated for cards in case they are re-added to the customer's digital wallet, or added to different devices. | #### Detecting duplicate payment methods Fingerprints are a valuable tool for detecting duplicate payment methods by identifying if a payment method has been seen before. This capability, in turn, helps in preventing various types of misuse (e.g., exploitation of free trials, or association with known problematic accounts, which can be a form of fraud). To effectively use fingerprints for this purpose, you will need to create and maintain your own lists (e.g., blocklists of known problematic fingerprints, allowlists for trusted customers, or tracking frequently used fingerprints). The ideal way to utilise fingerprints is by combining them with a manual capture process. While automatic capture with subsequent refunds for problematic payments is possible, manual capture based on fingerprint validation is recommended. During your manual capture workflow, after a payment was authorised: - Check the fingerprint status by comparing it against your maintained lists and internal business rules. - If you decide to proceed with the payment (e.g., the fingerprint is not on a blocklist, or matches a trusted customer's previous payment method): [Capture the order](https://developer.revolut.com/docs/api/merchant#capture-order). - If you decide not to proceed with the payment (e.g., the fingerprint matches a known fraudulent fingerprint, or exhibits suspicious patterns): [Cancel the order](https://developer.revolut.com/docs/api/merchant#cancel-order).157e:T9bc,A unique identifier for a payment method, always 44 characters long. This fingerprint can be used to uniquely identify various payment methods. #### Fingerprint generation | Payment method | Description | | -------- | ----------- | | **All payment methods** | A fingerprint is generated for all payment methods, including cards, Revolut Pay (card, account-to-account payments), Apple Pay, and Google Pay. | | **Cards (Revolut Pay & Card Gateway)** | For cards, the fingerprint is based on the PAN. Cards processed via Revolut Pay and our card gateway will share the same fingerprint. Renewed cards (new expiry/CVV) retain the same fingerprint for efficient blocking. | | **Apple Pay & Google Pay** | Since Apple Pay and Google Pay provide us Device PANs (DPAN), the fingerprint is based on the DPAN provided by Apple/Google, not the connected card's PAN. This means that a new DPAN (and fingerprint) is generated for cards in case they are re-added to the customer's digital wallet, or added to different devices. | #### Detecting duplicate payment methods Fingerprints are a valuable tool for detecting duplicate payment methods by identifying if a payment method has been seen before. This capability, in turn, helps in preventing various types of misuse (e.g., exploitation of free trials, or association with known problematic accounts, which can be a form of fraud). To effectively use fingerprints for this purpose, you will need to create and maintain your own lists (e.g., blocklists of known problematic fingerprints, allowlists for trusted customers, or tracking frequently used fingerprints). The ideal way to utilise fingerprints is by combining them with a manual capture process. While automatic capture with subsequent refunds for problematic payments is possible, manual capture based on fingerprint validation is recommended. During your manual capture workflow, after a payment was authorised: - Check the fingerprint status by comparing it against your maintained lists and internal business rules. - If you decide to proceed with the payment (e.g., the fingerprint is not on a blocklist, or matches a trusted customer's previous payment method): [Capture the order](https://developer.revolut.com/docs/api/merchant#capture-order). - If you decide not to proceed with the payment (e.g., the fingerprint matches a known fraudulent fingerprint, or exhibits suspicious patterns): [Cancel the order](https://developer.revolut.com/docs/api/merchant#cancel-order).1590:T9bc,A unique identifier for a payment method, always 44 characters long. This fingerprint can be used to uniquely identify various payment methods. #### Fingerprint generation | Payment method | Description | | -------- | ----------- | | **All payment methods** | A fingerprint is generated for all payment methods, including cards, Revolut Pay (card, account-to-account payments), Apple Pay, and Google Pay. | | **Cards (Revolut Pay & Card Gateway)** | For cards, the fingerprint is based on the PAN. Cards processed via Revolut Pay and our card gateway will share the same fingerprint. Renewed cards (new expiry/CVV) retain the same fingerprint for efficient blocking. | | **Apple Pay & Google Pay** | Since Apple Pay and Google Pay provide us Device PANs (DPAN), the fingerprint is based on the DPAN provided by Apple/Google, not the connected card's PAN. This means that a new DPAN (and fingerprint) is generated for cards in case they are re-added to the customer's digital wallet, or added to different devices. | #### Detecting duplicate payment methods Fingerprints are a valuable tool for detecting duplicate payment methods by identifying if a payment method has been seen before. This capability, in turn, helps in preventing various types of misuse (e.g., exploitation of free trials, or association with known problematic accounts, which can be a form of fraud). To effectively use fingerprints for this purpose, you will need to create and maintain your own lists (e.g., blocklists of known problematic fingerprints, allowlists for trusted customers, or tracking frequently used fingerprints). The ideal way to utilise fingerprints is by combining them with a manual capture process. While automatic capture with subsequent refunds for problematic payments is possible, manual capture based on fingerprint validation is recommended. During your manual capture workflow, after a payment was authorised: - Check the fingerprint status by comparing it against your maintained lists and internal business rules. - If you decide to proceed with the payment (e.g., the fingerprint is not on a blocklist, or matches a trusted customer's previous payment method): [Capture the order](https://developer.revolut.com/docs/api/merchant#capture-order). - If you decide not to proceed with the payment (e.g., the fingerprint matches a known fraudulent fingerprint, or exhibits suspicious patterns): [Cancel the order](https://developer.revolut.com/docs/api/merchant#cancel-order).15a2:T9bc,A unique identifier for a payment method, always 44 characters long. This fingerprint can be used to uniquely identify various payment methods. #### Fingerprint generation | Payment method | Description | | -------- | ----------- | | **All payment methods** | A fingerprint is generated for all payment methods, including cards, Revolut Pay (card, account-to-account payments), Apple Pay, and Google Pay. | | **Cards (Revolut Pay & Card Gateway)** | For cards, the fingerprint is based on the PAN. Cards processed via Revolut Pay and our card gateway will share the same fingerprint. Renewed cards (new expiry/CVV) retain the same fingerprint for efficient blocking. | | **Apple Pay & Google Pay** | Since Apple Pay and Google Pay provide us Device PANs (DPAN), the fingerprint is based on the DPAN provided by Apple/Google, not the connected card's PAN. This means that a new DPAN (and fingerprint) is generated for cards in case they are re-added to the customer's digital wallet, or added to different devices. | #### Detecting duplicate payment methods Fingerprints are a valuable tool for detecting duplicate payment methods by identifying if a payment method has been seen before. This capability, in turn, helps in preventing various types of misuse (e.g., exploitation of free trials, or association with known problematic accounts, which can be a form of fraud). To effectively use fingerprints for this purpose, you will need to create and maintain your own lists (e.g., blocklists of known problematic fingerprints, allowlists for trusted customers, or tracking frequently used fingerprints). The ideal way to utilise fingerprints is by combining them with a manual capture process. While automatic capture with subsequent refunds for problematic payments is possible, manual capture based on fingerprint validation is recommended. During your manual capture workflow, after a payment was authorised: - Check the fingerprint status by comparing it against your maintained lists and internal business rules. - If you decide to proceed with the payment (e.g., the fingerprint is not on a blocklist, or matches a trusted customer's previous payment method): [Capture the order](https://developer.revolut.com/docs/api/merchant#capture-order). - If you decide not to proceed with the payment (e.g., the fingerprint matches a known fraudulent fingerprint, or exhibits suspicious patterns): [Cancel the order](https://developer.revolut.com/docs/api/merchant#cancel-order).15a8:T9bc,A unique identifier for a payment method, always 44 characters long. This fingerprint can be used to uniquely identify various payment methods. #### Fingerprint generation | Payment method | Description | | -------- | ----------- | | **All payment methods** | A fingerprint is generated for all payment methods, including cards, Revolut Pay (card, account-to-account payments), Apple Pay, and Google Pay. | | **Cards (Revolut Pay & Card Gateway)** | For cards, the fingerprint is based on the PAN. Cards processed via Revolut Pay and our card gateway will share the same fingerprint. Renewed cards (new expiry/CVV) retain the same fingerprint for efficient blocking. | | **Apple Pay & Google Pay** | Since Apple Pay and Google Pay provide us Device PANs (DPAN), the fingerprint is based on the DPAN provided by Apple/Google, not the connected card's PAN. This means that a new DPAN (and fingerprint) is generated for cards in case they are re-added to the customer's digital wallet, or added to different devices. | #### Detecting duplicate payment methods Fingerprints are a valuable tool for detecting duplicate payment methods by identifying if a payment method has been seen before. This capability, in turn, helps in preventing various types of misuse (e.g., exploitation of free trials, or association with known problematic accounts, which can be a form of fraud). To effectively use fingerprints for this purpose, you will need to create and maintain your own lists (e.g., blocklists of known problematic fingerprints, allowlists for trusted customers, or tracking frequently used fingerprints). The ideal way to utilise fingerprints is by combining them with a manual capture process. While automatic capture with subsequent refunds for problematic payments is possible, manual capture based on fingerprint validation is recommended. During your manual capture workflow, after a payment was authorised: - Check the fingerprint status by comparing it against your maintained lists and internal business rules. - If you decide to proceed with the payment (e.g., the fingerprint is not on a blocklist, or matches a trusted customer's previous payment method): [Capture the order](https://developer.revolut.com/docs/api/merchant#capture-order). - If you decide not to proceed with the payment (e.g., the fingerprint matches a known fraudulent fingerprint, or exhibits suspicious patterns): [Cancel the order](https://developer.revolut.com/docs/api/merchant#cancel-order).15e9:T5ef,Object containing additional information about an airline booking associated with the order. Use this object to provide required data to enable **Revolut Flight Alerts**. This feature allows users to receive real-time flight updates such as check-in reminders, boarding alerts, and notifications for cancellations or delays in the Revolut app. To enable **Revolut Flight Alerts** functionalities in the Revolut app, the following fields are **required** on order creation or update, before capturing the order: ``` tickets_purchase, journey_legs, booking_url ``` :::note These are the specific data field requirements for merchants who must provide airline data. Note that these requirements can be extended on a case by case basis as decided by Revolut. | Required for airline/charter merchants | Required for OTA merchants | | -------------------------------------- | -------------------------- | |
  • `booking_id`
  • `fulfillment_date`
  • `passengers[].first_name`
  • `passengers[].last_name`
  • `journey_legs[].pnr`
  • `journey_legs[].sequence`
  • `journey_legs[].flight_number`
  • `journey_legs[].travel_date`
  • `journey_legs[].airline_code`
  • `journey_legs[].departure_airport_code`
  • `journey_legs[].arrival_airport_code`
|
  • `booking_id`
  • `fulfillment_date`
  • `passengers[].first_name`
  • `passengers[].last_name`
  • `journey_legs[].pnr`
  • `journey_legs[].arrival_airport_code`
| :::1674:T480,You can set a dynamic statement descriptor for your orders by providing a custom suffix. A statement descriptor is the text shown on cardholders' bank or card statements, helping them recognise a transaction or merchant. This field can be used to send extra information with the statement descriptor for card transactions. The complete descriptor is built using the following format: `{base}*{suffix}`, where: - **`{base}`** is the existing descriptor configured in the Revolut Business dashboard (**Settings > Business account > Merchant profile > Statement descriptor**). - **`{suffix}`** is defined by the `statement_descriptor_suffix` field. :::note - If the combined descriptor's length (base + suffix) exceeds the character limits of card scheme providers, the final value will be truncated. For example if the limit is 22 characters, the base descriptor is `"base"` and the suffix is `"testdescriptorsuffix"`, the final descriptor becomes `"base*testdescriptorsuf"`. - The final statement descriptor shown on a cardholder's statement may vary by issuing bank, as some banks apply their own custom formatting or truncation rules. :::1f:["$","$7a","refund-order",{"children":[["$","section",null,{"className":"y9a0do0","data-variant":"endpoint","children":["$","$L7b",null,{"responses":{"201":{"description":"Refund order successfully created","content":{"application/json":{"schema":{"title":"Order v5","type":"object","description":"To process the order from a credit or debit card, you create an `Order` object. You can then retrieve, capture, cancel, refund, or pay an order using its unique `id`. Alternatively, you can use its unique `token` to process a card payment with the Revolut Checkout Widget.","properties":{"id":{"type":"string","format":"uuid","description":"Permanent order ID used to retrieve, capture, cancel, or refund an order after authorization.","descriptionNode":"$L1533"},"token":{"type":"string","description":"Temporary ID for the order, which expires when the payment is authorised.\n\nThe order `token` is used for [token-based initialisation](https://developer.revolut.com/docs/sdks/merchant-web-sdk/initialisation/token-based), and is returned by the `createOrder` callback in the following payment methods:\n\n- [Embedded Checkout](https://developer.revolut.com/docs/sdks/merchant-web-sdk/payment-methods/embedded-checkout#embedded-checkout-options-interface)\n- [Revolut Pay](https://developer.revolut.com/docs/sdks/merchant-web-sdk/payment-methods/revolut-pay#widget-payments-revolut-pay-options)\n- [Apple Pay and Google Pay](https://developer.revolut.com/docs/sdks/merchant-web-sdk/payment-methods/apple-pay-google-pay#payment-request-options-interface)\n- [Pay by Bank](https://developer.revolut.com/docs/sdks/merchant-web-sdk/payment-methods/pay-by-bank#pay-by-bank-options-interface)","descriptionNode":"$L1534"},"type":{"type":"string","description":"The type of the order.","enum":"$19:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:orders:items:properties:type:enum","descriptionNode":"$L1535"},"state":{"type":"string","description":"The state of the order in its lifecycle.\n\n| State | Description |\n|-------|-------------|\n| `pending` | Order created, awaiting payment |\n| `processing` | Payment is being processed |\n| `authorised` | Payment authorised but not yet captured (for manual capture) |\n| `completed` | Payment successfully captured and settled |\n| `cancelled` | Order was cancelled |\n| `failed` | Payment failed |\n\n:::info\nFor more information, see: [Order and payment lifecycle](https://developer.revolut.com/docs/guides/merchant/reference/order-lifecycle)\n:::","enum":"$19:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:orders:items:properties:state:enum","examples":"$19:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:orders:items:properties:state:examples","descriptionNode":"$L1536"},"created_at":{"type":"string","description":"The date and time the order was created.","format":"date-time","descriptionNode":"$L1537"},"updated_at":{"type":"string","description":"The date and time the order was last updated.","format":"date-time","descriptionNode":"$L1538"},"description":{"type":"string","description":"The description of the order.","descriptionNode":"$L1539"},"capture_mode":{"type":"string","description":"The capture mode of the order. `automatic` is used by default.\n\n| Parameter value | Description |\n| --------------- | ----------- |\n| `automatic` | The order is captured automatically after payment authorisation. |\n| `manual` | The order is not captured automatically. You must manually capture the order later. |\n\n:::info\nFor more information, see [Capture an order](https://developer.revolut.com/docs/api/merchant#capture-order).\n:::","default":"automatic","enum":"$19:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:orders:items:properties:capture_mode:enum","descriptionNode":"$L153a"},"authorisation_type":{"type":"string","description":"The type of authorisation for the order. Used with manual capture mode. If omitted, `final` is used by default.\n\n### Pre-authorisation\n\nPre-authorisation allows you to reserve funds on a customer's card without immediately capturing them. This is useful for scenarios like:\n\n- Hotel bookings where the final amount may vary\n- Car rentals where additional charges may apply\n- Deposits that need to be held temporarily\n\n| Parameter value | Description |\n| --------------- | ----------- |\n| `final` | Standard authorisation for immediate or near-immediate capture. |\n| `pre_authorisation` | Reserve funds for later capture, used with manual capture mode. |\n\n:::note\nPre-authorisation must be used with `capture_mode: manual`. For more information, see [Capture an order](https://developer.revolut.com/docs/api/merchant#capture-order).\n:::","default":"final","enum":"$19:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:orders:items:properties:authorisation_type:enum","descriptionNode":"$L153b"},"cancel_authorised_after":{"type":"string","format":"duration","description":"$153c","descriptionNode":"$L153d"},"amount":{"type":"integer","description":"The order total expressed in minor currency units, according to the [ISO 4217 standard](https://en.wikipedia.org/wiki/ISO_4217). For example, `7034` in `EUR` corresponds to €70.34.\n\n:::info\n- Conversion between major and minor units varies by currency. For instance, `100` minor units equal £1.00 in `GBP`, whereas in `ISK` they represent 100 units. For more details, see the [ISO 4217 standard](https://en.wikipedia.org/wiki/ISO_4217).\n- If `line_items` are provided, the order `amount` must equal the sum of all line items' `total_amount`.\n- For card payments with a non-zero amount, the order `amount` must be at least **$0.005** (or equivalent in different currencies, calculated using Revolut's exchange rate on the payment date). Otherwise, card payments can't be performed.\n:::","descriptionNode":"$L153e"},"outstanding_amount":{"type":"integer","description":"The amount not yet paid for a given order (in minor currency units). For example, `7034` represents €70.34. \n\nThe value in this field may differ from `amount` if there are partial payments associated with the order.","descriptionNode":"$L153f"},"refunded_amount":{"type":"integer","description":"The amount that was refunded from the order (in minor currency units). For example, `7034` represents €70.34. \n\nThis applies to orders that have been refunded (i.e., orders of type `payment` that have a related `refund` order).","descriptionNode":"$L1540"},"currency":{"type":"string","format":"ISO 4217","minLength":3,"maxLength":3,"description":"[ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) currency code in upper case.\n\n:::info\nFor more information about the supported currencies, see: [Help Center](https://help.revolut.com/business/help/merchant-accounts/payments/in-which-currencies-can-i-accept-payments/).\n:::","descriptionNode":"$L1541"},"settlement_currency":{"type":"string","description":"[ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) currency code in upper case. \n\nIf `settlement_currency` is different from the value of `currency`, the money will be exchanged when the amount is settled to your merchant account. In case of a refund or chargeback, the money will be exchanged to the order's initial `currency`.\n\nIf `settlement_currency` is not specified, this value is taken from `currency`.\n\n:::info\nFor more information about the supported currencies, see: [Help Center](https://help.revolut.com/business/help/merchant-accounts/payments/in-which-currencies-can-i-accept-payments/).\n:::","descriptionNode":"$L1542"},"customer":{"type":"object","description":"$1543","properties":{"id":{"type":"string","format":"uuid","description":"Permanent ID of a customer used to retrieve, update, delete a customer. This ID can also be used to link customer to an order.\n\n:::note\nIf you provide the customer's ID during order creation, no other customer data is required, they will be parsed automatically from the referenced customer object.\n:::","descriptionNode":"$L1544"},"full_name":{"type":"string","description":"The full name of the customer.","descriptionNode":"$L1545"},"phone":{"type":"string","description":"The phone number of the customer in [E.164 format](https://en.wikipedia.org/wiki/E.164).","descriptionNode":"$L1546"},"email":{"type":"string","format":"email","description":"The email address of the customer.","descriptionNode":"$L1547"},"date_of_birth":{"type":"string","format":"date","description":"The birth date of the customer.","descriptionNode":"$L1548"}},"descriptionNode":"$L1549"},"payments":{"type":"array","description":"The details of all the payments that have been made towards this order (successful or unsuccessful).","items":{"type":"object","description":"Represents a payment for an order.\n\nFor pre-authorised payments, the `authorised_amount` field tracks the currently authorised amount, which may differ from `amount` during incremental authorisation processing.","properties":{"id":{"type":"string","format":"uuid","description":"The ID of the payment.","descriptionNode":"$L154a"},"state":{"type":"string","description":"The status of the payment.","enum":"$21:props:children:0:props:children:props:responses:200:content:application/json:schema:items:properties:state:enum","descriptionNode":"$L154b"},"decline_reason":{"type":"string","description":"The reason for a `failed` or `declined` payment.\n\nA failed or declined payment can result from multiple reasons. To learn more, check our [failure reasons](https://developer.revolut.com/docs/guides/merchant/reference/error-codes/decline-reasons).","enum":"$21:props:children:0:props:children:props:responses:200:content:application/json:schema:items:properties:decline_reason:enum","descriptionNode":"$L154c"},"bank_message":{"type":"string","description":"The reason for a `failed` or `declined` payment, sent by the financial institution processing the payment.","descriptionNode":"$L154d"},"created_at":{"type":"string","format":"date-time","description":"The date and time the payment was created.","descriptionNode":"$L154e"},"updated_at":{"type":"string","format":"date-time","description":"The date and time the payment was last updated.","descriptionNode":"$L154f"},"token":{"type":"string","format":"uuid","description":"Temporary token of the payment used to fetch the reward offer during checkout and link user registrations to the given offers. \n\nThe token is only valid for a limited time.","descriptionNode":"$L1550"},"amount":{"type":"integer","format":"int64","minimum":0,"description":"The payment amount in minor units (e.g., cents). The value of this field depends on the payment type and state.\n\n| Payment type | State | Amount value |\n|--------------|-------|--------------|\n| Standard payment | Any | Total payment amount |\n| Pre-authorised payment | `authorisation_started` | New amount being authorised (during increment processing) |\n| Pre-authorised payment | `authorised` | Currently authorised amount (equals `authorised_amount`) |\n\n:::info\nFor pre-authorised payments, see the `authorised_amount` field for tracking the currently authorised amount separately.\n:::","examples":"$21:props:children:0:props:children:props:responses:200:content:application/json:schema:items:properties:amount:examples","descriptionNode":"$L1551"},"authorised_amount":{"type":"integer","description":"The currently authorised amount for this payment (in minor units).\n\nFor pre-authorised payments with incremental authorization:\n- Initially equals the `amount` field\n- Remains unchanged during increment processing\n- Updates to new amount upon successful increment\n- Remains at original amount if increment is declined\n\nFor standard payments, this field may not be present or will equal the `amount` field.","examples":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:authorised_amount:examples","descriptionNode":"$L1552"},"currency":{"type":"string","format":"ISO 4217","minLength":3,"maxLength":3,"description":"[ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) currency code in upper case.\n\n:::info\nFor more information about the supported currencies, see: [Help Center](https://help.revolut.com/business/help/merchant-accounts/payments/in-which-currencies-can-i-accept-payments/).\n:::","descriptionNode":"$L1553"},"settled_amount":{"type":"integer","description":"The amount of the settled payment (minor currency unit). For example, `7034` stands for €70.34.","descriptionNode":"$L1554"},"settled_currency":{"type":"string","description":"The currency of the settled payment. [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) currency code in upper case.\n\n:::info\nFor more information about the supported currencies, see: [Help Center](https://help.revolut.com/business/help/merchant-accounts/payments/in-which-currencies-can-i-accept-payments/).\n:::","descriptionNode":"$L1555"},"payment_method":{"type":"object","description":"The details of the payment method used to make the payment.","discriminator":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:discriminator","oneOf":[{"type":"object","description":"Object containing details of a card used via Apple Pay.","properties":{"id":{"type":"string","format":"uuid","description":"ID of the saved payment method.\n\n:::note\nThe `id` parameter is only returned when the payment method is saved.\n:::","descriptionNode":"$L1556"},"type":{"type":"string","enum":"$21:props:children:0:props:children:props:responses:200:content:application/json:schema:items:properties:payment_method:oneOf:2:properties:type:enum","description":"The type of payment method used to pay for the order.\n\nAvailable values:\n\n| Payment method `type` | Description |\n| --------------------- | ----------- |\n| `apple_pay` | The customer paid the order using Apple Pay. |\n| `card` | The customer paid the order using their credit or debit card. |\n| `google_pay` | The customer paid the order using Google Pay. |\n| `revolut_pay_card` | The customer paid the order via Revolut Pay using their credit or debit card. |\n| `revolut_pay_account` | The customer paid the order via Revolut Pay using their Revolut account. |\n| `sepa_direct_debit` | The customer paid the order using SEPA Direct Debit. |","descriptionNode":"$L1557"},"card_brand":{"type":"string","description":"The type of the card.","enum":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:0:properties:card_brand:enum","descriptionNode":"$L1558"},"funding":{"type":"string","description":"The type of card funding.","enum":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:0:properties:funding:enum","descriptionNode":"$L1559"},"card_country_code":{"type":"string","description":"The 2-letter country code of the country where the card was issued.","descriptionNode":"$L155a"},"card_bin":{"type":"string","description":"The BIN of the card.","minLength":6,"maxLength":6,"descriptionNode":"$L155b"},"card_last_four":{"type":"string","description":"The last four digits of the card number.","minLength":4,"maxLength":4,"descriptionNode":"$L155c"},"card_expiry":{"type":"string","format":"MM/YY","description":"The expiry date of the card in the format of MM/YY.","descriptionNode":"$L155d"},"cardholder_name":{"type":"string","description":"The name of the cardholder.","descriptionNode":"$L155e"},"checks":{"type":"object","description":"The details of the check for card payment. Only for orders with successful payments.","properties":{"three_ds":{"type":"object","description":"The details of the 3D Secure check. Only for orders with successful payments.\n\n:::note\nNot returned for Apple Pay and Google Pay payments.\n:::","properties":{"eci":{"type":"string","description":"The Electronic Commerce Indicator (ECI) value corresponds to the authentication result and indicates the level of security used when the payment information was provided.","descriptionNode":"$L155f"},"state":{"type":"string","description":"The result of 3D Secure check.","enum":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:0:properties:checks:properties:three_ds:properties:state:enum","descriptionNode":"$L1560"},"version":{"type":"integer","description":"The 3D Secure version.","descriptionNode":"$L1561"}},"descriptionNode":"$L1562"},"cvv_verification":{"type":"string","description":"The result of CVV verification.\n\n| Parameter value | Description |\n| ----- | ----------- |\n| `match` | CVV matches the card's CVV |\n| `not_match` | CVV does not match the card's CVV |\n| `incorrect` | CVV format is incorrect for this type of card |\n| `not_processed` | CVV verification was not performed |","enum":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:0:properties:checks:properties:cvv_verification:enum","descriptionNode":"$L1563"},"address":{"type":"string","description":"The result of address verification.","enum":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:0:properties:checks:properties:address:enum","descriptionNode":"$L1564"},"postcode":{"type":"string","description":"The result of postcode verification.","enum":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:0:properties:checks:properties:postcode:enum","descriptionNode":"$L1565"},"cardholder":{"type":"string","description":"The result of cardholder verification.","enum":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:0:properties:checks:properties:cardholder:enum","descriptionNode":"$L1566"}},"descriptionNode":"$L1567"},"authorisation_code":{"type":"string","description":"The authorisation code (or auth code) is a short, alphanumeric code returned by the cardholder's issuing bank to the merchant's terminal or payment gateway.\n\nIt serves as confirmation that the transaction has been approved and funds are available.","pattern":"^[a-zA-Z0-9]{2,6}$","minLength":2,"maxLength":6,"examples":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:0:properties:authorisation_code:examples","descriptionNode":"$L1568"},"arn":{"type":"string","description":"Acquirer Reference Number (ARN) of the payment.\n\n:::note\nOnly returned for refund payments made by a card.\n:::","minLength":23,"maxLength":23,"examples":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:0:properties:arn:examples","descriptionNode":"$L1569"},"capture_deadline":{"type":"string","format":"date-time","description":"The date and time by which the payment must be captured.\n\nAfter this deadline, the authorised funds may be automatically released by the card issuer.","descriptionNode":"$L156a"},"terminal_hardware_id":{"type":"string","description":"The hardware identifier of the Revolut Terminal device used to process the payment.\n\n:::note\nOnly present for card-present transactions processed via Revolut Terminal.\n:::","descriptionNode":"$L156b"},"fingerprint":{"type":"string","minLength":44,"maxLength":44,"description":"$156c","examples":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:0:properties:fingerprint:examples","descriptionNode":"$L156d"},"network_transaction_id":{"type":"string","description":"The Network Transaction ID (NTI) is a unique identifier assigned by the card scheme (e.g., Visa or Mastercard) to a card transaction.\n\nIt can be used to trace the transaction across the payment network, link recurring or instalment payments to the original authorisation, and support dispute resolution.","descriptionNode":"$L156e"}},"required":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:0:required","descriptionNode":"$L156f"},{"type":"object","description":"Object containing details of the card used for the payment.","properties":{"id":{"type":"string","format":"uuid","description":"ID of the saved payment method.\n\n:::note\nThe `id` parameter is only returned when the payment method is saved.\n:::","descriptionNode":"$L1570"},"type":{"type":"string","enum":"$21:props:children:0:props:children:props:responses:200:content:application/json:schema:items:properties:payment_method:oneOf:2:properties:type:enum","description":"The type of payment method used to pay for the order.\n\nAvailable values:\n\n| Payment method `type` | Description |\n| --------------------- | ----------- |\n| `apple_pay` | The customer paid the order using Apple Pay. |\n| `card` | The customer paid the order using their credit or debit card. |\n| `google_pay` | The customer paid the order using Google Pay. |\n| `revolut_pay_card` | The customer paid the order via Revolut Pay using their credit or debit card. |\n| `revolut_pay_account` | The customer paid the order via Revolut Pay using their Revolut account. |\n| `sepa_direct_debit` | The customer paid the order using SEPA Direct Debit. |","descriptionNode":"$L1571"},"card_brand":{"type":"string","description":"The type of the card.","enum":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:1:properties:card_brand:enum","descriptionNode":"$L1572"},"funding":{"type":"string","description":"The type of card funding.","enum":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:1:properties:funding:enum","descriptionNode":"$L1573"},"card_country_code":{"type":"string","description":"The 2-letter country code of the country where the card was issued.","descriptionNode":"$L1574"},"card_bin":{"type":"string","description":"The BIN of the card.","minLength":6,"maxLength":6,"descriptionNode":"$L1575"},"card_last_four":{"type":"string","description":"The last four digits of the card number.","minLength":4,"maxLength":4,"descriptionNode":"$L1576"},"card_expiry":{"type":"string","format":"MM/YY","description":"The expiry date of the card in the format of MM/YY.","descriptionNode":"$L1577"},"cardholder_name":{"type":"string","description":"The name of the cardholder.","descriptionNode":"$L1578"},"checks":{"type":"object","description":"The details of the check for card payment. Only for orders with successful payments.","properties":{"three_ds":"$1f:props:children:0:props:children:props:responses:201:content:application/json:schema:properties:payments:items:properties:payment_method:oneOf:0:properties:checks:properties:three_ds","cvv_verification":"$1f:props:children:0:props:children:props:responses:201:content:application/json:schema:properties:payments:items:properties:payment_method:oneOf:0:properties:checks:properties:cvv_verification","address":"$1f:props:children:0:props:children:props:responses:201:content:application/json:schema:properties:payments:items:properties:payment_method:oneOf:0:properties:checks:properties:address","postcode":"$1f:props:children:0:props:children:props:responses:201:content:application/json:schema:properties:payments:items:properties:payment_method:oneOf:0:properties:checks:properties:postcode","cardholder":"$1f:props:children:0:props:children:props:responses:201:content:application/json:schema:properties:payments:items:properties:payment_method:oneOf:0:properties:checks:properties:cardholder"},"descriptionNode":"$L1579"},"authorisation_code":{"type":"string","description":"The authorisation code (or auth code) is a short, alphanumeric code returned by the cardholder's issuing bank to the merchant's terminal or payment gateway.\n\nIt serves as confirmation that the transaction has been approved and funds are available.","pattern":"^[a-zA-Z0-9]{2,6}$","minLength":2,"maxLength":6,"examples":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:0:properties:authorisation_code:examples","descriptionNode":"$L157a"},"arn":{"type":"string","description":"Acquirer Reference Number (ARN) of the payment.\n\n:::note\nOnly returned for refund payments made by a card.\n:::","minLength":23,"maxLength":23,"examples":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:0:properties:arn:examples","descriptionNode":"$L157b"},"capture_deadline":{"type":"string","format":"date-time","description":"The date and time by which the payment must be captured.\n\nAfter this deadline, the authorised funds may be automatically released by the card issuer.","descriptionNode":"$L157c"},"terminal_hardware_id":{"type":"string","description":"The hardware identifier of the Revolut Terminal device used to process the payment.\n\n:::note\nOnly present for card-present transactions processed via Revolut Terminal.\n:::","descriptionNode":"$L157d"},"fingerprint":{"type":"string","minLength":44,"maxLength":44,"description":"$157e","examples":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:0:properties:fingerprint:examples","descriptionNode":"$L157f"},"network_transaction_id":{"type":"string","description":"The Network Transaction ID (NTI) is a unique identifier assigned by the card scheme (e.g., Visa or Mastercard) to a card transaction.\n\nIt can be used to trace the transaction across the payment network, link recurring or instalment payments to the original authorisation, and support dispute resolution.","descriptionNode":"$L1580"}},"required":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:1:required","descriptionNode":"$L1581"},{"type":"object","description":"Object containing details of a card used via Google Pay.","properties":{"id":{"type":"string","format":"uuid","description":"ID of the saved payment method.\n\n:::note\nThe `id` parameter is only returned when the payment method is saved.\n:::","descriptionNode":"$L1582"},"type":{"type":"string","enum":"$21:props:children:0:props:children:props:responses:200:content:application/json:schema:items:properties:payment_method:oneOf:2:properties:type:enum","description":"The type of payment method used to pay for the order.\n\nAvailable values:\n\n| Payment method `type` | Description |\n| --------------------- | ----------- |\n| `apple_pay` | The customer paid the order using Apple Pay. |\n| `card` | The customer paid the order using their credit or debit card. |\n| `google_pay` | The customer paid the order using Google Pay. |\n| `revolut_pay_card` | The customer paid the order via Revolut Pay using their credit or debit card. |\n| `revolut_pay_account` | The customer paid the order via Revolut Pay using their Revolut account. |\n| `sepa_direct_debit` | The customer paid the order using SEPA Direct Debit. |","descriptionNode":"$L1583"},"card_brand":{"type":"string","description":"The type of the card.","enum":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:2:properties:card_brand:enum","descriptionNode":"$L1584"},"funding":{"type":"string","description":"The type of card funding.","enum":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:2:properties:funding:enum","descriptionNode":"$L1585"},"card_country_code":{"type":"string","description":"The 2-letter country code of the country where the card was issued.","descriptionNode":"$L1586"},"card_bin":{"type":"string","description":"The BIN of the card.","minLength":6,"maxLength":6,"descriptionNode":"$L1587"},"card_last_four":{"type":"string","description":"The last four digits of the card number.","minLength":4,"maxLength":4,"descriptionNode":"$L1588"},"card_expiry":{"type":"string","format":"MM/YY","description":"The expiry date of the card in the format of MM/YY.","descriptionNode":"$L1589"},"cardholder_name":{"type":"string","description":"The name of the cardholder.","descriptionNode":"$L158a"},"checks":{"type":"object","description":"The details of the check for card payment. Only for orders with successful payments.","properties":{"three_ds":"$1f:props:children:0:props:children:props:responses:201:content:application/json:schema:properties:payments:items:properties:payment_method:oneOf:0:properties:checks:properties:three_ds","cvv_verification":"$1f:props:children:0:props:children:props:responses:201:content:application/json:schema:properties:payments:items:properties:payment_method:oneOf:0:properties:checks:properties:cvv_verification","address":"$1f:props:children:0:props:children:props:responses:201:content:application/json:schema:properties:payments:items:properties:payment_method:oneOf:0:properties:checks:properties:address","postcode":"$1f:props:children:0:props:children:props:responses:201:content:application/json:schema:properties:payments:items:properties:payment_method:oneOf:0:properties:checks:properties:postcode","cardholder":"$1f:props:children:0:props:children:props:responses:201:content:application/json:schema:properties:payments:items:properties:payment_method:oneOf:0:properties:checks:properties:cardholder"},"descriptionNode":"$L158b"},"authorisation_code":{"type":"string","description":"The authorisation code (or auth code) is a short, alphanumeric code returned by the cardholder's issuing bank to the merchant's terminal or payment gateway.\n\nIt serves as confirmation that the transaction has been approved and funds are available.","pattern":"^[a-zA-Z0-9]{2,6}$","minLength":2,"maxLength":6,"examples":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:0:properties:authorisation_code:examples","descriptionNode":"$L158c"},"arn":{"type":"string","description":"Acquirer Reference Number (ARN) of the payment.\n\n:::note\nOnly returned for refund payments made by a card.\n:::","minLength":23,"maxLength":23,"examples":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:0:properties:arn:examples","descriptionNode":"$L158d"},"capture_deadline":{"type":"string","format":"date-time","description":"The date and time by which the payment must be captured.\n\nAfter this deadline, the authorised funds may be automatically released by the card issuer.","descriptionNode":"$L158e"},"terminal_hardware_id":{"type":"string","description":"The hardware identifier of the Revolut Terminal device used to process the payment.\n\n:::note\nOnly present for card-present transactions processed via Revolut Terminal.\n:::","descriptionNode":"$L158f"},"fingerprint":{"type":"string","minLength":44,"maxLength":44,"description":"$1590","examples":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:0:properties:fingerprint:examples","descriptionNode":"$L1591"},"network_transaction_id":{"type":"string","description":"The Network Transaction ID (NTI) is a unique identifier assigned by the card scheme (e.g., Visa or Mastercard) to a card transaction.\n\nIt can be used to trace the transaction across the payment network, link recurring or instalment payments to the original authorisation, and support dispute resolution.","descriptionNode":"$L1592"}},"required":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:2:required","descriptionNode":"$L1593"},{"type":"object","description":"Object containing details of a card used via Revolut Pay.","properties":{"id":{"type":"string","format":"uuid","description":"ID of the saved payment method.\n\n:::note\nThe `id` parameter is only returned when the payment method is saved.\n:::","descriptionNode":"$L1594"},"type":{"type":"string","enum":"$21:props:children:0:props:children:props:responses:200:content:application/json:schema:items:properties:payment_method:oneOf:2:properties:type:enum","description":"The type of payment method used to pay for the order.\n\nAvailable values:\n\n| Payment method `type` | Description |\n| --------------------- | ----------- |\n| `apple_pay` | The customer paid the order using Apple Pay. |\n| `card` | The customer paid the order using their credit or debit card. |\n| `google_pay` | The customer paid the order using Google Pay. |\n| `revolut_pay_card` | The customer paid the order via Revolut Pay using their credit or debit card. |\n| `revolut_pay_account` | The customer paid the order via Revolut Pay using their Revolut account. |\n| `sepa_direct_debit` | The customer paid the order using SEPA Direct Debit. |","descriptionNode":"$L1595"},"card_brand":{"type":"string","description":"The type of the card.","enum":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:3:properties:card_brand:enum","descriptionNode":"$L1596"},"funding":{"type":"string","description":"The type of card funding.","enum":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:3:properties:funding:enum","descriptionNode":"$L1597"},"card_country_code":{"type":"string","description":"The 2-letter country code of the country where the card was issued.","descriptionNode":"$L1598"},"card_bin":{"type":"string","description":"The BIN of the card.","minLength":6,"maxLength":6,"descriptionNode":"$L1599"},"card_last_four":{"type":"string","description":"The last four digits of the card number.","minLength":4,"maxLength":4,"descriptionNode":"$L159a"},"card_expiry":{"type":"string","format":"MM/YY","description":"The expiry date of the card in the format of MM/YY.","descriptionNode":"$L159b"},"cardholder_name":{"type":"string","description":"The name of the cardholder.","descriptionNode":"$L159c"},"checks":{"type":"object","description":"The details of the check for card payment. Only for orders with successful payments.","properties":{"three_ds":"$1f:props:children:0:props:children:props:responses:201:content:application/json:schema:properties:payments:items:properties:payment_method:oneOf:0:properties:checks:properties:three_ds","cvv_verification":"$1f:props:children:0:props:children:props:responses:201:content:application/json:schema:properties:payments:items:properties:payment_method:oneOf:0:properties:checks:properties:cvv_verification","address":"$1f:props:children:0:props:children:props:responses:201:content:application/json:schema:properties:payments:items:properties:payment_method:oneOf:0:properties:checks:properties:address","postcode":"$1f:props:children:0:props:children:props:responses:201:content:application/json:schema:properties:payments:items:properties:payment_method:oneOf:0:properties:checks:properties:postcode","cardholder":"$1f:props:children:0:props:children:props:responses:201:content:application/json:schema:properties:payments:items:properties:payment_method:oneOf:0:properties:checks:properties:cardholder"},"descriptionNode":"$L159d"},"authorisation_code":{"type":"string","description":"The authorisation code (or auth code) is a short, alphanumeric code returned by the cardholder's issuing bank to the merchant's terminal or payment gateway.\n\nIt serves as confirmation that the transaction has been approved and funds are available.","pattern":"^[a-zA-Z0-9]{2,6}$","minLength":2,"maxLength":6,"examples":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:0:properties:authorisation_code:examples","descriptionNode":"$L159e"},"arn":{"type":"string","description":"Acquirer Reference Number (ARN) of the payment.\n\n:::note\nOnly returned for refund payments made by a card.\n:::","minLength":23,"maxLength":23,"examples":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:0:properties:arn:examples","descriptionNode":"$L159f"},"capture_deadline":{"type":"string","format":"date-time","description":"The date and time by which the payment must be captured.\n\nAfter this deadline, the authorised funds may be automatically released by the card issuer.","descriptionNode":"$L15a0"},"terminal_hardware_id":{"type":"string","description":"The hardware identifier of the Revolut Terminal device used to process the payment.\n\n:::note\nOnly present for card-present transactions processed via Revolut Terminal.\n:::","descriptionNode":"$L15a1"},"fingerprint":{"type":"string","minLength":44,"maxLength":44,"description":"$15a2","examples":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:0:properties:fingerprint:examples","descriptionNode":"$L15a3"},"network_transaction_id":{"type":"string","description":"The Network Transaction ID (NTI) is a unique identifier assigned by the card scheme (e.g., Visa or Mastercard) to a card transaction.\n\nIt can be used to trace the transaction across the payment network, link recurring or instalment payments to the original authorisation, and support dispute resolution.","descriptionNode":"$L15a4"}},"required":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:3:required","descriptionNode":"$L15a5"},{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"ID of the saved payment method.\n\n:::note\nThe `id` parameter is only returned when the payment method is saved.\n:::","descriptionNode":"$L15a6"},"type":{"type":"string","enum":"$21:props:children:0:props:children:props:responses:200:content:application/json:schema:items:properties:payment_method:oneOf:2:properties:type:enum","description":"The type of payment method used to pay for the order.\n\nAvailable values:\n\n| Payment method `type` | Description |\n| --------------------- | ----------- |\n| `apple_pay` | The customer paid the order using Apple Pay. |\n| `card` | The customer paid the order using their credit or debit card. |\n| `google_pay` | The customer paid the order using Google Pay. |\n| `revolut_pay_card` | The customer paid the order via Revolut Pay using their credit or debit card. |\n| `revolut_pay_account` | The customer paid the order via Revolut Pay using their Revolut account. |\n| `sepa_direct_debit` | The customer paid the order using SEPA Direct Debit. |","descriptionNode":"$L15a7"},"fingerprint":{"type":"string","minLength":44,"maxLength":44,"description":"$15a8","examples":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:0:properties:fingerprint:examples","descriptionNode":"$L15a9"}},"required":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:4:required"},{"type":"object","description":"Object containing details of a SEPA Direct Debit payment.\n\n:::info\nFor more information, see: [SEPA Direct Debit server-to-server integration](https://developer.revolut.com/docs/guides/merchant/accept-payments/payment-methods/sepa-direct-debit/server-to-server)\n:::","properties":{"id":{"type":"string","format":"uuid","description":"ID of the saved payment method.\n\n:::note\nThe `id` parameter is only returned when the payment method is saved for the merchant.\n:::","descriptionNode":"$L15aa"},"type":{"type":"string","enum":"$21:props:children:0:props:children:props:responses:200:content:application/json:schema:items:properties:payment_method:oneOf:2:properties:type:enum","description":"The type of payment method used to pay for the order.\n\nAvailable values:\n\n| Payment method `type` | Description |\n| --------------------- | ----------- |\n| `apple_pay` | The customer paid the order using Apple Pay. |\n| `card` | The customer paid the order using their credit or debit card. |\n| `google_pay` | The customer paid the order using Google Pay. |\n| `revolut_pay_card` | The customer paid the order via Revolut Pay using their credit or debit card. |\n| `revolut_pay_account` | The customer paid the order via Revolut Pay using their Revolut account. |\n| `sepa_direct_debit` | The customer paid the order using SEPA Direct Debit. |","descriptionNode":"$L15ab"},"debtor_iban_last_four":{"type":"string","description":"The last four digits of the debtor's IBAN.","minLength":4,"maxLength":4,"descriptionNode":"$L15ac"},"debtor_name":{"type":"string","description":"The full name of the debtor as provided in the mandate.","descriptionNode":"$L15ad"},"mandate_reference":{"type":"string","description":"The unique mandate reference generated by Revolut. Include this in pre-debit notifications sent to your customers.","descriptionNode":"$L15ae"}},"required":"$21:props:children:0:props:children:props:responses:200:content:application/json:schema:items:properties:payment_method:oneOf:2:required","descriptionNode":"$L15af"}],"descriptionNode":"$L15b0"},"authentication_challenge":{"type":"object","description":"Details about the authentication challenge that should be performed to complete the authentication process. For more information about Revolut's 3DS solution, see: [3D Secure overview](https://developer.revolut.com/docs/guides/merchant/reference/3d-secure).\n\nOnly returned if the payment's state is `authentication_challenge`.","discriminator":"$21:props:children:0:props:children:props:responses:200:content:application/json:schema:items:properties:authentication_challenge:discriminator","oneOf":[{"title":"three_ds","type":"object","description":"Information about the 3DS challenge.","properties":{"type":{"type":"string","enum":"$21:props:children:0:props:children:props:responses:200:content:application/json:schema:items:properties:authentication_challenge:oneOf:0:properties:type:enum","description":"Type of the authentication challenge the payment triggers.","descriptionNode":"$L15b1"},"acs_url":{"type":"string","format":"url","description":"The URL of the authentication challenge.","descriptionNode":"$L15b2"}},"required":"$21:props:children:0:props:children:props:responses:200:content:application/json:schema:items:properties:authentication_challenge:oneOf:0:required","descriptionNode":"$L15b3"},{"title":"three_ds_fingerprint","type":"object","description":"Information about the 3DS fingerprint challenge.","properties":{"type":{"type":"string","enum":"$21:props:children:0:props:children:props:responses:200:content:application/json:schema:items:properties:authentication_challenge:oneOf:0:properties:type:enum","description":"Type of the authentication challenge the payment triggers.","descriptionNode":"$L15b4"},"fingerprint_url":{"type":"string","format":"url","description":"The URL of the fingerprint. (Used only internally by Revolut.)","descriptionNode":"$L15b5"},"fingerprint_data":{"type":"string","format":"JSON","description":"Data about the fingerprint used for authentication. (Used only internally\nby Revolut.)","descriptionNode":"$L15b6"}},"required":"$21:props:children:0:props:children:props:responses:200:content:application/json:schema:items:properties:authentication_challenge:oneOf:1:required","descriptionNode":"$L15b7"}],"descriptionNode":"$L15b8"},"billing_address":{"type":"object","description":"Object containing address details.","properties":{"street_line_1":{"type":"string","description":"Street line 1 information.","maxLength":100,"descriptionNode":"$L15b9"},"street_line_2":{"type":"string","description":"Street line 2 information.","maxLength":100,"descriptionNode":"$L15ba"},"region":{"type":"string","description":"The region associated with the address.","maxLength":100,"descriptionNode":"$L15bb"},"city":{"type":"string","description":"The city associated with the address.","maxLength":100,"descriptionNode":"$L15bc"},"country_code":{"type":"string","description":"The 2-letter country code of the country associated with the address.","maxLength":2,"descriptionNode":"$L15bd"},"postcode":{"type":"string","description":"The postcode associated with the address.","maxLength":100,"descriptionNode":"$L15be"}},"required":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:billing_address:required","descriptionNode":"$L15bf"},"risk_level":{"type":"string","description":"The risk level of the card.\n\nIf the risk level is `high`, the payment might be declined.","enum":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:risk_level:enum","descriptionNode":"$L15c0"},"fees":{"type":"array","description":"The details of the order fee.","items":{"type":"object","properties":{"type":{"type":"string","description":"The type of the order fee.","enum":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:fees:items:properties:type:enum","descriptionNode":"$L15c1"},"amount":{"type":"integer","description":"The amount of the payment fee (minor currency unit). For example, enter `7034` for €70.34 in the field.","descriptionNode":"$L15c2"},"currency":{"type":"string","description":"The currency of the payment fee. [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) currency code in upper case.\n\n:::info\nFor more information about the supported currencies, see: [Help Center](https://help.revolut.com/business/help/merchant-accounts/payments/in-which-currencies-can-i-accept-payments/).\n:::","descriptionNode":"$L15c3"}}},"descriptionNode":"$L15c4"},"payer":{"title":"Payer","type":"object","description":"The person who made the payment. This object is present when an email or phone number is provided during the payment flow.\n\nCapturing payer details lets you identify exactly who authorised the charge, reach the right person for receipts or refund queries, and support compliance or fraud-review workflows where the paying identity matters.","properties":{"email":{"description":"The email of the person who made the payment.","type":"string","format":"email","descriptionNode":"$L15c5"},"phone":{"description":"The phone number of the payer in [E.164 format](https://en.wikipedia.org/wiki/E.164).","type":"string","descriptionNode":"$L15c6"}},"descriptionNode":"$L15c7"}},"required":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payments:items:required","descriptionNode":"$L15c8"},"descriptionNode":"$L15c9"},"incremental_authorisations":{"type":"array","description":"History of incremental authorisation attempts for this order.\n\nOnly present for orders with `authorisation_type: pre_authorisation`.\n\nContains all increment attempts in chronological order.","items":{"type":"object","description":"Represents a single incremental authorisation attempt on an order.\n\nThe `incremental_authorisations` array tracks all increment attempts (successful and failed) in chronological order.","properties":{"new_amount":{"type":"integer","description":"The new total amount requested in this increment (in minor units).","examples":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:incremental_authorisations:items:properties:new_amount:examples","descriptionNode":"$L15ca"},"old_amount":{"type":"integer","description":"The previously authorised amount before this increment (in minor units).","examples":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:incremental_authorisations:items:properties:old_amount:examples","descriptionNode":"$L15cb"},"state":{"type":"string","enum":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:incremental_authorisations:items:properties:state:enum","description":"The state of this incremental authorization attempt.\n\n| State | Description |\n|-------|-------------|\n| `pending` | Increment registered in system, not yet submitted to card network |\n| `processing` | Increment is being processed by card network |\n| `authorised` | Increment was successfully authorised |\n| `declined` | Increment was declined by card issuer |\n| `failed` | Increment failed due to technical error (not an issuer decline) |","descriptionNode":"$L15cc"},"reference":{"type":"string","maxLength":255,"description":"External reference for this incremental authorisation.\n\n:::tip\nUse your internal charge or invoice ID. This reference is returned in webhooks for easy matching to your system.\n:::","examples":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:incremental_authorisations:items:properties:reference:examples","descriptionNode":"$L15cd"},"line_items":{"type":"array","description":"Line items associated with this increment (if provided).\n\n:::note\nIf the increment is successful, these line items will override the existing order line items.\n:::","items":{"type":"object","properties":{"name":{"type":"string","maxLength":250,"description":"Name of the line item.","descriptionNode":"$L15ce"},"type":{"type":"string","enum":"$19:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:orders:items:properties:line_items:items:properties:type:enum","description":"Type of the line item.","descriptionNode":"$L15cf"},"quantity":{"type":"object","description":"Object representing the quantity details of a line item, including the amount and its associated unit of measurement.","properties":{"value":{"type":"number","format":"double","minimum":0,"description":"The number of units of the line item.","descriptionNode":"$L15d0"},"unit":{"type":"string","maxLength":100,"description":"The measurement unit for the quantity, such as `cm`, or `kg`.","descriptionNode":"$L15d1"}},"required":"$19:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:orders:items:properties:line_items:items:properties:quantity:required","descriptionNode":"$L15d2"},"unit_price_amount":{"type":"integer","format":"int64","minimum":0,"description":"The unit price of the line item.","descriptionNode":"$L15d3"},"total_amount":{"type":"integer","format":"int64","description":"The total amount to be paid for the line item, including taxes and discounts.","descriptionNode":"$L15d4"},"external_id":{"type":"string","maxLength":250,"description":"Unique identifier of line item in the merchant's system.","descriptionNode":"$L15d5"},"discounts":{"type":"array","maxItems":50,"description":"A list of discounts applied to the line item. Each discount should be subtracted from the total amount payable for the item.","items":{"type":"object","description":"Details of a discount applied to the line item, including its name and monetary value.","properties":{"name":{"type":"string","maxLength":100,"description":"The specific name or label of the discount applied to the line item.","descriptionNode":"$L15d6"},"amount":{"type":"integer","format":"int64","minimum":0,"description":"The monetary value of the discount. ","descriptionNode":"$L15d7"}},"required":"$19:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:orders:items:properties:line_items:items:properties:discounts:items:required","descriptionNode":"$L15d8"},"descriptionNode":"$L15d9"},"taxes":{"type":"array","maxItems":50,"description":"A list of taxes applied to the line item. Each tax should be added to the total amount payable for the item.","items":{"type":"object","description":"Details about a tax applied to the line item, including its name and the corresponding amount.","properties":{"name":{"type":"string","description":"The specific name or designation of the tax applied to the line item.","maxLength":100,"descriptionNode":"$L15da"},"amount":{"type":"integer","format":"int64","description":"The monetary value of the tax in minor currency units (e.g., cents for EUR).","minimum":0,"descriptionNode":"$L15db"}},"required":"$19:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:orders:items:properties:line_items:items:properties:taxes:items:required","descriptionNode":"$L15dc"},"descriptionNode":"$L15dd"},"image_urls":{"type":"array","maxItems":50,"description":"A list of URLs pointing to images related to the line item. These images can provide visual details or representations of the item.","items":{"type":"string","format":"uri","pattern":"^https?:\\/{2}.+/gi","maxLength":2000,"description":"URL to an image associated with the line item.\n\n:::warning\nRestrictions:\n- Must be a valid URI as defined by [RFC 3986](https://datatracker.ietf.org/doc/html/rfc3986)\n- URI scheme is required and must be either `http` or `https`\n- URI host is required and cannot be `localhost` or an IP address\n- Max length: `2000`\n- Reserved or invalid characters must be percent-encoded (for example, use `%20` instead of a space)\n:::","descriptionNode":"$L15de"},"descriptionNode":"$L15df"},"description":{"type":"string","maxLength":1024,"description":"Description of the line item.","descriptionNode":"$L15e0"},"url":{"type":"string","format":"uri","pattern":"^https?:\\/{2}.+/gi","maxLength":2000,"description":"An HTTP/HTTPS URL that links to more information about the line item, such as a product page or details.\n\n:::warning\nRestrictions:\n- Must be a valid URI as defined by [RFC 3986](https://datatracker.ietf.org/doc/html/rfc3986)\n- URI scheme is required and must be either `http` or `https`\n- URI host is required and cannot be `localhost` or an IP address\n- Max length: `2000`\n- Reserved or invalid characters must be percent-encoded (for example, use `%20` instead of a space)\n:::","descriptionNode":"$L15e1"}},"required":"$19:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:orders:items:properties:line_items:items:required"},"descriptionNode":"$L15e2"},"reason":{"type":"string","description":"Reason why increment was declined or failed.\n\n:::note\nOnly present when `state` is `declined` or `failed`.\n:::","examples":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:incremental_authorisations:items:properties:reason:examples","descriptionNode":"$L15e3"}},"descriptionNode":"$L15e4"},"descriptionNode":"$L15e5"},"location_id":{"type":"string","format":"uuid","description":"Unique ID representing the location where merchants sells products.\n\n:::info\nFor more information, see: [Locations](https://developer.revolut.com/docs/api/merchant#tag-locations).\n::: ","descriptionNode":"$L15e6"},"metadata":{"type":"object","description":"Additional information to track your orders in your system, by providing custom metadata using `\"\" : \"\"` pairs.\n\n:::warning\n**Restrictions:**\n\n- Both keys and values must be `string`s\n- Values cannot be `null`.\n- Max number of key-value pairs: `50`\n- Max length of values: `500` characters\n- Format of keys: Must start with a letter and contain only letters, digits, and underscores. Max 40 characters. Pattern: `^[a-zA-Z][a-zA-Z\\\\d_]{0,39}$`\n:::","maxProperties":50,"additionalProperties":{"type":"string","maxLength":500,"description":"Additional metadata value provided with the corresponding metadata key.","descriptionNode":"$L15e7"},"examples":"$19:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:orders:items:properties:metadata:examples","descriptionNode":"$L15e8"},"industry_data":{"type":"object","description":"Object containing industry-specific information associated with the order.\n\n:::info\nIn the following cases, industry-specific info is required. Omitting this information may trigger additional scrutiny and risk mitigation actions by the Revolut risk team.\n\n | Transaction type | Required for |\n | ---------------- | ----------- |\n | `airline` | Airlines and Online Travel Agencies (OTAs). |\n | `car_rental` | Car Rental Merchants and Online Travel Agencies (OTAs). |\n | `crypto` | Crypto merchants. |\n | `marketplace` | Marketplace merchants. |\n | `event` | Event ticket sellers. |\n | `lodging` | Lodging providers. |\n:::","discriminator":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:discriminator","oneOf":[{"type":"object","description":"$15e9","properties":{"type":{"type":"string","enum":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:0:properties:type:enum","description":"Type of the industry-specific data object, determining what additional data is expected.\n\nAvailable types:\n\n | Object type | Description |\n | ------------- | ----------- |\n | `airline` | Object containing information about a specific airline ticket purchase. |\n | `car_rental` | Object containing information about a car rental booking associated with the order. |\n | `crypto` | Object containing information about crypto transactions associated with the order. |\n | `marketplace` | This object is required by Mastercard and Visa for merchants operating as marketplaces under the **Merchant Category Code (MCC):** `5262`. The marketplace object ensures compliance with the card schemes' regulations by providing detailed information about the subseller involved in the transaction. |\n | `event` | Object containing information about event ticket bookings associated with the order. |\n | `lodging` | Object containing information about lodging bookings associated with the order. |","descriptionNode":"$L15ea"},"booking_id":{"type":"string","description":"A unique identifier provided by the merchant associated with the order. \n\nThis `booking_id` is used to reference and correlate booking information with the Merchant API and the merchant's internal system.","descriptionNode":"$L15eb"},"fulfillment_date":{"type":"string","format":"date-time","description":"The UTC date and time of the final journey leg.\n\n:::warning\nThe following limitations apply:\n - When creating or updating an order, `fulfillment_date` cannot be set to a date in the past.\n - When updating an order, if the current `fulfillment_date` value is already in the past, it cannot be modified. The date must remain as is to maintain data integrity for completed transactions.\n:::","descriptionNode":"$L15ec"},"tickets_purchase":{"type":"boolean","description":"Flag indicating whether the order includes actual ticket purchases. Set to `true` if the order contains ticket purchases, and `false` if it does not (e.g., it **only** contains seat reservations, or baggage upgrades). \n\n:::info\nThis field is required for activating **Revolut Flight Alerts** functionalities within the Revolut app.\n\nProvide the info on order creation or update, before capturing the order.\n:::","descriptionNode":"$L15ed"},"ticket_type":{"type":"string","enum":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:0:properties:ticket_type:enum","description":"The type of the ticket.\n\n| Parameter value | Description |\n| --------------- | ----------- |\n| `fixed` | Non-modifiable once confirmed. |\n| `flexible` | Allows modifications or cancellations under specified conditions. |","descriptionNode":"$L15ee"},"crs_code":{"type":"string","maxLength":4,"description":"The code of the Computer Reservation System (CRS) used to make the booking and purchase the ticket.","descriptionNode":"$L15ef"},"ticket_change_indicator":{"type":"string","enum":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:0:properties:ticket_change_indicator:enum","description":"Parameter indicating whether this order is related to a new ticket reservation or a modification of an existing one.","descriptionNode":"$L15f0"},"refundability":{"type":"string","enum":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:0:properties:refundability:enum","description":"Parameter indicating whether the booking is refundable, partially refundable, or not refundable.","descriptionNode":"$L15f1"},"passengers":{"type":"array","description":"Array containing information of passengers associated with the booking.","items":{"type":"object","properties":{"first_name":{"type":"string","description":"Passenger's first name.","descriptionNode":"$L15f2"},"last_name":{"type":"string","description":"Passenger's last name.","descriptionNode":"$L15f3"}},"required":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:0:properties:passengers:items:required"},"descriptionNode":"$L15f4"},"journey_legs":{"type":"array","description":"Array containing information of journey legs associated with the booking.\n\n:::info\nThis field is required for activating **Revolut Flight Alerts** functionalities within the Revolut app. \n\nThis information is used to compile a tracking widget that provides real-time updates on flight status and sends notifications, such as a check-in reminders, boarding alerts, and notifications for cancellations or delays. \n\nTo enable the widget the following fields are required on order creation or update, before capturing the order:\n\n ```\n sequence,\n departure_airport_code,\n arrival_airport_code,\n flight_number,\n travel_date,\n airline_name,\n airline_code,\n ```\n:::","items":{"type":"object","properties":{"sequence":{"type":"integer","description":"Sequence of the journey legs. Increment by 1 for each flight included in the ticket.\n\nFor example: For a `FRA > LHR > DUB > LHR > FRA` journey the sequence will be assigned as:\n - `FRA > LHR`: 1\n - `LHR > DUB`: 2\n - `DUB > LHR`: 3\n - `LHR > FRA`: 4","descriptionNode":"$L15f5"},"departure_airport_code":{"type":"string","description":"The [IATA](https://www.iata.org/en/services/codes) 3-letter airport code for the departure airport.","descriptionNode":"$L15f6"},"arrival_airport_code":{"type":"string","description":"The [IATA](https://www.iata.org/en/services/codes) 3-letter airport code for the arrival airport.","descriptionNode":"$L15f7"},"flight_number":{"type":"string","description":"The flight identifier, without airline code.","descriptionNode":"$L15f8"},"fare_base_code":{"type":"string","description":"The fare base code for the given journey leg.","descriptionNode":"$L15f9"},"travel_date":{"type":"string","format":"date-time","description":"The UTC date and time of the flight departure for the given journey leg.","descriptionNode":"$L15fa"},"airline_name":{"type":"string","description":"The name of the airline associated with the journey leg.","descriptionNode":"$L15fb"},"airline_code":{"type":"string","description":"The IATA 2-letter accounting code identifying the airline associated with the journey leg.","descriptionNode":"$L15fc"},"pnr":{"type":"string","format":"alphanumeric","pattern":"^[a-zA-Z0-9]*$","maxLength":20,"description":"The Passenger Name Record (PNR) for the journey leg issued by the airline. \n\nPNR is a unique identifier for the booking, acting as a digital certificate allowing passengers to retrieve or manage their booking details.\n\n:::warning\nThis is a required field for OTAs.\n:::","descriptionNode":"$L15fd"}},"required":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:0:properties:journey_legs:items:required"},"descriptionNode":"$L15fe"},"booking_url":{"type":"string","format":"uri","pattern":"^https?:\\/{2}.+/gi","maxLength":2000,"description":"URL to the online portal for managing the airline booking, which includes check-in functionality. This URL may be a personalised, pre-populated check-in link specific to the user or a generic link, and it is essential for enabling direct access to booking details within the Revolut app.\n\n:::info\nThis field is required for activating **Revolut Flight Alerts** functionalities within the Revolut app. \n\nProvide the info on order creation or update, before capturing the order.\n:::\n\n:::warning\nRestrictions:\n- Must be a valid URI as defined by [RFC 3986](https://datatracker.ietf.org/doc/html/rfc3986)\n- URI scheme is required and must be either `http` or `https`\n- URI host is required and cannot be `localhost` or an IP address\n- Max length: `2000`\n- Reserved or invalid characters must be percent-encoded (for example, use `%20` instead of a space)\n:::","descriptionNode":"$L15ff"}},"required":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:0:required","descriptionNode":"$L1600"},{"type":"object","description":"Object containing additional information about a car rental booking associated with the order.\n\n:::info\nThese are the specific data field requirements for merchants offering car rental. Note that these requirements can be extended on a case by case basis as decided by Revolut.\n\n```\nbooking_id\ndrop_off_date\nrefundability\n```\n:::","properties":{"type":{"type":"string","enum":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:0:properties:type:enum","description":"Type of the industry-specific data object, determining what additional data is expected.\n\nAvailable types:\n\n | Object type | Description |\n | ------------- | ----------- |\n | `airline` | Object containing information about a specific airline ticket purchase. |\n | `car_rental` | Object containing information about a car rental booking associated with the order. |\n | `crypto` | Object containing information about crypto transactions associated with the order. |\n | `marketplace` | This object is required by Mastercard and Visa for merchants operating as marketplaces under the **Merchant Category Code (MCC):** `5262`. The marketplace object ensures compliance with the card schemes' regulations by providing detailed information about the subseller involved in the transaction. |\n | `event` | Object containing information about event ticket bookings associated with the order. |\n | `lodging` | Object containing information about lodging bookings associated with the order. |","descriptionNode":"$L1601"},"booking_id":{"type":"string","description":"A unique identifier provided by the merchant associated with the order. \n\nThis `booking_id` is used to reference and correlate booking information with the Merchant API and the merchant's internal system.","descriptionNode":"$L1602"},"pick_up_date":{"type":"string","format":"date-time","description":"The UTC date and time of the pick-up.","descriptionNode":"$L1603"},"pick_up_location":{"type":"object","description":"Object containing address details.","properties":{"street_line_1":"$1f:props:children:0:props:children:props:responses:201:content:application/json:schema:properties:payments:items:properties:billing_address:properties:street_line_1","street_line_2":"$1f:props:children:0:props:children:props:responses:201:content:application/json:schema:properties:payments:items:properties:billing_address:properties:street_line_2","region":"$1f:props:children:0:props:children:props:responses:201:content:application/json:schema:properties:payments:items:properties:billing_address:properties:region","city":"$1f:props:children:0:props:children:props:responses:201:content:application/json:schema:properties:payments:items:properties:billing_address:properties:city","country_code":"$1f:props:children:0:props:children:props:responses:201:content:application/json:schema:properties:payments:items:properties:billing_address:properties:country_code","postcode":"$1f:props:children:0:props:children:props:responses:201:content:application/json:schema:properties:payments:items:properties:billing_address:properties:postcode"},"required":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:billing_address:required","descriptionNode":"$L1604"},"drop_off_date":{"type":"string","format":"date-time","description":"The UTC date and time of the drop-off.","descriptionNode":"$L1605"},"drop_off_location":{"type":"object","description":"Object containing address details.","properties":{"street_line_1":"$1f:props:children:0:props:children:props:responses:201:content:application/json:schema:properties:payments:items:properties:billing_address:properties:street_line_1","street_line_2":"$1f:props:children:0:props:children:props:responses:201:content:application/json:schema:properties:payments:items:properties:billing_address:properties:street_line_2","region":"$1f:props:children:0:props:children:props:responses:201:content:application/json:schema:properties:payments:items:properties:billing_address:properties:region","city":"$1f:props:children:0:props:children:props:responses:201:content:application/json:schema:properties:payments:items:properties:billing_address:properties:city","country_code":"$1f:props:children:0:props:children:props:responses:201:content:application/json:schema:properties:payments:items:properties:billing_address:properties:country_code","postcode":"$1f:props:children:0:props:children:props:responses:201:content:application/json:schema:properties:payments:items:properties:billing_address:properties:postcode"},"required":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:billing_address:required","descriptionNode":"$L1606"},"refundability":{"type":"string","enum":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:0:properties:refundability:enum","description":"Parameter indicating whether the booking is refundable, partially refundable, or not refundable.","descriptionNode":"$L1607"},"distance_limit":{"type":"object","description":"Object containing distance limit information.","properties":{"limit":{"type":"integer","description":"The maximum distance allowed.","descriptionNode":"$L1608"},"unit":{"type":"string","description":"The unit of distance.","enum":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:1:properties:distance_limit:properties:unit:enum","descriptionNode":"$L1609"},"additional_distance_cost":{"type":"object","description":"Cost for exceeding the distance limit.","properties":{"amount":{"type":"integer","description":"The amount of the cost in minor currency units. For example, enter `7034` for €70.34.","descriptionNode":"$L160a"},"currency":{"type":"string","format":"ISO 4217","minLength":3,"maxLength":3,"description":"[ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) currency code in upper case.\n\n:::info\nFor more information about the supported currencies, see: [Help Center](https://help.revolut.com/business/help/merchant-accounts/payments/in-which-currencies-can-i-accept-payments/).\n:::","descriptionNode":"$L160b"}},"descriptionNode":"$L160c"}},"descriptionNode":"$L160d"}},"required":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:1:required","descriptionNode":"$L160e"},{"type":"object","description":"Object containing information about crypto transactions associated with the order.\n\n:::info\nProcessing crypto on-ramp transactions with Revolut has additional compliance requirements. Please reach out to your account executive for additional details.\n\n**Required data fields for crypto services:**\n\n```\ntransactions[].id\ntransactions[].status\ntransactions[].recipient_wallet_id\nseller.id\nseller.name\nseller.website\nseller.phone\nseller.address\nseller.mcc\ncustomer.full_name\ncustomer.date_of_birth\n```\n\nNote that these requirements can be extended on a case by case basis as decided by Revolut.\n:::","properties":{"type":{"type":"string","enum":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:0:properties:type:enum","description":"Type of the industry-specific data object, determining what additional data is expected.\n\nAvailable types:\n\n | Object type | Description |\n | ------------- | ----------- |\n | `airline` | Object containing information about a specific airline ticket purchase. |\n | `car_rental` | Object containing information about a car rental booking associated with the order. |\n | `crypto` | Object containing information about crypto transactions associated with the order. |\n | `marketplace` | This object is required by Mastercard and Visa for merchants operating as marketplaces under the **Merchant Category Code (MCC):** `5262`. The marketplace object ensures compliance with the card schemes' regulations by providing detailed information about the subseller involved in the transaction. |\n | `event` | Object containing information about event ticket bookings associated with the order. |\n | `lodging` | Object containing information about lodging bookings associated with the order. |","descriptionNode":"$L160f"},"transactions":{"type":"array","description":"Array of crypto transaction data associated with the order.","items":{"type":"object","properties":{"id":{"type":"string","maxLength":255,"description":"The public transaction hash of the crypto transaction.","descriptionNode":"$L1610"},"status":{"type":"string","enum":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:2:properties:transactions:items:properties:status:enum","description":"The status of the crypto transaction.","descriptionNode":"$L1611"},"recipient_wallet_id":{"type":"string","maxLength":255,"description":"The wallet ID of the recipient.\n\n:::note\nAt least one of the parameters: `recipient_user_id` or `recipient_wallet_id` is required.\n::: ","descriptionNode":"$L1612"},"recipient_user_id":{"type":"string","maxLength":255,"description":"The user ID of the recipient.\n\n:::note\nAt least one of the parameters: `recipient_user_id` or `recipient_wallet_id` is required.\n::: ","descriptionNode":"$L1613"}},"required":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:2:properties:transactions:items:required"},"minItems":1,"descriptionNode":"$L1614"},"seller":{"type":"object","description":"Information about the crypto conversion affiliate.\n\nThis should be provided when a customer completes a payment on a subseller's website rather than directly on the merchant's website, providing insight into the type of business conducted by the subseller.\n\n:::note\nThis needs to be provided only by crypto on-ramp providers for payments they are processing for conversion affiliates.\n\nFor their own payments, `seller` can be omitted.\n:::","properties":{"mcc":{"type":"string","description":"A string representing the four-digit [Merchant Category Code (MCC)](https://en.wikipedia.org/wiki/Merchant_category_code) of the conversion affiliate.","maxLength":4,"minLength":4,"pattern":"^\\d{4}$","descriptionNode":"$L1615"},"id":{"type":"string","description":"The ID of the seller in the merchant's internal system.","minLength":1,"maxLength":15,"descriptionNode":"$L1616"},"name":{"type":"string","description":"The business or legal name of the seller.","minLength":1,"maxLength":50,"descriptionNode":"$L1617"},"website":{"type":"string","format":"uri","pattern":"^https?:\\/{2}.+/gi","maxLength":255,"description":"The URL of the website of the seller.\n\n:::warning\nRestrictions:\n- Must be a valid URI as defined by [RFC 3986](https://datatracker.ietf.org/doc/html/rfc3986)\n- URI scheme is required and must be either `http` or `https`\n- URI host is required and cannot be `localhost` or an IP address\n- Max length: `255`\n- Reserved or invalid characters must be percent-encoded (for example, use `%20` instead of a space)\n:::","descriptionNode":"$L1618"},"phone":{"type":"string","description":"The phone number of the seller.","descriptionNode":"$L1619"},"address":{"type":"object","description":"Details of a physical address.","properties":{"street_line_1":{"type":"string","description":"Primary address line.","maxLength":100,"descriptionNode":"$L161a"},"street_line_2":{"type":"string","description":"Secondary address line, such as floor and apartment number.","maxLength":100,"descriptionNode":"$L161b"},"region":{"type":"string","description":"State or province of the address.","maxLength":100,"descriptionNode":"$L161c"},"city":{"type":"string","description":"City of the address.","maxLength":100,"descriptionNode":"$L161d"},"country_code":{"type":"string","pattern":"^[A-Z]{2}$","description":"ISO 2-letter country code.","minLength":2,"maxLength":2,"descriptionNode":"$L161e"},"country_subdivision_code":{"type":"string","pattern":"^[A-Z]{2}-[A-Z0-9]{1,3}$","description":"The subdivision code represents the state, province, or region within the country, following the [ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2) standard. This code uniquely identifies subdivisions within a country. \n\nFor example, for London in the United Kingdom, use `GB-LND`.\n\n:::warning\nThe parameter is required for countries listed on the [ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2) page.\n:::","minLength":5,"maxLength":6,"descriptionNode":"$L161f"},"postcode":{"type":"string","description":"Postal code of the address.","maxLength":100,"descriptionNode":"$L1620"}},"required":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:2:properties:seller:properties:address:required","descriptionNode":"$L1621"}},"required":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:2:properties:seller:required","descriptionNode":"$L1622"}},"required":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:2:required","descriptionNode":"$L1623"},{"type":"object","description":"This object is required by Mastercard and Visa for merchants operating as marketplaces under the Merchant Category Code (MCC) `5262`. The marketplace object ensures compliance with the card schemes' regulations by providing detailed information about the seller involved in the transaction.\n\n:::info\nThese are the specific data field requirements for merchants who must provide marketplace data.\n\n```\nseller.id\nseller.name\nseller.website\nseller.phone\nseller.address\n```\n:::","properties":{"type":{"type":"string","enum":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:0:properties:type:enum","description":"Type of the industry-specific data object, determining what additional data is expected.\n\nAvailable types:\n\n | Object type | Description |\n | ------------- | ----------- |\n | `airline` | Object containing information about a specific airline ticket purchase. |\n | `car_rental` | Object containing information about a car rental booking associated with the order. |\n | `crypto` | Object containing information about crypto transactions associated with the order. |\n | `marketplace` | This object is required by Mastercard and Visa for merchants operating as marketplaces under the **Merchant Category Code (MCC):** `5262`. The marketplace object ensures compliance with the card schemes' regulations by providing detailed information about the subseller involved in the transaction. |\n | `event` | Object containing information about event ticket bookings associated with the order. |\n | `lodging` | Object containing information about lodging bookings associated with the order. |","descriptionNode":"$L1624"},"seller":{"type":"object","description":"Information about the subseller on the marketplace platform.","properties":{"id":{"type":"string","description":"The ID of the seller in the merchant's internal system.","minLength":1,"maxLength":15,"descriptionNode":"$L1625"},"name":{"type":"string","description":"The business or legal name of the seller.","minLength":1,"maxLength":50,"descriptionNode":"$L1626"},"website":{"type":"string","format":"uri","pattern":"^https?:\\/{2}.+/gi","maxLength":255,"description":"The URL of the website of the seller.\n\n:::warning\nRestrictions:\n- Must be a valid URI as defined by [RFC 3986](https://datatracker.ietf.org/doc/html/rfc3986)\n- URI scheme is required and must be either `http` or `https`\n- URI host is required and cannot be `localhost` or an IP address\n- Max length: `255`\n- Reserved or invalid characters must be percent-encoded (for example, use `%20` instead of a space)\n:::","descriptionNode":"$L1627"},"phone":{"type":"string","description":"The phone number of the seller.","descriptionNode":"$L1628"},"address":{"type":"object","description":"Details of a physical address.","properties":{"street_line_1":"$1f:props:children:0:props:children:props:responses:201:content:application/json:schema:properties:industry_data:oneOf:2:properties:seller:properties:address:properties:street_line_1","street_line_2":"$1f:props:children:0:props:children:props:responses:201:content:application/json:schema:properties:industry_data:oneOf:2:properties:seller:properties:address:properties:street_line_2","region":"$1f:props:children:0:props:children:props:responses:201:content:application/json:schema:properties:industry_data:oneOf:2:properties:seller:properties:address:properties:region","city":"$1f:props:children:0:props:children:props:responses:201:content:application/json:schema:properties:industry_data:oneOf:2:properties:seller:properties:address:properties:city","country_code":"$1f:props:children:0:props:children:props:responses:201:content:application/json:schema:properties:industry_data:oneOf:2:properties:seller:properties:address:properties:country_code","country_subdivision_code":"$1f:props:children:0:props:children:props:responses:201:content:application/json:schema:properties:industry_data:oneOf:2:properties:seller:properties:address:properties:country_subdivision_code","postcode":"$1f:props:children:0:props:children:props:responses:201:content:application/json:schema:properties:industry_data:oneOf:2:properties:seller:properties:address:properties:postcode"},"required":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:2:properties:seller:properties:address:required","descriptionNode":"$L1629"}},"required":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:3:properties:seller:required","descriptionNode":"$L162a"}},"required":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:3:required","descriptionNode":"$L162b"},{"type":"object","description":"Object containing booking information for a list of event tickets associated with the order.\n\n:::info\nThese are the specific data field requirements for merchants who must provide event data. Note that these requirements can be extended on a case by case basis as decided by Revolut.\n\n```\nbooking_id\nevents[].start_date\nevents[].end_date\nevents[].supplier\nevents[].tickets[].id\n```\n:::","properties":{"type":{"type":"string","enum":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:0:properties:type:enum","description":"Type of the industry-specific data object, determining what additional data is expected.\n\nAvailable types:\n\n | Object type | Description |\n | ------------- | ----------- |\n | `airline` | Object containing information about a specific airline ticket purchase. |\n | `car_rental` | Object containing information about a car rental booking associated with the order. |\n | `crypto` | Object containing information about crypto transactions associated with the order. |\n | `marketplace` | This object is required by Mastercard and Visa for merchants operating as marketplaces under the **Merchant Category Code (MCC):** `5262`. The marketplace object ensures compliance with the card schemes' regulations by providing detailed information about the subseller involved in the transaction. |\n | `event` | Object containing information about event ticket bookings associated with the order. |\n | `lodging` | Object containing information about lodging bookings associated with the order. |","descriptionNode":"$L162c"},"booking_id":{"type":"string","description":"A unique identifier provided by the merchant associated with the order. \n\nThis `booking_id` is used to reference and correlate booking information with the Merchant API and the merchant's internal system.","descriptionNode":"$L162d"},"events":{"type":"array","description":"A list of events associated with the booking.","items":{"type":"object","description":"Object containing booking information about a specific event. ","properties":{"start_date":{"type":"string","format":"date-time","description":"[ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time when the event starts.","descriptionNode":"$L162e"},"end_date":{"type":"string","format":"date-time","description":"[ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time when the event ends.","descriptionNode":"$L162f"},"supplier":{"type":"string","description":"Legal name of the ticket vendor/event organiser.","descriptionNode":"$L1630"},"supplier_payment_date":{"type":"string","format":"date-time","description":"[ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time when the funds are released to merchants.","descriptionNode":"$L1631"},"name":{"type":"string","description":"The name of the event.","descriptionNode":"$L1632"},"location":{"type":"object","description":"The address of the event location.","properties":{"street_line_1":{"type":"string","description":"Primary address line.","maxLength":100,"descriptionNode":"$L1633"},"street_line_2":{"type":"string","description":"Secondary address line, such as floor and apartment number.","maxLength":100,"descriptionNode":"$L1634"},"region":{"type":"string","description":"State or province of the address.","maxLength":100,"descriptionNode":"$L1635"},"city":{"type":"string","description":"City of the address.","maxLength":100,"descriptionNode":"$L1636"},"country_code":{"type":"string","pattern":"^[A-Z]{2}$","description":"ISO 2-letter country code.","minLength":2,"maxLength":2,"descriptionNode":"$L1637"},"postcode":{"type":"string","description":"Postal code of the address.","maxLength":100,"descriptionNode":"$L1638"}},"required":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:4:properties:events:items:properties:location:required","descriptionNode":"$L1639"},"category":{"type":"string","enum":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:4:properties:events:items:properties:category:enum","description":"The type of the event.","descriptionNode":"$L163a"},"market":{"type":"string","enum":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:4:properties:events:items:properties:market:enum","description":"Indicates the relationship between the ticket vendor and the event organiser. \n\n| Parameter value | Description |\n| --------------- | ----------- |\n| `primary` | The merchant is the organiser and primary distributor of the tickets. |\n| `secondary` | The merchant is a reseller, only distributing the tickets. |","descriptionNode":"$L163b"},"tickets":{"type":"array","items":{"type":"object","description":"Object containing information about a ticket associated with the booking.","properties":{"id":{"type":"string","description":"A unique identifier provided by the merchant associated with the ticket.","descriptionNode":"$L163c"},"transferable":{"type":"boolean","description":"Indicates whether the ticket is transferable to another buyer.","descriptionNode":"$L163d"},"refundability":{"type":"string","enum":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:0:properties:refundability:enum","description":"Parameter indicating whether the booking is refundable, partially refundable, or not refundable.","descriptionNode":"$L163e"}},"required":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:4:properties:events:items:properties:tickets:items:required","descriptionNode":"$L163f"},"description":"A list of tickets associated with the booking.","descriptionNode":"$L1640"}},"descriptionNode":"$L1641"},"descriptionNode":"$L1642"}},"required":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:4:required","descriptionNode":"$L1643"},{"type":"object","description":"Object containing details of a lodging booking.\n\n:::info\nThese are the specific data field requirements for merchants who must provide lodging data. Note that these requirements can be extended on a case by case basis as decided by Revolut.\n\n```\nbooking_id\ncheck_in_date\ncheck_out_date\nsupplier_payment_date\n```\n:::","properties":{"type":{"type":"string","enum":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:0:properties:type:enum","description":"Type of the industry-specific data object, determining what additional data is expected.\n\nAvailable types:\n\n | Object type | Description |\n | ------------- | ----------- |\n | `airline` | Object containing information about a specific airline ticket purchase. |\n | `car_rental` | Object containing information about a car rental booking associated with the order. |\n | `crypto` | Object containing information about crypto transactions associated with the order. |\n | `marketplace` | This object is required by Mastercard and Visa for merchants operating as marketplaces under the **Merchant Category Code (MCC):** `5262`. The marketplace object ensures compliance with the card schemes' regulations by providing detailed information about the subseller involved in the transaction. |\n | `event` | Object containing information about event ticket bookings associated with the order. |\n | `lodging` | Object containing information about lodging bookings associated with the order. |","descriptionNode":"$L1644"},"booking_id":{"type":"string","description":"A unique identifier provided by the merchant associated with the order. \n\nThis `booking_id` is used to reference and correlate booking information with the Merchant API and the merchant's internal system.","descriptionNode":"$L1645"},"check_in_date":{"type":"string","format":"date-time","description":"[ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time of the check-in.","descriptionNode":"$L1646"},"check_out_date":{"type":"string","format":"date-time","description":"[ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time of the check-out.","descriptionNode":"$L1647"},"supplier_payment_date":{"type":"string","format":"date-time","description":"[ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time when the funds are released to merchants.","descriptionNode":"$L1648"},"category":{"type":"string","enum":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:5:properties:category:enum","description":"The type of the accommodation associated with the booking.","descriptionNode":"$L1649"},"booking_type":{"type":"string","enum":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:5:properties:booking_type:enum","description":"Indicates whether the booking terms are fixed or flexible.\n\n| Parameter value | Description |\n| --------------- | ----------- |\n| `fixed` | Non-modifiable once confirmed. |\n| `flexible` | Allows modifications or cancellations under specified conditions. |","descriptionNode":"$L164a"},"refundability":{"type":"string","enum":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:0:properties:refundability:enum","description":"Parameter indicating whether the booking is refundable, partially refundable, or not refundable.","descriptionNode":"$L164b"},"location":{"type":"object","description":"Address of the accommodation.","properties":{"street_line_1":{"type":"string","description":"Primary address line.","maxLength":100,"descriptionNode":"$L164c"},"street_line_2":{"type":"string","description":"Secondary address line, such as floor and apartment number.","maxLength":100,"descriptionNode":"$L164d"},"region":{"type":"string","description":"State or province of the address.","maxLength":100,"descriptionNode":"$L164e"},"city":{"type":"string","description":"City of the address.","maxLength":100,"descriptionNode":"$L164f"},"country_code":{"type":"string","pattern":"^[A-Z]{2}$","description":"ISO 2-letter country code.","minLength":2,"maxLength":2,"descriptionNode":"$L1650"},"postcode":{"type":"string","description":"Postal code of the address.","maxLength":100,"descriptionNode":"$L1651"}},"required":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:5:properties:location:required","descriptionNode":"$L1652"},"guests":{"type":"array","items":{"type":"object","properties":{"first_name":{"type":"string","description":"Guest's first name.","descriptionNode":"$L1653"},"last_name":{"type":"string","description":"Guest's last name.","descriptionNode":"$L1654"}},"required":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:5:properties:guests:items:required"},"description":"List of guests associated with the booking.","descriptionNode":"$L1655"}},"required":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:5:required","descriptionNode":"$L1656"}],"descriptionNode":"$L1657"},"merchant_order_data":{"type":"object","description":"Object for providing additional information stored in the merchant's order management system. ","properties":{"url":{"type":"string","format":"uri","pattern":"^https?:\\/{2}.+/gi","maxLength":2000,"description":"The URL of the order stored in the merchant's order management system.\n\nThis URL will be included in the order confirmation email for payments made via Revolut Pay. If specified, this URL will override the default link to the merchant's **Business website** configured in the Revolut Business account.\n\n:::warning\nRestrictions:\n- Must be a valid URI as defined by [RFC 3986](https://datatracker.ietf.org/doc/html/rfc3986)\n- URI scheme is required and must be either `http` or `https`\n- URI host is required and cannot be `localhost` or an IP address\n- Max length: `2000`\n- Reserved or invalid characters must be percent-encoded (for example, use `%20` instead of a space)\n:::","descriptionNode":"$L1658"},"reference":{"type":"string","description":"Merchant order ID for external reference.\n\nUse this field to set the ID that your own system can use to easily track orders.","descriptionNode":"$L1659"}},"descriptionNode":"$L165a"},"upcoming_payment_data":{"type":"object","description":"Object containing information about upcoming payments associated with the order.","properties":{"date":{"type":"string","format":"date-time","description":"The date and time in [ISO 8601 format](https://en.wikipedia.org/wiki/ISO_8601) when the upcoming payment is scheduled to be executed.","descriptionNode":"$L165b"},"payment_method_id":{"type":"string","description":"The unique ID of the customer's payment method used to complete the scheduled payment.\n\n:::info\nFor more information about operations related to customer's payment methods, see:\n - [Retrieve payment method list of a customer](https://developer.revolut.com/docs/api/merchant#retrieve-payment-method-list)\n - [Retrieve a customer's payment method](https://developer.revolut.com/docs/api/merchant#retrieve-payment-method)\n - [Update a customer's payment method](https://developer.revolut.com/docs/api/merchant#update-payment-method)\n - [Delete a customer's payment method](https://developer.revolut.com/docs/api/merchant#delete-payment-method)\n:::","descriptionNode":"$L165c"}},"required":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:upcoming_payment_data:required","descriptionNode":"$L165d"},"checkout_url":{"type":"string","description":"Link to a checkout page hosted by Revolut.","format":"uri","descriptionNode":"$L165e"},"redirect_url":{"type":"string","format":"uri","pattern":"^https?:\\/{2}.+/gi","maxLength":2000,"description":"The URL your customer will be redirected to after a successful payment on the hosted checkout page (`checkout_url` parameter's value of the order).\n\n:::warning\nRestrictions:\n- Must be a valid URI as defined by [RFC 3986](https://datatracker.ietf.org/doc/html/rfc3986)\n- URI scheme is required and must be either `http` or `https`\n- URI host is required and cannot be `localhost` or an IP address\n- Max length: `2000`\n- Reserved or invalid characters must be percent-encoded (for example, use `%20` instead of a space)\n:::\n\n:::info\nFor more information on how to use the `redirect_url`, see: [Custom redirection via the API](https://developer.revolut.com/docs/guides/merchant/accept-payments/online-payments/hosted-checkout-page/api#custom-post-payment-redirection-optional)\n:::","descriptionNode":"$L165f"},"shipping":{"type":"object","description":"Details about the shipping related to the order, including address, contact information, and individual shipments.\n\n:::info\nRequired for merchants shipping physical goods. Omitting this information may trigger additional scrutiny and risk mitigation actions by Revolut.\n:::","properties":{"address":{"type":"object","description":"Details of a physical address.","properties":{"street_line_1":{"type":"string","description":"Primary address line.","maxLength":100,"descriptionNode":"$L1660"},"street_line_2":{"type":"string","description":"Secondary address line, such as floor and apartment number.","maxLength":100,"descriptionNode":"$L1661"},"region":{"type":"string","description":"State or province of the address.","maxLength":100,"descriptionNode":"$L1662"},"city":{"type":"string","description":"City of the address.","maxLength":100,"descriptionNode":"$L1663"},"country_code":{"type":"string","pattern":"^[A-Z]{2}$","description":"ISO 2-letter country code.","minLength":2,"maxLength":2,"descriptionNode":"$L1664"},"postcode":{"type":"string","description":"Postal code of the address.","maxLength":100,"descriptionNode":"$L1665"}},"required":"$60:props:children:0:props:children:props:responses:200:content:application/json:schema:oneOf:1:properties:details:properties:address:required","descriptionNode":"$L1666"},"contact":{"type":"object","description":"Contact details for someone responsible for the shipment.\n\n:::warning\nAt least `email` or `phone` is required.\n:::","properties":{"name":{"type":"string","description":"Full name of the contact person.","maxLength":250,"descriptionNode":"$L1667"},"email":{"type":"string","format":"email","description":"Email address of the contact person.","descriptionNode":"$L1668"},"phone":{"type":"string","description":"Phone number of the contact person.","descriptionNode":"$L1669"}},"descriptionNode":"$L166a"},"shipments":{"type":"array","description":"List of individual shipment details.","maxItems":50,"items":{"type":"object","description":"Details of an individual shipment.","properties":{"shipping_company_name":{"type":"string","maxLength":250,"description":"Name of the company handling the shipment.","descriptionNode":"$L166b"},"tracking_number":{"type":"string","maxLength":500,"description":"Unique tracking number for the shipment.","descriptionNode":"$L166c"},"estimated_delivery_date":{"type":"string","format":"date-time","description":"Estimated delivery date and time for the shipment. \nThe time should also include the customer's timezone.","descriptionNode":"$L166d"},"tracking_url":{"type":"string","format":"uri","pattern":"^https?:\\/{2}.+/gi","maxLength":2000,"description":"An HTTP/HTTPS URL where the shipment can be tracked.\n\n:::warning\nRestrictions:\n- Must be a valid URI as defined by [RFC 3986](https://datatracker.ietf.org/doc/html/rfc3986)\n- URI scheme is required and must be either `http` or `https`\n- URI host is required and cannot be `localhost` or an IP address\n- Max length: `2000`\n- Reserved or invalid characters must be percent-encoded (for example, use `%20` instead of a space)\n:::","descriptionNode":"$L166e"}},"required":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:shipping:properties:shipments:items:required","descriptionNode":"$L166f"},"descriptionNode":"$L1670"}},"descriptionNode":"$L1671"},"enforce_challenge":{"type":"string","description":"The enforce challenge mode. `automatic` is used by default.\n\n| Parameter value | Description |\n| --------------- | ----------- |\n| `automatic` | The payments created for an order will have challenge requirement calculated by our fraud mechanisms. Not all payments will trigger a 3DS challenge. |\n| `forced` | The payments created for an order will always require a 3DS challenge. Currently only supported for card payments. |","default":"automatic","enum":"$19:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:orders:items:properties:enforce_challenge:enum","descriptionNode":"$L1672"},"line_items":{"type":"array","maxItems":250,"description":"An array of line items included in the order. Each line item represents an individual product or service, along with its quantity, price, taxes, and discounts.\n\n:::info\nRequired for merchants collecting payment for one or multiple products/services in one transaction. Omitting this information may trigger additional scrutiny and risk mitigation actions by Revolut.\n:::","items":{"type":"object","properties":{"name":"$1f:props:children:0:props:children:props:responses:201:content:application/json:schema:properties:incremental_authorisations:items:properties:line_items:items:properties:name","type":"$1f:props:children:0:props:children:props:responses:201:content:application/json:schema:properties:incremental_authorisations:items:properties:line_items:items:properties:type","quantity":"$1f:props:children:0:props:children:props:responses:201:content:application/json:schema:properties:incremental_authorisations:items:properties:line_items:items:properties:quantity","unit_price_amount":"$1f:props:children:0:props:children:props:responses:201:content:application/json:schema:properties:incremental_authorisations:items:properties:line_items:items:properties:unit_price_amount","total_amount":"$1f:props:children:0:props:children:props:responses:201:content:application/json:schema:properties:incremental_authorisations:items:properties:line_items:items:properties:total_amount","external_id":"$1f:props:children:0:props:children:props:responses:201:content:application/json:schema:properties:incremental_authorisations:items:properties:line_items:items:properties:external_id","discounts":"$1f:props:children:0:props:children:props:responses:201:content:application/json:schema:properties:incremental_authorisations:items:properties:line_items:items:properties:discounts","taxes":"$1f:props:children:0:props:children:props:responses:201:content:application/json:schema:properties:incremental_authorisations:items:properties:line_items:items:properties:taxes","image_urls":"$1f:props:children:0:props:children:props:responses:201:content:application/json:schema:properties:incremental_authorisations:items:properties:line_items:items:properties:image_urls","description":"$1f:props:children:0:props:children:props:responses:201:content:application/json:schema:properties:incremental_authorisations:items:properties:line_items:items:properties:description","url":"$1f:props:children:0:props:children:props:responses:201:content:application/json:schema:properties:incremental_authorisations:items:properties:line_items:items:properties:url"},"required":"$19:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:orders:items:properties:line_items:items:required"},"descriptionNode":"$L1673"},"statement_descriptor_suffix":{"type":"string","description":"$1674","minLength":1,"maxLength":19,"pattern":"^[^*\\n\\r\\\\]+$","descriptionNode":"$L1675"},"related_order_id":{"type":"string","format":"uuid","description":"The unique ID of the original order that was refunded and this refund is associated with. You can use this ID to get more information about the related order using the [Retrieve an order](https://developer.revolut.com/docs/api/merchant#retrieve-order) operation.\n\n:::note\nThis field is only returned for orders with `type: refund`.\n:::","descriptionNode":"$L1676"},"subscription_data":{"title":"Subscription data","type":"object","required":"$19:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:orders:items:properties:subscription_data:required","description":"Subscription details linked to the order. Use this object to match an order with its underlying subscription and understand the billing context in which the order was created.\n\nOnly present on orders created by a subscription.","properties":{"subscription_id":{"type":"string","format":"uuid","description":"Unique identifier for the subscription.","descriptionNode":"$L1677"},"active_cycle_id":{"type":"string","format":"uuid","description":"The unique identifier of the active (pre-paid) subscription cycle that this order collects payment for.\n\nThis is the current billing cycle whose recurring charges are being collected in advance by this order. For example, if a subscription cycle covers 1-31 July and the order is generated on 1 July, this field identifies that July cycle.","descriptionNode":"$L1678"},"settled_cycle_id":{"type":"string","format":"uuid","description":"The unique identifier of the settled (post-paid) subscription cycle whose usage-based charges this order collects.\n\nThis is the previous billing cycle whose usage is being settled by this order. For example, if a subscription cycle covers usage from 1-30 June and the order is generated on 10 July, this field identifies that June cycle.","descriptionNode":"$L1679"},"billing_reason":{"type":"string","enum":"$19:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:orders:items:properties:subscription_data:properties:billing_reason:enum","description":"The reason this subscription order was created.\n\n| Value | Description |\n| ----- | ----------- |\n| `cycle_billing` | The order was automatically generated to collect payment for an ongoing subscription cycle. `active_cycle_id` is present; `settled_cycle_id` is present if the previous cycle included usage-based products. |\n| `final_settlement` | The order was automatically generated after the subscription ended to collect outstanding usage-based charges. `active_cycle_id` is absent; `settled_cycle_id` is present. |\n| `setup_intent` | The order was manually created by the merchant or customer to update the payment method on file. `active_cycle_id` is absent; `settled_cycle_id` is absent. |","descriptionNode":"$L167a"}},"descriptionNode":"$L167b"}},"descriptionNode":"$L167c"},"examples":{"refund_with_minimal_params":{"summary":"Refund order response with minimal required parameters","value":{"id":"6852e9a6-5cf0-ac65-8182-6a9c251011ce","type":"refund","state":"processing","created_at":"2025-06-18T16:30:30.792962Z","updated_at":"2025-06-18T16:30:30.954966Z","amount":100,"currency":"GBP","outstanding_amount":100,"capture_mode":"automatic","authorisation_type":"final","payments":[{"id":"6852e9a6-ca77-a25d-b0be-83191db96e68","state":"refund_validated","created_at":"2025-06-18T16:30:30.821411Z","updated_at":"2025-06-18T16:30:31.391153Z","amount":100,"currency":"GBP","settled_amount":-100,"settled_currency":"GBP","billing_address":{"country_code":"GB","postcode":"E14 4HD"},"risk_level":"low","fees":[],"payer":{"email":"example.payer@example.com","phone":"+447911123456"},"payment_method":{"type":"card","fingerprint":"1JAllfQY4POhBV8DaddAQ4LC5RbMP8LMLvUdJW4s5JY=","network_transaction_id":"1234567890123456","card_brand":"visa","funding":"credit","card_country_code":"GB","card_bin":"123456","card_last_four":"1234","card_expiry":"12/33","cardholder_name":"Example Holder"}}],"enforce_challenge":"automatic","related_order_id":"6852e963-d6a9-a5a4-9609-50b3addc5425"}},"refund_with_additional_params":{"summary":"Refund order response with additional parameters","value":{"id":"6852dd1f-32e1-a7ca-81c5-66e0dbc85122","type":"refund","state":"processing","created_at":"2025-06-18T15:37:03.410996Z","updated_at":"2025-06-18T15:37:07.691537Z","amount":100,"currency":"GBP","outstanding_amount":0,"capture_mode":"automatic","authorisation_type":"final","description":"Example refund description","metadata":{"example_metadata_1":"Example metadata value 1","example_metadata_2":"Example metadata value 2"},"payments":[{"id":"6852dd1f-25df-a855-9481-f5405a03da67","state":"refund_validated","created_at":"2025-06-18T15:37:03.557842Z","updated_at":"2025-06-18T15:37:07.794313Z","amount":100,"currency":"GBP","settled_amount":-100,"settled_currency":"GBP","billing_address":{"street_line_1":"123 Example Street","street_line_2":"Example City 123456","city":"SentinelFraudLow","country_code":"GB","postcode":"AB1 C23"},"risk_level":"low","fees":[],"payer":{"email":"example.payer@example.com","phone":"+447911123456"},"payment_method":{"type":"revolut_pay_account","fingerprint":"1JAllfQY4POhBV8DaddAQ4LC5RbMP8LMLvUdJW4s5JY="}}],"enforce_challenge":"automatic","related_order_id":"6852dc49-b522-a7a2-89e0-09da07982e90","customer":{"id":"03e12eee-ea3c-4282-bb61-221517c47882","email":"example.customer@example.com","phone":"+441234567890","full_name":"Example Customer","date_of_birth":"1990-01-01"},"merchant_order_data":{"reference":"example_order_reference_123456"}}}}}},"descriptionNode":"$L167d"},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"code":{"type":"string","description":"An identifier that can be used to determine what went wrong.\n\nError codes are not globally unique, but uniqueness is guaranteed within endpoints.","descriptionNode":"$L167e"},"message":{"type":"string","description":"Some human readable text describing what went wrong.","descriptionNode":"$L167f"},"timestamp":{"type":"integer","description":"The [UNIX timestamp](https://www.unixtimestamp.com/) of the date and time the error happened.","descriptionNode":"$L1680"}}},"examples":{"default":{"value":{"code":"bad_request","message":"Could not parse JSON","timestamp":1750265245422}}}}},"descriptionNode":"$L1681"},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"code":{"type":"string","description":"An identifier that can be used to determine what went wrong.\n\nError codes are not globally unique, but uniqueness is guaranteed within endpoints.","descriptionNode":"$L1682"},"message":{"type":"string","description":"Some human readable text describing what went wrong.","descriptionNode":"$L1683"},"timestamp":{"type":"integer","description":"The [UNIX timestamp](https://www.unixtimestamp.com/) of the date and time the error happened.","descriptionNode":"$L1684"}}},"examples":{"default":{"value":{"code":"unauthenticated","message":"Authentication failed","timestamp":1750265245422}}}}},"descriptionNode":"$L1685"},"404":{"description":"Not Found","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"code":{"type":"string","description":"An identifier that can be used to determine what went wrong.\n\nError codes are not globally unique, but uniqueness is guaranteed within endpoints.","descriptionNode":"$L1686"},"message":{"type":"string","description":"Some human readable text describing what went wrong.","descriptionNode":"$L1687"},"timestamp":{"type":"integer","description":"The [UNIX timestamp](https://www.unixtimestamp.com/) of the date and time the error happened.","descriptionNode":"$L1688"}}},"examples":{"default":{"value":{"code":"not_found","message":"Order with id 6852e963-0009-a5a4-9609-50b3addc5425 was not found","timestamp":1750265369820}}}}},"descriptionNode":"$L1689"},"422":{"description":"Unprocessable Entity","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"code":{"type":"string","description":"An identifier that can be used to determine what went wrong.\n\nError codes are not globally unique, but uniqueness is guaranteed within endpoints.","descriptionNode":"$L168a"},"message":{"type":"string","description":"Some human readable text describing what went wrong.","descriptionNode":"$L168b"},"timestamp":{"type":"integer","description":"The [UNIX timestamp](https://www.unixtimestamp.com/) of the date and time the error happened.","descriptionNode":"$L168c"}}}}},"descriptionNode":"$L168d"}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","description":"The request body for creating a refund order.","required":["amount","currency"],"properties":{"amount":{"type":"integer","description":"The amount to be refunded, specified in the smallest currency unit (e.g., cents for USD, pence for GBP).","examples":[100],"descriptionNode":"$L168e"},"currency":{"type":"string","format":"ISO 4217","minLength":3,"maxLength":3,"description":"[ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) currency code in upper case.\n\n**Must match the `currency` of the original order to be refunded.**\n\n:::info\nFor more information about the supported currencies, see: [Help Center](https://help.revolut.com/business/help/merchant-accounts/payments/in-which-currencies-can-i-accept-payments/).\n:::","descriptionNode":"$L168f"},"merchant_order_data":{"type":"object","description":"Object for providing additional information stored in the merchant's order management system.","properties":{"reference":{"type":"string","description":"Merchant order ID for external reference.\n\nUse this field to set the ID that your own system can use to easily track orders.","descriptionNode":"$L1690"}},"descriptionNode":"$L1691"},"metadata":{"type":"object","description":"Additional information to track your orders in your system, by providing custom metadata using `\"\" : \"\"` pairs.\n\n:::warning\n**Restrictions:**\n\n- Both keys and values must be `string`s\n- Values cannot be `null`.\n- Max number of key-value pairs: `50`\n- Max length of values: `500` characters\n- Format of keys: Must start with a letter and contain only letters, digits, and underscores. Max 40 characters. Pattern: `^[a-zA-Z][a-zA-Z\\\\d_]{0,39}$`\n:::","maxProperties":50,"additionalProperties":{"type":"string","maxLength":500,"description":"Additional metadata value provided with the corresponding metadata key.","descriptionNode":"$L1692"},"examples":"$19:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:orders:items:properties:metadata:examples","descriptionNode":"$L1693"},"description":{"type":"string","description":"An optional, user-facing description for the refund. This may be displayed to the customer.","examples":["Refund for returned item."],"descriptionNode":"$L1694"}},"descriptionNode":"$L1695"},"examples":{"refund_with_minimal_params":{"summary":"Refund order with minimal required parameters","value":{"amount":100,"currency":"GBP"}},"refund_with_additional_params":{"summary":"Refund order with additional parameters","value":{"amount":100,"currency":"GBP","description":"Example refund description","merchant_order_data":{"reference":"example_order_reference_123456"},"metadata":{"example_metadata_1":"Example metadata value 1","example_metadata_2":"Example metadata value 2"}}}}}}},"variantLabels":["Refund order response with minimal required parameters","Refund order response with additional parameters"],"children":["$L1696","$L1697"]}]}],false]}] 1696:["$","div",null,{"className":"ezz1n30","children":[["$","div",null,{"data-header":"$undefined","className":"ezz1n31","children":["$","div",null,{"className":"y9a0do1","children":[["$","h2",null,{"id":"refund-order","children":[["$L1698","$undefined"],["$","$L15",null,{"id":"refund-order"}]]}],["$","$L16",null,{"url":"/docs/api/merchant/2025-10-16/operations/refund-order.md"}]]}]}],"$undefined"]}] 169f:T787,
curl -X POST "https://merchant.revolut.com/api/orders/__RP_TOK_0__/refund" \
  -H "Content-Type: application/json" \
  -H "Authorization: __RP_TOK_1__" \
  -H "Revolut-Api-Version: __RP_TOK_2__" \
  -H "Idempotency-Key: __RP_TOK_3__" \
  -d '{
  "amount": 100,
  "currency": "GBP"
}'
16a0:T10b0,
const payload = {
  "amount": 100,
  "currency": "GBP"
};
fetch("https://merchant.revolut.com/api/orders/__RP_TOK_0__/refund", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "__RP_TOK_1__",
    "Revolut-Api-Version": "__RP_TOK_2__",
    "Idempotency-Key": "__RP_TOK_3__"
  },
  body: JSON.stringify(payload)
})
  .then(response => response.json())
  .then(data => console.log(data));
16a1:T1859,
package main

import (
  "fmt"
  "net/http"
  "bytes"
  "encoding/json"
)

func main() {
  url := "https://merchant.revolut.com/api/orders/__RP_TOK_0__/refund"
  jsonData := []byte(`
{
  "amount": 100,
  "currency": "GBP"
}
  `)
  req, _ := http.NewRequest("POST", url, bytes.NewBuffer(jsonData))
  req.Header.Add("Content-Type", "application/json")
  req.Header.Add("Authorization", "__RP_TOK_1__")
  req.Header.Add("Revolut-Api-Version", "__RP_TOK_2__")
  req.Header.Add("Idempotency-Key", "__RP_TOK_3__")

  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  fmt.Println(res)
}
16a2:Tde2,
import requests

url = "https://merchant.revolut.com/api/orders/__RP_TOK_0__/refund"
headers = {
  "Content-Type": "application/json",
  "Authorization": "__RP_TOK_1__",
  "Revolut-Api-Version": "__RP_TOK_2__",
  "Idempotency-Key": "__RP_TOK_3__"
}
payload = {
  "amount": 100,
  "currency": "GBP"
}

response = requests.post(url, headers=headers, json=payload)
print(response.json())
16a3:T1dba,
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;

public class Main {
  public static void main(String[] args) {
    HttpClient client = HttpClient.newHttpClient();
    String body = """
{
  "amount": 100,
  "currency": "GBP"
}
    """;

    HttpRequest request = HttpRequest.newBuilder()
      .uri(URI.create("https://merchant.revolut.com/api/orders/__RP_TOK_0__/refund"))
      .header("Content-Type", "application/json")
      .header("Authorization", "__RP_TOK_1__")
      .header("Revolut-Api-Version", "__RP_TOK_2__")
      .header("Idempotency-Key", "__RP_TOK_3__")
      .POST(HttpRequest.BodyPublishers.ofString(body))
      .build();

    client.sendAsync(request, HttpResponse.BodyHandlers.ofString())
      .thenApply(HttpResponse::body)
      .thenAccept(System.out::println)
      .join();
  }
}
16a4:T1fd6,
using System.Net.Http;
using System.Net.Http.Headers;

var client = new HttpClient();
var request = new HttpRequestMessage
{
  Method = HttpMethod.Post,
  RequestUri = new Uri("https://merchant.revolut.com/api/orders/__RP_TOK_0__/refund"),
  Headers =
  {
    { "Authorization", "__RP_TOK_1__" },
    { "Revolut-Api-Version", "__RP_TOK_2__" },
    { "Idempotency-Key", "__RP_TOK_3__" },
  },
  Content = new StringContent(@"{
  ""amount"": 100,
  ""currency"": ""GBP""
}")
  {
    Headers =
    {
      ContentType = new MediaTypeHeaderValue("application/json")
    }
  }
};

using (var response = await client.SendAsync(request))
{
  response.EnsureSuccessStatusCode();
  var body = await response.Content.ReadAsStringAsync();
  Console.WriteLine(body);
}
16a5:T78f,
curl -X POST "https://sandbox-merchant.revolut.com/api/orders/__RP_TOK_0__/refund" \
  -H "Content-Type: application/json" \
  -H "Authorization: __RP_TOK_1__" \
  -H "Revolut-Api-Version: __RP_TOK_2__" \
  -H "Idempotency-Key: __RP_TOK_3__" \
  -d '{
  "amount": 100,
  "currency": "GBP"
}'
16a6:T10b8,
const payload = {
  "amount": 100,
  "currency": "GBP"
};
fetch("https://sandbox-merchant.revolut.com/api/orders/__RP_TOK_0__/refund", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "__RP_TOK_1__",
    "Revolut-Api-Version": "__RP_TOK_2__",
    "Idempotency-Key": "__RP_TOK_3__"
  },
  body: JSON.stringify(payload)
})
  .then(response => response.json())
  .then(data => console.log(data));
16a7:T1861,
package main

import (
  "fmt"
  "net/http"
  "bytes"
  "encoding/json"
)

func main() {
  url := "https://sandbox-merchant.revolut.com/api/orders/__RP_TOK_0__/refund"
  jsonData := []byte(`
{
  "amount": 100,
  "currency": "GBP"
}
  `)
  req, _ := http.NewRequest("POST", url, bytes.NewBuffer(jsonData))
  req.Header.Add("Content-Type", "application/json")
  req.Header.Add("Authorization", "__RP_TOK_1__")
  req.Header.Add("Revolut-Api-Version", "__RP_TOK_2__")
  req.Header.Add("Idempotency-Key", "__RP_TOK_3__")

  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  fmt.Println(res)
}
16a8:Tdea,
import requests

url = "https://sandbox-merchant.revolut.com/api/orders/__RP_TOK_0__/refund"
headers = {
  "Content-Type": "application/json",
  "Authorization": "__RP_TOK_1__",
  "Revolut-Api-Version": "__RP_TOK_2__",
  "Idempotency-Key": "__RP_TOK_3__"
}
payload = {
  "amount": 100,
  "currency": "GBP"
}

response = requests.post(url, headers=headers, json=payload)
print(response.json())
16a9:T1dc2,
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;

public class Main {
  public static void main(String[] args) {
    HttpClient client = HttpClient.newHttpClient();
    String body = """
{
  "amount": 100,
  "currency": "GBP"
}
    """;

    HttpRequest request = HttpRequest.newBuilder()
      .uri(URI.create("https://sandbox-merchant.revolut.com/api/orders/__RP_TOK_0__/refund"))
      .header("Content-Type", "application/json")
      .header("Authorization", "__RP_TOK_1__")
      .header("Revolut-Api-Version", "__RP_TOK_2__")
      .header("Idempotency-Key", "__RP_TOK_3__")
      .POST(HttpRequest.BodyPublishers.ofString(body))
      .build();

    client.sendAsync(request, HttpResponse.BodyHandlers.ofString())
      .thenApply(HttpResponse::body)
      .thenAccept(System.out::println)
      .join();
  }
}
16aa:T1fde,
using System.Net.Http;
using System.Net.Http.Headers;

var client = new HttpClient();
var request = new HttpRequestMessage
{
  Method = HttpMethod.Post,
  RequestUri = new Uri("https://sandbox-merchant.revolut.com/api/orders/__RP_TOK_0__/refund"),
  Headers =
  {
    { "Authorization", "__RP_TOK_1__" },
    { "Revolut-Api-Version", "__RP_TOK_2__" },
    { "Idempotency-Key", "__RP_TOK_3__" },
  },
  Content = new StringContent(@"{
  ""amount"": 100,
  ""currency"": ""GBP""
}")
  {
    Headers =
    {
      ContentType = new MediaTypeHeaderValue("application/json")
    }
  }
};

using (var response = await client.SendAsync(request))
{
  response.EnsureSuccessStatusCode();
  var body = await response.Content.ReadAsStringAsync();
  Console.WriteLine(body);
}
1697:["$","div",null,{"className":"ezz1n30","children":[["$","div",null,{"data-header":"$undefined","className":"ezz1n31","children":["$L1699",["$","$L85",null,{"parameters":[{"name":"Authorization","in":"header","schema":{"type":"string","format":"Bearer ","examples":"$62:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:0:schema:examples"},"required":true,"description":"This parameter accepts the [Merchant API Secret key](https://business.revolut.com/settings/apis?tab=merchant-api) to authorise requests coming from the merchant's backend. \n\nIt ensures that ensures that each request is authenticated and authorised by verifying the secret key. The secret key should be included in all request headers as a `Bearer` token.\n\n:::info\nFor more information, see: [Authentication](https://developer.revolut.com/docs/api/merchant#authentication)\n:::","descriptionNode":"$L169a"},{"name":"Revolut-Api-Version","in":"header","schema":{"type":"string","format":"date","enum":"$36:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:1:schema:enum","examples":"$36:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:1:schema:examples"},"required":true,"description":"The version of the Merchant API, specified in `YYYY-MM-DD` format.\n\nIf not specified, you will receive an error.\n\n\n:::info\nFor more information about API versioning, see: [API versions](https://developer.revolut.com/docs/guides/merchant/reference/versioning/api-versions).\n:::","x-config-always-visible-in-example":true,"example":"2025-10-16","descriptionNode":"$L169b"},{"name":"Idempotency-Key","in":"header","schema":{"type":"string"},"required":false,"description":"The `Idempotency-Key` ensures that requests are processed only once, preventing multiple executions of the same operation due to retries or duplicate requests.\n\nThis header is optional and can accept any unique string value the merchant uses.\n\nA recommended practice is to use a unique identifier from your system (such as the entity's ID or a request UUID) as the idempotency key. This facilitates tracking and managing requests effectively.","descriptionNode":"$L169c"},{"name":"order_id","in":"path","schema":{"type":"string","format":"uuid","description":"A UUID string, typically used to identify resources.","descriptionNode":"$L169d"},"required":true,"description":"The ID of the `Order` object.","descriptionNode":"$L169e"}],"requestBody":"$1f:props:children:0:props:children:props:requestBody","heading":"Request","requestBodySchemaTitle":"Request body","headingAs":"h3"}],["$","$L89",null,{"responses":"$1f:props:children:0:props:children:props:responses","headingAs":"h3"}]]}],["$","div",null,{"className":"ezz1n32","children":[[["$","$L8a",null,{"itemsByServer":{"https://merchant.revolut.com":[{"id":"curl","label":"cURL","templateCode":"curl -X POST \"https://merchant.revolut.com/api/orders/__RP_TOK_0__/refund\" \\\n -H \"Content-Type: application/json\" \\\n -H \"Authorization: __RP_TOK_1__\" \\\n -H \"Revolut-Api-Version: __RP_TOK_2__\" \\\n -H \"Idempotency-Key: __RP_TOK_3__\" \\\n -d '{\n \"amount\": 100,\n \"currency\": \"GBP\"\n}'","templateHtml":"$169f","tokens":[{"marker":"__RP_TOK_0__","paramName":"order_id","paramIn":"path","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_3__","paramName":"Idempotency-Key","paramIn":"header","pipeline":["shell-double-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","header:Idempotency-Key":"string","path:order_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"javascript","label":"JavaScript","templateCode":"const payload = {\n \"amount\": 100,\n \"currency\": \"GBP\"\n};\nfetch(\"https://merchant.revolut.com/api/orders/__RP_TOK_0__/refund\", {\n method: \"POST\",\n headers: {\n \"Content-Type\": \"application/json\",\n \"Authorization\": \"__RP_TOK_1__\",\n \"Revolut-Api-Version\": \"__RP_TOK_2__\",\n \"Idempotency-Key\": \"__RP_TOK_3__\"\n },\n body: JSON.stringify(payload)\n})\n .then(response => response.json())\n .then(data => console.log(data));","templateHtml":"$16a0","tokens":[{"marker":"__RP_TOK_0__","paramName":"order_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_3__","paramName":"Idempotency-Key","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","header:Idempotency-Key":"string","path:order_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"go","label":"Go","templateCode":"package main\n\nimport (\n \"fmt\"\n \"net/http\"\n \"bytes\"\n \"encoding/json\"\n)\n\nfunc main() {\n url := \"https://merchant.revolut.com/api/orders/__RP_TOK_0__/refund\"\n jsonData := []byte(`\n{\n \"amount\": 100,\n \"currency\": \"GBP\"\n}\n `)\n req, _ := http.NewRequest(\"POST\", url, bytes.NewBuffer(jsonData))\n req.Header.Add(\"Content-Type\", \"application/json\")\n req.Header.Add(\"Authorization\", \"__RP_TOK_1__\")\n req.Header.Add(\"Revolut-Api-Version\", \"__RP_TOK_2__\")\n req.Header.Add(\"Idempotency-Key\", \"__RP_TOK_3__\")\n\n res, _ := http.DefaultClient.Do(req)\n defer res.Body.Close()\n fmt.Println(res)\n}","templateHtml":"$16a1","tokens":[{"marker":"__RP_TOK_0__","paramName":"order_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_3__","paramName":"Idempotency-Key","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","header:Idempotency-Key":"string","path:order_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"python","label":"Python","templateCode":"import requests\n\nurl = \"https://merchant.revolut.com/api/orders/__RP_TOK_0__/refund\"\nheaders = {\n \"Content-Type\": \"application/json\",\n \"Authorization\": \"__RP_TOK_1__\",\n \"Revolut-Api-Version\": \"__RP_TOK_2__\",\n \"Idempotency-Key\": \"__RP_TOK_3__\"\n}\npayload = {\n \"amount\": 100,\n \"currency\": \"GBP\"\n}\n\nresponse = requests.post(url, headers=headers, json=payload)\nprint(response.json())","templateHtml":"$16a2","tokens":[{"marker":"__RP_TOK_0__","paramName":"order_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_3__","paramName":"Idempotency-Key","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","header:Idempotency-Key":"string","path:order_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"java","label":"Java","templateCode":"import java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\nimport java.net.URI;\n\npublic class Main {\n public static void main(String[] args) {\n HttpClient client = HttpClient.newHttpClient();\n String body = \"\"\"\n{\n \"amount\": 100,\n \"currency\": \"GBP\"\n}\n \"\"\";\n\n HttpRequest request = HttpRequest.newBuilder()\n .uri(URI.create(\"https://merchant.revolut.com/api/orders/__RP_TOK_0__/refund\"))\n .header(\"Content-Type\", \"application/json\")\n .header(\"Authorization\", \"__RP_TOK_1__\")\n .header(\"Revolut-Api-Version\", \"__RP_TOK_2__\")\n .header(\"Idempotency-Key\", \"__RP_TOK_3__\")\n .POST(HttpRequest.BodyPublishers.ofString(body))\n .build();\n\n client.sendAsync(request, HttpResponse.BodyHandlers.ofString())\n .thenApply(HttpResponse::body)\n .thenAccept(System.out::println)\n .join();\n }\n}","templateHtml":"$16a3","tokens":[{"marker":"__RP_TOK_0__","paramName":"order_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_3__","paramName":"Idempotency-Key","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","header:Idempotency-Key":"string","path:order_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"csharp","label":"C#","templateCode":"using System.Net.Http;\nusing System.Net.Http.Headers;\n\nvar client = new HttpClient();\nvar request = new HttpRequestMessage\n{\n Method = HttpMethod.Post,\n RequestUri = new Uri(\"https://merchant.revolut.com/api/orders/__RP_TOK_0__/refund\"),\n Headers =\n {\n { \"Authorization\", \"__RP_TOK_1__\" },\n { \"Revolut-Api-Version\", \"__RP_TOK_2__\" },\n { \"Idempotency-Key\", \"__RP_TOK_3__\" },\n },\n Content = new StringContent(@\"{\n \"\"amount\"\": 100,\n \"\"currency\"\": \"\"GBP\"\"\n}\")\n {\n Headers =\n {\n ContentType = new MediaTypeHeaderValue(\"application/json\")\n }\n }\n};\n\nusing (var response = await client.SendAsync(request))\n{\n response.EnsureSuccessStatusCode();\n var body = await response.Content.ReadAsStringAsync();\n Console.WriteLine(body);\n}","templateHtml":"$16a4","tokens":[{"marker":"__RP_TOK_0__","paramName":"order_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_3__","paramName":"Idempotency-Key","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","header:Idempotency-Key":"string","path:order_id":"123e4567-e89b-12d3-a456-426614174000"}}],"https://sandbox-merchant.revolut.com":[{"id":"curl","label":"cURL","templateCode":"curl -X POST \"https://sandbox-merchant.revolut.com/api/orders/__RP_TOK_0__/refund\" \\\n -H \"Content-Type: application/json\" \\\n -H \"Authorization: __RP_TOK_1__\" \\\n -H \"Revolut-Api-Version: __RP_TOK_2__\" \\\n -H \"Idempotency-Key: __RP_TOK_3__\" \\\n -d '{\n \"amount\": 100,\n \"currency\": \"GBP\"\n}'","templateHtml":"$16a5","tokens":[{"marker":"__RP_TOK_0__","paramName":"order_id","paramIn":"path","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_3__","paramName":"Idempotency-Key","paramIn":"header","pipeline":["shell-double-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","header:Idempotency-Key":"string","path:order_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"javascript","label":"JavaScript","templateCode":"const payload = {\n \"amount\": 100,\n \"currency\": \"GBP\"\n};\nfetch(\"https://sandbox-merchant.revolut.com/api/orders/__RP_TOK_0__/refund\", {\n method: \"POST\",\n headers: {\n \"Content-Type\": \"application/json\",\n \"Authorization\": \"__RP_TOK_1__\",\n \"Revolut-Api-Version\": \"__RP_TOK_2__\",\n \"Idempotency-Key\": \"__RP_TOK_3__\"\n },\n body: JSON.stringify(payload)\n})\n .then(response => response.json())\n .then(data => console.log(data));","templateHtml":"$16a6","tokens":[{"marker":"__RP_TOK_0__","paramName":"order_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_3__","paramName":"Idempotency-Key","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","header:Idempotency-Key":"string","path:order_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"go","label":"Go","templateCode":"package main\n\nimport (\n \"fmt\"\n \"net/http\"\n \"bytes\"\n \"encoding/json\"\n)\n\nfunc main() {\n url := \"https://sandbox-merchant.revolut.com/api/orders/__RP_TOK_0__/refund\"\n jsonData := []byte(`\n{\n \"amount\": 100,\n \"currency\": \"GBP\"\n}\n `)\n req, _ := http.NewRequest(\"POST\", url, bytes.NewBuffer(jsonData))\n req.Header.Add(\"Content-Type\", \"application/json\")\n req.Header.Add(\"Authorization\", \"__RP_TOK_1__\")\n req.Header.Add(\"Revolut-Api-Version\", \"__RP_TOK_2__\")\n req.Header.Add(\"Idempotency-Key\", \"__RP_TOK_3__\")\n\n res, _ := http.DefaultClient.Do(req)\n defer res.Body.Close()\n fmt.Println(res)\n}","templateHtml":"$16a7","tokens":[{"marker":"__RP_TOK_0__","paramName":"order_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_3__","paramName":"Idempotency-Key","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","header:Idempotency-Key":"string","path:order_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"python","label":"Python","templateCode":"import requests\n\nurl = \"https://sandbox-merchant.revolut.com/api/orders/__RP_TOK_0__/refund\"\nheaders = {\n \"Content-Type\": \"application/json\",\n \"Authorization\": \"__RP_TOK_1__\",\n \"Revolut-Api-Version\": \"__RP_TOK_2__\",\n \"Idempotency-Key\": \"__RP_TOK_3__\"\n}\npayload = {\n \"amount\": 100,\n \"currency\": \"GBP\"\n}\n\nresponse = requests.post(url, headers=headers, json=payload)\nprint(response.json())","templateHtml":"$16a8","tokens":[{"marker":"__RP_TOK_0__","paramName":"order_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_3__","paramName":"Idempotency-Key","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","header:Idempotency-Key":"string","path:order_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"java","label":"Java","templateCode":"import java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\nimport java.net.URI;\n\npublic class Main {\n public static void main(String[] args) {\n HttpClient client = HttpClient.newHttpClient();\n String body = \"\"\"\n{\n \"amount\": 100,\n \"currency\": \"GBP\"\n}\n \"\"\";\n\n HttpRequest request = HttpRequest.newBuilder()\n .uri(URI.create(\"https://sandbox-merchant.revolut.com/api/orders/__RP_TOK_0__/refund\"))\n .header(\"Content-Type\", \"application/json\")\n .header(\"Authorization\", \"__RP_TOK_1__\")\n .header(\"Revolut-Api-Version\", \"__RP_TOK_2__\")\n .header(\"Idempotency-Key\", \"__RP_TOK_3__\")\n .POST(HttpRequest.BodyPublishers.ofString(body))\n .build();\n\n client.sendAsync(request, HttpResponse.BodyHandlers.ofString())\n .thenApply(HttpResponse::body)\n .thenAccept(System.out::println)\n .join();\n }\n}","templateHtml":"$16a9","tokens":[{"marker":"__RP_TOK_0__","paramName":"order_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_3__","paramName":"Idempotency-Key","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","header:Idempotency-Key":"string","path:order_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"csharp","label":"C#","templateCode":"using System.Net.Http;\nusing System.Net.Http.Headers;\n\nvar client = new HttpClient();\nvar request = new HttpRequestMessage\n{\n Method = HttpMethod.Post,\n RequestUri = new Uri(\"https://sandbox-merchant.revolut.com/api/orders/__RP_TOK_0__/refund\"),\n Headers =\n {\n { \"Authorization\", \"__RP_TOK_1__\" },\n { \"Revolut-Api-Version\", \"__RP_TOK_2__\" },\n { \"Idempotency-Key\", \"__RP_TOK_3__\" },\n },\n Content = new StringContent(@\"{\n \"\"amount\"\": 100,\n \"\"currency\"\": \"\"GBP\"\"\n}\")\n {\n Headers =\n {\n ContentType = new MediaTypeHeaderValue(\"application/json\")\n }\n }\n};\n\nusing (var response = await client.SendAsync(request))\n{\n response.EnsureSuccessStatusCode();\n var body = await response.Content.ReadAsStringAsync();\n Console.WriteLine(body);\n}","templateHtml":"$16aa","tokens":[{"marker":"__RP_TOK_0__","paramName":"order_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_3__","paramName":"Idempotency-Key","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","header:Idempotency-Key":"string","path:order_id":"123e4567-e89b-12d3-a456-426614174000"}}]},"method":"post","servers":"$62:props:children:0:props:children:props:children:1:props:children:1:props:children:0:0:props:servers","path":"/api/orders/{order_id}/refund","parameters":["$1697:props:children:0:props:children:1:props:parameters:0","$1697:props:children:0:props:children:1:props:parameters:1","$1697:props:children:0:props:children:1:props:parameters:2","$1697:props:children:0:props:children:1:props:parameters:3"]}],"$L16ab"],"$L16ac","$L16ad"]}]]}] 16ab:["$","$L10d",null,{"security":[{"Api-Key":[]}],"authorization":{"Api-Key":{"type":"apiKey","in":"header","name":"Authorization","description":"Each Merchant API request must contain an authorization header in the following format:\n\n```\n'Authorization: Bearer '\n```\n\nTo use this API, you need to generate API keys from your Revolut Business account. The Secret key is used in the authorization header for all server calls, while the Public key is provided with payment methods at checkout.\n\n:::info\nFor detailed instructions on generating your API keys, see: [Generate API keys](https://developer.revolut.com/docs/guides/merchant/get-started#generate-api-keys).\n:::","descriptionNode":"$L16ae"}}}] 16ac:["$","$L10f",null,{"exampleBlocks":{"application/json":{"variants":[{"key":"refund_with_minimal_params","label":"Refund order with minimal required parameters","rawValue":"$1f:props:children:0:props:children:props:requestBody:content:application/json:examples:refund_with_minimal_params:value","block":"$L16af"},{"key":"refund_with_additional_params","label":"Refund order with additional parameters","rawValue":"$1f:props:children:0:props:children:props:requestBody:content:application/json:examples:refund_with_additional_params:value","block":"$L16b0"}],"syncedPropertyName":"$undefined"}},"title":"Request body samples","headingAs":"h4"}] 16ad:["$","$L110",null,{"exampleBlocks":{"201":{"application/json":{"variants":[{"key":"refund_with_minimal_params","label":"Refund order response with minimal required parameters","rawValue":"$1f:props:children:0:props:children:props:responses:201:content:application/json:examples:refund_with_minimal_params:value","block":"$L16b1"},{"key":"refund_with_additional_params","label":"Refund order response with additional parameters","rawValue":"$1f:props:children:0:props:children:props:responses:201:content:application/json:examples:refund_with_additional_params:value","block":"$L16b2"}],"syncedPropertyName":"$undefined"}},"400":{"application/json":{"variants":[{"key":"default","label":"default","rawValue":"$1f:props:children:0:props:children:props:responses:400:content:application/json:examples:default:value","block":"$L16b3"}],"syncedPropertyName":"$undefined"}},"401":{"application/json":{"variants":[{"key":"default","label":"default","rawValue":"$1f:props:children:0:props:children:props:responses:401:content:application/json:examples:default:value","block":"$L16b4"}],"syncedPropertyName":"$undefined"}},"404":{"application/json":{"variants":[{"key":"default","label":"default","rawValue":"$1f:props:children:0:props:children:props:responses:404:content:application/json:examples:default:value","block":"$L16b5"}],"syncedPropertyName":"$undefined"}},"422":{"application/json":{"variants":[{"key":"default","label":"Example","rawValue":{"code":"string","message":"string","timestamp":123},"block":"$L16b6"}],"syncedPropertyName":"$undefined"}}},"headingAs":"h4"}] 1698:"Refund an order" 1533:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Permanent order ID used to retrieve, capture, cancel, or refund an order after authorization."}]]}] 1534:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Temporary ID for the order, which expires when the payment is authorised."}],"\n",["$","p","p-1",{"children":["The order ",["$","code","code-0",{"children":"token"}]," is used for ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/sdks/merchant-web-sdk/initialisation/token-based","target":"_blank","rel":"noreferrer","children":"token-based initialisation"}],", and is returned by the ",["$","code","code-1",{"children":"createOrder"}]," callback in the following payment methods:"]}],"\n",["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["$","a","a-0",{"href":"https://developer.revolut.com/docs/sdks/merchant-web-sdk/payment-methods/embedded-checkout#embedded-checkout-options-interface","target":"_blank","rel":"noreferrer","children":"Embedded Checkout"}]}],"\n",["$","li","li-1",{"children":["$","a","a-0",{"href":"https://developer.revolut.com/docs/sdks/merchant-web-sdk/payment-methods/revolut-pay#widget-payments-revolut-pay-options","target":"_blank","rel":"noreferrer","children":"Revolut Pay"}]}],"\n",["$","li","li-2",{"children":["$","a","a-0",{"href":"https://developer.revolut.com/docs/sdks/merchant-web-sdk/payment-methods/apple-pay-google-pay#payment-request-options-interface","target":"_blank","rel":"noreferrer","children":"Apple Pay and Google Pay"}]}],"\n",["$","li","li-3",{"children":["$","a","a-0",{"href":"https://developer.revolut.com/docs/sdks/merchant-web-sdk/payment-methods/pay-by-bank#pay-by-bank-options-interface","target":"_blank","rel":"noreferrer","children":"Pay by Bank"}]}],"\n"]}]]}] 1535:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of the order."}]]}] 1536:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The state of the order in its lifecycle."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"State","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"pending"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Order created, awaiting payment","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"processing"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Payment is being processed","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"authorised"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Payment authorised but not yet captured (for manual capture)","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"completed"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Payment successfully captured and settled","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-4",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"cancelled"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Order was cancelled","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-5",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"failed"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Payment failed","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/reference/order-lifecycle","target":"_blank","rel":"noreferrer","children":"Order and payment lifecycle"}]]}]}]]}]]}] 1537:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The date and time the order was created."}]]}] 1538:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The date and time the order was last updated."}]]}] 1539:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The description of the order."}]]}] 153a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The capture mode of the order. ",["$","code","code-0",{"children":"automatic"}]," is used by default."]}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Parameter value","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"automatic"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The order is captured automatically after payment authorisation.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"manual"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The order is not captured automatically. You must manually capture the order later.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information, see ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#capture-order","target":"_blank","rel":"noreferrer","children":"Capture an order"}],"."]}]}]]}]]}] 153b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The type of authorisation for the order. Used with manual capture mode. If omitted, ",["$","code","code-0",{"children":"final"}]," is used by default."]}],"\n",["$","h1","h1-0",{"children":"Pre-authorisation"}],"\n",["$","p","p-1",{"children":"Pre-authorisation allows you to reserve funds on a customer's card without immediately capturing them. This is useful for scenarios like:"}],"\n",["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":"Hotel bookings where the final amount may vary"}],"\n",["$","li","li-1",{"children":"Car rentals where additional charges may apply"}],"\n",["$","li","li-2",{"children":"Deposits that need to be held temporarily"}],"\n"]}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Parameter value","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"final"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Standard authorisation for immediate or near-immediate capture.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"pre_authorisation"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Reserve funds for later capture, used with manual capture mode.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["Pre-authorisation must be used with ",["$","code","code-0",{"children":"capture_mode: manual"}],". For more information, see ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#capture-order","target":"_blank","rel":"noreferrer","children":"Capture an order"}],"."]}]}]]}]]}] 153d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["Automatic cancellation period for uncaptured orders, specified in ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_8601","target":"_blank","rel":"noreferrer","children":"ISO 8601"}]," format."]}],"\n",["$","p","p-1",{"children":["After this period, the authorised payment is automatically cancelled and the order is cancelled. Maximum: 7 days = ",["$","code","code-0",{"children":"P7D"}],"."]}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"The following limitations apply:"}],["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["\n",["$","p","p-0",{"children":"Cannot be a negative value."}],"\n"]}],"\n",["$","li","li-1",{"children":["\n",["$","p","p-0",{"children":"Cannot be updated if the new value is less than or equal to the elapsed time since authorisation."}],"\n",["$","p","p-1",{"children":["$","strong","strong-0",{"children":"Failing scenario:"}]}],"\n",["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":"Original value: 7 days"}],"\n",["$","li","li-1",{"children":"Time since authorisation: 3 days"}],"\n",["$","li","li-2",{"children":"Update value: 2 days"}],"\n"]}],"\n",["$","p","p-2",{"children":"In this scenario, an error is returned."}],"\n",["$","p","p-3",{"children":["$","strong","strong-0",{"children":"Successful scenario:"}]}],"\n",["$","ul","ul-1",{"children":["\n",["$","li","li-0",{"children":"Original value: 7 days"}],"\n",["$","li","li-1",{"children":"Time since authorisation: 3 days"}],"\n",["$","li","li-2",{"children":"Update value: 4 days"}],"\n"]}],"\n",["$","p","p-4",{"children":"In this scenario, the parameter can be updated."}],"\n"]}],"\n",["$","li","li-2",{"children":["\n",["$","p","p-0",{"children":"Cannot be updated if cancellation is ≤ 30 minutes away."}],"\n",["$","p","p-1",{"children":["$","strong","strong-0",{"children":"Failing scenario:"}]}],"\n",["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":"Original value: 12 hours"}],"\n",["$","li","li-1",{"children":"Time since authorisation: 11 hours 40 minutes"}],"\n"]}],"\n",["$","p","p-2",{"children":"In this scenario, an error is returned."}],"\n",["$","p","p-3",{"children":["$","strong","strong-0",{"children":"Successful scenario:"}]}],"\n",["$","ul","ul-1",{"children":["\n",["$","li","li-0",{"children":"Original value: 12 hours"}],"\n",["$","li","li-1",{"children":"Time since authorisation: 11 hours 20 minutes"}],"\n"]}],"\n",["$","p","p-4",{"children":"In this scenario, the parameter can be updated."}],"\n"]}],"\n"]}]]}]]}]]}] 153e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The order total expressed in minor currency units, according to the ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_4217","target":"_blank","rel":"noreferrer","children":"ISO 4217 standard"}],". For example, ",["$","code","code-0",{"children":"7034"}]," in ",["$","code","code-1",{"children":"EUR"}]," corresponds to €70.34."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["Conversion between major and minor units varies by currency. For instance, ",["$","code","code-0",{"children":"100"}]," minor units equal £1.00 in ",["$","code","code-1",{"children":"GBP"}],", whereas in ",["$","code","code-2",{"children":"ISK"}]," they represent 100 units. For more details, see the ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_4217","target":"_blank","rel":"noreferrer","children":"ISO 4217 standard"}],"."]}],"\n",["$","li","li-1",{"children":["If ",["$","code","code-0",{"children":"line_items"}]," are provided, the order ",["$","code","code-1",{"children":"amount"}]," must equal the sum of all line items' ",["$","code","code-2",{"children":"total_amount"}],"."]}],"\n",["$","li","li-2",{"children":["For card payments with a non-zero amount, the order ",["$","code","code-0",{"children":"amount"}]," must be at least ",["$","strong","strong-0",{"children":"$$0.005"}]," (or equivalent in different currencies, calculated using Revolut's exchange rate on the payment date). Otherwise, card payments can't be performed."]}],"\n"]}]}]]}]]}] 153f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The amount not yet paid for a given order (in minor currency units). For example, ",["$","code","code-0",{"children":"7034"}]," represents €70.34."]}],"\n",["$","p","p-1",{"children":["The value in this field may differ from ",["$","code","code-0",{"children":"amount"}]," if there are partial payments associated with the order."]}]]}] 1540:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The amount that was refunded from the order (in minor currency units). For example, ",["$","code","code-0",{"children":"7034"}]," represents €70.34."]}],"\n",["$","p","p-1",{"children":["This applies to orders that have been refunded (i.e., orders of type ",["$","code","code-0",{"children":"payment"}]," that have a related ",["$","code","code-1",{"children":"refund"}]," order)."]}]]}] 1541:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":[["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_4217","target":"_blank","rel":"noreferrer","children":"ISO 4217"}]," currency code in upper case."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information about the supported currencies, see: ",["$","a","a-0",{"href":"https://help.revolut.com/business/help/merchant-accounts/payments/in-which-currencies-can-i-accept-payments/","target":"_blank","rel":"noreferrer","children":"Help Center"}],"."]}]}]]}]]}] 1542:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":[["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_4217","target":"_blank","rel":"noreferrer","children":"ISO 4217"}]," currency code in upper case."]}],"\n",["$","p","p-1",{"children":["If ",["$","code","code-0",{"children":"settlement_currency"}]," is different from the value of ",["$","code","code-1",{"children":"currency"}],", the money will be exchanged when the amount is settled to your merchant account. In case of a refund or chargeback, the money will be exchanged to the order's initial ",["$","code","code-2",{"children":"currency"}],"."]}],"\n",["$","p","p-2",{"children":["If ",["$","code","code-0",{"children":"settlement_currency"}]," is not specified, this value is taken from ",["$","code","code-1",{"children":"currency"}],"."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information about the supported currencies, see: ",["$","a","a-0",{"href":"https://help.revolut.com/business/help/merchant-accounts/payments/in-which-currencies-can-i-accept-payments/","target":"_blank","rel":"noreferrer","children":"Help Center"}],"."]}]}]]}]]}] 1544:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Permanent ID of a customer used to retrieve, update, delete a customer. This ID can also be used to link customer to an order."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":"If you provide the customer's ID during order creation, no other customer data is required, they will be parsed automatically from the referenced customer object."}]}]]}]]}] 1545:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The full name of the customer."}]]}] 1546:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The phone number of the customer in ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/E.164","target":"_blank","rel":"noreferrer","children":"E.164 format"}],"."]}]]}] 1547:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The email address of the customer."}]]}] 1548:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The birth date of the customer."}]]}] 1549:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object containing information about a customer."}],"\n",["$","p","p-1",{"children":["If you have it, we strongly advise providing at least either ",["$","code","code-0",{"children":"id"}],", ",["$","code","code-1",{"children":"phone"}],", or ",["$","code","code-2",{"children":"email"}],"."]}],"\n",["$","p","p-2",{"children":["Using the ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#tag-customers","target":"_blank","rel":"noreferrer","children":"Customers operations"}],", you can manage customer instances."]}],"\n",["$","p","p-3",{"children":"The following behaviours apply to different use cases:"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Use case","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"API behavior","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":"Existing customer","className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["If ",["$","code","code-0",{"children":"id"}]," was provided, we ignore other customer details and associate the customer with the order.",["$","br","br-0",{}],["$","br","br-1",{}],"If either ",["$","code","code-1",{"children":"email"}],", ",["$","code","code-2",{"children":"phone"}],", or ",["$","code","code-3",{"children":"full_name"}]," was provided (without an existing customer's ",["$","code","code-4",{"children":"id"}],"), we always create a new customer, irrespective of another, existing customer object having the same details."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":"New customer","className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["If either ",["$","code","code-0",{"children":"email"}],", ",["$","code","code-1",{"children":"phone"}],", or ",["$","code","code-2",{"children":"full_name"}]," was provided, we create a new customer, irrespective of another customer object having the same details. ",["$","br","br-0",{}],["$","br","br-1",{}],"If ",["$","code","code-3",{"children":"id"}]," of a non-existent customer was provided, we return a ",["$","code","code-4",{"children":"404"}]," error, irrespective of other details provided."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["To avoid unintentional duplication of customer records, search for an existing customer by email or phone using the ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#retrieve-customer-list","target":"_blank","rel":"noreferrer","children":"List customers"}]," endpoint first, then provide ",["$","code","code-0",{"children":"customer.id"}]," in the order."]}]}]]}]]}] 154a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The ID of the payment."}]]}] 154b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The status of the payment."}]]}] 154c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The reason for a ",["$","code","code-0",{"children":"failed"}]," or ",["$","code","code-1",{"children":"declined"}]," payment."]}],"\n",["$","p","p-1",{"children":["A failed or declined payment can result from multiple reasons. To learn more, check our ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/reference/error-codes/decline-reasons","target":"_blank","rel":"noreferrer","children":"failure reasons"}],"."]}]]}] 154d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The reason for a ",["$","code","code-0",{"children":"failed"}]," or ",["$","code","code-1",{"children":"declined"}]," payment, sent by the financial institution processing the payment."]}]]}] 154e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The date and time the payment was created."}]]}] 154f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The date and time the payment was last updated."}]]}] 1550:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Temporary token of the payment used to fetch the reward offer during checkout and link user registrations to the given offers."}],"\n",["$","p","p-1",{"children":"The token is only valid for a limited time."}]]}] 1551:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The payment amount in minor units (e.g., cents). The value of this field depends on the payment type and state."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Payment type","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"State","className":"eowryt6","ref":"$undefined"}],["$","th","th-2",{"children":"Amount value","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":"Standard payment","className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Any","className":"eowryt7","ref":"$undefined"}],["$","td","td-2",{"children":"Total payment amount","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":"Pre-authorised payment","className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["$","code","code-0",{"children":"authorisation_started"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-2",{"children":"New amount being authorised (during increment processing)","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":"Pre-authorised payment","className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["$","code","code-0",{"children":"authorised"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-2",{"children":["Currently authorised amount (equals ",["$","code","code-0",{"children":"authorised_amount"}],")"],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For pre-authorised payments, see the ",["$","code","code-0",{"children":"authorised_amount"}]," field for tracking the currently authorised amount separately."]}]}]]}]]}] 1552:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The currently authorised amount for this payment (in minor units)."}],"\n",["$","p","p-1",{"children":"For pre-authorised payments with incremental authorization:"}],"\n",["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["Initially equals the ",["$","code","code-0",{"children":"amount"}]," field"]}],"\n",["$","li","li-1",{"children":"Remains unchanged during increment processing"}],"\n",["$","li","li-2",{"children":"Updates to new amount upon successful increment"}],"\n",["$","li","li-3",{"children":"Remains at original amount if increment is declined"}],"\n"]}],"\n",["$","p","p-2",{"children":["For standard payments, this field may not be present or will equal the ",["$","code","code-0",{"children":"amount"}]," field."]}]]}] 1553:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":[["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_4217","target":"_blank","rel":"noreferrer","children":"ISO 4217"}]," currency code in upper case."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information about the supported currencies, see: ",["$","a","a-0",{"href":"https://help.revolut.com/business/help/merchant-accounts/payments/in-which-currencies-can-i-accept-payments/","target":"_blank","rel":"noreferrer","children":"Help Center"}],"."]}]}]]}]]}] 1554:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The amount of the settled payment (minor currency unit). For example, ",["$","code","code-0",{"children":"7034"}]," stands for €70.34."]}]]}] 1555:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The currency of the settled payment. ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_4217","target":"_blank","rel":"noreferrer","children":"ISO 4217"}]," currency code in upper case."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information about the supported currencies, see: ",["$","a","a-0",{"href":"https://help.revolut.com/business/help/merchant-accounts/payments/in-which-currencies-can-i-accept-payments/","target":"_blank","rel":"noreferrer","children":"Help Center"}],"."]}]}]]}]]}] 1556:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"ID of the saved payment method."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["The ",["$","code","code-0",{"children":"id"}]," parameter is only returned when the payment method is saved."]}]}]]}]]}] 1557:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of payment method used to pay for the order."}],"\n",["$","p","p-1",{"children":"Available values:"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":["Payment method ",["$","code","code-0",{"children":"type"}]],"className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"apple_pay"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using Apple Pay.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"card"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using their credit or debit card.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"google_pay"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using Google Pay.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"revolut_pay_card"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order via Revolut Pay using their credit or debit card.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-4",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"revolut_pay_account"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order via Revolut Pay using their Revolut account.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-5",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"sepa_direct_debit"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using SEPA Direct Debit.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 1558:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of the card."}]]}] 1559:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of card funding."}]]}] 155a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The 2-letter country code of the country where the card was issued."}]]}] 155b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The BIN of the card."}]]}] 155c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The last four digits of the card number."}]]}] 155d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The expiry date of the card in the format of MM/YY."}]]}] 155e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The name of the cardholder."}]]}] 155f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The Electronic Commerce Indicator (ECI) value corresponds to the authentication result and indicates the level of security used when the payment information was provided."}]]}] 1560:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The result of 3D Secure check."}]]}] 1561:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The 3D Secure version."}]]}] 1562:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The details of the 3D Secure check. Only for orders with successful payments."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":"Not returned for Apple Pay and Google Pay payments."}]}]]}]]}] 1563:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The result of CVV verification."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Parameter value","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"match"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"CVV matches the card's CVV","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"not_match"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"CVV does not match the card's CVV","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"incorrect"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"CVV format is incorrect for this type of card","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"not_processed"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"CVV verification was not performed","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 1564:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The result of address verification."}]]}] 1565:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The result of postcode verification."}]]}] 1566:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The result of cardholder verification."}]]}] 1567:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The details of the check for card payment. Only for orders with successful payments."}]]}] 1568:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The authorisation code (or auth code) is a short, alphanumeric code returned by the cardholder's issuing bank to the merchant's terminal or payment gateway."}],"\n",["$","p","p-1",{"children":"It serves as confirmation that the transaction has been approved and funds are available."}]]}] 1569:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Acquirer Reference Number (ARN) of the payment."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":"Only returned for refund payments made by a card."}]}]]}]]}] 156a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The date and time by which the payment must be captured."}],"\n",["$","p","p-1",{"children":"After this deadline, the authorised funds may be automatically released by the card issuer."}]]}] 156b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The hardware identifier of the Revolut Terminal device used to process the payment."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":"Only present for card-present transactions processed via Revolut Terminal."}]}]]}]]}] 156d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A unique identifier for a payment method, always 44 characters long. This fingerprint can be used to uniquely identify various payment methods."}],"\n",["$","h1","h1-0",{"children":"Fingerprint generation"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Payment method","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","strong","strong-0",{"children":"All payment methods"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"A fingerprint is generated for all payment methods, including cards, Revolut Pay (card, account-to-account payments), Apple Pay, and Google Pay.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","strong","strong-0",{"children":"Cards (Revolut Pay & Card Gateway)"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"For cards, the fingerprint is based on the PAN. Cards processed via Revolut Pay and our card gateway will share the same fingerprint. Renewed cards (new expiry/CVV) retain the same fingerprint for efficient blocking.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","strong","strong-0",{"children":"Apple Pay & Google Pay"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Since Apple Pay and Google Pay provide us Device PANs (DPAN), the fingerprint is based on the DPAN provided by Apple/Google, not the connected card's PAN. This means that a new DPAN (and fingerprint) is generated for cards in case they are re-added to the customer's digital wallet, or added to different devices.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}],"\n",["$","h4","h4-0",{"children":"Detecting duplicate payment methods"}],"\n",["$","p","p-1",{"children":"Fingerprints are a valuable tool for detecting duplicate payment methods by identifying if a payment method has been seen before. This capability, in turn, helps in preventing various types of misuse (e.g., exploitation of free trials, or association with known problematic accounts, which can be a form of fraud). To effectively use fingerprints for this purpose, you will need to create and maintain your own lists (e.g., blocklists of known problematic fingerprints, allowlists for trusted customers, or tracking frequently used fingerprints)."}],"\n",["$","p","p-2",{"children":"The ideal way to utilise fingerprints is by combining them with a manual capture process. While automatic capture with subsequent refunds for problematic payments is possible, manual capture based on fingerprint validation is recommended."}],"\n",["$","p","p-3",{"children":"During your manual capture workflow, after a payment was authorised:"}],"\n",["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":"Check the fingerprint status by comparing it against your maintained lists and internal business rules."}],"\n",["$","li","li-1",{"children":["If you decide to proceed with the payment (e.g., the fingerprint is not on a blocklist, or matches a trusted customer's previous payment method): ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#capture-order","target":"_blank","rel":"noreferrer","children":"Capture the order"}],"."]}],"\n",["$","li","li-2",{"children":["If you decide not to proceed with the payment (e.g., the fingerprint matches a known fraudulent fingerprint, or exhibits suspicious patterns): ","$L16b7","."]}],"\n"]}]]}] 156e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The Network Transaction ID (NTI) is a unique identifier assigned by the card scheme (e.g., Visa or Mastercard) to a card transaction."}],"\n",["$","p","p-1",{"children":"It can be used to trace the transaction across the payment network, link recurring or instalment payments to the original authorisation, and support dispute resolution."}]]}] 156f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object containing details of a card used via Apple Pay."}]]}] 1570:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"ID of the saved payment method."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["The ",["$","code","code-0",{"children":"id"}]," parameter is only returned when the payment method is saved."]}]}]]}]]}] 1571:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of payment method used to pay for the order."}],"\n",["$","p","p-1",{"children":"Available values:"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":["Payment method ",["$","code","code-0",{"children":"type"}]],"className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"apple_pay"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using Apple Pay.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"card"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using their credit or debit card.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"google_pay"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using Google Pay.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"revolut_pay_card"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order via Revolut Pay using their credit or debit card.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-4",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"revolut_pay_account"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order via Revolut Pay using their Revolut account.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-5",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"sepa_direct_debit"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using SEPA Direct Debit.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 1572:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of the card."}]]}] 1573:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of card funding."}]]}] 1574:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The 2-letter country code of the country where the card was issued."}]]}] 1575:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The BIN of the card."}]]}] 1576:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The last four digits of the card number."}]]}] 1577:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The expiry date of the card in the format of MM/YY."}]]}] 1578:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The name of the cardholder."}]]}] 1579:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The details of the check for card payment. Only for orders with successful payments."}]]}] 157a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The authorisation code (or auth code) is a short, alphanumeric code returned by the cardholder's issuing bank to the merchant's terminal or payment gateway."}],"\n",["$","p","p-1",{"children":"It serves as confirmation that the transaction has been approved and funds are available."}]]}] 157b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Acquirer Reference Number (ARN) of the payment."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":"Only returned for refund payments made by a card."}]}]]}]]}] 157c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The date and time by which the payment must be captured."}],"\n",["$","p","p-1",{"children":"After this deadline, the authorised funds may be automatically released by the card issuer."}]]}] 157d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The hardware identifier of the Revolut Terminal device used to process the payment."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":"Only present for card-present transactions processed via Revolut Terminal."}]}]]}]]}] 157f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A unique identifier for a payment method, always 44 characters long. This fingerprint can be used to uniquely identify various payment methods."}],"\n",["$","h1","h1-0",{"children":"Fingerprint generation"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Payment method","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","strong","strong-0",{"children":"All payment methods"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"A fingerprint is generated for all payment methods, including cards, Revolut Pay (card, account-to-account payments), Apple Pay, and Google Pay.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","strong","strong-0",{"children":"Cards (Revolut Pay & Card Gateway)"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"For cards, the fingerprint is based on the PAN. Cards processed via Revolut Pay and our card gateway will share the same fingerprint. Renewed cards (new expiry/CVV) retain the same fingerprint for efficient blocking.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","strong","strong-0",{"children":"Apple Pay & Google Pay"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Since Apple Pay and Google Pay provide us Device PANs (DPAN), the fingerprint is based on the DPAN provided by Apple/Google, not the connected card's PAN. This means that a new DPAN (and fingerprint) is generated for cards in case they are re-added to the customer's digital wallet, or added to different devices.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}],"\n",["$","h4","h4-0",{"children":"Detecting duplicate payment methods"}],"\n",["$","p","p-1",{"children":"Fingerprints are a valuable tool for detecting duplicate payment methods by identifying if a payment method has been seen before. This capability, in turn, helps in preventing various types of misuse (e.g., exploitation of free trials, or association with known problematic accounts, which can be a form of fraud). To effectively use fingerprints for this purpose, you will need to create and maintain your own lists (e.g., blocklists of known problematic fingerprints, allowlists for trusted customers, or tracking frequently used fingerprints)."}],"\n",["$","p","p-2",{"children":"The ideal way to utilise fingerprints is by combining them with a manual capture process. While automatic capture with subsequent refunds for problematic payments is possible, manual capture based on fingerprint validation is recommended."}],"\n",["$","p","p-3",{"children":"During your manual capture workflow, after a payment was authorised:"}],"\n",["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":"Check the fingerprint status by comparing it against your maintained lists and internal business rules."}],"\n",["$","li","li-1",{"children":["If you decide to proceed with the payment (e.g., the fingerprint is not on a blocklist, or matches a trusted customer's previous payment method): ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#capture-order","target":"_blank","rel":"noreferrer","children":"Capture the order"}],"."]}],"\n",["$","li","li-2",{"children":["If you decide not to proceed with the payment (e.g., the fingerprint matches a known fraudulent fingerprint, or exhibits suspicious patterns): ","$L16b8","."]}],"\n"]}]]}] 1580:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The Network Transaction ID (NTI) is a unique identifier assigned by the card scheme (e.g., Visa or Mastercard) to a card transaction."}],"\n",["$","p","p-1",{"children":"It can be used to trace the transaction across the payment network, link recurring or instalment payments to the original authorisation, and support dispute resolution."}]]}] 1581:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object containing details of the card used for the payment."}]]}] 1582:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"ID of the saved payment method."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["The ",["$","code","code-0",{"children":"id"}]," parameter is only returned when the payment method is saved."]}]}]]}]]}] 1583:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of payment method used to pay for the order."}],"\n",["$","p","p-1",{"children":"Available values:"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":["Payment method ",["$","code","code-0",{"children":"type"}]],"className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"apple_pay"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using Apple Pay.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"card"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using their credit or debit card.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"google_pay"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using Google Pay.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"revolut_pay_card"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order via Revolut Pay using their credit or debit card.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-4",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"revolut_pay_account"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order via Revolut Pay using their Revolut account.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-5",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"sepa_direct_debit"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using SEPA Direct Debit.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 1584:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of the card."}]]}] 1585:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of card funding."}]]}] 1586:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The 2-letter country code of the country where the card was issued."}]]}] 1587:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The BIN of the card."}]]}] 1588:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The last four digits of the card number."}]]}] 1589:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The expiry date of the card in the format of MM/YY."}]]}] 158a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The name of the cardholder."}]]}] 158b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The details of the check for card payment. Only for orders with successful payments."}]]}] 158c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The authorisation code (or auth code) is a short, alphanumeric code returned by the cardholder's issuing bank to the merchant's terminal or payment gateway."}],"\n",["$","p","p-1",{"children":"It serves as confirmation that the transaction has been approved and funds are available."}]]}] 158d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Acquirer Reference Number (ARN) of the payment."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":"Only returned for refund payments made by a card."}]}]]}]]}] 158e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The date and time by which the payment must be captured."}],"\n",["$","p","p-1",{"children":"After this deadline, the authorised funds may be automatically released by the card issuer."}]]}] 158f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The hardware identifier of the Revolut Terminal device used to process the payment."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":"Only present for card-present transactions processed via Revolut Terminal."}]}]]}]]}] 1591:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A unique identifier for a payment method, always 44 characters long. This fingerprint can be used to uniquely identify various payment methods."}],"\n",["$","h1","h1-0",{"children":"Fingerprint generation"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Payment method","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","strong","strong-0",{"children":"All payment methods"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"A fingerprint is generated for all payment methods, including cards, Revolut Pay (card, account-to-account payments), Apple Pay, and Google Pay.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","strong","strong-0",{"children":"Cards (Revolut Pay & Card Gateway)"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"For cards, the fingerprint is based on the PAN. Cards processed via Revolut Pay and our card gateway will share the same fingerprint. Renewed cards (new expiry/CVV) retain the same fingerprint for efficient blocking.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","strong","strong-0",{"children":"Apple Pay & Google Pay"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Since Apple Pay and Google Pay provide us Device PANs (DPAN), the fingerprint is based on the DPAN provided by Apple/Google, not the connected card's PAN. This means that a new DPAN (and fingerprint) is generated for cards in case they are re-added to the customer's digital wallet, or added to different devices.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}],"\n",["$","h4","h4-0",{"children":"Detecting duplicate payment methods"}],"\n",["$","p","p-1",{"children":"Fingerprints are a valuable tool for detecting duplicate payment methods by identifying if a payment method has been seen before. This capability, in turn, helps in preventing various types of misuse (e.g., exploitation of free trials, or association with known problematic accounts, which can be a form of fraud). To effectively use fingerprints for this purpose, you will need to create and maintain your own lists (e.g., blocklists of known problematic fingerprints, allowlists for trusted customers, or tracking frequently used fingerprints)."}],"\n",["$","p","p-2",{"children":"The ideal way to utilise fingerprints is by combining them with a manual capture process. While automatic capture with subsequent refunds for problematic payments is possible, manual capture based on fingerprint validation is recommended."}],"\n",["$","p","p-3",{"children":"During your manual capture workflow, after a payment was authorised:"}],"\n",["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":"Check the fingerprint status by comparing it against your maintained lists and internal business rules."}],"\n",["$","li","li-1",{"children":["If you decide to proceed with the payment (e.g., the fingerprint is not on a blocklist, or matches a trusted customer's previous payment method): ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#capture-order","target":"_blank","rel":"noreferrer","children":"Capture the order"}],"."]}],"\n",["$","li","li-2",{"children":["If you decide not to proceed with the payment (e.g., the fingerprint matches a known fraudulent fingerprint, or exhibits suspicious patterns): ","$L16b9","."]}],"\n"]}]]}] 1592:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The Network Transaction ID (NTI) is a unique identifier assigned by the card scheme (e.g., Visa or Mastercard) to a card transaction."}],"\n",["$","p","p-1",{"children":"It can be used to trace the transaction across the payment network, link recurring or instalment payments to the original authorisation, and support dispute resolution."}]]}] 1593:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object containing details of a card used via Google Pay."}]]}] 1594:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"ID of the saved payment method."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["The ",["$","code","code-0",{"children":"id"}]," parameter is only returned when the payment method is saved."]}]}]]}]]}] 1595:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of payment method used to pay for the order."}],"\n",["$","p","p-1",{"children":"Available values:"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":["Payment method ",["$","code","code-0",{"children":"type"}]],"className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"apple_pay"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using Apple Pay.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"card"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using their credit or debit card.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"google_pay"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using Google Pay.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"revolut_pay_card"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order via Revolut Pay using their credit or debit card.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-4",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"revolut_pay_account"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order via Revolut Pay using their Revolut account.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-5",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"sepa_direct_debit"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using SEPA Direct Debit.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 1596:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of the card."}]]}] 1597:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of card funding."}]]}] 1598:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The 2-letter country code of the country where the card was issued."}]]}] 1599:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The BIN of the card."}]]}] 159a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The last four digits of the card number."}]]}] 159b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The expiry date of the card in the format of MM/YY."}]]}] 159c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The name of the cardholder."}]]}] 159d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The details of the check for card payment. Only for orders with successful payments."}]]}] 159e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The authorisation code (or auth code) is a short, alphanumeric code returned by the cardholder's issuing bank to the merchant's terminal or payment gateway."}],"\n",["$","p","p-1",{"children":"It serves as confirmation that the transaction has been approved and funds are available."}]]}] 159f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Acquirer Reference Number (ARN) of the payment."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":"Only returned for refund payments made by a card."}]}]]}]]}] 15a0:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The date and time by which the payment must be captured."}],"\n",["$","p","p-1",{"children":"After this deadline, the authorised funds may be automatically released by the card issuer."}]]}] 15a1:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The hardware identifier of the Revolut Terminal device used to process the payment."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":"Only present for card-present transactions processed via Revolut Terminal."}]}]]}]]}] 15a3:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A unique identifier for a payment method, always 44 characters long. This fingerprint can be used to uniquely identify various payment methods."}],"\n",["$","h1","h1-0",{"children":"Fingerprint generation"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Payment method","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","strong","strong-0",{"children":"All payment methods"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"A fingerprint is generated for all payment methods, including cards, Revolut Pay (card, account-to-account payments), Apple Pay, and Google Pay.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","strong","strong-0",{"children":"Cards (Revolut Pay & Card Gateway)"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"For cards, the fingerprint is based on the PAN. Cards processed via Revolut Pay and our card gateway will share the same fingerprint. Renewed cards (new expiry/CVV) retain the same fingerprint for efficient blocking.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","strong","strong-0",{"children":"Apple Pay & Google Pay"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Since Apple Pay and Google Pay provide us Device PANs (DPAN), the fingerprint is based on the DPAN provided by Apple/Google, not the connected card's PAN. This means that a new DPAN (and fingerprint) is generated for cards in case they are re-added to the customer's digital wallet, or added to different devices.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}],"\n",["$","h4","h4-0",{"children":"Detecting duplicate payment methods"}],"\n",["$","p","p-1",{"children":"Fingerprints are a valuable tool for detecting duplicate payment methods by identifying if a payment method has been seen before. This capability, in turn, helps in preventing various types of misuse (e.g., exploitation of free trials, or association with known problematic accounts, which can be a form of fraud). To effectively use fingerprints for this purpose, you will need to create and maintain your own lists (e.g., blocklists of known problematic fingerprints, allowlists for trusted customers, or tracking frequently used fingerprints)."}],"\n",["$","p","p-2",{"children":"The ideal way to utilise fingerprints is by combining them with a manual capture process. While automatic capture with subsequent refunds for problematic payments is possible, manual capture based on fingerprint validation is recommended."}],"\n",["$","p","p-3",{"children":"During your manual capture workflow, after a payment was authorised:"}],"\n",["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":"Check the fingerprint status by comparing it against your maintained lists and internal business rules."}],"\n",["$","li","li-1",{"children":["If you decide to proceed with the payment (e.g., the fingerprint is not on a blocklist, or matches a trusted customer's previous payment method): ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#capture-order","target":"_blank","rel":"noreferrer","children":"Capture the order"}],"."]}],"\n",["$","li","li-2",{"children":["If you decide not to proceed with the payment (e.g., the fingerprint matches a known fraudulent fingerprint, or exhibits suspicious patterns): ","$L16ba","."]}],"\n"]}]]}] 15a4:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The Network Transaction ID (NTI) is a unique identifier assigned by the card scheme (e.g., Visa or Mastercard) to a card transaction."}],"\n",["$","p","p-1",{"children":"It can be used to trace the transaction across the payment network, link recurring or instalment payments to the original authorisation, and support dispute resolution."}]]}] 15a5:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object containing details of a card used via Revolut Pay."}]]}] 15a6:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"ID of the saved payment method."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["The ",["$","code","code-0",{"children":"id"}]," parameter is only returned when the payment method is saved."]}]}]]}]]}] 15a7:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of payment method used to pay for the order."}],"\n",["$","p","p-1",{"children":"Available values:"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":["Payment method ",["$","code","code-0",{"children":"type"}]],"className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"apple_pay"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using Apple Pay.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"card"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using their credit or debit card.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"google_pay"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using Google Pay.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"revolut_pay_card"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order via Revolut Pay using their credit or debit card.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-4",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"revolut_pay_account"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order via Revolut Pay using their Revolut account.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-5",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"sepa_direct_debit"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using SEPA Direct Debit.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 15a9:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A unique identifier for a payment method, always 44 characters long. This fingerprint can be used to uniquely identify various payment methods."}],"\n",["$","h1","h1-0",{"children":"Fingerprint generation"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Payment method","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","strong","strong-0",{"children":"All payment methods"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"A fingerprint is generated for all payment methods, including cards, Revolut Pay (card, account-to-account payments), Apple Pay, and Google Pay.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","strong","strong-0",{"children":"Cards (Revolut Pay & Card Gateway)"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"For cards, the fingerprint is based on the PAN. Cards processed via Revolut Pay and our card gateway will share the same fingerprint. Renewed cards (new expiry/CVV) retain the same fingerprint for efficient blocking.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","strong","strong-0",{"children":"Apple Pay & Google Pay"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Since Apple Pay and Google Pay provide us Device PANs (DPAN), the fingerprint is based on the DPAN provided by Apple/Google, not the connected card's PAN. This means that a new DPAN (and fingerprint) is generated for cards in case they are re-added to the customer's digital wallet, or added to different devices.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}],"\n",["$","h4","h4-0",{"children":"Detecting duplicate payment methods"}],"\n",["$","p","p-1",{"children":"Fingerprints are a valuable tool for detecting duplicate payment methods by identifying if a payment method has been seen before. This capability, in turn, helps in preventing various types of misuse (e.g., exploitation of free trials, or association with known problematic accounts, which can be a form of fraud). To effectively use fingerprints for this purpose, you will need to create and maintain your own lists (e.g., blocklists of known problematic fingerprints, allowlists for trusted customers, or tracking frequently used fingerprints)."}],"\n",["$","p","p-2",{"children":"The ideal way to utilise fingerprints is by combining them with a manual capture process. While automatic capture with subsequent refunds for problematic payments is possible, manual capture based on fingerprint validation is recommended."}],"\n",["$","p","p-3",{"children":"During your manual capture workflow, after a payment was authorised:"}],"\n",["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":"Check the fingerprint status by comparing it against your maintained lists and internal business rules."}],"\n",["$","li","li-1",{"children":["If you decide to proceed with the payment (e.g., the fingerprint is not on a blocklist, or matches a trusted customer's previous payment method): ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#capture-order","target":"_blank","rel":"noreferrer","children":"Capture the order"}],"."]}],"\n",["$","li","li-2",{"children":["If you decide not to proceed with the payment (e.g., the fingerprint matches a known fraudulent fingerprint, or exhibits suspicious patterns): ","$L16bb","."]}],"\n"]}]]}] 15aa:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"ID of the saved payment method."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["The ",["$","code","code-0",{"children":"id"}]," parameter is only returned when the payment method is saved for the merchant."]}]}]]}]]}] 15ab:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of payment method used to pay for the order."}],"\n",["$","p","p-1",{"children":"Available values:"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":["Payment method ",["$","code","code-0",{"children":"type"}]],"className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"apple_pay"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using Apple Pay.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"card"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using their credit or debit card.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"google_pay"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using Google Pay.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"revolut_pay_card"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order via Revolut Pay using their credit or debit card.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-4",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"revolut_pay_account"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order via Revolut Pay using their Revolut account.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-5",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"sepa_direct_debit"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using SEPA Direct Debit.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 15ac:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The last four digits of the debtor's IBAN."}]]}] 15ad:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The full name of the debtor as provided in the mandate."}]]}] 15ae:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The unique mandate reference generated by Revolut. Include this in pre-debit notifications sent to your customers."}]]}] 15af:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object containing details of a SEPA Direct Debit payment."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/accept-payments/payment-methods/sepa-direct-debit/server-to-server","target":"_blank","rel":"noreferrer","children":"SEPA Direct Debit server-to-server integration"}]]}]}]]}]]}] 15b0:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The details of the payment method used to make the payment."}]]}] 15b1:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Type of the authentication challenge the payment triggers."}]]}] 15b2:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The URL of the authentication challenge."}]]}] 15b3:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Information about the 3DS challenge."}]]}] 15b4:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Type of the authentication challenge the payment triggers."}]]}] 15b5:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The URL of the fingerprint. (Used only internally by Revolut.)"}]]}] 15b6:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Data about the fingerprint used for authentication. (Used only internally\nby Revolut.)"}]]}] 15b7:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Information about the 3DS fingerprint challenge."}]]}] 15b8:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["Details about the authentication challenge that should be performed to complete the authentication process. For more information about Revolut's 3DS solution, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/reference/3d-secure","target":"_blank","rel":"noreferrer","children":"3D Secure overview"}],"."]}],"\n",["$","p","p-1",{"children":["Only returned if the payment's state is ",["$","code","code-0",{"children":"authentication_challenge"}],"."]}]]}] 15b9:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Street line 1 information."}]]}] 15ba:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Street line 2 information."}]]}] 15bb:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The region associated with the address."}]]}] 15bc:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The city associated with the address."}]]}] 15bd:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The 2-letter country code of the country associated with the address."}]]}] 15be:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The postcode associated with the address."}]]}] 15bf:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object containing address details."}]]}] 15c0:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The risk level of the card."}],"\n",["$","p","p-1",{"children":["If the risk level is ",["$","code","code-0",{"children":"high"}],", the payment might be declined."]}]]}] 15c1:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of the order fee."}]]}] 15c2:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The amount of the payment fee (minor currency unit). For example, enter ",["$","code","code-0",{"children":"7034"}]," for €70.34 in the field."]}]]}] 15c3:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The currency of the payment fee. ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_4217","target":"_blank","rel":"noreferrer","children":"ISO 4217"}]," currency code in upper case."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information about the supported currencies, see: ",["$","a","a-0",{"href":"https://help.revolut.com/business/help/merchant-accounts/payments/in-which-currencies-can-i-accept-payments/","target":"_blank","rel":"noreferrer","children":"Help Center"}],"."]}]}]]}]]}] 15c4:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The details of the order fee."}]]}] 15c5:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The email of the person who made the payment."}]]}] 15c6:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The phone number of the payer in ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/E.164","target":"_blank","rel":"noreferrer","children":"E.164 format"}],"."]}]]}] 15c7:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The person who made the payment. This object is present when an email or phone number is provided during the payment flow."}],"\n",["$","p","p-1",{"children":"Capturing payer details lets you identify exactly who authorised the charge, reach the right person for receipts or refund queries, and support compliance or fraud-review workflows where the paying identity matters."}]]}] 15c8:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Represents a payment for an order."}],"\n",["$","p","p-1",{"children":["For pre-authorised payments, the ",["$","code","code-0",{"children":"authorised_amount"}]," field tracks the currently authorised amount, which may differ from ",["$","code","code-1",{"children":"amount"}]," during incremental authorisation processing."]}]]}] 15c9:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The details of all the payments that have been made towards this order (successful or unsuccessful)."}]]}] 15ca:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The new total amount requested in this increment (in minor units)."}]]}] 15cb:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The previously authorised amount before this increment (in minor units)."}]]}] 15cc:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The state of this incremental authorization attempt."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"State","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"pending"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Increment registered in system, not yet submitted to card network","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"processing"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Increment is being processed by card network","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"authorised"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Increment was successfully authorised","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"declined"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Increment was declined by card issuer","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-4",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"failed"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Increment failed due to technical error (not an issuer decline)","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 15cd:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"External reference for this incremental authorisation."}],"\n",["$","div","inlinealert-0",{"data-type":"tip","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"Lightbulb","color":"var(--rui-color-success)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":"Use your internal charge or invoice ID. This reference is returned in webhooks for easy matching to your system."}]}]]}]]}] 15ce:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Name of the line item."}]]}] 15cf:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Type of the line item."}]]}] 15d0:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The number of units of the line item."}]]}] 15d1:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The measurement unit for the quantity, such as ",["$","code","code-0",{"children":"cm"}],", or ",["$","code","code-1",{"children":"kg"}],"."]}]]}] 15d2:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object representing the quantity details of a line item, including the amount and its associated unit of measurement."}]]}] 15d3:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The unit price of the line item."}]]}] 15d4:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The total amount to be paid for the line item, including taxes and discounts."}]]}] 15d5:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unique identifier of line item in the merchant's system."}]]}] 15d6:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The specific name or label of the discount applied to the line item."}]]}] 15d7:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The monetary value of the discount."}]]}] 15d8:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Details of a discount applied to the line item, including its name and monetary value."}]]}] 15d9:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A list of discounts applied to the line item. Each discount should be subtracted from the total amount payable for the item."}]]}] 15da:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The specific name or designation of the tax applied to the line item."}]]}] 15db:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The monetary value of the tax in minor currency units (e.g., cents for EUR)."}]]}] 15dc:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Details about a tax applied to the line item, including its name and the corresponding amount."}]]}] 15dd:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A list of taxes applied to the line item. Each tax should be added to the total amount payable for the item."}]]}] 15de:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"URL to an image associated with the line item."}],"\n",["$","div","inlinealert-0",{"data-type":"warning","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMark","color":"var(--rui-color-warning)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"Restrictions:"}],["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["Must be a valid URI as defined by ",["$","a","a-0",{"href":"https://datatracker.ietf.org/doc/html/rfc3986","target":"_blank","rel":"noreferrer","children":"RFC 3986"}]]}],"\n",["$","li","li-1",{"children":["URI scheme is required and must be either ",["$","code","code-0",{"children":"http"}]," or ",["$","code","code-1",{"children":"https"}]]}],"\n",["$","li","li-2",{"children":["URI host is required and cannot be ",["$","code","code-0",{"children":"localhost"}]," or an IP address"]}],"\n",["$","li","li-3",{"children":["Max length: ",["$","code","code-0",{"children":"2000"}]]}],"\n",["$","li","li-4",{"children":["Reserved or invalid characters must be percent-encoded (for example, use ",["$","code","code-0",{"children":"%20"}]," instead of a space)"]}],"\n"]}]]}]]}]]}] 15df:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A list of URLs pointing to images related to the line item. These images can provide visual details or representations of the item."}]]}] 15e0:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Description of the line item."}]]}] 15e1:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An HTTP/HTTPS URL that links to more information about the line item, such as a product page or details."}],"\n",["$","div","inlinealert-0",{"data-type":"warning","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMark","color":"var(--rui-color-warning)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"Restrictions:"}],["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["Must be a valid URI as defined by ",["$","a","a-0",{"href":"https://datatracker.ietf.org/doc/html/rfc3986","target":"_blank","rel":"noreferrer","children":"RFC 3986"}]]}],"\n",["$","li","li-1",{"children":["URI scheme is required and must be either ",["$","code","code-0",{"children":"http"}]," or ",["$","code","code-1",{"children":"https"}]]}],"\n",["$","li","li-2",{"children":["URI host is required and cannot be ",["$","code","code-0",{"children":"localhost"}]," or an IP address"]}],"\n",["$","li","li-3",{"children":["Max length: ",["$","code","code-0",{"children":"2000"}]]}],"\n",["$","li","li-4",{"children":["Reserved or invalid characters must be percent-encoded (for example, use ",["$","code","code-0",{"children":"%20"}]," instead of a space)"]}],"\n"]}]]}]]}]]}] 15e2:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Line items associated with this increment (if provided)."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":"If the increment is successful, these line items will override the existing order line items."}]}]]}]]}] 15e3:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Reason why increment was declined or failed."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["Only present when ",["$","code","code-0",{"children":"state"}]," is ",["$","code","code-1",{"children":"declined"}]," or ",["$","code","code-2",{"children":"failed"}],"."]}]}]]}]]}] 15e4:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Represents a single incremental authorisation attempt on an order."}],"\n",["$","p","p-1",{"children":["The ",["$","code","code-0",{"children":"incremental_authorisations"}]," array tracks all increment attempts (successful and failed) in chronological order."]}]]}] 15e5:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"History of incremental authorisation attempts for this order."}],"\n",["$","p","p-1",{"children":["Only present for orders with ",["$","code","code-0",{"children":"authorisation_type: pre_authorisation"}],"."]}],"\n",["$","p","p-2",{"children":"Contains all increment attempts in chronological order."}]]}] 15e6:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unique ID representing the location where merchants sells products."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#tag-locations","target":"_blank","rel":"noreferrer","children":"Locations"}],"."]}]}]]}]]}] 15e7:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Additional metadata value provided with the corresponding metadata key."}]]}] 15e8:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["Additional information to track your orders in your system, by providing custom metadata using ",["$","code","code-0",{"children":"\"\" : \"\""}]," pairs."]}],"\n",["$","div","inlinealert-0",{"data-type":"warning","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMark","color":"var(--rui-color-warning)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":["$","strong","strong-0",{"children":"Restrictions:"}]}],["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["Both keys and values must be ",["$","code","code-0",{"children":"string"}],"s"]}],"\n",["$","li","li-1",{"children":["Values cannot be ",["$","code","code-0",{"children":"null"}],"."]}],"\n",["$","li","li-2",{"children":["Max number of key-value pairs: ",["$","code","code-0",{"children":"50"}]]}],"\n",["$","li","li-3",{"children":["Max length of values: ",["$","code","code-0",{"children":"500"}]," characters"]}],"\n",["$","li","li-4",{"children":["Format of keys: Must start with a letter and contain only letters, digits, and underscores. Max 40 characters. Pattern: ",["$","code","code-0",{"children":"^[a-zA-Z][a-zA-Z\\\\d_]{0,39}$"}]]}],"\n"]}]]}]]}]]}] 15ea:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Type of the industry-specific data object, determining what additional data is expected."}],"\n",["$","p","p-1",{"children":"Available types:"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Object type","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"airline"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about a specific airline ticket purchase.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"car_rental"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about a car rental booking associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"crypto"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about crypto transactions associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"marketplace"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["This object is required by Mastercard and Visa for merchants operating as marketplaces under the ",["$","strong","strong-0",{"children":"Merchant Category Code (MCC):"}]," ",["$","code","code-0",{"children":"5262"}],". The marketplace object ensures compliance with the card schemes' regulations by providing detailed information about the subseller involved in the transaction."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-4",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"event"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about event ticket bookings associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-5",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"lodging"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about lodging bookings associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 15eb:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A unique identifier provided by the merchant associated with the order."}],"\n",["$","p","p-1",{"children":["This ",["$","code","code-0",{"children":"booking_id"}]," is used to reference and correlate booking information with the Merchant API and the merchant's internal system."]}]]}] 15ec:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The UTC date and time of the final journey leg."}],"\n",["$","div","inlinealert-0",{"data-type":"warning","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMark","color":"var(--rui-color-warning)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"The following limitations apply:"}],["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["When creating or updating an order, ",["$","code","code-0",{"children":"fulfillment_date"}]," cannot be set to a date in the past."]}],"\n",["$","li","li-1",{"children":["When updating an order, if the current ",["$","code","code-0",{"children":"fulfillment_date"}]," value is already in the past, it cannot be modified. The date must remain as is to maintain data integrity for completed transactions."]}],"\n"]}]]}]]}]]}] 15ed:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["Flag indicating whether the order includes actual ticket purchases. Set to ",["$","code","code-0",{"children":"true"}]," if the order contains ticket purchases, and ",["$","code","code-1",{"children":"false"}]," if it does not (e.g., it ",["$","strong","strong-0",{"children":"only"}]," contains seat reservations, or baggage upgrades)."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":["This field is required for activating ",["$","strong","strong-0",{"children":"Revolut Flight Alerts"}]," functionalities within the Revolut app."]}],["$","p","p-1",{"children":"Provide the info on order creation or update, before capturing the order."}]]}]]}]]}] 15ee:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of the ticket."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Parameter value","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"fixed"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Non-modifiable once confirmed.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"flexible"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Allows modifications or cancellations under specified conditions.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 15ef:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The code of the Computer Reservation System (CRS) used to make the booking and purchase the ticket."}]]}] 15f0:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Parameter indicating whether this order is related to a new ticket reservation or a modification of an existing one."}]]}] 15f1:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Parameter indicating whether the booking is refundable, partially refundable, or not refundable."}]]}] 15f2:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Passenger's first name."}]]}] 15f3:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Passenger's last name."}]]}] 15f4:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Array containing information of passengers associated with the booking."}]]}] 15f5:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Sequence of the journey legs. Increment by 1 for each flight included in the ticket."}],"\n",["$","p","p-1",{"children":["For example: For a ",["$","code","code-0",{"children":"FRA > LHR > DUB > LHR > FRA"}]," journey the sequence will be assigned as:"]}],"\n",["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":[["$","code","code-0",{"children":"FRA > LHR"}],": 1"]}],"\n",["$","li","li-1",{"children":[["$","code","code-0",{"children":"LHR > DUB"}],": 2"]}],"\n",["$","li","li-2",{"children":[["$","code","code-0",{"children":"DUB > LHR"}],": 3"]}],"\n",["$","li","li-3",{"children":[["$","code","code-0",{"children":"LHR > FRA"}],": 4"]}],"\n"]}]]}] 15f6:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://www.iata.org/en/services/codes","target":"_blank","rel":"noreferrer","children":"IATA"}]," 3-letter airport code for the departure airport."]}]]}] 15f7:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://www.iata.org/en/services/codes","target":"_blank","rel":"noreferrer","children":"IATA"}]," 3-letter airport code for the arrival airport."]}]]}] 15f8:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The flight identifier, without airline code."}]]}] 15f9:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The fare base code for the given journey leg."}]]}] 15fa:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The UTC date and time of the flight departure for the given journey leg."}]]}] 15fb:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The name of the airline associated with the journey leg."}]]}] 15fc:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The IATA 2-letter accounting code identifying the airline associated with the journey leg."}]]}] 15fd:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The Passenger Name Record (PNR) for the journey leg issued by the airline."}],"\n",["$","p","p-1",{"children":"PNR is a unique identifier for the booking, acting as a digital certificate allowing passengers to retrieve or manage their booking details."}],"\n",["$","div","inlinealert-0",{"data-type":"warning","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMark","color":"var(--rui-color-warning)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":"This is a required field for OTAs."}]}]]}]]}] 15fe:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Array containing information of journey legs associated with the booking."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":["This field is required for activating ",["$","strong","strong-0",{"children":"Revolut Flight Alerts"}]," functionalities within the Revolut app."]}],["$","p","p-1",{"children":"This information is used to compile a tracking widget that provides real-time updates on flight status and sends notifications, such as a check-in reminders, boarding alerts, and notifications for cancellations or delays."}],["$","p","p-2",{"children":"To enable the widget the following fields are required on order creation or update, before capturing the order:"}],"$L16bc"]}]]}]]}] 15ff:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"URL to the online portal for managing the airline booking, which includes check-in functionality. This URL may be a personalised, pre-populated check-in link specific to the user or a generic link, and it is essential for enabling direct access to booking details within the Revolut app."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":["This field is required for activating ",["$","strong","strong-0",{"children":"Revolut Flight Alerts"}]," functionalities within the Revolut app."]}],["$","p","p-1",{"children":"Provide the info on order creation or update, before capturing the order."}]]}]]}],"\n",["$","div","inlinealert-1",{"data-type":"warning","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMark","color":"var(--rui-color-warning)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"Restrictions:"}],["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["Must be a valid URI as defined by ",["$","a","a-0",{"href":"https://datatracker.ietf.org/doc/html/rfc3986","target":"_blank","rel":"noreferrer","children":"RFC 3986"}]]}],"\n",["$","li","li-1",{"children":["URI scheme is required and must be either ",["$","code","code-0",{"children":"http"}]," or ",["$","code","code-1",{"children":"https"}]]}],"\n",["$","li","li-2",{"children":["URI host is required and cannot be ",["$","code","code-0",{"children":"localhost"}]," or an IP address"]}],"\n",["$","li","li-3",{"children":["Max length: ",["$","code","code-0",{"children":"2000"}]]}],"\n",["$","li","li-4",{"children":["Reserved or invalid characters must be percent-encoded (for example, use ",["$","code","code-0",{"children":"%20"}]," instead of a space)"]}],"\n"]}]]}]]}]]}] 1600:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object containing additional information about an airline booking associated with the order."}],"\n",["$","p","p-1",{"children":["Use this object to provide required data to enable ",["$","strong","strong-0",{"children":"Revolut Flight Alerts"}],". This feature allows users to receive real-time flight updates such as check-in reminders, boarding alerts, and notifications for cancellations or delays in the Revolut app."]}],"\n",["$","p","p-2",{"children":["To enable ",["$","strong","strong-0",{"children":"Revolut Flight Alerts"}]," functionalities in the Revolut app, the following fields are ",["$","strong","strong-1",{"children":"required"}]," on order creation or update, before capturing the order:"]}],"\n","$L16bd","\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"These are the specific data field requirements for merchants who must provide airline data. Note that these requirements can be extended on a case by case basis as decided by Revolut."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Required for airline/charter merchants","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Required for OTA merchants","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","ul","ul-0",{"children":[["$","li","li-0",{"children":["$","code","code-0",{"children":"booking_id"}]}],["$","li","li-1",{"children":["$","code","code-0",{"children":"fulfillment_date"}]}],["$","li","li-2",{"children":["$","code","code-0",{"children":"passengers[].first_name"}]}],["$","li","li-3",{"children":["$","code","code-0",{"children":"passengers[].last_name"}]}],["$","li","li-4",{"children":["$","code","code-0",{"children":"journey_legs[].pnr"}]}],["$","li","li-5",{"children":["$","code","code-0",{"children":"journey_legs[].sequence"}]}],["$","li","li-6",{"children":["$","code","code-0",{"children":"journey_legs[].flight_number"}]}],["$","li","li-7",{"children":["$","code","code-0",{"children":"journey_legs[].travel_date"}]}],["$","li","li-8",{"children":["$","code","code-0",{"children":"journey_legs[].airline_code"}]}],["$","li","li-9",{"children":["$","code","code-0",{"children":"journey_legs[].departure_airport_code"}]}],["$","li","li-10",{"children":["$","code","code-0",{"children":"journey_legs[].arrival_airport_code"}]}]]}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["$","ul","ul-0",{"children":[["$","li","li-0",{"children":["$","code","code-0",{"children":"booking_id"}]}],["$","li","li-1",{"children":["$","code","code-0",{"children":"fulfillment_date"}]}],["$","li","li-2",{"children":["$","code","code-0",{"children":"passengers[].first_name"}]}],["$","li","li-3",{"children":["$","code","code-0",{"children":"passengers[].last_name"}]}],["$","li","li-4",{"children":["$","code","code-0",{"children":"journey_legs[].pnr"}]}],["$","li","li-5",{"children":["$","code","code-0",{"children":"journey_legs[].arrival_airport_code"}]}]]}],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt3","ref":"$undefined"}]]}]}]]}]]}]]}] 1601:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Type of the industry-specific data object, determining what additional data is expected."}],"\n",["$","p","p-1",{"children":"Available types:"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Object type","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"airline"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about a specific airline ticket purchase.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"car_rental"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about a car rental booking associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"crypto"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about crypto transactions associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"marketplace"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["This object is required by Mastercard and Visa for merchants operating as marketplaces under the ",["$","strong","strong-0",{"children":"Merchant Category Code (MCC):"}]," ",["$","code","code-0",{"children":"5262"}],". The marketplace object ensures compliance with the card schemes' regulations by providing detailed information about the subseller involved in the transaction."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-4",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"event"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about event ticket bookings associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-5",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"lodging"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about lodging bookings associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 1602:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A unique identifier provided by the merchant associated with the order."}],"\n",["$","p","p-1",{"children":["This ",["$","code","code-0",{"children":"booking_id"}]," is used to reference and correlate booking information with the Merchant API and the merchant's internal system."]}]]}] 1603:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The UTC date and time of the pick-up."}]]}] 1604:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object containing address details."}]]}] 1605:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The UTC date and time of the drop-off."}]]}] 1606:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object containing address details."}]]}] 1607:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Parameter indicating whether the booking is refundable, partially refundable, or not refundable."}]]}] 1608:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The maximum distance allowed."}]]}] 1609:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The unit of distance."}]]}] 160a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The amount of the cost in minor currency units. For example, enter ",["$","code","code-0",{"children":"7034"}]," for €70.34."]}]]}] 160b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":[["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_4217","target":"_blank","rel":"noreferrer","children":"ISO 4217"}]," currency code in upper case."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information about the supported currencies, see: ",["$","a","a-0",{"href":"https://help.revolut.com/business/help/merchant-accounts/payments/in-which-currencies-can-i-accept-payments/","target":"_blank","rel":"noreferrer","children":"Help Center"}],"."]}]}]]}]]}] 160c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Cost for exceeding the distance limit."}]]}] 160d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object containing distance limit information."}]]}] 160e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object containing additional information about a car rental booking associated with the order."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"These are the specific data field requirements for merchants offering car rental. Note that these requirements can be extended on a case by case basis as decided by Revolut."}],"$L16be"]}]]}]]}] 160f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Type of the industry-specific data object, determining what additional data is expected."}],"\n",["$","p","p-1",{"children":"Available types:"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Object type","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"airline"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about a specific airline ticket purchase.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"car_rental"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about a car rental booking associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"crypto"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about crypto transactions associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"marketplace"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["This object is required by Mastercard and Visa for merchants operating as marketplaces under the ",["$","strong","strong-0",{"children":"Merchant Category Code (MCC):"}]," ",["$","code","code-0",{"children":"5262"}],". The marketplace object ensures compliance with the card schemes' regulations by providing detailed information about the subseller involved in the transaction."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-4",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"event"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about event ticket bookings associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-5",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"lodging"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about lodging bookings associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 1610:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The public transaction hash of the crypto transaction."}]]}] 1611:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The status of the crypto transaction."}]]}] 1612:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The wallet ID of the recipient."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["At least one of the parameters: ",["$","code","code-0",{"children":"recipient_user_id"}]," or ",["$","code","code-1",{"children":"recipient_wallet_id"}]," is required."]}]}]]}]]}] 1613:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The user ID of the recipient."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["At least one of the parameters: ",["$","code","code-0",{"children":"recipient_user_id"}]," or ",["$","code","code-1",{"children":"recipient_wallet_id"}]," is required."]}]}]]}]]}] 1614:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Array of crypto transaction data associated with the order."}]]}] 1615:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["A string representing the four-digit ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/Merchant_category_code","target":"_blank","rel":"noreferrer","children":"Merchant Category Code (MCC)"}]," of the conversion affiliate."]}]]}] 1616:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The ID of the seller in the merchant's internal system."}]]}] 1617:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The business or legal name of the seller."}]]}] 1618:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The URL of the website of the seller."}],"\n",["$","div","inlinealert-0",{"data-type":"warning","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMark","color":"var(--rui-color-warning)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"Restrictions:"}],["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["Must be a valid URI as defined by ",["$","a","a-0",{"href":"https://datatracker.ietf.org/doc/html/rfc3986","target":"_blank","rel":"noreferrer","children":"RFC 3986"}]]}],"\n",["$","li","li-1",{"children":["URI scheme is required and must be either ",["$","code","code-0",{"children":"http"}]," or ",["$","code","code-1",{"children":"https"}]]}],"\n",["$","li","li-2",{"children":["URI host is required and cannot be ",["$","code","code-0",{"children":"localhost"}]," or an IP address"]}],"\n",["$","li","li-3",{"children":["Max length: ",["$","code","code-0",{"children":"255"}]]}],"\n",["$","li","li-4",{"children":["Reserved or invalid characters must be percent-encoded (for example, use ",["$","code","code-0",{"children":"%20"}]," instead of a space)"]}],"\n"]}]]}]]}]]}] 1619:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The phone number of the seller."}]]}] 161a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Primary address line."}]]}] 161b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Secondary address line, such as floor and apartment number."}]]}] 161c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"State or province of the address."}]]}] 161d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"City of the address."}]]}] 161e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"ISO 2-letter country code."}]]}] 161f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The subdivision code represents the state, province, or region within the country, following the ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_3166-2","target":"_blank","rel":"noreferrer","children":"ISO 3166-2"}]," standard. This code uniquely identifies subdivisions within a country."]}],"\n",["$","p","p-1",{"children":["For example, for London in the United Kingdom, use ",["$","code","code-0",{"children":"GB-LND"}],"."]}],"\n",["$","div","inlinealert-0",{"data-type":"warning","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMark","color":"var(--rui-color-warning)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["The parameter is required for countries listed on the ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_3166-2","target":"_blank","rel":"noreferrer","children":"ISO 3166-2"}]," page."]}]}]]}]]}] 1620:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Postal code of the address."}]]}] 1621:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Details of a physical address."}]]}] 1622:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Information about the crypto conversion affiliate."}],"\n",["$","p","p-1",{"children":"This should be provided when a customer completes a payment on a subseller's website rather than directly on the merchant's website, providing insight into the type of business conducted by the subseller."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"This needs to be provided only by crypto on-ramp providers for payments they are processing for conversion affiliates."}],["$","p","p-1",{"children":["For their own payments, ",["$","code","code-0",{"children":"seller"}]," can be omitted."]}]]}]]}]]}] 1623:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object containing information about crypto transactions associated with the order."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"Processing crypto on-ramp transactions with Revolut has additional compliance requirements. Please reach out to your account executive for additional details."}],["$","p","p-1",{"children":["$","strong","strong-0",{"children":"Required data fields for crypto services:"}]}],"$L16bf",["$","p","p-2",{"children":"Note that these requirements can be extended on a case by case basis as decided by Revolut."}]]}]]}]]}] 1624:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Type of the industry-specific data object, determining what additional data is expected."}],"\n",["$","p","p-1",{"children":"Available types:"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Object type","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"airline"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about a specific airline ticket purchase.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"car_rental"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about a car rental booking associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"crypto"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about crypto transactions associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"marketplace"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["This object is required by Mastercard and Visa for merchants operating as marketplaces under the ",["$","strong","strong-0",{"children":"Merchant Category Code (MCC):"}]," ",["$","code","code-0",{"children":"5262"}],". The marketplace object ensures compliance with the card schemes' regulations by providing detailed information about the subseller involved in the transaction."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-4",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"event"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about event ticket bookings associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-5",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"lodging"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about lodging bookings associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 1625:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The ID of the seller in the merchant's internal system."}]]}] 1626:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The business or legal name of the seller."}]]}] 1627:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The URL of the website of the seller."}],"\n",["$","div","inlinealert-0",{"data-type":"warning","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMark","color":"var(--rui-color-warning)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"Restrictions:"}],["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["Must be a valid URI as defined by ",["$","a","a-0",{"href":"https://datatracker.ietf.org/doc/html/rfc3986","target":"_blank","rel":"noreferrer","children":"RFC 3986"}]]}],"\n",["$","li","li-1",{"children":["URI scheme is required and must be either ",["$","code","code-0",{"children":"http"}]," or ",["$","code","code-1",{"children":"https"}]]}],"\n",["$","li","li-2",{"children":["URI host is required and cannot be ",["$","code","code-0",{"children":"localhost"}]," or an IP address"]}],"\n",["$","li","li-3",{"children":["Max length: ",["$","code","code-0",{"children":"255"}]]}],"\n",["$","li","li-4",{"children":["Reserved or invalid characters must be percent-encoded (for example, use ",["$","code","code-0",{"children":"%20"}]," instead of a space)"]}],"\n"]}]]}]]}]]}] 1628:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The phone number of the seller."}]]}] 1629:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Details of a physical address."}]]}] 162a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Information about the subseller on the marketplace platform."}]]}] 162b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["This object is required by Mastercard and Visa for merchants operating as marketplaces under the Merchant Category Code (MCC) ",["$","code","code-0",{"children":"5262"}],". The marketplace object ensures compliance with the card schemes' regulations by providing detailed information about the seller involved in the transaction."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"These are the specific data field requirements for merchants who must provide marketplace data."}],"$L16c0"]}]]}]]}] 162c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Type of the industry-specific data object, determining what additional data is expected."}],"\n",["$","p","p-1",{"children":"Available types:"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Object type","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"airline"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about a specific airline ticket purchase.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"car_rental"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about a car rental booking associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"crypto"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about crypto transactions associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"marketplace"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["This object is required by Mastercard and Visa for merchants operating as marketplaces under the ",["$","strong","strong-0",{"children":"Merchant Category Code (MCC):"}]," ",["$","code","code-0",{"children":"5262"}],". The marketplace object ensures compliance with the card schemes' regulations by providing detailed information about the subseller involved in the transaction."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-4",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"event"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about event ticket bookings associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-5",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"lodging"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about lodging bookings associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 162d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A unique identifier provided by the merchant associated with the order."}],"\n",["$","p","p-1",{"children":["This ",["$","code","code-0",{"children":"booking_id"}]," is used to reference and correlate booking information with the Merchant API and the merchant's internal system."]}]]}] 162e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":[["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_8601","target":"_blank","rel":"noreferrer","children":"ISO 8601"}]," date and time when the event starts."]}]]}] 162f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":[["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_8601","target":"_blank","rel":"noreferrer","children":"ISO 8601"}]," date and time when the event ends."]}]]}] 1630:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Legal name of the ticket vendor/event organiser."}]]}] 1631:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":[["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_8601","target":"_blank","rel":"noreferrer","children":"ISO 8601"}]," date and time when the funds are released to merchants."]}]]}] 1632:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The name of the event."}]]}] 1633:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Primary address line."}]]}] 1634:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Secondary address line, such as floor and apartment number."}]]}] 1635:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"State or province of the address."}]]}] 1636:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"City of the address."}]]}] 1637:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"ISO 2-letter country code."}]]}] 1638:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Postal code of the address."}]]}] 1639:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The address of the event location."}]]}] 163a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of the event."}]]}] 163b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Indicates the relationship between the ticket vendor and the event organiser."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Parameter value","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"primary"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The merchant is the organiser and primary distributor of the tickets.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"secondary"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The merchant is a reseller, only distributing the tickets.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 163c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A unique identifier provided by the merchant associated with the ticket."}]]}] 163d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Indicates whether the ticket is transferable to another buyer."}]]}] 163e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Parameter indicating whether the booking is refundable, partially refundable, or not refundable."}]]}] 163f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object containing information about a ticket associated with the booking."}]]}] 1640:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A list of tickets associated with the booking."}]]}] 1641:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object containing booking information about a specific event."}]]}] 1642:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A list of events associated with the booking."}]]}] 1643:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object containing booking information for a list of event tickets associated with the order."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"These are the specific data field requirements for merchants who must provide event data. Note that these requirements can be extended on a case by case basis as decided by Revolut."}],"$L16c1"]}]]}]]}] 1644:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Type of the industry-specific data object, determining what additional data is expected."}],"\n",["$","p","p-1",{"children":"Available types:"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Object type","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"airline"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about a specific airline ticket purchase.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"car_rental"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about a car rental booking associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"crypto"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about crypto transactions associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"marketplace"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["This object is required by Mastercard and Visa for merchants operating as marketplaces under the ",["$","strong","strong-0",{"children":"Merchant Category Code (MCC):"}]," ",["$","code","code-0",{"children":"5262"}],". The marketplace object ensures compliance with the card schemes' regulations by providing detailed information about the subseller involved in the transaction."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-4",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"event"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about event ticket bookings associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-5",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"lodging"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about lodging bookings associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 1645:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A unique identifier provided by the merchant associated with the order."}],"\n",["$","p","p-1",{"children":["This ",["$","code","code-0",{"children":"booking_id"}]," is used to reference and correlate booking information with the Merchant API and the merchant's internal system."]}]]}] 1646:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":[["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_8601","target":"_blank","rel":"noreferrer","children":"ISO 8601"}]," date and time of the check-in."]}]]}] 1647:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":[["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_8601","target":"_blank","rel":"noreferrer","children":"ISO 8601"}]," date and time of the check-out."]}]]}] 1648:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":[["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_8601","target":"_blank","rel":"noreferrer","children":"ISO 8601"}]," date and time when the funds are released to merchants."]}]]}] 1649:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of the accommodation associated with the booking."}]]}] 164a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Indicates whether the booking terms are fixed or flexible."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Parameter value","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"fixed"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Non-modifiable once confirmed.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"flexible"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Allows modifications or cancellations under specified conditions.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 164b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Parameter indicating whether the booking is refundable, partially refundable, or not refundable."}]]}] 164c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Primary address line."}]]}] 164d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Secondary address line, such as floor and apartment number."}]]}] 164e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"State or province of the address."}]]}] 164f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"City of the address."}]]}] 1650:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"ISO 2-letter country code."}]]}] 1651:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Postal code of the address."}]]}] 1652:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Address of the accommodation."}]]}] 1653:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Guest's first name."}]]}] 1654:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Guest's last name."}]]}] 1655:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"List of guests associated with the booking."}]]}] 1656:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object containing details of a lodging booking."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"These are the specific data field requirements for merchants who must provide lodging data. Note that these requirements can be extended on a case by case basis as decided by Revolut."}],"$L16c2"]}]]}]]}] 1657:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object containing industry-specific information associated with the order."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"In the following cases, industry-specific info is required. Omitting this information may trigger additional scrutiny and risk mitigation actions by the Revolut risk team."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Transaction type","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Required for","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"airline"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Airlines and Online Travel Agencies (OTAs).","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"car_rental"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Car Rental Merchants and Online Travel Agencies (OTAs).","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"crypto"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Crypto merchants.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"marketplace"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Marketplace merchants.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-4",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"event"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Event ticket sellers.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-5",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"lodging"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Lodging providers.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}]]}]]}] 1658:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The URL of the order stored in the merchant's order management system."}],"\n",["$","p","p-1",{"children":["This URL will be included in the order confirmation email for payments made via Revolut Pay. If specified, this URL will override the default link to the merchant's ",["$","strong","strong-0",{"children":"Business website"}]," configured in the Revolut Business account."]}],"\n",["$","div","inlinealert-0",{"data-type":"warning","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMark","color":"var(--rui-color-warning)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"Restrictions:"}],["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["Must be a valid URI as defined by ",["$","a","a-0",{"href":"https://datatracker.ietf.org/doc/html/rfc3986","target":"_blank","rel":"noreferrer","children":"RFC 3986"}]]}],"\n",["$","li","li-1",{"children":["URI scheme is required and must be either ",["$","code","code-0",{"children":"http"}]," or ",["$","code","code-1",{"children":"https"}]]}],"\n",["$","li","li-2",{"children":["URI host is required and cannot be ",["$","code","code-0",{"children":"localhost"}]," or an IP address"]}],"\n",["$","li","li-3",{"children":["Max length: ",["$","code","code-0",{"children":"2000"}]]}],"\n",["$","li","li-4",{"children":["Reserved or invalid characters must be percent-encoded (for example, use ",["$","code","code-0",{"children":"%20"}]," instead of a space)"]}],"\n"]}]]}]]}]]}] 1659:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Merchant order ID for external reference."}],"\n",["$","p","p-1",{"children":"Use this field to set the ID that your own system can use to easily track orders."}]]}] 165a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object for providing additional information stored in the merchant's order management system."}]]}] 165b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The date and time in ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_8601","target":"_blank","rel":"noreferrer","children":"ISO 8601 format"}]," when the upcoming payment is scheduled to be executed."]}]]}] 165c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The unique ID of the customer's payment method used to complete the scheduled payment."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"For more information about operations related to customer's payment methods, see:"}],["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#retrieve-payment-method-list","target":"_blank","rel":"noreferrer","children":"Retrieve payment method list of a customer"}]}],"\n",["$","li","li-1",{"children":["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#retrieve-payment-method","target":"_blank","rel":"noreferrer","children":"Retrieve a customer's payment method"}]}],"\n",["$","li","li-2",{"children":["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#update-payment-method","target":"_blank","rel":"noreferrer","children":"Update a customer's payment method"}]}],"\n",["$","li","li-3",{"children":["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#delete-payment-method","target":"_blank","rel":"noreferrer","children":"Delete a customer's payment method"}]}],"\n"]}]]}]]}]]}] 165d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object containing information about upcoming payments associated with the order."}]]}] 165e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Link to a checkout page hosted by Revolut."}]]}] 165f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The URL your customer will be redirected to after a successful payment on the hosted checkout page (",["$","code","code-0",{"children":"checkout_url"}]," parameter's value of the order)."]}],"\n",["$","div","inlinealert-0",{"data-type":"warning","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMark","color":"var(--rui-color-warning)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"Restrictions:"}],["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["Must be a valid URI as defined by ",["$","a","a-0",{"href":"https://datatracker.ietf.org/doc/html/rfc3986","target":"_blank","rel":"noreferrer","children":"RFC 3986"}]]}],"\n",["$","li","li-1",{"children":["URI scheme is required and must be either ",["$","code","code-0",{"children":"http"}]," or ",["$","code","code-1",{"children":"https"}]]}],"\n",["$","li","li-2",{"children":["URI host is required and cannot be ",["$","code","code-0",{"children":"localhost"}]," or an IP address"]}],"\n",["$","li","li-3",{"children":["Max length: ",["$","code","code-0",{"children":"2000"}]]}],"\n",["$","li","li-4",{"children":["Reserved or invalid characters must be percent-encoded (for example, use ",["$","code","code-0",{"children":"%20"}]," instead of a space)"]}],"\n"]}]]}]]}],"\n",["$","div","inlinealert-1",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information on how to use the ",["$","code","code-0",{"children":"redirect_url"}],", see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/accept-payments/online-payments/hosted-checkout-page/api#custom-post-payment-redirection-optional","target":"_blank","rel":"noreferrer","children":"Custom redirection via the API"}]]}]}]]}]]}] 1660:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Primary address line."}]]}] 1661:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Secondary address line, such as floor and apartment number."}]]}] 1662:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"State or province of the address."}]]}] 1663:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"City of the address."}]]}] 1664:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"ISO 2-letter country code."}]]}] 1665:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Postal code of the address."}]]}] 1666:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Details of a physical address."}]]}] 1667:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Full name of the contact person."}]]}] 1668:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Email address of the contact person."}]]}] 1669:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Phone number of the contact person."}]]}] 166a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Contact details for someone responsible for the shipment."}],"\n",["$","div","inlinealert-0",{"data-type":"warning","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMark","color":"var(--rui-color-warning)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["At least ",["$","code","code-0",{"children":"email"}]," or ",["$","code","code-1",{"children":"phone"}]," is required."]}]}]]}]]}] 166b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Name of the company handling the shipment."}]]}] 166c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unique tracking number for the shipment."}]]}] 166d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Estimated delivery date and time for the shipment.\nThe time should also include the customer's timezone."}]]}] 166e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An HTTP/HTTPS URL where the shipment can be tracked."}],"\n",["$","div","inlinealert-0",{"data-type":"warning","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMark","color":"var(--rui-color-warning)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"Restrictions:"}],["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["Must be a valid URI as defined by ",["$","a","a-0",{"href":"https://datatracker.ietf.org/doc/html/rfc3986","target":"_blank","rel":"noreferrer","children":"RFC 3986"}]]}],"\n",["$","li","li-1",{"children":["URI scheme is required and must be either ",["$","code","code-0",{"children":"http"}]," or ",["$","code","code-1",{"children":"https"}]]}],"\n",["$","li","li-2",{"children":["URI host is required and cannot be ",["$","code","code-0",{"children":"localhost"}]," or an IP address"]}],"\n",["$","li","li-3",{"children":["Max length: ",["$","code","code-0",{"children":"2000"}]]}],"\n",["$","li","li-4",{"children":["Reserved or invalid characters must be percent-encoded (for example, use ",["$","code","code-0",{"children":"%20"}]," instead of a space)"]}],"\n"]}]]}]]}]]}] 166f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Details of an individual shipment."}]]}] 1670:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"List of individual shipment details."}]]}] 1671:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Details about the shipping related to the order, including address, contact information, and individual shipments."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":"Required for merchants shipping physical goods. Omitting this information may trigger additional scrutiny and risk mitigation actions by Revolut."}]}]]}]]}] 1672:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The enforce challenge mode. ",["$","code","code-0",{"children":"automatic"}]," is used by default."]}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Parameter value","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"automatic"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The payments created for an order will have challenge requirement calculated by our fraud mechanisms. Not all payments will trigger a 3DS challenge.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"forced"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The payments created for an order will always require a 3DS challenge. Currently only supported for card payments.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 1673:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An array of line items included in the order. Each line item represents an individual product or service, along with its quantity, price, taxes, and discounts."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":"Required for merchants collecting payment for one or multiple products/services in one transaction. Omitting this information may trigger additional scrutiny and risk mitigation actions by Revolut."}]}]]}]]}] 1675:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"You can set a dynamic statement descriptor for your orders by providing a custom suffix."}],"\n",["$","p","p-1",{"children":"A statement descriptor is the text shown on cardholders' bank or card statements, helping them recognise a transaction or merchant. This field can be used to send extra information with the statement descriptor for card transactions."}],"\n",["$","p","p-2",{"children":["The complete descriptor is built using the following format: ",["$","code","code-0",{"children":"{base}*{suffix}"}],", where:"]}],"\n",["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":[["$","strong","strong-0",{"children":["$","code","code-0",{"children":"{base}"}]}]," is the existing descriptor configured in the Revolut Business dashboard (",["$","strong","strong-1",{"children":"Settings > Business account > Merchant profile > Statement descriptor"}],")."]}],"\n",["$","li","li-1",{"children":[["$","strong","strong-0",{"children":["$","code","code-0",{"children":"{suffix}"}]}]," is defined by the ",["$","code","code-0",{"children":"statement_descriptor_suffix"}]," field."]}],"\n"]}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["If the combined descriptor's length (base + suffix) exceeds the character limits of card scheme providers, the final value will be truncated. For example if the limit is 22 characters, the base descriptor is ",["$","code","code-0",{"children":"\"base\""}]," and the suffix is ",["$","code","code-1",{"children":"\"testdescriptorsuffix\""}],", the final descriptor becomes ",["$","code","code-2",{"children":"\"base*testdescriptorsuf\""}],"."]}],"\n",["$","li","li-1",{"children":"The final statement descriptor shown on a cardholder's statement may vary by issuing bank, as some banks apply their own custom formatting or truncation rules."}],"\n"]}]}]]}]]}] 1676:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The unique ID of the original order that was refunded and this refund is associated with. You can use this ID to get more information about the related order using the ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#retrieve-order","target":"_blank","rel":"noreferrer","children":"Retrieve an order"}]," operation."]}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["This field is only returned for orders with ",["$","code","code-0",{"children":"type: refund"}],"."]}]}]]}]]}] 1677:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unique identifier for the subscription."}]]}] 1678:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The unique identifier of the active (pre-paid) subscription cycle that this order collects payment for."}],"\n",["$","p","p-1",{"children":"This is the current billing cycle whose recurring charges are being collected in advance by this order. For example, if a subscription cycle covers 1-31 July and the order is generated on 1 July, this field identifies that July cycle."}]]}] 1679:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The unique identifier of the settled (post-paid) subscription cycle whose usage-based charges this order collects."}],"\n",["$","p","p-1",{"children":"This is the previous billing cycle whose usage is being settled by this order. For example, if a subscription cycle covers usage from 1-30 June and the order is generated on 10 July, this field identifies that June cycle."}]]}] 167a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The reason this subscription order was created."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Value","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"cycle_billing"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["The order was automatically generated to collect payment for an ongoing subscription cycle. ",["$","code","code-0",{"children":"active_cycle_id"}]," is present; ",["$","code","code-1",{"children":"settled_cycle_id"}]," is present if the previous cycle included usage-based products."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"final_settlement"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["The order was automatically generated after the subscription ended to collect outstanding usage-based charges. ",["$","code","code-0",{"children":"active_cycle_id"}]," is absent; ",["$","code","code-1",{"children":"settled_cycle_id"}]," is present."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"setup_intent"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["The order was manually created by the merchant or customer to update the payment method on file. ",["$","code","code-0",{"children":"active_cycle_id"}]," is absent; ",["$","code","code-1",{"children":"settled_cycle_id"}]," is absent."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 167b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Subscription details linked to the order. Use this object to match an order with its underlying subscription and understand the billing context in which the order was created."}],"\n",["$","p","p-1",{"children":"Only present on orders created by a subscription."}]]}] 167c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["To process the order from a credit or debit card, you create an ",["$","code","code-0",{"children":"Order"}]," object. You can then retrieve, capture, cancel, refund, or pay an order using its unique ",["$","code","code-1",{"children":"id"}],". Alternatively, you can use its unique ",["$","code","code-2",{"children":"token"}]," to process a card payment with the Revolut Checkout Widget."]}]]}] 167d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Refund order successfully created"}]]}] 167e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An identifier that can be used to determine what went wrong."}],"\n",["$","p","p-1",{"children":"Error codes are not globally unique, but uniqueness is guaranteed within endpoints."}]]}] 167f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Some human readable text describing what went wrong."}]]}] 1680:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://www.unixtimestamp.com/","target":"_blank","rel":"noreferrer","children":"UNIX timestamp"}]," of the date and time the error happened."]}]]}] 1681:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Bad Request"}]]}] 1682:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An identifier that can be used to determine what went wrong."}],"\n",["$","p","p-1",{"children":"Error codes are not globally unique, but uniqueness is guaranteed within endpoints."}]]}] 1683:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Some human readable text describing what went wrong."}]]}] 1684:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://www.unixtimestamp.com/","target":"_blank","rel":"noreferrer","children":"UNIX timestamp"}]," of the date and time the error happened."]}]]}] 1685:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unauthorized"}]]}] 1686:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An identifier that can be used to determine what went wrong."}],"\n",["$","p","p-1",{"children":"Error codes are not globally unique, but uniqueness is guaranteed within endpoints."}]]}] 1687:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Some human readable text describing what went wrong."}]]}] 1688:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://www.unixtimestamp.com/","target":"_blank","rel":"noreferrer","children":"UNIX timestamp"}]," of the date and time the error happened."]}]]}] 1689:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Not Found"}]]}] 168a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An identifier that can be used to determine what went wrong."}],"\n",["$","p","p-1",{"children":"Error codes are not globally unique, but uniqueness is guaranteed within endpoints."}]]}] 168b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Some human readable text describing what went wrong."}]]}] 168c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://www.unixtimestamp.com/","target":"_blank","rel":"noreferrer","children":"UNIX timestamp"}]," of the date and time the error happened."]}]]}] 168d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unprocessable Entity"}]]}] 168e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The amount to be refunded, specified in the smallest currency unit (e.g., cents for USD, pence for GBP)."}]]}] 168f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":[["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_4217","target":"_blank","rel":"noreferrer","children":"ISO 4217"}]," currency code in upper case."]}],"\n",["$","p","p-1",{"children":["$","strong","strong-0",{"children":["Must match the ",["$","code","code-0",{"children":"currency"}]," of the original order to be refunded."]}]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information about the supported currencies, see: ",["$","a","a-0",{"href":"https://help.revolut.com/business/help/merchant-accounts/payments/in-which-currencies-can-i-accept-payments/","target":"_blank","rel":"noreferrer","children":"Help Center"}],"."]}]}]]}]]}] 1690:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Merchant order ID for external reference."}],"\n",["$","p","p-1",{"children":"Use this field to set the ID that your own system can use to easily track orders."}]]}] 1691:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object for providing additional information stored in the merchant's order management system."}]]}] 1692:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Additional metadata value provided with the corresponding metadata key."}]]}] 1693:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["Additional information to track your orders in your system, by providing custom metadata using ",["$","code","code-0",{"children":"\"\" : \"\""}]," pairs."]}],"\n",["$","div","inlinealert-0",{"data-type":"warning","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMark","color":"var(--rui-color-warning)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":["$","strong","strong-0",{"children":"Restrictions:"}]}],["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["Both keys and values must be ",["$","code","code-0",{"children":"string"}],"s"]}],"\n",["$","li","li-1",{"children":["Values cannot be ",["$","code","code-0",{"children":"null"}],"."]}],"\n",["$","li","li-2",{"children":["Max number of key-value pairs: ",["$","code","code-0",{"children":"50"}]]}],"\n",["$","li","li-3",{"children":["Max length of values: ",["$","code","code-0",{"children":"500"}]," characters"]}],"\n",["$","li","li-4",{"children":["Format of keys: Must start with a letter and contain only letters, digits, and underscores. Max 40 characters. Pattern: ",["$","code","code-0",{"children":"^[a-zA-Z][a-zA-Z\\\\d_]{0,39}$"}]]}],"\n"]}]]}]]}]]}] 1694:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An optional, user-facing description for the refund. This may be displayed to the customer."}]]}] 1695:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The request body for creating a refund order."}]]}] 1699:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Issue a refund for a completed order. This operation allows for either a full or partial refund, which will be processed back to the customer's original payment method."}],"\n",["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["The refund operation generates a new order with ",["$","code","code-0",{"children":"type: refund"}],". This new order represents a full or partial refund of the original amount paid."]}],"\n",["$","li","li-1",{"children":"Multiple partial refunds can be issued for a single order, given the total refunded amount does not exceed the original order amount."}],"\n",["$","li","li-2",{"children":["Refund orders will contain ",["$","code","code-0",{"children":"related_order_id"}]," which links to the original order that was refunded."]}],"\n",["$","li","li-3",{"children":["Refunds can only be initiated for orders that are in a ",["$","code","code-0",{"children":"completed"}]," state. Orders in any other state are not eligible for refunds to ensure transaction integrity and to prevent errors."]}],"\n"]}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["Consider using the ",["$","code","code-0",{"children":"Idempotency-Key"}]," header to make the refund operation idempotent, preventing duplicate refund processing in cases of multiple submissions."]}]}]]}],"\n",["$","div","inlinealert-1",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information see our ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/operations/refunds","target":"_blank","rel":"noreferrer","children":"Refund payments"}]," guide."]}]}]]}]]}] 169a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["This parameter accepts the ",["$","a","a-0",{"href":"https://business.revolut.com/settings/apis?tab=merchant-api","target":"_blank","rel":"noreferrer","children":"Merchant API Secret key"}]," to authorise requests coming from the merchant's backend."]}],"\n",["$","p","p-1",{"children":["It ensures that ensures that each request is authenticated and authorised by verifying the secret key. The secret key should be included in all request headers as a ",["$","code","code-0",{"children":"Bearer"}]," token."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#authentication","target":"_blank","rel":"noreferrer","children":"Authentication"}]]}]}]]}]]}] 169b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The version of the Merchant API, specified in ",["$","code","code-0",{"children":"YYYY-MM-DD"}]," format."]}],"\n",["$","p","p-1",{"children":"If not specified, you will receive an error."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information about API versioning, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/reference/versioning/api-versions","target":"_blank","rel":"noreferrer","children":"API versions"}],"."]}]}]]}]]}] 169c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","code","code-0",{"children":"Idempotency-Key"}]," ensures that requests are processed only once, preventing multiple executions of the same operation due to retries or duplicate requests."]}],"\n",["$","p","p-1",{"children":"This header is optional and can accept any unique string value the merchant uses."}],"\n",["$","p","p-2",{"children":"A recommended practice is to use a unique identifier from your system (such as the entity's ID or a request UUID) as the idempotency key. This facilitates tracking and managing requests effectively."}]]}] 169d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A UUID string, typically used to identify resources."}]]}] 169e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ID of the ",["$","code","code-0",{"children":"Order"}]," object."]}]]}] 16b7:["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#cancel-order","target":"_blank","rel":"noreferrer","children":"Cancel the order"}] 16b8:["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#cancel-order","target":"_blank","rel":"noreferrer","children":"Cancel the order"}] 16b9:["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#cancel-order","target":"_blank","rel":"noreferrer","children":"Cancel the order"}] 16ba:["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#cancel-order","target":"_blank","rel":"noreferrer","children":"Cancel the order"}] 16bb:["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#cancel-order","target":"_blank","rel":"noreferrer","children":"Cancel the order"}] 16ae:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Each Merchant API request must contain an authorization header in the following format:"}],"\n","$L16c3","\n",["$","p","p-1",{"children":"To use this API, you need to generate API keys from your Revolut Business account. The Secret key is used in the authorization header for all server calls, while the Public key is provided with payment methods at checkout."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For detailed instructions on generating your API keys, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/get-started#generate-api-keys","target":"_blank","rel":"noreferrer","children":"Generate API keys"}],"."]}]}]]}]]}] 16af:["$","div","request-application/json-refund_with_minimal_params",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"
{\n  \"amount\": 100,\n  \"currency\": \"GBP\"\n}
"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"amount\": 100,\n \"currency\": \"GBP\"\n}"}]}]]}] 16c4:T9a3,
{
  "amount": 100,
  "currency": "GBP",
  "description": "Example refund description",
  "merchant_order_data": {
    "reference": "example_order_reference_123456"
  },
  "metadata": {
    "example_metadata_1": "Example metadata value 1",
    "example_metadata_2": "Example metadata value 2"
  }
}
16b0:["$","div","request-application/json-refund_with_additional_params",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$16c4"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"amount\": 100,\n \"currency\": \"GBP\",\n \"description\": \"Example refund description\",\n \"merchant_order_data\": {\n \"reference\": \"example_order_reference_123456\"\n },\n \"metadata\": {\n \"example_metadata_1\": \"Example metadata value 1\",\n \"example_metadata_2\": \"Example metadata value 2\"\n }\n}"}]}]]}] 16c5:T2cc6,
{
  "id": "6852e9a6-5cf0-ac65-8182-6a9c251011ce",
  "type": "refund",
  "state": "processing",
  "created_at": "2025-06-18T16:30:30.792962Z",
  "updated_at": "2025-06-18T16:30:30.954966Z",
  "amount": 100,
  "currency": "GBP",
  "outstanding_amount": 100,
  "capture_mode": "automatic",
  "authorisation_type": "final",
  "payments": [
    {
      "id": "6852e9a6-ca77-a25d-b0be-83191db96e68",
      "state": "refund_validated",
      "created_at": "2025-06-18T16:30:30.821411Z",
      "updated_at": "2025-06-18T16:30:31.391153Z",
      "amount": 100,
      "currency": "GBP",
      "settled_amount": -100,
      "settled_currency": "GBP",
      "billing_address": {
        "country_code": "GB",
        "postcode": "E14 4HD"
      },
      "risk_level": "low",
      "fees": [],
      "payer": {
        "email": "example.payer@example.com",
        "phone": "+447911123456"
      },
      "payment_method": {
        "type": "card",
        "fingerprint": "1JAllfQY4POhBV8DaddAQ4LC5RbMP8LMLvUdJW4s5JY=",
        "network_transaction_id": "1234567890123456",
        "card_brand": "visa",
        "funding": "credit",
        "card_country_code": "GB",
        "card_bin": "123456",
        "card_last_four": "1234",
        "card_expiry": "12/33",
        "cardholder_name": "Example Holder"
      }
    }
  ],
  "enforce_challenge": "automatic",
  "related_order_id": "6852e963-d6a9-a5a4-9609-50b3addc5425"
}
16b1:["$","div","201-application/json-refund_with_minimal_params",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$16c5"}}]}]],"$L16c6"]}] 16c7:T341b,
{
  "id": "6852dd1f-32e1-a7ca-81c5-66e0dbc85122",
  "type": "refund",
  "state": "processing",
  "created_at": "2025-06-18T15:37:03.410996Z",
  "updated_at": "2025-06-18T15:37:07.691537Z",
  "amount": 100,
  "currency": "GBP",
  "outstanding_amount": 0,
  "capture_mode": "automatic",
  "authorisation_type": "final",
  "description": "Example refund description",
  "metadata": {
    "example_metadata_1": "Example metadata value 1",
    "example_metadata_2": "Example metadata value 2"
  },
  "payments": [
    {
      "id": "6852dd1f-25df-a855-9481-f5405a03da67",
      "state": "refund_validated",
      "created_at": "2025-06-18T15:37:03.557842Z",
      "updated_at": "2025-06-18T15:37:07.794313Z",
      "amount": 100,
      "currency": "GBP",
      "settled_amount": -100,
      "settled_currency": "GBP",
      "billing_address": {
        "street_line_1": "123 Example Street",
        "street_line_2": "Example City 123456",
        "city": "SentinelFraudLow",
        "country_code": "GB",
        "postcode": "AB1 C23"
      },
      "risk_level": "low",
      "fees": [],
      "payer": {
        "email": "example.payer@example.com",
        "phone": "+447911123456"
      },
      "payment_method": {
        "type": "revolut_pay_account",
        "fingerprint": "1JAllfQY4POhBV8DaddAQ4LC5RbMP8LMLvUdJW4s5JY="
      }
    }
  ],
  "enforce_challenge": "automatic",
  "related_order_id": "6852dc49-b522-a7a2-89e0-09da07982e90",
  "customer": {
    "id": "03e12eee-ea3c-4282-bb61-221517c47882",
    "email": "example.customer@example.com",
    "phone": "+441234567890",
    "full_name": "Example Customer",
    "date_of_birth": "1990-01-01"
  },
  "merchant_order_data": {
    "reference": "example_order_reference_123456"
  }
}
16b2:["$","div","201-application/json-refund_with_additional_params",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$16c7"}}]}]],"$L16c8"]}] 16c9:T46a,
{
  "code": "bad_request",
  "message": "Could not parse JSON",
  "timestamp": 1750265245422
}
16b3:["$","div","400-application/json-default",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$16c9"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"code\": \"bad_request\",\n \"message\": \"Could not parse JSON\",\n \"timestamp\": 1750265245422\n}"}]}]]}] 16ca:T46f,
{
  "code": "unauthenticated",
  "message": "Authentication failed",
  "timestamp": 1750265245422
}
16b4:["$","div","401-application/json-default",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$16ca"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"code\": \"unauthenticated\",\n \"message\": \"Authentication failed\",\n \"timestamp\": 1750265245422\n}"}]}]]}] 16cb:T494,
{
  "code": "not_found",
  "message": "Order with id 6852e963-0009-a5a4-9609-50b3addc5425 was not found",
  "timestamp": 1750265369820
}
16b5:["$","div","404-application/json-default",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$16cb"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"code\": \"not_found\",\n \"message\": \"Order with id 6852e963-0009-a5a4-9609-50b3addc5425 was not found\",\n \"timestamp\": 1750265369820\n}"}]}]]}] 16cc:T44d,
{
  "code": "string",
  "message": "string",
  "timestamp": 123
}
16b6:["$","div","422-application/json-default",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$16cc"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"code\": \"string\",\n \"message\": \"string\",\n \"timestamp\": 123\n}"}]}]]}] 16cd:T584,{ "id": "6852e9a6-5cf0-ac65-8182-6a9c251011ce", "type": "refund", "state": "processing", "created_at": "2025-06-18T16:30:30.792962Z", "updated_at": "2025-06-18T16:30:30.954966Z", "amount": 100, "currency": "GBP", "outstanding_amount": 100, "capture_mode": "automatic", "authorisation_type": "final", "payments": [ { "id": "6852e9a6-ca77-a25d-b0be-83191db96e68", "state": "refund_validated", "created_at": "2025-06-18T16:30:30.821411Z", "updated_at": "2025-06-18T16:30:31.391153Z", "amount": 100, "currency": "GBP", "settled_amount": -100, "settled_currency": "GBP", "billing_address": { "country_code": "GB", "postcode": "E14 4HD" }, "risk_level": "low", "fees": [], "payer": { "email": "example.payer@example.com", "phone": "+447911123456" }, "payment_method": { "type": "card", "fingerprint": "1JAllfQY4POhBV8DaddAQ4LC5RbMP8LMLvUdJW4s5JY=", "network_transaction_id": "1234567890123456", "card_brand": "visa", "funding": "credit", "card_country_code": "GB", "card_bin": "123456", "card_last_four": "1234", "card_expiry": "12/33", "cardholder_name": "Example Holder" } } ], "enforce_challenge": "automatic", "related_order_id": "6852e963-d6a9-a5a4-9609-50b3addc5425" }16c6:["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"$16cd"}]}] 16ce:T6cd,{ "id": "6852dd1f-32e1-a7ca-81c5-66e0dbc85122", "type": "refund", "state": "processing", "created_at": "2025-06-18T15:37:03.410996Z", "updated_at": "2025-06-18T15:37:07.691537Z", "amount": 100, "currency": "GBP", "outstanding_amount": 0, "capture_mode": "automatic", "authorisation_type": "final", "description": "Example refund description", "metadata": { "example_metadata_1": "Example metadata value 1", "example_metadata_2": "Example metadata value 2" }, "payments": [ { "id": "6852dd1f-25df-a855-9481-f5405a03da67", "state": "refund_validated", "created_at": "2025-06-18T15:37:03.557842Z", "updated_at": "2025-06-18T15:37:07.794313Z", "amount": 100, "currency": "GBP", "settled_amount": -100, "settled_currency": "GBP", "billing_address": { "street_line_1": "123 Example Street", "street_line_2": "Example City 123456", "city": "SentinelFraudLow", "country_code": "GB", "postcode": "AB1 C23" }, "risk_level": "low", "fees": [], "payer": { "email": "example.payer@example.com", "phone": "+447911123456" }, "payment_method": { "type": "revolut_pay_account", "fingerprint": "1JAllfQY4POhBV8DaddAQ4LC5RbMP8LMLvUdJW4s5JY=" } } ], "enforce_challenge": "automatic", "related_order_id": "6852dc49-b522-a7a2-89e0-09da07982e90", "customer": { "id": "03e12eee-ea3c-4282-bb61-221517c47882", "email": "example.customer@example.com", "phone": "+441234567890", "full_name": "Example Customer", "date_of_birth": "1990-01-01" }, "merchant_order_data": { "reference": "example_order_reference_123456" } }16c8:["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"$16ce"}]}] 16bc:["$","div","CodeBlock-0",{"className":"wzy01m0 _18b50nc0","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"
sequence,\ndeparture_airport_code,\narrival_airport_code,\nflight_number,\ntravel_date,\nairline_name,\nairline_code,
"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"sequence,\ndeparture_airport_code,\narrival_airport_code,\nflight_number,\ntravel_date,\nairline_name,\nairline_code,\n"}]}]]}] 16bd:["$","div","CodeBlock-0",{"className":"wzy01m0 _18b50nc0","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"
tickets_purchase,\njourney_legs,\nbooking_url
"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"tickets_purchase,\njourney_legs,\nbooking_url\n"}]}]]}] 16be:["$","div","CodeBlock-0",{"className":"wzy01m0 _18b50nc0","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"
booking_id\ndrop_off_date\nrefundability
"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"booking_id\ndrop_off_date\nrefundability\n"}]}]]}] 16bf:["$","div","CodeBlock-0",{"className":"wzy01m0 _18b50nc0","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"
transactions[].id\ntransactions[].status\ntransactions[].recipient_wallet_id\nseller.id\nseller.name\nseller.website\nseller.phone\nseller.address\nseller.mcc\ncustomer.full_name\ncustomer.date_of_birth
"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"transactions[].id\ntransactions[].status\ntransactions[].recipient_wallet_id\nseller.id\nseller.name\nseller.website\nseller.phone\nseller.address\nseller.mcc\ncustomer.full_name\ncustomer.date_of_birth\n"}]}]]}] 16c0:["$","div","CodeBlock-0",{"className":"wzy01m0 _18b50nc0","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"
seller.id\nseller.name\nseller.website\nseller.phone\nseller.address
"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"seller.id\nseller.name\nseller.website\nseller.phone\nseller.address\n"}]}]]}] 16c1:["$","div","CodeBlock-0",{"className":"wzy01m0 _18b50nc0","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"
booking_id\nevents[].start_date\nevents[].end_date\nevents[].supplier\nevents[].tickets[].id
"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"booking_id\nevents[].start_date\nevents[].end_date\nevents[].supplier\nevents[].tickets[].id\n"}]}]]}] 16c2:["$","div","CodeBlock-0",{"className":"wzy01m0 _18b50nc0","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"
booking_id\ncheck_in_date\ncheck_out_date\nsupplier_payment_date
"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"booking_id\ncheck_in_date\ncheck_out_date\nsupplier_payment_date\n"}]}]]}] 16c3:["$","div","CodeBlock-0",{"className":"wzy01m0 _18b50nc0","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"
'Authorization: Bearer <yourSecretApiKey>'
"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"'Authorization: Bearer '\n"}]}]]}] 16d8:T4c1,Automatic cancellation period for uncaptured orders, specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. After this period, the authorised payment is automatically cancelled and the order is cancelled. Maximum: 7 days = `P7D`. :::note The following limitations apply: - Cannot be a negative value. - Cannot be updated if the new value is less than or equal to the elapsed time since authorisation. **Failing scenario:** - Original value: 7 days - Time since authorisation: 3 days - Update value: 2 days In this scenario, an error is returned. **Successful scenario:** - Original value: 7 days - Time since authorisation: 3 days - Update value: 4 days In this scenario, the parameter can be updated. - Cannot be updated if cancellation is ≤ 30 minutes away. **Failing scenario:** - Original value: 12 hours - Time since authorisation: 11 hours 40 minutes In this scenario, an error is returned. **Successful scenario:** - Original value: 12 hours - Time since authorisation: 11 hours 20 minutes In this scenario, the parameter can be updated. :::16df:T50a,Object containing information about a customer. If you have it, we strongly advise providing at least either `id`, `phone`, or `email`. Using the [Customers operations](https://developer.revolut.com/docs/api/merchant#tag-customers), you can manage customer instances. The following behaviours apply to different use cases: | Use case | API behavior | | -------- | ------------ | | Existing customer | If `id` was provided, we ignore other customer details and associate the customer with the order.

If either `email`, `phone`, or `full_name` was provided (without an existing customer's `id`), we always create a new customer, irrespective of another, existing customer object having the same details. | | New customer | If either `email`, `phone`, or `full_name` was provided, we create a new customer, irrespective of another customer object having the same details.

If `id` of a non-existent customer was provided, we return a `404` error, irrespective of other details provided. | :::note To avoid unintentional duplication of customer records, search for an existing customer by email or phone using the [List customers](https://developer.revolut.com/docs/api/merchant#retrieve-customer-list) endpoint first, then provide `customer.id` in the order. :::1708:T9bc,A unique identifier for a payment method, always 44 characters long. This fingerprint can be used to uniquely identify various payment methods. #### Fingerprint generation | Payment method | Description | | -------- | ----------- | | **All payment methods** | A fingerprint is generated for all payment methods, including cards, Revolut Pay (card, account-to-account payments), Apple Pay, and Google Pay. | | **Cards (Revolut Pay & Card Gateway)** | For cards, the fingerprint is based on the PAN. Cards processed via Revolut Pay and our card gateway will share the same fingerprint. Renewed cards (new expiry/CVV) retain the same fingerprint for efficient blocking. | | **Apple Pay & Google Pay** | Since Apple Pay and Google Pay provide us Device PANs (DPAN), the fingerprint is based on the DPAN provided by Apple/Google, not the connected card's PAN. This means that a new DPAN (and fingerprint) is generated for cards in case they are re-added to the customer's digital wallet, or added to different devices. | #### Detecting duplicate payment methods Fingerprints are a valuable tool for detecting duplicate payment methods by identifying if a payment method has been seen before. This capability, in turn, helps in preventing various types of misuse (e.g., exploitation of free trials, or association with known problematic accounts, which can be a form of fraud). To effectively use fingerprints for this purpose, you will need to create and maintain your own lists (e.g., blocklists of known problematic fingerprints, allowlists for trusted customers, or tracking frequently used fingerprints). The ideal way to utilise fingerprints is by combining them with a manual capture process. While automatic capture with subsequent refunds for problematic payments is possible, manual capture based on fingerprint validation is recommended. During your manual capture workflow, after a payment was authorised: - Check the fingerprint status by comparing it against your maintained lists and internal business rules. - If you decide to proceed with the payment (e.g., the fingerprint is not on a blocklist, or matches a trusted customer's previous payment method): [Capture the order](https://developer.revolut.com/docs/api/merchant#capture-order). - If you decide not to proceed with the payment (e.g., the fingerprint matches a known fraudulent fingerprint, or exhibits suspicious patterns): [Cancel the order](https://developer.revolut.com/docs/api/merchant#cancel-order).171a:T9bc,A unique identifier for a payment method, always 44 characters long. This fingerprint can be used to uniquely identify various payment methods. #### Fingerprint generation | Payment method | Description | | -------- | ----------- | | **All payment methods** | A fingerprint is generated for all payment methods, including cards, Revolut Pay (card, account-to-account payments), Apple Pay, and Google Pay. | | **Cards (Revolut Pay & Card Gateway)** | For cards, the fingerprint is based on the PAN. Cards processed via Revolut Pay and our card gateway will share the same fingerprint. Renewed cards (new expiry/CVV) retain the same fingerprint for efficient blocking. | | **Apple Pay & Google Pay** | Since Apple Pay and Google Pay provide us Device PANs (DPAN), the fingerprint is based on the DPAN provided by Apple/Google, not the connected card's PAN. This means that a new DPAN (and fingerprint) is generated for cards in case they are re-added to the customer's digital wallet, or added to different devices. | #### Detecting duplicate payment methods Fingerprints are a valuable tool for detecting duplicate payment methods by identifying if a payment method has been seen before. This capability, in turn, helps in preventing various types of misuse (e.g., exploitation of free trials, or association with known problematic accounts, which can be a form of fraud). To effectively use fingerprints for this purpose, you will need to create and maintain your own lists (e.g., blocklists of known problematic fingerprints, allowlists for trusted customers, or tracking frequently used fingerprints). The ideal way to utilise fingerprints is by combining them with a manual capture process. While automatic capture with subsequent refunds for problematic payments is possible, manual capture based on fingerprint validation is recommended. During your manual capture workflow, after a payment was authorised: - Check the fingerprint status by comparing it against your maintained lists and internal business rules. - If you decide to proceed with the payment (e.g., the fingerprint is not on a blocklist, or matches a trusted customer's previous payment method): [Capture the order](https://developer.revolut.com/docs/api/merchant#capture-order). - If you decide not to proceed with the payment (e.g., the fingerprint matches a known fraudulent fingerprint, or exhibits suspicious patterns): [Cancel the order](https://developer.revolut.com/docs/api/merchant#cancel-order).172c:T9bc,A unique identifier for a payment method, always 44 characters long. This fingerprint can be used to uniquely identify various payment methods. #### Fingerprint generation | Payment method | Description | | -------- | ----------- | | **All payment methods** | A fingerprint is generated for all payment methods, including cards, Revolut Pay (card, account-to-account payments), Apple Pay, and Google Pay. | | **Cards (Revolut Pay & Card Gateway)** | For cards, the fingerprint is based on the PAN. Cards processed via Revolut Pay and our card gateway will share the same fingerprint. Renewed cards (new expiry/CVV) retain the same fingerprint for efficient blocking. | | **Apple Pay & Google Pay** | Since Apple Pay and Google Pay provide us Device PANs (DPAN), the fingerprint is based on the DPAN provided by Apple/Google, not the connected card's PAN. This means that a new DPAN (and fingerprint) is generated for cards in case they are re-added to the customer's digital wallet, or added to different devices. | #### Detecting duplicate payment methods Fingerprints are a valuable tool for detecting duplicate payment methods by identifying if a payment method has been seen before. This capability, in turn, helps in preventing various types of misuse (e.g., exploitation of free trials, or association with known problematic accounts, which can be a form of fraud). To effectively use fingerprints for this purpose, you will need to create and maintain your own lists (e.g., blocklists of known problematic fingerprints, allowlists for trusted customers, or tracking frequently used fingerprints). The ideal way to utilise fingerprints is by combining them with a manual capture process. While automatic capture with subsequent refunds for problematic payments is possible, manual capture based on fingerprint validation is recommended. During your manual capture workflow, after a payment was authorised: - Check the fingerprint status by comparing it against your maintained lists and internal business rules. - If you decide to proceed with the payment (e.g., the fingerprint is not on a blocklist, or matches a trusted customer's previous payment method): [Capture the order](https://developer.revolut.com/docs/api/merchant#capture-order). - If you decide not to proceed with the payment (e.g., the fingerprint matches a known fraudulent fingerprint, or exhibits suspicious patterns): [Cancel the order](https://developer.revolut.com/docs/api/merchant#cancel-order).173e:T9bc,A unique identifier for a payment method, always 44 characters long. This fingerprint can be used to uniquely identify various payment methods. #### Fingerprint generation | Payment method | Description | | -------- | ----------- | | **All payment methods** | A fingerprint is generated for all payment methods, including cards, Revolut Pay (card, account-to-account payments), Apple Pay, and Google Pay. | | **Cards (Revolut Pay & Card Gateway)** | For cards, the fingerprint is based on the PAN. Cards processed via Revolut Pay and our card gateway will share the same fingerprint. Renewed cards (new expiry/CVV) retain the same fingerprint for efficient blocking. | | **Apple Pay & Google Pay** | Since Apple Pay and Google Pay provide us Device PANs (DPAN), the fingerprint is based on the DPAN provided by Apple/Google, not the connected card's PAN. This means that a new DPAN (and fingerprint) is generated for cards in case they are re-added to the customer's digital wallet, or added to different devices. | #### Detecting duplicate payment methods Fingerprints are a valuable tool for detecting duplicate payment methods by identifying if a payment method has been seen before. This capability, in turn, helps in preventing various types of misuse (e.g., exploitation of free trials, or association with known problematic accounts, which can be a form of fraud). To effectively use fingerprints for this purpose, you will need to create and maintain your own lists (e.g., blocklists of known problematic fingerprints, allowlists for trusted customers, or tracking frequently used fingerprints). The ideal way to utilise fingerprints is by combining them with a manual capture process. While automatic capture with subsequent refunds for problematic payments is possible, manual capture based on fingerprint validation is recommended. During your manual capture workflow, after a payment was authorised: - Check the fingerprint status by comparing it against your maintained lists and internal business rules. - If you decide to proceed with the payment (e.g., the fingerprint is not on a blocklist, or matches a trusted customer's previous payment method): [Capture the order](https://developer.revolut.com/docs/api/merchant#capture-order). - If you decide not to proceed with the payment (e.g., the fingerprint matches a known fraudulent fingerprint, or exhibits suspicious patterns): [Cancel the order](https://developer.revolut.com/docs/api/merchant#cancel-order).1744:T9bc,A unique identifier for a payment method, always 44 characters long. This fingerprint can be used to uniquely identify various payment methods. #### Fingerprint generation | Payment method | Description | | -------- | ----------- | | **All payment methods** | A fingerprint is generated for all payment methods, including cards, Revolut Pay (card, account-to-account payments), Apple Pay, and Google Pay. | | **Cards (Revolut Pay & Card Gateway)** | For cards, the fingerprint is based on the PAN. Cards processed via Revolut Pay and our card gateway will share the same fingerprint. Renewed cards (new expiry/CVV) retain the same fingerprint for efficient blocking. | | **Apple Pay & Google Pay** | Since Apple Pay and Google Pay provide us Device PANs (DPAN), the fingerprint is based on the DPAN provided by Apple/Google, not the connected card's PAN. This means that a new DPAN (and fingerprint) is generated for cards in case they are re-added to the customer's digital wallet, or added to different devices. | #### Detecting duplicate payment methods Fingerprints are a valuable tool for detecting duplicate payment methods by identifying if a payment method has been seen before. This capability, in turn, helps in preventing various types of misuse (e.g., exploitation of free trials, or association with known problematic accounts, which can be a form of fraud). To effectively use fingerprints for this purpose, you will need to create and maintain your own lists (e.g., blocklists of known problematic fingerprints, allowlists for trusted customers, or tracking frequently used fingerprints). The ideal way to utilise fingerprints is by combining them with a manual capture process. While automatic capture with subsequent refunds for problematic payments is possible, manual capture based on fingerprint validation is recommended. During your manual capture workflow, after a payment was authorised: - Check the fingerprint status by comparing it against your maintained lists and internal business rules. - If you decide to proceed with the payment (e.g., the fingerprint is not on a blocklist, or matches a trusted customer's previous payment method): [Capture the order](https://developer.revolut.com/docs/api/merchant#capture-order). - If you decide not to proceed with the payment (e.g., the fingerprint matches a known fraudulent fingerprint, or exhibits suspicious patterns): [Cancel the order](https://developer.revolut.com/docs/api/merchant#cancel-order).1785:T5ef,Object containing additional information about an airline booking associated with the order. Use this object to provide required data to enable **Revolut Flight Alerts**. This feature allows users to receive real-time flight updates such as check-in reminders, boarding alerts, and notifications for cancellations or delays in the Revolut app. To enable **Revolut Flight Alerts** functionalities in the Revolut app, the following fields are **required** on order creation or update, before capturing the order: ``` tickets_purchase, journey_legs, booking_url ``` :::note These are the specific data field requirements for merchants who must provide airline data. Note that these requirements can be extended on a case by case basis as decided by Revolut. | Required for airline/charter merchants | Required for OTA merchants | | -------------------------------------- | -------------------------- | |
  • `booking_id`
  • `fulfillment_date`
  • `passengers[].first_name`
  • `passengers[].last_name`
  • `journey_legs[].pnr`
  • `journey_legs[].sequence`
  • `journey_legs[].flight_number`
  • `journey_legs[].travel_date`
  • `journey_legs[].airline_code`
  • `journey_legs[].departure_airport_code`
  • `journey_legs[].arrival_airport_code`
|
  • `booking_id`
  • `fulfillment_date`
  • `passengers[].first_name`
  • `passengers[].last_name`
  • `journey_legs[].pnr`
  • `journey_legs[].arrival_airport_code`
| :::1810:T480,You can set a dynamic statement descriptor for your orders by providing a custom suffix. A statement descriptor is the text shown on cardholders' bank or card statements, helping them recognise a transaction or merchant. This field can be used to send extra information with the statement descriptor for card transactions. The complete descriptor is built using the following format: `{base}*{suffix}`, where: - **`{base}`** is the existing descriptor configured in the Revolut Business dashboard (**Settings > Business account > Merchant profile > Statement descriptor**). - **`{suffix}`** is defined by the `statement_descriptor_suffix` field. :::note - If the combined descriptor's length (base + suffix) exceeds the character limits of card scheme providers, the final value will be truncated. For example if the limit is 22 characters, the base descriptor is `"base"` and the suffix is `"testdescriptorsuffix"`, the final descriptor becomes `"base*testdescriptorsuf"`. - The final statement descriptor shown on a cardholder's statement may vary by issuing bank, as some banks apply their own custom formatting or truncation rules. :::1d:["$","$7a","capture-order",{"children":[["$","section",null,{"className":"y9a0do0","data-variant":"endpoint","children":["$","$L7b",null,{"responses":{"200":{"description":"Order captured","content":{"application/json":{"schema":{"title":"Order v5","type":"object","description":"To process the order from a credit or debit card, you create an `Order` object. You can then retrieve, capture, cancel, refund, or pay an order using its unique `id`. Alternatively, you can use its unique `token` to process a card payment with the Revolut Checkout Widget.","properties":{"id":{"type":"string","format":"uuid","description":"Permanent order ID used to retrieve, capture, cancel, or refund an order after authorization.","descriptionNode":"$L16cf"},"token":{"type":"string","description":"Temporary ID for the order, which expires when the payment is authorised.\n\nThe order `token` is used for [token-based initialisation](https://developer.revolut.com/docs/sdks/merchant-web-sdk/initialisation/token-based), and is returned by the `createOrder` callback in the following payment methods:\n\n- [Embedded Checkout](https://developer.revolut.com/docs/sdks/merchant-web-sdk/payment-methods/embedded-checkout#embedded-checkout-options-interface)\n- [Revolut Pay](https://developer.revolut.com/docs/sdks/merchant-web-sdk/payment-methods/revolut-pay#widget-payments-revolut-pay-options)\n- [Apple Pay and Google Pay](https://developer.revolut.com/docs/sdks/merchant-web-sdk/payment-methods/apple-pay-google-pay#payment-request-options-interface)\n- [Pay by Bank](https://developer.revolut.com/docs/sdks/merchant-web-sdk/payment-methods/pay-by-bank#pay-by-bank-options-interface)","descriptionNode":"$L16d0"},"type":{"type":"string","description":"The type of the order.","enum":"$19:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:orders:items:properties:type:enum","descriptionNode":"$L16d1"},"state":{"type":"string","description":"The state of the order in its lifecycle.\n\n| State | Description |\n|-------|-------------|\n| `pending` | Order created, awaiting payment |\n| `processing` | Payment is being processed |\n| `authorised` | Payment authorised but not yet captured (for manual capture) |\n| `completed` | Payment successfully captured and settled |\n| `cancelled` | Order was cancelled |\n| `failed` | Payment failed |\n\n:::info\nFor more information, see: [Order and payment lifecycle](https://developer.revolut.com/docs/guides/merchant/reference/order-lifecycle)\n:::","enum":"$19:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:orders:items:properties:state:enum","examples":"$19:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:orders:items:properties:state:examples","descriptionNode":"$L16d2"},"created_at":{"type":"string","description":"The date and time the order was created.","format":"date-time","descriptionNode":"$L16d3"},"updated_at":{"type":"string","description":"The date and time the order was last updated.","format":"date-time","descriptionNode":"$L16d4"},"description":{"type":"string","description":"The description of the order.","descriptionNode":"$L16d5"},"capture_mode":{"type":"string","description":"The capture mode of the order. `automatic` is used by default.\n\n| Parameter value | Description |\n| --------------- | ----------- |\n| `automatic` | The order is captured automatically after payment authorisation. |\n| `manual` | The order is not captured automatically. You must manually capture the order later. |\n\n:::info\nFor more information, see [Capture an order](https://developer.revolut.com/docs/api/merchant#capture-order).\n:::","default":"automatic","enum":"$19:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:orders:items:properties:capture_mode:enum","descriptionNode":"$L16d6"},"authorisation_type":{"type":"string","description":"The type of authorisation for the order. Used with manual capture mode. If omitted, `final` is used by default.\n\n### Pre-authorisation\n\nPre-authorisation allows you to reserve funds on a customer's card without immediately capturing them. This is useful for scenarios like:\n\n- Hotel bookings where the final amount may vary\n- Car rentals where additional charges may apply\n- Deposits that need to be held temporarily\n\n| Parameter value | Description |\n| --------------- | ----------- |\n| `final` | Standard authorisation for immediate or near-immediate capture. |\n| `pre_authorisation` | Reserve funds for later capture, used with manual capture mode. |\n\n:::note\nPre-authorisation must be used with `capture_mode: manual`. For more information, see [Capture an order](https://developer.revolut.com/docs/api/merchant#capture-order).\n:::","default":"final","enum":"$19:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:orders:items:properties:authorisation_type:enum","descriptionNode":"$L16d7"},"cancel_authorised_after":{"type":"string","format":"duration","description":"$16d8","descriptionNode":"$L16d9"},"amount":{"type":"integer","description":"The order total expressed in minor currency units, according to the [ISO 4217 standard](https://en.wikipedia.org/wiki/ISO_4217). For example, `7034` in `EUR` corresponds to €70.34.\n\n:::info\n- Conversion between major and minor units varies by currency. For instance, `100` minor units equal £1.00 in `GBP`, whereas in `ISK` they represent 100 units. For more details, see the [ISO 4217 standard](https://en.wikipedia.org/wiki/ISO_4217).\n- If `line_items` are provided, the order `amount` must equal the sum of all line items' `total_amount`.\n- For card payments with a non-zero amount, the order `amount` must be at least **$0.005** (or equivalent in different currencies, calculated using Revolut's exchange rate on the payment date). Otherwise, card payments can't be performed.\n:::","descriptionNode":"$L16da"},"outstanding_amount":{"type":"integer","description":"The amount not yet paid for a given order (in minor currency units). For example, `7034` represents €70.34. \n\nThe value in this field may differ from `amount` if there are partial payments associated with the order.","descriptionNode":"$L16db"},"refunded_amount":{"type":"integer","description":"The amount that was refunded from the order (in minor currency units). For example, `7034` represents €70.34. \n\nThis applies to orders that have been refunded (i.e., orders of type `payment` that have a related `refund` order).","descriptionNode":"$L16dc"},"currency":{"type":"string","format":"ISO 4217","minLength":3,"maxLength":3,"description":"[ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) currency code in upper case.\n\n:::info\nFor more information about the supported currencies, see: [Help Center](https://help.revolut.com/business/help/merchant-accounts/payments/in-which-currencies-can-i-accept-payments/).\n:::","descriptionNode":"$L16dd"},"settlement_currency":{"type":"string","description":"[ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) currency code in upper case. \n\nIf `settlement_currency` is different from the value of `currency`, the money will be exchanged when the amount is settled to your merchant account. In case of a refund or chargeback, the money will be exchanged to the order's initial `currency`.\n\nIf `settlement_currency` is not specified, this value is taken from `currency`.\n\n:::info\nFor more information about the supported currencies, see: [Help Center](https://help.revolut.com/business/help/merchant-accounts/payments/in-which-currencies-can-i-accept-payments/).\n:::","descriptionNode":"$L16de"},"customer":{"type":"object","description":"$16df","properties":{"id":{"type":"string","format":"uuid","description":"Permanent ID of a customer used to retrieve, update, delete a customer. This ID can also be used to link customer to an order.\n\n:::note\nIf you provide the customer's ID during order creation, no other customer data is required, they will be parsed automatically from the referenced customer object.\n:::","descriptionNode":"$L16e0"},"full_name":{"type":"string","description":"The full name of the customer.","descriptionNode":"$L16e1"},"phone":{"type":"string","description":"The phone number of the customer in [E.164 format](https://en.wikipedia.org/wiki/E.164).","descriptionNode":"$L16e2"},"email":{"type":"string","format":"email","description":"The email address of the customer.","descriptionNode":"$L16e3"},"date_of_birth":{"type":"string","format":"date","description":"The birth date of the customer.","descriptionNode":"$L16e4"}},"descriptionNode":"$L16e5"},"payments":{"type":"array","description":"The details of all the payments that have been made towards this order (successful or unsuccessful).","items":{"type":"object","description":"Represents a payment for an order.\n\nFor pre-authorised payments, the `authorised_amount` field tracks the currently authorised amount, which may differ from `amount` during incremental authorisation processing.","properties":{"id":{"type":"string","format":"uuid","description":"The ID of the payment.","descriptionNode":"$L16e6"},"state":{"type":"string","description":"The status of the payment.","enum":"$21:props:children:0:props:children:props:responses:200:content:application/json:schema:items:properties:state:enum","descriptionNode":"$L16e7"},"decline_reason":{"type":"string","description":"The reason for a `failed` or `declined` payment.\n\nA failed or declined payment can result from multiple reasons. To learn more, check our [failure reasons](https://developer.revolut.com/docs/guides/merchant/reference/error-codes/decline-reasons).","enum":"$21:props:children:0:props:children:props:responses:200:content:application/json:schema:items:properties:decline_reason:enum","descriptionNode":"$L16e8"},"bank_message":{"type":"string","description":"The reason for a `failed` or `declined` payment, sent by the financial institution processing the payment.","descriptionNode":"$L16e9"},"created_at":{"type":"string","format":"date-time","description":"The date and time the payment was created.","descriptionNode":"$L16ea"},"updated_at":{"type":"string","format":"date-time","description":"The date and time the payment was last updated.","descriptionNode":"$L16eb"},"token":{"type":"string","format":"uuid","description":"Temporary token of the payment used to fetch the reward offer during checkout and link user registrations to the given offers. \n\nThe token is only valid for a limited time.","descriptionNode":"$L16ec"},"amount":{"type":"integer","format":"int64","minimum":0,"description":"The payment amount in minor units (e.g., cents). The value of this field depends on the payment type and state.\n\n| Payment type | State | Amount value |\n|--------------|-------|--------------|\n| Standard payment | Any | Total payment amount |\n| Pre-authorised payment | `authorisation_started` | New amount being authorised (during increment processing) |\n| Pre-authorised payment | `authorised` | Currently authorised amount (equals `authorised_amount`) |\n\n:::info\nFor pre-authorised payments, see the `authorised_amount` field for tracking the currently authorised amount separately.\n:::","examples":"$21:props:children:0:props:children:props:responses:200:content:application/json:schema:items:properties:amount:examples","descriptionNode":"$L16ed"},"authorised_amount":{"type":"integer","description":"The currently authorised amount for this payment (in minor units).\n\nFor pre-authorised payments with incremental authorization:\n- Initially equals the `amount` field\n- Remains unchanged during increment processing\n- Updates to new amount upon successful increment\n- Remains at original amount if increment is declined\n\nFor standard payments, this field may not be present or will equal the `amount` field.","examples":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:authorised_amount:examples","descriptionNode":"$L16ee"},"currency":{"type":"string","format":"ISO 4217","minLength":3,"maxLength":3,"description":"[ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) currency code in upper case.\n\n:::info\nFor more information about the supported currencies, see: [Help Center](https://help.revolut.com/business/help/merchant-accounts/payments/in-which-currencies-can-i-accept-payments/).\n:::","descriptionNode":"$L16ef"},"settled_amount":{"type":"integer","description":"The amount of the settled payment (minor currency unit). For example, `7034` stands for €70.34.","descriptionNode":"$L16f0"},"settled_currency":{"type":"string","description":"The currency of the settled payment. [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) currency code in upper case.\n\n:::info\nFor more information about the supported currencies, see: [Help Center](https://help.revolut.com/business/help/merchant-accounts/payments/in-which-currencies-can-i-accept-payments/).\n:::","descriptionNode":"$L16f1"},"payment_method":{"type":"object","description":"The details of the payment method used to make the payment.","discriminator":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:discriminator","oneOf":[{"type":"object","description":"Object containing details of a card used via Apple Pay.","properties":{"id":{"type":"string","format":"uuid","description":"ID of the saved payment method.\n\n:::note\nThe `id` parameter is only returned when the payment method is saved.\n:::","descriptionNode":"$L16f2"},"type":{"type":"string","enum":"$21:props:children:0:props:children:props:responses:200:content:application/json:schema:items:properties:payment_method:oneOf:2:properties:type:enum","description":"The type of payment method used to pay for the order.\n\nAvailable values:\n\n| Payment method `type` | Description |\n| --------------------- | ----------- |\n| `apple_pay` | The customer paid the order using Apple Pay. |\n| `card` | The customer paid the order using their credit or debit card. |\n| `google_pay` | The customer paid the order using Google Pay. |\n| `revolut_pay_card` | The customer paid the order via Revolut Pay using their credit or debit card. |\n| `revolut_pay_account` | The customer paid the order via Revolut Pay using their Revolut account. |\n| `sepa_direct_debit` | The customer paid the order using SEPA Direct Debit. |","descriptionNode":"$L16f3"},"card_brand":{"type":"string","description":"The type of the card.","enum":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:0:properties:card_brand:enum","descriptionNode":"$L16f4"},"funding":{"type":"string","description":"The type of card funding.","enum":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:0:properties:funding:enum","descriptionNode":"$L16f5"},"card_country_code":{"type":"string","description":"The 2-letter country code of the country where the card was issued.","descriptionNode":"$L16f6"},"card_bin":{"type":"string","description":"The BIN of the card.","minLength":6,"maxLength":6,"descriptionNode":"$L16f7"},"card_last_four":{"type":"string","description":"The last four digits of the card number.","minLength":4,"maxLength":4,"descriptionNode":"$L16f8"},"card_expiry":{"type":"string","format":"MM/YY","description":"The expiry date of the card in the format of MM/YY.","descriptionNode":"$L16f9"},"cardholder_name":{"type":"string","description":"The name of the cardholder.","descriptionNode":"$L16fa"},"checks":{"type":"object","description":"The details of the check for card payment. Only for orders with successful payments.","properties":{"three_ds":{"type":"object","description":"The details of the 3D Secure check. Only for orders with successful payments.\n\n:::note\nNot returned for Apple Pay and Google Pay payments.\n:::","properties":{"eci":{"type":"string","description":"The Electronic Commerce Indicator (ECI) value corresponds to the authentication result and indicates the level of security used when the payment information was provided.","descriptionNode":"$L16fb"},"state":{"type":"string","description":"The result of 3D Secure check.","enum":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:0:properties:checks:properties:three_ds:properties:state:enum","descriptionNode":"$L16fc"},"version":{"type":"integer","description":"The 3D Secure version.","descriptionNode":"$L16fd"}},"descriptionNode":"$L16fe"},"cvv_verification":{"type":"string","description":"The result of CVV verification.\n\n| Parameter value | Description |\n| ----- | ----------- |\n| `match` | CVV matches the card's CVV |\n| `not_match` | CVV does not match the card's CVV |\n| `incorrect` | CVV format is incorrect for this type of card |\n| `not_processed` | CVV verification was not performed |","enum":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:0:properties:checks:properties:cvv_verification:enum","descriptionNode":"$L16ff"},"address":{"type":"string","description":"The result of address verification.","enum":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:0:properties:checks:properties:address:enum","descriptionNode":"$L1700"},"postcode":{"type":"string","description":"The result of postcode verification.","enum":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:0:properties:checks:properties:postcode:enum","descriptionNode":"$L1701"},"cardholder":{"type":"string","description":"The result of cardholder verification.","enum":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:0:properties:checks:properties:cardholder:enum","descriptionNode":"$L1702"}},"descriptionNode":"$L1703"},"authorisation_code":{"type":"string","description":"The authorisation code (or auth code) is a short, alphanumeric code returned by the cardholder's issuing bank to the merchant's terminal or payment gateway.\n\nIt serves as confirmation that the transaction has been approved and funds are available.","pattern":"^[a-zA-Z0-9]{2,6}$","minLength":2,"maxLength":6,"examples":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:0:properties:authorisation_code:examples","descriptionNode":"$L1704"},"arn":{"type":"string","description":"Acquirer Reference Number (ARN) of the payment.\n\n:::note\nOnly returned for refund payments made by a card.\n:::","minLength":23,"maxLength":23,"examples":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:0:properties:arn:examples","descriptionNode":"$L1705"},"capture_deadline":{"type":"string","format":"date-time","description":"The date and time by which the payment must be captured.\n\nAfter this deadline, the authorised funds may be automatically released by the card issuer.","descriptionNode":"$L1706"},"terminal_hardware_id":{"type":"string","description":"The hardware identifier of the Revolut Terminal device used to process the payment.\n\n:::note\nOnly present for card-present transactions processed via Revolut Terminal.\n:::","descriptionNode":"$L1707"},"fingerprint":{"type":"string","minLength":44,"maxLength":44,"description":"$1708","examples":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:0:properties:fingerprint:examples","descriptionNode":"$L1709"},"network_transaction_id":{"type":"string","description":"The Network Transaction ID (NTI) is a unique identifier assigned by the card scheme (e.g., Visa or Mastercard) to a card transaction.\n\nIt can be used to trace the transaction across the payment network, link recurring or instalment payments to the original authorisation, and support dispute resolution.","descriptionNode":"$L170a"}},"required":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:0:required","descriptionNode":"$L170b"},{"type":"object","description":"Object containing details of the card used for the payment.","properties":{"id":{"type":"string","format":"uuid","description":"ID of the saved payment method.\n\n:::note\nThe `id` parameter is only returned when the payment method is saved.\n:::","descriptionNode":"$L170c"},"type":{"type":"string","enum":"$21:props:children:0:props:children:props:responses:200:content:application/json:schema:items:properties:payment_method:oneOf:2:properties:type:enum","description":"The type of payment method used to pay for the order.\n\nAvailable values:\n\n| Payment method `type` | Description |\n| --------------------- | ----------- |\n| `apple_pay` | The customer paid the order using Apple Pay. |\n| `card` | The customer paid the order using their credit or debit card. |\n| `google_pay` | The customer paid the order using Google Pay. |\n| `revolut_pay_card` | The customer paid the order via Revolut Pay using their credit or debit card. |\n| `revolut_pay_account` | The customer paid the order via Revolut Pay using their Revolut account. |\n| `sepa_direct_debit` | The customer paid the order using SEPA Direct Debit. |","descriptionNode":"$L170d"},"card_brand":{"type":"string","description":"The type of the card.","enum":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:1:properties:card_brand:enum","descriptionNode":"$L170e"},"funding":{"type":"string","description":"The type of card funding.","enum":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:1:properties:funding:enum","descriptionNode":"$L170f"},"card_country_code":{"type":"string","description":"The 2-letter country code of the country where the card was issued.","descriptionNode":"$L1710"},"card_bin":{"type":"string","description":"The BIN of the card.","minLength":6,"maxLength":6,"descriptionNode":"$L1711"},"card_last_four":{"type":"string","description":"The last four digits of the card number.","minLength":4,"maxLength":4,"descriptionNode":"$L1712"},"card_expiry":{"type":"string","format":"MM/YY","description":"The expiry date of the card in the format of MM/YY.","descriptionNode":"$L1713"},"cardholder_name":{"type":"string","description":"The name of the cardholder.","descriptionNode":"$L1714"},"checks":{"type":"object","description":"The details of the check for card payment. Only for orders with successful payments.","properties":{"three_ds":"$1d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payments:items:properties:payment_method:oneOf:0:properties:checks:properties:three_ds","cvv_verification":"$1d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payments:items:properties:payment_method:oneOf:0:properties:checks:properties:cvv_verification","address":"$1d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payments:items:properties:payment_method:oneOf:0:properties:checks:properties:address","postcode":"$1d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payments:items:properties:payment_method:oneOf:0:properties:checks:properties:postcode","cardholder":"$1d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payments:items:properties:payment_method:oneOf:0:properties:checks:properties:cardholder"},"descriptionNode":"$L1715"},"authorisation_code":{"type":"string","description":"The authorisation code (or auth code) is a short, alphanumeric code returned by the cardholder's issuing bank to the merchant's terminal or payment gateway.\n\nIt serves as confirmation that the transaction has been approved and funds are available.","pattern":"^[a-zA-Z0-9]{2,6}$","minLength":2,"maxLength":6,"examples":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:0:properties:authorisation_code:examples","descriptionNode":"$L1716"},"arn":{"type":"string","description":"Acquirer Reference Number (ARN) of the payment.\n\n:::note\nOnly returned for refund payments made by a card.\n:::","minLength":23,"maxLength":23,"examples":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:0:properties:arn:examples","descriptionNode":"$L1717"},"capture_deadline":{"type":"string","format":"date-time","description":"The date and time by which the payment must be captured.\n\nAfter this deadline, the authorised funds may be automatically released by the card issuer.","descriptionNode":"$L1718"},"terminal_hardware_id":{"type":"string","description":"The hardware identifier of the Revolut Terminal device used to process the payment.\n\n:::note\nOnly present for card-present transactions processed via Revolut Terminal.\n:::","descriptionNode":"$L1719"},"fingerprint":{"type":"string","minLength":44,"maxLength":44,"description":"$171a","examples":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:0:properties:fingerprint:examples","descriptionNode":"$L171b"},"network_transaction_id":{"type":"string","description":"The Network Transaction ID (NTI) is a unique identifier assigned by the card scheme (e.g., Visa or Mastercard) to a card transaction.\n\nIt can be used to trace the transaction across the payment network, link recurring or instalment payments to the original authorisation, and support dispute resolution.","descriptionNode":"$L171c"}},"required":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:1:required","descriptionNode":"$L171d"},{"type":"object","description":"Object containing details of a card used via Google Pay.","properties":{"id":{"type":"string","format":"uuid","description":"ID of the saved payment method.\n\n:::note\nThe `id` parameter is only returned when the payment method is saved.\n:::","descriptionNode":"$L171e"},"type":{"type":"string","enum":"$21:props:children:0:props:children:props:responses:200:content:application/json:schema:items:properties:payment_method:oneOf:2:properties:type:enum","description":"The type of payment method used to pay for the order.\n\nAvailable values:\n\n| Payment method `type` | Description |\n| --------------------- | ----------- |\n| `apple_pay` | The customer paid the order using Apple Pay. |\n| `card` | The customer paid the order using their credit or debit card. |\n| `google_pay` | The customer paid the order using Google Pay. |\n| `revolut_pay_card` | The customer paid the order via Revolut Pay using their credit or debit card. |\n| `revolut_pay_account` | The customer paid the order via Revolut Pay using their Revolut account. |\n| `sepa_direct_debit` | The customer paid the order using SEPA Direct Debit. |","descriptionNode":"$L171f"},"card_brand":{"type":"string","description":"The type of the card.","enum":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:2:properties:card_brand:enum","descriptionNode":"$L1720"},"funding":{"type":"string","description":"The type of card funding.","enum":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:2:properties:funding:enum","descriptionNode":"$L1721"},"card_country_code":{"type":"string","description":"The 2-letter country code of the country where the card was issued.","descriptionNode":"$L1722"},"card_bin":{"type":"string","description":"The BIN of the card.","minLength":6,"maxLength":6,"descriptionNode":"$L1723"},"card_last_four":{"type":"string","description":"The last four digits of the card number.","minLength":4,"maxLength":4,"descriptionNode":"$L1724"},"card_expiry":{"type":"string","format":"MM/YY","description":"The expiry date of the card in the format of MM/YY.","descriptionNode":"$L1725"},"cardholder_name":{"type":"string","description":"The name of the cardholder.","descriptionNode":"$L1726"},"checks":{"type":"object","description":"The details of the check for card payment. Only for orders with successful payments.","properties":{"three_ds":"$1d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payments:items:properties:payment_method:oneOf:0:properties:checks:properties:three_ds","cvv_verification":"$1d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payments:items:properties:payment_method:oneOf:0:properties:checks:properties:cvv_verification","address":"$1d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payments:items:properties:payment_method:oneOf:0:properties:checks:properties:address","postcode":"$1d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payments:items:properties:payment_method:oneOf:0:properties:checks:properties:postcode","cardholder":"$1d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payments:items:properties:payment_method:oneOf:0:properties:checks:properties:cardholder"},"descriptionNode":"$L1727"},"authorisation_code":{"type":"string","description":"The authorisation code (or auth code) is a short, alphanumeric code returned by the cardholder's issuing bank to the merchant's terminal or payment gateway.\n\nIt serves as confirmation that the transaction has been approved and funds are available.","pattern":"^[a-zA-Z0-9]{2,6}$","minLength":2,"maxLength":6,"examples":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:0:properties:authorisation_code:examples","descriptionNode":"$L1728"},"arn":{"type":"string","description":"Acquirer Reference Number (ARN) of the payment.\n\n:::note\nOnly returned for refund payments made by a card.\n:::","minLength":23,"maxLength":23,"examples":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:0:properties:arn:examples","descriptionNode":"$L1729"},"capture_deadline":{"type":"string","format":"date-time","description":"The date and time by which the payment must be captured.\n\nAfter this deadline, the authorised funds may be automatically released by the card issuer.","descriptionNode":"$L172a"},"terminal_hardware_id":{"type":"string","description":"The hardware identifier of the Revolut Terminal device used to process the payment.\n\n:::note\nOnly present for card-present transactions processed via Revolut Terminal.\n:::","descriptionNode":"$L172b"},"fingerprint":{"type":"string","minLength":44,"maxLength":44,"description":"$172c","examples":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:0:properties:fingerprint:examples","descriptionNode":"$L172d"},"network_transaction_id":{"type":"string","description":"The Network Transaction ID (NTI) is a unique identifier assigned by the card scheme (e.g., Visa or Mastercard) to a card transaction.\n\nIt can be used to trace the transaction across the payment network, link recurring or instalment payments to the original authorisation, and support dispute resolution.","descriptionNode":"$L172e"}},"required":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:2:required","descriptionNode":"$L172f"},{"type":"object","description":"Object containing details of a card used via Revolut Pay.","properties":{"id":{"type":"string","format":"uuid","description":"ID of the saved payment method.\n\n:::note\nThe `id` parameter is only returned when the payment method is saved.\n:::","descriptionNode":"$L1730"},"type":{"type":"string","enum":"$21:props:children:0:props:children:props:responses:200:content:application/json:schema:items:properties:payment_method:oneOf:2:properties:type:enum","description":"The type of payment method used to pay for the order.\n\nAvailable values:\n\n| Payment method `type` | Description |\n| --------------------- | ----------- |\n| `apple_pay` | The customer paid the order using Apple Pay. |\n| `card` | The customer paid the order using their credit or debit card. |\n| `google_pay` | The customer paid the order using Google Pay. |\n| `revolut_pay_card` | The customer paid the order via Revolut Pay using their credit or debit card. |\n| `revolut_pay_account` | The customer paid the order via Revolut Pay using their Revolut account. |\n| `sepa_direct_debit` | The customer paid the order using SEPA Direct Debit. |","descriptionNode":"$L1731"},"card_brand":{"type":"string","description":"The type of the card.","enum":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:3:properties:card_brand:enum","descriptionNode":"$L1732"},"funding":{"type":"string","description":"The type of card funding.","enum":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:3:properties:funding:enum","descriptionNode":"$L1733"},"card_country_code":{"type":"string","description":"The 2-letter country code of the country where the card was issued.","descriptionNode":"$L1734"},"card_bin":{"type":"string","description":"The BIN of the card.","minLength":6,"maxLength":6,"descriptionNode":"$L1735"},"card_last_four":{"type":"string","description":"The last four digits of the card number.","minLength":4,"maxLength":4,"descriptionNode":"$L1736"},"card_expiry":{"type":"string","format":"MM/YY","description":"The expiry date of the card in the format of MM/YY.","descriptionNode":"$L1737"},"cardholder_name":{"type":"string","description":"The name of the cardholder.","descriptionNode":"$L1738"},"checks":{"type":"object","description":"The details of the check for card payment. Only for orders with successful payments.","properties":{"three_ds":"$1d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payments:items:properties:payment_method:oneOf:0:properties:checks:properties:three_ds","cvv_verification":"$1d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payments:items:properties:payment_method:oneOf:0:properties:checks:properties:cvv_verification","address":"$1d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payments:items:properties:payment_method:oneOf:0:properties:checks:properties:address","postcode":"$1d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payments:items:properties:payment_method:oneOf:0:properties:checks:properties:postcode","cardholder":"$1d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payments:items:properties:payment_method:oneOf:0:properties:checks:properties:cardholder"},"descriptionNode":"$L1739"},"authorisation_code":{"type":"string","description":"The authorisation code (or auth code) is a short, alphanumeric code returned by the cardholder's issuing bank to the merchant's terminal or payment gateway.\n\nIt serves as confirmation that the transaction has been approved and funds are available.","pattern":"^[a-zA-Z0-9]{2,6}$","minLength":2,"maxLength":6,"examples":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:0:properties:authorisation_code:examples","descriptionNode":"$L173a"},"arn":{"type":"string","description":"Acquirer Reference Number (ARN) of the payment.\n\n:::note\nOnly returned for refund payments made by a card.\n:::","minLength":23,"maxLength":23,"examples":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:0:properties:arn:examples","descriptionNode":"$L173b"},"capture_deadline":{"type":"string","format":"date-time","description":"The date and time by which the payment must be captured.\n\nAfter this deadline, the authorised funds may be automatically released by the card issuer.","descriptionNode":"$L173c"},"terminal_hardware_id":{"type":"string","description":"The hardware identifier of the Revolut Terminal device used to process the payment.\n\n:::note\nOnly present for card-present transactions processed via Revolut Terminal.\n:::","descriptionNode":"$L173d"},"fingerprint":{"type":"string","minLength":44,"maxLength":44,"description":"$173e","examples":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:0:properties:fingerprint:examples","descriptionNode":"$L173f"},"network_transaction_id":{"type":"string","description":"The Network Transaction ID (NTI) is a unique identifier assigned by the card scheme (e.g., Visa or Mastercard) to a card transaction.\n\nIt can be used to trace the transaction across the payment network, link recurring or instalment payments to the original authorisation, and support dispute resolution.","descriptionNode":"$L1740"}},"required":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:3:required","descriptionNode":"$L1741"},{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"ID of the saved payment method.\n\n:::note\nThe `id` parameter is only returned when the payment method is saved.\n:::","descriptionNode":"$L1742"},"type":{"type":"string","enum":"$21:props:children:0:props:children:props:responses:200:content:application/json:schema:items:properties:payment_method:oneOf:2:properties:type:enum","description":"The type of payment method used to pay for the order.\n\nAvailable values:\n\n| Payment method `type` | Description |\n| --------------------- | ----------- |\n| `apple_pay` | The customer paid the order using Apple Pay. |\n| `card` | The customer paid the order using their credit or debit card. |\n| `google_pay` | The customer paid the order using Google Pay. |\n| `revolut_pay_card` | The customer paid the order via Revolut Pay using their credit or debit card. |\n| `revolut_pay_account` | The customer paid the order via Revolut Pay using their Revolut account. |\n| `sepa_direct_debit` | The customer paid the order using SEPA Direct Debit. |","descriptionNode":"$L1743"},"fingerprint":{"type":"string","minLength":44,"maxLength":44,"description":"$1744","examples":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:0:properties:fingerprint:examples","descriptionNode":"$L1745"}},"required":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:4:required"},{"type":"object","description":"Object containing details of a SEPA Direct Debit payment.\n\n:::info\nFor more information, see: [SEPA Direct Debit server-to-server integration](https://developer.revolut.com/docs/guides/merchant/accept-payments/payment-methods/sepa-direct-debit/server-to-server)\n:::","properties":{"id":{"type":"string","format":"uuid","description":"ID of the saved payment method.\n\n:::note\nThe `id` parameter is only returned when the payment method is saved for the merchant.\n:::","descriptionNode":"$L1746"},"type":{"type":"string","enum":"$21:props:children:0:props:children:props:responses:200:content:application/json:schema:items:properties:payment_method:oneOf:2:properties:type:enum","description":"The type of payment method used to pay for the order.\n\nAvailable values:\n\n| Payment method `type` | Description |\n| --------------------- | ----------- |\n| `apple_pay` | The customer paid the order using Apple Pay. |\n| `card` | The customer paid the order using their credit or debit card. |\n| `google_pay` | The customer paid the order using Google Pay. |\n| `revolut_pay_card` | The customer paid the order via Revolut Pay using their credit or debit card. |\n| `revolut_pay_account` | The customer paid the order via Revolut Pay using their Revolut account. |\n| `sepa_direct_debit` | The customer paid the order using SEPA Direct Debit. |","descriptionNode":"$L1747"},"debtor_iban_last_four":{"type":"string","description":"The last four digits of the debtor's IBAN.","minLength":4,"maxLength":4,"descriptionNode":"$L1748"},"debtor_name":{"type":"string","description":"The full name of the debtor as provided in the mandate.","descriptionNode":"$L1749"},"mandate_reference":{"type":"string","description":"The unique mandate reference generated by Revolut. Include this in pre-debit notifications sent to your customers.","descriptionNode":"$L174a"}},"required":"$21:props:children:0:props:children:props:responses:200:content:application/json:schema:items:properties:payment_method:oneOf:2:required","descriptionNode":"$L174b"}],"descriptionNode":"$L174c"},"authentication_challenge":{"type":"object","description":"Details about the authentication challenge that should be performed to complete the authentication process. For more information about Revolut's 3DS solution, see: [3D Secure overview](https://developer.revolut.com/docs/guides/merchant/reference/3d-secure).\n\nOnly returned if the payment's state is `authentication_challenge`.","discriminator":"$21:props:children:0:props:children:props:responses:200:content:application/json:schema:items:properties:authentication_challenge:discriminator","oneOf":[{"title":"three_ds","type":"object","description":"Information about the 3DS challenge.","properties":{"type":{"type":"string","enum":"$21:props:children:0:props:children:props:responses:200:content:application/json:schema:items:properties:authentication_challenge:oneOf:0:properties:type:enum","description":"Type of the authentication challenge the payment triggers.","descriptionNode":"$L174d"},"acs_url":{"type":"string","format":"url","description":"The URL of the authentication challenge.","descriptionNode":"$L174e"}},"required":"$21:props:children:0:props:children:props:responses:200:content:application/json:schema:items:properties:authentication_challenge:oneOf:0:required","descriptionNode":"$L174f"},{"title":"three_ds_fingerprint","type":"object","description":"Information about the 3DS fingerprint challenge.","properties":{"type":{"type":"string","enum":"$21:props:children:0:props:children:props:responses:200:content:application/json:schema:items:properties:authentication_challenge:oneOf:0:properties:type:enum","description":"Type of the authentication challenge the payment triggers.","descriptionNode":"$L1750"},"fingerprint_url":{"type":"string","format":"url","description":"The URL of the fingerprint. (Used only internally by Revolut.)","descriptionNode":"$L1751"},"fingerprint_data":{"type":"string","format":"JSON","description":"Data about the fingerprint used for authentication. (Used only internally\nby Revolut.)","descriptionNode":"$L1752"}},"required":"$21:props:children:0:props:children:props:responses:200:content:application/json:schema:items:properties:authentication_challenge:oneOf:1:required","descriptionNode":"$L1753"}],"descriptionNode":"$L1754"},"billing_address":{"type":"object","description":"Object containing address details.","properties":{"street_line_1":{"type":"string","description":"Street line 1 information.","maxLength":100,"descriptionNode":"$L1755"},"street_line_2":{"type":"string","description":"Street line 2 information.","maxLength":100,"descriptionNode":"$L1756"},"region":{"type":"string","description":"The region associated with the address.","maxLength":100,"descriptionNode":"$L1757"},"city":{"type":"string","description":"The city associated with the address.","maxLength":100,"descriptionNode":"$L1758"},"country_code":{"type":"string","description":"The 2-letter country code of the country associated with the address.","maxLength":2,"descriptionNode":"$L1759"},"postcode":{"type":"string","description":"The postcode associated with the address.","maxLength":100,"descriptionNode":"$L175a"}},"required":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:billing_address:required","descriptionNode":"$L175b"},"risk_level":{"type":"string","description":"The risk level of the card.\n\nIf the risk level is `high`, the payment might be declined.","enum":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:risk_level:enum","descriptionNode":"$L175c"},"fees":{"type":"array","description":"The details of the order fee.","items":{"type":"object","properties":{"type":{"type":"string","description":"The type of the order fee.","enum":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:fees:items:properties:type:enum","descriptionNode":"$L175d"},"amount":{"type":"integer","description":"The amount of the payment fee (minor currency unit). For example, enter `7034` for €70.34 in the field.","descriptionNode":"$L175e"},"currency":{"type":"string","description":"The currency of the payment fee. [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) currency code in upper case.\n\n:::info\nFor more information about the supported currencies, see: [Help Center](https://help.revolut.com/business/help/merchant-accounts/payments/in-which-currencies-can-i-accept-payments/).\n:::","descriptionNode":"$L175f"}}},"descriptionNode":"$L1760"},"payer":{"title":"Payer","type":"object","description":"The person who made the payment. This object is present when an email or phone number is provided during the payment flow.\n\nCapturing payer details lets you identify exactly who authorised the charge, reach the right person for receipts or refund queries, and support compliance or fraud-review workflows where the paying identity matters.","properties":{"email":{"description":"The email of the person who made the payment.","type":"string","format":"email","descriptionNode":"$L1761"},"phone":{"description":"The phone number of the payer in [E.164 format](https://en.wikipedia.org/wiki/E.164).","type":"string","descriptionNode":"$L1762"}},"descriptionNode":"$L1763"}},"required":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payments:items:required","descriptionNode":"$L1764"},"descriptionNode":"$L1765"},"incremental_authorisations":{"type":"array","description":"History of incremental authorisation attempts for this order.\n\nOnly present for orders with `authorisation_type: pre_authorisation`.\n\nContains all increment attempts in chronological order.","items":{"type":"object","description":"Represents a single incremental authorisation attempt on an order.\n\nThe `incremental_authorisations` array tracks all increment attempts (successful and failed) in chronological order.","properties":{"new_amount":{"type":"integer","description":"The new total amount requested in this increment (in minor units).","examples":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:incremental_authorisations:items:properties:new_amount:examples","descriptionNode":"$L1766"},"old_amount":{"type":"integer","description":"The previously authorised amount before this increment (in minor units).","examples":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:incremental_authorisations:items:properties:old_amount:examples","descriptionNode":"$L1767"},"state":{"type":"string","enum":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:incremental_authorisations:items:properties:state:enum","description":"The state of this incremental authorization attempt.\n\n| State | Description |\n|-------|-------------|\n| `pending` | Increment registered in system, not yet submitted to card network |\n| `processing` | Increment is being processed by card network |\n| `authorised` | Increment was successfully authorised |\n| `declined` | Increment was declined by card issuer |\n| `failed` | Increment failed due to technical error (not an issuer decline) |","descriptionNode":"$L1768"},"reference":{"type":"string","maxLength":255,"description":"External reference for this incremental authorisation.\n\n:::tip\nUse your internal charge or invoice ID. This reference is returned in webhooks for easy matching to your system.\n:::","examples":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:incremental_authorisations:items:properties:reference:examples","descriptionNode":"$L1769"},"line_items":{"type":"array","description":"Line items associated with this increment (if provided).\n\n:::note\nIf the increment is successful, these line items will override the existing order line items.\n:::","items":{"type":"object","properties":{"name":{"type":"string","maxLength":250,"description":"Name of the line item.","descriptionNode":"$L176a"},"type":{"type":"string","enum":"$19:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:orders:items:properties:line_items:items:properties:type:enum","description":"Type of the line item.","descriptionNode":"$L176b"},"quantity":{"type":"object","description":"Object representing the quantity details of a line item, including the amount and its associated unit of measurement.","properties":{"value":{"type":"number","format":"double","minimum":0,"description":"The number of units of the line item.","descriptionNode":"$L176c"},"unit":{"type":"string","maxLength":100,"description":"The measurement unit for the quantity, such as `cm`, or `kg`.","descriptionNode":"$L176d"}},"required":"$19:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:orders:items:properties:line_items:items:properties:quantity:required","descriptionNode":"$L176e"},"unit_price_amount":{"type":"integer","format":"int64","minimum":0,"description":"The unit price of the line item.","descriptionNode":"$L176f"},"total_amount":{"type":"integer","format":"int64","description":"The total amount to be paid for the line item, including taxes and discounts.","descriptionNode":"$L1770"},"external_id":{"type":"string","maxLength":250,"description":"Unique identifier of line item in the merchant's system.","descriptionNode":"$L1771"},"discounts":{"type":"array","maxItems":50,"description":"A list of discounts applied to the line item. Each discount should be subtracted from the total amount payable for the item.","items":{"type":"object","description":"Details of a discount applied to the line item, including its name and monetary value.","properties":{"name":{"type":"string","maxLength":100,"description":"The specific name or label of the discount applied to the line item.","descriptionNode":"$L1772"},"amount":{"type":"integer","format":"int64","minimum":0,"description":"The monetary value of the discount. ","descriptionNode":"$L1773"}},"required":"$19:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:orders:items:properties:line_items:items:properties:discounts:items:required","descriptionNode":"$L1774"},"descriptionNode":"$L1775"},"taxes":{"type":"array","maxItems":50,"description":"A list of taxes applied to the line item. Each tax should be added to the total amount payable for the item.","items":{"type":"object","description":"Details about a tax applied to the line item, including its name and the corresponding amount.","properties":{"name":{"type":"string","description":"The specific name or designation of the tax applied to the line item.","maxLength":100,"descriptionNode":"$L1776"},"amount":{"type":"integer","format":"int64","description":"The monetary value of the tax in minor currency units (e.g., cents for EUR).","minimum":0,"descriptionNode":"$L1777"}},"required":"$19:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:orders:items:properties:line_items:items:properties:taxes:items:required","descriptionNode":"$L1778"},"descriptionNode":"$L1779"},"image_urls":{"type":"array","maxItems":50,"description":"A list of URLs pointing to images related to the line item. These images can provide visual details or representations of the item.","items":{"type":"string","format":"uri","pattern":"^https?:\\/{2}.+/gi","maxLength":2000,"description":"URL to an image associated with the line item.\n\n:::warning\nRestrictions:\n- Must be a valid URI as defined by [RFC 3986](https://datatracker.ietf.org/doc/html/rfc3986)\n- URI scheme is required and must be either `http` or `https`\n- URI host is required and cannot be `localhost` or an IP address\n- Max length: `2000`\n- Reserved or invalid characters must be percent-encoded (for example, use `%20` instead of a space)\n:::","descriptionNode":"$L177a"},"descriptionNode":"$L177b"},"description":{"type":"string","maxLength":1024,"description":"Description of the line item.","descriptionNode":"$L177c"},"url":{"type":"string","format":"uri","pattern":"^https?:\\/{2}.+/gi","maxLength":2000,"description":"An HTTP/HTTPS URL that links to more information about the line item, such as a product page or details.\n\n:::warning\nRestrictions:\n- Must be a valid URI as defined by [RFC 3986](https://datatracker.ietf.org/doc/html/rfc3986)\n- URI scheme is required and must be either `http` or `https`\n- URI host is required and cannot be `localhost` or an IP address\n- Max length: `2000`\n- Reserved or invalid characters must be percent-encoded (for example, use `%20` instead of a space)\n:::","descriptionNode":"$L177d"}},"required":"$19:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:orders:items:properties:line_items:items:required"},"descriptionNode":"$L177e"},"reason":{"type":"string","description":"Reason why increment was declined or failed.\n\n:::note\nOnly present when `state` is `declined` or `failed`.\n:::","examples":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:incremental_authorisations:items:properties:reason:examples","descriptionNode":"$L177f"}},"descriptionNode":"$L1780"},"descriptionNode":"$L1781"},"location_id":{"type":"string","format":"uuid","description":"Unique ID representing the location where merchants sells products.\n\n:::info\nFor more information, see: [Locations](https://developer.revolut.com/docs/api/merchant#tag-locations).\n::: ","descriptionNode":"$L1782"},"metadata":{"type":"object","description":"Additional information to track your orders in your system, by providing custom metadata using `\"\" : \"\"` pairs.\n\n:::warning\n**Restrictions:**\n\n- Both keys and values must be `string`s\n- Values cannot be `null`.\n- Max number of key-value pairs: `50`\n- Max length of values: `500` characters\n- Format of keys: Must start with a letter and contain only letters, digits, and underscores. Max 40 characters. Pattern: `^[a-zA-Z][a-zA-Z\\\\d_]{0,39}$`\n:::","maxProperties":50,"additionalProperties":{"type":"string","maxLength":500,"description":"Additional metadata value provided with the corresponding metadata key.","descriptionNode":"$L1783"},"examples":"$19:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:orders:items:properties:metadata:examples","descriptionNode":"$L1784"},"industry_data":{"type":"object","description":"Object containing industry-specific information associated with the order.\n\n:::info\nIn the following cases, industry-specific info is required. Omitting this information may trigger additional scrutiny and risk mitigation actions by the Revolut risk team.\n\n | Transaction type | Required for |\n | ---------------- | ----------- |\n | `airline` | Airlines and Online Travel Agencies (OTAs). |\n | `car_rental` | Car Rental Merchants and Online Travel Agencies (OTAs). |\n | `crypto` | Crypto merchants. |\n | `marketplace` | Marketplace merchants. |\n | `event` | Event ticket sellers. |\n | `lodging` | Lodging providers. |\n:::","discriminator":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:discriminator","oneOf":[{"type":"object","description":"$1785","properties":{"type":{"type":"string","enum":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:0:properties:type:enum","description":"Type of the industry-specific data object, determining what additional data is expected.\n\nAvailable types:\n\n | Object type | Description |\n | ------------- | ----------- |\n | `airline` | Object containing information about a specific airline ticket purchase. |\n | `car_rental` | Object containing information about a car rental booking associated with the order. |\n | `crypto` | Object containing information about crypto transactions associated with the order. |\n | `marketplace` | This object is required by Mastercard and Visa for merchants operating as marketplaces under the **Merchant Category Code (MCC):** `5262`. The marketplace object ensures compliance with the card schemes' regulations by providing detailed information about the subseller involved in the transaction. |\n | `event` | Object containing information about event ticket bookings associated with the order. |\n | `lodging` | Object containing information about lodging bookings associated with the order. |","descriptionNode":"$L1786"},"booking_id":{"type":"string","description":"A unique identifier provided by the merchant associated with the order. \n\nThis `booking_id` is used to reference and correlate booking information with the Merchant API and the merchant's internal system.","descriptionNode":"$L1787"},"fulfillment_date":{"type":"string","format":"date-time","description":"The UTC date and time of the final journey leg.\n\n:::warning\nThe following limitations apply:\n - When creating or updating an order, `fulfillment_date` cannot be set to a date in the past.\n - When updating an order, if the current `fulfillment_date` value is already in the past, it cannot be modified. The date must remain as is to maintain data integrity for completed transactions.\n:::","descriptionNode":"$L1788"},"tickets_purchase":{"type":"boolean","description":"Flag indicating whether the order includes actual ticket purchases. Set to `true` if the order contains ticket purchases, and `false` if it does not (e.g., it **only** contains seat reservations, or baggage upgrades). \n\n:::info\nThis field is required for activating **Revolut Flight Alerts** functionalities within the Revolut app.\n\nProvide the info on order creation or update, before capturing the order.\n:::","descriptionNode":"$L1789"},"ticket_type":{"type":"string","enum":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:0:properties:ticket_type:enum","description":"The type of the ticket.\n\n| Parameter value | Description |\n| --------------- | ----------- |\n| `fixed` | Non-modifiable once confirmed. |\n| `flexible` | Allows modifications or cancellations under specified conditions. |","descriptionNode":"$L178a"},"crs_code":{"type":"string","maxLength":4,"description":"The code of the Computer Reservation System (CRS) used to make the booking and purchase the ticket.","descriptionNode":"$L178b"},"ticket_change_indicator":{"type":"string","enum":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:0:properties:ticket_change_indicator:enum","description":"Parameter indicating whether this order is related to a new ticket reservation or a modification of an existing one.","descriptionNode":"$L178c"},"refundability":{"type":"string","enum":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:0:properties:refundability:enum","description":"Parameter indicating whether the booking is refundable, partially refundable, or not refundable.","descriptionNode":"$L178d"},"passengers":{"type":"array","description":"Array containing information of passengers associated with the booking.","items":{"type":"object","properties":{"first_name":{"type":"string","description":"Passenger's first name.","descriptionNode":"$L178e"},"last_name":{"type":"string","description":"Passenger's last name.","descriptionNode":"$L178f"}},"required":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:0:properties:passengers:items:required"},"descriptionNode":"$L1790"},"journey_legs":{"type":"array","description":"Array containing information of journey legs associated with the booking.\n\n:::info\nThis field is required for activating **Revolut Flight Alerts** functionalities within the Revolut app. \n\nThis information is used to compile a tracking widget that provides real-time updates on flight status and sends notifications, such as a check-in reminders, boarding alerts, and notifications for cancellations or delays. \n\nTo enable the widget the following fields are required on order creation or update, before capturing the order:\n\n ```\n sequence,\n departure_airport_code,\n arrival_airport_code,\n flight_number,\n travel_date,\n airline_name,\n airline_code,\n ```\n:::","items":{"type":"object","properties":{"sequence":{"type":"integer","description":"Sequence of the journey legs. Increment by 1 for each flight included in the ticket.\n\nFor example: For a `FRA > LHR > DUB > LHR > FRA` journey the sequence will be assigned as:\n - `FRA > LHR`: 1\n - `LHR > DUB`: 2\n - `DUB > LHR`: 3\n - `LHR > FRA`: 4","descriptionNode":"$L1791"},"departure_airport_code":{"type":"string","description":"The [IATA](https://www.iata.org/en/services/codes) 3-letter airport code for the departure airport.","descriptionNode":"$L1792"},"arrival_airport_code":{"type":"string","description":"The [IATA](https://www.iata.org/en/services/codes) 3-letter airport code for the arrival airport.","descriptionNode":"$L1793"},"flight_number":{"type":"string","description":"The flight identifier, without airline code.","descriptionNode":"$L1794"},"fare_base_code":{"type":"string","description":"The fare base code for the given journey leg.","descriptionNode":"$L1795"},"travel_date":{"type":"string","format":"date-time","description":"The UTC date and time of the flight departure for the given journey leg.","descriptionNode":"$L1796"},"airline_name":{"type":"string","description":"The name of the airline associated with the journey leg.","descriptionNode":"$L1797"},"airline_code":{"type":"string","description":"The IATA 2-letter accounting code identifying the airline associated with the journey leg.","descriptionNode":"$L1798"},"pnr":{"type":"string","format":"alphanumeric","pattern":"^[a-zA-Z0-9]*$","maxLength":20,"description":"The Passenger Name Record (PNR) for the journey leg issued by the airline. \n\nPNR is a unique identifier for the booking, acting as a digital certificate allowing passengers to retrieve or manage their booking details.\n\n:::warning\nThis is a required field for OTAs.\n:::","descriptionNode":"$L1799"}},"required":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:0:properties:journey_legs:items:required"},"descriptionNode":"$L179a"},"booking_url":{"type":"string","format":"uri","pattern":"^https?:\\/{2}.+/gi","maxLength":2000,"description":"URL to the online portal for managing the airline booking, which includes check-in functionality. This URL may be a personalised, pre-populated check-in link specific to the user or a generic link, and it is essential for enabling direct access to booking details within the Revolut app.\n\n:::info\nThis field is required for activating **Revolut Flight Alerts** functionalities within the Revolut app. \n\nProvide the info on order creation or update, before capturing the order.\n:::\n\n:::warning\nRestrictions:\n- Must be a valid URI as defined by [RFC 3986](https://datatracker.ietf.org/doc/html/rfc3986)\n- URI scheme is required and must be either `http` or `https`\n- URI host is required and cannot be `localhost` or an IP address\n- Max length: `2000`\n- Reserved or invalid characters must be percent-encoded (for example, use `%20` instead of a space)\n:::","descriptionNode":"$L179b"}},"required":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:0:required","descriptionNode":"$L179c"},{"type":"object","description":"Object containing additional information about a car rental booking associated with the order.\n\n:::info\nThese are the specific data field requirements for merchants offering car rental. Note that these requirements can be extended on a case by case basis as decided by Revolut.\n\n```\nbooking_id\ndrop_off_date\nrefundability\n```\n:::","properties":{"type":{"type":"string","enum":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:0:properties:type:enum","description":"Type of the industry-specific data object, determining what additional data is expected.\n\nAvailable types:\n\n | Object type | Description |\n | ------------- | ----------- |\n | `airline` | Object containing information about a specific airline ticket purchase. |\n | `car_rental` | Object containing information about a car rental booking associated with the order. |\n | `crypto` | Object containing information about crypto transactions associated with the order. |\n | `marketplace` | This object is required by Mastercard and Visa for merchants operating as marketplaces under the **Merchant Category Code (MCC):** `5262`. The marketplace object ensures compliance with the card schemes' regulations by providing detailed information about the subseller involved in the transaction. |\n | `event` | Object containing information about event ticket bookings associated with the order. |\n | `lodging` | Object containing information about lodging bookings associated with the order. |","descriptionNode":"$L179d"},"booking_id":{"type":"string","description":"A unique identifier provided by the merchant associated with the order. \n\nThis `booking_id` is used to reference and correlate booking information with the Merchant API and the merchant's internal system.","descriptionNode":"$L179e"},"pick_up_date":{"type":"string","format":"date-time","description":"The UTC date and time of the pick-up.","descriptionNode":"$L179f"},"pick_up_location":{"type":"object","description":"Object containing address details.","properties":{"street_line_1":"$1d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payments:items:properties:billing_address:properties:street_line_1","street_line_2":"$1d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payments:items:properties:billing_address:properties:street_line_2","region":"$1d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payments:items:properties:billing_address:properties:region","city":"$1d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payments:items:properties:billing_address:properties:city","country_code":"$1d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payments:items:properties:billing_address:properties:country_code","postcode":"$1d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payments:items:properties:billing_address:properties:postcode"},"required":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:billing_address:required","descriptionNode":"$L17a0"},"drop_off_date":{"type":"string","format":"date-time","description":"The UTC date and time of the drop-off.","descriptionNode":"$L17a1"},"drop_off_location":{"type":"object","description":"Object containing address details.","properties":{"street_line_1":"$1d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payments:items:properties:billing_address:properties:street_line_1","street_line_2":"$1d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payments:items:properties:billing_address:properties:street_line_2","region":"$1d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payments:items:properties:billing_address:properties:region","city":"$1d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payments:items:properties:billing_address:properties:city","country_code":"$1d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payments:items:properties:billing_address:properties:country_code","postcode":"$1d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payments:items:properties:billing_address:properties:postcode"},"required":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:billing_address:required","descriptionNode":"$L17a2"},"refundability":{"type":"string","enum":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:0:properties:refundability:enum","description":"Parameter indicating whether the booking is refundable, partially refundable, or not refundable.","descriptionNode":"$L17a3"},"distance_limit":{"type":"object","description":"Object containing distance limit information.","properties":{"limit":{"type":"integer","description":"The maximum distance allowed.","descriptionNode":"$L17a4"},"unit":{"type":"string","description":"The unit of distance.","enum":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:1:properties:distance_limit:properties:unit:enum","descriptionNode":"$L17a5"},"additional_distance_cost":{"type":"object","description":"Cost for exceeding the distance limit.","properties":{"amount":{"type":"integer","description":"The amount of the cost in minor currency units. For example, enter `7034` for €70.34.","descriptionNode":"$L17a6"},"currency":{"type":"string","format":"ISO 4217","minLength":3,"maxLength":3,"description":"[ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) currency code in upper case.\n\n:::info\nFor more information about the supported currencies, see: [Help Center](https://help.revolut.com/business/help/merchant-accounts/payments/in-which-currencies-can-i-accept-payments/).\n:::","descriptionNode":"$L17a7"}},"descriptionNode":"$L17a8"}},"descriptionNode":"$L17a9"}},"required":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:1:required","descriptionNode":"$L17aa"},{"type":"object","description":"Object containing information about crypto transactions associated with the order.\n\n:::info\nProcessing crypto on-ramp transactions with Revolut has additional compliance requirements. Please reach out to your account executive for additional details.\n\n**Required data fields for crypto services:**\n\n```\ntransactions[].id\ntransactions[].status\ntransactions[].recipient_wallet_id\nseller.id\nseller.name\nseller.website\nseller.phone\nseller.address\nseller.mcc\ncustomer.full_name\ncustomer.date_of_birth\n```\n\nNote that these requirements can be extended on a case by case basis as decided by Revolut.\n:::","properties":{"type":{"type":"string","enum":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:0:properties:type:enum","description":"Type of the industry-specific data object, determining what additional data is expected.\n\nAvailable types:\n\n | Object type | Description |\n | ------------- | ----------- |\n | `airline` | Object containing information about a specific airline ticket purchase. |\n | `car_rental` | Object containing information about a car rental booking associated with the order. |\n | `crypto` | Object containing information about crypto transactions associated with the order. |\n | `marketplace` | This object is required by Mastercard and Visa for merchants operating as marketplaces under the **Merchant Category Code (MCC):** `5262`. The marketplace object ensures compliance with the card schemes' regulations by providing detailed information about the subseller involved in the transaction. |\n | `event` | Object containing information about event ticket bookings associated with the order. |\n | `lodging` | Object containing information about lodging bookings associated with the order. |","descriptionNode":"$L17ab"},"transactions":{"type":"array","description":"Array of crypto transaction data associated with the order.","items":{"type":"object","properties":{"id":{"type":"string","maxLength":255,"description":"The public transaction hash of the crypto transaction.","descriptionNode":"$L17ac"},"status":{"type":"string","enum":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:2:properties:transactions:items:properties:status:enum","description":"The status of the crypto transaction.","descriptionNode":"$L17ad"},"recipient_wallet_id":{"type":"string","maxLength":255,"description":"The wallet ID of the recipient.\n\n:::note\nAt least one of the parameters: `recipient_user_id` or `recipient_wallet_id` is required.\n::: ","descriptionNode":"$L17ae"},"recipient_user_id":{"type":"string","maxLength":255,"description":"The user ID of the recipient.\n\n:::note\nAt least one of the parameters: `recipient_user_id` or `recipient_wallet_id` is required.\n::: ","descriptionNode":"$L17af"}},"required":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:2:properties:transactions:items:required"},"minItems":1,"descriptionNode":"$L17b0"},"seller":{"type":"object","description":"Information about the crypto conversion affiliate.\n\nThis should be provided when a customer completes a payment on a subseller's website rather than directly on the merchant's website, providing insight into the type of business conducted by the subseller.\n\n:::note\nThis needs to be provided only by crypto on-ramp providers for payments they are processing for conversion affiliates.\n\nFor their own payments, `seller` can be omitted.\n:::","properties":{"mcc":{"type":"string","description":"A string representing the four-digit [Merchant Category Code (MCC)](https://en.wikipedia.org/wiki/Merchant_category_code) of the conversion affiliate.","maxLength":4,"minLength":4,"pattern":"^\\d{4}$","descriptionNode":"$L17b1"},"id":{"type":"string","description":"The ID of the seller in the merchant's internal system.","minLength":1,"maxLength":15,"descriptionNode":"$L17b2"},"name":{"type":"string","description":"The business or legal name of the seller.","minLength":1,"maxLength":50,"descriptionNode":"$L17b3"},"website":{"type":"string","format":"uri","pattern":"^https?:\\/{2}.+/gi","maxLength":255,"description":"The URL of the website of the seller.\n\n:::warning\nRestrictions:\n- Must be a valid URI as defined by [RFC 3986](https://datatracker.ietf.org/doc/html/rfc3986)\n- URI scheme is required and must be either `http` or `https`\n- URI host is required and cannot be `localhost` or an IP address\n- Max length: `255`\n- Reserved or invalid characters must be percent-encoded (for example, use `%20` instead of a space)\n:::","descriptionNode":"$L17b4"},"phone":{"type":"string","description":"The phone number of the seller.","descriptionNode":"$L17b5"},"address":{"type":"object","description":"Details of a physical address.","properties":{"street_line_1":{"type":"string","description":"Primary address line.","maxLength":100,"descriptionNode":"$L17b6"},"street_line_2":{"type":"string","description":"Secondary address line, such as floor and apartment number.","maxLength":100,"descriptionNode":"$L17b7"},"region":{"type":"string","description":"State or province of the address.","maxLength":100,"descriptionNode":"$L17b8"},"city":{"type":"string","description":"City of the address.","maxLength":100,"descriptionNode":"$L17b9"},"country_code":{"type":"string","pattern":"^[A-Z]{2}$","description":"ISO 2-letter country code.","minLength":2,"maxLength":2,"descriptionNode":"$L17ba"},"country_subdivision_code":{"type":"string","pattern":"^[A-Z]{2}-[A-Z0-9]{1,3}$","description":"The subdivision code represents the state, province, or region within the country, following the [ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2) standard. This code uniquely identifies subdivisions within a country. \n\nFor example, for London in the United Kingdom, use `GB-LND`.\n\n:::warning\nThe parameter is required for countries listed on the [ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2) page.\n:::","minLength":5,"maxLength":6,"descriptionNode":"$L17bb"},"postcode":{"type":"string","description":"Postal code of the address.","maxLength":100,"descriptionNode":"$L17bc"}},"required":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:2:properties:seller:properties:address:required","descriptionNode":"$L17bd"}},"required":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:2:properties:seller:required","descriptionNode":"$L17be"}},"required":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:2:required","descriptionNode":"$L17bf"},{"type":"object","description":"This object is required by Mastercard and Visa for merchants operating as marketplaces under the Merchant Category Code (MCC) `5262`. The marketplace object ensures compliance with the card schemes' regulations by providing detailed information about the seller involved in the transaction.\n\n:::info\nThese are the specific data field requirements for merchants who must provide marketplace data.\n\n```\nseller.id\nseller.name\nseller.website\nseller.phone\nseller.address\n```\n:::","properties":{"type":{"type":"string","enum":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:0:properties:type:enum","description":"Type of the industry-specific data object, determining what additional data is expected.\n\nAvailable types:\n\n | Object type | Description |\n | ------------- | ----------- |\n | `airline` | Object containing information about a specific airline ticket purchase. |\n | `car_rental` | Object containing information about a car rental booking associated with the order. |\n | `crypto` | Object containing information about crypto transactions associated with the order. |\n | `marketplace` | This object is required by Mastercard and Visa for merchants operating as marketplaces under the **Merchant Category Code (MCC):** `5262`. The marketplace object ensures compliance with the card schemes' regulations by providing detailed information about the subseller involved in the transaction. |\n | `event` | Object containing information about event ticket bookings associated with the order. |\n | `lodging` | Object containing information about lodging bookings associated with the order. |","descriptionNode":"$L17c0"},"seller":{"type":"object","description":"Information about the subseller on the marketplace platform.","properties":{"id":{"type":"string","description":"The ID of the seller in the merchant's internal system.","minLength":1,"maxLength":15,"descriptionNode":"$L17c1"},"name":{"type":"string","description":"The business or legal name of the seller.","minLength":1,"maxLength":50,"descriptionNode":"$L17c2"},"website":{"type":"string","format":"uri","pattern":"^https?:\\/{2}.+/gi","maxLength":255,"description":"The URL of the website of the seller.\n\n:::warning\nRestrictions:\n- Must be a valid URI as defined by [RFC 3986](https://datatracker.ietf.org/doc/html/rfc3986)\n- URI scheme is required and must be either `http` or `https`\n- URI host is required and cannot be `localhost` or an IP address\n- Max length: `255`\n- Reserved or invalid characters must be percent-encoded (for example, use `%20` instead of a space)\n:::","descriptionNode":"$L17c3"},"phone":{"type":"string","description":"The phone number of the seller.","descriptionNode":"$L17c4"},"address":{"type":"object","description":"Details of a physical address.","properties":{"street_line_1":"$1d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:2:properties:seller:properties:address:properties:street_line_1","street_line_2":"$1d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:2:properties:seller:properties:address:properties:street_line_2","region":"$1d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:2:properties:seller:properties:address:properties:region","city":"$1d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:2:properties:seller:properties:address:properties:city","country_code":"$1d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:2:properties:seller:properties:address:properties:country_code","country_subdivision_code":"$1d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:2:properties:seller:properties:address:properties:country_subdivision_code","postcode":"$1d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:2:properties:seller:properties:address:properties:postcode"},"required":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:2:properties:seller:properties:address:required","descriptionNode":"$L17c5"}},"required":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:3:properties:seller:required","descriptionNode":"$L17c6"}},"required":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:3:required","descriptionNode":"$L17c7"},{"type":"object","description":"Object containing booking information for a list of event tickets associated with the order.\n\n:::info\nThese are the specific data field requirements for merchants who must provide event data. Note that these requirements can be extended on a case by case basis as decided by Revolut.\n\n```\nbooking_id\nevents[].start_date\nevents[].end_date\nevents[].supplier\nevents[].tickets[].id\n```\n:::","properties":{"type":{"type":"string","enum":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:0:properties:type:enum","description":"Type of the industry-specific data object, determining what additional data is expected.\n\nAvailable types:\n\n | Object type | Description |\n | ------------- | ----------- |\n | `airline` | Object containing information about a specific airline ticket purchase. |\n | `car_rental` | Object containing information about a car rental booking associated with the order. |\n | `crypto` | Object containing information about crypto transactions associated with the order. |\n | `marketplace` | This object is required by Mastercard and Visa for merchants operating as marketplaces under the **Merchant Category Code (MCC):** `5262`. The marketplace object ensures compliance with the card schemes' regulations by providing detailed information about the subseller involved in the transaction. |\n | `event` | Object containing information about event ticket bookings associated with the order. |\n | `lodging` | Object containing information about lodging bookings associated with the order. |","descriptionNode":"$L17c8"},"booking_id":{"type":"string","description":"A unique identifier provided by the merchant associated with the order. \n\nThis `booking_id` is used to reference and correlate booking information with the Merchant API and the merchant's internal system.","descriptionNode":"$L17c9"},"events":{"type":"array","description":"A list of events associated with the booking.","items":{"type":"object","description":"Object containing booking information about a specific event. ","properties":{"start_date":{"type":"string","format":"date-time","description":"[ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time when the event starts.","descriptionNode":"$L17ca"},"end_date":{"type":"string","format":"date-time","description":"[ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time when the event ends.","descriptionNode":"$L17cb"},"supplier":{"type":"string","description":"Legal name of the ticket vendor/event organiser.","descriptionNode":"$L17cc"},"supplier_payment_date":{"type":"string","format":"date-time","description":"[ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time when the funds are released to merchants.","descriptionNode":"$L17cd"},"name":{"type":"string","description":"The name of the event.","descriptionNode":"$L17ce"},"location":{"type":"object","description":"The address of the event location.","properties":{"street_line_1":{"type":"string","description":"Primary address line.","maxLength":100,"descriptionNode":"$L17cf"},"street_line_2":{"type":"string","description":"Secondary address line, such as floor and apartment number.","maxLength":100,"descriptionNode":"$L17d0"},"region":{"type":"string","description":"State or province of the address.","maxLength":100,"descriptionNode":"$L17d1"},"city":{"type":"string","description":"City of the address.","maxLength":100,"descriptionNode":"$L17d2"},"country_code":{"type":"string","pattern":"^[A-Z]{2}$","description":"ISO 2-letter country code.","minLength":2,"maxLength":2,"descriptionNode":"$L17d3"},"postcode":{"type":"string","description":"Postal code of the address.","maxLength":100,"descriptionNode":"$L17d4"}},"required":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:4:properties:events:items:properties:location:required","descriptionNode":"$L17d5"},"category":{"type":"string","enum":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:4:properties:events:items:properties:category:enum","description":"The type of the event.","descriptionNode":"$L17d6"},"market":{"type":"string","enum":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:4:properties:events:items:properties:market:enum","description":"Indicates the relationship between the ticket vendor and the event organiser. \n\n| Parameter value | Description |\n| --------------- | ----------- |\n| `primary` | The merchant is the organiser and primary distributor of the tickets. |\n| `secondary` | The merchant is a reseller, only distributing the tickets. |","descriptionNode":"$L17d7"},"tickets":{"type":"array","items":{"type":"object","description":"Object containing information about a ticket associated with the booking.","properties":{"id":{"type":"string","description":"A unique identifier provided by the merchant associated with the ticket.","descriptionNode":"$L17d8"},"transferable":{"type":"boolean","description":"Indicates whether the ticket is transferable to another buyer.","descriptionNode":"$L17d9"},"refundability":{"type":"string","enum":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:0:properties:refundability:enum","description":"Parameter indicating whether the booking is refundable, partially refundable, or not refundable.","descriptionNode":"$L17da"}},"required":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:4:properties:events:items:properties:tickets:items:required","descriptionNode":"$L17db"},"description":"A list of tickets associated with the booking.","descriptionNode":"$L17dc"}},"descriptionNode":"$L17dd"},"descriptionNode":"$L17de"}},"required":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:4:required","descriptionNode":"$L17df"},{"type":"object","description":"Object containing details of a lodging booking.\n\n:::info\nThese are the specific data field requirements for merchants who must provide lodging data. Note that these requirements can be extended on a case by case basis as decided by Revolut.\n\n```\nbooking_id\ncheck_in_date\ncheck_out_date\nsupplier_payment_date\n```\n:::","properties":{"type":{"type":"string","enum":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:0:properties:type:enum","description":"Type of the industry-specific data object, determining what additional data is expected.\n\nAvailable types:\n\n | Object type | Description |\n | ------------- | ----------- |\n | `airline` | Object containing information about a specific airline ticket purchase. |\n | `car_rental` | Object containing information about a car rental booking associated with the order. |\n | `crypto` | Object containing information about crypto transactions associated with the order. |\n | `marketplace` | This object is required by Mastercard and Visa for merchants operating as marketplaces under the **Merchant Category Code (MCC):** `5262`. The marketplace object ensures compliance with the card schemes' regulations by providing detailed information about the subseller involved in the transaction. |\n | `event` | Object containing information about event ticket bookings associated with the order. |\n | `lodging` | Object containing information about lodging bookings associated with the order. |","descriptionNode":"$L17e0"},"booking_id":{"type":"string","description":"A unique identifier provided by the merchant associated with the order. \n\nThis `booking_id` is used to reference and correlate booking information with the Merchant API and the merchant's internal system.","descriptionNode":"$L17e1"},"check_in_date":{"type":"string","format":"date-time","description":"[ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time of the check-in.","descriptionNode":"$L17e2"},"check_out_date":{"type":"string","format":"date-time","description":"[ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time of the check-out.","descriptionNode":"$L17e3"},"supplier_payment_date":{"type":"string","format":"date-time","description":"[ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time when the funds are released to merchants.","descriptionNode":"$L17e4"},"category":{"type":"string","enum":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:5:properties:category:enum","description":"The type of the accommodation associated with the booking.","descriptionNode":"$L17e5"},"booking_type":{"type":"string","enum":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:5:properties:booking_type:enum","description":"Indicates whether the booking terms are fixed or flexible.\n\n| Parameter value | Description |\n| --------------- | ----------- |\n| `fixed` | Non-modifiable once confirmed. |\n| `flexible` | Allows modifications or cancellations under specified conditions. |","descriptionNode":"$L17e6"},"refundability":{"type":"string","enum":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:0:properties:refundability:enum","description":"Parameter indicating whether the booking is refundable, partially refundable, or not refundable.","descriptionNode":"$L17e7"},"location":{"type":"object","description":"Address of the accommodation.","properties":{"street_line_1":{"type":"string","description":"Primary address line.","maxLength":100,"descriptionNode":"$L17e8"},"street_line_2":{"type":"string","description":"Secondary address line, such as floor and apartment number.","maxLength":100,"descriptionNode":"$L17e9"},"region":{"type":"string","description":"State or province of the address.","maxLength":100,"descriptionNode":"$L17ea"},"city":{"type":"string","description":"City of the address.","maxLength":100,"descriptionNode":"$L17eb"},"country_code":{"type":"string","pattern":"^[A-Z]{2}$","description":"ISO 2-letter country code.","minLength":2,"maxLength":2,"descriptionNode":"$L17ec"},"postcode":{"type":"string","description":"Postal code of the address.","maxLength":100,"descriptionNode":"$L17ed"}},"required":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:5:properties:location:required","descriptionNode":"$L17ee"},"guests":{"type":"array","items":{"type":"object","properties":{"first_name":{"type":"string","description":"Guest's first name.","descriptionNode":"$L17ef"},"last_name":{"type":"string","description":"Guest's last name.","descriptionNode":"$L17f0"}},"required":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:5:properties:guests:items:required"},"description":"List of guests associated with the booking.","descriptionNode":"$L17f1"}},"required":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:5:required","descriptionNode":"$L17f2"}],"descriptionNode":"$L17f3"},"merchant_order_data":{"type":"object","description":"Object for providing additional information stored in the merchant's order management system. ","properties":{"url":{"type":"string","format":"uri","pattern":"^https?:\\/{2}.+/gi","maxLength":2000,"description":"The URL of the order stored in the merchant's order management system.\n\nThis URL will be included in the order confirmation email for payments made via Revolut Pay. If specified, this URL will override the default link to the merchant's **Business website** configured in the Revolut Business account.\n\n:::warning\nRestrictions:\n- Must be a valid URI as defined by [RFC 3986](https://datatracker.ietf.org/doc/html/rfc3986)\n- URI scheme is required and must be either `http` or `https`\n- URI host is required and cannot be `localhost` or an IP address\n- Max length: `2000`\n- Reserved or invalid characters must be percent-encoded (for example, use `%20` instead of a space)\n:::","descriptionNode":"$L17f4"},"reference":{"type":"string","description":"Merchant order ID for external reference.\n\nUse this field to set the ID that your own system can use to easily track orders.","descriptionNode":"$L17f5"}},"descriptionNode":"$L17f6"},"upcoming_payment_data":{"type":"object","description":"Object containing information about upcoming payments associated with the order.","properties":{"date":{"type":"string","format":"date-time","description":"The date and time in [ISO 8601 format](https://en.wikipedia.org/wiki/ISO_8601) when the upcoming payment is scheduled to be executed.","descriptionNode":"$L17f7"},"payment_method_id":{"type":"string","description":"The unique ID of the customer's payment method used to complete the scheduled payment.\n\n:::info\nFor more information about operations related to customer's payment methods, see:\n - [Retrieve payment method list of a customer](https://developer.revolut.com/docs/api/merchant#retrieve-payment-method-list)\n - [Retrieve a customer's payment method](https://developer.revolut.com/docs/api/merchant#retrieve-payment-method)\n - [Update a customer's payment method](https://developer.revolut.com/docs/api/merchant#update-payment-method)\n - [Delete a customer's payment method](https://developer.revolut.com/docs/api/merchant#delete-payment-method)\n:::","descriptionNode":"$L17f8"}},"required":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:upcoming_payment_data:required","descriptionNode":"$L17f9"},"checkout_url":{"type":"string","description":"Link to a checkout page hosted by Revolut.","format":"uri","descriptionNode":"$L17fa"},"redirect_url":{"type":"string","format":"uri","pattern":"^https?:\\/{2}.+/gi","maxLength":2000,"description":"The URL your customer will be redirected to after a successful payment on the hosted checkout page (`checkout_url` parameter's value of the order).\n\n:::warning\nRestrictions:\n- Must be a valid URI as defined by [RFC 3986](https://datatracker.ietf.org/doc/html/rfc3986)\n- URI scheme is required and must be either `http` or `https`\n- URI host is required and cannot be `localhost` or an IP address\n- Max length: `2000`\n- Reserved or invalid characters must be percent-encoded (for example, use `%20` instead of a space)\n:::\n\n:::info\nFor more information on how to use the `redirect_url`, see: [Custom redirection via the API](https://developer.revolut.com/docs/guides/merchant/accept-payments/online-payments/hosted-checkout-page/api#custom-post-payment-redirection-optional)\n:::","descriptionNode":"$L17fb"},"shipping":{"type":"object","description":"Details about the shipping related to the order, including address, contact information, and individual shipments.\n\n:::info\nRequired for merchants shipping physical goods. Omitting this information may trigger additional scrutiny and risk mitigation actions by Revolut.\n:::","properties":{"address":{"type":"object","description":"Details of a physical address.","properties":{"street_line_1":{"type":"string","description":"Primary address line.","maxLength":100,"descriptionNode":"$L17fc"},"street_line_2":{"type":"string","description":"Secondary address line, such as floor and apartment number.","maxLength":100,"descriptionNode":"$L17fd"},"region":{"type":"string","description":"State or province of the address.","maxLength":100,"descriptionNode":"$L17fe"},"city":{"type":"string","description":"City of the address.","maxLength":100,"descriptionNode":"$L17ff"},"country_code":{"type":"string","pattern":"^[A-Z]{2}$","description":"ISO 2-letter country code.","minLength":2,"maxLength":2,"descriptionNode":"$L1800"},"postcode":{"type":"string","description":"Postal code of the address.","maxLength":100,"descriptionNode":"$L1801"}},"required":"$60:props:children:0:props:children:props:responses:200:content:application/json:schema:oneOf:1:properties:details:properties:address:required","descriptionNode":"$L1802"},"contact":{"type":"object","description":"Contact details for someone responsible for the shipment.\n\n:::warning\nAt least `email` or `phone` is required.\n:::","properties":{"name":{"type":"string","description":"Full name of the contact person.","maxLength":250,"descriptionNode":"$L1803"},"email":{"type":"string","format":"email","description":"Email address of the contact person.","descriptionNode":"$L1804"},"phone":{"type":"string","description":"Phone number of the contact person.","descriptionNode":"$L1805"}},"descriptionNode":"$L1806"},"shipments":{"type":"array","description":"List of individual shipment details.","maxItems":50,"items":{"type":"object","description":"Details of an individual shipment.","properties":{"shipping_company_name":{"type":"string","maxLength":250,"description":"Name of the company handling the shipment.","descriptionNode":"$L1807"},"tracking_number":{"type":"string","maxLength":500,"description":"Unique tracking number for the shipment.","descriptionNode":"$L1808"},"estimated_delivery_date":{"type":"string","format":"date-time","description":"Estimated delivery date and time for the shipment. \nThe time should also include the customer's timezone.","descriptionNode":"$L1809"},"tracking_url":{"type":"string","format":"uri","pattern":"^https?:\\/{2}.+/gi","maxLength":2000,"description":"An HTTP/HTTPS URL where the shipment can be tracked.\n\n:::warning\nRestrictions:\n- Must be a valid URI as defined by [RFC 3986](https://datatracker.ietf.org/doc/html/rfc3986)\n- URI scheme is required and must be either `http` or `https`\n- URI host is required and cannot be `localhost` or an IP address\n- Max length: `2000`\n- Reserved or invalid characters must be percent-encoded (for example, use `%20` instead of a space)\n:::","descriptionNode":"$L180a"}},"required":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:shipping:properties:shipments:items:required","descriptionNode":"$L180b"},"descriptionNode":"$L180c"}},"descriptionNode":"$L180d"},"enforce_challenge":{"type":"string","description":"The enforce challenge mode. `automatic` is used by default.\n\n| Parameter value | Description |\n| --------------- | ----------- |\n| `automatic` | The payments created for an order will have challenge requirement calculated by our fraud mechanisms. Not all payments will trigger a 3DS challenge. |\n| `forced` | The payments created for an order will always require a 3DS challenge. Currently only supported for card payments. |","default":"automatic","enum":"$19:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:orders:items:properties:enforce_challenge:enum","descriptionNode":"$L180e"},"line_items":{"type":"array","maxItems":250,"description":"An array of line items included in the order. Each line item represents an individual product or service, along with its quantity, price, taxes, and discounts.\n\n:::info\nRequired for merchants collecting payment for one or multiple products/services in one transaction. Omitting this information may trigger additional scrutiny and risk mitigation actions by Revolut.\n:::","items":{"type":"object","properties":{"name":"$1d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:incremental_authorisations:items:properties:line_items:items:properties:name","type":"$1d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:incremental_authorisations:items:properties:line_items:items:properties:type","quantity":"$1d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:incremental_authorisations:items:properties:line_items:items:properties:quantity","unit_price_amount":"$1d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:incremental_authorisations:items:properties:line_items:items:properties:unit_price_amount","total_amount":"$1d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:incremental_authorisations:items:properties:line_items:items:properties:total_amount","external_id":"$1d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:incremental_authorisations:items:properties:line_items:items:properties:external_id","discounts":"$1d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:incremental_authorisations:items:properties:line_items:items:properties:discounts","taxes":"$1d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:incremental_authorisations:items:properties:line_items:items:properties:taxes","image_urls":"$1d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:incremental_authorisations:items:properties:line_items:items:properties:image_urls","description":"$1d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:incremental_authorisations:items:properties:line_items:items:properties:description","url":"$1d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:incremental_authorisations:items:properties:line_items:items:properties:url"},"required":"$19:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:orders:items:properties:line_items:items:required"},"descriptionNode":"$L180f"},"statement_descriptor_suffix":{"type":"string","description":"$1810","minLength":1,"maxLength":19,"pattern":"^[^*\\n\\r\\\\]+$","descriptionNode":"$L1811"},"related_order_id":{"type":"string","format":"uuid","description":"The unique ID of the original order that was refunded and this refund is associated with. You can use this ID to get more information about the related order using the [Retrieve an order](https://developer.revolut.com/docs/api/merchant#retrieve-order) operation.\n\n:::note\nThis field is only returned for orders with `type: refund`.\n:::","descriptionNode":"$L1812"},"subscription_data":{"title":"Subscription data","type":"object","required":"$19:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:orders:items:properties:subscription_data:required","description":"Subscription details linked to the order. Use this object to match an order with its underlying subscription and understand the billing context in which the order was created.\n\nOnly present on orders created by a subscription.","properties":{"subscription_id":{"type":"string","format":"uuid","description":"Unique identifier for the subscription.","descriptionNode":"$L1813"},"active_cycle_id":{"type":"string","format":"uuid","description":"The unique identifier of the active (pre-paid) subscription cycle that this order collects payment for.\n\nThis is the current billing cycle whose recurring charges are being collected in advance by this order. For example, if a subscription cycle covers 1-31 July and the order is generated on 1 July, this field identifies that July cycle.","descriptionNode":"$L1814"},"settled_cycle_id":{"type":"string","format":"uuid","description":"The unique identifier of the settled (post-paid) subscription cycle whose usage-based charges this order collects.\n\nThis is the previous billing cycle whose usage is being settled by this order. For example, if a subscription cycle covers usage from 1-30 June and the order is generated on 10 July, this field identifies that June cycle.","descriptionNode":"$L1815"},"billing_reason":{"type":"string","enum":"$19:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:orders:items:properties:subscription_data:properties:billing_reason:enum","description":"The reason this subscription order was created.\n\n| Value | Description |\n| ----- | ----------- |\n| `cycle_billing` | The order was automatically generated to collect payment for an ongoing subscription cycle. `active_cycle_id` is present; `settled_cycle_id` is present if the previous cycle included usage-based products. |\n| `final_settlement` | The order was automatically generated after the subscription ended to collect outstanding usage-based charges. `active_cycle_id` is absent; `settled_cycle_id` is present. |\n| `setup_intent` | The order was manually created by the merchant or customer to update the payment method on file. `active_cycle_id` is absent; `settled_cycle_id` is absent. |","descriptionNode":"$L1816"}},"descriptionNode":"$L1817"}},"descriptionNode":"$L1818"},"examples":{"captured_order_minimal":{"summary":"Captured order (minimal)","value":{"id":"65c4c739-113d-a608-9128-47c7ca90cbe3","token":"ebc06202-061e-4d0f-8063-99195fad31fb","type":"payment","state":"completed","created_at":"2024-02-08T12:21:13.022871Z","updated_at":"2024-02-08T12:21:52.194601Z","amount":100,"currency":"GBP","refunded_amount":0,"outstanding_amount":0,"capture_mode":"manual","payments":[{"id":"65c4c748-bf0d-af8a-9d69-0fc92bc0ff94","state":"captured","created_at":"2024-02-08T12:21:28.803165Z","updated_at":"2024-02-08T12:21:52.191352Z","token":"74af5a2b-6722-4353-aaf1-cd5926883b60","amount":100,"currency":"GBP","settled_amount":100,"settled_currency":"GBP","billing_address":{"country_code":"US","postcode":"12345"},"risk_level":"low","fees":[],"payer":{"email":"example.payer@example.com","phone":"+447911123456"},"payment_method":{"type":"revolut_pay_card","card_brand":"visa","funding":"debit","card_country_code":"US","card_bin":"529999","card_last_four":"0368","card_expiry":"12/28","cardholder_name":"Test Holder","checks":{"three_ds":{"state":"verified","version":2}},"enforce_challenge":"automatic","fingerprint":"1JAllfQY4POhBV8DaddAQ4LC5RbMP8LMLvUdJW4s5JY=","network_transaction_id":"1234567890123456"}}]}},"captured_order_line_items":{"summary":"Captured order with line items","value":{"id":"65c4c739-113d-a608-9128-47c7ca90cbe3","token":"ebc06202-061e-4d0f-8063-99195fad31fb","type":"payment","state":"completed","created_at":"2024-02-08T12:21:13.022871Z","updated_at":"2024-02-08T12:21:52.194601Z","amount":770,"currency":"GBP","refunded_amount":0,"outstanding_amount":0,"capture_mode":"manual","line_items":[{"name":"Example item 1","type":"physical","quantity":{"value":2,"unit":"kg"},"unit_price_amount":100,"total_amount":170,"external_id":"external_id_123","discounts":[{"name":"Discount 1","amount":50}],"taxes":[{"name":"10% VAT","amount":20}]},{"name":"Example item 2","type":"service","quantity":{"value":10,"unit":"pieces"},"unit_price_amount":100,"total_amount":600,"external_id":"external_id_456","discounts":[{"name":"Discount 2","amount":500}],"taxes":[{"name":"10% VAT","amount":100}]}],"payments":[{"id":"65c4c748-bf0d-af8a-9d69-0fc92bc0ff94","state":"captured","created_at":"2024-02-08T12:21:28.803165Z","updated_at":"2024-02-08T12:21:52.191352Z","token":"74af5a2b-6722-4353-aaf1-cd5926883b60","amount":770,"currency":"GBP","settled_amount":770,"settled_currency":"GBP","billing_address":{"country_code":"US","postcode":"12345"},"risk_level":"low","fees":[],"payer":{"email":"example.payer@example.com","phone":"+447911123456"},"payment_method":{"type":"revolut_pay_card","card_brand":"visa","funding":"debit","card_country_code":"US","card_bin":"529999","card_last_four":"0368","card_expiry":"12/28","cardholder_name":"Test Holder","checks":{"three_ds":{"state":"verified","version":2}},"enforce_challenge":"automatic","fingerprint":"1JAllfQY4POhBV8DaddAQ4LC5RbMP8LMLvUdJW4s5JY=","network_transaction_id":"1234567890123456"}}]}}}}},"descriptionNode":"$L1819"},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"code":{"type":"string","description":"An identifier that can be used to determine what went wrong.\n\nError codes are not globally unique, but uniqueness is guaranteed within endpoints.","descriptionNode":"$L181a"},"message":{"type":"string","description":"Some human readable text describing what went wrong.","descriptionNode":"$L181b"},"timestamp":{"type":"integer","description":"The [UNIX timestamp](https://www.unixtimestamp.com/) of the date and time the error happened.","descriptionNode":"$L181c"}}},"examples":{"example-1":{"value":{"code":"bad_request","message":"Could not parse JSON","timestamp":1601296792533}}}}},"descriptionNode":"$L181d"},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"code":{"type":"string","description":"An identifier that can be used to determine what went wrong.\n\nError codes are not globally unique, but uniqueness is guaranteed within endpoints.","descriptionNode":"$L181e"},"message":{"type":"string","description":"Some human readable text describing what went wrong.","descriptionNode":"$L181f"},"timestamp":{"type":"integer","description":"The [UNIX timestamp](https://www.unixtimestamp.com/) of the date and time the error happened.","descriptionNode":"$L1820"}}},"examples":{"default":{"value":{"code":"unauthenticated","message":"Authentication failed","timestamp":1721049596461}}}}},"descriptionNode":"$L1821"},"404":{"description":"Not Found","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"code":{"type":"string","description":"An identifier that can be used to determine what went wrong.\n\nError codes are not globally unique, but uniqueness is guaranteed within endpoints.","descriptionNode":"$L1822"},"message":{"type":"string","description":"Some human readable text describing what went wrong.","descriptionNode":"$L1823"},"timestamp":{"type":"integer","description":"The [UNIX timestamp](https://www.unixtimestamp.com/) of the date and time the error happened.","descriptionNode":"$L1824"}}},"examples":{"default":{"value":{"code":"not_found","message":"Order with id abfa5bbd-a20c-4a0e-be66-30e733454518 was not found","timestamp":1721050063886}}}}},"descriptionNode":"$L1825"}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","description":"Order capture request parameters.\n\nYou can optionally provide line items when capturing an order. This is useful when you need to adjust the final order details at capture time (for example, when doing partial captures with specific items, or when the final delivered items differ from the initial authorisation).\n\n:::warning\nIf you provide `line_items` when capturing, they will **overwrite** the original line items that were provided during order creation or update. Make sure to include all the items you want to be associated with the captured order.\n:::","properties":{"amount":{"type":"integer","description":"Specify an amount to capture, in minor currency units. The amount must not exceed the authorised amount.\n\nAn order can only be captured once. Partial capture is supported by sending an amount lower than the authorised amount. The uncaptured amount will be voided.\n\nIf you resend a capture request for an order that is already captured, no additional capture is performed. Resending with the same amount returns the current order state, while resending with a different amount returns an error.\n\nIf not provided, it defaults to the authorised amount (full capture will be executed).","descriptionNode":"$L1826"},"line_items":{"type":"array","maxItems":250,"description":"An array of line items included in the order. Each line item represents an individual product or service, along with its quantity, price, taxes, and discounts.\n\n:::info\nRequired for merchants collecting payment for one or multiple products/services in one transaction. Omitting this information may trigger additional scrutiny and risk mitigation actions by Revolut.\n:::","items":{"type":"object","properties":{"name":{"type":"string","maxLength":250,"description":"Name of the line item.","descriptionNode":"$L1827"},"type":{"type":"string","enum":"$19:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:orders:items:properties:line_items:items:properties:type:enum","description":"Type of the line item.","descriptionNode":"$L1828"},"quantity":{"type":"object","description":"Object representing the quantity details of a line item, including the amount and its associated unit of measurement.","properties":{"value":{"type":"number","format":"double","minimum":0,"description":"The number of units of the line item.","descriptionNode":"$L1829"},"unit":{"type":"string","maxLength":100,"description":"The measurement unit for the quantity, such as `cm`, or `kg`.","descriptionNode":"$L182a"}},"required":"$19:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:orders:items:properties:line_items:items:properties:quantity:required","descriptionNode":"$L182b"},"unit_price_amount":{"type":"integer","format":"int64","minimum":0,"description":"The unit price of the line item.","descriptionNode":"$L182c"},"total_amount":{"type":"integer","format":"int64","description":"The total amount to be paid for the line item, including taxes and discounts.","descriptionNode":"$L182d"},"external_id":{"type":"string","maxLength":250,"description":"Unique identifier of line item in the merchant's system.","descriptionNode":"$L182e"},"discounts":{"type":"array","maxItems":50,"description":"A list of discounts applied to the line item. Each discount should be subtracted from the total amount payable for the item.","items":{"type":"object","description":"Details of a discount applied to the line item, including its name and monetary value.","properties":{"name":{"type":"string","maxLength":100,"description":"The specific name or label of the discount applied to the line item.","descriptionNode":"$L182f"},"amount":{"type":"integer","format":"int64","minimum":0,"description":"The monetary value of the discount. ","descriptionNode":"$L1830"}},"required":"$19:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:orders:items:properties:line_items:items:properties:discounts:items:required","descriptionNode":"$L1831"},"descriptionNode":"$L1832"},"taxes":{"type":"array","maxItems":50,"description":"A list of taxes applied to the line item. Each tax should be added to the total amount payable for the item.","items":{"type":"object","description":"Details about a tax applied to the line item, including its name and the corresponding amount.","properties":{"name":{"type":"string","description":"The specific name or designation of the tax applied to the line item.","maxLength":100,"descriptionNode":"$L1833"},"amount":{"type":"integer","format":"int64","description":"The monetary value of the tax in minor currency units (e.g., cents for EUR).","minimum":0,"descriptionNode":"$L1834"}},"required":"$19:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:orders:items:properties:line_items:items:properties:taxes:items:required","descriptionNode":"$L1835"},"descriptionNode":"$L1836"},"image_urls":{"type":"array","maxItems":50,"description":"A list of URLs pointing to images related to the line item. These images can provide visual details or representations of the item.","items":{"type":"string","format":"uri","pattern":"^https?:\\/{2}.+/gi","maxLength":2000,"description":"URL to an image associated with the line item.\n\n:::warning\nRestrictions:\n- Must be a valid URI as defined by [RFC 3986](https://datatracker.ietf.org/doc/html/rfc3986)\n- URI scheme is required and must be either `http` or `https`\n- URI host is required and cannot be `localhost` or an IP address\n- Max length: `2000`\n- Reserved or invalid characters must be percent-encoded (for example, use `%20` instead of a space)\n:::","descriptionNode":"$L1837"},"descriptionNode":"$L1838"},"description":{"type":"string","maxLength":1024,"description":"Description of the line item.","descriptionNode":"$L1839"},"url":{"type":"string","format":"uri","pattern":"^https?:\\/{2}.+/gi","maxLength":2000,"description":"An HTTP/HTTPS URL that links to more information about the line item, such as a product page or details.\n\n:::warning\nRestrictions:\n- Must be a valid URI as defined by [RFC 3986](https://datatracker.ietf.org/doc/html/rfc3986)\n- URI scheme is required and must be either `http` or `https`\n- URI host is required and cannot be `localhost` or an IP address\n- Max length: `2000`\n- Reserved or invalid characters must be percent-encoded (for example, use `%20` instead of a space)\n:::","descriptionNode":"$L183a"}},"required":"$19:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:orders:items:properties:line_items:items:required"},"descriptionNode":"$L183b"}},"descriptionNode":"$L183c"},"examples":{"example_minimal":{"summary":"Capture with amount only","value":{"amount":100}},"example_with_line_items":{"summary":"Capture with amount and line items","value":{"amount":770,"line_items":[{"name":"Example item 1","type":"physical","quantity":{"value":2,"unit":"kg"},"unit_price_amount":100,"total_amount":170,"external_id":"external_id_123","discounts":[{"name":"Discount 1","amount":50}],"taxes":[{"name":"10% VAT","amount":20}]},{"name":"Example item 2","type":"service","quantity":{"value":10,"unit":"pieces"},"unit_price_amount":100,"total_amount":600,"external_id":"external_id_456","discounts":[{"name":"Discount 2","amount":500}],"taxes":[{"name":"10% VAT","amount":100}]}]}}}}}},"variantLabels":["Captured order (minimal)","Captured order with line items"],"children":["$L183d","$L183e"]}]}],false]}] 183d:["$","div",null,{"className":"ezz1n30","children":[["$","div",null,{"data-header":"$undefined","className":"ezz1n31","children":["$","div",null,{"className":"y9a0do1","children":[["$","h2",null,{"id":"capture-order","children":[["$L183f","$undefined"],["$","$L15",null,{"id":"capture-order"}]]}],["$","$L16",null,{"url":"/docs/api/merchant/2025-10-16/operations/capture-order.md"}]]}]}],"$undefined"]}] 1845:T638,
curl -X POST "https://merchant.revolut.com/api/orders/__RP_TOK_0__/capture" \
  -H "Content-Type: application/json" \
  -H "Authorization: __RP_TOK_1__" \
  -H "Revolut-Api-Version: __RP_TOK_2__" \
  -d '{
  "amount": 100
}'
1846:Te81,
const payload = {
  "amount": 100
};
fetch("https://merchant.revolut.com/api/orders/__RP_TOK_0__/capture", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "__RP_TOK_1__",
    "Revolut-Api-Version": "__RP_TOK_2__"
  },
  body: JSON.stringify(payload)
})
  .then(response => response.json())
  .then(data => console.log(data));
1847:T161d,
package main

import (
  "fmt"
  "net/http"
  "bytes"
  "encoding/json"
)

func main() {
  url := "https://merchant.revolut.com/api/orders/__RP_TOK_0__/capture"
  jsonData := []byte(`
{
  "amount": 100
}
  `)
  req, _ := http.NewRequest("POST", url, bytes.NewBuffer(jsonData))
  req.Header.Add("Content-Type", "application/json")
  req.Header.Add("Authorization", "__RP_TOK_1__")
  req.Header.Add("Revolut-Api-Version", "__RP_TOK_2__")

  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  fmt.Println(res)
}
1848:Tbb5,
import requests

url = "https://merchant.revolut.com/api/orders/__RP_TOK_0__/capture"
headers = {
  "Content-Type": "application/json",
  "Authorization": "__RP_TOK_1__",
  "Revolut-Api-Version": "__RP_TOK_2__"
}
payload = {
  "amount": 100
}

response = requests.post(url, headers=headers, json=payload)
print(response.json())
1849:T1b81,
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;

public class Main {
  public static void main(String[] args) {
    HttpClient client = HttpClient.newHttpClient();
    String body = """
{
  "amount": 100
}
    """;

    HttpRequest request = HttpRequest.newBuilder()
      .uri(URI.create("https://merchant.revolut.com/api/orders/__RP_TOK_0__/capture"))
      .header("Content-Type", "application/json")
      .header("Authorization", "__RP_TOK_1__")
      .header("Revolut-Api-Version", "__RP_TOK_2__")
      .POST(HttpRequest.BodyPublishers.ofString(body))
      .build();

    client.sendAsync(request, HttpResponse.BodyHandlers.ofString())
      .thenApply(HttpResponse::body)
      .thenAccept(System.out::println)
      .join();
  }
}
184a:T1cbf,
using System.Net.Http;
using System.Net.Http.Headers;

var client = new HttpClient();
var request = new HttpRequestMessage
{
  Method = HttpMethod.Post,
  RequestUri = new Uri("https://merchant.revolut.com/api/orders/__RP_TOK_0__/capture"),
  Headers =
  {
    { "Authorization", "__RP_TOK_1__" },
    { "Revolut-Api-Version", "__RP_TOK_2__" },
  },
  Content = new StringContent(@"{
  ""amount"": 100
}")
  {
    Headers =
    {
      ContentType = new MediaTypeHeaderValue("application/json")
    }
  }
};

using (var response = await client.SendAsync(request))
{
  response.EnsureSuccessStatusCode();
  var body = await response.Content.ReadAsStringAsync();
  Console.WriteLine(body);
}
184b:T640,
curl -X POST "https://sandbox-merchant.revolut.com/api/orders/__RP_TOK_0__/capture" \
  -H "Content-Type: application/json" \
  -H "Authorization: __RP_TOK_1__" \
  -H "Revolut-Api-Version: __RP_TOK_2__" \
  -d '{
  "amount": 100
}'
184c:Te89,
const payload = {
  "amount": 100
};
fetch("https://sandbox-merchant.revolut.com/api/orders/__RP_TOK_0__/capture", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "__RP_TOK_1__",
    "Revolut-Api-Version": "__RP_TOK_2__"
  },
  body: JSON.stringify(payload)
})
  .then(response => response.json())
  .then(data => console.log(data));
184d:T1625,
package main

import (
  "fmt"
  "net/http"
  "bytes"
  "encoding/json"
)

func main() {
  url := "https://sandbox-merchant.revolut.com/api/orders/__RP_TOK_0__/capture"
  jsonData := []byte(`
{
  "amount": 100
}
  `)
  req, _ := http.NewRequest("POST", url, bytes.NewBuffer(jsonData))
  req.Header.Add("Content-Type", "application/json")
  req.Header.Add("Authorization", "__RP_TOK_1__")
  req.Header.Add("Revolut-Api-Version", "__RP_TOK_2__")

  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  fmt.Println(res)
}
184e:Tbbd,
import requests

url = "https://sandbox-merchant.revolut.com/api/orders/__RP_TOK_0__/capture"
headers = {
  "Content-Type": "application/json",
  "Authorization": "__RP_TOK_1__",
  "Revolut-Api-Version": "__RP_TOK_2__"
}
payload = {
  "amount": 100
}

response = requests.post(url, headers=headers, json=payload)
print(response.json())
184f:T1b89,
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;

public class Main {
  public static void main(String[] args) {
    HttpClient client = HttpClient.newHttpClient();
    String body = """
{
  "amount": 100
}
    """;

    HttpRequest request = HttpRequest.newBuilder()
      .uri(URI.create("https://sandbox-merchant.revolut.com/api/orders/__RP_TOK_0__/capture"))
      .header("Content-Type", "application/json")
      .header("Authorization", "__RP_TOK_1__")
      .header("Revolut-Api-Version", "__RP_TOK_2__")
      .POST(HttpRequest.BodyPublishers.ofString(body))
      .build();

    client.sendAsync(request, HttpResponse.BodyHandlers.ofString())
      .thenApply(HttpResponse::body)
      .thenAccept(System.out::println)
      .join();
  }
}
1850:T1cc7,
using System.Net.Http;
using System.Net.Http.Headers;

var client = new HttpClient();
var request = new HttpRequestMessage
{
  Method = HttpMethod.Post,
  RequestUri = new Uri("https://sandbox-merchant.revolut.com/api/orders/__RP_TOK_0__/capture"),
  Headers =
  {
    { "Authorization", "__RP_TOK_1__" },
    { "Revolut-Api-Version", "__RP_TOK_2__" },
  },
  Content = new StringContent(@"{
  ""amount"": 100
}")
  {
    Headers =
    {
      ContentType = new MediaTypeHeaderValue("application/json")
    }
  }
};

using (var response = await client.SendAsync(request))
{
  response.EnsureSuccessStatusCode();
  var body = await response.Content.ReadAsStringAsync();
  Console.WriteLine(body);
}
183e:["$","div",null,{"className":"ezz1n30","children":[["$","div",null,{"data-header":"$undefined","className":"ezz1n31","children":["$L1840",["$","$L85",null,{"parameters":[{"name":"Authorization","in":"header","schema":{"type":"string","format":"Bearer ","examples":"$62:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:0:schema:examples"},"required":true,"description":"This parameter accepts the [Merchant API Secret key](https://business.revolut.com/settings/apis?tab=merchant-api) to authorise requests coming from the merchant's backend. \n\nIt ensures that ensures that each request is authenticated and authorised by verifying the secret key. The secret key should be included in all request headers as a `Bearer` token.\n\n:::info\nFor more information, see: [Authentication](https://developer.revolut.com/docs/api/merchant#authentication)\n:::","descriptionNode":"$L1841"},{"name":"Revolut-Api-Version","in":"header","schema":{"type":"string","format":"date","enum":"$36:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:1:schema:enum","examples":"$36:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:1:schema:examples"},"required":true,"description":"The version of the Merchant API, specified in `YYYY-MM-DD` format.\n\nIf not specified, you will receive an error.\n\n\n:::info\nFor more information about API versioning, see: [API versions](https://developer.revolut.com/docs/guides/merchant/reference/versioning/api-versions).\n:::","x-config-always-visible-in-example":true,"example":"2025-10-16","descriptionNode":"$L1842"},{"name":"order_id","in":"path","schema":{"type":"string","format":"uuid","description":"A UUID string, typically used to identify resources.","descriptionNode":"$L1843"},"required":true,"description":"The ID of the `Order` object.","descriptionNode":"$L1844"}],"requestBody":"$1d:props:children:0:props:children:props:requestBody","heading":"Request","requestBodySchemaTitle":"Request body","headingAs":"h3"}],["$","$L89",null,{"responses":"$1d:props:children:0:props:children:props:responses","headingAs":"h3"}]]}],["$","div",null,{"className":"ezz1n32","children":[[["$","$L8a",null,{"itemsByServer":{"https://merchant.revolut.com":[{"id":"curl","label":"cURL","templateCode":"curl -X POST \"https://merchant.revolut.com/api/orders/__RP_TOK_0__/capture\" \\\n -H \"Content-Type: application/json\" \\\n -H \"Authorization: __RP_TOK_1__\" \\\n -H \"Revolut-Api-Version: __RP_TOK_2__\" \\\n -d '{\n \"amount\": 100\n}'","templateHtml":"$1845","tokens":[{"marker":"__RP_TOK_0__","paramName":"order_id","paramIn":"path","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["shell-double-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:order_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"javascript","label":"JavaScript","templateCode":"const payload = {\n \"amount\": 100\n};\nfetch(\"https://merchant.revolut.com/api/orders/__RP_TOK_0__/capture\", {\n method: \"POST\",\n headers: {\n \"Content-Type\": \"application/json\",\n \"Authorization\": \"__RP_TOK_1__\",\n \"Revolut-Api-Version\": \"__RP_TOK_2__\"\n },\n body: JSON.stringify(payload)\n})\n .then(response => response.json())\n .then(data => console.log(data));","templateHtml":"$1846","tokens":[{"marker":"__RP_TOK_0__","paramName":"order_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:order_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"go","label":"Go","templateCode":"package main\n\nimport (\n \"fmt\"\n \"net/http\"\n \"bytes\"\n \"encoding/json\"\n)\n\nfunc main() {\n url := \"https://merchant.revolut.com/api/orders/__RP_TOK_0__/capture\"\n jsonData := []byte(`\n{\n \"amount\": 100\n}\n `)\n req, _ := http.NewRequest(\"POST\", url, bytes.NewBuffer(jsonData))\n req.Header.Add(\"Content-Type\", \"application/json\")\n req.Header.Add(\"Authorization\", \"__RP_TOK_1__\")\n req.Header.Add(\"Revolut-Api-Version\", \"__RP_TOK_2__\")\n\n res, _ := http.DefaultClient.Do(req)\n defer res.Body.Close()\n fmt.Println(res)\n}","templateHtml":"$1847","tokens":[{"marker":"__RP_TOK_0__","paramName":"order_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:order_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"python","label":"Python","templateCode":"import requests\n\nurl = \"https://merchant.revolut.com/api/orders/__RP_TOK_0__/capture\"\nheaders = {\n \"Content-Type\": \"application/json\",\n \"Authorization\": \"__RP_TOK_1__\",\n \"Revolut-Api-Version\": \"__RP_TOK_2__\"\n}\npayload = {\n \"amount\": 100\n}\n\nresponse = requests.post(url, headers=headers, json=payload)\nprint(response.json())","templateHtml":"$1848","tokens":[{"marker":"__RP_TOK_0__","paramName":"order_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:order_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"java","label":"Java","templateCode":"import java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\nimport java.net.URI;\n\npublic class Main {\n public static void main(String[] args) {\n HttpClient client = HttpClient.newHttpClient();\n String body = \"\"\"\n{\n \"amount\": 100\n}\n \"\"\";\n\n HttpRequest request = HttpRequest.newBuilder()\n .uri(URI.create(\"https://merchant.revolut.com/api/orders/__RP_TOK_0__/capture\"))\n .header(\"Content-Type\", \"application/json\")\n .header(\"Authorization\", \"__RP_TOK_1__\")\n .header(\"Revolut-Api-Version\", \"__RP_TOK_2__\")\n .POST(HttpRequest.BodyPublishers.ofString(body))\n .build();\n\n client.sendAsync(request, HttpResponse.BodyHandlers.ofString())\n .thenApply(HttpResponse::body)\n .thenAccept(System.out::println)\n .join();\n }\n}","templateHtml":"$1849","tokens":[{"marker":"__RP_TOK_0__","paramName":"order_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:order_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"csharp","label":"C#","templateCode":"using System.Net.Http;\nusing System.Net.Http.Headers;\n\nvar client = new HttpClient();\nvar request = new HttpRequestMessage\n{\n Method = HttpMethod.Post,\n RequestUri = new Uri(\"https://merchant.revolut.com/api/orders/__RP_TOK_0__/capture\"),\n Headers =\n {\n { \"Authorization\", \"__RP_TOK_1__\" },\n { \"Revolut-Api-Version\", \"__RP_TOK_2__\" },\n },\n Content = new StringContent(@\"{\n \"\"amount\"\": 100\n}\")\n {\n Headers =\n {\n ContentType = new MediaTypeHeaderValue(\"application/json\")\n }\n }\n};\n\nusing (var response = await client.SendAsync(request))\n{\n response.EnsureSuccessStatusCode();\n var body = await response.Content.ReadAsStringAsync();\n Console.WriteLine(body);\n}","templateHtml":"$184a","tokens":[{"marker":"__RP_TOK_0__","paramName":"order_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:order_id":"123e4567-e89b-12d3-a456-426614174000"}}],"https://sandbox-merchant.revolut.com":[{"id":"curl","label":"cURL","templateCode":"curl -X POST \"https://sandbox-merchant.revolut.com/api/orders/__RP_TOK_0__/capture\" \\\n -H \"Content-Type: application/json\" \\\n -H \"Authorization: __RP_TOK_1__\" \\\n -H \"Revolut-Api-Version: __RP_TOK_2__\" \\\n -d '{\n \"amount\": 100\n}'","templateHtml":"$184b","tokens":[{"marker":"__RP_TOK_0__","paramName":"order_id","paramIn":"path","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["shell-double-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:order_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"javascript","label":"JavaScript","templateCode":"const payload = {\n \"amount\": 100\n};\nfetch(\"https://sandbox-merchant.revolut.com/api/orders/__RP_TOK_0__/capture\", {\n method: \"POST\",\n headers: {\n \"Content-Type\": \"application/json\",\n \"Authorization\": \"__RP_TOK_1__\",\n \"Revolut-Api-Version\": \"__RP_TOK_2__\"\n },\n body: JSON.stringify(payload)\n})\n .then(response => response.json())\n .then(data => console.log(data));","templateHtml":"$184c","tokens":[{"marker":"__RP_TOK_0__","paramName":"order_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:order_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"go","label":"Go","templateCode":"package main\n\nimport (\n \"fmt\"\n \"net/http\"\n \"bytes\"\n \"encoding/json\"\n)\n\nfunc main() {\n url := \"https://sandbox-merchant.revolut.com/api/orders/__RP_TOK_0__/capture\"\n jsonData := []byte(`\n{\n \"amount\": 100\n}\n `)\n req, _ := http.NewRequest(\"POST\", url, bytes.NewBuffer(jsonData))\n req.Header.Add(\"Content-Type\", \"application/json\")\n req.Header.Add(\"Authorization\", \"__RP_TOK_1__\")\n req.Header.Add(\"Revolut-Api-Version\", \"__RP_TOK_2__\")\n\n res, _ := http.DefaultClient.Do(req)\n defer res.Body.Close()\n fmt.Println(res)\n}","templateHtml":"$184d","tokens":[{"marker":"__RP_TOK_0__","paramName":"order_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:order_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"python","label":"Python","templateCode":"import requests\n\nurl = \"https://sandbox-merchant.revolut.com/api/orders/__RP_TOK_0__/capture\"\nheaders = {\n \"Content-Type\": \"application/json\",\n \"Authorization\": \"__RP_TOK_1__\",\n \"Revolut-Api-Version\": \"__RP_TOK_2__\"\n}\npayload = {\n \"amount\": 100\n}\n\nresponse = requests.post(url, headers=headers, json=payload)\nprint(response.json())","templateHtml":"$184e","tokens":[{"marker":"__RP_TOK_0__","paramName":"order_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:order_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"java","label":"Java","templateCode":"import java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\nimport java.net.URI;\n\npublic class Main {\n public static void main(String[] args) {\n HttpClient client = HttpClient.newHttpClient();\n String body = \"\"\"\n{\n \"amount\": 100\n}\n \"\"\";\n\n HttpRequest request = HttpRequest.newBuilder()\n .uri(URI.create(\"https://sandbox-merchant.revolut.com/api/orders/__RP_TOK_0__/capture\"))\n .header(\"Content-Type\", \"application/json\")\n .header(\"Authorization\", \"__RP_TOK_1__\")\n .header(\"Revolut-Api-Version\", \"__RP_TOK_2__\")\n .POST(HttpRequest.BodyPublishers.ofString(body))\n .build();\n\n client.sendAsync(request, HttpResponse.BodyHandlers.ofString())\n .thenApply(HttpResponse::body)\n .thenAccept(System.out::println)\n .join();\n }\n}","templateHtml":"$184f","tokens":[{"marker":"__RP_TOK_0__","paramName":"order_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:order_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"csharp","label":"C#","templateCode":"using System.Net.Http;\nusing System.Net.Http.Headers;\n\nvar client = new HttpClient();\nvar request = new HttpRequestMessage\n{\n Method = HttpMethod.Post,\n RequestUri = new Uri(\"https://sandbox-merchant.revolut.com/api/orders/__RP_TOK_0__/capture\"),\n Headers =\n {\n { \"Authorization\", \"__RP_TOK_1__\" },\n { \"Revolut-Api-Version\", \"__RP_TOK_2__\" },\n },\n Content = new StringContent(@\"{\n \"\"amount\"\": 100\n}\")\n {\n Headers =\n {\n ContentType = new MediaTypeHeaderValue(\"application/json\")\n }\n }\n};\n\nusing (var response = await client.SendAsync(request))\n{\n response.EnsureSuccessStatusCode();\n var body = await response.Content.ReadAsStringAsync();\n Console.WriteLine(body);\n}","templateHtml":"$1850","tokens":[{"marker":"__RP_TOK_0__","paramName":"order_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:order_id":"123e4567-e89b-12d3-a456-426614174000"}}]},"method":"post","servers":"$62:props:children:0:props:children:props:children:1:props:children:1:props:children:0:0:props:servers","path":"/api/orders/{order_id}/capture","parameters":["$183e:props:children:0:props:children:1:props:parameters:0","$183e:props:children:0:props:children:1:props:parameters:1","$183e:props:children:0:props:children:1:props:parameters:2"]}],"$L1851"],"$L1852","$L1853"]}]]}] 185d:T4c1,Automatic cancellation period for uncaptured orders, specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. After this period, the authorised payment is automatically cancelled and the order is cancelled. Maximum: 7 days = `P7D`. :::note The following limitations apply: - Cannot be a negative value. - Cannot be updated if the new value is less than or equal to the elapsed time since authorisation. **Failing scenario:** - Original value: 7 days - Time since authorisation: 3 days - Update value: 2 days In this scenario, an error is returned. **Successful scenario:** - Original value: 7 days - Time since authorisation: 3 days - Update value: 4 days In this scenario, the parameter can be updated. - Cannot be updated if cancellation is ≤ 30 minutes away. **Failing scenario:** - Original value: 12 hours - Time since authorisation: 11 hours 40 minutes In this scenario, an error is returned. **Successful scenario:** - Original value: 12 hours - Time since authorisation: 11 hours 20 minutes In this scenario, the parameter can be updated. :::1864:T50a,Object containing information about a customer. If you have it, we strongly advise providing at least either `id`, `phone`, or `email`. Using the [Customers operations](https://developer.revolut.com/docs/api/merchant#tag-customers), you can manage customer instances. The following behaviours apply to different use cases: | Use case | API behavior | | -------- | ------------ | | Existing customer | If `id` was provided, we ignore other customer details and associate the customer with the order.

If either `email`, `phone`, or `full_name` was provided (without an existing customer's `id`), we always create a new customer, irrespective of another, existing customer object having the same details. | | New customer | If either `email`, `phone`, or `full_name` was provided, we create a new customer, irrespective of another customer object having the same details.

If `id` of a non-existent customer was provided, we return a `404` error, irrespective of other details provided. | :::note To avoid unintentional duplication of customer records, search for an existing customer by email or phone using the [List customers](https://developer.revolut.com/docs/api/merchant#retrieve-customer-list) endpoint first, then provide `customer.id` in the order. :::188d:T9bc,A unique identifier for a payment method, always 44 characters long. This fingerprint can be used to uniquely identify various payment methods. #### Fingerprint generation | Payment method | Description | | -------- | ----------- | | **All payment methods** | A fingerprint is generated for all payment methods, including cards, Revolut Pay (card, account-to-account payments), Apple Pay, and Google Pay. | | **Cards (Revolut Pay & Card Gateway)** | For cards, the fingerprint is based on the PAN. Cards processed via Revolut Pay and our card gateway will share the same fingerprint. Renewed cards (new expiry/CVV) retain the same fingerprint for efficient blocking. | | **Apple Pay & Google Pay** | Since Apple Pay and Google Pay provide us Device PANs (DPAN), the fingerprint is based on the DPAN provided by Apple/Google, not the connected card's PAN. This means that a new DPAN (and fingerprint) is generated for cards in case they are re-added to the customer's digital wallet, or added to different devices. | #### Detecting duplicate payment methods Fingerprints are a valuable tool for detecting duplicate payment methods by identifying if a payment method has been seen before. This capability, in turn, helps in preventing various types of misuse (e.g., exploitation of free trials, or association with known problematic accounts, which can be a form of fraud). To effectively use fingerprints for this purpose, you will need to create and maintain your own lists (e.g., blocklists of known problematic fingerprints, allowlists for trusted customers, or tracking frequently used fingerprints). The ideal way to utilise fingerprints is by combining them with a manual capture process. While automatic capture with subsequent refunds for problematic payments is possible, manual capture based on fingerprint validation is recommended. During your manual capture workflow, after a payment was authorised: - Check the fingerprint status by comparing it against your maintained lists and internal business rules. - If you decide to proceed with the payment (e.g., the fingerprint is not on a blocklist, or matches a trusted customer's previous payment method): [Capture the order](https://developer.revolut.com/docs/api/merchant#capture-order). - If you decide not to proceed with the payment (e.g., the fingerprint matches a known fraudulent fingerprint, or exhibits suspicious patterns): [Cancel the order](https://developer.revolut.com/docs/api/merchant#cancel-order).189f:T9bc,A unique identifier for a payment method, always 44 characters long. This fingerprint can be used to uniquely identify various payment methods. #### Fingerprint generation | Payment method | Description | | -------- | ----------- | | **All payment methods** | A fingerprint is generated for all payment methods, including cards, Revolut Pay (card, account-to-account payments), Apple Pay, and Google Pay. | | **Cards (Revolut Pay & Card Gateway)** | For cards, the fingerprint is based on the PAN. Cards processed via Revolut Pay and our card gateway will share the same fingerprint. Renewed cards (new expiry/CVV) retain the same fingerprint for efficient blocking. | | **Apple Pay & Google Pay** | Since Apple Pay and Google Pay provide us Device PANs (DPAN), the fingerprint is based on the DPAN provided by Apple/Google, not the connected card's PAN. This means that a new DPAN (and fingerprint) is generated for cards in case they are re-added to the customer's digital wallet, or added to different devices. | #### Detecting duplicate payment methods Fingerprints are a valuable tool for detecting duplicate payment methods by identifying if a payment method has been seen before. This capability, in turn, helps in preventing various types of misuse (e.g., exploitation of free trials, or association with known problematic accounts, which can be a form of fraud). To effectively use fingerprints for this purpose, you will need to create and maintain your own lists (e.g., blocklists of known problematic fingerprints, allowlists for trusted customers, or tracking frequently used fingerprints). The ideal way to utilise fingerprints is by combining them with a manual capture process. While automatic capture with subsequent refunds for problematic payments is possible, manual capture based on fingerprint validation is recommended. During your manual capture workflow, after a payment was authorised: - Check the fingerprint status by comparing it against your maintained lists and internal business rules. - If you decide to proceed with the payment (e.g., the fingerprint is not on a blocklist, or matches a trusted customer's previous payment method): [Capture the order](https://developer.revolut.com/docs/api/merchant#capture-order). - If you decide not to proceed with the payment (e.g., the fingerprint matches a known fraudulent fingerprint, or exhibits suspicious patterns): [Cancel the order](https://developer.revolut.com/docs/api/merchant#cancel-order).18b1:T9bc,A unique identifier for a payment method, always 44 characters long. This fingerprint can be used to uniquely identify various payment methods. #### Fingerprint generation | Payment method | Description | | -------- | ----------- | | **All payment methods** | A fingerprint is generated for all payment methods, including cards, Revolut Pay (card, account-to-account payments), Apple Pay, and Google Pay. | | **Cards (Revolut Pay & Card Gateway)** | For cards, the fingerprint is based on the PAN. Cards processed via Revolut Pay and our card gateway will share the same fingerprint. Renewed cards (new expiry/CVV) retain the same fingerprint for efficient blocking. | | **Apple Pay & Google Pay** | Since Apple Pay and Google Pay provide us Device PANs (DPAN), the fingerprint is based on the DPAN provided by Apple/Google, not the connected card's PAN. This means that a new DPAN (and fingerprint) is generated for cards in case they are re-added to the customer's digital wallet, or added to different devices. | #### Detecting duplicate payment methods Fingerprints are a valuable tool for detecting duplicate payment methods by identifying if a payment method has been seen before. This capability, in turn, helps in preventing various types of misuse (e.g., exploitation of free trials, or association with known problematic accounts, which can be a form of fraud). To effectively use fingerprints for this purpose, you will need to create and maintain your own lists (e.g., blocklists of known problematic fingerprints, allowlists for trusted customers, or tracking frequently used fingerprints). The ideal way to utilise fingerprints is by combining them with a manual capture process. While automatic capture with subsequent refunds for problematic payments is possible, manual capture based on fingerprint validation is recommended. During your manual capture workflow, after a payment was authorised: - Check the fingerprint status by comparing it against your maintained lists and internal business rules. - If you decide to proceed with the payment (e.g., the fingerprint is not on a blocklist, or matches a trusted customer's previous payment method): [Capture the order](https://developer.revolut.com/docs/api/merchant#capture-order). - If you decide not to proceed with the payment (e.g., the fingerprint matches a known fraudulent fingerprint, or exhibits suspicious patterns): [Cancel the order](https://developer.revolut.com/docs/api/merchant#cancel-order).18c3:T9bc,A unique identifier for a payment method, always 44 characters long. This fingerprint can be used to uniquely identify various payment methods. #### Fingerprint generation | Payment method | Description | | -------- | ----------- | | **All payment methods** | A fingerprint is generated for all payment methods, including cards, Revolut Pay (card, account-to-account payments), Apple Pay, and Google Pay. | | **Cards (Revolut Pay & Card Gateway)** | For cards, the fingerprint is based on the PAN. Cards processed via Revolut Pay and our card gateway will share the same fingerprint. Renewed cards (new expiry/CVV) retain the same fingerprint for efficient blocking. | | **Apple Pay & Google Pay** | Since Apple Pay and Google Pay provide us Device PANs (DPAN), the fingerprint is based on the DPAN provided by Apple/Google, not the connected card's PAN. This means that a new DPAN (and fingerprint) is generated for cards in case they are re-added to the customer's digital wallet, or added to different devices. | #### Detecting duplicate payment methods Fingerprints are a valuable tool for detecting duplicate payment methods by identifying if a payment method has been seen before. This capability, in turn, helps in preventing various types of misuse (e.g., exploitation of free trials, or association with known problematic accounts, which can be a form of fraud). To effectively use fingerprints for this purpose, you will need to create and maintain your own lists (e.g., blocklists of known problematic fingerprints, allowlists for trusted customers, or tracking frequently used fingerprints). The ideal way to utilise fingerprints is by combining them with a manual capture process. While automatic capture with subsequent refunds for problematic payments is possible, manual capture based on fingerprint validation is recommended. During your manual capture workflow, after a payment was authorised: - Check the fingerprint status by comparing it against your maintained lists and internal business rules. - If you decide to proceed with the payment (e.g., the fingerprint is not on a blocklist, or matches a trusted customer's previous payment method): [Capture the order](https://developer.revolut.com/docs/api/merchant#capture-order). - If you decide not to proceed with the payment (e.g., the fingerprint matches a known fraudulent fingerprint, or exhibits suspicious patterns): [Cancel the order](https://developer.revolut.com/docs/api/merchant#cancel-order).18c9:T9bc,A unique identifier for a payment method, always 44 characters long. This fingerprint can be used to uniquely identify various payment methods. #### Fingerprint generation | Payment method | Description | | -------- | ----------- | | **All payment methods** | A fingerprint is generated for all payment methods, including cards, Revolut Pay (card, account-to-account payments), Apple Pay, and Google Pay. | | **Cards (Revolut Pay & Card Gateway)** | For cards, the fingerprint is based on the PAN. Cards processed via Revolut Pay and our card gateway will share the same fingerprint. Renewed cards (new expiry/CVV) retain the same fingerprint for efficient blocking. | | **Apple Pay & Google Pay** | Since Apple Pay and Google Pay provide us Device PANs (DPAN), the fingerprint is based on the DPAN provided by Apple/Google, not the connected card's PAN. This means that a new DPAN (and fingerprint) is generated for cards in case they are re-added to the customer's digital wallet, or added to different devices. | #### Detecting duplicate payment methods Fingerprints are a valuable tool for detecting duplicate payment methods by identifying if a payment method has been seen before. This capability, in turn, helps in preventing various types of misuse (e.g., exploitation of free trials, or association with known problematic accounts, which can be a form of fraud). To effectively use fingerprints for this purpose, you will need to create and maintain your own lists (e.g., blocklists of known problematic fingerprints, allowlists for trusted customers, or tracking frequently used fingerprints). The ideal way to utilise fingerprints is by combining them with a manual capture process. While automatic capture with subsequent refunds for problematic payments is possible, manual capture based on fingerprint validation is recommended. During your manual capture workflow, after a payment was authorised: - Check the fingerprint status by comparing it against your maintained lists and internal business rules. - If you decide to proceed with the payment (e.g., the fingerprint is not on a blocklist, or matches a trusted customer's previous payment method): [Capture the order](https://developer.revolut.com/docs/api/merchant#capture-order). - If you decide not to proceed with the payment (e.g., the fingerprint matches a known fraudulent fingerprint, or exhibits suspicious patterns): [Cancel the order](https://developer.revolut.com/docs/api/merchant#cancel-order).190a:T5ef,Object containing additional information about an airline booking associated with the order. Use this object to provide required data to enable **Revolut Flight Alerts**. This feature allows users to receive real-time flight updates such as check-in reminders, boarding alerts, and notifications for cancellations or delays in the Revolut app. To enable **Revolut Flight Alerts** functionalities in the Revolut app, the following fields are **required** on order creation or update, before capturing the order: ``` tickets_purchase, journey_legs, booking_url ``` :::note These are the specific data field requirements for merchants who must provide airline data. Note that these requirements can be extended on a case by case basis as decided by Revolut. | Required for airline/charter merchants | Required for OTA merchants | | -------------------------------------- | -------------------------- | |
  • `booking_id`
  • `fulfillment_date`
  • `passengers[].first_name`
  • `passengers[].last_name`
  • `journey_legs[].pnr`
  • `journey_legs[].sequence`
  • `journey_legs[].flight_number`
  • `journey_legs[].travel_date`
  • `journey_legs[].airline_code`
  • `journey_legs[].departure_airport_code`
  • `journey_legs[].arrival_airport_code`
|
  • `booking_id`
  • `fulfillment_date`
  • `passengers[].first_name`
  • `passengers[].last_name`
  • `journey_legs[].pnr`
  • `journey_legs[].arrival_airport_code`
| :::1995:T480,You can set a dynamic statement descriptor for your orders by providing a custom suffix. A statement descriptor is the text shown on cardholders' bank or card statements, helping them recognise a transaction or merchant. This field can be used to send extra information with the statement descriptor for card transactions. The complete descriptor is built using the following format: `{base}*{suffix}`, where: - **`{base}`** is the existing descriptor configured in the Revolut Business dashboard (**Settings > Business account > Merchant profile > Statement descriptor**). - **`{suffix}`** is defined by the `statement_descriptor_suffix` field. :::note - If the combined descriptor's length (base + suffix) exceeds the character limits of card scheme providers, the final value will be truncated. For example if the limit is 22 characters, the base descriptor is `"base"` and the suffix is `"testdescriptorsuffix"`, the final descriptor becomes `"base*testdescriptorsuf"`. - The final statement descriptor shown on a cardholder's statement may vary by issuing bank, as some banks apply their own custom formatting or truncation rules. :::1c:["$","$7a","increment-order-authorisation",{"children":[["$","section",null,{"className":"y9a0do0","data-variant":"endpoint","children":["$","$L7b",null,{"responses":{"200":{"description":"Authorization increment initiated successfully","content":{"application/json":{"schema":{"title":"Order v5","type":"object","description":"To process the order from a credit or debit card, you create an `Order` object. You can then retrieve, capture, cancel, refund, or pay an order using its unique `id`. Alternatively, you can use its unique `token` to process a card payment with the Revolut Checkout Widget.","properties":{"id":{"type":"string","format":"uuid","description":"Permanent order ID used to retrieve, capture, cancel, or refund an order after authorization.","descriptionNode":"$L1854"},"token":{"type":"string","description":"Temporary ID for the order, which expires when the payment is authorised.\n\nThe order `token` is used for [token-based initialisation](https://developer.revolut.com/docs/sdks/merchant-web-sdk/initialisation/token-based), and is returned by the `createOrder` callback in the following payment methods:\n\n- [Embedded Checkout](https://developer.revolut.com/docs/sdks/merchant-web-sdk/payment-methods/embedded-checkout#embedded-checkout-options-interface)\n- [Revolut Pay](https://developer.revolut.com/docs/sdks/merchant-web-sdk/payment-methods/revolut-pay#widget-payments-revolut-pay-options)\n- [Apple Pay and Google Pay](https://developer.revolut.com/docs/sdks/merchant-web-sdk/payment-methods/apple-pay-google-pay#payment-request-options-interface)\n- [Pay by Bank](https://developer.revolut.com/docs/sdks/merchant-web-sdk/payment-methods/pay-by-bank#pay-by-bank-options-interface)","descriptionNode":"$L1855"},"type":{"type":"string","description":"The type of the order.","enum":"$19:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:orders:items:properties:type:enum","descriptionNode":"$L1856"},"state":{"type":"string","description":"The state of the order in its lifecycle.\n\n| State | Description |\n|-------|-------------|\n| `pending` | Order created, awaiting payment |\n| `processing` | Payment is being processed |\n| `authorised` | Payment authorised but not yet captured (for manual capture) |\n| `completed` | Payment successfully captured and settled |\n| `cancelled` | Order was cancelled |\n| `failed` | Payment failed |\n\n:::info\nFor more information, see: [Order and payment lifecycle](https://developer.revolut.com/docs/guides/merchant/reference/order-lifecycle)\n:::","enum":"$19:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:orders:items:properties:state:enum","examples":"$19:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:orders:items:properties:state:examples","descriptionNode":"$L1857"},"created_at":{"type":"string","description":"The date and time the order was created.","format":"date-time","descriptionNode":"$L1858"},"updated_at":{"type":"string","description":"The date and time the order was last updated.","format":"date-time","descriptionNode":"$L1859"},"description":{"type":"string","description":"The description of the order.","descriptionNode":"$L185a"},"capture_mode":{"type":"string","description":"The capture mode of the order. `automatic` is used by default.\n\n| Parameter value | Description |\n| --------------- | ----------- |\n| `automatic` | The order is captured automatically after payment authorisation. |\n| `manual` | The order is not captured automatically. You must manually capture the order later. |\n\n:::info\nFor more information, see [Capture an order](https://developer.revolut.com/docs/api/merchant#capture-order).\n:::","default":"automatic","enum":"$19:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:orders:items:properties:capture_mode:enum","descriptionNode":"$L185b"},"authorisation_type":{"type":"string","description":"The type of authorisation for the order. Used with manual capture mode. If omitted, `final` is used by default.\n\n### Pre-authorisation\n\nPre-authorisation allows you to reserve funds on a customer's card without immediately capturing them. This is useful for scenarios like:\n\n- Hotel bookings where the final amount may vary\n- Car rentals where additional charges may apply\n- Deposits that need to be held temporarily\n\n| Parameter value | Description |\n| --------------- | ----------- |\n| `final` | Standard authorisation for immediate or near-immediate capture. |\n| `pre_authorisation` | Reserve funds for later capture, used with manual capture mode. |\n\n:::note\nPre-authorisation must be used with `capture_mode: manual`. For more information, see [Capture an order](https://developer.revolut.com/docs/api/merchant#capture-order).\n:::","default":"final","enum":"$19:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:orders:items:properties:authorisation_type:enum","descriptionNode":"$L185c"},"cancel_authorised_after":{"type":"string","format":"duration","description":"$185d","descriptionNode":"$L185e"},"amount":{"type":"integer","description":"The order total expressed in minor currency units, according to the [ISO 4217 standard](https://en.wikipedia.org/wiki/ISO_4217). For example, `7034` in `EUR` corresponds to €70.34.\n\n:::info\n- Conversion between major and minor units varies by currency. For instance, `100` minor units equal £1.00 in `GBP`, whereas in `ISK` they represent 100 units. For more details, see the [ISO 4217 standard](https://en.wikipedia.org/wiki/ISO_4217).\n- If `line_items` are provided, the order `amount` must equal the sum of all line items' `total_amount`.\n- For card payments with a non-zero amount, the order `amount` must be at least **$0.005** (or equivalent in different currencies, calculated using Revolut's exchange rate on the payment date). Otherwise, card payments can't be performed.\n:::","descriptionNode":"$L185f"},"outstanding_amount":{"type":"integer","description":"The amount not yet paid for a given order (in minor currency units). For example, `7034` represents €70.34. \n\nThe value in this field may differ from `amount` if there are partial payments associated with the order.","descriptionNode":"$L1860"},"refunded_amount":{"type":"integer","description":"The amount that was refunded from the order (in minor currency units). For example, `7034` represents €70.34. \n\nThis applies to orders that have been refunded (i.e., orders of type `payment` that have a related `refund` order).","descriptionNode":"$L1861"},"currency":{"type":"string","format":"ISO 4217","minLength":3,"maxLength":3,"description":"[ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) currency code in upper case.\n\n:::info\nFor more information about the supported currencies, see: [Help Center](https://help.revolut.com/business/help/merchant-accounts/payments/in-which-currencies-can-i-accept-payments/).\n:::","descriptionNode":"$L1862"},"settlement_currency":{"type":"string","description":"[ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) currency code in upper case. \n\nIf `settlement_currency` is different from the value of `currency`, the money will be exchanged when the amount is settled to your merchant account. In case of a refund or chargeback, the money will be exchanged to the order's initial `currency`.\n\nIf `settlement_currency` is not specified, this value is taken from `currency`.\n\n:::info\nFor more information about the supported currencies, see: [Help Center](https://help.revolut.com/business/help/merchant-accounts/payments/in-which-currencies-can-i-accept-payments/).\n:::","descriptionNode":"$L1863"},"customer":{"type":"object","description":"$1864","properties":{"id":{"type":"string","format":"uuid","description":"Permanent ID of a customer used to retrieve, update, delete a customer. This ID can also be used to link customer to an order.\n\n:::note\nIf you provide the customer's ID during order creation, no other customer data is required, they will be parsed automatically from the referenced customer object.\n:::","descriptionNode":"$L1865"},"full_name":{"type":"string","description":"The full name of the customer.","descriptionNode":"$L1866"},"phone":{"type":"string","description":"The phone number of the customer in [E.164 format](https://en.wikipedia.org/wiki/E.164).","descriptionNode":"$L1867"},"email":{"type":"string","format":"email","description":"The email address of the customer.","descriptionNode":"$L1868"},"date_of_birth":{"type":"string","format":"date","description":"The birth date of the customer.","descriptionNode":"$L1869"}},"descriptionNode":"$L186a"},"payments":{"type":"array","description":"The details of all the payments that have been made towards this order (successful or unsuccessful).","items":{"type":"object","description":"Represents a payment for an order.\n\nFor pre-authorised payments, the `authorised_amount` field tracks the currently authorised amount, which may differ from `amount` during incremental authorisation processing.","properties":{"id":{"type":"string","format":"uuid","description":"The ID of the payment.","descriptionNode":"$L186b"},"state":{"type":"string","description":"The status of the payment.","enum":"$21:props:children:0:props:children:props:responses:200:content:application/json:schema:items:properties:state:enum","descriptionNode":"$L186c"},"decline_reason":{"type":"string","description":"The reason for a `failed` or `declined` payment.\n\nA failed or declined payment can result from multiple reasons. To learn more, check our [failure reasons](https://developer.revolut.com/docs/guides/merchant/reference/error-codes/decline-reasons).","enum":"$21:props:children:0:props:children:props:responses:200:content:application/json:schema:items:properties:decline_reason:enum","descriptionNode":"$L186d"},"bank_message":{"type":"string","description":"The reason for a `failed` or `declined` payment, sent by the financial institution processing the payment.","descriptionNode":"$L186e"},"created_at":{"type":"string","format":"date-time","description":"The date and time the payment was created.","descriptionNode":"$L186f"},"updated_at":{"type":"string","format":"date-time","description":"The date and time the payment was last updated.","descriptionNode":"$L1870"},"token":{"type":"string","format":"uuid","description":"Temporary token of the payment used to fetch the reward offer during checkout and link user registrations to the given offers. \n\nThe token is only valid for a limited time.","descriptionNode":"$L1871"},"amount":{"type":"integer","format":"int64","minimum":0,"description":"The payment amount in minor units (e.g., cents). The value of this field depends on the payment type and state.\n\n| Payment type | State | Amount value |\n|--------------|-------|--------------|\n| Standard payment | Any | Total payment amount |\n| Pre-authorised payment | `authorisation_started` | New amount being authorised (during increment processing) |\n| Pre-authorised payment | `authorised` | Currently authorised amount (equals `authorised_amount`) |\n\n:::info\nFor pre-authorised payments, see the `authorised_amount` field for tracking the currently authorised amount separately.\n:::","examples":"$21:props:children:0:props:children:props:responses:200:content:application/json:schema:items:properties:amount:examples","descriptionNode":"$L1872"},"authorised_amount":{"type":"integer","description":"The currently authorised amount for this payment (in minor units).\n\nFor pre-authorised payments with incremental authorization:\n- Initially equals the `amount` field\n- Remains unchanged during increment processing\n- Updates to new amount upon successful increment\n- Remains at original amount if increment is declined\n\nFor standard payments, this field may not be present or will equal the `amount` field.","examples":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:authorised_amount:examples","descriptionNode":"$L1873"},"currency":{"type":"string","format":"ISO 4217","minLength":3,"maxLength":3,"description":"[ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) currency code in upper case.\n\n:::info\nFor more information about the supported currencies, see: [Help Center](https://help.revolut.com/business/help/merchant-accounts/payments/in-which-currencies-can-i-accept-payments/).\n:::","descriptionNode":"$L1874"},"settled_amount":{"type":"integer","description":"The amount of the settled payment (minor currency unit). For example, `7034` stands for €70.34.","descriptionNode":"$L1875"},"settled_currency":{"type":"string","description":"The currency of the settled payment. [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) currency code in upper case.\n\n:::info\nFor more information about the supported currencies, see: [Help Center](https://help.revolut.com/business/help/merchant-accounts/payments/in-which-currencies-can-i-accept-payments/).\n:::","descriptionNode":"$L1876"},"payment_method":{"type":"object","description":"The details of the payment method used to make the payment.","discriminator":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:discriminator","oneOf":[{"type":"object","description":"Object containing details of a card used via Apple Pay.","properties":{"id":{"type":"string","format":"uuid","description":"ID of the saved payment method.\n\n:::note\nThe `id` parameter is only returned when the payment method is saved.\n:::","descriptionNode":"$L1877"},"type":{"type":"string","enum":"$21:props:children:0:props:children:props:responses:200:content:application/json:schema:items:properties:payment_method:oneOf:2:properties:type:enum","description":"The type of payment method used to pay for the order.\n\nAvailable values:\n\n| Payment method `type` | Description |\n| --------------------- | ----------- |\n| `apple_pay` | The customer paid the order using Apple Pay. |\n| `card` | The customer paid the order using their credit or debit card. |\n| `google_pay` | The customer paid the order using Google Pay. |\n| `revolut_pay_card` | The customer paid the order via Revolut Pay using their credit or debit card. |\n| `revolut_pay_account` | The customer paid the order via Revolut Pay using their Revolut account. |\n| `sepa_direct_debit` | The customer paid the order using SEPA Direct Debit. |","descriptionNode":"$L1878"},"card_brand":{"type":"string","description":"The type of the card.","enum":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:0:properties:card_brand:enum","descriptionNode":"$L1879"},"funding":{"type":"string","description":"The type of card funding.","enum":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:0:properties:funding:enum","descriptionNode":"$L187a"},"card_country_code":{"type":"string","description":"The 2-letter country code of the country where the card was issued.","descriptionNode":"$L187b"},"card_bin":{"type":"string","description":"The BIN of the card.","minLength":6,"maxLength":6,"descriptionNode":"$L187c"},"card_last_four":{"type":"string","description":"The last four digits of the card number.","minLength":4,"maxLength":4,"descriptionNode":"$L187d"},"card_expiry":{"type":"string","format":"MM/YY","description":"The expiry date of the card in the format of MM/YY.","descriptionNode":"$L187e"},"cardholder_name":{"type":"string","description":"The name of the cardholder.","descriptionNode":"$L187f"},"checks":{"type":"object","description":"The details of the check for card payment. Only for orders with successful payments.","properties":{"three_ds":{"type":"object","description":"The details of the 3D Secure check. Only for orders with successful payments.\n\n:::note\nNot returned for Apple Pay and Google Pay payments.\n:::","properties":{"eci":{"type":"string","description":"The Electronic Commerce Indicator (ECI) value corresponds to the authentication result and indicates the level of security used when the payment information was provided.","descriptionNode":"$L1880"},"state":{"type":"string","description":"The result of 3D Secure check.","enum":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:0:properties:checks:properties:three_ds:properties:state:enum","descriptionNode":"$L1881"},"version":{"type":"integer","description":"The 3D Secure version.","descriptionNode":"$L1882"}},"descriptionNode":"$L1883"},"cvv_verification":{"type":"string","description":"The result of CVV verification.\n\n| Parameter value | Description |\n| ----- | ----------- |\n| `match` | CVV matches the card's CVV |\n| `not_match` | CVV does not match the card's CVV |\n| `incorrect` | CVV format is incorrect for this type of card |\n| `not_processed` | CVV verification was not performed |","enum":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:0:properties:checks:properties:cvv_verification:enum","descriptionNode":"$L1884"},"address":{"type":"string","description":"The result of address verification.","enum":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:0:properties:checks:properties:address:enum","descriptionNode":"$L1885"},"postcode":{"type":"string","description":"The result of postcode verification.","enum":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:0:properties:checks:properties:postcode:enum","descriptionNode":"$L1886"},"cardholder":{"type":"string","description":"The result of cardholder verification.","enum":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:0:properties:checks:properties:cardholder:enum","descriptionNode":"$L1887"}},"descriptionNode":"$L1888"},"authorisation_code":{"type":"string","description":"The authorisation code (or auth code) is a short, alphanumeric code returned by the cardholder's issuing bank to the merchant's terminal or payment gateway.\n\nIt serves as confirmation that the transaction has been approved and funds are available.","pattern":"^[a-zA-Z0-9]{2,6}$","minLength":2,"maxLength":6,"examples":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:0:properties:authorisation_code:examples","descriptionNode":"$L1889"},"arn":{"type":"string","description":"Acquirer Reference Number (ARN) of the payment.\n\n:::note\nOnly returned for refund payments made by a card.\n:::","minLength":23,"maxLength":23,"examples":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:0:properties:arn:examples","descriptionNode":"$L188a"},"capture_deadline":{"type":"string","format":"date-time","description":"The date and time by which the payment must be captured.\n\nAfter this deadline, the authorised funds may be automatically released by the card issuer.","descriptionNode":"$L188b"},"terminal_hardware_id":{"type":"string","description":"The hardware identifier of the Revolut Terminal device used to process the payment.\n\n:::note\nOnly present for card-present transactions processed via Revolut Terminal.\n:::","descriptionNode":"$L188c"},"fingerprint":{"type":"string","minLength":44,"maxLength":44,"description":"$188d","examples":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:0:properties:fingerprint:examples","descriptionNode":"$L188e"},"network_transaction_id":{"type":"string","description":"The Network Transaction ID (NTI) is a unique identifier assigned by the card scheme (e.g., Visa or Mastercard) to a card transaction.\n\nIt can be used to trace the transaction across the payment network, link recurring or instalment payments to the original authorisation, and support dispute resolution.","descriptionNode":"$L188f"}},"required":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:0:required","descriptionNode":"$L1890"},{"type":"object","description":"Object containing details of the card used for the payment.","properties":{"id":{"type":"string","format":"uuid","description":"ID of the saved payment method.\n\n:::note\nThe `id` parameter is only returned when the payment method is saved.\n:::","descriptionNode":"$L1891"},"type":{"type":"string","enum":"$21:props:children:0:props:children:props:responses:200:content:application/json:schema:items:properties:payment_method:oneOf:2:properties:type:enum","description":"The type of payment method used to pay for the order.\n\nAvailable values:\n\n| Payment method `type` | Description |\n| --------------------- | ----------- |\n| `apple_pay` | The customer paid the order using Apple Pay. |\n| `card` | The customer paid the order using their credit or debit card. |\n| `google_pay` | The customer paid the order using Google Pay. |\n| `revolut_pay_card` | The customer paid the order via Revolut Pay using their credit or debit card. |\n| `revolut_pay_account` | The customer paid the order via Revolut Pay using their Revolut account. |\n| `sepa_direct_debit` | The customer paid the order using SEPA Direct Debit. |","descriptionNode":"$L1892"},"card_brand":{"type":"string","description":"The type of the card.","enum":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:1:properties:card_brand:enum","descriptionNode":"$L1893"},"funding":{"type":"string","description":"The type of card funding.","enum":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:1:properties:funding:enum","descriptionNode":"$L1894"},"card_country_code":{"type":"string","description":"The 2-letter country code of the country where the card was issued.","descriptionNode":"$L1895"},"card_bin":{"type":"string","description":"The BIN of the card.","minLength":6,"maxLength":6,"descriptionNode":"$L1896"},"card_last_four":{"type":"string","description":"The last four digits of the card number.","minLength":4,"maxLength":4,"descriptionNode":"$L1897"},"card_expiry":{"type":"string","format":"MM/YY","description":"The expiry date of the card in the format of MM/YY.","descriptionNode":"$L1898"},"cardholder_name":{"type":"string","description":"The name of the cardholder.","descriptionNode":"$L1899"},"checks":{"type":"object","description":"The details of the check for card payment. Only for orders with successful payments.","properties":{"three_ds":"$1c:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payments:items:properties:payment_method:oneOf:0:properties:checks:properties:three_ds","cvv_verification":"$1c:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payments:items:properties:payment_method:oneOf:0:properties:checks:properties:cvv_verification","address":"$1c:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payments:items:properties:payment_method:oneOf:0:properties:checks:properties:address","postcode":"$1c:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payments:items:properties:payment_method:oneOf:0:properties:checks:properties:postcode","cardholder":"$1c:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payments:items:properties:payment_method:oneOf:0:properties:checks:properties:cardholder"},"descriptionNode":"$L189a"},"authorisation_code":{"type":"string","description":"The authorisation code (or auth code) is a short, alphanumeric code returned by the cardholder's issuing bank to the merchant's terminal or payment gateway.\n\nIt serves as confirmation that the transaction has been approved and funds are available.","pattern":"^[a-zA-Z0-9]{2,6}$","minLength":2,"maxLength":6,"examples":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:0:properties:authorisation_code:examples","descriptionNode":"$L189b"},"arn":{"type":"string","description":"Acquirer Reference Number (ARN) of the payment.\n\n:::note\nOnly returned for refund payments made by a card.\n:::","minLength":23,"maxLength":23,"examples":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:0:properties:arn:examples","descriptionNode":"$L189c"},"capture_deadline":{"type":"string","format":"date-time","description":"The date and time by which the payment must be captured.\n\nAfter this deadline, the authorised funds may be automatically released by the card issuer.","descriptionNode":"$L189d"},"terminal_hardware_id":{"type":"string","description":"The hardware identifier of the Revolut Terminal device used to process the payment.\n\n:::note\nOnly present for card-present transactions processed via Revolut Terminal.\n:::","descriptionNode":"$L189e"},"fingerprint":{"type":"string","minLength":44,"maxLength":44,"description":"$189f","examples":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:0:properties:fingerprint:examples","descriptionNode":"$L18a0"},"network_transaction_id":{"type":"string","description":"The Network Transaction ID (NTI) is a unique identifier assigned by the card scheme (e.g., Visa or Mastercard) to a card transaction.\n\nIt can be used to trace the transaction across the payment network, link recurring or instalment payments to the original authorisation, and support dispute resolution.","descriptionNode":"$L18a1"}},"required":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:1:required","descriptionNode":"$L18a2"},{"type":"object","description":"Object containing details of a card used via Google Pay.","properties":{"id":{"type":"string","format":"uuid","description":"ID of the saved payment method.\n\n:::note\nThe `id` parameter is only returned when the payment method is saved.\n:::","descriptionNode":"$L18a3"},"type":{"type":"string","enum":"$21:props:children:0:props:children:props:responses:200:content:application/json:schema:items:properties:payment_method:oneOf:2:properties:type:enum","description":"The type of payment method used to pay for the order.\n\nAvailable values:\n\n| Payment method `type` | Description |\n| --------------------- | ----------- |\n| `apple_pay` | The customer paid the order using Apple Pay. |\n| `card` | The customer paid the order using their credit or debit card. |\n| `google_pay` | The customer paid the order using Google Pay. |\n| `revolut_pay_card` | The customer paid the order via Revolut Pay using their credit or debit card. |\n| `revolut_pay_account` | The customer paid the order via Revolut Pay using their Revolut account. |\n| `sepa_direct_debit` | The customer paid the order using SEPA Direct Debit. |","descriptionNode":"$L18a4"},"card_brand":{"type":"string","description":"The type of the card.","enum":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:2:properties:card_brand:enum","descriptionNode":"$L18a5"},"funding":{"type":"string","description":"The type of card funding.","enum":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:2:properties:funding:enum","descriptionNode":"$L18a6"},"card_country_code":{"type":"string","description":"The 2-letter country code of the country where the card was issued.","descriptionNode":"$L18a7"},"card_bin":{"type":"string","description":"The BIN of the card.","minLength":6,"maxLength":6,"descriptionNode":"$L18a8"},"card_last_four":{"type":"string","description":"The last four digits of the card number.","minLength":4,"maxLength":4,"descriptionNode":"$L18a9"},"card_expiry":{"type":"string","format":"MM/YY","description":"The expiry date of the card in the format of MM/YY.","descriptionNode":"$L18aa"},"cardholder_name":{"type":"string","description":"The name of the cardholder.","descriptionNode":"$L18ab"},"checks":{"type":"object","description":"The details of the check for card payment. Only for orders with successful payments.","properties":{"three_ds":"$1c:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payments:items:properties:payment_method:oneOf:0:properties:checks:properties:three_ds","cvv_verification":"$1c:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payments:items:properties:payment_method:oneOf:0:properties:checks:properties:cvv_verification","address":"$1c:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payments:items:properties:payment_method:oneOf:0:properties:checks:properties:address","postcode":"$1c:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payments:items:properties:payment_method:oneOf:0:properties:checks:properties:postcode","cardholder":"$1c:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payments:items:properties:payment_method:oneOf:0:properties:checks:properties:cardholder"},"descriptionNode":"$L18ac"},"authorisation_code":{"type":"string","description":"The authorisation code (or auth code) is a short, alphanumeric code returned by the cardholder's issuing bank to the merchant's terminal or payment gateway.\n\nIt serves as confirmation that the transaction has been approved and funds are available.","pattern":"^[a-zA-Z0-9]{2,6}$","minLength":2,"maxLength":6,"examples":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:0:properties:authorisation_code:examples","descriptionNode":"$L18ad"},"arn":{"type":"string","description":"Acquirer Reference Number (ARN) of the payment.\n\n:::note\nOnly returned for refund payments made by a card.\n:::","minLength":23,"maxLength":23,"examples":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:0:properties:arn:examples","descriptionNode":"$L18ae"},"capture_deadline":{"type":"string","format":"date-time","description":"The date and time by which the payment must be captured.\n\nAfter this deadline, the authorised funds may be automatically released by the card issuer.","descriptionNode":"$L18af"},"terminal_hardware_id":{"type":"string","description":"The hardware identifier of the Revolut Terminal device used to process the payment.\n\n:::note\nOnly present for card-present transactions processed via Revolut Terminal.\n:::","descriptionNode":"$L18b0"},"fingerprint":{"type":"string","minLength":44,"maxLength":44,"description":"$18b1","examples":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:0:properties:fingerprint:examples","descriptionNode":"$L18b2"},"network_transaction_id":{"type":"string","description":"The Network Transaction ID (NTI) is a unique identifier assigned by the card scheme (e.g., Visa or Mastercard) to a card transaction.\n\nIt can be used to trace the transaction across the payment network, link recurring or instalment payments to the original authorisation, and support dispute resolution.","descriptionNode":"$L18b3"}},"required":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:2:required","descriptionNode":"$L18b4"},{"type":"object","description":"Object containing details of a card used via Revolut Pay.","properties":{"id":{"type":"string","format":"uuid","description":"ID of the saved payment method.\n\n:::note\nThe `id` parameter is only returned when the payment method is saved.\n:::","descriptionNode":"$L18b5"},"type":{"type":"string","enum":"$21:props:children:0:props:children:props:responses:200:content:application/json:schema:items:properties:payment_method:oneOf:2:properties:type:enum","description":"The type of payment method used to pay for the order.\n\nAvailable values:\n\n| Payment method `type` | Description |\n| --------------------- | ----------- |\n| `apple_pay` | The customer paid the order using Apple Pay. |\n| `card` | The customer paid the order using their credit or debit card. |\n| `google_pay` | The customer paid the order using Google Pay. |\n| `revolut_pay_card` | The customer paid the order via Revolut Pay using their credit or debit card. |\n| `revolut_pay_account` | The customer paid the order via Revolut Pay using their Revolut account. |\n| `sepa_direct_debit` | The customer paid the order using SEPA Direct Debit. |","descriptionNode":"$L18b6"},"card_brand":{"type":"string","description":"The type of the card.","enum":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:3:properties:card_brand:enum","descriptionNode":"$L18b7"},"funding":{"type":"string","description":"The type of card funding.","enum":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:3:properties:funding:enum","descriptionNode":"$L18b8"},"card_country_code":{"type":"string","description":"The 2-letter country code of the country where the card was issued.","descriptionNode":"$L18b9"},"card_bin":{"type":"string","description":"The BIN of the card.","minLength":6,"maxLength":6,"descriptionNode":"$L18ba"},"card_last_four":{"type":"string","description":"The last four digits of the card number.","minLength":4,"maxLength":4,"descriptionNode":"$L18bb"},"card_expiry":{"type":"string","format":"MM/YY","description":"The expiry date of the card in the format of MM/YY.","descriptionNode":"$L18bc"},"cardholder_name":{"type":"string","description":"The name of the cardholder.","descriptionNode":"$L18bd"},"checks":{"type":"object","description":"The details of the check for card payment. Only for orders with successful payments.","properties":{"three_ds":"$1c:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payments:items:properties:payment_method:oneOf:0:properties:checks:properties:three_ds","cvv_verification":"$1c:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payments:items:properties:payment_method:oneOf:0:properties:checks:properties:cvv_verification","address":"$1c:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payments:items:properties:payment_method:oneOf:0:properties:checks:properties:address","postcode":"$1c:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payments:items:properties:payment_method:oneOf:0:properties:checks:properties:postcode","cardholder":"$1c:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payments:items:properties:payment_method:oneOf:0:properties:checks:properties:cardholder"},"descriptionNode":"$L18be"},"authorisation_code":{"type":"string","description":"The authorisation code (or auth code) is a short, alphanumeric code returned by the cardholder's issuing bank to the merchant's terminal or payment gateway.\n\nIt serves as confirmation that the transaction has been approved and funds are available.","pattern":"^[a-zA-Z0-9]{2,6}$","minLength":2,"maxLength":6,"examples":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:0:properties:authorisation_code:examples","descriptionNode":"$L18bf"},"arn":{"type":"string","description":"Acquirer Reference Number (ARN) of the payment.\n\n:::note\nOnly returned for refund payments made by a card.\n:::","minLength":23,"maxLength":23,"examples":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:0:properties:arn:examples","descriptionNode":"$L18c0"},"capture_deadline":{"type":"string","format":"date-time","description":"The date and time by which the payment must be captured.\n\nAfter this deadline, the authorised funds may be automatically released by the card issuer.","descriptionNode":"$L18c1"},"terminal_hardware_id":{"type":"string","description":"The hardware identifier of the Revolut Terminal device used to process the payment.\n\n:::note\nOnly present for card-present transactions processed via Revolut Terminal.\n:::","descriptionNode":"$L18c2"},"fingerprint":{"type":"string","minLength":44,"maxLength":44,"description":"$18c3","examples":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:0:properties:fingerprint:examples","descriptionNode":"$L18c4"},"network_transaction_id":{"type":"string","description":"The Network Transaction ID (NTI) is a unique identifier assigned by the card scheme (e.g., Visa or Mastercard) to a card transaction.\n\nIt can be used to trace the transaction across the payment network, link recurring or instalment payments to the original authorisation, and support dispute resolution.","descriptionNode":"$L18c5"}},"required":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:3:required","descriptionNode":"$L18c6"},{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"ID of the saved payment method.\n\n:::note\nThe `id` parameter is only returned when the payment method is saved.\n:::","descriptionNode":"$L18c7"},"type":{"type":"string","enum":"$21:props:children:0:props:children:props:responses:200:content:application/json:schema:items:properties:payment_method:oneOf:2:properties:type:enum","description":"The type of payment method used to pay for the order.\n\nAvailable values:\n\n| Payment method `type` | Description |\n| --------------------- | ----------- |\n| `apple_pay` | The customer paid the order using Apple Pay. |\n| `card` | The customer paid the order using their credit or debit card. |\n| `google_pay` | The customer paid the order using Google Pay. |\n| `revolut_pay_card` | The customer paid the order via Revolut Pay using their credit or debit card. |\n| `revolut_pay_account` | The customer paid the order via Revolut Pay using their Revolut account. |\n| `sepa_direct_debit` | The customer paid the order using SEPA Direct Debit. |","descriptionNode":"$L18c8"},"fingerprint":{"type":"string","minLength":44,"maxLength":44,"description":"$18c9","examples":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:0:properties:fingerprint:examples","descriptionNode":"$L18ca"}},"required":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:4:required"},{"type":"object","description":"Object containing details of a SEPA Direct Debit payment.\n\n:::info\nFor more information, see: [SEPA Direct Debit server-to-server integration](https://developer.revolut.com/docs/guides/merchant/accept-payments/payment-methods/sepa-direct-debit/server-to-server)\n:::","properties":{"id":{"type":"string","format":"uuid","description":"ID of the saved payment method.\n\n:::note\nThe `id` parameter is only returned when the payment method is saved for the merchant.\n:::","descriptionNode":"$L18cb"},"type":{"type":"string","enum":"$21:props:children:0:props:children:props:responses:200:content:application/json:schema:items:properties:payment_method:oneOf:2:properties:type:enum","description":"The type of payment method used to pay for the order.\n\nAvailable values:\n\n| Payment method `type` | Description |\n| --------------------- | ----------- |\n| `apple_pay` | The customer paid the order using Apple Pay. |\n| `card` | The customer paid the order using their credit or debit card. |\n| `google_pay` | The customer paid the order using Google Pay. |\n| `revolut_pay_card` | The customer paid the order via Revolut Pay using their credit or debit card. |\n| `revolut_pay_account` | The customer paid the order via Revolut Pay using their Revolut account. |\n| `sepa_direct_debit` | The customer paid the order using SEPA Direct Debit. |","descriptionNode":"$L18cc"},"debtor_iban_last_four":{"type":"string","description":"The last four digits of the debtor's IBAN.","minLength":4,"maxLength":4,"descriptionNode":"$L18cd"},"debtor_name":{"type":"string","description":"The full name of the debtor as provided in the mandate.","descriptionNode":"$L18ce"},"mandate_reference":{"type":"string","description":"The unique mandate reference generated by Revolut. Include this in pre-debit notifications sent to your customers.","descriptionNode":"$L18cf"}},"required":"$21:props:children:0:props:children:props:responses:200:content:application/json:schema:items:properties:payment_method:oneOf:2:required","descriptionNode":"$L18d0"}],"descriptionNode":"$L18d1"},"authentication_challenge":{"type":"object","description":"Details about the authentication challenge that should be performed to complete the authentication process. For more information about Revolut's 3DS solution, see: [3D Secure overview](https://developer.revolut.com/docs/guides/merchant/reference/3d-secure).\n\nOnly returned if the payment's state is `authentication_challenge`.","discriminator":"$21:props:children:0:props:children:props:responses:200:content:application/json:schema:items:properties:authentication_challenge:discriminator","oneOf":[{"title":"three_ds","type":"object","description":"Information about the 3DS challenge.","properties":{"type":{"type":"string","enum":"$21:props:children:0:props:children:props:responses:200:content:application/json:schema:items:properties:authentication_challenge:oneOf:0:properties:type:enum","description":"Type of the authentication challenge the payment triggers.","descriptionNode":"$L18d2"},"acs_url":{"type":"string","format":"url","description":"The URL of the authentication challenge.","descriptionNode":"$L18d3"}},"required":"$21:props:children:0:props:children:props:responses:200:content:application/json:schema:items:properties:authentication_challenge:oneOf:0:required","descriptionNode":"$L18d4"},{"title":"three_ds_fingerprint","type":"object","description":"Information about the 3DS fingerprint challenge.","properties":{"type":{"type":"string","enum":"$21:props:children:0:props:children:props:responses:200:content:application/json:schema:items:properties:authentication_challenge:oneOf:0:properties:type:enum","description":"Type of the authentication challenge the payment triggers.","descriptionNode":"$L18d5"},"fingerprint_url":{"type":"string","format":"url","description":"The URL of the fingerprint. (Used only internally by Revolut.)","descriptionNode":"$L18d6"},"fingerprint_data":{"type":"string","format":"JSON","description":"Data about the fingerprint used for authentication. (Used only internally\nby Revolut.)","descriptionNode":"$L18d7"}},"required":"$21:props:children:0:props:children:props:responses:200:content:application/json:schema:items:properties:authentication_challenge:oneOf:1:required","descriptionNode":"$L18d8"}],"descriptionNode":"$L18d9"},"billing_address":{"type":"object","description":"Object containing address details.","properties":{"street_line_1":{"type":"string","description":"Street line 1 information.","maxLength":100,"descriptionNode":"$L18da"},"street_line_2":{"type":"string","description":"Street line 2 information.","maxLength":100,"descriptionNode":"$L18db"},"region":{"type":"string","description":"The region associated with the address.","maxLength":100,"descriptionNode":"$L18dc"},"city":{"type":"string","description":"The city associated with the address.","maxLength":100,"descriptionNode":"$L18dd"},"country_code":{"type":"string","description":"The 2-letter country code of the country associated with the address.","maxLength":2,"descriptionNode":"$L18de"},"postcode":{"type":"string","description":"The postcode associated with the address.","maxLength":100,"descriptionNode":"$L18df"}},"required":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:billing_address:required","descriptionNode":"$L18e0"},"risk_level":{"type":"string","description":"The risk level of the card.\n\nIf the risk level is `high`, the payment might be declined.","enum":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:risk_level:enum","descriptionNode":"$L18e1"},"fees":{"type":"array","description":"The details of the order fee.","items":{"type":"object","properties":{"type":{"type":"string","description":"The type of the order fee.","enum":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:fees:items:properties:type:enum","descriptionNode":"$L18e2"},"amount":{"type":"integer","description":"The amount of the payment fee (minor currency unit). For example, enter `7034` for €70.34 in the field.","descriptionNode":"$L18e3"},"currency":{"type":"string","description":"The currency of the payment fee. [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) currency code in upper case.\n\n:::info\nFor more information about the supported currencies, see: [Help Center](https://help.revolut.com/business/help/merchant-accounts/payments/in-which-currencies-can-i-accept-payments/).\n:::","descriptionNode":"$L18e4"}}},"descriptionNode":"$L18e5"},"payer":{"title":"Payer","type":"object","description":"The person who made the payment. This object is present when an email or phone number is provided during the payment flow.\n\nCapturing payer details lets you identify exactly who authorised the charge, reach the right person for receipts or refund queries, and support compliance or fraud-review workflows where the paying identity matters.","properties":{"email":{"description":"The email of the person who made the payment.","type":"string","format":"email","descriptionNode":"$L18e6"},"phone":{"description":"The phone number of the payer in [E.164 format](https://en.wikipedia.org/wiki/E.164).","type":"string","descriptionNode":"$L18e7"}},"descriptionNode":"$L18e8"}},"required":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payments:items:required","descriptionNode":"$L18e9"},"descriptionNode":"$L18ea"},"incremental_authorisations":{"type":"array","description":"History of incremental authorisation attempts for this order.\n\nOnly present for orders with `authorisation_type: pre_authorisation`.\n\nContains all increment attempts in chronological order.","items":{"type":"object","description":"Represents a single incremental authorisation attempt on an order.\n\nThe `incremental_authorisations` array tracks all increment attempts (successful and failed) in chronological order.","properties":{"new_amount":{"type":"integer","description":"The new total amount requested in this increment (in minor units).","examples":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:incremental_authorisations:items:properties:new_amount:examples","descriptionNode":"$L18eb"},"old_amount":{"type":"integer","description":"The previously authorised amount before this increment (in minor units).","examples":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:incremental_authorisations:items:properties:old_amount:examples","descriptionNode":"$L18ec"},"state":{"type":"string","enum":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:incremental_authorisations:items:properties:state:enum","description":"The state of this incremental authorization attempt.\n\n| State | Description |\n|-------|-------------|\n| `pending` | Increment registered in system, not yet submitted to card network |\n| `processing` | Increment is being processed by card network |\n| `authorised` | Increment was successfully authorised |\n| `declined` | Increment was declined by card issuer |\n| `failed` | Increment failed due to technical error (not an issuer decline) |","descriptionNode":"$L18ed"},"reference":{"type":"string","maxLength":255,"description":"External reference for this incremental authorisation.\n\n:::tip\nUse your internal charge or invoice ID. This reference is returned in webhooks for easy matching to your system.\n:::","examples":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:incremental_authorisations:items:properties:reference:examples","descriptionNode":"$L18ee"},"line_items":{"type":"array","description":"Line items associated with this increment (if provided).\n\n:::note\nIf the increment is successful, these line items will override the existing order line items.\n:::","items":{"type":"object","properties":{"name":{"type":"string","maxLength":250,"description":"Name of the line item.","descriptionNode":"$L18ef"},"type":{"type":"string","enum":"$19:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:orders:items:properties:line_items:items:properties:type:enum","description":"Type of the line item.","descriptionNode":"$L18f0"},"quantity":{"type":"object","description":"Object representing the quantity details of a line item, including the amount and its associated unit of measurement.","properties":{"value":{"type":"number","format":"double","minimum":0,"description":"The number of units of the line item.","descriptionNode":"$L18f1"},"unit":{"type":"string","maxLength":100,"description":"The measurement unit for the quantity, such as `cm`, or `kg`.","descriptionNode":"$L18f2"}},"required":"$19:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:orders:items:properties:line_items:items:properties:quantity:required","descriptionNode":"$L18f3"},"unit_price_amount":{"type":"integer","format":"int64","minimum":0,"description":"The unit price of the line item.","descriptionNode":"$L18f4"},"total_amount":{"type":"integer","format":"int64","description":"The total amount to be paid for the line item, including taxes and discounts.","descriptionNode":"$L18f5"},"external_id":{"type":"string","maxLength":250,"description":"Unique identifier of line item in the merchant's system.","descriptionNode":"$L18f6"},"discounts":{"type":"array","maxItems":50,"description":"A list of discounts applied to the line item. Each discount should be subtracted from the total amount payable for the item.","items":{"type":"object","description":"Details of a discount applied to the line item, including its name and monetary value.","properties":{"name":{"type":"string","maxLength":100,"description":"The specific name or label of the discount applied to the line item.","descriptionNode":"$L18f7"},"amount":{"type":"integer","format":"int64","minimum":0,"description":"The monetary value of the discount. ","descriptionNode":"$L18f8"}},"required":"$19:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:orders:items:properties:line_items:items:properties:discounts:items:required","descriptionNode":"$L18f9"},"descriptionNode":"$L18fa"},"taxes":{"type":"array","maxItems":50,"description":"A list of taxes applied to the line item. Each tax should be added to the total amount payable for the item.","items":{"type":"object","description":"Details about a tax applied to the line item, including its name and the corresponding amount.","properties":{"name":{"type":"string","description":"The specific name or designation of the tax applied to the line item.","maxLength":100,"descriptionNode":"$L18fb"},"amount":{"type":"integer","format":"int64","description":"The monetary value of the tax in minor currency units (e.g., cents for EUR).","minimum":0,"descriptionNode":"$L18fc"}},"required":"$19:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:orders:items:properties:line_items:items:properties:taxes:items:required","descriptionNode":"$L18fd"},"descriptionNode":"$L18fe"},"image_urls":{"type":"array","maxItems":50,"description":"A list of URLs pointing to images related to the line item. These images can provide visual details or representations of the item.","items":{"type":"string","format":"uri","pattern":"^https?:\\/{2}.+/gi","maxLength":2000,"description":"URL to an image associated with the line item.\n\n:::warning\nRestrictions:\n- Must be a valid URI as defined by [RFC 3986](https://datatracker.ietf.org/doc/html/rfc3986)\n- URI scheme is required and must be either `http` or `https`\n- URI host is required and cannot be `localhost` or an IP address\n- Max length: `2000`\n- Reserved or invalid characters must be percent-encoded (for example, use `%20` instead of a space)\n:::","descriptionNode":"$L18ff"},"descriptionNode":"$L1900"},"description":{"type":"string","maxLength":1024,"description":"Description of the line item.","descriptionNode":"$L1901"},"url":{"type":"string","format":"uri","pattern":"^https?:\\/{2}.+/gi","maxLength":2000,"description":"An HTTP/HTTPS URL that links to more information about the line item, such as a product page or details.\n\n:::warning\nRestrictions:\n- Must be a valid URI as defined by [RFC 3986](https://datatracker.ietf.org/doc/html/rfc3986)\n- URI scheme is required and must be either `http` or `https`\n- URI host is required and cannot be `localhost` or an IP address\n- Max length: `2000`\n- Reserved or invalid characters must be percent-encoded (for example, use `%20` instead of a space)\n:::","descriptionNode":"$L1902"}},"required":"$19:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:orders:items:properties:line_items:items:required"},"descriptionNode":"$L1903"},"reason":{"type":"string","description":"Reason why increment was declined or failed.\n\n:::note\nOnly present when `state` is `declined` or `failed`.\n:::","examples":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:incremental_authorisations:items:properties:reason:examples","descriptionNode":"$L1904"}},"descriptionNode":"$L1905"},"descriptionNode":"$L1906"},"location_id":{"type":"string","format":"uuid","description":"Unique ID representing the location where merchants sells products.\n\n:::info\nFor more information, see: [Locations](https://developer.revolut.com/docs/api/merchant#tag-locations).\n::: ","descriptionNode":"$L1907"},"metadata":{"type":"object","description":"Additional information to track your orders in your system, by providing custom metadata using `\"\" : \"\"` pairs.\n\n:::warning\n**Restrictions:**\n\n- Both keys and values must be `string`s\n- Values cannot be `null`.\n- Max number of key-value pairs: `50`\n- Max length of values: `500` characters\n- Format of keys: Must start with a letter and contain only letters, digits, and underscores. Max 40 characters. Pattern: `^[a-zA-Z][a-zA-Z\\\\d_]{0,39}$`\n:::","maxProperties":50,"additionalProperties":{"type":"string","maxLength":500,"description":"Additional metadata value provided with the corresponding metadata key.","descriptionNode":"$L1908"},"examples":"$19:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:orders:items:properties:metadata:examples","descriptionNode":"$L1909"},"industry_data":{"type":"object","description":"Object containing industry-specific information associated with the order.\n\n:::info\nIn the following cases, industry-specific info is required. Omitting this information may trigger additional scrutiny and risk mitigation actions by the Revolut risk team.\n\n | Transaction type | Required for |\n | ---------------- | ----------- |\n | `airline` | Airlines and Online Travel Agencies (OTAs). |\n | `car_rental` | Car Rental Merchants and Online Travel Agencies (OTAs). |\n | `crypto` | Crypto merchants. |\n | `marketplace` | Marketplace merchants. |\n | `event` | Event ticket sellers. |\n | `lodging` | Lodging providers. |\n:::","discriminator":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:discriminator","oneOf":[{"type":"object","description":"$190a","properties":{"type":{"type":"string","enum":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:0:properties:type:enum","description":"Type of the industry-specific data object, determining what additional data is expected.\n\nAvailable types:\n\n | Object type | Description |\n | ------------- | ----------- |\n | `airline` | Object containing information about a specific airline ticket purchase. |\n | `car_rental` | Object containing information about a car rental booking associated with the order. |\n | `crypto` | Object containing information about crypto transactions associated with the order. |\n | `marketplace` | This object is required by Mastercard and Visa for merchants operating as marketplaces under the **Merchant Category Code (MCC):** `5262`. The marketplace object ensures compliance with the card schemes' regulations by providing detailed information about the subseller involved in the transaction. |\n | `event` | Object containing information about event ticket bookings associated with the order. |\n | `lodging` | Object containing information about lodging bookings associated with the order. |","descriptionNode":"$L190b"},"booking_id":{"type":"string","description":"A unique identifier provided by the merchant associated with the order. \n\nThis `booking_id` is used to reference and correlate booking information with the Merchant API and the merchant's internal system.","descriptionNode":"$L190c"},"fulfillment_date":{"type":"string","format":"date-time","description":"The UTC date and time of the final journey leg.\n\n:::warning\nThe following limitations apply:\n - When creating or updating an order, `fulfillment_date` cannot be set to a date in the past.\n - When updating an order, if the current `fulfillment_date` value is already in the past, it cannot be modified. The date must remain as is to maintain data integrity for completed transactions.\n:::","descriptionNode":"$L190d"},"tickets_purchase":{"type":"boolean","description":"Flag indicating whether the order includes actual ticket purchases. Set to `true` if the order contains ticket purchases, and `false` if it does not (e.g., it **only** contains seat reservations, or baggage upgrades). \n\n:::info\nThis field is required for activating **Revolut Flight Alerts** functionalities within the Revolut app.\n\nProvide the info on order creation or update, before capturing the order.\n:::","descriptionNode":"$L190e"},"ticket_type":{"type":"string","enum":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:0:properties:ticket_type:enum","description":"The type of the ticket.\n\n| Parameter value | Description |\n| --------------- | ----------- |\n| `fixed` | Non-modifiable once confirmed. |\n| `flexible` | Allows modifications or cancellations under specified conditions. |","descriptionNode":"$L190f"},"crs_code":{"type":"string","maxLength":4,"description":"The code of the Computer Reservation System (CRS) used to make the booking and purchase the ticket.","descriptionNode":"$L1910"},"ticket_change_indicator":{"type":"string","enum":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:0:properties:ticket_change_indicator:enum","description":"Parameter indicating whether this order is related to a new ticket reservation or a modification of an existing one.","descriptionNode":"$L1911"},"refundability":{"type":"string","enum":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:0:properties:refundability:enum","description":"Parameter indicating whether the booking is refundable, partially refundable, or not refundable.","descriptionNode":"$L1912"},"passengers":{"type":"array","description":"Array containing information of passengers associated with the booking.","items":{"type":"object","properties":{"first_name":{"type":"string","description":"Passenger's first name.","descriptionNode":"$L1913"},"last_name":{"type":"string","description":"Passenger's last name.","descriptionNode":"$L1914"}},"required":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:0:properties:passengers:items:required"},"descriptionNode":"$L1915"},"journey_legs":{"type":"array","description":"Array containing information of journey legs associated with the booking.\n\n:::info\nThis field is required for activating **Revolut Flight Alerts** functionalities within the Revolut app. \n\nThis information is used to compile a tracking widget that provides real-time updates on flight status and sends notifications, such as a check-in reminders, boarding alerts, and notifications for cancellations or delays. \n\nTo enable the widget the following fields are required on order creation or update, before capturing the order:\n\n ```\n sequence,\n departure_airport_code,\n arrival_airport_code,\n flight_number,\n travel_date,\n airline_name,\n airline_code,\n ```\n:::","items":{"type":"object","properties":{"sequence":{"type":"integer","description":"Sequence of the journey legs. Increment by 1 for each flight included in the ticket.\n\nFor example: For a `FRA > LHR > DUB > LHR > FRA` journey the sequence will be assigned as:\n - `FRA > LHR`: 1\n - `LHR > DUB`: 2\n - `DUB > LHR`: 3\n - `LHR > FRA`: 4","descriptionNode":"$L1916"},"departure_airport_code":{"type":"string","description":"The [IATA](https://www.iata.org/en/services/codes) 3-letter airport code for the departure airport.","descriptionNode":"$L1917"},"arrival_airport_code":{"type":"string","description":"The [IATA](https://www.iata.org/en/services/codes) 3-letter airport code for the arrival airport.","descriptionNode":"$L1918"},"flight_number":{"type":"string","description":"The flight identifier, without airline code.","descriptionNode":"$L1919"},"fare_base_code":{"type":"string","description":"The fare base code for the given journey leg.","descriptionNode":"$L191a"},"travel_date":{"type":"string","format":"date-time","description":"The UTC date and time of the flight departure for the given journey leg.","descriptionNode":"$L191b"},"airline_name":{"type":"string","description":"The name of the airline associated with the journey leg.","descriptionNode":"$L191c"},"airline_code":{"type":"string","description":"The IATA 2-letter accounting code identifying the airline associated with the journey leg.","descriptionNode":"$L191d"},"pnr":{"type":"string","format":"alphanumeric","pattern":"^[a-zA-Z0-9]*$","maxLength":20,"description":"The Passenger Name Record (PNR) for the journey leg issued by the airline. \n\nPNR is a unique identifier for the booking, acting as a digital certificate allowing passengers to retrieve or manage their booking details.\n\n:::warning\nThis is a required field for OTAs.\n:::","descriptionNode":"$L191e"}},"required":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:0:properties:journey_legs:items:required"},"descriptionNode":"$L191f"},"booking_url":{"type":"string","format":"uri","pattern":"^https?:\\/{2}.+/gi","maxLength":2000,"description":"URL to the online portal for managing the airline booking, which includes check-in functionality. This URL may be a personalised, pre-populated check-in link specific to the user or a generic link, and it is essential for enabling direct access to booking details within the Revolut app.\n\n:::info\nThis field is required for activating **Revolut Flight Alerts** functionalities within the Revolut app. \n\nProvide the info on order creation or update, before capturing the order.\n:::\n\n:::warning\nRestrictions:\n- Must be a valid URI as defined by [RFC 3986](https://datatracker.ietf.org/doc/html/rfc3986)\n- URI scheme is required and must be either `http` or `https`\n- URI host is required and cannot be `localhost` or an IP address\n- Max length: `2000`\n- Reserved or invalid characters must be percent-encoded (for example, use `%20` instead of a space)\n:::","descriptionNode":"$L1920"}},"required":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:0:required","descriptionNode":"$L1921"},{"type":"object","description":"Object containing additional information about a car rental booking associated with the order.\n\n:::info\nThese are the specific data field requirements for merchants offering car rental. Note that these requirements can be extended on a case by case basis as decided by Revolut.\n\n```\nbooking_id\ndrop_off_date\nrefundability\n```\n:::","properties":{"type":{"type":"string","enum":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:0:properties:type:enum","description":"Type of the industry-specific data object, determining what additional data is expected.\n\nAvailable types:\n\n | Object type | Description |\n | ------------- | ----------- |\n | `airline` | Object containing information about a specific airline ticket purchase. |\n | `car_rental` | Object containing information about a car rental booking associated with the order. |\n | `crypto` | Object containing information about crypto transactions associated with the order. |\n | `marketplace` | This object is required by Mastercard and Visa for merchants operating as marketplaces under the **Merchant Category Code (MCC):** `5262`. The marketplace object ensures compliance with the card schemes' regulations by providing detailed information about the subseller involved in the transaction. |\n | `event` | Object containing information about event ticket bookings associated with the order. |\n | `lodging` | Object containing information about lodging bookings associated with the order. |","descriptionNode":"$L1922"},"booking_id":{"type":"string","description":"A unique identifier provided by the merchant associated with the order. \n\nThis `booking_id` is used to reference and correlate booking information with the Merchant API and the merchant's internal system.","descriptionNode":"$L1923"},"pick_up_date":{"type":"string","format":"date-time","description":"The UTC date and time of the pick-up.","descriptionNode":"$L1924"},"pick_up_location":{"type":"object","description":"Object containing address details.","properties":{"street_line_1":"$1c:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payments:items:properties:billing_address:properties:street_line_1","street_line_2":"$1c:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payments:items:properties:billing_address:properties:street_line_2","region":"$1c:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payments:items:properties:billing_address:properties:region","city":"$1c:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payments:items:properties:billing_address:properties:city","country_code":"$1c:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payments:items:properties:billing_address:properties:country_code","postcode":"$1c:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payments:items:properties:billing_address:properties:postcode"},"required":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:billing_address:required","descriptionNode":"$L1925"},"drop_off_date":{"type":"string","format":"date-time","description":"The UTC date and time of the drop-off.","descriptionNode":"$L1926"},"drop_off_location":{"type":"object","description":"Object containing address details.","properties":{"street_line_1":"$1c:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payments:items:properties:billing_address:properties:street_line_1","street_line_2":"$1c:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payments:items:properties:billing_address:properties:street_line_2","region":"$1c:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payments:items:properties:billing_address:properties:region","city":"$1c:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payments:items:properties:billing_address:properties:city","country_code":"$1c:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payments:items:properties:billing_address:properties:country_code","postcode":"$1c:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payments:items:properties:billing_address:properties:postcode"},"required":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:billing_address:required","descriptionNode":"$L1927"},"refundability":{"type":"string","enum":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:0:properties:refundability:enum","description":"Parameter indicating whether the booking is refundable, partially refundable, or not refundable.","descriptionNode":"$L1928"},"distance_limit":{"type":"object","description":"Object containing distance limit information.","properties":{"limit":{"type":"integer","description":"The maximum distance allowed.","descriptionNode":"$L1929"},"unit":{"type":"string","description":"The unit of distance.","enum":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:1:properties:distance_limit:properties:unit:enum","descriptionNode":"$L192a"},"additional_distance_cost":{"type":"object","description":"Cost for exceeding the distance limit.","properties":{"amount":{"type":"integer","description":"The amount of the cost in minor currency units. For example, enter `7034` for €70.34.","descriptionNode":"$L192b"},"currency":{"type":"string","format":"ISO 4217","minLength":3,"maxLength":3,"description":"[ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) currency code in upper case.\n\n:::info\nFor more information about the supported currencies, see: [Help Center](https://help.revolut.com/business/help/merchant-accounts/payments/in-which-currencies-can-i-accept-payments/).\n:::","descriptionNode":"$L192c"}},"descriptionNode":"$L192d"}},"descriptionNode":"$L192e"}},"required":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:1:required","descriptionNode":"$L192f"},{"type":"object","description":"Object containing information about crypto transactions associated with the order.\n\n:::info\nProcessing crypto on-ramp transactions with Revolut has additional compliance requirements. Please reach out to your account executive for additional details.\n\n**Required data fields for crypto services:**\n\n```\ntransactions[].id\ntransactions[].status\ntransactions[].recipient_wallet_id\nseller.id\nseller.name\nseller.website\nseller.phone\nseller.address\nseller.mcc\ncustomer.full_name\ncustomer.date_of_birth\n```\n\nNote that these requirements can be extended on a case by case basis as decided by Revolut.\n:::","properties":{"type":{"type":"string","enum":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:0:properties:type:enum","description":"Type of the industry-specific data object, determining what additional data is expected.\n\nAvailable types:\n\n | Object type | Description |\n | ------------- | ----------- |\n | `airline` | Object containing information about a specific airline ticket purchase. |\n | `car_rental` | Object containing information about a car rental booking associated with the order. |\n | `crypto` | Object containing information about crypto transactions associated with the order. |\n | `marketplace` | This object is required by Mastercard and Visa for merchants operating as marketplaces under the **Merchant Category Code (MCC):** `5262`. The marketplace object ensures compliance with the card schemes' regulations by providing detailed information about the subseller involved in the transaction. |\n | `event` | Object containing information about event ticket bookings associated with the order. |\n | `lodging` | Object containing information about lodging bookings associated with the order. |","descriptionNode":"$L1930"},"transactions":{"type":"array","description":"Array of crypto transaction data associated with the order.","items":{"type":"object","properties":{"id":{"type":"string","maxLength":255,"description":"The public transaction hash of the crypto transaction.","descriptionNode":"$L1931"},"status":{"type":"string","enum":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:2:properties:transactions:items:properties:status:enum","description":"The status of the crypto transaction.","descriptionNode":"$L1932"},"recipient_wallet_id":{"type":"string","maxLength":255,"description":"The wallet ID of the recipient.\n\n:::note\nAt least one of the parameters: `recipient_user_id` or `recipient_wallet_id` is required.\n::: ","descriptionNode":"$L1933"},"recipient_user_id":{"type":"string","maxLength":255,"description":"The user ID of the recipient.\n\n:::note\nAt least one of the parameters: `recipient_user_id` or `recipient_wallet_id` is required.\n::: ","descriptionNode":"$L1934"}},"required":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:2:properties:transactions:items:required"},"minItems":1,"descriptionNode":"$L1935"},"seller":{"type":"object","description":"Information about the crypto conversion affiliate.\n\nThis should be provided when a customer completes a payment on a subseller's website rather than directly on the merchant's website, providing insight into the type of business conducted by the subseller.\n\n:::note\nThis needs to be provided only by crypto on-ramp providers for payments they are processing for conversion affiliates.\n\nFor their own payments, `seller` can be omitted.\n:::","properties":{"mcc":{"type":"string","description":"A string representing the four-digit [Merchant Category Code (MCC)](https://en.wikipedia.org/wiki/Merchant_category_code) of the conversion affiliate.","maxLength":4,"minLength":4,"pattern":"^\\d{4}$","descriptionNode":"$L1936"},"id":{"type":"string","description":"The ID of the seller in the merchant's internal system.","minLength":1,"maxLength":15,"descriptionNode":"$L1937"},"name":{"type":"string","description":"The business or legal name of the seller.","minLength":1,"maxLength":50,"descriptionNode":"$L1938"},"website":{"type":"string","format":"uri","pattern":"^https?:\\/{2}.+/gi","maxLength":255,"description":"The URL of the website of the seller.\n\n:::warning\nRestrictions:\n- Must be a valid URI as defined by [RFC 3986](https://datatracker.ietf.org/doc/html/rfc3986)\n- URI scheme is required and must be either `http` or `https`\n- URI host is required and cannot be `localhost` or an IP address\n- Max length: `255`\n- Reserved or invalid characters must be percent-encoded (for example, use `%20` instead of a space)\n:::","descriptionNode":"$L1939"},"phone":{"type":"string","description":"The phone number of the seller.","descriptionNode":"$L193a"},"address":{"type":"object","description":"Details of a physical address.","properties":{"street_line_1":{"type":"string","description":"Primary address line.","maxLength":100,"descriptionNode":"$L193b"},"street_line_2":{"type":"string","description":"Secondary address line, such as floor and apartment number.","maxLength":100,"descriptionNode":"$L193c"},"region":{"type":"string","description":"State or province of the address.","maxLength":100,"descriptionNode":"$L193d"},"city":{"type":"string","description":"City of the address.","maxLength":100,"descriptionNode":"$L193e"},"country_code":{"type":"string","pattern":"^[A-Z]{2}$","description":"ISO 2-letter country code.","minLength":2,"maxLength":2,"descriptionNode":"$L193f"},"country_subdivision_code":{"type":"string","pattern":"^[A-Z]{2}-[A-Z0-9]{1,3}$","description":"The subdivision code represents the state, province, or region within the country, following the [ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2) standard. This code uniquely identifies subdivisions within a country. \n\nFor example, for London in the United Kingdom, use `GB-LND`.\n\n:::warning\nThe parameter is required for countries listed on the [ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2) page.\n:::","minLength":5,"maxLength":6,"descriptionNode":"$L1940"},"postcode":{"type":"string","description":"Postal code of the address.","maxLength":100,"descriptionNode":"$L1941"}},"required":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:2:properties:seller:properties:address:required","descriptionNode":"$L1942"}},"required":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:2:properties:seller:required","descriptionNode":"$L1943"}},"required":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:2:required","descriptionNode":"$L1944"},{"type":"object","description":"This object is required by Mastercard and Visa for merchants operating as marketplaces under the Merchant Category Code (MCC) `5262`. The marketplace object ensures compliance with the card schemes' regulations by providing detailed information about the seller involved in the transaction.\n\n:::info\nThese are the specific data field requirements for merchants who must provide marketplace data.\n\n```\nseller.id\nseller.name\nseller.website\nseller.phone\nseller.address\n```\n:::","properties":{"type":{"type":"string","enum":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:0:properties:type:enum","description":"Type of the industry-specific data object, determining what additional data is expected.\n\nAvailable types:\n\n | Object type | Description |\n | ------------- | ----------- |\n | `airline` | Object containing information about a specific airline ticket purchase. |\n | `car_rental` | Object containing information about a car rental booking associated with the order. |\n | `crypto` | Object containing information about crypto transactions associated with the order. |\n | `marketplace` | This object is required by Mastercard and Visa for merchants operating as marketplaces under the **Merchant Category Code (MCC):** `5262`. The marketplace object ensures compliance with the card schemes' regulations by providing detailed information about the subseller involved in the transaction. |\n | `event` | Object containing information about event ticket bookings associated with the order. |\n | `lodging` | Object containing information about lodging bookings associated with the order. |","descriptionNode":"$L1945"},"seller":{"type":"object","description":"Information about the subseller on the marketplace platform.","properties":{"id":{"type":"string","description":"The ID of the seller in the merchant's internal system.","minLength":1,"maxLength":15,"descriptionNode":"$L1946"},"name":{"type":"string","description":"The business or legal name of the seller.","minLength":1,"maxLength":50,"descriptionNode":"$L1947"},"website":{"type":"string","format":"uri","pattern":"^https?:\\/{2}.+/gi","maxLength":255,"description":"The URL of the website of the seller.\n\n:::warning\nRestrictions:\n- Must be a valid URI as defined by [RFC 3986](https://datatracker.ietf.org/doc/html/rfc3986)\n- URI scheme is required and must be either `http` or `https`\n- URI host is required and cannot be `localhost` or an IP address\n- Max length: `255`\n- Reserved or invalid characters must be percent-encoded (for example, use `%20` instead of a space)\n:::","descriptionNode":"$L1948"},"phone":{"type":"string","description":"The phone number of the seller.","descriptionNode":"$L1949"},"address":{"type":"object","description":"Details of a physical address.","properties":{"street_line_1":"$1c:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:2:properties:seller:properties:address:properties:street_line_1","street_line_2":"$1c:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:2:properties:seller:properties:address:properties:street_line_2","region":"$1c:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:2:properties:seller:properties:address:properties:region","city":"$1c:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:2:properties:seller:properties:address:properties:city","country_code":"$1c:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:2:properties:seller:properties:address:properties:country_code","country_subdivision_code":"$1c:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:2:properties:seller:properties:address:properties:country_subdivision_code","postcode":"$1c:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:2:properties:seller:properties:address:properties:postcode"},"required":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:2:properties:seller:properties:address:required","descriptionNode":"$L194a"}},"required":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:3:properties:seller:required","descriptionNode":"$L194b"}},"required":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:3:required","descriptionNode":"$L194c"},{"type":"object","description":"Object containing booking information for a list of event tickets associated with the order.\n\n:::info\nThese are the specific data field requirements for merchants who must provide event data. Note that these requirements can be extended on a case by case basis as decided by Revolut.\n\n```\nbooking_id\nevents[].start_date\nevents[].end_date\nevents[].supplier\nevents[].tickets[].id\n```\n:::","properties":{"type":{"type":"string","enum":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:0:properties:type:enum","description":"Type of the industry-specific data object, determining what additional data is expected.\n\nAvailable types:\n\n | Object type | Description |\n | ------------- | ----------- |\n | `airline` | Object containing information about a specific airline ticket purchase. |\n | `car_rental` | Object containing information about a car rental booking associated with the order. |\n | `crypto` | Object containing information about crypto transactions associated with the order. |\n | `marketplace` | This object is required by Mastercard and Visa for merchants operating as marketplaces under the **Merchant Category Code (MCC):** `5262`. The marketplace object ensures compliance with the card schemes' regulations by providing detailed information about the subseller involved in the transaction. |\n | `event` | Object containing information about event ticket bookings associated with the order. |\n | `lodging` | Object containing information about lodging bookings associated with the order. |","descriptionNode":"$L194d"},"booking_id":{"type":"string","description":"A unique identifier provided by the merchant associated with the order. \n\nThis `booking_id` is used to reference and correlate booking information with the Merchant API and the merchant's internal system.","descriptionNode":"$L194e"},"events":{"type":"array","description":"A list of events associated with the booking.","items":{"type":"object","description":"Object containing booking information about a specific event. ","properties":{"start_date":{"type":"string","format":"date-time","description":"[ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time when the event starts.","descriptionNode":"$L194f"},"end_date":{"type":"string","format":"date-time","description":"[ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time when the event ends.","descriptionNode":"$L1950"},"supplier":{"type":"string","description":"Legal name of the ticket vendor/event organiser.","descriptionNode":"$L1951"},"supplier_payment_date":{"type":"string","format":"date-time","description":"[ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time when the funds are released to merchants.","descriptionNode":"$L1952"},"name":{"type":"string","description":"The name of the event.","descriptionNode":"$L1953"},"location":{"type":"object","description":"The address of the event location.","properties":{"street_line_1":{"type":"string","description":"Primary address line.","maxLength":100,"descriptionNode":"$L1954"},"street_line_2":{"type":"string","description":"Secondary address line, such as floor and apartment number.","maxLength":100,"descriptionNode":"$L1955"},"region":{"type":"string","description":"State or province of the address.","maxLength":100,"descriptionNode":"$L1956"},"city":{"type":"string","description":"City of the address.","maxLength":100,"descriptionNode":"$L1957"},"country_code":{"type":"string","pattern":"^[A-Z]{2}$","description":"ISO 2-letter country code.","minLength":2,"maxLength":2,"descriptionNode":"$L1958"},"postcode":{"type":"string","description":"Postal code of the address.","maxLength":100,"descriptionNode":"$L1959"}},"required":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:4:properties:events:items:properties:location:required","descriptionNode":"$L195a"},"category":{"type":"string","enum":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:4:properties:events:items:properties:category:enum","description":"The type of the event.","descriptionNode":"$L195b"},"market":{"type":"string","enum":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:4:properties:events:items:properties:market:enum","description":"Indicates the relationship between the ticket vendor and the event organiser. \n\n| Parameter value | Description |\n| --------------- | ----------- |\n| `primary` | The merchant is the organiser and primary distributor of the tickets. |\n| `secondary` | The merchant is a reseller, only distributing the tickets. |","descriptionNode":"$L195c"},"tickets":{"type":"array","items":{"type":"object","description":"Object containing information about a ticket associated with the booking.","properties":{"id":{"type":"string","description":"A unique identifier provided by the merchant associated with the ticket.","descriptionNode":"$L195d"},"transferable":{"type":"boolean","description":"Indicates whether the ticket is transferable to another buyer.","descriptionNode":"$L195e"},"refundability":{"type":"string","enum":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:0:properties:refundability:enum","description":"Parameter indicating whether the booking is refundable, partially refundable, or not refundable.","descriptionNode":"$L195f"}},"required":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:4:properties:events:items:properties:tickets:items:required","descriptionNode":"$L1960"},"description":"A list of tickets associated with the booking.","descriptionNode":"$L1961"}},"descriptionNode":"$L1962"},"descriptionNode":"$L1963"}},"required":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:4:required","descriptionNode":"$L1964"},{"type":"object","description":"Object containing details of a lodging booking.\n\n:::info\nThese are the specific data field requirements for merchants who must provide lodging data. Note that these requirements can be extended on a case by case basis as decided by Revolut.\n\n```\nbooking_id\ncheck_in_date\ncheck_out_date\nsupplier_payment_date\n```\n:::","properties":{"type":{"type":"string","enum":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:0:properties:type:enum","description":"Type of the industry-specific data object, determining what additional data is expected.\n\nAvailable types:\n\n | Object type | Description |\n | ------------- | ----------- |\n | `airline` | Object containing information about a specific airline ticket purchase. |\n | `car_rental` | Object containing information about a car rental booking associated with the order. |\n | `crypto` | Object containing information about crypto transactions associated with the order. |\n | `marketplace` | This object is required by Mastercard and Visa for merchants operating as marketplaces under the **Merchant Category Code (MCC):** `5262`. The marketplace object ensures compliance with the card schemes' regulations by providing detailed information about the subseller involved in the transaction. |\n | `event` | Object containing information about event ticket bookings associated with the order. |\n | `lodging` | Object containing information about lodging bookings associated with the order. |","descriptionNode":"$L1965"},"booking_id":{"type":"string","description":"A unique identifier provided by the merchant associated with the order. \n\nThis `booking_id` is used to reference and correlate booking information with the Merchant API and the merchant's internal system.","descriptionNode":"$L1966"},"check_in_date":{"type":"string","format":"date-time","description":"[ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time of the check-in.","descriptionNode":"$L1967"},"check_out_date":{"type":"string","format":"date-time","description":"[ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time of the check-out.","descriptionNode":"$L1968"},"supplier_payment_date":{"type":"string","format":"date-time","description":"[ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time when the funds are released to merchants.","descriptionNode":"$L1969"},"category":{"type":"string","enum":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:5:properties:category:enum","description":"The type of the accommodation associated with the booking.","descriptionNode":"$L196a"},"booking_type":{"type":"string","enum":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:5:properties:booking_type:enum","description":"Indicates whether the booking terms are fixed or flexible.\n\n| Parameter value | Description |\n| --------------- | ----------- |\n| `fixed` | Non-modifiable once confirmed. |\n| `flexible` | Allows modifications or cancellations under specified conditions. |","descriptionNode":"$L196b"},"refundability":{"type":"string","enum":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:0:properties:refundability:enum","description":"Parameter indicating whether the booking is refundable, partially refundable, or not refundable.","descriptionNode":"$L196c"},"location":{"type":"object","description":"Address of the accommodation.","properties":{"street_line_1":{"type":"string","description":"Primary address line.","maxLength":100,"descriptionNode":"$L196d"},"street_line_2":{"type":"string","description":"Secondary address line, such as floor and apartment number.","maxLength":100,"descriptionNode":"$L196e"},"region":{"type":"string","description":"State or province of the address.","maxLength":100,"descriptionNode":"$L196f"},"city":{"type":"string","description":"City of the address.","maxLength":100,"descriptionNode":"$L1970"},"country_code":{"type":"string","pattern":"^[A-Z]{2}$","description":"ISO 2-letter country code.","minLength":2,"maxLength":2,"descriptionNode":"$L1971"},"postcode":{"type":"string","description":"Postal code of the address.","maxLength":100,"descriptionNode":"$L1972"}},"required":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:5:properties:location:required","descriptionNode":"$L1973"},"guests":{"type":"array","items":{"type":"object","properties":{"first_name":{"type":"string","description":"Guest's first name.","descriptionNode":"$L1974"},"last_name":{"type":"string","description":"Guest's last name.","descriptionNode":"$L1975"}},"required":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:5:properties:guests:items:required"},"description":"List of guests associated with the booking.","descriptionNode":"$L1976"}},"required":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:5:required","descriptionNode":"$L1977"}],"descriptionNode":"$L1978"},"merchant_order_data":{"type":"object","description":"Object for providing additional information stored in the merchant's order management system. ","properties":{"url":{"type":"string","format":"uri","pattern":"^https?:\\/{2}.+/gi","maxLength":2000,"description":"The URL of the order stored in the merchant's order management system.\n\nThis URL will be included in the order confirmation email for payments made via Revolut Pay. If specified, this URL will override the default link to the merchant's **Business website** configured in the Revolut Business account.\n\n:::warning\nRestrictions:\n- Must be a valid URI as defined by [RFC 3986](https://datatracker.ietf.org/doc/html/rfc3986)\n- URI scheme is required and must be either `http` or `https`\n- URI host is required and cannot be `localhost` or an IP address\n- Max length: `2000`\n- Reserved or invalid characters must be percent-encoded (for example, use `%20` instead of a space)\n:::","descriptionNode":"$L1979"},"reference":{"type":"string","description":"Merchant order ID for external reference.\n\nUse this field to set the ID that your own system can use to easily track orders.","descriptionNode":"$L197a"}},"descriptionNode":"$L197b"},"upcoming_payment_data":{"type":"object","description":"Object containing information about upcoming payments associated with the order.","properties":{"date":{"type":"string","format":"date-time","description":"The date and time in [ISO 8601 format](https://en.wikipedia.org/wiki/ISO_8601) when the upcoming payment is scheduled to be executed.","descriptionNode":"$L197c"},"payment_method_id":{"type":"string","description":"The unique ID of the customer's payment method used to complete the scheduled payment.\n\n:::info\nFor more information about operations related to customer's payment methods, see:\n - [Retrieve payment method list of a customer](https://developer.revolut.com/docs/api/merchant#retrieve-payment-method-list)\n - [Retrieve a customer's payment method](https://developer.revolut.com/docs/api/merchant#retrieve-payment-method)\n - [Update a customer's payment method](https://developer.revolut.com/docs/api/merchant#update-payment-method)\n - [Delete a customer's payment method](https://developer.revolut.com/docs/api/merchant#delete-payment-method)\n:::","descriptionNode":"$L197d"}},"required":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:upcoming_payment_data:required","descriptionNode":"$L197e"},"checkout_url":{"type":"string","description":"Link to a checkout page hosted by Revolut.","format":"uri","descriptionNode":"$L197f"},"redirect_url":{"type":"string","format":"uri","pattern":"^https?:\\/{2}.+/gi","maxLength":2000,"description":"The URL your customer will be redirected to after a successful payment on the hosted checkout page (`checkout_url` parameter's value of the order).\n\n:::warning\nRestrictions:\n- Must be a valid URI as defined by [RFC 3986](https://datatracker.ietf.org/doc/html/rfc3986)\n- URI scheme is required and must be either `http` or `https`\n- URI host is required and cannot be `localhost` or an IP address\n- Max length: `2000`\n- Reserved or invalid characters must be percent-encoded (for example, use `%20` instead of a space)\n:::\n\n:::info\nFor more information on how to use the `redirect_url`, see: [Custom redirection via the API](https://developer.revolut.com/docs/guides/merchant/accept-payments/online-payments/hosted-checkout-page/api#custom-post-payment-redirection-optional)\n:::","descriptionNode":"$L1980"},"shipping":{"type":"object","description":"Details about the shipping related to the order, including address, contact information, and individual shipments.\n\n:::info\nRequired for merchants shipping physical goods. Omitting this information may trigger additional scrutiny and risk mitigation actions by Revolut.\n:::","properties":{"address":{"type":"object","description":"Details of a physical address.","properties":{"street_line_1":{"type":"string","description":"Primary address line.","maxLength":100,"descriptionNode":"$L1981"},"street_line_2":{"type":"string","description":"Secondary address line, such as floor and apartment number.","maxLength":100,"descriptionNode":"$L1982"},"region":{"type":"string","description":"State or province of the address.","maxLength":100,"descriptionNode":"$L1983"},"city":{"type":"string","description":"City of the address.","maxLength":100,"descriptionNode":"$L1984"},"country_code":{"type":"string","pattern":"^[A-Z]{2}$","description":"ISO 2-letter country code.","minLength":2,"maxLength":2,"descriptionNode":"$L1985"},"postcode":{"type":"string","description":"Postal code of the address.","maxLength":100,"descriptionNode":"$L1986"}},"required":"$60:props:children:0:props:children:props:responses:200:content:application/json:schema:oneOf:1:properties:details:properties:address:required","descriptionNode":"$L1987"},"contact":{"type":"object","description":"Contact details for someone responsible for the shipment.\n\n:::warning\nAt least `email` or `phone` is required.\n:::","properties":{"name":{"type":"string","description":"Full name of the contact person.","maxLength":250,"descriptionNode":"$L1988"},"email":{"type":"string","format":"email","description":"Email address of the contact person.","descriptionNode":"$L1989"},"phone":{"type":"string","description":"Phone number of the contact person.","descriptionNode":"$L198a"}},"descriptionNode":"$L198b"},"shipments":{"type":"array","description":"List of individual shipment details.","maxItems":50,"items":{"type":"object","description":"Details of an individual shipment.","properties":{"shipping_company_name":{"type":"string","maxLength":250,"description":"Name of the company handling the shipment.","descriptionNode":"$L198c"},"tracking_number":{"type":"string","maxLength":500,"description":"Unique tracking number for the shipment.","descriptionNode":"$L198d"},"estimated_delivery_date":{"type":"string","format":"date-time","description":"Estimated delivery date and time for the shipment. \nThe time should also include the customer's timezone.","descriptionNode":"$L198e"},"tracking_url":{"type":"string","format":"uri","pattern":"^https?:\\/{2}.+/gi","maxLength":2000,"description":"An HTTP/HTTPS URL where the shipment can be tracked.\n\n:::warning\nRestrictions:\n- Must be a valid URI as defined by [RFC 3986](https://datatracker.ietf.org/doc/html/rfc3986)\n- URI scheme is required and must be either `http` or `https`\n- URI host is required and cannot be `localhost` or an IP address\n- Max length: `2000`\n- Reserved or invalid characters must be percent-encoded (for example, use `%20` instead of a space)\n:::","descriptionNode":"$L198f"}},"required":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:shipping:properties:shipments:items:required","descriptionNode":"$L1990"},"descriptionNode":"$L1991"}},"descriptionNode":"$L1992"},"enforce_challenge":{"type":"string","description":"The enforce challenge mode. `automatic` is used by default.\n\n| Parameter value | Description |\n| --------------- | ----------- |\n| `automatic` | The payments created for an order will have challenge requirement calculated by our fraud mechanisms. Not all payments will trigger a 3DS challenge. |\n| `forced` | The payments created for an order will always require a 3DS challenge. Currently only supported for card payments. |","default":"automatic","enum":"$19:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:orders:items:properties:enforce_challenge:enum","descriptionNode":"$L1993"},"line_items":{"type":"array","maxItems":250,"description":"An array of line items included in the order. Each line item represents an individual product or service, along with its quantity, price, taxes, and discounts.\n\n:::info\nRequired for merchants collecting payment for one or multiple products/services in one transaction. Omitting this information may trigger additional scrutiny and risk mitigation actions by Revolut.\n:::","items":{"type":"object","properties":{"name":"$1c:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:incremental_authorisations:items:properties:line_items:items:properties:name","type":"$1c:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:incremental_authorisations:items:properties:line_items:items:properties:type","quantity":"$1c:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:incremental_authorisations:items:properties:line_items:items:properties:quantity","unit_price_amount":"$1c:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:incremental_authorisations:items:properties:line_items:items:properties:unit_price_amount","total_amount":"$1c:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:incremental_authorisations:items:properties:line_items:items:properties:total_amount","external_id":"$1c:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:incremental_authorisations:items:properties:line_items:items:properties:external_id","discounts":"$1c:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:incremental_authorisations:items:properties:line_items:items:properties:discounts","taxes":"$1c:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:incremental_authorisations:items:properties:line_items:items:properties:taxes","image_urls":"$1c:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:incremental_authorisations:items:properties:line_items:items:properties:image_urls","description":"$1c:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:incremental_authorisations:items:properties:line_items:items:properties:description","url":"$1c:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:incremental_authorisations:items:properties:line_items:items:properties:url"},"required":"$19:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:orders:items:properties:line_items:items:required"},"descriptionNode":"$L1994"},"statement_descriptor_suffix":{"type":"string","description":"$1995","minLength":1,"maxLength":19,"pattern":"^[^*\\n\\r\\\\]+$","descriptionNode":"$L1996"},"related_order_id":{"type":"string","format":"uuid","description":"The unique ID of the original order that was refunded and this refund is associated with. You can use this ID to get more information about the related order using the [Retrieve an order](https://developer.revolut.com/docs/api/merchant#retrieve-order) operation.\n\n:::note\nThis field is only returned for orders with `type: refund`.\n:::","descriptionNode":"$L1997"},"subscription_data":{"title":"Subscription data","type":"object","required":"$19:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:orders:items:properties:subscription_data:required","description":"Subscription details linked to the order. Use this object to match an order with its underlying subscription and understand the billing context in which the order was created.\n\nOnly present on orders created by a subscription.","properties":{"subscription_id":{"type":"string","format":"uuid","description":"Unique identifier for the subscription.","descriptionNode":"$L1998"},"active_cycle_id":{"type":"string","format":"uuid","description":"The unique identifier of the active (pre-paid) subscription cycle that this order collects payment for.\n\nThis is the current billing cycle whose recurring charges are being collected in advance by this order. For example, if a subscription cycle covers 1-31 July and the order is generated on 1 July, this field identifies that July cycle.","descriptionNode":"$L1999"},"settled_cycle_id":{"type":"string","format":"uuid","description":"The unique identifier of the settled (post-paid) subscription cycle whose usage-based charges this order collects.\n\nThis is the previous billing cycle whose usage is being settled by this order. For example, if a subscription cycle covers usage from 1-30 June and the order is generated on 10 July, this field identifies that June cycle.","descriptionNode":"$L199a"},"billing_reason":{"type":"string","enum":"$19:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:orders:items:properties:subscription_data:properties:billing_reason:enum","description":"The reason this subscription order was created.\n\n| Value | Description |\n| ----- | ----------- |\n| `cycle_billing` | The order was automatically generated to collect payment for an ongoing subscription cycle. `active_cycle_id` is present; `settled_cycle_id` is present if the previous cycle included usage-based products. |\n| `final_settlement` | The order was automatically generated after the subscription ended to collect outstanding usage-based charges. `active_cycle_id` is absent; `settled_cycle_id` is present. |\n| `setup_intent` | The order was manually created by the merchant or customer to update the payment method on file. `active_cycle_id` is absent; `settled_cycle_id` is absent. |","descriptionNode":"$L199b"}},"descriptionNode":"$L199c"}},"descriptionNode":"$L199d"},"examples":{"increment_in_progress":{"summary":"Increment in progress","value":{"id":"6920869a-8d8d-aefd-a3c3-8fe4690e4323","token":"0823794d-28e9-4fdd-a130-3293ff9dd57b","type":"payment","state":"processing","created_at":"2025-11-21T15:34:50.351537Z","updated_at":"2025-11-21T15:35:12.123456Z","amount":500,"currency":"EUR","outstanding_amount":500,"capture_mode":"manual","authorisation_type":"pre_authorisation","incremental_authorisations":[{"new_amount":600,"old_amount":500,"state":"processing","reference":"1263738"}],"payments":[{"id":"696a4ce4-2aaf-a008-9f26-f47cf8ab1678","state":"authorisation_started","created_at":"2025-11-21T15:34:50.474085Z","updated_at":"2025-11-21T15:35:12.300608Z","token":"928f25b1-121c-4669-ab9f-d0b7a5804576","amount":600,"authorised_amount":500,"currency":"EUR","settled_amount":500,"settled_currency":"EUR","billing_address":{"country_code":"US","postcode":"94102"},"risk_level":"low","fees":[],"payer":{"email":"example.payer@example.com","phone":"+447911123456"},"payment_method":{"type":"card","card_brand":"visa","funding":"debit","card_country_code":"US","card_bin":"424242","card_last_four":"4242","card_expiry":"12/35","cardholder_name":"Example Customer","checks":{"three_ds":{"eci":"05","state":"verified","version":2},"cvv_verification":"not_processed","address":"n_a","postcode":"n_a","cardholder":"n_a"},"fingerprint":"aadDmPDArelhtk5QK3zqccaPi39zEDp6/uKuUsA9LHE=","network_transaction_id":"1234567890123456","authorisation_code":"100000","arn":"12345678912345678912345","capture_deadline":"2025-11-28T15:34:50.513Z"}}],"checkout_url":"https://checkout.revolut.com/payment-link/0823794d-28e9-4fdd-a130-3293ff9dd57b","enforce_challenge":"automatic"}},"increment_authorised":{"summary":"Increment authorised successfully","value":{"id":"6920869a-8d8d-aefd-a3c3-8fe4690e4323","token":"0823794d-28e9-4fdd-a130-3293ff9dd57b","type":"payment","state":"authorised","created_at":"2025-11-21T15:34:50.351537Z","updated_at":"2025-11-21T15:35:15.789012Z","amount":600,"currency":"EUR","outstanding_amount":600,"capture_mode":"manual","authorisation_type":"pre_authorisation","incremental_authorisations":[{"new_amount":600,"old_amount":500,"state":"authorised","reference":"1263738"}],"payments":[{"id":"696a4ce4-2aaf-a008-9f26-f47cf8ab1678","state":"authorised","created_at":"2025-11-21T15:34:50.474085Z","updated_at":"2025-11-21T15:35:15.789012Z","token":"928f25b1-121c-4669-ab9f-d0b7a5804576","amount":600,"authorised_amount":600,"currency":"EUR","settled_amount":600,"settled_currency":"EUR","billing_address":{"country_code":"US","postcode":"94102"},"risk_level":"low","fees":[],"payer":{"email":"example.payer@example.com","phone":"+447911123456"},"payment_method":{"type":"card","card_brand":"visa","funding":"debit","card_country_code":"US","card_bin":"424242","card_last_four":"4242","card_expiry":"12/35","cardholder_name":"Example Customer","checks":{"three_ds":{"eci":"05","state":"verified","version":2},"cvv_verification":"not_processed","address":"n_a","postcode":"n_a","cardholder":"n_a"},"fingerprint":"aadDmPDArelhtk5QK3zqccaPi39zEDp6/uKuUsA9LHE=","network_transaction_id":"1234567890123456","authorisation_code":"100000","arn":"12345678912345678912345","capture_deadline":"2025-11-28T15:34:50.513Z"}}]}},"increment_declined":{"summary":"Increment declined","value":{"id":"6920869a-8d8d-aefd-a3c3-8fe4690e4323","token":"0823794d-28e9-4fdd-a130-3293ff9dd57b","type":"payment","state":"authorised","created_at":"2025-11-21T15:34:50.351537Z","updated_at":"2025-11-21T15:35:15.789012Z","amount":500,"currency":"EUR","outstanding_amount":500,"capture_mode":"manual","authorisation_type":"pre_authorisation","incremental_authorisations":[{"new_amount":600,"old_amount":500,"state":"declined","reference":"1263738","reason":"insufficient_funds"}],"payments":[{"id":"696a4ce4-2aaf-a008-9f26-f47cf8ab1678","state":"authorised","created_at":"2025-11-21T15:34:50.474085Z","updated_at":"2025-11-21T15:35:15.789012Z","token":"928f25b1-121c-4669-ab9f-d0b7a5804576","amount":500,"authorised_amount":500,"currency":"EUR","settled_amount":500,"settled_currency":"EUR","billing_address":{"country_code":"US","postcode":"94102"},"risk_level":"low","fees":[],"payer":{"email":"example.payer@example.com","phone":"+447911123456"},"payment_method":{"type":"card","card_brand":"visa","funding":"debit","card_country_code":"US","card_bin":"424242","card_last_four":"4242","card_expiry":"12/35","cardholder_name":"Example Customer","checks":{"three_ds":{"eci":"05","state":"verified","version":2},"cvv_verification":"not_processed","address":"n_a","postcode":"n_a","cardholder":"n_a"},"fingerprint":"aadDmPDArelhtk5QK3zqccaPi39zEDp6/uKuUsA9LHE=","network_transaction_id":"1234567890123456","authorisation_code":"100000","arn":"12345678912345678912345","capture_deadline":"2025-11-28T15:34:50.513Z"}}]}}}}},"descriptionNode":"$L199e"},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"code":{"type":"string","description":"An identifier that can be used to determine what went wrong.\n\nError codes are not globally unique, but uniqueness is guaranteed within endpoints.","descriptionNode":"$L199f"},"message":{"type":"string","description":"Some human readable text describing what went wrong.","descriptionNode":"$L19a0"},"timestamp":{"type":"integer","description":"The [UNIX timestamp](https://www.unixtimestamp.com/) of the date and time the error happened.","descriptionNode":"$L19a1"}}},"examples":{"invalid_amount":{"value":{"code":"validation","message":"New amount: 3 should be greater or equal to order amount: 500","timestamp":1768397646286}}}}},"descriptionNode":"$L19a2"},"404":{"description":"Order not found","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"code":{"type":"string","description":"An identifier that can be used to determine what went wrong.\n\nError codes are not globally unique, but uniqueness is guaranteed within endpoints.","descriptionNode":"$L19a3"},"message":{"type":"string","description":"Some human readable text describing what went wrong.","descriptionNode":"$L19a4"},"timestamp":{"type":"integer","description":"The [UNIX timestamp](https://www.unixtimestamp.com/) of the date and time the error happened.","descriptionNode":"$L19a5"}}},"examples":{"default":{"value":{"code":"not_found","message":"Order not found","timestamp":1768397646286}}}}},"descriptionNode":"$L19a6"},"422":{"description":"Unprocessable Entity","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"code":{"type":"string","description":"An identifier that can be used to determine what went wrong.\n\nError codes are not globally unique, but uniqueness is guaranteed within endpoints.","descriptionNode":"$L19a7"},"message":{"type":"string","description":"Some human readable text describing what went wrong.","descriptionNode":"$L19a8"},"timestamp":{"type":"integer","description":"The [UNIX timestamp](https://www.unixtimestamp.com/) of the date and time the error happened.","descriptionNode":"$L19a9"}}},"examples":{"invalid_state":{"summary":"Invalid state","value":{"code":"bad_state","message":"No authorised card not present payment found for order 69732536-0379-a2e2-8983-15e7184f8fc6.","timestamp":1768397646286}},"invalid_auth_type":{"summary":"Wrong authorisation type","value":{"code":"order_invalid_authorisation_type","message":"Operation cannot be performed for order 697325ca-a9a2-a922-8df5-c603664da5a5 because order authorisation type is final and expected is pre_authorisation","timestamp":1768397646286}}}}},"descriptionNode":"$L19aa"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"amount":{"type":"integer","minimum":1,"description":"The new total amount to be authorised (in minor units, e.g., cents).\n\nThis should be the **full new amount**, not the increment value.\nFor example, if the current authorised amount is `500` and you want to add 100, pass `600`.\n\n:::warning\n- Must be greater than or equal to the current authorised amount (incrementing with same amount allowed to extend capture deadline for Mastercard)\n- The sum of all increment amounts cannot exceed 5x the initial authorised amount (e.g., initial amount £100 allows up to £500 in total increments)\n:::","examples":[600],"descriptionNode":"$L19ab"},"reference":{"type":"string","maxLength":255,"description":"External reference for this incremental authorisation.\n\n:::tip\nUse your internal charge or invoice ID. This reference is returned in webhooks for easy matching to your system.\n:::","examples":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:incremental_authorisations:items:properties:reference:examples","descriptionNode":"$L19ac"},"line_items":{"type":"array","maxItems":250,"description":"An array of line items included in the order. Each line item represents an individual product or service, along with its quantity, price, taxes, and discounts.\n\n:::info\nRequired for merchants collecting payment for one or multiple products/services in one transaction. Omitting this information may trigger additional scrutiny and risk mitigation actions by Revolut.\n:::","items":{"type":"object","properties":{"name":{"type":"string","maxLength":250,"description":"Name of the line item.","descriptionNode":"$L19ad"},"type":{"type":"string","enum":"$19:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:orders:items:properties:line_items:items:properties:type:enum","description":"Type of the line item.","descriptionNode":"$L19ae"},"quantity":{"type":"object","description":"Object representing the quantity details of a line item, including the amount and its associated unit of measurement.","properties":{"value":{"type":"number","format":"double","minimum":0,"description":"The number of units of the line item.","descriptionNode":"$L19af"},"unit":{"type":"string","maxLength":100,"description":"The measurement unit for the quantity, such as `cm`, or `kg`.","descriptionNode":"$L19b0"}},"required":"$19:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:orders:items:properties:line_items:items:properties:quantity:required","descriptionNode":"$L19b1"},"unit_price_amount":{"type":"integer","format":"int64","minimum":0,"description":"The unit price of the line item.","descriptionNode":"$L19b2"},"total_amount":{"type":"integer","format":"int64","description":"The total amount to be paid for the line item, including taxes and discounts.","descriptionNode":"$L19b3"},"external_id":{"type":"string","maxLength":250,"description":"Unique identifier of line item in the merchant's system.","descriptionNode":"$L19b4"},"discounts":{"type":"array","maxItems":50,"description":"A list of discounts applied to the line item. Each discount should be subtracted from the total amount payable for the item.","items":{"type":"object","description":"Details of a discount applied to the line item, including its name and monetary value.","properties":{"name":{"type":"string","maxLength":100,"description":"The specific name or label of the discount applied to the line item.","descriptionNode":"$L19b5"},"amount":{"type":"integer","format":"int64","minimum":0,"description":"The monetary value of the discount. ","descriptionNode":"$L19b6"}},"required":"$19:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:orders:items:properties:line_items:items:properties:discounts:items:required","descriptionNode":"$L19b7"},"descriptionNode":"$L19b8"},"taxes":{"type":"array","maxItems":50,"description":"A list of taxes applied to the line item. Each tax should be added to the total amount payable for the item.","items":{"type":"object","description":"Details about a tax applied to the line item, including its name and the corresponding amount.","properties":{"name":{"type":"string","description":"The specific name or designation of the tax applied to the line item.","maxLength":100,"descriptionNode":"$L19b9"},"amount":{"type":"integer","format":"int64","description":"The monetary value of the tax in minor currency units (e.g., cents for EUR).","minimum":0,"descriptionNode":"$L19ba"}},"required":"$19:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:orders:items:properties:line_items:items:properties:taxes:items:required","descriptionNode":"$L19bb"},"descriptionNode":"$L19bc"},"image_urls":{"type":"array","maxItems":50,"description":"A list of URLs pointing to images related to the line item. These images can provide visual details or representations of the item.","items":{"type":"string","format":"uri","pattern":"^https?:\\/{2}.+/gi","maxLength":2000,"description":"URL to an image associated with the line item.\n\n:::warning\nRestrictions:\n- Must be a valid URI as defined by [RFC 3986](https://datatracker.ietf.org/doc/html/rfc3986)\n- URI scheme is required and must be either `http` or `https`\n- URI host is required and cannot be `localhost` or an IP address\n- Max length: `2000`\n- Reserved or invalid characters must be percent-encoded (for example, use `%20` instead of a space)\n:::","descriptionNode":"$L19bd"},"descriptionNode":"$L19be"},"description":{"type":"string","maxLength":1024,"description":"Description of the line item.","descriptionNode":"$L19bf"},"url":{"type":"string","format":"uri","pattern":"^https?:\\/{2}.+/gi","maxLength":2000,"description":"An HTTP/HTTPS URL that links to more information about the line item, such as a product page or details.\n\n:::warning\nRestrictions:\n- Must be a valid URI as defined by [RFC 3986](https://datatracker.ietf.org/doc/html/rfc3986)\n- URI scheme is required and must be either `http` or `https`\n- URI host is required and cannot be `localhost` or an IP address\n- Max length: `2000`\n- Reserved or invalid characters must be percent-encoded (for example, use `%20` instead of a space)\n:::","descriptionNode":"$L19c0"}},"required":"$19:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:orders:items:properties:line_items:items:required"},"descriptionNode":"$L19c1"}},"required":["amount"]},"examples":{"basic_increment":{"summary":"Example increment with minimal required parameters","value":{"amount":600}},"increment_with_additional":{"summary":"Example increment with additional parameters","value":{"amount":6000,"reference":"CHG-67890","line_items":[{"name":"Minibar","type":"physical","quantity":{"value":1},"unit_price_amount":2500,"total_amount":2500},{"name":"Room service","type":"physical","quantity":{"value":1},"unit_price_amount":3500,"total_amount":3500}]}}}}}},"variantLabels":["Increment in progress","Increment authorised successfully","Increment declined"],"children":["$L19c2","$L19c3"]}]}],false]}] 1851:["$","$L10d",null,{"security":[{"Api-Key":[]}],"authorization":{"Api-Key":{"type":"apiKey","in":"header","name":"Authorization","description":"Each Merchant API request must contain an authorization header in the following format:\n\n```\n'Authorization: Bearer '\n```\n\nTo use this API, you need to generate API keys from your Revolut Business account. The Secret key is used in the authorization header for all server calls, while the Public key is provided with payment methods at checkout.\n\n:::info\nFor detailed instructions on generating your API keys, see: [Generate API keys](https://developer.revolut.com/docs/guides/merchant/get-started#generate-api-keys).\n:::","descriptionNode":"$L19c4"}}}] 1852:["$","$L10f",null,{"exampleBlocks":{"application/json":{"variants":[{"key":"example_minimal","label":"Capture with amount only","rawValue":"$1d:props:children:0:props:children:props:requestBody:content:application/json:examples:example_minimal:value","block":"$L19c5"},{"key":"example_with_line_items","label":"Capture with amount and line items","rawValue":"$1d:props:children:0:props:children:props:requestBody:content:application/json:examples:example_with_line_items:value","block":"$L19c6"}],"syncedPropertyName":"$undefined"}},"title":"Request body samples","headingAs":"h4"}] 1853:["$","$L110",null,{"exampleBlocks":{"200":{"application/json":{"variants":[{"key":"captured_order_minimal","label":"Captured order (minimal)","rawValue":"$1d:props:children:0:props:children:props:responses:200:content:application/json:examples:captured_order_minimal:value","block":"$L19c7"},{"key":"captured_order_line_items","label":"Captured order with line items","rawValue":"$1d:props:children:0:props:children:props:responses:200:content:application/json:examples:captured_order_line_items:value","block":"$L19c8"}],"syncedPropertyName":"$undefined"}},"400":{"application/json":{"variants":[{"key":"example-1","label":"example-1","rawValue":"$1d:props:children:0:props:children:props:responses:400:content:application/json:examples:example-1:value","block":"$L19c9"}],"syncedPropertyName":"$undefined"}},"401":{"application/json":{"variants":[{"key":"default","label":"default","rawValue":"$1d:props:children:0:props:children:props:responses:401:content:application/json:examples:default:value","block":"$L19ca"}],"syncedPropertyName":"$undefined"}},"404":{"application/json":{"variants":[{"key":"default","label":"default","rawValue":"$1d:props:children:0:props:children:props:responses:404:content:application/json:examples:default:value","block":"$L19cb"}],"syncedPropertyName":"$undefined"}}},"headingAs":"h4"}] 19c2:["$","div",null,{"className":"ezz1n30","children":[["$","div",null,{"data-header":"$undefined","className":"ezz1n31","children":["$","div",null,{"className":"y9a0do1","children":[["$","h2",null,{"id":"increment-order-authorisation","children":[["$L19cc","$undefined"],["$","$L15",null,{"id":"increment-order-authorisation"}]]}],["$","$L16",null,{"url":"/docs/api/merchant/2025-10-16/operations/increment-order-authorisation.md"}]]}]}],"$undefined"]}] 19d2:T648,
curl -X POST "https://merchant.revolut.com/api/orders/__RP_TOK_0__/increment-authorisation" \
  -H "Content-Type: application/json" \
  -H "Authorization: __RP_TOK_1__" \
  -H "Revolut-Api-Version: __RP_TOK_2__" \
  -d '{
  "amount": 600
}'
19d3:Te91,
const payload = {
  "amount": 600
};
fetch("https://merchant.revolut.com/api/orders/__RP_TOK_0__/increment-authorisation", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "__RP_TOK_1__",
    "Revolut-Api-Version": "__RP_TOK_2__"
  },
  body: JSON.stringify(payload)
})
  .then(response => response.json())
  .then(data => console.log(data));
19d4:T162d,
package main

import (
  "fmt"
  "net/http"
  "bytes"
  "encoding/json"
)

func main() {
  url := "https://merchant.revolut.com/api/orders/__RP_TOK_0__/increment-authorisation"
  jsonData := []byte(`
{
  "amount": 600
}
  `)
  req, _ := http.NewRequest("POST", url, bytes.NewBuffer(jsonData))
  req.Header.Add("Content-Type", "application/json")
  req.Header.Add("Authorization", "__RP_TOK_1__")
  req.Header.Add("Revolut-Api-Version", "__RP_TOK_2__")

  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  fmt.Println(res)
}
19d5:Tbc5,
import requests

url = "https://merchant.revolut.com/api/orders/__RP_TOK_0__/increment-authorisation"
headers = {
  "Content-Type": "application/json",
  "Authorization": "__RP_TOK_1__",
  "Revolut-Api-Version": "__RP_TOK_2__"
}
payload = {
  "amount": 600
}

response = requests.post(url, headers=headers, json=payload)
print(response.json())
19d6:T1b91,
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;

public class Main {
  public static void main(String[] args) {
    HttpClient client = HttpClient.newHttpClient();
    String body = """
{
  "amount": 600
}
    """;

    HttpRequest request = HttpRequest.newBuilder()
      .uri(URI.create("https://merchant.revolut.com/api/orders/__RP_TOK_0__/increment-authorisation"))
      .header("Content-Type", "application/json")
      .header("Authorization", "__RP_TOK_1__")
      .header("Revolut-Api-Version", "__RP_TOK_2__")
      .POST(HttpRequest.BodyPublishers.ofString(body))
      .build();

    client.sendAsync(request, HttpResponse.BodyHandlers.ofString())
      .thenApply(HttpResponse::body)
      .thenAccept(System.out::println)
      .join();
  }
}
19d7:T1ccf,
using System.Net.Http;
using System.Net.Http.Headers;

var client = new HttpClient();
var request = new HttpRequestMessage
{
  Method = HttpMethod.Post,
  RequestUri = new Uri("https://merchant.revolut.com/api/orders/__RP_TOK_0__/increment-authorisation"),
  Headers =
  {
    { "Authorization", "__RP_TOK_1__" },
    { "Revolut-Api-Version", "__RP_TOK_2__" },
  },
  Content = new StringContent(@"{
  ""amount"": 600
}")
  {
    Headers =
    {
      ContentType = new MediaTypeHeaderValue("application/json")
    }
  }
};

using (var response = await client.SendAsync(request))
{
  response.EnsureSuccessStatusCode();
  var body = await response.Content.ReadAsStringAsync();
  Console.WriteLine(body);
}
19d8:T650,
curl -X POST "https://sandbox-merchant.revolut.com/api/orders/__RP_TOK_0__/increment-authorisation" \
  -H "Content-Type: application/json" \
  -H "Authorization: __RP_TOK_1__" \
  -H "Revolut-Api-Version: __RP_TOK_2__" \
  -d '{
  "amount": 600
}'
19d9:Te99,
const payload = {
  "amount": 600
};
fetch("https://sandbox-merchant.revolut.com/api/orders/__RP_TOK_0__/increment-authorisation", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "__RP_TOK_1__",
    "Revolut-Api-Version": "__RP_TOK_2__"
  },
  body: JSON.stringify(payload)
})
  .then(response => response.json())
  .then(data => console.log(data));
19da:T1635,
package main

import (
  "fmt"
  "net/http"
  "bytes"
  "encoding/json"
)

func main() {
  url := "https://sandbox-merchant.revolut.com/api/orders/__RP_TOK_0__/increment-authorisation"
  jsonData := []byte(`
{
  "amount": 600
}
  `)
  req, _ := http.NewRequest("POST", url, bytes.NewBuffer(jsonData))
  req.Header.Add("Content-Type", "application/json")
  req.Header.Add("Authorization", "__RP_TOK_1__")
  req.Header.Add("Revolut-Api-Version", "__RP_TOK_2__")

  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  fmt.Println(res)
}
19db:Tbcd,
import requests

url = "https://sandbox-merchant.revolut.com/api/orders/__RP_TOK_0__/increment-authorisation"
headers = {
  "Content-Type": "application/json",
  "Authorization": "__RP_TOK_1__",
  "Revolut-Api-Version": "__RP_TOK_2__"
}
payload = {
  "amount": 600
}

response = requests.post(url, headers=headers, json=payload)
print(response.json())
19dc:T1b99,
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;

public class Main {
  public static void main(String[] args) {
    HttpClient client = HttpClient.newHttpClient();
    String body = """
{
  "amount": 600
}
    """;

    HttpRequest request = HttpRequest.newBuilder()
      .uri(URI.create("https://sandbox-merchant.revolut.com/api/orders/__RP_TOK_0__/increment-authorisation"))
      .header("Content-Type", "application/json")
      .header("Authorization", "__RP_TOK_1__")
      .header("Revolut-Api-Version", "__RP_TOK_2__")
      .POST(HttpRequest.BodyPublishers.ofString(body))
      .build();

    client.sendAsync(request, HttpResponse.BodyHandlers.ofString())
      .thenApply(HttpResponse::body)
      .thenAccept(System.out::println)
      .join();
  }
}
19dd:T1cd7,
using System.Net.Http;
using System.Net.Http.Headers;

var client = new HttpClient();
var request = new HttpRequestMessage
{
  Method = HttpMethod.Post,
  RequestUri = new Uri("https://sandbox-merchant.revolut.com/api/orders/__RP_TOK_0__/increment-authorisation"),
  Headers =
  {
    { "Authorization", "__RP_TOK_1__" },
    { "Revolut-Api-Version", "__RP_TOK_2__" },
  },
  Content = new StringContent(@"{
  ""amount"": 600
}")
  {
    Headers =
    {
      ContentType = new MediaTypeHeaderValue("application/json")
    }
  }
};

using (var response = await client.SendAsync(request))
{
  response.EnsureSuccessStatusCode();
  var body = await response.Content.ReadAsStringAsync();
  Console.WriteLine(body);
}
19c3:["$","div",null,{"className":"ezz1n30","children":[["$","div",null,{"data-header":"$undefined","className":"ezz1n31","children":["$L19cd",["$","$L85",null,{"parameters":[{"name":"Authorization","in":"header","schema":{"type":"string","format":"Bearer ","examples":"$62:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:0:schema:examples"},"required":true,"description":"This parameter accepts the [Merchant API Secret key](https://business.revolut.com/settings/apis?tab=merchant-api) to authorise requests coming from the merchant's backend. \n\nIt ensures that ensures that each request is authenticated and authorised by verifying the secret key. The secret key should be included in all request headers as a `Bearer` token.\n\n:::info\nFor more information, see: [Authentication](https://developer.revolut.com/docs/api/merchant#authentication)\n:::","descriptionNode":"$L19ce"},{"name":"Revolut-Api-Version","in":"header","schema":{"type":"string","format":"date","enum":"$36:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:1:schema:enum","examples":"$36:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:1:schema:examples"},"required":true,"description":"The version of the Merchant API, specified in `YYYY-MM-DD` format.\n\nIf not specified, you will receive an error.\n\n\n:::info\nFor more information about API versioning, see: [API versions](https://developer.revolut.com/docs/guides/merchant/reference/versioning/api-versions).\n:::","x-config-always-visible-in-example":true,"example":"2025-10-16","descriptionNode":"$L19cf"},{"name":"order_id","in":"path","schema":{"type":"string","format":"uuid","description":"A UUID string, typically used to identify resources.","descriptionNode":"$L19d0"},"required":true,"description":"The ID of the `Order` object.","descriptionNode":"$L19d1"}],"requestBody":"$1c:props:children:0:props:children:props:requestBody","heading":"Request","requestBodySchemaTitle":"Request body","headingAs":"h3"}],["$","$L89",null,{"responses":"$1c:props:children:0:props:children:props:responses","headingAs":"h3"}]]}],["$","div",null,{"className":"ezz1n32","children":[[["$","$L8a",null,{"itemsByServer":{"https://merchant.revolut.com":[{"id":"curl","label":"cURL","templateCode":"curl -X POST \"https://merchant.revolut.com/api/orders/__RP_TOK_0__/increment-authorisation\" \\\n -H \"Content-Type: application/json\" \\\n -H \"Authorization: __RP_TOK_1__\" \\\n -H \"Revolut-Api-Version: __RP_TOK_2__\" \\\n -d '{\n \"amount\": 600\n}'","templateHtml":"$19d2","tokens":[{"marker":"__RP_TOK_0__","paramName":"order_id","paramIn":"path","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["shell-double-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:order_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"javascript","label":"JavaScript","templateCode":"const payload = {\n \"amount\": 600\n};\nfetch(\"https://merchant.revolut.com/api/orders/__RP_TOK_0__/increment-authorisation\", {\n method: \"POST\",\n headers: {\n \"Content-Type\": \"application/json\",\n \"Authorization\": \"__RP_TOK_1__\",\n \"Revolut-Api-Version\": \"__RP_TOK_2__\"\n },\n body: JSON.stringify(payload)\n})\n .then(response => response.json())\n .then(data => console.log(data));","templateHtml":"$19d3","tokens":[{"marker":"__RP_TOK_0__","paramName":"order_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:order_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"go","label":"Go","templateCode":"package main\n\nimport (\n \"fmt\"\n \"net/http\"\n \"bytes\"\n \"encoding/json\"\n)\n\nfunc main() {\n url := \"https://merchant.revolut.com/api/orders/__RP_TOK_0__/increment-authorisation\"\n jsonData := []byte(`\n{\n \"amount\": 600\n}\n `)\n req, _ := http.NewRequest(\"POST\", url, bytes.NewBuffer(jsonData))\n req.Header.Add(\"Content-Type\", \"application/json\")\n req.Header.Add(\"Authorization\", \"__RP_TOK_1__\")\n req.Header.Add(\"Revolut-Api-Version\", \"__RP_TOK_2__\")\n\n res, _ := http.DefaultClient.Do(req)\n defer res.Body.Close()\n fmt.Println(res)\n}","templateHtml":"$19d4","tokens":[{"marker":"__RP_TOK_0__","paramName":"order_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:order_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"python","label":"Python","templateCode":"import requests\n\nurl = \"https://merchant.revolut.com/api/orders/__RP_TOK_0__/increment-authorisation\"\nheaders = {\n \"Content-Type\": \"application/json\",\n \"Authorization\": \"__RP_TOK_1__\",\n \"Revolut-Api-Version\": \"__RP_TOK_2__\"\n}\npayload = {\n \"amount\": 600\n}\n\nresponse = requests.post(url, headers=headers, json=payload)\nprint(response.json())","templateHtml":"$19d5","tokens":[{"marker":"__RP_TOK_0__","paramName":"order_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:order_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"java","label":"Java","templateCode":"import java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\nimport java.net.URI;\n\npublic class Main {\n public static void main(String[] args) {\n HttpClient client = HttpClient.newHttpClient();\n String body = \"\"\"\n{\n \"amount\": 600\n}\n \"\"\";\n\n HttpRequest request = HttpRequest.newBuilder()\n .uri(URI.create(\"https://merchant.revolut.com/api/orders/__RP_TOK_0__/increment-authorisation\"))\n .header(\"Content-Type\", \"application/json\")\n .header(\"Authorization\", \"__RP_TOK_1__\")\n .header(\"Revolut-Api-Version\", \"__RP_TOK_2__\")\n .POST(HttpRequest.BodyPublishers.ofString(body))\n .build();\n\n client.sendAsync(request, HttpResponse.BodyHandlers.ofString())\n .thenApply(HttpResponse::body)\n .thenAccept(System.out::println)\n .join();\n }\n}","templateHtml":"$19d6","tokens":[{"marker":"__RP_TOK_0__","paramName":"order_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:order_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"csharp","label":"C#","templateCode":"using System.Net.Http;\nusing System.Net.Http.Headers;\n\nvar client = new HttpClient();\nvar request = new HttpRequestMessage\n{\n Method = HttpMethod.Post,\n RequestUri = new Uri(\"https://merchant.revolut.com/api/orders/__RP_TOK_0__/increment-authorisation\"),\n Headers =\n {\n { \"Authorization\", \"__RP_TOK_1__\" },\n { \"Revolut-Api-Version\", \"__RP_TOK_2__\" },\n },\n Content = new StringContent(@\"{\n \"\"amount\"\": 600\n}\")\n {\n Headers =\n {\n ContentType = new MediaTypeHeaderValue(\"application/json\")\n }\n }\n};\n\nusing (var response = await client.SendAsync(request))\n{\n response.EnsureSuccessStatusCode();\n var body = await response.Content.ReadAsStringAsync();\n Console.WriteLine(body);\n}","templateHtml":"$19d7","tokens":[{"marker":"__RP_TOK_0__","paramName":"order_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:order_id":"123e4567-e89b-12d3-a456-426614174000"}}],"https://sandbox-merchant.revolut.com":[{"id":"curl","label":"cURL","templateCode":"curl -X POST \"https://sandbox-merchant.revolut.com/api/orders/__RP_TOK_0__/increment-authorisation\" \\\n -H \"Content-Type: application/json\" \\\n -H \"Authorization: __RP_TOK_1__\" \\\n -H \"Revolut-Api-Version: __RP_TOK_2__\" \\\n -d '{\n \"amount\": 600\n}'","templateHtml":"$19d8","tokens":[{"marker":"__RP_TOK_0__","paramName":"order_id","paramIn":"path","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["shell-double-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:order_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"javascript","label":"JavaScript","templateCode":"const payload = {\n \"amount\": 600\n};\nfetch(\"https://sandbox-merchant.revolut.com/api/orders/__RP_TOK_0__/increment-authorisation\", {\n method: \"POST\",\n headers: {\n \"Content-Type\": \"application/json\",\n \"Authorization\": \"__RP_TOK_1__\",\n \"Revolut-Api-Version\": \"__RP_TOK_2__\"\n },\n body: JSON.stringify(payload)\n})\n .then(response => response.json())\n .then(data => console.log(data));","templateHtml":"$19d9","tokens":[{"marker":"__RP_TOK_0__","paramName":"order_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:order_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"go","label":"Go","templateCode":"package main\n\nimport (\n \"fmt\"\n \"net/http\"\n \"bytes\"\n \"encoding/json\"\n)\n\nfunc main() {\n url := \"https://sandbox-merchant.revolut.com/api/orders/__RP_TOK_0__/increment-authorisation\"\n jsonData := []byte(`\n{\n \"amount\": 600\n}\n `)\n req, _ := http.NewRequest(\"POST\", url, bytes.NewBuffer(jsonData))\n req.Header.Add(\"Content-Type\", \"application/json\")\n req.Header.Add(\"Authorization\", \"__RP_TOK_1__\")\n req.Header.Add(\"Revolut-Api-Version\", \"__RP_TOK_2__\")\n\n res, _ := http.DefaultClient.Do(req)\n defer res.Body.Close()\n fmt.Println(res)\n}","templateHtml":"$19da","tokens":[{"marker":"__RP_TOK_0__","paramName":"order_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:order_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"python","label":"Python","templateCode":"import requests\n\nurl = \"https://sandbox-merchant.revolut.com/api/orders/__RP_TOK_0__/increment-authorisation\"\nheaders = {\n \"Content-Type\": \"application/json\",\n \"Authorization\": \"__RP_TOK_1__\",\n \"Revolut-Api-Version\": \"__RP_TOK_2__\"\n}\npayload = {\n \"amount\": 600\n}\n\nresponse = requests.post(url, headers=headers, json=payload)\nprint(response.json())","templateHtml":"$19db","tokens":[{"marker":"__RP_TOK_0__","paramName":"order_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:order_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"java","label":"Java","templateCode":"import java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\nimport java.net.URI;\n\npublic class Main {\n public static void main(String[] args) {\n HttpClient client = HttpClient.newHttpClient();\n String body = \"\"\"\n{\n \"amount\": 600\n}\n \"\"\";\n\n HttpRequest request = HttpRequest.newBuilder()\n .uri(URI.create(\"https://sandbox-merchant.revolut.com/api/orders/__RP_TOK_0__/increment-authorisation\"))\n .header(\"Content-Type\", \"application/json\")\n .header(\"Authorization\", \"__RP_TOK_1__\")\n .header(\"Revolut-Api-Version\", \"__RP_TOK_2__\")\n .POST(HttpRequest.BodyPublishers.ofString(body))\n .build();\n\n client.sendAsync(request, HttpResponse.BodyHandlers.ofString())\n .thenApply(HttpResponse::body)\n .thenAccept(System.out::println)\n .join();\n }\n}","templateHtml":"$19dc","tokens":[{"marker":"__RP_TOK_0__","paramName":"order_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:order_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"csharp","label":"C#","templateCode":"using System.Net.Http;\nusing System.Net.Http.Headers;\n\nvar client = new HttpClient();\nvar request = new HttpRequestMessage\n{\n Method = HttpMethod.Post,\n RequestUri = new Uri(\"https://sandbox-merchant.revolut.com/api/orders/__RP_TOK_0__/increment-authorisation\"),\n Headers =\n {\n { \"Authorization\", \"__RP_TOK_1__\" },\n { \"Revolut-Api-Version\", \"__RP_TOK_2__\" },\n },\n Content = new StringContent(@\"{\n \"\"amount\"\": 600\n}\")\n {\n Headers =\n {\n ContentType = new MediaTypeHeaderValue(\"application/json\")\n }\n }\n};\n\nusing (var response = await client.SendAsync(request))\n{\n response.EnsureSuccessStatusCode();\n var body = await response.Content.ReadAsStringAsync();\n Console.WriteLine(body);\n}","templateHtml":"$19dd","tokens":[{"marker":"__RP_TOK_0__","paramName":"order_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:order_id":"123e4567-e89b-12d3-a456-426614174000"}}]},"method":"post","servers":"$62:props:children:0:props:children:props:children:1:props:children:1:props:children:0:0:props:servers","path":"/api/orders/{order_id}/increment-authorisation","parameters":["$19c3:props:children:0:props:children:1:props:parameters:0","$19c3:props:children:0:props:children:1:props:parameters:1","$19c3:props:children:0:props:children:1:props:parameters:2"]}],"$L19de"],"$L19df","$L19e0"]}]]}] 19de:["$","$L10d",null,{"security":[{"Api-Key":[]}],"authorization":{"Api-Key":{"type":"apiKey","in":"header","name":"Authorization","description":"Each Merchant API request must contain an authorization header in the following format:\n\n```\n'Authorization: Bearer '\n```\n\nTo use this API, you need to generate API keys from your Revolut Business account. The Secret key is used in the authorization header for all server calls, while the Public key is provided with payment methods at checkout.\n\n:::info\nFor detailed instructions on generating your API keys, see: [Generate API keys](https://developer.revolut.com/docs/guides/merchant/get-started#generate-api-keys).\n:::","descriptionNode":"$L19e1"}}}] 19df:["$","$L10f",null,{"exampleBlocks":{"application/json":{"variants":[{"key":"basic_increment","label":"Example increment with minimal required parameters","rawValue":"$1c:props:children:0:props:children:props:requestBody:content:application/json:examples:basic_increment:value","block":"$L19e2"},{"key":"increment_with_additional","label":"Example increment with additional parameters","rawValue":"$1c:props:children:0:props:children:props:requestBody:content:application/json:examples:increment_with_additional:value","block":"$L19e3"}],"syncedPropertyName":"$undefined"}},"title":"Request body samples","headingAs":"h4"}] 19e0:["$","$L110",null,{"exampleBlocks":{"200":{"application/json":{"variants":[{"key":"increment_in_progress","label":"Increment in progress","rawValue":"$1c:props:children:0:props:children:props:responses:200:content:application/json:examples:increment_in_progress:value","block":"$L19e4"},{"key":"increment_authorised","label":"Increment authorised successfully","rawValue":"$1c:props:children:0:props:children:props:responses:200:content:application/json:examples:increment_authorised:value","block":"$L19e5"},{"key":"increment_declined","label":"Increment declined","rawValue":"$1c:props:children:0:props:children:props:responses:200:content:application/json:examples:increment_declined:value","block":"$L19e6"}],"syncedPropertyName":"$undefined"}},"400":{"application/json":{"variants":[{"key":"invalid_amount","label":"invalid_amount","rawValue":"$1c:props:children:0:props:children:props:responses:400:content:application/json:examples:invalid_amount:value","block":"$L19e7"}],"syncedPropertyName":"$undefined"}},"404":{"application/json":{"variants":[{"key":"default","label":"default","rawValue":"$1c:props:children:0:props:children:props:responses:404:content:application/json:examples:default:value","block":"$L19e8"}],"syncedPropertyName":"$undefined"}},"422":{"application/json":{"variants":[{"key":"invalid_state","label":"Invalid state","rawValue":"$1c:props:children:0:props:children:props:responses:422:content:application/json:examples:invalid_state:value","block":"$L19e9"},{"key":"invalid_auth_type","label":"Wrong authorisation type","rawValue":"$1c:props:children:0:props:children:props:responses:422:content:application/json:examples:invalid_auth_type:value","block":"$L19ea"}],"syncedPropertyName":"$undefined"}}},"headingAs":"h4"}] 183f:"Capture an order" 16cf:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Permanent order ID used to retrieve, capture, cancel, or refund an order after authorization."}]]}] 16d0:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Temporary ID for the order, which expires when the payment is authorised."}],"\n",["$","p","p-1",{"children":["The order ",["$","code","code-0",{"children":"token"}]," is used for ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/sdks/merchant-web-sdk/initialisation/token-based","target":"_blank","rel":"noreferrer","children":"token-based initialisation"}],", and is returned by the ",["$","code","code-1",{"children":"createOrder"}]," callback in the following payment methods:"]}],"\n",["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["$","a","a-0",{"href":"https://developer.revolut.com/docs/sdks/merchant-web-sdk/payment-methods/embedded-checkout#embedded-checkout-options-interface","target":"_blank","rel":"noreferrer","children":"Embedded Checkout"}]}],"\n",["$","li","li-1",{"children":["$","a","a-0",{"href":"https://developer.revolut.com/docs/sdks/merchant-web-sdk/payment-methods/revolut-pay#widget-payments-revolut-pay-options","target":"_blank","rel":"noreferrer","children":"Revolut Pay"}]}],"\n",["$","li","li-2",{"children":["$","a","a-0",{"href":"https://developer.revolut.com/docs/sdks/merchant-web-sdk/payment-methods/apple-pay-google-pay#payment-request-options-interface","target":"_blank","rel":"noreferrer","children":"Apple Pay and Google Pay"}]}],"\n",["$","li","li-3",{"children":["$","a","a-0",{"href":"https://developer.revolut.com/docs/sdks/merchant-web-sdk/payment-methods/pay-by-bank#pay-by-bank-options-interface","target":"_blank","rel":"noreferrer","children":"Pay by Bank"}]}],"\n"]}]]}] 16d1:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of the order."}]]}] 16d2:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The state of the order in its lifecycle."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"State","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"pending"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Order created, awaiting payment","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"processing"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Payment is being processed","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"authorised"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Payment authorised but not yet captured (for manual capture)","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"completed"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Payment successfully captured and settled","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-4",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"cancelled"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Order was cancelled","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-5",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"failed"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Payment failed","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/reference/order-lifecycle","target":"_blank","rel":"noreferrer","children":"Order and payment lifecycle"}]]}]}]]}]]}] 16d3:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The date and time the order was created."}]]}] 16d4:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The date and time the order was last updated."}]]}] 16d5:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The description of the order."}]]}] 16d6:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The capture mode of the order. ",["$","code","code-0",{"children":"automatic"}]," is used by default."]}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Parameter value","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"automatic"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The order is captured automatically after payment authorisation.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"manual"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The order is not captured automatically. You must manually capture the order later.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information, see ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#capture-order","target":"_blank","rel":"noreferrer","children":"Capture an order"}],"."]}]}]]}]]}] 19cc:"Increment authorisation" 16d7:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The type of authorisation for the order. Used with manual capture mode. If omitted, ",["$","code","code-0",{"children":"final"}]," is used by default."]}],"\n",["$","h1","h1-0",{"children":"Pre-authorisation"}],"\n",["$","p","p-1",{"children":"Pre-authorisation allows you to reserve funds on a customer's card without immediately capturing them. This is useful for scenarios like:"}],"\n",["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":"Hotel bookings where the final amount may vary"}],"\n",["$","li","li-1",{"children":"Car rentals where additional charges may apply"}],"\n",["$","li","li-2",{"children":"Deposits that need to be held temporarily"}],"\n"]}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Parameter value","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"final"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Standard authorisation for immediate or near-immediate capture.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"pre_authorisation"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Reserve funds for later capture, used with manual capture mode.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["Pre-authorisation must be used with ",["$","code","code-0",{"children":"capture_mode: manual"}],". For more information, see ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#capture-order","target":"_blank","rel":"noreferrer","children":"Capture an order"}],"."]}]}]]}]]}] 16d9:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["Automatic cancellation period for uncaptured orders, specified in ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_8601","target":"_blank","rel":"noreferrer","children":"ISO 8601"}]," format."]}],"\n",["$","p","p-1",{"children":["After this period, the authorised payment is automatically cancelled and the order is cancelled. Maximum: 7 days = ",["$","code","code-0",{"children":"P7D"}],"."]}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"The following limitations apply:"}],["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["\n",["$","p","p-0",{"children":"Cannot be a negative value."}],"\n"]}],"\n",["$","li","li-1",{"children":["\n",["$","p","p-0",{"children":"Cannot be updated if the new value is less than or equal to the elapsed time since authorisation."}],"\n",["$","p","p-1",{"children":["$","strong","strong-0",{"children":"Failing scenario:"}]}],"\n",["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":"Original value: 7 days"}],"\n",["$","li","li-1",{"children":"Time since authorisation: 3 days"}],"\n",["$","li","li-2",{"children":"Update value: 2 days"}],"\n"]}],"\n",["$","p","p-2",{"children":"In this scenario, an error is returned."}],"\n",["$","p","p-3",{"children":["$","strong","strong-0",{"children":"Successful scenario:"}]}],"\n",["$","ul","ul-1",{"children":["\n",["$","li","li-0",{"children":"Original value: 7 days"}],"\n",["$","li","li-1",{"children":"Time since authorisation: 3 days"}],"\n",["$","li","li-2",{"children":"Update value: 4 days"}],"\n"]}],"\n",["$","p","p-4",{"children":"In this scenario, the parameter can be updated."}],"\n"]}],"\n",["$","li","li-2",{"children":["\n",["$","p","p-0",{"children":"Cannot be updated if cancellation is ≤ 30 minutes away."}],"\n",["$","p","p-1",{"children":["$","strong","strong-0",{"children":"Failing scenario:"}]}],"\n",["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":"Original value: 12 hours"}],"\n",["$","li","li-1",{"children":"Time since authorisation: 11 hours 40 minutes"}],"\n"]}],"\n",["$","p","p-2",{"children":"In this scenario, an error is returned."}],"\n",["$","p","p-3",{"children":["$","strong","strong-0",{"children":"Successful scenario:"}]}],"\n",["$","ul","ul-1",{"children":["\n",["$","li","li-0",{"children":"Original value: 12 hours"}],"\n",["$","li","li-1",{"children":"Time since authorisation: 11 hours 20 minutes"}],"\n"]}],"\n",["$","p","p-4",{"children":"In this scenario, the parameter can be updated."}],"\n"]}],"\n"]}]]}]]}]]}] 16da:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The order total expressed in minor currency units, according to the ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_4217","target":"_blank","rel":"noreferrer","children":"ISO 4217 standard"}],". For example, ",["$","code","code-0",{"children":"7034"}]," in ",["$","code","code-1",{"children":"EUR"}]," corresponds to €70.34."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["Conversion between major and minor units varies by currency. For instance, ",["$","code","code-0",{"children":"100"}]," minor units equal £1.00 in ",["$","code","code-1",{"children":"GBP"}],", whereas in ",["$","code","code-2",{"children":"ISK"}]," they represent 100 units. For more details, see the ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_4217","target":"_blank","rel":"noreferrer","children":"ISO 4217 standard"}],"."]}],"\n",["$","li","li-1",{"children":["If ",["$","code","code-0",{"children":"line_items"}]," are provided, the order ",["$","code","code-1",{"children":"amount"}]," must equal the sum of all line items' ",["$","code","code-2",{"children":"total_amount"}],"."]}],"\n",["$","li","li-2",{"children":["For card payments with a non-zero amount, the order ",["$","code","code-0",{"children":"amount"}]," must be at least ",["$","strong","strong-0",{"children":"$$0.005"}]," (or equivalent in different currencies, calculated using Revolut's exchange rate on the payment date). Otherwise, card payments can't be performed."]}],"\n"]}]}]]}]]}] 16db:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The amount not yet paid for a given order (in minor currency units). For example, ",["$","code","code-0",{"children":"7034"}]," represents €70.34."]}],"\n",["$","p","p-1",{"children":["The value in this field may differ from ",["$","code","code-0",{"children":"amount"}]," if there are partial payments associated with the order."]}]]}] 16dc:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The amount that was refunded from the order (in minor currency units). For example, ",["$","code","code-0",{"children":"7034"}]," represents €70.34."]}],"\n",["$","p","p-1",{"children":["This applies to orders that have been refunded (i.e., orders of type ",["$","code","code-0",{"children":"payment"}]," that have a related ",["$","code","code-1",{"children":"refund"}]," order)."]}]]}] 16dd:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":[["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_4217","target":"_blank","rel":"noreferrer","children":"ISO 4217"}]," currency code in upper case."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information about the supported currencies, see: ",["$","a","a-0",{"href":"https://help.revolut.com/business/help/merchant-accounts/payments/in-which-currencies-can-i-accept-payments/","target":"_blank","rel":"noreferrer","children":"Help Center"}],"."]}]}]]}]]}] 16de:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":[["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_4217","target":"_blank","rel":"noreferrer","children":"ISO 4217"}]," currency code in upper case."]}],"\n",["$","p","p-1",{"children":["If ",["$","code","code-0",{"children":"settlement_currency"}]," is different from the value of ",["$","code","code-1",{"children":"currency"}],", the money will be exchanged when the amount is settled to your merchant account. In case of a refund or chargeback, the money will be exchanged to the order's initial ",["$","code","code-2",{"children":"currency"}],"."]}],"\n",["$","p","p-2",{"children":["If ",["$","code","code-0",{"children":"settlement_currency"}]," is not specified, this value is taken from ",["$","code","code-1",{"children":"currency"}],"."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information about the supported currencies, see: ",["$","a","a-0",{"href":"https://help.revolut.com/business/help/merchant-accounts/payments/in-which-currencies-can-i-accept-payments/","target":"_blank","rel":"noreferrer","children":"Help Center"}],"."]}]}]]}]]}] 16e0:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Permanent ID of a customer used to retrieve, update, delete a customer. This ID can also be used to link customer to an order."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":"If you provide the customer's ID during order creation, no other customer data is required, they will be parsed automatically from the referenced customer object."}]}]]}]]}] 16e1:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The full name of the customer."}]]}] 16e2:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The phone number of the customer in ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/E.164","target":"_blank","rel":"noreferrer","children":"E.164 format"}],"."]}]]}] 16e3:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The email address of the customer."}]]}] 16e4:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The birth date of the customer."}]]}] 16e5:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object containing information about a customer."}],"\n",["$","p","p-1",{"children":["If you have it, we strongly advise providing at least either ",["$","code","code-0",{"children":"id"}],", ",["$","code","code-1",{"children":"phone"}],", or ",["$","code","code-2",{"children":"email"}],"."]}],"\n",["$","p","p-2",{"children":["Using the ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#tag-customers","target":"_blank","rel":"noreferrer","children":"Customers operations"}],", you can manage customer instances."]}],"\n",["$","p","p-3",{"children":"The following behaviours apply to different use cases:"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Use case","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"API behavior","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":"Existing customer","className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["If ",["$","code","code-0",{"children":"id"}]," was provided, we ignore other customer details and associate the customer with the order.",["$","br","br-0",{}],["$","br","br-1",{}],"If either ",["$","code","code-1",{"children":"email"}],", ",["$","code","code-2",{"children":"phone"}],", or ",["$","code","code-3",{"children":"full_name"}]," was provided (without an existing customer's ",["$","code","code-4",{"children":"id"}],"), we always create a new customer, irrespective of another, existing customer object having the same details."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":"New customer","className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["If either ",["$","code","code-0",{"children":"email"}],", ",["$","code","code-1",{"children":"phone"}],", or ",["$","code","code-2",{"children":"full_name"}]," was provided, we create a new customer, irrespective of another customer object having the same details. ",["$","br","br-0",{}],["$","br","br-1",{}],"If ",["$","code","code-3",{"children":"id"}]," of a non-existent customer was provided, we return a ",["$","code","code-4",{"children":"404"}]," error, irrespective of other details provided."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["To avoid unintentional duplication of customer records, search for an existing customer by email or phone using the ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#retrieve-customer-list","target":"_blank","rel":"noreferrer","children":"List customers"}]," endpoint first, then provide ",["$","code","code-0",{"children":"customer.id"}]," in the order."]}]}]]}]]}] 16e6:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The ID of the payment."}]]}] 16e7:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The status of the payment."}]]}] 16e8:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The reason for a ",["$","code","code-0",{"children":"failed"}]," or ",["$","code","code-1",{"children":"declined"}]," payment."]}],"\n",["$","p","p-1",{"children":["A failed or declined payment can result from multiple reasons. To learn more, check our ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/reference/error-codes/decline-reasons","target":"_blank","rel":"noreferrer","children":"failure reasons"}],"."]}]]}] 16e9:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The reason for a ",["$","code","code-0",{"children":"failed"}]," or ",["$","code","code-1",{"children":"declined"}]," payment, sent by the financial institution processing the payment."]}]]}] 16ea:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The date and time the payment was created."}]]}] 16eb:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The date and time the payment was last updated."}]]}] 16ec:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Temporary token of the payment used to fetch the reward offer during checkout and link user registrations to the given offers."}],"\n",["$","p","p-1",{"children":"The token is only valid for a limited time."}]]}] 16ed:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The payment amount in minor units (e.g., cents). The value of this field depends on the payment type and state."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Payment type","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"State","className":"eowryt6","ref":"$undefined"}],["$","th","th-2",{"children":"Amount value","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":"Standard payment","className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Any","className":"eowryt7","ref":"$undefined"}],["$","td","td-2",{"children":"Total payment amount","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":"Pre-authorised payment","className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["$","code","code-0",{"children":"authorisation_started"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-2",{"children":"New amount being authorised (during increment processing)","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":"Pre-authorised payment","className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["$","code","code-0",{"children":"authorised"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-2",{"children":["Currently authorised amount (equals ",["$","code","code-0",{"children":"authorised_amount"}],")"],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For pre-authorised payments, see the ",["$","code","code-0",{"children":"authorised_amount"}]," field for tracking the currently authorised amount separately."]}]}]]}]]}] 16ee:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The currently authorised amount for this payment (in minor units)."}],"\n",["$","p","p-1",{"children":"For pre-authorised payments with incremental authorization:"}],"\n",["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["Initially equals the ",["$","code","code-0",{"children":"amount"}]," field"]}],"\n",["$","li","li-1",{"children":"Remains unchanged during increment processing"}],"\n",["$","li","li-2",{"children":"Updates to new amount upon successful increment"}],"\n",["$","li","li-3",{"children":"Remains at original amount if increment is declined"}],"\n"]}],"\n",["$","p","p-2",{"children":["For standard payments, this field may not be present or will equal the ",["$","code","code-0",{"children":"amount"}]," field."]}]]}] 16ef:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":[["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_4217","target":"_blank","rel":"noreferrer","children":"ISO 4217"}]," currency code in upper case."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information about the supported currencies, see: ",["$","a","a-0",{"href":"https://help.revolut.com/business/help/merchant-accounts/payments/in-which-currencies-can-i-accept-payments/","target":"_blank","rel":"noreferrer","children":"Help Center"}],"."]}]}]]}]]}] 16f0:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The amount of the settled payment (minor currency unit). For example, ",["$","code","code-0",{"children":"7034"}]," stands for €70.34."]}]]}] 16f1:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The currency of the settled payment. ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_4217","target":"_blank","rel":"noreferrer","children":"ISO 4217"}]," currency code in upper case."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information about the supported currencies, see: ",["$","a","a-0",{"href":"https://help.revolut.com/business/help/merchant-accounts/payments/in-which-currencies-can-i-accept-payments/","target":"_blank","rel":"noreferrer","children":"Help Center"}],"."]}]}]]}]]}] 16f2:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"ID of the saved payment method."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["The ",["$","code","code-0",{"children":"id"}]," parameter is only returned when the payment method is saved."]}]}]]}]]}] 16f3:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of payment method used to pay for the order."}],"\n",["$","p","p-1",{"children":"Available values:"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":["Payment method ",["$","code","code-0",{"children":"type"}]],"className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"apple_pay"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using Apple Pay.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"card"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using their credit or debit card.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"google_pay"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using Google Pay.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"revolut_pay_card"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order via Revolut Pay using their credit or debit card.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-4",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"revolut_pay_account"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order via Revolut Pay using their Revolut account.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-5",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"sepa_direct_debit"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using SEPA Direct Debit.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 16f4:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of the card."}]]}] 16f5:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of card funding."}]]}] 16f6:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The 2-letter country code of the country where the card was issued."}]]}] 16f7:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The BIN of the card."}]]}] 16f8:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The last four digits of the card number."}]]}] 16f9:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The expiry date of the card in the format of MM/YY."}]]}] 16fa:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The name of the cardholder."}]]}] 16fb:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The Electronic Commerce Indicator (ECI) value corresponds to the authentication result and indicates the level of security used when the payment information was provided."}]]}] 16fc:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The result of 3D Secure check."}]]}] 16fd:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The 3D Secure version."}]]}] 16fe:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The details of the 3D Secure check. Only for orders with successful payments."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":"Not returned for Apple Pay and Google Pay payments."}]}]]}]]}] 16ff:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The result of CVV verification."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Parameter value","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"match"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"CVV matches the card's CVV","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"not_match"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"CVV does not match the card's CVV","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"incorrect"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"CVV format is incorrect for this type of card","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"not_processed"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"CVV verification was not performed","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 1700:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The result of address verification."}]]}] 1701:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The result of postcode verification."}]]}] 1702:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The result of cardholder verification."}]]}] 1703:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The details of the check for card payment. Only for orders with successful payments."}]]}] 1704:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The authorisation code (or auth code) is a short, alphanumeric code returned by the cardholder's issuing bank to the merchant's terminal or payment gateway."}],"\n",["$","p","p-1",{"children":"It serves as confirmation that the transaction has been approved and funds are available."}]]}] 1705:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Acquirer Reference Number (ARN) of the payment."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":"Only returned for refund payments made by a card."}]}]]}]]}] 1706:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The date and time by which the payment must be captured."}],"\n",["$","p","p-1",{"children":"After this deadline, the authorised funds may be automatically released by the card issuer."}]]}] 1707:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The hardware identifier of the Revolut Terminal device used to process the payment."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":"Only present for card-present transactions processed via Revolut Terminal."}]}]]}]]}] 1709:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A unique identifier for a payment method, always 44 characters long. This fingerprint can be used to uniquely identify various payment methods."}],"\n",["$","h1","h1-0",{"children":"Fingerprint generation"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Payment method","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","strong","strong-0",{"children":"All payment methods"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"A fingerprint is generated for all payment methods, including cards, Revolut Pay (card, account-to-account payments), Apple Pay, and Google Pay.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","strong","strong-0",{"children":"Cards (Revolut Pay & Card Gateway)"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"For cards, the fingerprint is based on the PAN. Cards processed via Revolut Pay and our card gateway will share the same fingerprint. Renewed cards (new expiry/CVV) retain the same fingerprint for efficient blocking.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","strong","strong-0",{"children":"Apple Pay & Google Pay"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Since Apple Pay and Google Pay provide us Device PANs (DPAN), the fingerprint is based on the DPAN provided by Apple/Google, not the connected card's PAN. This means that a new DPAN (and fingerprint) is generated for cards in case they are re-added to the customer's digital wallet, or added to different devices.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}],"\n",["$","h4","h4-0",{"children":"Detecting duplicate payment methods"}],"\n",["$","p","p-1",{"children":"Fingerprints are a valuable tool for detecting duplicate payment methods by identifying if a payment method has been seen before. This capability, in turn, helps in preventing various types of misuse (e.g., exploitation of free trials, or association with known problematic accounts, which can be a form of fraud). To effectively use fingerprints for this purpose, you will need to create and maintain your own lists (e.g., blocklists of known problematic fingerprints, allowlists for trusted customers, or tracking frequently used fingerprints)."}],"\n",["$","p","p-2",{"children":"The ideal way to utilise fingerprints is by combining them with a manual capture process. While automatic capture with subsequent refunds for problematic payments is possible, manual capture based on fingerprint validation is recommended."}],"\n",["$","p","p-3",{"children":"During your manual capture workflow, after a payment was authorised:"}],"\n",["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":"Check the fingerprint status by comparing it against your maintained lists and internal business rules."}],"\n",["$","li","li-1",{"children":["If you decide to proceed with the payment (e.g., the fingerprint is not on a blocklist, or matches a trusted customer's previous payment method): ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#capture-order","target":"_blank","rel":"noreferrer","children":"Capture the order"}],"."]}],"\n",["$","li","li-2",{"children":["If you decide not to proceed with the payment (e.g., the fingerprint matches a known fraudulent fingerprint, or exhibits suspicious patterns): ","$L19eb","."]}],"\n"]}]]}] 170a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The Network Transaction ID (NTI) is a unique identifier assigned by the card scheme (e.g., Visa or Mastercard) to a card transaction."}],"\n",["$","p","p-1",{"children":"It can be used to trace the transaction across the payment network, link recurring or instalment payments to the original authorisation, and support dispute resolution."}]]}] 170b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object containing details of a card used via Apple Pay."}]]}] 170c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"ID of the saved payment method."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["The ",["$","code","code-0",{"children":"id"}]," parameter is only returned when the payment method is saved."]}]}]]}]]}] 170d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of payment method used to pay for the order."}],"\n",["$","p","p-1",{"children":"Available values:"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":["Payment method ",["$","code","code-0",{"children":"type"}]],"className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"apple_pay"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using Apple Pay.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"card"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using their credit or debit card.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"google_pay"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using Google Pay.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"revolut_pay_card"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order via Revolut Pay using their credit or debit card.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-4",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"revolut_pay_account"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order via Revolut Pay using their Revolut account.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-5",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"sepa_direct_debit"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using SEPA Direct Debit.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 170e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of the card."}]]}] 170f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of card funding."}]]}] 1710:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The 2-letter country code of the country where the card was issued."}]]}] 1711:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The BIN of the card."}]]}] 1712:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The last four digits of the card number."}]]}] 1713:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The expiry date of the card in the format of MM/YY."}]]}] 1714:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The name of the cardholder."}]]}] 1715:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The details of the check for card payment. Only for orders with successful payments."}]]}] 1716:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The authorisation code (or auth code) is a short, alphanumeric code returned by the cardholder's issuing bank to the merchant's terminal or payment gateway."}],"\n",["$","p","p-1",{"children":"It serves as confirmation that the transaction has been approved and funds are available."}]]}] 1717:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Acquirer Reference Number (ARN) of the payment."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":"Only returned for refund payments made by a card."}]}]]}]]}] 1718:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The date and time by which the payment must be captured."}],"\n",["$","p","p-1",{"children":"After this deadline, the authorised funds may be automatically released by the card issuer."}]]}] 1719:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The hardware identifier of the Revolut Terminal device used to process the payment."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":"Only present for card-present transactions processed via Revolut Terminal."}]}]]}]]}] 171b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A unique identifier for a payment method, always 44 characters long. This fingerprint can be used to uniquely identify various payment methods."}],"\n",["$","h1","h1-0",{"children":"Fingerprint generation"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Payment method","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","strong","strong-0",{"children":"All payment methods"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"A fingerprint is generated for all payment methods, including cards, Revolut Pay (card, account-to-account payments), Apple Pay, and Google Pay.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","strong","strong-0",{"children":"Cards (Revolut Pay & Card Gateway)"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"For cards, the fingerprint is based on the PAN. Cards processed via Revolut Pay and our card gateway will share the same fingerprint. Renewed cards (new expiry/CVV) retain the same fingerprint for efficient blocking.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","strong","strong-0",{"children":"Apple Pay & Google Pay"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Since Apple Pay and Google Pay provide us Device PANs (DPAN), the fingerprint is based on the DPAN provided by Apple/Google, not the connected card's PAN. This means that a new DPAN (and fingerprint) is generated for cards in case they are re-added to the customer's digital wallet, or added to different devices.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}],"\n",["$","h4","h4-0",{"children":"Detecting duplicate payment methods"}],"\n",["$","p","p-1",{"children":"Fingerprints are a valuable tool for detecting duplicate payment methods by identifying if a payment method has been seen before. This capability, in turn, helps in preventing various types of misuse (e.g., exploitation of free trials, or association with known problematic accounts, which can be a form of fraud). To effectively use fingerprints for this purpose, you will need to create and maintain your own lists (e.g., blocklists of known problematic fingerprints, allowlists for trusted customers, or tracking frequently used fingerprints)."}],"\n",["$","p","p-2",{"children":"The ideal way to utilise fingerprints is by combining them with a manual capture process. While automatic capture with subsequent refunds for problematic payments is possible, manual capture based on fingerprint validation is recommended."}],"\n",["$","p","p-3",{"children":"During your manual capture workflow, after a payment was authorised:"}],"\n",["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":"Check the fingerprint status by comparing it against your maintained lists and internal business rules."}],"\n",["$","li","li-1",{"children":["If you decide to proceed with the payment (e.g., the fingerprint is not on a blocklist, or matches a trusted customer's previous payment method): ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#capture-order","target":"_blank","rel":"noreferrer","children":"Capture the order"}],"."]}],"\n",["$","li","li-2",{"children":["If you decide not to proceed with the payment (e.g., the fingerprint matches a known fraudulent fingerprint, or exhibits suspicious patterns): ","$L19ec","."]}],"\n"]}]]}] 171c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The Network Transaction ID (NTI) is a unique identifier assigned by the card scheme (e.g., Visa or Mastercard) to a card transaction."}],"\n",["$","p","p-1",{"children":"It can be used to trace the transaction across the payment network, link recurring or instalment payments to the original authorisation, and support dispute resolution."}]]}] 171d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object containing details of the card used for the payment."}]]}] 171e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"ID of the saved payment method."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["The ",["$","code","code-0",{"children":"id"}]," parameter is only returned when the payment method is saved."]}]}]]}]]}] 171f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of payment method used to pay for the order."}],"\n",["$","p","p-1",{"children":"Available values:"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":["Payment method ",["$","code","code-0",{"children":"type"}]],"className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"apple_pay"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using Apple Pay.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"card"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using their credit or debit card.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"google_pay"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using Google Pay.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"revolut_pay_card"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order via Revolut Pay using their credit or debit card.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-4",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"revolut_pay_account"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order via Revolut Pay using their Revolut account.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-5",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"sepa_direct_debit"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using SEPA Direct Debit.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 1720:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of the card."}]]}] 1721:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of card funding."}]]}] 1722:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The 2-letter country code of the country where the card was issued."}]]}] 1723:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The BIN of the card."}]]}] 1724:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The last four digits of the card number."}]]}] 1725:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The expiry date of the card in the format of MM/YY."}]]}] 1726:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The name of the cardholder."}]]}] 1727:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The details of the check for card payment. Only for orders with successful payments."}]]}] 1728:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The authorisation code (or auth code) is a short, alphanumeric code returned by the cardholder's issuing bank to the merchant's terminal or payment gateway."}],"\n",["$","p","p-1",{"children":"It serves as confirmation that the transaction has been approved and funds are available."}]]}] 1729:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Acquirer Reference Number (ARN) of the payment."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":"Only returned for refund payments made by a card."}]}]]}]]}] 172a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The date and time by which the payment must be captured."}],"\n",["$","p","p-1",{"children":"After this deadline, the authorised funds may be automatically released by the card issuer."}]]}] 172b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The hardware identifier of the Revolut Terminal device used to process the payment."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":"Only present for card-present transactions processed via Revolut Terminal."}]}]]}]]}] 172d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A unique identifier for a payment method, always 44 characters long. This fingerprint can be used to uniquely identify various payment methods."}],"\n",["$","h1","h1-0",{"children":"Fingerprint generation"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Payment method","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","strong","strong-0",{"children":"All payment methods"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"A fingerprint is generated for all payment methods, including cards, Revolut Pay (card, account-to-account payments), Apple Pay, and Google Pay.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","strong","strong-0",{"children":"Cards (Revolut Pay & Card Gateway)"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"For cards, the fingerprint is based on the PAN. Cards processed via Revolut Pay and our card gateway will share the same fingerprint. Renewed cards (new expiry/CVV) retain the same fingerprint for efficient blocking.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","strong","strong-0",{"children":"Apple Pay & Google Pay"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Since Apple Pay and Google Pay provide us Device PANs (DPAN), the fingerprint is based on the DPAN provided by Apple/Google, not the connected card's PAN. This means that a new DPAN (and fingerprint) is generated for cards in case they are re-added to the customer's digital wallet, or added to different devices.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}],"\n",["$","h4","h4-0",{"children":"Detecting duplicate payment methods"}],"\n",["$","p","p-1",{"children":"Fingerprints are a valuable tool for detecting duplicate payment methods by identifying if a payment method has been seen before. This capability, in turn, helps in preventing various types of misuse (e.g., exploitation of free trials, or association with known problematic accounts, which can be a form of fraud). To effectively use fingerprints for this purpose, you will need to create and maintain your own lists (e.g., blocklists of known problematic fingerprints, allowlists for trusted customers, or tracking frequently used fingerprints)."}],"\n",["$","p","p-2",{"children":"The ideal way to utilise fingerprints is by combining them with a manual capture process. While automatic capture with subsequent refunds for problematic payments is possible, manual capture based on fingerprint validation is recommended."}],"\n",["$","p","p-3",{"children":"During your manual capture workflow, after a payment was authorised:"}],"\n",["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":"Check the fingerprint status by comparing it against your maintained lists and internal business rules."}],"\n",["$","li","li-1",{"children":["If you decide to proceed with the payment (e.g., the fingerprint is not on a blocklist, or matches a trusted customer's previous payment method): ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#capture-order","target":"_blank","rel":"noreferrer","children":"Capture the order"}],"."]}],"\n",["$","li","li-2",{"children":["If you decide not to proceed with the payment (e.g., the fingerprint matches a known fraudulent fingerprint, or exhibits suspicious patterns): ","$L19ed","."]}],"\n"]}]]}] 172e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The Network Transaction ID (NTI) is a unique identifier assigned by the card scheme (e.g., Visa or Mastercard) to a card transaction."}],"\n",["$","p","p-1",{"children":"It can be used to trace the transaction across the payment network, link recurring or instalment payments to the original authorisation, and support dispute resolution."}]]}] 172f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object containing details of a card used via Google Pay."}]]}] 1730:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"ID of the saved payment method."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["The ",["$","code","code-0",{"children":"id"}]," parameter is only returned when the payment method is saved."]}]}]]}]]}] 1731:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of payment method used to pay for the order."}],"\n",["$","p","p-1",{"children":"Available values:"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":["Payment method ",["$","code","code-0",{"children":"type"}]],"className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"apple_pay"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using Apple Pay.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"card"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using their credit or debit card.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"google_pay"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using Google Pay.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"revolut_pay_card"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order via Revolut Pay using their credit or debit card.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-4",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"revolut_pay_account"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order via Revolut Pay using their Revolut account.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-5",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"sepa_direct_debit"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using SEPA Direct Debit.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 1732:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of the card."}]]}] 1733:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of card funding."}]]}] 1734:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The 2-letter country code of the country where the card was issued."}]]}] 1735:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The BIN of the card."}]]}] 1736:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The last four digits of the card number."}]]}] 1737:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The expiry date of the card in the format of MM/YY."}]]}] 1738:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The name of the cardholder."}]]}] 1739:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The details of the check for card payment. Only for orders with successful payments."}]]}] 173a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The authorisation code (or auth code) is a short, alphanumeric code returned by the cardholder's issuing bank to the merchant's terminal or payment gateway."}],"\n",["$","p","p-1",{"children":"It serves as confirmation that the transaction has been approved and funds are available."}]]}] 173b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Acquirer Reference Number (ARN) of the payment."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":"Only returned for refund payments made by a card."}]}]]}]]}] 173c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The date and time by which the payment must be captured."}],"\n",["$","p","p-1",{"children":"After this deadline, the authorised funds may be automatically released by the card issuer."}]]}] 173d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The hardware identifier of the Revolut Terminal device used to process the payment."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":"Only present for card-present transactions processed via Revolut Terminal."}]}]]}]]}] 173f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A unique identifier for a payment method, always 44 characters long. This fingerprint can be used to uniquely identify various payment methods."}],"\n",["$","h1","h1-0",{"children":"Fingerprint generation"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Payment method","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","strong","strong-0",{"children":"All payment methods"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"A fingerprint is generated for all payment methods, including cards, Revolut Pay (card, account-to-account payments), Apple Pay, and Google Pay.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","strong","strong-0",{"children":"Cards (Revolut Pay & Card Gateway)"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"For cards, the fingerprint is based on the PAN. Cards processed via Revolut Pay and our card gateway will share the same fingerprint. Renewed cards (new expiry/CVV) retain the same fingerprint for efficient blocking.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","strong","strong-0",{"children":"Apple Pay & Google Pay"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Since Apple Pay and Google Pay provide us Device PANs (DPAN), the fingerprint is based on the DPAN provided by Apple/Google, not the connected card's PAN. This means that a new DPAN (and fingerprint) is generated for cards in case they are re-added to the customer's digital wallet, or added to different devices.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}],"\n",["$","h4","h4-0",{"children":"Detecting duplicate payment methods"}],"\n",["$","p","p-1",{"children":"Fingerprints are a valuable tool for detecting duplicate payment methods by identifying if a payment method has been seen before. This capability, in turn, helps in preventing various types of misuse (e.g., exploitation of free trials, or association with known problematic accounts, which can be a form of fraud). To effectively use fingerprints for this purpose, you will need to create and maintain your own lists (e.g., blocklists of known problematic fingerprints, allowlists for trusted customers, or tracking frequently used fingerprints)."}],"\n",["$","p","p-2",{"children":"The ideal way to utilise fingerprints is by combining them with a manual capture process. While automatic capture with subsequent refunds for problematic payments is possible, manual capture based on fingerprint validation is recommended."}],"\n",["$","p","p-3",{"children":"During your manual capture workflow, after a payment was authorised:"}],"\n",["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":"Check the fingerprint status by comparing it against your maintained lists and internal business rules."}],"\n",["$","li","li-1",{"children":["If you decide to proceed with the payment (e.g., the fingerprint is not on a blocklist, or matches a trusted customer's previous payment method): ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#capture-order","target":"_blank","rel":"noreferrer","children":"Capture the order"}],"."]}],"\n",["$","li","li-2",{"children":["If you decide not to proceed with the payment (e.g., the fingerprint matches a known fraudulent fingerprint, or exhibits suspicious patterns): ","$L19ee","."]}],"\n"]}]]}] 1740:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The Network Transaction ID (NTI) is a unique identifier assigned by the card scheme (e.g., Visa or Mastercard) to a card transaction."}],"\n",["$","p","p-1",{"children":"It can be used to trace the transaction across the payment network, link recurring or instalment payments to the original authorisation, and support dispute resolution."}]]}] 1741:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object containing details of a card used via Revolut Pay."}]]}] 1742:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"ID of the saved payment method."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["The ",["$","code","code-0",{"children":"id"}]," parameter is only returned when the payment method is saved."]}]}]]}]]}] 1743:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of payment method used to pay for the order."}],"\n",["$","p","p-1",{"children":"Available values:"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":["Payment method ",["$","code","code-0",{"children":"type"}]],"className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"apple_pay"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using Apple Pay.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"card"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using their credit or debit card.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"google_pay"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using Google Pay.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"revolut_pay_card"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order via Revolut Pay using their credit or debit card.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-4",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"revolut_pay_account"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order via Revolut Pay using their Revolut account.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-5",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"sepa_direct_debit"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using SEPA Direct Debit.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 1745:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A unique identifier for a payment method, always 44 characters long. This fingerprint can be used to uniquely identify various payment methods."}],"\n",["$","h1","h1-0",{"children":"Fingerprint generation"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Payment method","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","strong","strong-0",{"children":"All payment methods"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"A fingerprint is generated for all payment methods, including cards, Revolut Pay (card, account-to-account payments), Apple Pay, and Google Pay.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","strong","strong-0",{"children":"Cards (Revolut Pay & Card Gateway)"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"For cards, the fingerprint is based on the PAN. Cards processed via Revolut Pay and our card gateway will share the same fingerprint. Renewed cards (new expiry/CVV) retain the same fingerprint for efficient blocking.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","strong","strong-0",{"children":"Apple Pay & Google Pay"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Since Apple Pay and Google Pay provide us Device PANs (DPAN), the fingerprint is based on the DPAN provided by Apple/Google, not the connected card's PAN. This means that a new DPAN (and fingerprint) is generated for cards in case they are re-added to the customer's digital wallet, or added to different devices.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}],"\n",["$","h4","h4-0",{"children":"Detecting duplicate payment methods"}],"\n",["$","p","p-1",{"children":"Fingerprints are a valuable tool for detecting duplicate payment methods by identifying if a payment method has been seen before. This capability, in turn, helps in preventing various types of misuse (e.g., exploitation of free trials, or association with known problematic accounts, which can be a form of fraud). To effectively use fingerprints for this purpose, you will need to create and maintain your own lists (e.g., blocklists of known problematic fingerprints, allowlists for trusted customers, or tracking frequently used fingerprints)."}],"\n",["$","p","p-2",{"children":"The ideal way to utilise fingerprints is by combining them with a manual capture process. While automatic capture with subsequent refunds for problematic payments is possible, manual capture based on fingerprint validation is recommended."}],"\n",["$","p","p-3",{"children":"During your manual capture workflow, after a payment was authorised:"}],"\n",["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":"Check the fingerprint status by comparing it against your maintained lists and internal business rules."}],"\n",["$","li","li-1",{"children":["If you decide to proceed with the payment (e.g., the fingerprint is not on a blocklist, or matches a trusted customer's previous payment method): ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#capture-order","target":"_blank","rel":"noreferrer","children":"Capture the order"}],"."]}],"\n",["$","li","li-2",{"children":["If you decide not to proceed with the payment (e.g., the fingerprint matches a known fraudulent fingerprint, or exhibits suspicious patterns): ","$L19ef","."]}],"\n"]}]]}] 1746:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"ID of the saved payment method."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["The ",["$","code","code-0",{"children":"id"}]," parameter is only returned when the payment method is saved for the merchant."]}]}]]}]]}] 1747:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of payment method used to pay for the order."}],"\n",["$","p","p-1",{"children":"Available values:"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":["Payment method ",["$","code","code-0",{"children":"type"}]],"className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"apple_pay"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using Apple Pay.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"card"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using their credit or debit card.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"google_pay"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using Google Pay.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"revolut_pay_card"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order via Revolut Pay using their credit or debit card.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-4",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"revolut_pay_account"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order via Revolut Pay using their Revolut account.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-5",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"sepa_direct_debit"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using SEPA Direct Debit.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 1748:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The last four digits of the debtor's IBAN."}]]}] 1749:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The full name of the debtor as provided in the mandate."}]]}] 174a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The unique mandate reference generated by Revolut. Include this in pre-debit notifications sent to your customers."}]]}] 174b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object containing details of a SEPA Direct Debit payment."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/accept-payments/payment-methods/sepa-direct-debit/server-to-server","target":"_blank","rel":"noreferrer","children":"SEPA Direct Debit server-to-server integration"}]]}]}]]}]]}] 174c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The details of the payment method used to make the payment."}]]}] 174d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Type of the authentication challenge the payment triggers."}]]}] 174e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The URL of the authentication challenge."}]]}] 174f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Information about the 3DS challenge."}]]}] 1750:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Type of the authentication challenge the payment triggers."}]]}] 1751:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The URL of the fingerprint. (Used only internally by Revolut.)"}]]}] 1752:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Data about the fingerprint used for authentication. (Used only internally\nby Revolut.)"}]]}] 1753:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Information about the 3DS fingerprint challenge."}]]}] 1754:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["Details about the authentication challenge that should be performed to complete the authentication process. For more information about Revolut's 3DS solution, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/reference/3d-secure","target":"_blank","rel":"noreferrer","children":"3D Secure overview"}],"."]}],"\n",["$","p","p-1",{"children":["Only returned if the payment's state is ",["$","code","code-0",{"children":"authentication_challenge"}],"."]}]]}] 1755:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Street line 1 information."}]]}] 1756:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Street line 2 information."}]]}] 1757:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The region associated with the address."}]]}] 1758:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The city associated with the address."}]]}] 1759:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The 2-letter country code of the country associated with the address."}]]}] 175a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The postcode associated with the address."}]]}] 175b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object containing address details."}]]}] 175c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The risk level of the card."}],"\n",["$","p","p-1",{"children":["If the risk level is ",["$","code","code-0",{"children":"high"}],", the payment might be declined."]}]]}] 175d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of the order fee."}]]}] 175e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The amount of the payment fee (minor currency unit). For example, enter ",["$","code","code-0",{"children":"7034"}]," for €70.34 in the field."]}]]}] 175f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The currency of the payment fee. ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_4217","target":"_blank","rel":"noreferrer","children":"ISO 4217"}]," currency code in upper case."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information about the supported currencies, see: ",["$","a","a-0",{"href":"https://help.revolut.com/business/help/merchant-accounts/payments/in-which-currencies-can-i-accept-payments/","target":"_blank","rel":"noreferrer","children":"Help Center"}],"."]}]}]]}]]}] 1760:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The details of the order fee."}]]}] 1761:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The email of the person who made the payment."}]]}] 1762:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The phone number of the payer in ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/E.164","target":"_blank","rel":"noreferrer","children":"E.164 format"}],"."]}]]}] 1763:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The person who made the payment. This object is present when an email or phone number is provided during the payment flow."}],"\n",["$","p","p-1",{"children":"Capturing payer details lets you identify exactly who authorised the charge, reach the right person for receipts or refund queries, and support compliance or fraud-review workflows where the paying identity matters."}]]}] 1764:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Represents a payment for an order."}],"\n",["$","p","p-1",{"children":["For pre-authorised payments, the ",["$","code","code-0",{"children":"authorised_amount"}]," field tracks the currently authorised amount, which may differ from ",["$","code","code-1",{"children":"amount"}]," during incremental authorisation processing."]}]]}] 1765:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The details of all the payments that have been made towards this order (successful or unsuccessful)."}]]}] 1766:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The new total amount requested in this increment (in minor units)."}]]}] 1767:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The previously authorised amount before this increment (in minor units)."}]]}] 1768:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The state of this incremental authorization attempt."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"State","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"pending"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Increment registered in system, not yet submitted to card network","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"processing"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Increment is being processed by card network","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"authorised"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Increment was successfully authorised","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"declined"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Increment was declined by card issuer","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-4",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"failed"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Increment failed due to technical error (not an issuer decline)","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 1769:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"External reference for this incremental authorisation."}],"\n",["$","div","inlinealert-0",{"data-type":"tip","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"Lightbulb","color":"var(--rui-color-success)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":"Use your internal charge or invoice ID. This reference is returned in webhooks for easy matching to your system."}]}]]}]]}] 176a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Name of the line item."}]]}] 176b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Type of the line item."}]]}] 176c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The number of units of the line item."}]]}] 176d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The measurement unit for the quantity, such as ",["$","code","code-0",{"children":"cm"}],", or ",["$","code","code-1",{"children":"kg"}],"."]}]]}] 176e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object representing the quantity details of a line item, including the amount and its associated unit of measurement."}]]}] 176f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The unit price of the line item."}]]}] 1770:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The total amount to be paid for the line item, including taxes and discounts."}]]}] 1771:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unique identifier of line item in the merchant's system."}]]}] 1772:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The specific name or label of the discount applied to the line item."}]]}] 1773:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The monetary value of the discount."}]]}] 1774:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Details of a discount applied to the line item, including its name and monetary value."}]]}] 1775:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A list of discounts applied to the line item. Each discount should be subtracted from the total amount payable for the item."}]]}] 1776:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The specific name or designation of the tax applied to the line item."}]]}] 1777:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The monetary value of the tax in minor currency units (e.g., cents for EUR)."}]]}] 1778:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Details about a tax applied to the line item, including its name and the corresponding amount."}]]}] 1779:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A list of taxes applied to the line item. Each tax should be added to the total amount payable for the item."}]]}] 177a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"URL to an image associated with the line item."}],"\n",["$","div","inlinealert-0",{"data-type":"warning","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMark","color":"var(--rui-color-warning)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"Restrictions:"}],["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["Must be a valid URI as defined by ",["$","a","a-0",{"href":"https://datatracker.ietf.org/doc/html/rfc3986","target":"_blank","rel":"noreferrer","children":"RFC 3986"}]]}],"\n",["$","li","li-1",{"children":["URI scheme is required and must be either ",["$","code","code-0",{"children":"http"}]," or ",["$","code","code-1",{"children":"https"}]]}],"\n",["$","li","li-2",{"children":["URI host is required and cannot be ",["$","code","code-0",{"children":"localhost"}]," or an IP address"]}],"\n",["$","li","li-3",{"children":["Max length: ",["$","code","code-0",{"children":"2000"}]]}],"\n",["$","li","li-4",{"children":["Reserved or invalid characters must be percent-encoded (for example, use ",["$","code","code-0",{"children":"%20"}]," instead of a space)"]}],"\n"]}]]}]]}]]}] 177b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A list of URLs pointing to images related to the line item. These images can provide visual details or representations of the item."}]]}] 177c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Description of the line item."}]]}] 177d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An HTTP/HTTPS URL that links to more information about the line item, such as a product page or details."}],"\n",["$","div","inlinealert-0",{"data-type":"warning","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMark","color":"var(--rui-color-warning)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"Restrictions:"}],["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["Must be a valid URI as defined by ",["$","a","a-0",{"href":"https://datatracker.ietf.org/doc/html/rfc3986","target":"_blank","rel":"noreferrer","children":"RFC 3986"}]]}],"\n",["$","li","li-1",{"children":["URI scheme is required and must be either ",["$","code","code-0",{"children":"http"}]," or ",["$","code","code-1",{"children":"https"}]]}],"\n",["$","li","li-2",{"children":["URI host is required and cannot be ",["$","code","code-0",{"children":"localhost"}]," or an IP address"]}],"\n",["$","li","li-3",{"children":["Max length: ",["$","code","code-0",{"children":"2000"}]]}],"\n",["$","li","li-4",{"children":["Reserved or invalid characters must be percent-encoded (for example, use ",["$","code","code-0",{"children":"%20"}]," instead of a space)"]}],"\n"]}]]}]]}]]}] 177e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Line items associated with this increment (if provided)."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":"If the increment is successful, these line items will override the existing order line items."}]}]]}]]}] 177f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Reason why increment was declined or failed."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["Only present when ",["$","code","code-0",{"children":"state"}]," is ",["$","code","code-1",{"children":"declined"}]," or ",["$","code","code-2",{"children":"failed"}],"."]}]}]]}]]}] 1780:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Represents a single incremental authorisation attempt on an order."}],"\n",["$","p","p-1",{"children":["The ",["$","code","code-0",{"children":"incremental_authorisations"}]," array tracks all increment attempts (successful and failed) in chronological order."]}]]}] 1781:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"History of incremental authorisation attempts for this order."}],"\n",["$","p","p-1",{"children":["Only present for orders with ",["$","code","code-0",{"children":"authorisation_type: pre_authorisation"}],"."]}],"\n",["$","p","p-2",{"children":"Contains all increment attempts in chronological order."}]]}] 1782:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unique ID representing the location where merchants sells products."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#tag-locations","target":"_blank","rel":"noreferrer","children":"Locations"}],"."]}]}]]}]]}] 1783:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Additional metadata value provided with the corresponding metadata key."}]]}] 1784:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["Additional information to track your orders in your system, by providing custom metadata using ",["$","code","code-0",{"children":"\"\" : \"\""}]," pairs."]}],"\n",["$","div","inlinealert-0",{"data-type":"warning","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMark","color":"var(--rui-color-warning)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":["$","strong","strong-0",{"children":"Restrictions:"}]}],["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["Both keys and values must be ",["$","code","code-0",{"children":"string"}],"s"]}],"\n",["$","li","li-1",{"children":["Values cannot be ",["$","code","code-0",{"children":"null"}],"."]}],"\n",["$","li","li-2",{"children":["Max number of key-value pairs: ",["$","code","code-0",{"children":"50"}]]}],"\n",["$","li","li-3",{"children":["Max length of values: ",["$","code","code-0",{"children":"500"}]," characters"]}],"\n",["$","li","li-4",{"children":["Format of keys: Must start with a letter and contain only letters, digits, and underscores. Max 40 characters. Pattern: ",["$","code","code-0",{"children":"^[a-zA-Z][a-zA-Z\\\\d_]{0,39}$"}]]}],"\n"]}]]}]]}]]}] 1786:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Type of the industry-specific data object, determining what additional data is expected."}],"\n",["$","p","p-1",{"children":"Available types:"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Object type","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"airline"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about a specific airline ticket purchase.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"car_rental"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about a car rental booking associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"crypto"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about crypto transactions associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"marketplace"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["This object is required by Mastercard and Visa for merchants operating as marketplaces under the ",["$","strong","strong-0",{"children":"Merchant Category Code (MCC):"}]," ",["$","code","code-0",{"children":"5262"}],". The marketplace object ensures compliance with the card schemes' regulations by providing detailed information about the subseller involved in the transaction."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-4",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"event"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about event ticket bookings associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-5",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"lodging"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about lodging bookings associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 1787:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A unique identifier provided by the merchant associated with the order."}],"\n",["$","p","p-1",{"children":["This ",["$","code","code-0",{"children":"booking_id"}]," is used to reference and correlate booking information with the Merchant API and the merchant's internal system."]}]]}] 1788:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The UTC date and time of the final journey leg."}],"\n",["$","div","inlinealert-0",{"data-type":"warning","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMark","color":"var(--rui-color-warning)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"The following limitations apply:"}],["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["When creating or updating an order, ",["$","code","code-0",{"children":"fulfillment_date"}]," cannot be set to a date in the past."]}],"\n",["$","li","li-1",{"children":["When updating an order, if the current ",["$","code","code-0",{"children":"fulfillment_date"}]," value is already in the past, it cannot be modified. The date must remain as is to maintain data integrity for completed transactions."]}],"\n"]}]]}]]}]]}] 1789:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["Flag indicating whether the order includes actual ticket purchases. Set to ",["$","code","code-0",{"children":"true"}]," if the order contains ticket purchases, and ",["$","code","code-1",{"children":"false"}]," if it does not (e.g., it ",["$","strong","strong-0",{"children":"only"}]," contains seat reservations, or baggage upgrades)."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":["This field is required for activating ",["$","strong","strong-0",{"children":"Revolut Flight Alerts"}]," functionalities within the Revolut app."]}],["$","p","p-1",{"children":"Provide the info on order creation or update, before capturing the order."}]]}]]}]]}] 178a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of the ticket."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Parameter value","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"fixed"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Non-modifiable once confirmed.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"flexible"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Allows modifications or cancellations under specified conditions.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 178b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The code of the Computer Reservation System (CRS) used to make the booking and purchase the ticket."}]]}] 178c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Parameter indicating whether this order is related to a new ticket reservation or a modification of an existing one."}]]}] 178d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Parameter indicating whether the booking is refundable, partially refundable, or not refundable."}]]}] 178e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Passenger's first name."}]]}] 178f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Passenger's last name."}]]}] 1790:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Array containing information of passengers associated with the booking."}]]}] 1791:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Sequence of the journey legs. Increment by 1 for each flight included in the ticket."}],"\n",["$","p","p-1",{"children":["For example: For a ",["$","code","code-0",{"children":"FRA > LHR > DUB > LHR > FRA"}]," journey the sequence will be assigned as:"]}],"\n",["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":[["$","code","code-0",{"children":"FRA > LHR"}],": 1"]}],"\n",["$","li","li-1",{"children":[["$","code","code-0",{"children":"LHR > DUB"}],": 2"]}],"\n",["$","li","li-2",{"children":[["$","code","code-0",{"children":"DUB > LHR"}],": 3"]}],"\n",["$","li","li-3",{"children":[["$","code","code-0",{"children":"LHR > FRA"}],": 4"]}],"\n"]}]]}] 1792:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://www.iata.org/en/services/codes","target":"_blank","rel":"noreferrer","children":"IATA"}]," 3-letter airport code for the departure airport."]}]]}] 1793:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://www.iata.org/en/services/codes","target":"_blank","rel":"noreferrer","children":"IATA"}]," 3-letter airport code for the arrival airport."]}]]}] 1794:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The flight identifier, without airline code."}]]}] 1795:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The fare base code for the given journey leg."}]]}] 1796:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The UTC date and time of the flight departure for the given journey leg."}]]}] 1797:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The name of the airline associated with the journey leg."}]]}] 1798:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The IATA 2-letter accounting code identifying the airline associated with the journey leg."}]]}] 1799:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The Passenger Name Record (PNR) for the journey leg issued by the airline."}],"\n",["$","p","p-1",{"children":"PNR is a unique identifier for the booking, acting as a digital certificate allowing passengers to retrieve or manage their booking details."}],"\n",["$","div","inlinealert-0",{"data-type":"warning","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMark","color":"var(--rui-color-warning)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":"This is a required field for OTAs."}]}]]}]]}] 179a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Array containing information of journey legs associated with the booking."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":["This field is required for activating ",["$","strong","strong-0",{"children":"Revolut Flight Alerts"}]," functionalities within the Revolut app."]}],["$","p","p-1",{"children":"This information is used to compile a tracking widget that provides real-time updates on flight status and sends notifications, such as a check-in reminders, boarding alerts, and notifications for cancellations or delays."}],["$","p","p-2",{"children":"To enable the widget the following fields are required on order creation or update, before capturing the order:"}],"$L19f0"]}]]}]]}] 179b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"URL to the online portal for managing the airline booking, which includes check-in functionality. This URL may be a personalised, pre-populated check-in link specific to the user or a generic link, and it is essential for enabling direct access to booking details within the Revolut app."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":["This field is required for activating ",["$","strong","strong-0",{"children":"Revolut Flight Alerts"}]," functionalities within the Revolut app."]}],["$","p","p-1",{"children":"Provide the info on order creation or update, before capturing the order."}]]}]]}],"\n",["$","div","inlinealert-1",{"data-type":"warning","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMark","color":"var(--rui-color-warning)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"Restrictions:"}],["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["Must be a valid URI as defined by ",["$","a","a-0",{"href":"https://datatracker.ietf.org/doc/html/rfc3986","target":"_blank","rel":"noreferrer","children":"RFC 3986"}]]}],"\n",["$","li","li-1",{"children":["URI scheme is required and must be either ",["$","code","code-0",{"children":"http"}]," or ",["$","code","code-1",{"children":"https"}]]}],"\n",["$","li","li-2",{"children":["URI host is required and cannot be ",["$","code","code-0",{"children":"localhost"}]," or an IP address"]}],"\n",["$","li","li-3",{"children":["Max length: ",["$","code","code-0",{"children":"2000"}]]}],"\n",["$","li","li-4",{"children":["Reserved or invalid characters must be percent-encoded (for example, use ",["$","code","code-0",{"children":"%20"}]," instead of a space)"]}],"\n"]}]]}]]}]]}] 179c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object containing additional information about an airline booking associated with the order."}],"\n",["$","p","p-1",{"children":["Use this object to provide required data to enable ",["$","strong","strong-0",{"children":"Revolut Flight Alerts"}],". This feature allows users to receive real-time flight updates such as check-in reminders, boarding alerts, and notifications for cancellations or delays in the Revolut app."]}],"\n",["$","p","p-2",{"children":["To enable ",["$","strong","strong-0",{"children":"Revolut Flight Alerts"}]," functionalities in the Revolut app, the following fields are ",["$","strong","strong-1",{"children":"required"}]," on order creation or update, before capturing the order:"]}],"\n","$L19f1","\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"These are the specific data field requirements for merchants who must provide airline data. Note that these requirements can be extended on a case by case basis as decided by Revolut."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Required for airline/charter merchants","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Required for OTA merchants","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","ul","ul-0",{"children":[["$","li","li-0",{"children":["$","code","code-0",{"children":"booking_id"}]}],["$","li","li-1",{"children":["$","code","code-0",{"children":"fulfillment_date"}]}],["$","li","li-2",{"children":["$","code","code-0",{"children":"passengers[].first_name"}]}],["$","li","li-3",{"children":["$","code","code-0",{"children":"passengers[].last_name"}]}],["$","li","li-4",{"children":["$","code","code-0",{"children":"journey_legs[].pnr"}]}],["$","li","li-5",{"children":["$","code","code-0",{"children":"journey_legs[].sequence"}]}],["$","li","li-6",{"children":["$","code","code-0",{"children":"journey_legs[].flight_number"}]}],["$","li","li-7",{"children":["$","code","code-0",{"children":"journey_legs[].travel_date"}]}],["$","li","li-8",{"children":["$","code","code-0",{"children":"journey_legs[].airline_code"}]}],["$","li","li-9",{"children":["$","code","code-0",{"children":"journey_legs[].departure_airport_code"}]}],["$","li","li-10",{"children":["$","code","code-0",{"children":"journey_legs[].arrival_airport_code"}]}]]}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["$","ul","ul-0",{"children":[["$","li","li-0",{"children":["$","code","code-0",{"children":"booking_id"}]}],["$","li","li-1",{"children":["$","code","code-0",{"children":"fulfillment_date"}]}],["$","li","li-2",{"children":["$","code","code-0",{"children":"passengers[].first_name"}]}],["$","li","li-3",{"children":["$","code","code-0",{"children":"passengers[].last_name"}]}],["$","li","li-4",{"children":["$","code","code-0",{"children":"journey_legs[].pnr"}]}],["$","li","li-5",{"children":["$","code","code-0",{"children":"journey_legs[].arrival_airport_code"}]}]]}],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt3","ref":"$undefined"}]]}]}]]}]]}]]}] 179d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Type of the industry-specific data object, determining what additional data is expected."}],"\n",["$","p","p-1",{"children":"Available types:"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Object type","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"airline"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about a specific airline ticket purchase.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"car_rental"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about a car rental booking associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"crypto"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about crypto transactions associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"marketplace"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["This object is required by Mastercard and Visa for merchants operating as marketplaces under the ",["$","strong","strong-0",{"children":"Merchant Category Code (MCC):"}]," ",["$","code","code-0",{"children":"5262"}],". The marketplace object ensures compliance with the card schemes' regulations by providing detailed information about the subseller involved in the transaction."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-4",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"event"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about event ticket bookings associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-5",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"lodging"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about lodging bookings associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 179e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A unique identifier provided by the merchant associated with the order."}],"\n",["$","p","p-1",{"children":["This ",["$","code","code-0",{"children":"booking_id"}]," is used to reference and correlate booking information with the Merchant API and the merchant's internal system."]}]]}] 179f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The UTC date and time of the pick-up."}]]}] 17a0:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object containing address details."}]]}] 17a1:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The UTC date and time of the drop-off."}]]}] 17a2:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object containing address details."}]]}] 17a3:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Parameter indicating whether the booking is refundable, partially refundable, or not refundable."}]]}] 17a4:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The maximum distance allowed."}]]}] 17a5:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The unit of distance."}]]}] 17a6:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The amount of the cost in minor currency units. For example, enter ",["$","code","code-0",{"children":"7034"}]," for €70.34."]}]]}] 17a7:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":[["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_4217","target":"_blank","rel":"noreferrer","children":"ISO 4217"}]," currency code in upper case."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information about the supported currencies, see: ",["$","a","a-0",{"href":"https://help.revolut.com/business/help/merchant-accounts/payments/in-which-currencies-can-i-accept-payments/","target":"_blank","rel":"noreferrer","children":"Help Center"}],"."]}]}]]}]]}] 17a8:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Cost for exceeding the distance limit."}]]}] 17a9:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object containing distance limit information."}]]}] 17aa:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object containing additional information about a car rental booking associated with the order."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"These are the specific data field requirements for merchants offering car rental. Note that these requirements can be extended on a case by case basis as decided by Revolut."}],"$L19f2"]}]]}]]}] 17ab:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Type of the industry-specific data object, determining what additional data is expected."}],"\n",["$","p","p-1",{"children":"Available types:"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Object type","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"airline"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about a specific airline ticket purchase.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"car_rental"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about a car rental booking associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"crypto"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about crypto transactions associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"marketplace"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["This object is required by Mastercard and Visa for merchants operating as marketplaces under the ",["$","strong","strong-0",{"children":"Merchant Category Code (MCC):"}]," ",["$","code","code-0",{"children":"5262"}],". The marketplace object ensures compliance with the card schemes' regulations by providing detailed information about the subseller involved in the transaction."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-4",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"event"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about event ticket bookings associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-5",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"lodging"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about lodging bookings associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 17ac:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The public transaction hash of the crypto transaction."}]]}] 17ad:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The status of the crypto transaction."}]]}] 17ae:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The wallet ID of the recipient."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["At least one of the parameters: ",["$","code","code-0",{"children":"recipient_user_id"}]," or ",["$","code","code-1",{"children":"recipient_wallet_id"}]," is required."]}]}]]}]]}] 17af:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The user ID of the recipient."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["At least one of the parameters: ",["$","code","code-0",{"children":"recipient_user_id"}]," or ",["$","code","code-1",{"children":"recipient_wallet_id"}]," is required."]}]}]]}]]}] 17b0:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Array of crypto transaction data associated with the order."}]]}] 17b1:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["A string representing the four-digit ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/Merchant_category_code","target":"_blank","rel":"noreferrer","children":"Merchant Category Code (MCC)"}]," of the conversion affiliate."]}]]}] 17b2:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The ID of the seller in the merchant's internal system."}]]}] 17b3:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The business or legal name of the seller."}]]}] 17b4:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The URL of the website of the seller."}],"\n",["$","div","inlinealert-0",{"data-type":"warning","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMark","color":"var(--rui-color-warning)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"Restrictions:"}],["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["Must be a valid URI as defined by ",["$","a","a-0",{"href":"https://datatracker.ietf.org/doc/html/rfc3986","target":"_blank","rel":"noreferrer","children":"RFC 3986"}]]}],"\n",["$","li","li-1",{"children":["URI scheme is required and must be either ",["$","code","code-0",{"children":"http"}]," or ",["$","code","code-1",{"children":"https"}]]}],"\n",["$","li","li-2",{"children":["URI host is required and cannot be ",["$","code","code-0",{"children":"localhost"}]," or an IP address"]}],"\n",["$","li","li-3",{"children":["Max length: ",["$","code","code-0",{"children":"255"}]]}],"\n",["$","li","li-4",{"children":["Reserved or invalid characters must be percent-encoded (for example, use ",["$","code","code-0",{"children":"%20"}]," instead of a space)"]}],"\n"]}]]}]]}]]}] 17b5:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The phone number of the seller."}]]}] 17b6:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Primary address line."}]]}] 17b7:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Secondary address line, such as floor and apartment number."}]]}] 17b8:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"State or province of the address."}]]}] 17b9:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"City of the address."}]]}] 17ba:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"ISO 2-letter country code."}]]}] 17bb:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The subdivision code represents the state, province, or region within the country, following the ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_3166-2","target":"_blank","rel":"noreferrer","children":"ISO 3166-2"}]," standard. This code uniquely identifies subdivisions within a country."]}],"\n",["$","p","p-1",{"children":["For example, for London in the United Kingdom, use ",["$","code","code-0",{"children":"GB-LND"}],"."]}],"\n",["$","div","inlinealert-0",{"data-type":"warning","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMark","color":"var(--rui-color-warning)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["The parameter is required for countries listed on the ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_3166-2","target":"_blank","rel":"noreferrer","children":"ISO 3166-2"}]," page."]}]}]]}]]}] 17bc:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Postal code of the address."}]]}] 17bd:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Details of a physical address."}]]}] 17be:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Information about the crypto conversion affiliate."}],"\n",["$","p","p-1",{"children":"This should be provided when a customer completes a payment on a subseller's website rather than directly on the merchant's website, providing insight into the type of business conducted by the subseller."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"This needs to be provided only by crypto on-ramp providers for payments they are processing for conversion affiliates."}],["$","p","p-1",{"children":["For their own payments, ",["$","code","code-0",{"children":"seller"}]," can be omitted."]}]]}]]}]]}] 17bf:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object containing information about crypto transactions associated with the order."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"Processing crypto on-ramp transactions with Revolut has additional compliance requirements. Please reach out to your account executive for additional details."}],["$","p","p-1",{"children":["$","strong","strong-0",{"children":"Required data fields for crypto services:"}]}],"$L19f3",["$","p","p-2",{"children":"Note that these requirements can be extended on a case by case basis as decided by Revolut."}]]}]]}]]}] 17c0:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Type of the industry-specific data object, determining what additional data is expected."}],"\n",["$","p","p-1",{"children":"Available types:"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Object type","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"airline"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about a specific airline ticket purchase.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"car_rental"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about a car rental booking associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"crypto"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about crypto transactions associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"marketplace"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["This object is required by Mastercard and Visa for merchants operating as marketplaces under the ",["$","strong","strong-0",{"children":"Merchant Category Code (MCC):"}]," ",["$","code","code-0",{"children":"5262"}],". The marketplace object ensures compliance with the card schemes' regulations by providing detailed information about the subseller involved in the transaction."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-4",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"event"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about event ticket bookings associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-5",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"lodging"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about lodging bookings associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 17c1:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The ID of the seller in the merchant's internal system."}]]}] 17c2:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The business or legal name of the seller."}]]}] 17c3:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The URL of the website of the seller."}],"\n",["$","div","inlinealert-0",{"data-type":"warning","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMark","color":"var(--rui-color-warning)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"Restrictions:"}],["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["Must be a valid URI as defined by ",["$","a","a-0",{"href":"https://datatracker.ietf.org/doc/html/rfc3986","target":"_blank","rel":"noreferrer","children":"RFC 3986"}]]}],"\n",["$","li","li-1",{"children":["URI scheme is required and must be either ",["$","code","code-0",{"children":"http"}]," or ",["$","code","code-1",{"children":"https"}]]}],"\n",["$","li","li-2",{"children":["URI host is required and cannot be ",["$","code","code-0",{"children":"localhost"}]," or an IP address"]}],"\n",["$","li","li-3",{"children":["Max length: ",["$","code","code-0",{"children":"255"}]]}],"\n",["$","li","li-4",{"children":["Reserved or invalid characters must be percent-encoded (for example, use ",["$","code","code-0",{"children":"%20"}]," instead of a space)"]}],"\n"]}]]}]]}]]}] 17c4:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The phone number of the seller."}]]}] 17c5:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Details of a physical address."}]]}] 17c6:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Information about the subseller on the marketplace platform."}]]}] 17c7:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["This object is required by Mastercard and Visa for merchants operating as marketplaces under the Merchant Category Code (MCC) ",["$","code","code-0",{"children":"5262"}],". The marketplace object ensures compliance with the card schemes' regulations by providing detailed information about the seller involved in the transaction."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"These are the specific data field requirements for merchants who must provide marketplace data."}],"$L19f4"]}]]}]]}] 17c8:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Type of the industry-specific data object, determining what additional data is expected."}],"\n",["$","p","p-1",{"children":"Available types:"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Object type","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"airline"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about a specific airline ticket purchase.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"car_rental"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about a car rental booking associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"crypto"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about crypto transactions associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"marketplace"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["This object is required by Mastercard and Visa for merchants operating as marketplaces under the ",["$","strong","strong-0",{"children":"Merchant Category Code (MCC):"}]," ",["$","code","code-0",{"children":"5262"}],". The marketplace object ensures compliance with the card schemes' regulations by providing detailed information about the subseller involved in the transaction."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-4",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"event"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about event ticket bookings associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-5",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"lodging"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about lodging bookings associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 17c9:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A unique identifier provided by the merchant associated with the order."}],"\n",["$","p","p-1",{"children":["This ",["$","code","code-0",{"children":"booking_id"}]," is used to reference and correlate booking information with the Merchant API and the merchant's internal system."]}]]}] 17ca:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":[["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_8601","target":"_blank","rel":"noreferrer","children":"ISO 8601"}]," date and time when the event starts."]}]]}] 17cb:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":[["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_8601","target":"_blank","rel":"noreferrer","children":"ISO 8601"}]," date and time when the event ends."]}]]}] 17cc:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Legal name of the ticket vendor/event organiser."}]]}] 17cd:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":[["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_8601","target":"_blank","rel":"noreferrer","children":"ISO 8601"}]," date and time when the funds are released to merchants."]}]]}] 17ce:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The name of the event."}]]}] 17cf:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Primary address line."}]]}] 17d0:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Secondary address line, such as floor and apartment number."}]]}] 17d1:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"State or province of the address."}]]}] 17d2:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"City of the address."}]]}] 17d3:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"ISO 2-letter country code."}]]}] 17d4:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Postal code of the address."}]]}] 17d5:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The address of the event location."}]]}] 17d6:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of the event."}]]}] 17d7:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Indicates the relationship between the ticket vendor and the event organiser."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Parameter value","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"primary"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The merchant is the organiser and primary distributor of the tickets.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"secondary"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The merchant is a reseller, only distributing the tickets.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 17d8:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A unique identifier provided by the merchant associated with the ticket."}]]}] 17d9:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Indicates whether the ticket is transferable to another buyer."}]]}] 17da:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Parameter indicating whether the booking is refundable, partially refundable, or not refundable."}]]}] 17db:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object containing information about a ticket associated with the booking."}]]}] 17dc:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A list of tickets associated with the booking."}]]}] 17dd:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object containing booking information about a specific event."}]]}] 17de:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A list of events associated with the booking."}]]}] 17df:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object containing booking information for a list of event tickets associated with the order."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"These are the specific data field requirements for merchants who must provide event data. Note that these requirements can be extended on a case by case basis as decided by Revolut."}],"$L19f5"]}]]}]]}] 17e0:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Type of the industry-specific data object, determining what additional data is expected."}],"\n",["$","p","p-1",{"children":"Available types:"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Object type","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"airline"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about a specific airline ticket purchase.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"car_rental"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about a car rental booking associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"crypto"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about crypto transactions associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"marketplace"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["This object is required by Mastercard and Visa for merchants operating as marketplaces under the ",["$","strong","strong-0",{"children":"Merchant Category Code (MCC):"}]," ",["$","code","code-0",{"children":"5262"}],". The marketplace object ensures compliance with the card schemes' regulations by providing detailed information about the subseller involved in the transaction."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-4",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"event"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about event ticket bookings associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-5",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"lodging"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about lodging bookings associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 17e1:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A unique identifier provided by the merchant associated with the order."}],"\n",["$","p","p-1",{"children":["This ",["$","code","code-0",{"children":"booking_id"}]," is used to reference and correlate booking information with the Merchant API and the merchant's internal system."]}]]}] 17e2:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":[["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_8601","target":"_blank","rel":"noreferrer","children":"ISO 8601"}]," date and time of the check-in."]}]]}] 17e3:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":[["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_8601","target":"_blank","rel":"noreferrer","children":"ISO 8601"}]," date and time of the check-out."]}]]}] 17e4:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":[["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_8601","target":"_blank","rel":"noreferrer","children":"ISO 8601"}]," date and time when the funds are released to merchants."]}]]}] 17e5:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of the accommodation associated with the booking."}]]}] 17e6:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Indicates whether the booking terms are fixed or flexible."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Parameter value","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"fixed"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Non-modifiable once confirmed.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"flexible"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Allows modifications or cancellations under specified conditions.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 17e7:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Parameter indicating whether the booking is refundable, partially refundable, or not refundable."}]]}] 17e8:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Primary address line."}]]}] 17e9:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Secondary address line, such as floor and apartment number."}]]}] 17ea:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"State or province of the address."}]]}] 17eb:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"City of the address."}]]}] 17ec:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"ISO 2-letter country code."}]]}] 17ed:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Postal code of the address."}]]}] 17ee:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Address of the accommodation."}]]}] 17ef:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Guest's first name."}]]}] 17f0:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Guest's last name."}]]}] 17f1:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"List of guests associated with the booking."}]]}] 17f2:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object containing details of a lodging booking."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"These are the specific data field requirements for merchants who must provide lodging data. Note that these requirements can be extended on a case by case basis as decided by Revolut."}],"$L19f6"]}]]}]]}] 17f3:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object containing industry-specific information associated with the order."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"In the following cases, industry-specific info is required. Omitting this information may trigger additional scrutiny and risk mitigation actions by the Revolut risk team."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Transaction type","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Required for","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"airline"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Airlines and Online Travel Agencies (OTAs).","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"car_rental"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Car Rental Merchants and Online Travel Agencies (OTAs).","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"crypto"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Crypto merchants.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"marketplace"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Marketplace merchants.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-4",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"event"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Event ticket sellers.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-5",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"lodging"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Lodging providers.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}]]}]]}] 17f4:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The URL of the order stored in the merchant's order management system."}],"\n",["$","p","p-1",{"children":["This URL will be included in the order confirmation email for payments made via Revolut Pay. If specified, this URL will override the default link to the merchant's ",["$","strong","strong-0",{"children":"Business website"}]," configured in the Revolut Business account."]}],"\n",["$","div","inlinealert-0",{"data-type":"warning","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMark","color":"var(--rui-color-warning)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"Restrictions:"}],["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["Must be a valid URI as defined by ",["$","a","a-0",{"href":"https://datatracker.ietf.org/doc/html/rfc3986","target":"_blank","rel":"noreferrer","children":"RFC 3986"}]]}],"\n",["$","li","li-1",{"children":["URI scheme is required and must be either ",["$","code","code-0",{"children":"http"}]," or ",["$","code","code-1",{"children":"https"}]]}],"\n",["$","li","li-2",{"children":["URI host is required and cannot be ",["$","code","code-0",{"children":"localhost"}]," or an IP address"]}],"\n",["$","li","li-3",{"children":["Max length: ",["$","code","code-0",{"children":"2000"}]]}],"\n",["$","li","li-4",{"children":["Reserved or invalid characters must be percent-encoded (for example, use ",["$","code","code-0",{"children":"%20"}]," instead of a space)"]}],"\n"]}]]}]]}]]}] 17f5:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Merchant order ID for external reference."}],"\n",["$","p","p-1",{"children":"Use this field to set the ID that your own system can use to easily track orders."}]]}] 17f6:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object for providing additional information stored in the merchant's order management system."}]]}] 17f7:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The date and time in ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_8601","target":"_blank","rel":"noreferrer","children":"ISO 8601 format"}]," when the upcoming payment is scheduled to be executed."]}]]}] 17f8:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The unique ID of the customer's payment method used to complete the scheduled payment."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"For more information about operations related to customer's payment methods, see:"}],["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#retrieve-payment-method-list","target":"_blank","rel":"noreferrer","children":"Retrieve payment method list of a customer"}]}],"\n",["$","li","li-1",{"children":["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#retrieve-payment-method","target":"_blank","rel":"noreferrer","children":"Retrieve a customer's payment method"}]}],"\n",["$","li","li-2",{"children":["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#update-payment-method","target":"_blank","rel":"noreferrer","children":"Update a customer's payment method"}]}],"\n",["$","li","li-3",{"children":["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#delete-payment-method","target":"_blank","rel":"noreferrer","children":"Delete a customer's payment method"}]}],"\n"]}]]}]]}]]}] 17f9:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object containing information about upcoming payments associated with the order."}]]}] 17fa:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Link to a checkout page hosted by Revolut."}]]}] 17fb:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The URL your customer will be redirected to after a successful payment on the hosted checkout page (",["$","code","code-0",{"children":"checkout_url"}]," parameter's value of the order)."]}],"\n",["$","div","inlinealert-0",{"data-type":"warning","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMark","color":"var(--rui-color-warning)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"Restrictions:"}],["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["Must be a valid URI as defined by ",["$","a","a-0",{"href":"https://datatracker.ietf.org/doc/html/rfc3986","target":"_blank","rel":"noreferrer","children":"RFC 3986"}]]}],"\n",["$","li","li-1",{"children":["URI scheme is required and must be either ",["$","code","code-0",{"children":"http"}]," or ",["$","code","code-1",{"children":"https"}]]}],"\n",["$","li","li-2",{"children":["URI host is required and cannot be ",["$","code","code-0",{"children":"localhost"}]," or an IP address"]}],"\n",["$","li","li-3",{"children":["Max length: ",["$","code","code-0",{"children":"2000"}]]}],"\n",["$","li","li-4",{"children":["Reserved or invalid characters must be percent-encoded (for example, use ",["$","code","code-0",{"children":"%20"}]," instead of a space)"]}],"\n"]}]]}]]}],"\n",["$","div","inlinealert-1",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information on how to use the ",["$","code","code-0",{"children":"redirect_url"}],", see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/accept-payments/online-payments/hosted-checkout-page/api#custom-post-payment-redirection-optional","target":"_blank","rel":"noreferrer","children":"Custom redirection via the API"}]]}]}]]}]]}] 17fc:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Primary address line."}]]}] 17fd:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Secondary address line, such as floor and apartment number."}]]}] 17fe:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"State or province of the address."}]]}] 17ff:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"City of the address."}]]}] 1800:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"ISO 2-letter country code."}]]}] 1801:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Postal code of the address."}]]}] 1802:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Details of a physical address."}]]}] 1803:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Full name of the contact person."}]]}] 1804:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Email address of the contact person."}]]}] 1805:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Phone number of the contact person."}]]}] 1806:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Contact details for someone responsible for the shipment."}],"\n",["$","div","inlinealert-0",{"data-type":"warning","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMark","color":"var(--rui-color-warning)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["At least ",["$","code","code-0",{"children":"email"}]," or ",["$","code","code-1",{"children":"phone"}]," is required."]}]}]]}]]}] 1807:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Name of the company handling the shipment."}]]}] 1808:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unique tracking number for the shipment."}]]}] 1809:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Estimated delivery date and time for the shipment.\nThe time should also include the customer's timezone."}]]}] 180a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An HTTP/HTTPS URL where the shipment can be tracked."}],"\n",["$","div","inlinealert-0",{"data-type":"warning","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMark","color":"var(--rui-color-warning)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"Restrictions:"}],["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["Must be a valid URI as defined by ",["$","a","a-0",{"href":"https://datatracker.ietf.org/doc/html/rfc3986","target":"_blank","rel":"noreferrer","children":"RFC 3986"}]]}],"\n",["$","li","li-1",{"children":["URI scheme is required and must be either ",["$","code","code-0",{"children":"http"}]," or ",["$","code","code-1",{"children":"https"}]]}],"\n",["$","li","li-2",{"children":["URI host is required and cannot be ",["$","code","code-0",{"children":"localhost"}]," or an IP address"]}],"\n",["$","li","li-3",{"children":["Max length: ",["$","code","code-0",{"children":"2000"}]]}],"\n",["$","li","li-4",{"children":["Reserved or invalid characters must be percent-encoded (for example, use ",["$","code","code-0",{"children":"%20"}]," instead of a space)"]}],"\n"]}]]}]]}]]}] 180b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Details of an individual shipment."}]]}] 180c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"List of individual shipment details."}]]}] 180d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Details about the shipping related to the order, including address, contact information, and individual shipments."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":"Required for merchants shipping physical goods. Omitting this information may trigger additional scrutiny and risk mitigation actions by Revolut."}]}]]}]]}] 180e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The enforce challenge mode. ",["$","code","code-0",{"children":"automatic"}]," is used by default."]}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Parameter value","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"automatic"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The payments created for an order will have challenge requirement calculated by our fraud mechanisms. Not all payments will trigger a 3DS challenge.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"forced"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The payments created for an order will always require a 3DS challenge. Currently only supported for card payments.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 180f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An array of line items included in the order. Each line item represents an individual product or service, along with its quantity, price, taxes, and discounts."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":"Required for merchants collecting payment for one or multiple products/services in one transaction. Omitting this information may trigger additional scrutiny and risk mitigation actions by Revolut."}]}]]}]]}] 1811:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"You can set a dynamic statement descriptor for your orders by providing a custom suffix."}],"\n",["$","p","p-1",{"children":"A statement descriptor is the text shown on cardholders' bank or card statements, helping them recognise a transaction or merchant. This field can be used to send extra information with the statement descriptor for card transactions."}],"\n",["$","p","p-2",{"children":["The complete descriptor is built using the following format: ",["$","code","code-0",{"children":"{base}*{suffix}"}],", where:"]}],"\n",["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":[["$","strong","strong-0",{"children":["$","code","code-0",{"children":"{base}"}]}]," is the existing descriptor configured in the Revolut Business dashboard (",["$","strong","strong-1",{"children":"Settings > Business account > Merchant profile > Statement descriptor"}],")."]}],"\n",["$","li","li-1",{"children":[["$","strong","strong-0",{"children":["$","code","code-0",{"children":"{suffix}"}]}]," is defined by the ",["$","code","code-0",{"children":"statement_descriptor_suffix"}]," field."]}],"\n"]}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["If the combined descriptor's length (base + suffix) exceeds the character limits of card scheme providers, the final value will be truncated. For example if the limit is 22 characters, the base descriptor is ",["$","code","code-0",{"children":"\"base\""}]," and the suffix is ",["$","code","code-1",{"children":"\"testdescriptorsuffix\""}],", the final descriptor becomes ",["$","code","code-2",{"children":"\"base*testdescriptorsuf\""}],"."]}],"\n",["$","li","li-1",{"children":"The final statement descriptor shown on a cardholder's statement may vary by issuing bank, as some banks apply their own custom formatting or truncation rules."}],"\n"]}]}]]}]]}] 1812:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The unique ID of the original order that was refunded and this refund is associated with. You can use this ID to get more information about the related order using the ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#retrieve-order","target":"_blank","rel":"noreferrer","children":"Retrieve an order"}]," operation."]}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["This field is only returned for orders with ",["$","code","code-0",{"children":"type: refund"}],"."]}]}]]}]]}] 1813:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unique identifier for the subscription."}]]}] 1814:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The unique identifier of the active (pre-paid) subscription cycle that this order collects payment for."}],"\n",["$","p","p-1",{"children":"This is the current billing cycle whose recurring charges are being collected in advance by this order. For example, if a subscription cycle covers 1-31 July and the order is generated on 1 July, this field identifies that July cycle."}]]}] 1815:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The unique identifier of the settled (post-paid) subscription cycle whose usage-based charges this order collects."}],"\n",["$","p","p-1",{"children":"This is the previous billing cycle whose usage is being settled by this order. For example, if a subscription cycle covers usage from 1-30 June and the order is generated on 10 July, this field identifies that June cycle."}]]}] 1816:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The reason this subscription order was created."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Value","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"cycle_billing"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["The order was automatically generated to collect payment for an ongoing subscription cycle. ",["$","code","code-0",{"children":"active_cycle_id"}]," is present; ",["$","code","code-1",{"children":"settled_cycle_id"}]," is present if the previous cycle included usage-based products."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"final_settlement"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["The order was automatically generated after the subscription ended to collect outstanding usage-based charges. ",["$","code","code-0",{"children":"active_cycle_id"}]," is absent; ",["$","code","code-1",{"children":"settled_cycle_id"}]," is present."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"setup_intent"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["The order was manually created by the merchant or customer to update the payment method on file. ",["$","code","code-0",{"children":"active_cycle_id"}]," is absent; ",["$","code","code-1",{"children":"settled_cycle_id"}]," is absent."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 1817:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Subscription details linked to the order. Use this object to match an order with its underlying subscription and understand the billing context in which the order was created."}],"\n",["$","p","p-1",{"children":"Only present on orders created by a subscription."}]]}] 1818:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["To process the order from a credit or debit card, you create an ",["$","code","code-0",{"children":"Order"}]," object. You can then retrieve, capture, cancel, refund, or pay an order using its unique ",["$","code","code-1",{"children":"id"}],". Alternatively, you can use its unique ",["$","code","code-2",{"children":"token"}]," to process a card payment with the Revolut Checkout Widget."]}]]}] 1819:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Order captured"}]]}] 181a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An identifier that can be used to determine what went wrong."}],"\n",["$","p","p-1",{"children":"Error codes are not globally unique, but uniqueness is guaranteed within endpoints."}]]}] 181b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Some human readable text describing what went wrong."}]]}] 181c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://www.unixtimestamp.com/","target":"_blank","rel":"noreferrer","children":"UNIX timestamp"}]," of the date and time the error happened."]}]]}] 181d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Bad Request"}]]}] 181e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An identifier that can be used to determine what went wrong."}],"\n",["$","p","p-1",{"children":"Error codes are not globally unique, but uniqueness is guaranteed within endpoints."}]]}] 181f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Some human readable text describing what went wrong."}]]}] 1820:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://www.unixtimestamp.com/","target":"_blank","rel":"noreferrer","children":"UNIX timestamp"}]," of the date and time the error happened."]}]]}] 1821:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unauthorized"}]]}] 1822:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An identifier that can be used to determine what went wrong."}],"\n",["$","p","p-1",{"children":"Error codes are not globally unique, but uniqueness is guaranteed within endpoints."}]]}] 1823:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Some human readable text describing what went wrong."}]]}] 1824:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://www.unixtimestamp.com/","target":"_blank","rel":"noreferrer","children":"UNIX timestamp"}]," of the date and time the error happened."]}]]}] 1825:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Not Found"}]]}] 1826:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Specify an amount to capture, in minor currency units. The amount must not exceed the authorised amount."}],"\n",["$","p","p-1",{"children":"An order can only be captured once. Partial capture is supported by sending an amount lower than the authorised amount. The uncaptured amount will be voided."}],"\n",["$","p","p-2",{"children":"If you resend a capture request for an order that is already captured, no additional capture is performed. Resending with the same amount returns the current order state, while resending with a different amount returns an error."}],"\n",["$","p","p-3",{"children":"If not provided, it defaults to the authorised amount (full capture will be executed)."}]]}] 1827:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Name of the line item."}]]}] 1828:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Type of the line item."}]]}] 1829:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The number of units of the line item."}]]}] 182a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The measurement unit for the quantity, such as ",["$","code","code-0",{"children":"cm"}],", or ",["$","code","code-1",{"children":"kg"}],"."]}]]}] 182b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object representing the quantity details of a line item, including the amount and its associated unit of measurement."}]]}] 182c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The unit price of the line item."}]]}] 182d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The total amount to be paid for the line item, including taxes and discounts."}]]}] 182e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unique identifier of line item in the merchant's system."}]]}] 182f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The specific name or label of the discount applied to the line item."}]]}] 1830:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The monetary value of the discount."}]]}] 1831:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Details of a discount applied to the line item, including its name and monetary value."}]]}] 1832:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A list of discounts applied to the line item. Each discount should be subtracted from the total amount payable for the item."}]]}] 1833:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The specific name or designation of the tax applied to the line item."}]]}] 1834:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The monetary value of the tax in minor currency units (e.g., cents for EUR)."}]]}] 1835:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Details about a tax applied to the line item, including its name and the corresponding amount."}]]}] 1836:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A list of taxes applied to the line item. Each tax should be added to the total amount payable for the item."}]]}] 1837:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"URL to an image associated with the line item."}],"\n",["$","div","inlinealert-0",{"data-type":"warning","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMark","color":"var(--rui-color-warning)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"Restrictions:"}],["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["Must be a valid URI as defined by ",["$","a","a-0",{"href":"https://datatracker.ietf.org/doc/html/rfc3986","target":"_blank","rel":"noreferrer","children":"RFC 3986"}]]}],"\n",["$","li","li-1",{"children":["URI scheme is required and must be either ",["$","code","code-0",{"children":"http"}]," or ",["$","code","code-1",{"children":"https"}]]}],"\n",["$","li","li-2",{"children":["URI host is required and cannot be ",["$","code","code-0",{"children":"localhost"}]," or an IP address"]}],"\n",["$","li","li-3",{"children":["Max length: ",["$","code","code-0",{"children":"2000"}]]}],"\n",["$","li","li-4",{"children":["Reserved or invalid characters must be percent-encoded (for example, use ",["$","code","code-0",{"children":"%20"}]," instead of a space)"]}],"\n"]}]]}]]}]]}] 1838:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A list of URLs pointing to images related to the line item. These images can provide visual details or representations of the item."}]]}] 1839:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Description of the line item."}]]}] 183a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An HTTP/HTTPS URL that links to more information about the line item, such as a product page or details."}],"\n",["$","div","inlinealert-0",{"data-type":"warning","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMark","color":"var(--rui-color-warning)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"Restrictions:"}],["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["Must be a valid URI as defined by ",["$","a","a-0",{"href":"https://datatracker.ietf.org/doc/html/rfc3986","target":"_blank","rel":"noreferrer","children":"RFC 3986"}]]}],"\n",["$","li","li-1",{"children":["URI scheme is required and must be either ",["$","code","code-0",{"children":"http"}]," or ",["$","code","code-1",{"children":"https"}]]}],"\n",["$","li","li-2",{"children":["URI host is required and cannot be ",["$","code","code-0",{"children":"localhost"}]," or an IP address"]}],"\n",["$","li","li-3",{"children":["Max length: ",["$","code","code-0",{"children":"2000"}]]}],"\n",["$","li","li-4",{"children":["Reserved or invalid characters must be percent-encoded (for example, use ",["$","code","code-0",{"children":"%20"}]," instead of a space)"]}],"\n"]}]]}]]}]]}] 183b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An array of line items included in the order. Each line item represents an individual product or service, along with its quantity, price, taxes, and discounts."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":"Required for merchants collecting payment for one or multiple products/services in one transaction. Omitting this information may trigger additional scrutiny and risk mitigation actions by Revolut."}]}]]}]]}] 183c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Order capture request parameters."}],"\n",["$","p","p-1",{"children":"You can optionally provide line items when capturing an order. This is useful when you need to adjust the final order details at capture time (for example, when doing partial captures with specific items, or when the final delivered items differ from the initial authorisation)."}],"\n",["$","div","inlinealert-0",{"data-type":"warning","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMark","color":"var(--rui-color-warning)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["If you provide ",["$","code","code-0",{"children":"line_items"}]," when capturing, they will ",["$","strong","strong-0",{"children":"overwrite"}]," the original line items that were provided during order creation or update. Make sure to include all the items you want to be associated with the captured order."]}]}]]}]]}] 1840:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"This endpoint is used to capture the funds of an existing, uncaptured order. When the payment for an order is authorised, you can capture the order to send it to the processing stage."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information about the order and payment lifecycle, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/reference/order-lifecycle","target":"_blank","rel":"noreferrer","children":"Order and payment\nlifecycle"}],"."]}]}]]}],"\n",["$","h3","h3-0",{"children":"Capture modes"}],"\n",["$","p","p-1",{"children":["When you ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant/2025-10-16#create-order","target":"_blank","rel":"noreferrer","children":"create an order"}],", you can choose one of the following capture modes:"]}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":["$","strong","strong-0",{"children":"Capture mode"}],"className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":["$","strong","strong-0",{"children":"Description"}],"className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"automatic"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The order is captured automatically after payment authorisation. No further actions are needed.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"manual"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["The order is not captured automatically and stays in ",["$","code","code-0",{"children":"authorised"}]," state. You must manually capture the order using the steps outlined below."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}],"\n",["$","div","inlinealert-1",{"data-type":"warning","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMark","color":"var(--rui-color-warning)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":["By default, uncaptured orders with ",["$","strong","strong-0",{"children":"final authorisation"}]," (",["$","code","code-0",{"children":"authorisation_type: final"}],") remain in ",["$","code","code-1",{"children":"authorised"}]," state for ",["$","strong","strong-1",{"children":"7 days"}],". If not captured within this period, the funds are returned to the customer's original payment method."]}],["$","p","p-1",{"children":"The capture deadline can be customised:"}],["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["Use ",["$","code","code-0",{"children":"cancel_authorised_after"}]," parameter when creating an order to set a custom expiry period"]}],"\n",["$","li","li-1",{"children":["The effective deadline is the earlier of ",["$","code","code-0",{"children":"cancel_authorised_after"}]," and the card/network clearing window"]}],"\n",["$","li","li-2",{"children":[["$","code","code-0",{"children":"capture_deadline"}]," is set when the order becomes ",["$","code","code-1",{"children":"authorised"}]," and doesn't change afterwards"]}],"\n",["$","li","li-3",{"children":["Use ",["$","strong","strong-0",{"children":"pre-authorisation"}]," (",["$","code","code-0",{"children":"authorisation_type: pre_authorisation"}],") for extended clearing windows (up to 30 days) and incremental authorisation support (see tip below)"]}],"\n"]}]]}]]}],"\n",["$","div","inlinealert-2",{"data-type":"tip","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":"$L19f7"}],"$L19f8","$L19f9"]}],"\n","$L19fa","\n","$L19fb","\n\n\n\n\n\n\n\n\n\n\n\n\n\n","$L19fc","\n","$L19fd","\n","$L19fe","\n","$L19ff","\n","$L1a00","\n","$L1a01","\n","$L1a02","\n","$L1a03","\n","$L1a04","\n","$L1a05","\n","$L1a06","\n","$L1a07","\n","$L1a08","\n","$L1a09"]}] 1841:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["This parameter accepts the ",["$","a","a-0",{"href":"https://business.revolut.com/settings/apis?tab=merchant-api","target":"_blank","rel":"noreferrer","children":"Merchant API Secret key"}]," to authorise requests coming from the merchant's backend."]}],"\n",["$","p","p-1",{"children":["It ensures that ensures that each request is authenticated and authorised by verifying the secret key. The secret key should be included in all request headers as a ",["$","code","code-0",{"children":"Bearer"}]," token."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#authentication","target":"_blank","rel":"noreferrer","children":"Authentication"}]]}]}]]}]]}] 1842:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The version of the Merchant API, specified in ",["$","code","code-0",{"children":"YYYY-MM-DD"}]," format."]}],"\n",["$","p","p-1",{"children":"If not specified, you will receive an error."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information about API versioning, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/reference/versioning/api-versions","target":"_blank","rel":"noreferrer","children":"API versions"}],"."]}]}]]}]]}] 1843:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A UUID string, typically used to identify resources."}]]}] 1844:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ID of the ",["$","code","code-0",{"children":"Order"}]," object."]}]]}] 1854:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Permanent order ID used to retrieve, capture, cancel, or refund an order after authorization."}]]}] 1855:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Temporary ID for the order, which expires when the payment is authorised."}],"\n",["$","p","p-1",{"children":["The order ",["$","code","code-0",{"children":"token"}]," is used for ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/sdks/merchant-web-sdk/initialisation/token-based","target":"_blank","rel":"noreferrer","children":"token-based initialisation"}],", and is returned by the ",["$","code","code-1",{"children":"createOrder"}]," callback in the following payment methods:"]}],"\n",["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["$","a","a-0",{"href":"https://developer.revolut.com/docs/sdks/merchant-web-sdk/payment-methods/embedded-checkout#embedded-checkout-options-interface","target":"_blank","rel":"noreferrer","children":"Embedded Checkout"}]}],"\n",["$","li","li-1",{"children":["$","a","a-0",{"href":"https://developer.revolut.com/docs/sdks/merchant-web-sdk/payment-methods/revolut-pay#widget-payments-revolut-pay-options","target":"_blank","rel":"noreferrer","children":"Revolut Pay"}]}],"\n",["$","li","li-2",{"children":["$","a","a-0",{"href":"https://developer.revolut.com/docs/sdks/merchant-web-sdk/payment-methods/apple-pay-google-pay#payment-request-options-interface","target":"_blank","rel":"noreferrer","children":"Apple Pay and Google Pay"}]}],"\n",["$","li","li-3",{"children":["$","a","a-0",{"href":"https://developer.revolut.com/docs/sdks/merchant-web-sdk/payment-methods/pay-by-bank#pay-by-bank-options-interface","target":"_blank","rel":"noreferrer","children":"Pay by Bank"}]}],"\n"]}]]}] 1856:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of the order."}]]}] 1857:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The state of the order in its lifecycle."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"State","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"pending"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Order created, awaiting payment","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"processing"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Payment is being processed","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"authorised"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Payment authorised but not yet captured (for manual capture)","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"completed"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Payment successfully captured and settled","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-4",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"cancelled"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Order was cancelled","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-5",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"failed"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Payment failed","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/reference/order-lifecycle","target":"_blank","rel":"noreferrer","children":"Order and payment lifecycle"}]]}]}]]}]]}] 1858:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The date and time the order was created."}]]}] 1859:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The date and time the order was last updated."}]]}] 185a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The description of the order."}]]}] 185b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The capture mode of the order. ",["$","code","code-0",{"children":"automatic"}]," is used by default."]}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Parameter value","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"automatic"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The order is captured automatically after payment authorisation.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"manual"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The order is not captured automatically. You must manually capture the order later.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information, see ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#capture-order","target":"_blank","rel":"noreferrer","children":"Capture an order"}],"."]}]}]]}]]}] 19eb:["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#cancel-order","target":"_blank","rel":"noreferrer","children":"Cancel the order"}] 19ec:["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#cancel-order","target":"_blank","rel":"noreferrer","children":"Cancel the order"}] 19ed:["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#cancel-order","target":"_blank","rel":"noreferrer","children":"Cancel the order"}] 19ee:["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#cancel-order","target":"_blank","rel":"noreferrer","children":"Cancel the order"}] 19ef:["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#cancel-order","target":"_blank","rel":"noreferrer","children":"Cancel the order"}] 19f7:["$","$L73",null,{"name":"Lightbulb","color":"var(--rui-color-success)","inline":true}] 19f8:["$","div",null,{"className":"_25vm6y2","children":"Extended clearing windows"}] 19f9:["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["If your business requires longer authorisation hold periods (up to 30 days depending on card scheme and MCC), use ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/operations/capture-and-settlement/advanced-authorisation/pre-authorisation","target":"_blank","rel":"noreferrer","children":"pre-authorisation"}]," instead of standard authorisation. Pre-authorisation also supports ",["$","a","a-1",{"href":"https://developer.revolut.com/docs/guides/merchant/operations/capture-and-settlement/advanced-authorisation/incremental-authorisation","target":"_blank","rel":"noreferrer","children":"incremental authorisation"}]," for variable-amount scenarios."]}]}] 19fa:["$","h5","h5-0",{"children":"Manual capture"}] 19fb:["$","p","p-2",{"children":"To capture an order manually, use one of the following methods:"}] 19fc:["$","div","table-1",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":["$","strong","strong-0",{"children":"Web UI"}],"className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":["$","strong","strong-0",{"children":"Merchant API"}],"className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","ol","ol-0",{"children":[["$","li","li-0",{"children":["Log in to your ",["$","a","a-0",{"href":"https://business.revolut.com","target":"_blank","rel":"noreferrer","children":"Revolut Business portal"}],"."]}],["$","li","li-1",{"children":["Navigate to the ",["$","strong","strong-0",{"children":"Merchant"}]," tab on the dashboard, and click the ",["$","strong","strong-1",{"children":"See all"}]," button in the ",["$","strong","strong-2",{"children":"Transactions"}]," section."]}],["$","li","li-2",{"children":["Select an uncaptured payment, and click ",["$","strong","strong-0",{"children":"Capture"}],"."]}]]}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["Use the ",["$","code","code-0",{"children":"/capture"}]," endpoint."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt3","ref":"$undefined"}]]}]}] 19fd:["$","div","inlinealert-3",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information about manually capturing an order, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/operations/capture-and-settlement/capture-later","target":"_blank","rel":"noreferrer","children":"Authorise an amount to capture\nlater"}],"."]}]}]]}] 19fe:["$","h6","h6-0",{"children":"Partial capture"}] 19ff:["$","p","p-3",{"children":"You have the option to capture only a fraction of the full amount. In such cases, the uncaptured portion of the amount will be voided."}] 1a00:["$","div","inlinealert-4",{"data-type":"warning","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMark","color":"var(--rui-color-warning)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"The following limitations apply to manual captures:"}],["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":"An order can only be captured once"}],"\n",["$","li","li-1",{"children":"Captured amount can't exceed the authorised amount"}],"\n",["$","li","li-2",{"children":"On Web UI, only capturing full amount is possible"}],"\n",["$","li","li-3",{"children":[["$","code","code-0",{"children":"0"}]," amount captures are not allowed"]}],"\n",["$","li","li-4",{"children":"For partial captures, you can only resend the request with the initial amount"}],"\n"]}]]}]]}] 1a01:["$","h6","h6-1",{"children":"Updating line items at capture"}] 1a02:["$","p","p-4",{"children":["You can optionally provide ",["$","code","code-0",{"children":"line_items"}]," when capturing an order. This allows you to adjust the final order details at the time of capture, which is useful for scenarios such as:"]}] 1a03:["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":[["$","strong","strong-0",{"children":"Partial captures:"}]," Specify which items are being captured when capturing less than the full amount. Line items help accurately reflect which items were captured versus voided (see ",["$","a","a-0",{"href":"#partial-capture","children":"Partial capture"}]," above)."]}],"\n",["$","li","li-1",{"children":[["$","strong","strong-0",{"children":"Final adjustments:"}]," Update order details when the delivered items differ from the initial authorisation (e.g., out-of-stock items, substitutions, quantity changes)."]}],"\n"]}] 1a04:["$","div","inlinealert-5",{"data-type":"warning","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMark","color":"var(--rui-color-warning)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["If you provide ",["$","code","code-0",{"children":"line_items"}]," when capturing, they will ",["$","strong","strong-0",{"children":"overwrite"}]," the original line items provided during order creation or update. Ensure you include all items you want associated with the captured order."]}]}]]}] 1a05:["$","div","inlinealert-6",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For a comprehensive guide including use cases and examples, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/operations/capture-and-settlement/capture-later#update-line-items-at-capture","target":"_blank","rel":"noreferrer","children":"Authorise a payment to capture later"}],"."]}]}]]}] 1a06:["$","h4","h4-0",{"children":"Idempotency and repeated requests"}] 1a07:["$","p","p-5",{"children":"The capture operation is idempotent. This means that an order can only be captured once. If you send a capture request more than once:"}] 1a08:["$","ul","ul-1",{"children":["\n",["$","li","li-0",{"children":"The first valid request captures the order and moves it to the processing stage."}],"\n",["$","li","li-1",{"children":["Any subsequent request with the same capture amount will not recapture funds and behaves like a ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant/2025-10-16#retrieve-order","target":"_blank","rel":"noreferrer","children":"Retrieve an order"}]," request, returning the current order state."]}],"\n",["$","li","li-2",{"children":"A subsequent request with a different capture amount returns an error."}],"\n"]}] 1a09:["$","div","inlinealert-7",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":"Utilising the idempotent nature of this endpoint helps maintain data consistency and prevents duplicate processing of the same order."}]}]]}] 19c4:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Each Merchant API request must contain an authorization header in the following format:"}],"\n","$L1a0a","\n",["$","p","p-1",{"children":"To use this API, you need to generate API keys from your Revolut Business account. The Secret key is used in the authorization header for all server calls, while the Public key is provided with payment methods at checkout."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For detailed instructions on generating your API keys, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/get-started#generate-api-keys","target":"_blank","rel":"noreferrer","children":"Generate API keys"}],"."]}]}]]}]]}] 185c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The type of authorisation for the order. Used with manual capture mode. If omitted, ",["$","code","code-0",{"children":"final"}]," is used by default."]}],"\n",["$","h1","h1-0",{"children":"Pre-authorisation"}],"\n",["$","p","p-1",{"children":"Pre-authorisation allows you to reserve funds on a customer's card without immediately capturing them. This is useful for scenarios like:"}],"\n",["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":"Hotel bookings where the final amount may vary"}],"\n",["$","li","li-1",{"children":"Car rentals where additional charges may apply"}],"\n",["$","li","li-2",{"children":"Deposits that need to be held temporarily"}],"\n"]}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Parameter value","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"final"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Standard authorisation for immediate or near-immediate capture.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"pre_authorisation"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Reserve funds for later capture, used with manual capture mode.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["Pre-authorisation must be used with ",["$","code","code-0",{"children":"capture_mode: manual"}],". For more information, see ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#capture-order","target":"_blank","rel":"noreferrer","children":"Capture an order"}],"."]}]}]]}]]}] 185e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["Automatic cancellation period for uncaptured orders, specified in ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_8601","target":"_blank","rel":"noreferrer","children":"ISO 8601"}]," format."]}],"\n",["$","p","p-1",{"children":["After this period, the authorised payment is automatically cancelled and the order is cancelled. Maximum: 7 days = ",["$","code","code-0",{"children":"P7D"}],"."]}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"The following limitations apply:"}],["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["\n",["$","p","p-0",{"children":"Cannot be a negative value."}],"\n"]}],"\n",["$","li","li-1",{"children":["\n",["$","p","p-0",{"children":"Cannot be updated if the new value is less than or equal to the elapsed time since authorisation."}],"\n",["$","p","p-1",{"children":["$","strong","strong-0",{"children":"Failing scenario:"}]}],"\n",["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":"Original value: 7 days"}],"\n",["$","li","li-1",{"children":"Time since authorisation: 3 days"}],"\n",["$","li","li-2",{"children":"Update value: 2 days"}],"\n"]}],"\n",["$","p","p-2",{"children":"In this scenario, an error is returned."}],"\n",["$","p","p-3",{"children":["$","strong","strong-0",{"children":"Successful scenario:"}]}],"\n",["$","ul","ul-1",{"children":["\n",["$","li","li-0",{"children":"Original value: 7 days"}],"\n",["$","li","li-1",{"children":"Time since authorisation: 3 days"}],"\n",["$","li","li-2",{"children":"Update value: 4 days"}],"\n"]}],"\n",["$","p","p-4",{"children":"In this scenario, the parameter can be updated."}],"\n"]}],"\n",["$","li","li-2",{"children":["\n",["$","p","p-0",{"children":"Cannot be updated if cancellation is ≤ 30 minutes away."}],"\n",["$","p","p-1",{"children":["$","strong","strong-0",{"children":"Failing scenario:"}]}],"\n",["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":"Original value: 12 hours"}],"\n",["$","li","li-1",{"children":"Time since authorisation: 11 hours 40 minutes"}],"\n"]}],"\n",["$","p","p-2",{"children":"In this scenario, an error is returned."}],"\n",["$","p","p-3",{"children":["$","strong","strong-0",{"children":"Successful scenario:"}]}],"\n",["$","ul","ul-1",{"children":["\n",["$","li","li-0",{"children":"Original value: 12 hours"}],"\n",["$","li","li-1",{"children":"Time since authorisation: 11 hours 20 minutes"}],"\n"]}],"\n",["$","p","p-4",{"children":"In this scenario, the parameter can be updated."}],"\n"]}],"\n"]}]]}]]}]]}] 185f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The order total expressed in minor currency units, according to the ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_4217","target":"_blank","rel":"noreferrer","children":"ISO 4217 standard"}],". For example, ",["$","code","code-0",{"children":"7034"}]," in ",["$","code","code-1",{"children":"EUR"}]," corresponds to €70.34."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["Conversion between major and minor units varies by currency. For instance, ",["$","code","code-0",{"children":"100"}]," minor units equal £1.00 in ",["$","code","code-1",{"children":"GBP"}],", whereas in ",["$","code","code-2",{"children":"ISK"}]," they represent 100 units. For more details, see the ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_4217","target":"_blank","rel":"noreferrer","children":"ISO 4217 standard"}],"."]}],"\n",["$","li","li-1",{"children":["If ",["$","code","code-0",{"children":"line_items"}]," are provided, the order ",["$","code","code-1",{"children":"amount"}]," must equal the sum of all line items' ",["$","code","code-2",{"children":"total_amount"}],"."]}],"\n",["$","li","li-2",{"children":["For card payments with a non-zero amount, the order ",["$","code","code-0",{"children":"amount"}]," must be at least ",["$","strong","strong-0",{"children":"$$0.005"}]," (or equivalent in different currencies, calculated using Revolut's exchange rate on the payment date). Otherwise, card payments can't be performed."]}],"\n"]}]}]]}]]}] 1860:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The amount not yet paid for a given order (in minor currency units). For example, ",["$","code","code-0",{"children":"7034"}]," represents €70.34."]}],"\n",["$","p","p-1",{"children":["The value in this field may differ from ",["$","code","code-0",{"children":"amount"}]," if there are partial payments associated with the order."]}]]}] 1861:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The amount that was refunded from the order (in minor currency units). For example, ",["$","code","code-0",{"children":"7034"}]," represents €70.34."]}],"\n",["$","p","p-1",{"children":["This applies to orders that have been refunded (i.e., orders of type ",["$","code","code-0",{"children":"payment"}]," that have a related ",["$","code","code-1",{"children":"refund"}]," order)."]}]]}] 1862:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":[["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_4217","target":"_blank","rel":"noreferrer","children":"ISO 4217"}]," currency code in upper case."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information about the supported currencies, see: ",["$","a","a-0",{"href":"https://help.revolut.com/business/help/merchant-accounts/payments/in-which-currencies-can-i-accept-payments/","target":"_blank","rel":"noreferrer","children":"Help Center"}],"."]}]}]]}]]}] 1863:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":[["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_4217","target":"_blank","rel":"noreferrer","children":"ISO 4217"}]," currency code in upper case."]}],"\n",["$","p","p-1",{"children":["If ",["$","code","code-0",{"children":"settlement_currency"}]," is different from the value of ",["$","code","code-1",{"children":"currency"}],", the money will be exchanged when the amount is settled to your merchant account. In case of a refund or chargeback, the money will be exchanged to the order's initial ",["$","code","code-2",{"children":"currency"}],"."]}],"\n",["$","p","p-2",{"children":["If ",["$","code","code-0",{"children":"settlement_currency"}]," is not specified, this value is taken from ",["$","code","code-1",{"children":"currency"}],"."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information about the supported currencies, see: ",["$","a","a-0",{"href":"https://help.revolut.com/business/help/merchant-accounts/payments/in-which-currencies-can-i-accept-payments/","target":"_blank","rel":"noreferrer","children":"Help Center"}],"."]}]}]]}]]}] 1865:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Permanent ID of a customer used to retrieve, update, delete a customer. This ID can also be used to link customer to an order."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":"If you provide the customer's ID during order creation, no other customer data is required, they will be parsed automatically from the referenced customer object."}]}]]}]]}] 1866:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The full name of the customer."}]]}] 1867:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The phone number of the customer in ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/E.164","target":"_blank","rel":"noreferrer","children":"E.164 format"}],"."]}]]}] 1868:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The email address of the customer."}]]}] 1869:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The birth date of the customer."}]]}] 186a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object containing information about a customer."}],"\n",["$","p","p-1",{"children":["If you have it, we strongly advise providing at least either ",["$","code","code-0",{"children":"id"}],", ",["$","code","code-1",{"children":"phone"}],", or ",["$","code","code-2",{"children":"email"}],"."]}],"\n",["$","p","p-2",{"children":["Using the ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#tag-customers","target":"_blank","rel":"noreferrer","children":"Customers operations"}],", you can manage customer instances."]}],"\n",["$","p","p-3",{"children":"The following behaviours apply to different use cases:"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Use case","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"API behavior","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":"Existing customer","className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["If ",["$","code","code-0",{"children":"id"}]," was provided, we ignore other customer details and associate the customer with the order.",["$","br","br-0",{}],["$","br","br-1",{}],"If either ",["$","code","code-1",{"children":"email"}],", ",["$","code","code-2",{"children":"phone"}],", or ",["$","code","code-3",{"children":"full_name"}]," was provided (without an existing customer's ",["$","code","code-4",{"children":"id"}],"), we always create a new customer, irrespective of another, existing customer object having the same details."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":"New customer","className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["If either ",["$","code","code-0",{"children":"email"}],", ",["$","code","code-1",{"children":"phone"}],", or ",["$","code","code-2",{"children":"full_name"}]," was provided, we create a new customer, irrespective of another customer object having the same details. ",["$","br","br-0",{}],["$","br","br-1",{}],"If ",["$","code","code-3",{"children":"id"}]," of a non-existent customer was provided, we return a ",["$","code","code-4",{"children":"404"}]," error, irrespective of other details provided."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["To avoid unintentional duplication of customer records, search for an existing customer by email or phone using the ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#retrieve-customer-list","target":"_blank","rel":"noreferrer","children":"List customers"}]," endpoint first, then provide ",["$","code","code-0",{"children":"customer.id"}]," in the order."]}]}]]}]]}] 186b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The ID of the payment."}]]}] 186c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The status of the payment."}]]}] 186d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The reason for a ",["$","code","code-0",{"children":"failed"}]," or ",["$","code","code-1",{"children":"declined"}]," payment."]}],"\n",["$","p","p-1",{"children":["A failed or declined payment can result from multiple reasons. To learn more, check our ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/reference/error-codes/decline-reasons","target":"_blank","rel":"noreferrer","children":"failure reasons"}],"."]}]]}] 186e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The reason for a ",["$","code","code-0",{"children":"failed"}]," or ",["$","code","code-1",{"children":"declined"}]," payment, sent by the financial institution processing the payment."]}]]}] 186f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The date and time the payment was created."}]]}] 1870:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The date and time the payment was last updated."}]]}] 1871:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Temporary token of the payment used to fetch the reward offer during checkout and link user registrations to the given offers."}],"\n",["$","p","p-1",{"children":"The token is only valid for a limited time."}]]}] 1872:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The payment amount in minor units (e.g., cents). The value of this field depends on the payment type and state."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Payment type","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"State","className":"eowryt6","ref":"$undefined"}],["$","th","th-2",{"children":"Amount value","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":"Standard payment","className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Any","className":"eowryt7","ref":"$undefined"}],["$","td","td-2",{"children":"Total payment amount","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":"Pre-authorised payment","className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["$","code","code-0",{"children":"authorisation_started"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-2",{"children":"New amount being authorised (during increment processing)","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":"Pre-authorised payment","className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["$","code","code-0",{"children":"authorised"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-2",{"children":["Currently authorised amount (equals ",["$","code","code-0",{"children":"authorised_amount"}],")"],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For pre-authorised payments, see the ",["$","code","code-0",{"children":"authorised_amount"}]," field for tracking the currently authorised amount separately."]}]}]]}]]}] 1873:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The currently authorised amount for this payment (in minor units)."}],"\n",["$","p","p-1",{"children":"For pre-authorised payments with incremental authorization:"}],"\n",["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["Initially equals the ",["$","code","code-0",{"children":"amount"}]," field"]}],"\n",["$","li","li-1",{"children":"Remains unchanged during increment processing"}],"\n",["$","li","li-2",{"children":"Updates to new amount upon successful increment"}],"\n",["$","li","li-3",{"children":"Remains at original amount if increment is declined"}],"\n"]}],"\n",["$","p","p-2",{"children":["For standard payments, this field may not be present or will equal the ",["$","code","code-0",{"children":"amount"}]," field."]}]]}] 1874:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":[["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_4217","target":"_blank","rel":"noreferrer","children":"ISO 4217"}]," currency code in upper case."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information about the supported currencies, see: ",["$","a","a-0",{"href":"https://help.revolut.com/business/help/merchant-accounts/payments/in-which-currencies-can-i-accept-payments/","target":"_blank","rel":"noreferrer","children":"Help Center"}],"."]}]}]]}]]}] 1875:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The amount of the settled payment (minor currency unit). For example, ",["$","code","code-0",{"children":"7034"}]," stands for €70.34."]}]]}] 1876:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The currency of the settled payment. ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_4217","target":"_blank","rel":"noreferrer","children":"ISO 4217"}]," currency code in upper case."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information about the supported currencies, see: ",["$","a","a-0",{"href":"https://help.revolut.com/business/help/merchant-accounts/payments/in-which-currencies-can-i-accept-payments/","target":"_blank","rel":"noreferrer","children":"Help Center"}],"."]}]}]]}]]}] 1877:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"ID of the saved payment method."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["The ",["$","code","code-0",{"children":"id"}]," parameter is only returned when the payment method is saved."]}]}]]}]]}] 1878:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of payment method used to pay for the order."}],"\n",["$","p","p-1",{"children":"Available values:"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":["Payment method ",["$","code","code-0",{"children":"type"}]],"className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"apple_pay"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using Apple Pay.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"card"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using their credit or debit card.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"google_pay"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using Google Pay.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"revolut_pay_card"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order via Revolut Pay using their credit or debit card.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-4",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"revolut_pay_account"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order via Revolut Pay using their Revolut account.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-5",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"sepa_direct_debit"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using SEPA Direct Debit.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 1879:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of the card."}]]}] 187a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of card funding."}]]}] 187b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The 2-letter country code of the country where the card was issued."}]]}] 187c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The BIN of the card."}]]}] 187d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The last four digits of the card number."}]]}] 187e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The expiry date of the card in the format of MM/YY."}]]}] 187f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The name of the cardholder."}]]}] 1880:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The Electronic Commerce Indicator (ECI) value corresponds to the authentication result and indicates the level of security used when the payment information was provided."}]]}] 1881:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The result of 3D Secure check."}]]}] 1882:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The 3D Secure version."}]]}] 1883:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The details of the 3D Secure check. Only for orders with successful payments."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":"Not returned for Apple Pay and Google Pay payments."}]}]]}]]}] 1884:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The result of CVV verification."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Parameter value","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"match"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"CVV matches the card's CVV","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"not_match"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"CVV does not match the card's CVV","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"incorrect"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"CVV format is incorrect for this type of card","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"not_processed"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"CVV verification was not performed","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 1885:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The result of address verification."}]]}] 1886:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The result of postcode verification."}]]}] 1887:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The result of cardholder verification."}]]}] 1888:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The details of the check for card payment. Only for orders with successful payments."}]]}] 1889:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The authorisation code (or auth code) is a short, alphanumeric code returned by the cardholder's issuing bank to the merchant's terminal or payment gateway."}],"\n",["$","p","p-1",{"children":"It serves as confirmation that the transaction has been approved and funds are available."}]]}] 188a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Acquirer Reference Number (ARN) of the payment."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":"Only returned for refund payments made by a card."}]}]]}]]}] 188b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The date and time by which the payment must be captured."}],"\n",["$","p","p-1",{"children":"After this deadline, the authorised funds may be automatically released by the card issuer."}]]}] 188c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The hardware identifier of the Revolut Terminal device used to process the payment."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":"Only present for card-present transactions processed via Revolut Terminal."}]}]]}]]}] 188e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A unique identifier for a payment method, always 44 characters long. This fingerprint can be used to uniquely identify various payment methods."}],"\n",["$","h1","h1-0",{"children":"Fingerprint generation"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Payment method","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","strong","strong-0",{"children":"All payment methods"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"A fingerprint is generated for all payment methods, including cards, Revolut Pay (card, account-to-account payments), Apple Pay, and Google Pay.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","strong","strong-0",{"children":"Cards (Revolut Pay & Card Gateway)"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"For cards, the fingerprint is based on the PAN. Cards processed via Revolut Pay and our card gateway will share the same fingerprint. Renewed cards (new expiry/CVV) retain the same fingerprint for efficient blocking.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","strong","strong-0",{"children":"Apple Pay & Google Pay"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Since Apple Pay and Google Pay provide us Device PANs (DPAN), the fingerprint is based on the DPAN provided by Apple/Google, not the connected card's PAN. This means that a new DPAN (and fingerprint) is generated for cards in case they are re-added to the customer's digital wallet, or added to different devices.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}],"\n",["$","h4","h4-0",{"children":"Detecting duplicate payment methods"}],"\n",["$","p","p-1",{"children":"Fingerprints are a valuable tool for detecting duplicate payment methods by identifying if a payment method has been seen before. This capability, in turn, helps in preventing various types of misuse (e.g., exploitation of free trials, or association with known problematic accounts, which can be a form of fraud). To effectively use fingerprints for this purpose, you will need to create and maintain your own lists (e.g., blocklists of known problematic fingerprints, allowlists for trusted customers, or tracking frequently used fingerprints)."}],"\n",["$","p","p-2",{"children":"The ideal way to utilise fingerprints is by combining them with a manual capture process. While automatic capture with subsequent refunds for problematic payments is possible, manual capture based on fingerprint validation is recommended."}],"\n",["$","p","p-3",{"children":"During your manual capture workflow, after a payment was authorised:"}],"\n",["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":"Check the fingerprint status by comparing it against your maintained lists and internal business rules."}],"\n",["$","li","li-1",{"children":["If you decide to proceed with the payment (e.g., the fingerprint is not on a blocklist, or matches a trusted customer's previous payment method): ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#capture-order","target":"_blank","rel":"noreferrer","children":"Capture the order"}],"."]}],"\n",["$","li","li-2",{"children":["If you decide not to proceed with the payment (e.g., the fingerprint matches a known fraudulent fingerprint, or exhibits suspicious patterns): ","$L1a0b","."]}],"\n"]}]]}] 188f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The Network Transaction ID (NTI) is a unique identifier assigned by the card scheme (e.g., Visa or Mastercard) to a card transaction."}],"\n",["$","p","p-1",{"children":"It can be used to trace the transaction across the payment network, link recurring or instalment payments to the original authorisation, and support dispute resolution."}]]}] 1890:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object containing details of a card used via Apple Pay."}]]}] 1891:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"ID of the saved payment method."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["The ",["$","code","code-0",{"children":"id"}]," parameter is only returned when the payment method is saved."]}]}]]}]]}] 1892:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of payment method used to pay for the order."}],"\n",["$","p","p-1",{"children":"Available values:"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":["Payment method ",["$","code","code-0",{"children":"type"}]],"className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"apple_pay"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using Apple Pay.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"card"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using their credit or debit card.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"google_pay"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using Google Pay.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"revolut_pay_card"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order via Revolut Pay using their credit or debit card.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-4",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"revolut_pay_account"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order via Revolut Pay using their Revolut account.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-5",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"sepa_direct_debit"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using SEPA Direct Debit.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 1893:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of the card."}]]}] 1894:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of card funding."}]]}] 1895:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The 2-letter country code of the country where the card was issued."}]]}] 1896:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The BIN of the card."}]]}] 1897:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The last four digits of the card number."}]]}] 1898:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The expiry date of the card in the format of MM/YY."}]]}] 1899:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The name of the cardholder."}]]}] 189a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The details of the check for card payment. Only for orders with successful payments."}]]}] 189b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The authorisation code (or auth code) is a short, alphanumeric code returned by the cardholder's issuing bank to the merchant's terminal or payment gateway."}],"\n",["$","p","p-1",{"children":"It serves as confirmation that the transaction has been approved and funds are available."}]]}] 189c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Acquirer Reference Number (ARN) of the payment."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":"Only returned for refund payments made by a card."}]}]]}]]}] 189d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The date and time by which the payment must be captured."}],"\n",["$","p","p-1",{"children":"After this deadline, the authorised funds may be automatically released by the card issuer."}]]}] 189e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The hardware identifier of the Revolut Terminal device used to process the payment."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":"Only present for card-present transactions processed via Revolut Terminal."}]}]]}]]}] 18a0:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A unique identifier for a payment method, always 44 characters long. This fingerprint can be used to uniquely identify various payment methods."}],"\n",["$","h1","h1-0",{"children":"Fingerprint generation"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Payment method","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","strong","strong-0",{"children":"All payment methods"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"A fingerprint is generated for all payment methods, including cards, Revolut Pay (card, account-to-account payments), Apple Pay, and Google Pay.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","strong","strong-0",{"children":"Cards (Revolut Pay & Card Gateway)"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"For cards, the fingerprint is based on the PAN. Cards processed via Revolut Pay and our card gateway will share the same fingerprint. Renewed cards (new expiry/CVV) retain the same fingerprint for efficient blocking.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","strong","strong-0",{"children":"Apple Pay & Google Pay"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Since Apple Pay and Google Pay provide us Device PANs (DPAN), the fingerprint is based on the DPAN provided by Apple/Google, not the connected card's PAN. This means that a new DPAN (and fingerprint) is generated for cards in case they are re-added to the customer's digital wallet, or added to different devices.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}],"\n",["$","h4","h4-0",{"children":"Detecting duplicate payment methods"}],"\n",["$","p","p-1",{"children":"Fingerprints are a valuable tool for detecting duplicate payment methods by identifying if a payment method has been seen before. This capability, in turn, helps in preventing various types of misuse (e.g., exploitation of free trials, or association with known problematic accounts, which can be a form of fraud). To effectively use fingerprints for this purpose, you will need to create and maintain your own lists (e.g., blocklists of known problematic fingerprints, allowlists for trusted customers, or tracking frequently used fingerprints)."}],"\n",["$","p","p-2",{"children":"The ideal way to utilise fingerprints is by combining them with a manual capture process. While automatic capture with subsequent refunds for problematic payments is possible, manual capture based on fingerprint validation is recommended."}],"\n",["$","p","p-3",{"children":"During your manual capture workflow, after a payment was authorised:"}],"\n",["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":"Check the fingerprint status by comparing it against your maintained lists and internal business rules."}],"\n",["$","li","li-1",{"children":["If you decide to proceed with the payment (e.g., the fingerprint is not on a blocklist, or matches a trusted customer's previous payment method): ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#capture-order","target":"_blank","rel":"noreferrer","children":"Capture the order"}],"."]}],"\n",["$","li","li-2",{"children":["If you decide not to proceed with the payment (e.g., the fingerprint matches a known fraudulent fingerprint, or exhibits suspicious patterns): ","$L1a0c","."]}],"\n"]}]]}] 18a1:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The Network Transaction ID (NTI) is a unique identifier assigned by the card scheme (e.g., Visa or Mastercard) to a card transaction."}],"\n",["$","p","p-1",{"children":"It can be used to trace the transaction across the payment network, link recurring or instalment payments to the original authorisation, and support dispute resolution."}]]}] 18a2:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object containing details of the card used for the payment."}]]}] 18a3:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"ID of the saved payment method."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["The ",["$","code","code-0",{"children":"id"}]," parameter is only returned when the payment method is saved."]}]}]]}]]}] 18a4:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of payment method used to pay for the order."}],"\n",["$","p","p-1",{"children":"Available values:"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":["Payment method ",["$","code","code-0",{"children":"type"}]],"className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"apple_pay"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using Apple Pay.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"card"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using their credit or debit card.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"google_pay"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using Google Pay.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"revolut_pay_card"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order via Revolut Pay using their credit or debit card.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-4",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"revolut_pay_account"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order via Revolut Pay using their Revolut account.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-5",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"sepa_direct_debit"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using SEPA Direct Debit.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 18a5:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of the card."}]]}] 18a6:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of card funding."}]]}] 18a7:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The 2-letter country code of the country where the card was issued."}]]}] 18a8:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The BIN of the card."}]]}] 18a9:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The last four digits of the card number."}]]}] 18aa:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The expiry date of the card in the format of MM/YY."}]]}] 18ab:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The name of the cardholder."}]]}] 18ac:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The details of the check for card payment. Only for orders with successful payments."}]]}] 18ad:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The authorisation code (or auth code) is a short, alphanumeric code returned by the cardholder's issuing bank to the merchant's terminal or payment gateway."}],"\n",["$","p","p-1",{"children":"It serves as confirmation that the transaction has been approved and funds are available."}]]}] 18ae:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Acquirer Reference Number (ARN) of the payment."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":"Only returned for refund payments made by a card."}]}]]}]]}] 18af:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The date and time by which the payment must be captured."}],"\n",["$","p","p-1",{"children":"After this deadline, the authorised funds may be automatically released by the card issuer."}]]}] 18b0:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The hardware identifier of the Revolut Terminal device used to process the payment."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":"Only present for card-present transactions processed via Revolut Terminal."}]}]]}]]}] 18b2:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A unique identifier for a payment method, always 44 characters long. This fingerprint can be used to uniquely identify various payment methods."}],"\n",["$","h1","h1-0",{"children":"Fingerprint generation"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Payment method","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","strong","strong-0",{"children":"All payment methods"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"A fingerprint is generated for all payment methods, including cards, Revolut Pay (card, account-to-account payments), Apple Pay, and Google Pay.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","strong","strong-0",{"children":"Cards (Revolut Pay & Card Gateway)"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"For cards, the fingerprint is based on the PAN. Cards processed via Revolut Pay and our card gateway will share the same fingerprint. Renewed cards (new expiry/CVV) retain the same fingerprint for efficient blocking.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","strong","strong-0",{"children":"Apple Pay & Google Pay"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Since Apple Pay and Google Pay provide us Device PANs (DPAN), the fingerprint is based on the DPAN provided by Apple/Google, not the connected card's PAN. This means that a new DPAN (and fingerprint) is generated for cards in case they are re-added to the customer's digital wallet, or added to different devices.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}],"\n",["$","h4","h4-0",{"children":"Detecting duplicate payment methods"}],"\n",["$","p","p-1",{"children":"Fingerprints are a valuable tool for detecting duplicate payment methods by identifying if a payment method has been seen before. This capability, in turn, helps in preventing various types of misuse (e.g., exploitation of free trials, or association with known problematic accounts, which can be a form of fraud). To effectively use fingerprints for this purpose, you will need to create and maintain your own lists (e.g., blocklists of known problematic fingerprints, allowlists for trusted customers, or tracking frequently used fingerprints)."}],"\n",["$","p","p-2",{"children":"The ideal way to utilise fingerprints is by combining them with a manual capture process. While automatic capture with subsequent refunds for problematic payments is possible, manual capture based on fingerprint validation is recommended."}],"\n",["$","p","p-3",{"children":"During your manual capture workflow, after a payment was authorised:"}],"\n",["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":"Check the fingerprint status by comparing it against your maintained lists and internal business rules."}],"\n",["$","li","li-1",{"children":["If you decide to proceed with the payment (e.g., the fingerprint is not on a blocklist, or matches a trusted customer's previous payment method): ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#capture-order","target":"_blank","rel":"noreferrer","children":"Capture the order"}],"."]}],"\n",["$","li","li-2",{"children":["If you decide not to proceed with the payment (e.g., the fingerprint matches a known fraudulent fingerprint, or exhibits suspicious patterns): ","$L1a0d","."]}],"\n"]}]]}] 18b3:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The Network Transaction ID (NTI) is a unique identifier assigned by the card scheme (e.g., Visa or Mastercard) to a card transaction."}],"\n",["$","p","p-1",{"children":"It can be used to trace the transaction across the payment network, link recurring or instalment payments to the original authorisation, and support dispute resolution."}]]}] 18b4:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object containing details of a card used via Google Pay."}]]}] 18b5:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"ID of the saved payment method."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["The ",["$","code","code-0",{"children":"id"}]," parameter is only returned when the payment method is saved."]}]}]]}]]}] 18b6:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of payment method used to pay for the order."}],"\n",["$","p","p-1",{"children":"Available values:"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":["Payment method ",["$","code","code-0",{"children":"type"}]],"className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"apple_pay"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using Apple Pay.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"card"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using their credit or debit card.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"google_pay"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using Google Pay.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"revolut_pay_card"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order via Revolut Pay using their credit or debit card.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-4",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"revolut_pay_account"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order via Revolut Pay using their Revolut account.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-5",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"sepa_direct_debit"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using SEPA Direct Debit.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 18b7:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of the card."}]]}] 18b8:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of card funding."}]]}] 18b9:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The 2-letter country code of the country where the card was issued."}]]}] 18ba:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The BIN of the card."}]]}] 18bb:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The last four digits of the card number."}]]}] 18bc:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The expiry date of the card in the format of MM/YY."}]]}] 18bd:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The name of the cardholder."}]]}] 18be:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The details of the check for card payment. Only for orders with successful payments."}]]}] 18bf:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The authorisation code (or auth code) is a short, alphanumeric code returned by the cardholder's issuing bank to the merchant's terminal or payment gateway."}],"\n",["$","p","p-1",{"children":"It serves as confirmation that the transaction has been approved and funds are available."}]]}] 18c0:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Acquirer Reference Number (ARN) of the payment."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":"Only returned for refund payments made by a card."}]}]]}]]}] 18c1:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The date and time by which the payment must be captured."}],"\n",["$","p","p-1",{"children":"After this deadline, the authorised funds may be automatically released by the card issuer."}]]}] 18c2:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The hardware identifier of the Revolut Terminal device used to process the payment."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":"Only present for card-present transactions processed via Revolut Terminal."}]}]]}]]}] 18c4:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A unique identifier for a payment method, always 44 characters long. This fingerprint can be used to uniquely identify various payment methods."}],"\n",["$","h1","h1-0",{"children":"Fingerprint generation"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Payment method","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","strong","strong-0",{"children":"All payment methods"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"A fingerprint is generated for all payment methods, including cards, Revolut Pay (card, account-to-account payments), Apple Pay, and Google Pay.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","strong","strong-0",{"children":"Cards (Revolut Pay & Card Gateway)"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"For cards, the fingerprint is based on the PAN. Cards processed via Revolut Pay and our card gateway will share the same fingerprint. Renewed cards (new expiry/CVV) retain the same fingerprint for efficient blocking.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","strong","strong-0",{"children":"Apple Pay & Google Pay"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Since Apple Pay and Google Pay provide us Device PANs (DPAN), the fingerprint is based on the DPAN provided by Apple/Google, not the connected card's PAN. This means that a new DPAN (and fingerprint) is generated for cards in case they are re-added to the customer's digital wallet, or added to different devices.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}],"\n",["$","h4","h4-0",{"children":"Detecting duplicate payment methods"}],"\n",["$","p","p-1",{"children":"Fingerprints are a valuable tool for detecting duplicate payment methods by identifying if a payment method has been seen before. This capability, in turn, helps in preventing various types of misuse (e.g., exploitation of free trials, or association with known problematic accounts, which can be a form of fraud). To effectively use fingerprints for this purpose, you will need to create and maintain your own lists (e.g., blocklists of known problematic fingerprints, allowlists for trusted customers, or tracking frequently used fingerprints)."}],"\n",["$","p","p-2",{"children":"The ideal way to utilise fingerprints is by combining them with a manual capture process. While automatic capture with subsequent refunds for problematic payments is possible, manual capture based on fingerprint validation is recommended."}],"\n",["$","p","p-3",{"children":"During your manual capture workflow, after a payment was authorised:"}],"\n",["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":"Check the fingerprint status by comparing it against your maintained lists and internal business rules."}],"\n",["$","li","li-1",{"children":["If you decide to proceed with the payment (e.g., the fingerprint is not on a blocklist, or matches a trusted customer's previous payment method): ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#capture-order","target":"_blank","rel":"noreferrer","children":"Capture the order"}],"."]}],"\n",["$","li","li-2",{"children":["If you decide not to proceed with the payment (e.g., the fingerprint matches a known fraudulent fingerprint, or exhibits suspicious patterns): ","$L1a0e","."]}],"\n"]}]]}] 18c5:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The Network Transaction ID (NTI) is a unique identifier assigned by the card scheme (e.g., Visa or Mastercard) to a card transaction."}],"\n",["$","p","p-1",{"children":"It can be used to trace the transaction across the payment network, link recurring or instalment payments to the original authorisation, and support dispute resolution."}]]}] 18c6:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object containing details of a card used via Revolut Pay."}]]}] 18c7:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"ID of the saved payment method."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["The ",["$","code","code-0",{"children":"id"}]," parameter is only returned when the payment method is saved."]}]}]]}]]}] 18c8:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of payment method used to pay for the order."}],"\n",["$","p","p-1",{"children":"Available values:"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":["Payment method ",["$","code","code-0",{"children":"type"}]],"className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"apple_pay"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using Apple Pay.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"card"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using their credit or debit card.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"google_pay"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using Google Pay.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"revolut_pay_card"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order via Revolut Pay using their credit or debit card.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-4",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"revolut_pay_account"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order via Revolut Pay using their Revolut account.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-5",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"sepa_direct_debit"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using SEPA Direct Debit.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 18ca:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A unique identifier for a payment method, always 44 characters long. This fingerprint can be used to uniquely identify various payment methods."}],"\n",["$","h1","h1-0",{"children":"Fingerprint generation"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Payment method","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","strong","strong-0",{"children":"All payment methods"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"A fingerprint is generated for all payment methods, including cards, Revolut Pay (card, account-to-account payments), Apple Pay, and Google Pay.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","strong","strong-0",{"children":"Cards (Revolut Pay & Card Gateway)"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"For cards, the fingerprint is based on the PAN. Cards processed via Revolut Pay and our card gateway will share the same fingerprint. Renewed cards (new expiry/CVV) retain the same fingerprint for efficient blocking.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","strong","strong-0",{"children":"Apple Pay & Google Pay"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Since Apple Pay and Google Pay provide us Device PANs (DPAN), the fingerprint is based on the DPAN provided by Apple/Google, not the connected card's PAN. This means that a new DPAN (and fingerprint) is generated for cards in case they are re-added to the customer's digital wallet, or added to different devices.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}],"\n",["$","h4","h4-0",{"children":"Detecting duplicate payment methods"}],"\n",["$","p","p-1",{"children":"Fingerprints are a valuable tool for detecting duplicate payment methods by identifying if a payment method has been seen before. This capability, in turn, helps in preventing various types of misuse (e.g., exploitation of free trials, or association with known problematic accounts, which can be a form of fraud). To effectively use fingerprints for this purpose, you will need to create and maintain your own lists (e.g., blocklists of known problematic fingerprints, allowlists for trusted customers, or tracking frequently used fingerprints)."}],"\n",["$","p","p-2",{"children":"The ideal way to utilise fingerprints is by combining them with a manual capture process. While automatic capture with subsequent refunds for problematic payments is possible, manual capture based on fingerprint validation is recommended."}],"\n",["$","p","p-3",{"children":"During your manual capture workflow, after a payment was authorised:"}],"\n",["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":"Check the fingerprint status by comparing it against your maintained lists and internal business rules."}],"\n",["$","li","li-1",{"children":["If you decide to proceed with the payment (e.g., the fingerprint is not on a blocklist, or matches a trusted customer's previous payment method): ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#capture-order","target":"_blank","rel":"noreferrer","children":"Capture the order"}],"."]}],"\n",["$","li","li-2",{"children":["If you decide not to proceed with the payment (e.g., the fingerprint matches a known fraudulent fingerprint, or exhibits suspicious patterns): ","$L1a0f","."]}],"\n"]}]]}] 18cb:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"ID of the saved payment method."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["The ",["$","code","code-0",{"children":"id"}]," parameter is only returned when the payment method is saved for the merchant."]}]}]]}]]}] 18cc:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of payment method used to pay for the order."}],"\n",["$","p","p-1",{"children":"Available values:"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":["Payment method ",["$","code","code-0",{"children":"type"}]],"className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"apple_pay"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using Apple Pay.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"card"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using their credit or debit card.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"google_pay"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using Google Pay.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"revolut_pay_card"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order via Revolut Pay using their credit or debit card.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-4",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"revolut_pay_account"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order via Revolut Pay using their Revolut account.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-5",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"sepa_direct_debit"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using SEPA Direct Debit.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 18cd:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The last four digits of the debtor's IBAN."}]]}] 18ce:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The full name of the debtor as provided in the mandate."}]]}] 18cf:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The unique mandate reference generated by Revolut. Include this in pre-debit notifications sent to your customers."}]]}] 18d0:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object containing details of a SEPA Direct Debit payment."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/accept-payments/payment-methods/sepa-direct-debit/server-to-server","target":"_blank","rel":"noreferrer","children":"SEPA Direct Debit server-to-server integration"}]]}]}]]}]]}] 18d1:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The details of the payment method used to make the payment."}]]}] 18d2:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Type of the authentication challenge the payment triggers."}]]}] 18d3:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The URL of the authentication challenge."}]]}] 18d4:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Information about the 3DS challenge."}]]}] 18d5:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Type of the authentication challenge the payment triggers."}]]}] 18d6:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The URL of the fingerprint. (Used only internally by Revolut.)"}]]}] 18d7:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Data about the fingerprint used for authentication. (Used only internally\nby Revolut.)"}]]}] 18d8:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Information about the 3DS fingerprint challenge."}]]}] 18d9:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["Details about the authentication challenge that should be performed to complete the authentication process. For more information about Revolut's 3DS solution, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/reference/3d-secure","target":"_blank","rel":"noreferrer","children":"3D Secure overview"}],"."]}],"\n",["$","p","p-1",{"children":["Only returned if the payment's state is ",["$","code","code-0",{"children":"authentication_challenge"}],"."]}]]}] 18da:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Street line 1 information."}]]}] 18db:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Street line 2 information."}]]}] 18dc:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The region associated with the address."}]]}] 18dd:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The city associated with the address."}]]}] 18de:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The 2-letter country code of the country associated with the address."}]]}] 18df:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The postcode associated with the address."}]]}] 18e0:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object containing address details."}]]}] 18e1:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The risk level of the card."}],"\n",["$","p","p-1",{"children":["If the risk level is ",["$","code","code-0",{"children":"high"}],", the payment might be declined."]}]]}] 18e2:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of the order fee."}]]}] 18e3:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The amount of the payment fee (minor currency unit). For example, enter ",["$","code","code-0",{"children":"7034"}]," for €70.34 in the field."]}]]}] 18e4:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The currency of the payment fee. ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_4217","target":"_blank","rel":"noreferrer","children":"ISO 4217"}]," currency code in upper case."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information about the supported currencies, see: ",["$","a","a-0",{"href":"https://help.revolut.com/business/help/merchant-accounts/payments/in-which-currencies-can-i-accept-payments/","target":"_blank","rel":"noreferrer","children":"Help Center"}],"."]}]}]]}]]}] 18e5:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The details of the order fee."}]]}] 18e6:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The email of the person who made the payment."}]]}] 18e7:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The phone number of the payer in ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/E.164","target":"_blank","rel":"noreferrer","children":"E.164 format"}],"."]}]]}] 18e8:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The person who made the payment. This object is present when an email or phone number is provided during the payment flow."}],"\n",["$","p","p-1",{"children":"Capturing payer details lets you identify exactly who authorised the charge, reach the right person for receipts or refund queries, and support compliance or fraud-review workflows where the paying identity matters."}]]}] 18e9:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Represents a payment for an order."}],"\n",["$","p","p-1",{"children":["For pre-authorised payments, the ",["$","code","code-0",{"children":"authorised_amount"}]," field tracks the currently authorised amount, which may differ from ",["$","code","code-1",{"children":"amount"}]," during incremental authorisation processing."]}]]}] 18ea:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The details of all the payments that have been made towards this order (successful or unsuccessful)."}]]}] 18eb:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The new total amount requested in this increment (in minor units)."}]]}] 18ec:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The previously authorised amount before this increment (in minor units)."}]]}] 18ed:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The state of this incremental authorization attempt."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"State","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"pending"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Increment registered in system, not yet submitted to card network","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"processing"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Increment is being processed by card network","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"authorised"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Increment was successfully authorised","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"declined"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Increment was declined by card issuer","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-4",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"failed"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Increment failed due to technical error (not an issuer decline)","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 18ee:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"External reference for this incremental authorisation."}],"\n",["$","div","inlinealert-0",{"data-type":"tip","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"Lightbulb","color":"var(--rui-color-success)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":"Use your internal charge or invoice ID. This reference is returned in webhooks for easy matching to your system."}]}]]}]]}] 18ef:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Name of the line item."}]]}] 18f0:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Type of the line item."}]]}] 18f1:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The number of units of the line item."}]]}] 18f2:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The measurement unit for the quantity, such as ",["$","code","code-0",{"children":"cm"}],", or ",["$","code","code-1",{"children":"kg"}],"."]}]]}] 18f3:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object representing the quantity details of a line item, including the amount and its associated unit of measurement."}]]}] 18f4:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The unit price of the line item."}]]}] 18f5:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The total amount to be paid for the line item, including taxes and discounts."}]]}] 18f6:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unique identifier of line item in the merchant's system."}]]}] 18f7:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The specific name or label of the discount applied to the line item."}]]}] 18f8:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The monetary value of the discount."}]]}] 18f9:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Details of a discount applied to the line item, including its name and monetary value."}]]}] 18fa:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A list of discounts applied to the line item. Each discount should be subtracted from the total amount payable for the item."}]]}] 18fb:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The specific name or designation of the tax applied to the line item."}]]}] 18fc:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The monetary value of the tax in minor currency units (e.g., cents for EUR)."}]]}] 18fd:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Details about a tax applied to the line item, including its name and the corresponding amount."}]]}] 18fe:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A list of taxes applied to the line item. Each tax should be added to the total amount payable for the item."}]]}] 18ff:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"URL to an image associated with the line item."}],"\n",["$","div","inlinealert-0",{"data-type":"warning","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMark","color":"var(--rui-color-warning)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"Restrictions:"}],["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["Must be a valid URI as defined by ",["$","a","a-0",{"href":"https://datatracker.ietf.org/doc/html/rfc3986","target":"_blank","rel":"noreferrer","children":"RFC 3986"}]]}],"\n",["$","li","li-1",{"children":["URI scheme is required and must be either ",["$","code","code-0",{"children":"http"}]," or ",["$","code","code-1",{"children":"https"}]]}],"\n",["$","li","li-2",{"children":["URI host is required and cannot be ",["$","code","code-0",{"children":"localhost"}]," or an IP address"]}],"\n",["$","li","li-3",{"children":["Max length: ",["$","code","code-0",{"children":"2000"}]]}],"\n",["$","li","li-4",{"children":["Reserved or invalid characters must be percent-encoded (for example, use ",["$","code","code-0",{"children":"%20"}]," instead of a space)"]}],"\n"]}]]}]]}]]}] 1900:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A list of URLs pointing to images related to the line item. These images can provide visual details or representations of the item."}]]}] 1901:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Description of the line item."}]]}] 1902:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An HTTP/HTTPS URL that links to more information about the line item, such as a product page or details."}],"\n",["$","div","inlinealert-0",{"data-type":"warning","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMark","color":"var(--rui-color-warning)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"Restrictions:"}],["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["Must be a valid URI as defined by ",["$","a","a-0",{"href":"https://datatracker.ietf.org/doc/html/rfc3986","target":"_blank","rel":"noreferrer","children":"RFC 3986"}]]}],"\n",["$","li","li-1",{"children":["URI scheme is required and must be either ",["$","code","code-0",{"children":"http"}]," or ",["$","code","code-1",{"children":"https"}]]}],"\n",["$","li","li-2",{"children":["URI host is required and cannot be ",["$","code","code-0",{"children":"localhost"}]," or an IP address"]}],"\n",["$","li","li-3",{"children":["Max length: ",["$","code","code-0",{"children":"2000"}]]}],"\n",["$","li","li-4",{"children":["Reserved or invalid characters must be percent-encoded (for example, use ",["$","code","code-0",{"children":"%20"}]," instead of a space)"]}],"\n"]}]]}]]}]]}] 1903:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Line items associated with this increment (if provided)."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":"If the increment is successful, these line items will override the existing order line items."}]}]]}]]}] 1904:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Reason why increment was declined or failed."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["Only present when ",["$","code","code-0",{"children":"state"}]," is ",["$","code","code-1",{"children":"declined"}]," or ",["$","code","code-2",{"children":"failed"}],"."]}]}]]}]]}] 1905:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Represents a single incremental authorisation attempt on an order."}],"\n",["$","p","p-1",{"children":["The ",["$","code","code-0",{"children":"incremental_authorisations"}]," array tracks all increment attempts (successful and failed) in chronological order."]}]]}] 1906:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"History of incremental authorisation attempts for this order."}],"\n",["$","p","p-1",{"children":["Only present for orders with ",["$","code","code-0",{"children":"authorisation_type: pre_authorisation"}],"."]}],"\n",["$","p","p-2",{"children":"Contains all increment attempts in chronological order."}]]}] 1907:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unique ID representing the location where merchants sells products."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#tag-locations","target":"_blank","rel":"noreferrer","children":"Locations"}],"."]}]}]]}]]}] 1908:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Additional metadata value provided with the corresponding metadata key."}]]}] 1909:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["Additional information to track your orders in your system, by providing custom metadata using ",["$","code","code-0",{"children":"\"\" : \"\""}]," pairs."]}],"\n",["$","div","inlinealert-0",{"data-type":"warning","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMark","color":"var(--rui-color-warning)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":["$","strong","strong-0",{"children":"Restrictions:"}]}],["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["Both keys and values must be ",["$","code","code-0",{"children":"string"}],"s"]}],"\n",["$","li","li-1",{"children":["Values cannot be ",["$","code","code-0",{"children":"null"}],"."]}],"\n",["$","li","li-2",{"children":["Max number of key-value pairs: ",["$","code","code-0",{"children":"50"}]]}],"\n",["$","li","li-3",{"children":["Max length of values: ",["$","code","code-0",{"children":"500"}]," characters"]}],"\n",["$","li","li-4",{"children":["Format of keys: Must start with a letter and contain only letters, digits, and underscores. Max 40 characters. Pattern: ",["$","code","code-0",{"children":"^[a-zA-Z][a-zA-Z\\\\d_]{0,39}$"}]]}],"\n"]}]]}]]}]]}] 190b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Type of the industry-specific data object, determining what additional data is expected."}],"\n",["$","p","p-1",{"children":"Available types:"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Object type","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"airline"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about a specific airline ticket purchase.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"car_rental"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about a car rental booking associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"crypto"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about crypto transactions associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"marketplace"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["This object is required by Mastercard and Visa for merchants operating as marketplaces under the ",["$","strong","strong-0",{"children":"Merchant Category Code (MCC):"}]," ",["$","code","code-0",{"children":"5262"}],". The marketplace object ensures compliance with the card schemes' regulations by providing detailed information about the subseller involved in the transaction."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-4",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"event"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about event ticket bookings associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-5",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"lodging"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about lodging bookings associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 190c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A unique identifier provided by the merchant associated with the order."}],"\n",["$","p","p-1",{"children":["This ",["$","code","code-0",{"children":"booking_id"}]," is used to reference and correlate booking information with the Merchant API and the merchant's internal system."]}]]}] 190d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The UTC date and time of the final journey leg."}],"\n",["$","div","inlinealert-0",{"data-type":"warning","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMark","color":"var(--rui-color-warning)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"The following limitations apply:"}],["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["When creating or updating an order, ",["$","code","code-0",{"children":"fulfillment_date"}]," cannot be set to a date in the past."]}],"\n",["$","li","li-1",{"children":["When updating an order, if the current ",["$","code","code-0",{"children":"fulfillment_date"}]," value is already in the past, it cannot be modified. The date must remain as is to maintain data integrity for completed transactions."]}],"\n"]}]]}]]}]]}] 190e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["Flag indicating whether the order includes actual ticket purchases. Set to ",["$","code","code-0",{"children":"true"}]," if the order contains ticket purchases, and ",["$","code","code-1",{"children":"false"}]," if it does not (e.g., it ",["$","strong","strong-0",{"children":"only"}]," contains seat reservations, or baggage upgrades)."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":["This field is required for activating ",["$","strong","strong-0",{"children":"Revolut Flight Alerts"}]," functionalities within the Revolut app."]}],["$","p","p-1",{"children":"Provide the info on order creation or update, before capturing the order."}]]}]]}]]}] 190f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of the ticket."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Parameter value","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"fixed"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Non-modifiable once confirmed.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"flexible"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Allows modifications or cancellations under specified conditions.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 1910:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The code of the Computer Reservation System (CRS) used to make the booking and purchase the ticket."}]]}] 1911:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Parameter indicating whether this order is related to a new ticket reservation or a modification of an existing one."}]]}] 1912:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Parameter indicating whether the booking is refundable, partially refundable, or not refundable."}]]}] 1913:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Passenger's first name."}]]}] 1914:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Passenger's last name."}]]}] 1915:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Array containing information of passengers associated with the booking."}]]}] 1916:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Sequence of the journey legs. Increment by 1 for each flight included in the ticket."}],"\n",["$","p","p-1",{"children":["For example: For a ",["$","code","code-0",{"children":"FRA > LHR > DUB > LHR > FRA"}]," journey the sequence will be assigned as:"]}],"\n",["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":[["$","code","code-0",{"children":"FRA > LHR"}],": 1"]}],"\n",["$","li","li-1",{"children":[["$","code","code-0",{"children":"LHR > DUB"}],": 2"]}],"\n",["$","li","li-2",{"children":[["$","code","code-0",{"children":"DUB > LHR"}],": 3"]}],"\n",["$","li","li-3",{"children":[["$","code","code-0",{"children":"LHR > FRA"}],": 4"]}],"\n"]}]]}] 1917:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://www.iata.org/en/services/codes","target":"_blank","rel":"noreferrer","children":"IATA"}]," 3-letter airport code for the departure airport."]}]]}] 1918:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://www.iata.org/en/services/codes","target":"_blank","rel":"noreferrer","children":"IATA"}]," 3-letter airport code for the arrival airport."]}]]}] 1919:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The flight identifier, without airline code."}]]}] 191a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The fare base code for the given journey leg."}]]}] 191b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The UTC date and time of the flight departure for the given journey leg."}]]}] 191c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The name of the airline associated with the journey leg."}]]}] 191d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The IATA 2-letter accounting code identifying the airline associated with the journey leg."}]]}] 191e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The Passenger Name Record (PNR) for the journey leg issued by the airline."}],"\n",["$","p","p-1",{"children":"PNR is a unique identifier for the booking, acting as a digital certificate allowing passengers to retrieve or manage their booking details."}],"\n",["$","div","inlinealert-0",{"data-type":"warning","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMark","color":"var(--rui-color-warning)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":"This is a required field for OTAs."}]}]]}]]}] 191f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Array containing information of journey legs associated with the booking."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":["This field is required for activating ",["$","strong","strong-0",{"children":"Revolut Flight Alerts"}]," functionalities within the Revolut app."]}],["$","p","p-1",{"children":"This information is used to compile a tracking widget that provides real-time updates on flight status and sends notifications, such as a check-in reminders, boarding alerts, and notifications for cancellations or delays."}],["$","p","p-2",{"children":"To enable the widget the following fields are required on order creation or update, before capturing the order:"}],"$L1a10"]}]]}]]}] 1920:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"URL to the online portal for managing the airline booking, which includes check-in functionality. This URL may be a personalised, pre-populated check-in link specific to the user or a generic link, and it is essential for enabling direct access to booking details within the Revolut app."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":["This field is required for activating ",["$","strong","strong-0",{"children":"Revolut Flight Alerts"}]," functionalities within the Revolut app."]}],["$","p","p-1",{"children":"Provide the info on order creation or update, before capturing the order."}]]}]]}],"\n",["$","div","inlinealert-1",{"data-type":"warning","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMark","color":"var(--rui-color-warning)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"Restrictions:"}],["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["Must be a valid URI as defined by ",["$","a","a-0",{"href":"https://datatracker.ietf.org/doc/html/rfc3986","target":"_blank","rel":"noreferrer","children":"RFC 3986"}]]}],"\n",["$","li","li-1",{"children":["URI scheme is required and must be either ",["$","code","code-0",{"children":"http"}]," or ",["$","code","code-1",{"children":"https"}]]}],"\n",["$","li","li-2",{"children":["URI host is required and cannot be ",["$","code","code-0",{"children":"localhost"}]," or an IP address"]}],"\n",["$","li","li-3",{"children":["Max length: ",["$","code","code-0",{"children":"2000"}]]}],"\n",["$","li","li-4",{"children":["Reserved or invalid characters must be percent-encoded (for example, use ",["$","code","code-0",{"children":"%20"}]," instead of a space)"]}],"\n"]}]]}]]}]]}] 1921:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object containing additional information about an airline booking associated with the order."}],"\n",["$","p","p-1",{"children":["Use this object to provide required data to enable ",["$","strong","strong-0",{"children":"Revolut Flight Alerts"}],". This feature allows users to receive real-time flight updates such as check-in reminders, boarding alerts, and notifications for cancellations or delays in the Revolut app."]}],"\n",["$","p","p-2",{"children":["To enable ",["$","strong","strong-0",{"children":"Revolut Flight Alerts"}]," functionalities in the Revolut app, the following fields are ",["$","strong","strong-1",{"children":"required"}]," on order creation or update, before capturing the order:"]}],"\n","$L1a11","\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"These are the specific data field requirements for merchants who must provide airline data. Note that these requirements can be extended on a case by case basis as decided by Revolut."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Required for airline/charter merchants","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Required for OTA merchants","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","ul","ul-0",{"children":[["$","li","li-0",{"children":["$","code","code-0",{"children":"booking_id"}]}],["$","li","li-1",{"children":["$","code","code-0",{"children":"fulfillment_date"}]}],["$","li","li-2",{"children":["$","code","code-0",{"children":"passengers[].first_name"}]}],["$","li","li-3",{"children":["$","code","code-0",{"children":"passengers[].last_name"}]}],["$","li","li-4",{"children":["$","code","code-0",{"children":"journey_legs[].pnr"}]}],["$","li","li-5",{"children":["$","code","code-0",{"children":"journey_legs[].sequence"}]}],["$","li","li-6",{"children":["$","code","code-0",{"children":"journey_legs[].flight_number"}]}],["$","li","li-7",{"children":["$","code","code-0",{"children":"journey_legs[].travel_date"}]}],["$","li","li-8",{"children":["$","code","code-0",{"children":"journey_legs[].airline_code"}]}],["$","li","li-9",{"children":["$","code","code-0",{"children":"journey_legs[].departure_airport_code"}]}],["$","li","li-10",{"children":["$","code","code-0",{"children":"journey_legs[].arrival_airport_code"}]}]]}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["$","ul","ul-0",{"children":[["$","li","li-0",{"children":["$","code","code-0",{"children":"booking_id"}]}],["$","li","li-1",{"children":["$","code","code-0",{"children":"fulfillment_date"}]}],["$","li","li-2",{"children":["$","code","code-0",{"children":"passengers[].first_name"}]}],["$","li","li-3",{"children":["$","code","code-0",{"children":"passengers[].last_name"}]}],["$","li","li-4",{"children":["$","code","code-0",{"children":"journey_legs[].pnr"}]}],["$","li","li-5",{"children":["$","code","code-0",{"children":"journey_legs[].arrival_airport_code"}]}]]}],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt3","ref":"$undefined"}]]}]}]]}]]}]]}] 1922:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Type of the industry-specific data object, determining what additional data is expected."}],"\n",["$","p","p-1",{"children":"Available types:"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Object type","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"airline"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about a specific airline ticket purchase.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"car_rental"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about a car rental booking associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"crypto"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about crypto transactions associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"marketplace"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["This object is required by Mastercard and Visa for merchants operating as marketplaces under the ",["$","strong","strong-0",{"children":"Merchant Category Code (MCC):"}]," ",["$","code","code-0",{"children":"5262"}],". The marketplace object ensures compliance with the card schemes' regulations by providing detailed information about the subseller involved in the transaction."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-4",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"event"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about event ticket bookings associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-5",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"lodging"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about lodging bookings associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 1923:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A unique identifier provided by the merchant associated with the order."}],"\n",["$","p","p-1",{"children":["This ",["$","code","code-0",{"children":"booking_id"}]," is used to reference and correlate booking information with the Merchant API and the merchant's internal system."]}]]}] 1924:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The UTC date and time of the pick-up."}]]}] 1925:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object containing address details."}]]}] 1926:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The UTC date and time of the drop-off."}]]}] 1927:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object containing address details."}]]}] 1928:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Parameter indicating whether the booking is refundable, partially refundable, or not refundable."}]]}] 1929:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The maximum distance allowed."}]]}] 192a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The unit of distance."}]]}] 192b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The amount of the cost in minor currency units. For example, enter ",["$","code","code-0",{"children":"7034"}]," for €70.34."]}]]}] 192c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":[["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_4217","target":"_blank","rel":"noreferrer","children":"ISO 4217"}]," currency code in upper case."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information about the supported currencies, see: ",["$","a","a-0",{"href":"https://help.revolut.com/business/help/merchant-accounts/payments/in-which-currencies-can-i-accept-payments/","target":"_blank","rel":"noreferrer","children":"Help Center"}],"."]}]}]]}]]}] 192d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Cost for exceeding the distance limit."}]]}] 192e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object containing distance limit information."}]]}] 192f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object containing additional information about a car rental booking associated with the order."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"These are the specific data field requirements for merchants offering car rental. Note that these requirements can be extended on a case by case basis as decided by Revolut."}],"$L1a12"]}]]}]]}] 1930:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Type of the industry-specific data object, determining what additional data is expected."}],"\n",["$","p","p-1",{"children":"Available types:"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Object type","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"airline"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about a specific airline ticket purchase.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"car_rental"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about a car rental booking associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"crypto"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about crypto transactions associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"marketplace"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["This object is required by Mastercard and Visa for merchants operating as marketplaces under the ",["$","strong","strong-0",{"children":"Merchant Category Code (MCC):"}]," ",["$","code","code-0",{"children":"5262"}],". The marketplace object ensures compliance with the card schemes' regulations by providing detailed information about the subseller involved in the transaction."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-4",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"event"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about event ticket bookings associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-5",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"lodging"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about lodging bookings associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 1931:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The public transaction hash of the crypto transaction."}]]}] 1932:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The status of the crypto transaction."}]]}] 1933:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The wallet ID of the recipient."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["At least one of the parameters: ",["$","code","code-0",{"children":"recipient_user_id"}]," or ",["$","code","code-1",{"children":"recipient_wallet_id"}]," is required."]}]}]]}]]}] 1934:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The user ID of the recipient."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["At least one of the parameters: ",["$","code","code-0",{"children":"recipient_user_id"}]," or ",["$","code","code-1",{"children":"recipient_wallet_id"}]," is required."]}]}]]}]]}] 1935:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Array of crypto transaction data associated with the order."}]]}] 1936:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["A string representing the four-digit ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/Merchant_category_code","target":"_blank","rel":"noreferrer","children":"Merchant Category Code (MCC)"}]," of the conversion affiliate."]}]]}] 1937:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The ID of the seller in the merchant's internal system."}]]}] 1938:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The business or legal name of the seller."}]]}] 1939:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The URL of the website of the seller."}],"\n",["$","div","inlinealert-0",{"data-type":"warning","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMark","color":"var(--rui-color-warning)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"Restrictions:"}],["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["Must be a valid URI as defined by ",["$","a","a-0",{"href":"https://datatracker.ietf.org/doc/html/rfc3986","target":"_blank","rel":"noreferrer","children":"RFC 3986"}]]}],"\n",["$","li","li-1",{"children":["URI scheme is required and must be either ",["$","code","code-0",{"children":"http"}]," or ",["$","code","code-1",{"children":"https"}]]}],"\n",["$","li","li-2",{"children":["URI host is required and cannot be ",["$","code","code-0",{"children":"localhost"}]," or an IP address"]}],"\n",["$","li","li-3",{"children":["Max length: ",["$","code","code-0",{"children":"255"}]]}],"\n",["$","li","li-4",{"children":["Reserved or invalid characters must be percent-encoded (for example, use ",["$","code","code-0",{"children":"%20"}]," instead of a space)"]}],"\n"]}]]}]]}]]}] 193a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The phone number of the seller."}]]}] 193b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Primary address line."}]]}] 193c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Secondary address line, such as floor and apartment number."}]]}] 193d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"State or province of the address."}]]}] 193e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"City of the address."}]]}] 193f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"ISO 2-letter country code."}]]}] 1940:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The subdivision code represents the state, province, or region within the country, following the ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_3166-2","target":"_blank","rel":"noreferrer","children":"ISO 3166-2"}]," standard. This code uniquely identifies subdivisions within a country."]}],"\n",["$","p","p-1",{"children":["For example, for London in the United Kingdom, use ",["$","code","code-0",{"children":"GB-LND"}],"."]}],"\n",["$","div","inlinealert-0",{"data-type":"warning","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMark","color":"var(--rui-color-warning)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["The parameter is required for countries listed on the ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_3166-2","target":"_blank","rel":"noreferrer","children":"ISO 3166-2"}]," page."]}]}]]}]]}] 1941:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Postal code of the address."}]]}] 1942:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Details of a physical address."}]]}] 1943:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Information about the crypto conversion affiliate."}],"\n",["$","p","p-1",{"children":"This should be provided when a customer completes a payment on a subseller's website rather than directly on the merchant's website, providing insight into the type of business conducted by the subseller."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"This needs to be provided only by crypto on-ramp providers for payments they are processing for conversion affiliates."}],["$","p","p-1",{"children":["For their own payments, ",["$","code","code-0",{"children":"seller"}]," can be omitted."]}]]}]]}]]}] 1944:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object containing information about crypto transactions associated with the order."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"Processing crypto on-ramp transactions with Revolut has additional compliance requirements. Please reach out to your account executive for additional details."}],["$","p","p-1",{"children":["$","strong","strong-0",{"children":"Required data fields for crypto services:"}]}],"$L1a13",["$","p","p-2",{"children":"Note that these requirements can be extended on a case by case basis as decided by Revolut."}]]}]]}]]}] 1945:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Type of the industry-specific data object, determining what additional data is expected."}],"\n",["$","p","p-1",{"children":"Available types:"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Object type","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"airline"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about a specific airline ticket purchase.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"car_rental"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about a car rental booking associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"crypto"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about crypto transactions associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"marketplace"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["This object is required by Mastercard and Visa for merchants operating as marketplaces under the ",["$","strong","strong-0",{"children":"Merchant Category Code (MCC):"}]," ",["$","code","code-0",{"children":"5262"}],". The marketplace object ensures compliance with the card schemes' regulations by providing detailed information about the subseller involved in the transaction."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-4",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"event"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about event ticket bookings associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-5",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"lodging"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about lodging bookings associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 1946:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The ID of the seller in the merchant's internal system."}]]}] 1947:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The business or legal name of the seller."}]]}] 1948:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The URL of the website of the seller."}],"\n",["$","div","inlinealert-0",{"data-type":"warning","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMark","color":"var(--rui-color-warning)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"Restrictions:"}],["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["Must be a valid URI as defined by ",["$","a","a-0",{"href":"https://datatracker.ietf.org/doc/html/rfc3986","target":"_blank","rel":"noreferrer","children":"RFC 3986"}]]}],"\n",["$","li","li-1",{"children":["URI scheme is required and must be either ",["$","code","code-0",{"children":"http"}]," or ",["$","code","code-1",{"children":"https"}]]}],"\n",["$","li","li-2",{"children":["URI host is required and cannot be ",["$","code","code-0",{"children":"localhost"}]," or an IP address"]}],"\n",["$","li","li-3",{"children":["Max length: ",["$","code","code-0",{"children":"255"}]]}],"\n",["$","li","li-4",{"children":["Reserved or invalid characters must be percent-encoded (for example, use ",["$","code","code-0",{"children":"%20"}]," instead of a space)"]}],"\n"]}]]}]]}]]}] 1949:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The phone number of the seller."}]]}] 194a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Details of a physical address."}]]}] 194b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Information about the subseller on the marketplace platform."}]]}] 194c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["This object is required by Mastercard and Visa for merchants operating as marketplaces under the Merchant Category Code (MCC) ",["$","code","code-0",{"children":"5262"}],". The marketplace object ensures compliance with the card schemes' regulations by providing detailed information about the seller involved in the transaction."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"These are the specific data field requirements for merchants who must provide marketplace data."}],"$L1a14"]}]]}]]}] 194d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Type of the industry-specific data object, determining what additional data is expected."}],"\n",["$","p","p-1",{"children":"Available types:"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Object type","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"airline"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about a specific airline ticket purchase.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"car_rental"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about a car rental booking associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"crypto"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about crypto transactions associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"marketplace"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["This object is required by Mastercard and Visa for merchants operating as marketplaces under the ",["$","strong","strong-0",{"children":"Merchant Category Code (MCC):"}]," ",["$","code","code-0",{"children":"5262"}],". The marketplace object ensures compliance with the card schemes' regulations by providing detailed information about the subseller involved in the transaction."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-4",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"event"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about event ticket bookings associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-5",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"lodging"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about lodging bookings associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 194e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A unique identifier provided by the merchant associated with the order."}],"\n",["$","p","p-1",{"children":["This ",["$","code","code-0",{"children":"booking_id"}]," is used to reference and correlate booking information with the Merchant API and the merchant's internal system."]}]]}] 194f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":[["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_8601","target":"_blank","rel":"noreferrer","children":"ISO 8601"}]," date and time when the event starts."]}]]}] 1950:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":[["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_8601","target":"_blank","rel":"noreferrer","children":"ISO 8601"}]," date and time when the event ends."]}]]}] 1951:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Legal name of the ticket vendor/event organiser."}]]}] 1952:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":[["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_8601","target":"_blank","rel":"noreferrer","children":"ISO 8601"}]," date and time when the funds are released to merchants."]}]]}] 1953:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The name of the event."}]]}] 1954:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Primary address line."}]]}] 1955:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Secondary address line, such as floor and apartment number."}]]}] 1956:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"State or province of the address."}]]}] 1957:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"City of the address."}]]}] 1958:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"ISO 2-letter country code."}]]}] 1959:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Postal code of the address."}]]}] 195a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The address of the event location."}]]}] 195b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of the event."}]]}] 195c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Indicates the relationship between the ticket vendor and the event organiser."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Parameter value","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"primary"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The merchant is the organiser and primary distributor of the tickets.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"secondary"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The merchant is a reseller, only distributing the tickets.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 195d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A unique identifier provided by the merchant associated with the ticket."}]]}] 195e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Indicates whether the ticket is transferable to another buyer."}]]}] 195f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Parameter indicating whether the booking is refundable, partially refundable, or not refundable."}]]}] 1960:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object containing information about a ticket associated with the booking."}]]}] 1961:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A list of tickets associated with the booking."}]]}] 1962:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object containing booking information about a specific event."}]]}] 1963:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A list of events associated with the booking."}]]}] 1964:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object containing booking information for a list of event tickets associated with the order."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"These are the specific data field requirements for merchants who must provide event data. Note that these requirements can be extended on a case by case basis as decided by Revolut."}],"$L1a15"]}]]}]]}] 1965:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Type of the industry-specific data object, determining what additional data is expected."}],"\n",["$","p","p-1",{"children":"Available types:"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Object type","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"airline"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about a specific airline ticket purchase.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"car_rental"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about a car rental booking associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"crypto"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about crypto transactions associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"marketplace"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["This object is required by Mastercard and Visa for merchants operating as marketplaces under the ",["$","strong","strong-0",{"children":"Merchant Category Code (MCC):"}]," ",["$","code","code-0",{"children":"5262"}],". The marketplace object ensures compliance with the card schemes' regulations by providing detailed information about the subseller involved in the transaction."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-4",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"event"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about event ticket bookings associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-5",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"lodging"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about lodging bookings associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 1966:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A unique identifier provided by the merchant associated with the order."}],"\n",["$","p","p-1",{"children":["This ",["$","code","code-0",{"children":"booking_id"}]," is used to reference and correlate booking information with the Merchant API and the merchant's internal system."]}]]}] 1967:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":[["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_8601","target":"_blank","rel":"noreferrer","children":"ISO 8601"}]," date and time of the check-in."]}]]}] 1968:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":[["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_8601","target":"_blank","rel":"noreferrer","children":"ISO 8601"}]," date and time of the check-out."]}]]}] 1969:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":[["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_8601","target":"_blank","rel":"noreferrer","children":"ISO 8601"}]," date and time when the funds are released to merchants."]}]]}] 196a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of the accommodation associated with the booking."}]]}] 196b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Indicates whether the booking terms are fixed or flexible."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Parameter value","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"fixed"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Non-modifiable once confirmed.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"flexible"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Allows modifications or cancellations under specified conditions.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 196c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Parameter indicating whether the booking is refundable, partially refundable, or not refundable."}]]}] 196d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Primary address line."}]]}] 196e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Secondary address line, such as floor and apartment number."}]]}] 196f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"State or province of the address."}]]}] 1970:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"City of the address."}]]}] 1971:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"ISO 2-letter country code."}]]}] 1972:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Postal code of the address."}]]}] 1973:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Address of the accommodation."}]]}] 1974:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Guest's first name."}]]}] 1975:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Guest's last name."}]]}] 1976:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"List of guests associated with the booking."}]]}] 1977:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object containing details of a lodging booking."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"These are the specific data field requirements for merchants who must provide lodging data. Note that these requirements can be extended on a case by case basis as decided by Revolut."}],"$L1a16"]}]]}]]}] 1978:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object containing industry-specific information associated with the order."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"In the following cases, industry-specific info is required. Omitting this information may trigger additional scrutiny and risk mitigation actions by the Revolut risk team."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Transaction type","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Required for","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"airline"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Airlines and Online Travel Agencies (OTAs).","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"car_rental"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Car Rental Merchants and Online Travel Agencies (OTAs).","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"crypto"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Crypto merchants.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"marketplace"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Marketplace merchants.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-4",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"event"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Event ticket sellers.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-5",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"lodging"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Lodging providers.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}]]}]]}] 1979:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The URL of the order stored in the merchant's order management system."}],"\n",["$","p","p-1",{"children":["This URL will be included in the order confirmation email for payments made via Revolut Pay. If specified, this URL will override the default link to the merchant's ",["$","strong","strong-0",{"children":"Business website"}]," configured in the Revolut Business account."]}],"\n",["$","div","inlinealert-0",{"data-type":"warning","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMark","color":"var(--rui-color-warning)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"Restrictions:"}],["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["Must be a valid URI as defined by ",["$","a","a-0",{"href":"https://datatracker.ietf.org/doc/html/rfc3986","target":"_blank","rel":"noreferrer","children":"RFC 3986"}]]}],"\n",["$","li","li-1",{"children":["URI scheme is required and must be either ",["$","code","code-0",{"children":"http"}]," or ",["$","code","code-1",{"children":"https"}]]}],"\n",["$","li","li-2",{"children":["URI host is required and cannot be ",["$","code","code-0",{"children":"localhost"}]," or an IP address"]}],"\n",["$","li","li-3",{"children":["Max length: ",["$","code","code-0",{"children":"2000"}]]}],"\n",["$","li","li-4",{"children":["Reserved or invalid characters must be percent-encoded (for example, use ",["$","code","code-0",{"children":"%20"}]," instead of a space)"]}],"\n"]}]]}]]}]]}] 197a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Merchant order ID for external reference."}],"\n",["$","p","p-1",{"children":"Use this field to set the ID that your own system can use to easily track orders."}]]}] 197b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object for providing additional information stored in the merchant's order management system."}]]}] 197c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The date and time in ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_8601","target":"_blank","rel":"noreferrer","children":"ISO 8601 format"}]," when the upcoming payment is scheduled to be executed."]}]]}] 197d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The unique ID of the customer's payment method used to complete the scheduled payment."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"For more information about operations related to customer's payment methods, see:"}],["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#retrieve-payment-method-list","target":"_blank","rel":"noreferrer","children":"Retrieve payment method list of a customer"}]}],"\n",["$","li","li-1",{"children":["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#retrieve-payment-method","target":"_blank","rel":"noreferrer","children":"Retrieve a customer's payment method"}]}],"\n",["$","li","li-2",{"children":["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#update-payment-method","target":"_blank","rel":"noreferrer","children":"Update a customer's payment method"}]}],"\n",["$","li","li-3",{"children":["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#delete-payment-method","target":"_blank","rel":"noreferrer","children":"Delete a customer's payment method"}]}],"\n"]}]]}]]}]]}] 197e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object containing information about upcoming payments associated with the order."}]]}] 197f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Link to a checkout page hosted by Revolut."}]]}] 1980:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The URL your customer will be redirected to after a successful payment on the hosted checkout page (",["$","code","code-0",{"children":"checkout_url"}]," parameter's value of the order)."]}],"\n",["$","div","inlinealert-0",{"data-type":"warning","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMark","color":"var(--rui-color-warning)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"Restrictions:"}],["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["Must be a valid URI as defined by ",["$","a","a-0",{"href":"https://datatracker.ietf.org/doc/html/rfc3986","target":"_blank","rel":"noreferrer","children":"RFC 3986"}]]}],"\n",["$","li","li-1",{"children":["URI scheme is required and must be either ",["$","code","code-0",{"children":"http"}]," or ",["$","code","code-1",{"children":"https"}]]}],"\n",["$","li","li-2",{"children":["URI host is required and cannot be ",["$","code","code-0",{"children":"localhost"}]," or an IP address"]}],"\n",["$","li","li-3",{"children":["Max length: ",["$","code","code-0",{"children":"2000"}]]}],"\n",["$","li","li-4",{"children":["Reserved or invalid characters must be percent-encoded (for example, use ",["$","code","code-0",{"children":"%20"}]," instead of a space)"]}],"\n"]}]]}]]}],"\n",["$","div","inlinealert-1",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information on how to use the ",["$","code","code-0",{"children":"redirect_url"}],", see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/accept-payments/online-payments/hosted-checkout-page/api#custom-post-payment-redirection-optional","target":"_blank","rel":"noreferrer","children":"Custom redirection via the API"}]]}]}]]}]]}] 1981:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Primary address line."}]]}] 1982:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Secondary address line, such as floor and apartment number."}]]}] 1983:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"State or province of the address."}]]}] 1984:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"City of the address."}]]}] 1985:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"ISO 2-letter country code."}]]}] 1986:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Postal code of the address."}]]}] 1987:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Details of a physical address."}]]}] 1988:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Full name of the contact person."}]]}] 1989:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Email address of the contact person."}]]}] 198a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Phone number of the contact person."}]]}] 198b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Contact details for someone responsible for the shipment."}],"\n",["$","div","inlinealert-0",{"data-type":"warning","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMark","color":"var(--rui-color-warning)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["At least ",["$","code","code-0",{"children":"email"}]," or ",["$","code","code-1",{"children":"phone"}]," is required."]}]}]]}]]}] 198c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Name of the company handling the shipment."}]]}] 198d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unique tracking number for the shipment."}]]}] 198e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Estimated delivery date and time for the shipment.\nThe time should also include the customer's timezone."}]]}] 198f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An HTTP/HTTPS URL where the shipment can be tracked."}],"\n",["$","div","inlinealert-0",{"data-type":"warning","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMark","color":"var(--rui-color-warning)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"Restrictions:"}],["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["Must be a valid URI as defined by ",["$","a","a-0",{"href":"https://datatracker.ietf.org/doc/html/rfc3986","target":"_blank","rel":"noreferrer","children":"RFC 3986"}]]}],"\n",["$","li","li-1",{"children":["URI scheme is required and must be either ",["$","code","code-0",{"children":"http"}]," or ",["$","code","code-1",{"children":"https"}]]}],"\n",["$","li","li-2",{"children":["URI host is required and cannot be ",["$","code","code-0",{"children":"localhost"}]," or an IP address"]}],"\n",["$","li","li-3",{"children":["Max length: ",["$","code","code-0",{"children":"2000"}]]}],"\n",["$","li","li-4",{"children":["Reserved or invalid characters must be percent-encoded (for example, use ",["$","code","code-0",{"children":"%20"}]," instead of a space)"]}],"\n"]}]]}]]}]]}] 1990:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Details of an individual shipment."}]]}] 1991:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"List of individual shipment details."}]]}] 1992:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Details about the shipping related to the order, including address, contact information, and individual shipments."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":"Required for merchants shipping physical goods. Omitting this information may trigger additional scrutiny and risk mitigation actions by Revolut."}]}]]}]]}] 1993:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The enforce challenge mode. ",["$","code","code-0",{"children":"automatic"}]," is used by default."]}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Parameter value","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"automatic"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The payments created for an order will have challenge requirement calculated by our fraud mechanisms. Not all payments will trigger a 3DS challenge.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"forced"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The payments created for an order will always require a 3DS challenge. Currently only supported for card payments.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 1994:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An array of line items included in the order. Each line item represents an individual product or service, along with its quantity, price, taxes, and discounts."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":"Required for merchants collecting payment for one or multiple products/services in one transaction. Omitting this information may trigger additional scrutiny and risk mitigation actions by Revolut."}]}]]}]]}] 1996:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"You can set a dynamic statement descriptor for your orders by providing a custom suffix."}],"\n",["$","p","p-1",{"children":"A statement descriptor is the text shown on cardholders' bank or card statements, helping them recognise a transaction or merchant. This field can be used to send extra information with the statement descriptor for card transactions."}],"\n",["$","p","p-2",{"children":["The complete descriptor is built using the following format: ",["$","code","code-0",{"children":"{base}*{suffix}"}],", where:"]}],"\n",["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":[["$","strong","strong-0",{"children":["$","code","code-0",{"children":"{base}"}]}]," is the existing descriptor configured in the Revolut Business dashboard (",["$","strong","strong-1",{"children":"Settings > Business account > Merchant profile > Statement descriptor"}],")."]}],"\n",["$","li","li-1",{"children":[["$","strong","strong-0",{"children":["$","code","code-0",{"children":"{suffix}"}]}]," is defined by the ",["$","code","code-0",{"children":"statement_descriptor_suffix"}]," field."]}],"\n"]}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["If the combined descriptor's length (base + suffix) exceeds the character limits of card scheme providers, the final value will be truncated. For example if the limit is 22 characters, the base descriptor is ",["$","code","code-0",{"children":"\"base\""}]," and the suffix is ",["$","code","code-1",{"children":"\"testdescriptorsuffix\""}],", the final descriptor becomes ",["$","code","code-2",{"children":"\"base*testdescriptorsuf\""}],"."]}],"\n",["$","li","li-1",{"children":"The final statement descriptor shown on a cardholder's statement may vary by issuing bank, as some banks apply their own custom formatting or truncation rules."}],"\n"]}]}]]}]]}] 1997:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The unique ID of the original order that was refunded and this refund is associated with. You can use this ID to get more information about the related order using the ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#retrieve-order","target":"_blank","rel":"noreferrer","children":"Retrieve an order"}]," operation."]}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["This field is only returned for orders with ",["$","code","code-0",{"children":"type: refund"}],"."]}]}]]}]]}] 1998:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unique identifier for the subscription."}]]}] 1999:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The unique identifier of the active (pre-paid) subscription cycle that this order collects payment for."}],"\n",["$","p","p-1",{"children":"This is the current billing cycle whose recurring charges are being collected in advance by this order. For example, if a subscription cycle covers 1-31 July and the order is generated on 1 July, this field identifies that July cycle."}]]}] 199a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The unique identifier of the settled (post-paid) subscription cycle whose usage-based charges this order collects."}],"\n",["$","p","p-1",{"children":"This is the previous billing cycle whose usage is being settled by this order. For example, if a subscription cycle covers usage from 1-30 June and the order is generated on 10 July, this field identifies that June cycle."}]]}] 199b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The reason this subscription order was created."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Value","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"cycle_billing"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["The order was automatically generated to collect payment for an ongoing subscription cycle. ",["$","code","code-0",{"children":"active_cycle_id"}]," is present; ",["$","code","code-1",{"children":"settled_cycle_id"}]," is present if the previous cycle included usage-based products."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"final_settlement"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["The order was automatically generated after the subscription ended to collect outstanding usage-based charges. ",["$","code","code-0",{"children":"active_cycle_id"}]," is absent; ",["$","code","code-1",{"children":"settled_cycle_id"}]," is present."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"setup_intent"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["The order was manually created by the merchant or customer to update the payment method on file. ",["$","code","code-0",{"children":"active_cycle_id"}]," is absent; ",["$","code","code-1",{"children":"settled_cycle_id"}]," is absent."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 199c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Subscription details linked to the order. Use this object to match an order with its underlying subscription and understand the billing context in which the order was created."}],"\n",["$","p","p-1",{"children":"Only present on orders created by a subscription."}]]}] 199d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["To process the order from a credit or debit card, you create an ",["$","code","code-0",{"children":"Order"}]," object. You can then retrieve, capture, cancel, refund, or pay an order using its unique ",["$","code","code-1",{"children":"id"}],". Alternatively, you can use its unique ",["$","code","code-2",{"children":"token"}]," to process a card payment with the Revolut Checkout Widget."]}]]}] 199e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Authorization increment initiated successfully"}]]}] 199f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An identifier that can be used to determine what went wrong."}],"\n",["$","p","p-1",{"children":"Error codes are not globally unique, but uniqueness is guaranteed within endpoints."}]]}] 19a0:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Some human readable text describing what went wrong."}]]}] 19a1:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://www.unixtimestamp.com/","target":"_blank","rel":"noreferrer","children":"UNIX timestamp"}]," of the date and time the error happened."]}]]}] 19a2:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Bad Request"}]]}] 19a3:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An identifier that can be used to determine what went wrong."}],"\n",["$","p","p-1",{"children":"Error codes are not globally unique, but uniqueness is guaranteed within endpoints."}]]}] 19a4:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Some human readable text describing what went wrong."}]]}] 19a5:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://www.unixtimestamp.com/","target":"_blank","rel":"noreferrer","children":"UNIX timestamp"}]," of the date and time the error happened."]}]]}] 19a6:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Order not found"}]]}] 19a7:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An identifier that can be used to determine what went wrong."}],"\n",["$","p","p-1",{"children":"Error codes are not globally unique, but uniqueness is guaranteed within endpoints."}]]}] 19a8:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Some human readable text describing what went wrong."}]]}] 19a9:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://www.unixtimestamp.com/","target":"_blank","rel":"noreferrer","children":"UNIX timestamp"}]," of the date and time the error happened."]}]]}] 19aa:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unprocessable Entity"}]]}] 19ab:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The new total amount to be authorised (in minor units, e.g., cents)."}],"\n",["$","p","p-1",{"children":["This should be the ",["$","strong","strong-0",{"children":"full new amount"}],", not the increment value.\nFor example, if the current authorised amount is ",["$","code","code-0",{"children":"500"}]," and you want to add 100, pass ",["$","code","code-1",{"children":"600"}],"."]}],"\n",["$","div","inlinealert-0",{"data-type":"warning","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMark","color":"var(--rui-color-warning)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":"Must be greater than or equal to the current authorised amount (incrementing with same amount allowed to extend capture deadline for Mastercard)"}],"\n",["$","li","li-1",{"children":"The sum of all increment amounts cannot exceed 5x the initial authorised amount (e.g., initial amount £100 allows up to £500 in total increments)"}],"\n"]}]}]]}]]}] 19ac:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"External reference for this incremental authorisation."}],"\n",["$","div","inlinealert-0",{"data-type":"tip","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"Lightbulb","color":"var(--rui-color-success)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":"Use your internal charge or invoice ID. This reference is returned in webhooks for easy matching to your system."}]}]]}]]}] 19ad:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Name of the line item."}]]}] 19ae:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Type of the line item."}]]}] 19af:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The number of units of the line item."}]]}] 19b0:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The measurement unit for the quantity, such as ",["$","code","code-0",{"children":"cm"}],", or ",["$","code","code-1",{"children":"kg"}],"."]}]]}] 19b1:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object representing the quantity details of a line item, including the amount and its associated unit of measurement."}]]}] 19b2:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The unit price of the line item."}]]}] 19b3:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The total amount to be paid for the line item, including taxes and discounts."}]]}] 19b4:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unique identifier of line item in the merchant's system."}]]}] 19b5:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The specific name or label of the discount applied to the line item."}]]}] 19b6:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The monetary value of the discount."}]]}] 19b7:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Details of a discount applied to the line item, including its name and monetary value."}]]}] 19b8:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A list of discounts applied to the line item. Each discount should be subtracted from the total amount payable for the item."}]]}] 19b9:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The specific name or designation of the tax applied to the line item."}]]}] 19ba:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The monetary value of the tax in minor currency units (e.g., cents for EUR)."}]]}] 19bb:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Details about a tax applied to the line item, including its name and the corresponding amount."}]]}] 19bc:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A list of taxes applied to the line item. Each tax should be added to the total amount payable for the item."}]]}] 19bd:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"URL to an image associated with the line item."}],"\n",["$","div","inlinealert-0",{"data-type":"warning","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMark","color":"var(--rui-color-warning)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"Restrictions:"}],["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["Must be a valid URI as defined by ",["$","a","a-0",{"href":"https://datatracker.ietf.org/doc/html/rfc3986","target":"_blank","rel":"noreferrer","children":"RFC 3986"}]]}],"\n",["$","li","li-1",{"children":["URI scheme is required and must be either ",["$","code","code-0",{"children":"http"}]," or ",["$","code","code-1",{"children":"https"}]]}],"\n",["$","li","li-2",{"children":["URI host is required and cannot be ",["$","code","code-0",{"children":"localhost"}]," or an IP address"]}],"\n",["$","li","li-3",{"children":["Max length: ",["$","code","code-0",{"children":"2000"}]]}],"\n",["$","li","li-4",{"children":["Reserved or invalid characters must be percent-encoded (for example, use ",["$","code","code-0",{"children":"%20"}]," instead of a space)"]}],"\n"]}]]}]]}]]}] 19be:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A list of URLs pointing to images related to the line item. These images can provide visual details or representations of the item."}]]}] 19bf:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Description of the line item."}]]}] 19c0:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An HTTP/HTTPS URL that links to more information about the line item, such as a product page or details."}],"\n",["$","div","inlinealert-0",{"data-type":"warning","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMark","color":"var(--rui-color-warning)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"Restrictions:"}],["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["Must be a valid URI as defined by ",["$","a","a-0",{"href":"https://datatracker.ietf.org/doc/html/rfc3986","target":"_blank","rel":"noreferrer","children":"RFC 3986"}]]}],"\n",["$","li","li-1",{"children":["URI scheme is required and must be either ",["$","code","code-0",{"children":"http"}]," or ",["$","code","code-1",{"children":"https"}]]}],"\n",["$","li","li-2",{"children":["URI host is required and cannot be ",["$","code","code-0",{"children":"localhost"}]," or an IP address"]}],"\n",["$","li","li-3",{"children":["Max length: ",["$","code","code-0",{"children":"2000"}]]}],"\n",["$","li","li-4",{"children":["Reserved or invalid characters must be percent-encoded (for example, use ",["$","code","code-0",{"children":"%20"}]," instead of a space)"]}],"\n"]}]]}]]}]]}] 19c1:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An array of line items included in the order. Each line item represents an individual product or service, along with its quantity, price, taxes, and discounts."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":"Required for merchants collecting payment for one or multiple products/services in one transaction. Omitting this information may trigger additional scrutiny and risk mitigation actions by Revolut."}]}]]}]]}] 19cd:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Increase the authorised amount on a pre-authorised order."}],"\n",["$","p","p-1",{"children":["This operation allows you to increment the authorised amount for orders created with ",["$","code","code-0",{"children":"authorisation_type: pre_authorisation"}]," and ",["$","code","code-1",{"children":"capture_mode: manual"}],"."]}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":"Currently, only card payments are supported."}]}]]}],"\n",["$","h3","h3-0",{"children":"Common use-cases"}],"\n",["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":"Hotel additional charges (e.g., minibar, room service)"}],"\n",["$","li","li-1",{"children":"Car rental damage or fuel charges"}],"\n",["$","li","li-2",{"children":"Equipment rental extensions"}],"\n"]}],"\n",["$","h5","h5-0",{"children":"How it works"}],"\n",["$","ol","ol-0",{"children":["\n",["$","li","li-0",{"children":["Create an order with ",["$","code","code-0",{"children":"capture_mode: manual"}]," and ",["$","code","code-1",{"children":"authorisation_type: pre_authorisation"}]]}],"\n",["$","li","li-1",{"children":"Take payment using one of our card payment solutions"}],"\n",["$","li","li-2",{"children":["When payment/order reaches ",["$","code","code-0",{"children":"authorised"}]," state, you can increment authorised amount"]}],"\n",["$","li","li-3",{"children":["When no more increments are expected, ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant/2025-10-16#capture-order","target":"_blank","rel":"noreferrer","children":"capture the order"}]," to complete the transaction"]}],"\n"]}],"\n",["$","div","inlinealert-1",{"data-type":"warning","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMark","color":"var(--rui-color-warning)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["Can only increment orders in ",["$","code","code-0",{"children":"authorised"}]," state"]}],"\n",["$","li","li-1",{"children":["Must have ",["$","code","code-0",{"children":"authorisation_type: pre_authorisation"}]," and ",["$","code","code-1",{"children":"capture_mode: manual"}]]}],"\n",["$","li","li-2",{"children":"Sum of all increment amounts cannot exceed 5x the initial amount"}],"\n",["$","li","li-3",{"children":"Maximum 10 increments per order"}],"\n",["$","li","li-4",{"children":"Process increments sequentially to avoid declines"}],"\n",["$","li","li-5",{"children":"Currently only supported for card payments"}],"\n"]}]}]]}],"\n",["$","div","inlinealert-2",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/operations/capture-and-settlement/advanced-authorisation/incremental-authorisation","target":"_blank","rel":"noreferrer","children":"Incremental authorisation guide"}]]}]}]]}]]}] 19ce:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["This parameter accepts the ",["$","a","a-0",{"href":"https://business.revolut.com/settings/apis?tab=merchant-api","target":"_blank","rel":"noreferrer","children":"Merchant API Secret key"}]," to authorise requests coming from the merchant's backend."]}],"\n",["$","p","p-1",{"children":["It ensures that ensures that each request is authenticated and authorised by verifying the secret key. The secret key should be included in all request headers as a ",["$","code","code-0",{"children":"Bearer"}]," token."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#authentication","target":"_blank","rel":"noreferrer","children":"Authentication"}]]}]}]]}]]}] 19cf:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The version of the Merchant API, specified in ",["$","code","code-0",{"children":"YYYY-MM-DD"}]," format."]}],"\n",["$","p","p-1",{"children":"If not specified, you will receive an error."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information about API versioning, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/reference/versioning/api-versions","target":"_blank","rel":"noreferrer","children":"API versions"}],"."]}]}]]}]]}] 19d0:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A UUID string, typically used to identify resources."}]]}] 19d1:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ID of the ",["$","code","code-0",{"children":"Order"}]," object."]}]]}] 1a0b:["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#cancel-order","target":"_blank","rel":"noreferrer","children":"Cancel the order"}] 1a0c:["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#cancel-order","target":"_blank","rel":"noreferrer","children":"Cancel the order"}] 1a0d:["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#cancel-order","target":"_blank","rel":"noreferrer","children":"Cancel the order"}] 1a0e:["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#cancel-order","target":"_blank","rel":"noreferrer","children":"Cancel the order"}] 1a0f:["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#cancel-order","target":"_blank","rel":"noreferrer","children":"Cancel the order"}] 19e1:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Each Merchant API request must contain an authorization header in the following format:"}],"\n","$L1a17","\n",["$","p","p-1",{"children":"To use this API, you need to generate API keys from your Revolut Business account. The Secret key is used in the authorization header for all server calls, while the Public key is provided with payment methods at checkout."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For detailed instructions on generating your API keys, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/get-started#generate-api-keys","target":"_blank","rel":"noreferrer","children":"Generate API keys"}],"."]}]}]]}]]}] 19c5:["$","div","request-application/json-example_minimal",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"
{\n  \"amount\": 100\n}
"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"amount\": 100\n}"}]}]]}] 1a18:T23fb,
{
  "amount": 770,
  "line_items": [
    {
      "name": "Example item 1",
      "type": "physical",
      "quantity": {
        "value": 2,
        "unit": "kg"
      },
      "unit_price_amount": 100,
      "total_amount": 170,
      "external_id": "external_id_123",
      "discounts": [
        {
          "name": "Discount 1",
          "amount": 50
        }
      ],
      "taxes": [
        {
          "name": "10% VAT",
          "amount": 20
        }
      ]
    },
    {
      "name": "Example item 2",
      "type": "service",
      "quantity": {
        "value": 10,
        "unit": "pieces"
      },
      "unit_price_amount": 100,
      "total_amount": 600,
      "external_id": "external_id_456",
      "discounts": [
        {
          "name": "Discount 2",
          "amount": 500
        }
      ],
      "taxes": [
        {
          "name": "10% VAT",
          "amount": 100
        }
      ]
    }
  ]
}
19c6:["$","div","request-application/json-example_with_line_items",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$1a18"}}]}]],"$L1a19"]}] 1a1a:T320a,
{
  "id": "65c4c739-113d-a608-9128-47c7ca90cbe3",
  "token": "ebc06202-061e-4d0f-8063-99195fad31fb",
  "type": "payment",
  "state": "completed",
  "created_at": "2024-02-08T12:21:13.022871Z",
  "updated_at": "2024-02-08T12:21:52.194601Z",
  "amount": 100,
  "currency": "GBP",
  "refunded_amount": 0,
  "outstanding_amount": 0,
  "capture_mode": "manual",
  "payments": [
    {
      "id": "65c4c748-bf0d-af8a-9d69-0fc92bc0ff94",
      "state": "captured",
      "created_at": "2024-02-08T12:21:28.803165Z",
      "updated_at": "2024-02-08T12:21:52.191352Z",
      "token": "74af5a2b-6722-4353-aaf1-cd5926883b60",
      "amount": 100,
      "currency": "GBP",
      "settled_amount": 100,
      "settled_currency": "GBP",
      "billing_address": {
        "country_code": "US",
        "postcode": "12345"
      },
      "risk_level": "low",
      "fees": [],
      "payer": {
        "email": "example.payer@example.com",
        "phone": "+447911123456"
      },
      "payment_method": {
        "type": "revolut_pay_card",
        "card_brand": "visa",
        "funding": "debit",
        "card_country_code": "US",
        "card_bin": "529999",
        "card_last_four": "0368",
        "card_expiry": "12/28",
        "cardholder_name": "Test Holder",
        "checks": {
          "three_ds": {
            "state": "verified",
            "version": 2
          }
        },
        "enforce_challenge": "automatic",
        "fingerprint": "1JAllfQY4POhBV8DaddAQ4LC5RbMP8LMLvUdJW4s5JY=",
        "network_transaction_id": "1234567890123456"
      }
    }
  ]
}
19c7:["$","div","200-application/json-captured_order_minimal",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$1a1a"}}]}]],"$L1a1b"]}] 1a1c:T53a2,
{
  "id": "65c4c739-113d-a608-9128-47c7ca90cbe3",
  "token": "ebc06202-061e-4d0f-8063-99195fad31fb",
  "type": "payment",
  "state": "completed",
  "created_at": "2024-02-08T12:21:13.022871Z",
  "updated_at": "2024-02-08T12:21:52.194601Z",
  "amount": 770,
  "currency": "GBP",
  "refunded_amount": 0,
  "outstanding_amount": 0,
  "capture_mode": "manual",
  "line_items": [
    {
      "name": "Example item 1",
      "type": "physical",
      "quantity": {
        "value": 2,
        "unit": "kg"
      },
      "unit_price_amount": 100,
      "total_amount": 170,
      "external_id": "external_id_123",
      "discounts": [
        {
          "name": "Discount 1",
          "amount": 50
        }
      ],
      "taxes": [
        {
          "name": "10% VAT",
          "amount": 20
        }
      ]
    },
    {
      "name": "Example item 2",
      "type": "service",
      "quantity": {
        "value": 10,
        "unit": "pieces"
      },
      "unit_price_amount": 100,
      "total_amount": 600,
      "external_id": "external_id_456",
      "discounts": [
        {
          "name": "Discount 2",
          "amount": 500
        }
      ],
      "taxes": [
        {
          "name": "10% VAT",
          "amount": 100
        }
      ]
    }
  ],
  "payments": [
    {
      "id": "65c4c748-bf0d-af8a-9d69-0fc92bc0ff94",
      "state": "captured",
      "created_at": "2024-02-08T12:21:28.803165Z",
      "updated_at": "2024-02-08T12:21:52.191352Z",
      "token": "74af5a2b-6722-4353-aaf1-cd5926883b60",
      "amount": 770,
      "currency": "GBP",
      "settled_amount": 770,
      "settled_currency": "GBP",
      "billing_address": {
        "country_code": "US",
        "postcode": "12345"
      },
      "risk_level": "low",
      "fees": [],
      "payer": {
        "email": "example.payer@example.com",
        "phone": "+447911123456"
      },
      "payment_method": {
        "type": "revolut_pay_card",
        "card_brand": "visa",
        "funding": "debit",
        "card_country_code": "US",
        "card_bin": "529999",
        "card_last_four": "0368",
        "card_expiry": "12/28",
        "cardholder_name": "Test Holder",
        "checks": {
          "three_ds": {
            "state": "verified",
            "version": 2
          }
        },
        "enforce_challenge": "automatic",
        "fingerprint": "1JAllfQY4POhBV8DaddAQ4LC5RbMP8LMLvUdJW4s5JY=",
        "network_transaction_id": "1234567890123456"
      }
    }
  ]
}
19c8:["$","div","200-application/json-captured_order_line_items",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$1a1c"}}]}]],"$L1a1d"]}] 1a1e:T46a,
{
  "code": "bad_request",
  "message": "Could not parse JSON",
  "timestamp": 1601296792533
}
19c9:["$","div","400-application/json-example-1",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$1a1e"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"code\": \"bad_request\",\n \"message\": \"Could not parse JSON\",\n \"timestamp\": 1601296792533\n}"}]}]]}] 1a1f:T46f,
{
  "code": "unauthenticated",
  "message": "Authentication failed",
  "timestamp": 1721049596461
}
19ca:["$","div","401-application/json-default",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$1a1f"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"code\": \"unauthenticated\",\n \"message\": \"Authentication failed\",\n \"timestamp\": 1721049596461\n}"}]}]]}] 1a20:T494,
{
  "code": "not_found",
  "message": "Order with id abfa5bbd-a20c-4a0e-be66-30e733454518 was not found",
  "timestamp": 1721050063886
}
19cb:["$","div","404-application/json-default",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$1a20"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"code\": \"not_found\",\n \"message\": \"Order with id abfa5bbd-a20c-4a0e-be66-30e733454518 was not found\",\n \"timestamp\": 1721050063886\n}"}]}]]}] 1a19:["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"amount\": 770,\n \"line_items\": [\n {\n \"name\": \"Example item 1\",\n \"type\": \"physical\",\n \"quantity\": {\n \"value\": 2,\n \"unit\": \"kg\"\n },\n \"unit_price_amount\": 100,\n \"total_amount\": 170,\n \"external_id\": \"external_id_123\",\n \"discounts\": [\n {\n \"name\": \"Discount 1\",\n \"amount\": 50\n }\n ],\n \"taxes\": [\n {\n \"name\": \"10% VAT\",\n \"amount\": 20\n }\n ]\n },\n {\n \"name\": \"Example item 2\",\n \"type\": \"service\",\n \"quantity\": {\n \"value\": 10,\n \"unit\": \"pieces\"\n },\n \"unit_price_amount\": 100,\n \"total_amount\": 600,\n \"external_id\": \"external_id_456\",\n \"discounts\": [\n {\n \"name\": \"Discount 2\",\n \"amount\": 500\n }\n ],\n \"taxes\": [\n {\n \"name\": \"10% VAT\",\n \"amount\": 100\n }\n ]\n }\n ]\n}"}]}] 1a21:T622,{ "id": "65c4c739-113d-a608-9128-47c7ca90cbe3", "token": "ebc06202-061e-4d0f-8063-99195fad31fb", "type": "payment", "state": "completed", "created_at": "2024-02-08T12:21:13.022871Z", "updated_at": "2024-02-08T12:21:52.194601Z", "amount": 100, "currency": "GBP", "refunded_amount": 0, "outstanding_amount": 0, "capture_mode": "manual", "payments": [ { "id": "65c4c748-bf0d-af8a-9d69-0fc92bc0ff94", "state": "captured", "created_at": "2024-02-08T12:21:28.803165Z", "updated_at": "2024-02-08T12:21:52.191352Z", "token": "74af5a2b-6722-4353-aaf1-cd5926883b60", "amount": 100, "currency": "GBP", "settled_amount": 100, "settled_currency": "GBP", "billing_address": { "country_code": "US", "postcode": "12345" }, "risk_level": "low", "fees": [], "payer": { "email": "example.payer@example.com", "phone": "+447911123456" }, "payment_method": { "type": "revolut_pay_card", "card_brand": "visa", "funding": "debit", "card_country_code": "US", "card_bin": "529999", "card_last_four": "0368", "card_expiry": "12/28", "cardholder_name": "Test Holder", "checks": { "three_ds": { "state": "verified", "version": 2 } }, "enforce_challenge": "automatic", "fingerprint": "1JAllfQY4POhBV8DaddAQ4LC5RbMP8LMLvUdJW4s5JY=", "network_transaction_id": "1234567890123456" } } ] }1a1b:["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"$1a21"}]}] 1a22:T9b2,{ "id": "65c4c739-113d-a608-9128-47c7ca90cbe3", "token": "ebc06202-061e-4d0f-8063-99195fad31fb", "type": "payment", "state": "completed", "created_at": "2024-02-08T12:21:13.022871Z", "updated_at": "2024-02-08T12:21:52.194601Z", "amount": 770, "currency": "GBP", "refunded_amount": 0, "outstanding_amount": 0, "capture_mode": "manual", "line_items": [ { "name": "Example item 1", "type": "physical", "quantity": { "value": 2, "unit": "kg" }, "unit_price_amount": 100, "total_amount": 170, "external_id": "external_id_123", "discounts": [ { "name": "Discount 1", "amount": 50 } ], "taxes": [ { "name": "10% VAT", "amount": 20 } ] }, { "name": "Example item 2", "type": "service", "quantity": { "value": 10, "unit": "pieces" }, "unit_price_amount": 100, "total_amount": 600, "external_id": "external_id_456", "discounts": [ { "name": "Discount 2", "amount": 500 } ], "taxes": [ { "name": "10% VAT", "amount": 100 } ] } ], "payments": [ { "id": "65c4c748-bf0d-af8a-9d69-0fc92bc0ff94", "state": "captured", "created_at": "2024-02-08T12:21:28.803165Z", "updated_at": "2024-02-08T12:21:52.191352Z", "token": "74af5a2b-6722-4353-aaf1-cd5926883b60", "amount": 770, "currency": "GBP", "settled_amount": 770, "settled_currency": "GBP", "billing_address": { "country_code": "US", "postcode": "12345" }, "risk_level": "low", "fees": [], "payer": { "email": "example.payer@example.com", "phone": "+447911123456" }, "payment_method": { "type": "revolut_pay_card", "card_brand": "visa", "funding": "debit", "card_country_code": "US", "card_bin": "529999", "card_last_four": "0368", "card_expiry": "12/28", "cardholder_name": "Test Holder", "checks": { "three_ds": { "state": "verified", "version": 2 } }, "enforce_challenge": "automatic", "fingerprint": "1JAllfQY4POhBV8DaddAQ4LC5RbMP8LMLvUdJW4s5JY=", "network_transaction_id": "1234567890123456" } } ] }1a1d:["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"$1a22"}]}] 19e2:["$","div","request-application/json-basic_increment",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"
{\n  \"amount\": 600\n}
"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"amount\": 600\n}"}]}]]}] 1a23:T11ad,
{
  "amount": 6000,
  "reference": "CHG-67890",
  "line_items": [
    {
      "name": "Minibar",
      "type": "physical",
      "quantity": {
        "value": 1
      },
      "unit_price_amount": 2500,
      "total_amount": 2500
    },
    {
      "name": "Room service",
      "type": "physical",
      "quantity": {
        "value": 1
      },
      "unit_price_amount": 3500,
      "total_amount": 3500
    }
  ]
}
19e3:["$","div","request-application/json-increment_with_additional",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$1a23"}}]}]],"$L1a24"]}] 1a25:T42f3,
{
  "id": "6920869a-8d8d-aefd-a3c3-8fe4690e4323",
  "token": "0823794d-28e9-4fdd-a130-3293ff9dd57b",
  "type": "payment",
  "state": "processing",
  "created_at": "2025-11-21T15:34:50.351537Z",
  "updated_at": "2025-11-21T15:35:12.123456Z",
  "amount": 500,
  "currency": "EUR",
  "outstanding_amount": 500,
  "capture_mode": "manual",
  "authorisation_type": "pre_authorisation",
  "incremental_authorisations": [
    {
      "new_amount": 600,
      "old_amount": 500,
      "state": "processing",
      "reference": "1263738"
    }
  ],
  "payments": [
    {
      "id": "696a4ce4-2aaf-a008-9f26-f47cf8ab1678",
      "state": "authorisation_started",
      "created_at": "2025-11-21T15:34:50.474085Z",
      "updated_at": "2025-11-21T15:35:12.300608Z",
      "token": "928f25b1-121c-4669-ab9f-d0b7a5804576",
      "amount": 600,
      "authorised_amount": 500,
      "currency": "EUR",
      "settled_amount": 500,
      "settled_currency": "EUR",
      "billing_address": {
        "country_code": "US",
        "postcode": "94102"
      },
      "risk_level": "low",
      "fees": [],
      "payer": {
        "email": "example.payer@example.com",
        "phone": "+447911123456"
      },
      "payment_method": {
        "type": "card",
        "card_brand": "visa",
        "funding": "debit",
        "card_country_code": "US",
        "card_bin": "424242",
        "card_last_four": "4242",
        "card_expiry": "12/35",
        "cardholder_name": "Example Customer",
        "checks": {
          "three_ds": {
            "eci": "05",
            "state": "verified",
            "version": 2
          },
          "cvv_verification": "not_processed",
          "address": "n_a",
          "postcode": "n_a",
          "cardholder": "n_a"
        },
        "fingerprint": "aadDmPDArelhtk5QK3zqccaPi39zEDp6/uKuUsA9LHE=",
        "network_transaction_id": "1234567890123456",
        "authorisation_code": "100000",
        "arn": "12345678912345678912345",
        "capture_deadline": "2025-11-28T15:34:50.513Z"
      }
    }
  ],
  "checkout_url": "https://checkout.revolut.com/payment-link/0823794d-28e9-4fdd-a130-3293ff9dd57b",
  "enforce_challenge": "automatic"
}
19e4:["$","div","200-application/json-increment_in_progress",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$1a25"}}]}]],"$L1a26"]}] 1a27:T40a4,
{
  "id": "6920869a-8d8d-aefd-a3c3-8fe4690e4323",
  "token": "0823794d-28e9-4fdd-a130-3293ff9dd57b",
  "type": "payment",
  "state": "authorised",
  "created_at": "2025-11-21T15:34:50.351537Z",
  "updated_at": "2025-11-21T15:35:15.789012Z",
  "amount": 600,
  "currency": "EUR",
  "outstanding_amount": 600,
  "capture_mode": "manual",
  "authorisation_type": "pre_authorisation",
  "incremental_authorisations": [
    {
      "new_amount": 600,
      "old_amount": 500,
      "state": "authorised",
      "reference": "1263738"
    }
  ],
  "payments": [
    {
      "id": "696a4ce4-2aaf-a008-9f26-f47cf8ab1678",
      "state": "authorised",
      "created_at": "2025-11-21T15:34:50.474085Z",
      "updated_at": "2025-11-21T15:35:15.789012Z",
      "token": "928f25b1-121c-4669-ab9f-d0b7a5804576",
      "amount": 600,
      "authorised_amount": 600,
      "currency": "EUR",
      "settled_amount": 600,
      "settled_currency": "EUR",
      "billing_address": {
        "country_code": "US",
        "postcode": "94102"
      },
      "risk_level": "low",
      "fees": [],
      "payer": {
        "email": "example.payer@example.com",
        "phone": "+447911123456"
      },
      "payment_method": {
        "type": "card",
        "card_brand": "visa",
        "funding": "debit",
        "card_country_code": "US",
        "card_bin": "424242",
        "card_last_four": "4242",
        "card_expiry": "12/35",
        "cardholder_name": "Example Customer",
        "checks": {
          "three_ds": {
            "eci": "05",
            "state": "verified",
            "version": 2
          },
          "cvv_verification": "not_processed",
          "address": "n_a",
          "postcode": "n_a",
          "cardholder": "n_a"
        },
        "fingerprint": "aadDmPDArelhtk5QK3zqccaPi39zEDp6/uKuUsA9LHE=",
        "network_transaction_id": "1234567890123456",
        "authorisation_code": "100000",
        "arn": "12345678912345678912345",
        "capture_deadline": "2025-11-28T15:34:50.513Z"
      }
    }
  ]
}
19e5:["$","div","200-application/json-increment_authorised",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$1a27"}}]}]],"$L1a28"]}] 1a29:T41c2,
{
  "id": "6920869a-8d8d-aefd-a3c3-8fe4690e4323",
  "token": "0823794d-28e9-4fdd-a130-3293ff9dd57b",
  "type": "payment",
  "state": "authorised",
  "created_at": "2025-11-21T15:34:50.351537Z",
  "updated_at": "2025-11-21T15:35:15.789012Z",
  "amount": 500,
  "currency": "EUR",
  "outstanding_amount": 500,
  "capture_mode": "manual",
  "authorisation_type": "pre_authorisation",
  "incremental_authorisations": [
    {
      "new_amount": 600,
      "old_amount": 500,
      "state": "declined",
      "reference": "1263738",
      "reason": "insufficient_funds"
    }
  ],
  "payments": [
    {
      "id": "696a4ce4-2aaf-a008-9f26-f47cf8ab1678",
      "state": "authorised",
      "created_at": "2025-11-21T15:34:50.474085Z",
      "updated_at": "2025-11-21T15:35:15.789012Z",
      "token": "928f25b1-121c-4669-ab9f-d0b7a5804576",
      "amount": 500,
      "authorised_amount": 500,
      "currency": "EUR",
      "settled_amount": 500,
      "settled_currency": "EUR",
      "billing_address": {
        "country_code": "US",
        "postcode": "94102"
      },
      "risk_level": "low",
      "fees": [],
      "payer": {
        "email": "example.payer@example.com",
        "phone": "+447911123456"
      },
      "payment_method": {
        "type": "card",
        "card_brand": "visa",
        "funding": "debit",
        "card_country_code": "US",
        "card_bin": "424242",
        "card_last_four": "4242",
        "card_expiry": "12/35",
        "cardholder_name": "Example Customer",
        "checks": {
          "three_ds": {
            "eci": "05",
            "state": "verified",
            "version": 2
          },
          "cvv_verification": "not_processed",
          "address": "n_a",
          "postcode": "n_a",
          "cardholder": "n_a"
        },
        "fingerprint": "aadDmPDArelhtk5QK3zqccaPi39zEDp6/uKuUsA9LHE=",
        "network_transaction_id": "1234567890123456",
        "authorisation_code": "100000",
        "arn": "12345678912345678912345",
        "capture_deadline": "2025-11-28T15:34:50.513Z"
      }
    }
  ]
}
19e6:["$","div","200-application/json-increment_declined",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$1a29"}}]}]],"$L1a2a"]}] 1a2b:T492,
{
  "code": "validation",
  "message": "New amount: 3 should be greater or equal to order amount: 500",
  "timestamp": 1768397646286
}
19e7:["$","div","400-application/json-invalid_amount",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$1a2b"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"code\": \"validation\",\n \"message\": \"New amount: 3 should be greater or equal to order amount: 500\",\n \"timestamp\": 1768397646286\n}"}]}]]}] 1a2c:T463,
{
  "code": "not_found",
  "message": "Order not found",
  "timestamp": 1768397646286
}
19e8:["$","div","404-application/json-default",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$1a2c"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"code\": \"not_found\",\n \"message\": \"Order not found\",\n \"timestamp\": 1768397646286\n}"}]}]]}] 1a2d:T4b0,
{
  "code": "bad_state",
  "message": "No authorised card not present payment found for order 69732536-0379-a2e2-8983-15e7184f8fc6.",
  "timestamp": 1768397646286
}
19e9:["$","div","422-application/json-invalid_state",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$1a2d"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"code\": \"bad_state\",\n \"message\": \"No authorised card not present payment found for order 69732536-0379-a2e2-8983-15e7184f8fc6.\",\n \"timestamp\": 1768397646286\n}"}]}]]}] 1a2e:T503,
{
  "code": "order_invalid_authorisation_type",
  "message": "Operation cannot be performed for order 697325ca-a9a2-a922-8df5-c603664da5a5 because order authorisation type is final and expected is pre_authorisation",
  "timestamp": 1768397646286
}
19ea:["$","div","422-application/json-invalid_auth_type",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$1a2e"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"code\": \"order_invalid_authorisation_type\",\n \"message\": \"Operation cannot be performed for order 697325ca-a9a2-a922-8df5-c603664da5a5 because order authorisation type is final and expected is pre_authorisation\",\n \"timestamp\": 1768397646286\n}"}]}]]}] 1a24:["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"amount\": 6000,\n \"reference\": \"CHG-67890\",\n \"line_items\": [\n {\n \"name\": \"Minibar\",\n \"type\": \"physical\",\n \"quantity\": {\n \"value\": 1\n },\n \"unit_price_amount\": 2500,\n \"total_amount\": 2500\n },\n {\n \"name\": \"Room service\",\n \"type\": \"physical\",\n \"quantity\": {\n \"value\": 1\n },\n \"unit_price_amount\": 3500,\n \"total_amount\": 3500\n }\n ]\n}"}]}] 1a2f:T887,{ "id": "6920869a-8d8d-aefd-a3c3-8fe4690e4323", "token": "0823794d-28e9-4fdd-a130-3293ff9dd57b", "type": "payment", "state": "processing", "created_at": "2025-11-21T15:34:50.351537Z", "updated_at": "2025-11-21T15:35:12.123456Z", "amount": 500, "currency": "EUR", "outstanding_amount": 500, "capture_mode": "manual", "authorisation_type": "pre_authorisation", "incremental_authorisations": [ { "new_amount": 600, "old_amount": 500, "state": "processing", "reference": "1263738" } ], "payments": [ { "id": "696a4ce4-2aaf-a008-9f26-f47cf8ab1678", "state": "authorisation_started", "created_at": "2025-11-21T15:34:50.474085Z", "updated_at": "2025-11-21T15:35:12.300608Z", "token": "928f25b1-121c-4669-ab9f-d0b7a5804576", "amount": 600, "authorised_amount": 500, "currency": "EUR", "settled_amount": 500, "settled_currency": "EUR", "billing_address": { "country_code": "US", "postcode": "94102" }, "risk_level": "low", "fees": [], "payer": { "email": "example.payer@example.com", "phone": "+447911123456" }, "payment_method": { "type": "card", "card_brand": "visa", "funding": "debit", "card_country_code": "US", "card_bin": "424242", "card_last_four": "4242", "card_expiry": "12/35", "cardholder_name": "Example Customer", "checks": { "three_ds": { "eci": "05", "state": "verified", "version": 2 }, "cvv_verification": "not_processed", "address": "n_a", "postcode": "n_a", "cardholder": "n_a" }, "fingerprint": "aadDmPDArelhtk5QK3zqccaPi39zEDp6/uKuUsA9LHE=", "network_transaction_id": "1234567890123456", "authorisation_code": "100000", "arn": "12345678912345678912345", "capture_deadline": "2025-11-28T15:34:50.513Z" } } ], "checkout_url": "https://checkout.revolut.com/payment-link/0823794d-28e9-4fdd-a130-3293ff9dd57b", "enforce_challenge": "automatic" }1a26:["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"$1a2f"}]}] 1a30:T7f4,{ "id": "6920869a-8d8d-aefd-a3c3-8fe4690e4323", "token": "0823794d-28e9-4fdd-a130-3293ff9dd57b", "type": "payment", "state": "authorised", "created_at": "2025-11-21T15:34:50.351537Z", "updated_at": "2025-11-21T15:35:15.789012Z", "amount": 600, "currency": "EUR", "outstanding_amount": 600, "capture_mode": "manual", "authorisation_type": "pre_authorisation", "incremental_authorisations": [ { "new_amount": 600, "old_amount": 500, "state": "authorised", "reference": "1263738" } ], "payments": [ { "id": "696a4ce4-2aaf-a008-9f26-f47cf8ab1678", "state": "authorised", "created_at": "2025-11-21T15:34:50.474085Z", "updated_at": "2025-11-21T15:35:15.789012Z", "token": "928f25b1-121c-4669-ab9f-d0b7a5804576", "amount": 600, "authorised_amount": 600, "currency": "EUR", "settled_amount": 600, "settled_currency": "EUR", "billing_address": { "country_code": "US", "postcode": "94102" }, "risk_level": "low", "fees": [], "payer": { "email": "example.payer@example.com", "phone": "+447911123456" }, "payment_method": { "type": "card", "card_brand": "visa", "funding": "debit", "card_country_code": "US", "card_bin": "424242", "card_last_four": "4242", "card_expiry": "12/35", "cardholder_name": "Example Customer", "checks": { "three_ds": { "eci": "05", "state": "verified", "version": 2 }, "cvv_verification": "not_processed", "address": "n_a", "postcode": "n_a", "cardholder": "n_a" }, "fingerprint": "aadDmPDArelhtk5QK3zqccaPi39zEDp6/uKuUsA9LHE=", "network_transaction_id": "1234567890123456", "authorisation_code": "100000", "arn": "12345678912345678912345", "capture_deadline": "2025-11-28T15:34:50.513Z" } } ] }1a28:["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"$1a30"}]}] 1a31:T818,{ "id": "6920869a-8d8d-aefd-a3c3-8fe4690e4323", "token": "0823794d-28e9-4fdd-a130-3293ff9dd57b", "type": "payment", "state": "authorised", "created_at": "2025-11-21T15:34:50.351537Z", "updated_at": "2025-11-21T15:35:15.789012Z", "amount": 500, "currency": "EUR", "outstanding_amount": 500, "capture_mode": "manual", "authorisation_type": "pre_authorisation", "incremental_authorisations": [ { "new_amount": 600, "old_amount": 500, "state": "declined", "reference": "1263738", "reason": "insufficient_funds" } ], "payments": [ { "id": "696a4ce4-2aaf-a008-9f26-f47cf8ab1678", "state": "authorised", "created_at": "2025-11-21T15:34:50.474085Z", "updated_at": "2025-11-21T15:35:15.789012Z", "token": "928f25b1-121c-4669-ab9f-d0b7a5804576", "amount": 500, "authorised_amount": 500, "currency": "EUR", "settled_amount": 500, "settled_currency": "EUR", "billing_address": { "country_code": "US", "postcode": "94102" }, "risk_level": "low", "fees": [], "payer": { "email": "example.payer@example.com", "phone": "+447911123456" }, "payment_method": { "type": "card", "card_brand": "visa", "funding": "debit", "card_country_code": "US", "card_bin": "424242", "card_last_four": "4242", "card_expiry": "12/35", "cardholder_name": "Example Customer", "checks": { "three_ds": { "eci": "05", "state": "verified", "version": 2 }, "cvv_verification": "not_processed", "address": "n_a", "postcode": "n_a", "cardholder": "n_a" }, "fingerprint": "aadDmPDArelhtk5QK3zqccaPi39zEDp6/uKuUsA9LHE=", "network_transaction_id": "1234567890123456", "authorisation_code": "100000", "arn": "12345678912345678912345", "capture_deadline": "2025-11-28T15:34:50.513Z" } } ] }1a2a:["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"$1a31"}]}] 19f0:["$","div","CodeBlock-0",{"className":"wzy01m0 _18b50nc0","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"
sequence,\ndeparture_airport_code,\narrival_airport_code,\nflight_number,\ntravel_date,\nairline_name,\nairline_code,
"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"sequence,\ndeparture_airport_code,\narrival_airport_code,\nflight_number,\ntravel_date,\nairline_name,\nairline_code,\n"}]}]]}] 19f1:["$","div","CodeBlock-0",{"className":"wzy01m0 _18b50nc0","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"
tickets_purchase,\njourney_legs,\nbooking_url
"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"tickets_purchase,\njourney_legs,\nbooking_url\n"}]}]]}] 19f2:["$","div","CodeBlock-0",{"className":"wzy01m0 _18b50nc0","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"
booking_id\ndrop_off_date\nrefundability
"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"booking_id\ndrop_off_date\nrefundability\n"}]}]]}] 19f3:["$","div","CodeBlock-0",{"className":"wzy01m0 _18b50nc0","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"
transactions[].id\ntransactions[].status\ntransactions[].recipient_wallet_id\nseller.id\nseller.name\nseller.website\nseller.phone\nseller.address\nseller.mcc\ncustomer.full_name\ncustomer.date_of_birth
"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"transactions[].id\ntransactions[].status\ntransactions[].recipient_wallet_id\nseller.id\nseller.name\nseller.website\nseller.phone\nseller.address\nseller.mcc\ncustomer.full_name\ncustomer.date_of_birth\n"}]}]]}] 19f4:["$","div","CodeBlock-0",{"className":"wzy01m0 _18b50nc0","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"
seller.id\nseller.name\nseller.website\nseller.phone\nseller.address
"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"seller.id\nseller.name\nseller.website\nseller.phone\nseller.address\n"}]}]]}] 19f5:["$","div","CodeBlock-0",{"className":"wzy01m0 _18b50nc0","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"
booking_id\nevents[].start_date\nevents[].end_date\nevents[].supplier\nevents[].tickets[].id
"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"booking_id\nevents[].start_date\nevents[].end_date\nevents[].supplier\nevents[].tickets[].id\n"}]}]]}] 19f6:["$","div","CodeBlock-0",{"className":"wzy01m0 _18b50nc0","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"
booking_id\ncheck_in_date\ncheck_out_date\nsupplier_payment_date
"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"booking_id\ncheck_in_date\ncheck_out_date\nsupplier_payment_date\n"}]}]]}] 1a0a:["$","div","CodeBlock-0",{"className":"wzy01m0 _18b50nc0","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"
'Authorization: Bearer <yourSecretApiKey>'
"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"'Authorization: Bearer '\n"}]}]]}] 1a10:["$","div","CodeBlock-0",{"className":"wzy01m0 _18b50nc0","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"
sequence,\ndeparture_airport_code,\narrival_airport_code,\nflight_number,\ntravel_date,\nairline_name,\nairline_code,
"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"sequence,\ndeparture_airport_code,\narrival_airport_code,\nflight_number,\ntravel_date,\nairline_name,\nairline_code,\n"}]}]]}] 1a11:["$","div","CodeBlock-0",{"className":"wzy01m0 _18b50nc0","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"
tickets_purchase,\njourney_legs,\nbooking_url
"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"tickets_purchase,\njourney_legs,\nbooking_url\n"}]}]]}] 1a12:["$","div","CodeBlock-0",{"className":"wzy01m0 _18b50nc0","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"
booking_id\ndrop_off_date\nrefundability
"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"booking_id\ndrop_off_date\nrefundability\n"}]}]]}] 1a13:["$","div","CodeBlock-0",{"className":"wzy01m0 _18b50nc0","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"
transactions[].id\ntransactions[].status\ntransactions[].recipient_wallet_id\nseller.id\nseller.name\nseller.website\nseller.phone\nseller.address\nseller.mcc\ncustomer.full_name\ncustomer.date_of_birth
"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"transactions[].id\ntransactions[].status\ntransactions[].recipient_wallet_id\nseller.id\nseller.name\nseller.website\nseller.phone\nseller.address\nseller.mcc\ncustomer.full_name\ncustomer.date_of_birth\n"}]}]]}] 1a14:["$","div","CodeBlock-0",{"className":"wzy01m0 _18b50nc0","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"
seller.id\nseller.name\nseller.website\nseller.phone\nseller.address
"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"seller.id\nseller.name\nseller.website\nseller.phone\nseller.address\n"}]}]]}] 1a15:["$","div","CodeBlock-0",{"className":"wzy01m0 _18b50nc0","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"
booking_id\nevents[].start_date\nevents[].end_date\nevents[].supplier\nevents[].tickets[].id
"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"booking_id\nevents[].start_date\nevents[].end_date\nevents[].supplier\nevents[].tickets[].id\n"}]}]]}] 1a16:["$","div","CodeBlock-0",{"className":"wzy01m0 _18b50nc0","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"
booking_id\ncheck_in_date\ncheck_out_date\nsupplier_payment_date
"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"booking_id\ncheck_in_date\ncheck_out_date\nsupplier_payment_date\n"}]}]]}] 1a17:["$","div","CodeBlock-0",{"className":"wzy01m0 _18b50nc0","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"
'Authorization: Bearer <yourSecretApiKey>'
"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"'Authorization: Bearer '\n"}]}]]}] 1a3b:T4c1,Automatic cancellation period for uncaptured orders, specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. After this period, the authorised payment is automatically cancelled and the order is cancelled. Maximum: 7 days = `P7D`. :::note The following limitations apply: - Cannot be a negative value. - Cannot be updated if the new value is less than or equal to the elapsed time since authorisation. **Failing scenario:** - Original value: 7 days - Time since authorisation: 3 days - Update value: 2 days In this scenario, an error is returned. **Successful scenario:** - Original value: 7 days - Time since authorisation: 3 days - Update value: 4 days In this scenario, the parameter can be updated. - Cannot be updated if cancellation is ≤ 30 minutes away. **Failing scenario:** - Original value: 12 hours - Time since authorisation: 11 hours 40 minutes In this scenario, an error is returned. **Successful scenario:** - Original value: 12 hours - Time since authorisation: 11 hours 20 minutes In this scenario, the parameter can be updated. :::1a42:T50a,Object containing information about a customer. If you have it, we strongly advise providing at least either `id`, `phone`, or `email`. Using the [Customers operations](https://developer.revolut.com/docs/api/merchant#tag-customers), you can manage customer instances. The following behaviours apply to different use cases: | Use case | API behavior | | -------- | ------------ | | Existing customer | If `id` was provided, we ignore other customer details and associate the customer with the order.

If either `email`, `phone`, or `full_name` was provided (without an existing customer's `id`), we always create a new customer, irrespective of another, existing customer object having the same details. | | New customer | If either `email`, `phone`, or `full_name` was provided, we create a new customer, irrespective of another customer object having the same details.

If `id` of a non-existent customer was provided, we return a `404` error, irrespective of other details provided. | :::note To avoid unintentional duplication of customer records, search for an existing customer by email or phone using the [List customers](https://developer.revolut.com/docs/api/merchant#retrieve-customer-list) endpoint first, then provide `customer.id` in the order. :::1a6b:T9bc,A unique identifier for a payment method, always 44 characters long. This fingerprint can be used to uniquely identify various payment methods. #### Fingerprint generation | Payment method | Description | | -------- | ----------- | | **All payment methods** | A fingerprint is generated for all payment methods, including cards, Revolut Pay (card, account-to-account payments), Apple Pay, and Google Pay. | | **Cards (Revolut Pay & Card Gateway)** | For cards, the fingerprint is based on the PAN. Cards processed via Revolut Pay and our card gateway will share the same fingerprint. Renewed cards (new expiry/CVV) retain the same fingerprint for efficient blocking. | | **Apple Pay & Google Pay** | Since Apple Pay and Google Pay provide us Device PANs (DPAN), the fingerprint is based on the DPAN provided by Apple/Google, not the connected card's PAN. This means that a new DPAN (and fingerprint) is generated for cards in case they are re-added to the customer's digital wallet, or added to different devices. | #### Detecting duplicate payment methods Fingerprints are a valuable tool for detecting duplicate payment methods by identifying if a payment method has been seen before. This capability, in turn, helps in preventing various types of misuse (e.g., exploitation of free trials, or association with known problematic accounts, which can be a form of fraud). To effectively use fingerprints for this purpose, you will need to create and maintain your own lists (e.g., blocklists of known problematic fingerprints, allowlists for trusted customers, or tracking frequently used fingerprints). The ideal way to utilise fingerprints is by combining them with a manual capture process. While automatic capture with subsequent refunds for problematic payments is possible, manual capture based on fingerprint validation is recommended. During your manual capture workflow, after a payment was authorised: - Check the fingerprint status by comparing it against your maintained lists and internal business rules. - If you decide to proceed with the payment (e.g., the fingerprint is not on a blocklist, or matches a trusted customer's previous payment method): [Capture the order](https://developer.revolut.com/docs/api/merchant#capture-order). - If you decide not to proceed with the payment (e.g., the fingerprint matches a known fraudulent fingerprint, or exhibits suspicious patterns): [Cancel the order](https://developer.revolut.com/docs/api/merchant#cancel-order).1a7d:T9bc,A unique identifier for a payment method, always 44 characters long. This fingerprint can be used to uniquely identify various payment methods. #### Fingerprint generation | Payment method | Description | | -------- | ----------- | | **All payment methods** | A fingerprint is generated for all payment methods, including cards, Revolut Pay (card, account-to-account payments), Apple Pay, and Google Pay. | | **Cards (Revolut Pay & Card Gateway)** | For cards, the fingerprint is based on the PAN. Cards processed via Revolut Pay and our card gateway will share the same fingerprint. Renewed cards (new expiry/CVV) retain the same fingerprint for efficient blocking. | | **Apple Pay & Google Pay** | Since Apple Pay and Google Pay provide us Device PANs (DPAN), the fingerprint is based on the DPAN provided by Apple/Google, not the connected card's PAN. This means that a new DPAN (and fingerprint) is generated for cards in case they are re-added to the customer's digital wallet, or added to different devices. | #### Detecting duplicate payment methods Fingerprints are a valuable tool for detecting duplicate payment methods by identifying if a payment method has been seen before. This capability, in turn, helps in preventing various types of misuse (e.g., exploitation of free trials, or association with known problematic accounts, which can be a form of fraud). To effectively use fingerprints for this purpose, you will need to create and maintain your own lists (e.g., blocklists of known problematic fingerprints, allowlists for trusted customers, or tracking frequently used fingerprints). The ideal way to utilise fingerprints is by combining them with a manual capture process. While automatic capture with subsequent refunds for problematic payments is possible, manual capture based on fingerprint validation is recommended. During your manual capture workflow, after a payment was authorised: - Check the fingerprint status by comparing it against your maintained lists and internal business rules. - If you decide to proceed with the payment (e.g., the fingerprint is not on a blocklist, or matches a trusted customer's previous payment method): [Capture the order](https://developer.revolut.com/docs/api/merchant#capture-order). - If you decide not to proceed with the payment (e.g., the fingerprint matches a known fraudulent fingerprint, or exhibits suspicious patterns): [Cancel the order](https://developer.revolut.com/docs/api/merchant#cancel-order).1a8f:T9bc,A unique identifier for a payment method, always 44 characters long. This fingerprint can be used to uniquely identify various payment methods. #### Fingerprint generation | Payment method | Description | | -------- | ----------- | | **All payment methods** | A fingerprint is generated for all payment methods, including cards, Revolut Pay (card, account-to-account payments), Apple Pay, and Google Pay. | | **Cards (Revolut Pay & Card Gateway)** | For cards, the fingerprint is based on the PAN. Cards processed via Revolut Pay and our card gateway will share the same fingerprint. Renewed cards (new expiry/CVV) retain the same fingerprint for efficient blocking. | | **Apple Pay & Google Pay** | Since Apple Pay and Google Pay provide us Device PANs (DPAN), the fingerprint is based on the DPAN provided by Apple/Google, not the connected card's PAN. This means that a new DPAN (and fingerprint) is generated for cards in case they are re-added to the customer's digital wallet, or added to different devices. | #### Detecting duplicate payment methods Fingerprints are a valuable tool for detecting duplicate payment methods by identifying if a payment method has been seen before. This capability, in turn, helps in preventing various types of misuse (e.g., exploitation of free trials, or association with known problematic accounts, which can be a form of fraud). To effectively use fingerprints for this purpose, you will need to create and maintain your own lists (e.g., blocklists of known problematic fingerprints, allowlists for trusted customers, or tracking frequently used fingerprints). The ideal way to utilise fingerprints is by combining them with a manual capture process. While automatic capture with subsequent refunds for problematic payments is possible, manual capture based on fingerprint validation is recommended. During your manual capture workflow, after a payment was authorised: - Check the fingerprint status by comparing it against your maintained lists and internal business rules. - If you decide to proceed with the payment (e.g., the fingerprint is not on a blocklist, or matches a trusted customer's previous payment method): [Capture the order](https://developer.revolut.com/docs/api/merchant#capture-order). - If you decide not to proceed with the payment (e.g., the fingerprint matches a known fraudulent fingerprint, or exhibits suspicious patterns): [Cancel the order](https://developer.revolut.com/docs/api/merchant#cancel-order).1aa1:T9bc,A unique identifier for a payment method, always 44 characters long. This fingerprint can be used to uniquely identify various payment methods. #### Fingerprint generation | Payment method | Description | | -------- | ----------- | | **All payment methods** | A fingerprint is generated for all payment methods, including cards, Revolut Pay (card, account-to-account payments), Apple Pay, and Google Pay. | | **Cards (Revolut Pay & Card Gateway)** | For cards, the fingerprint is based on the PAN. Cards processed via Revolut Pay and our card gateway will share the same fingerprint. Renewed cards (new expiry/CVV) retain the same fingerprint for efficient blocking. | | **Apple Pay & Google Pay** | Since Apple Pay and Google Pay provide us Device PANs (DPAN), the fingerprint is based on the DPAN provided by Apple/Google, not the connected card's PAN. This means that a new DPAN (and fingerprint) is generated for cards in case they are re-added to the customer's digital wallet, or added to different devices. | #### Detecting duplicate payment methods Fingerprints are a valuable tool for detecting duplicate payment methods by identifying if a payment method has been seen before. This capability, in turn, helps in preventing various types of misuse (e.g., exploitation of free trials, or association with known problematic accounts, which can be a form of fraud). To effectively use fingerprints for this purpose, you will need to create and maintain your own lists (e.g., blocklists of known problematic fingerprints, allowlists for trusted customers, or tracking frequently used fingerprints). The ideal way to utilise fingerprints is by combining them with a manual capture process. While automatic capture with subsequent refunds for problematic payments is possible, manual capture based on fingerprint validation is recommended. During your manual capture workflow, after a payment was authorised: - Check the fingerprint status by comparing it against your maintained lists and internal business rules. - If you decide to proceed with the payment (e.g., the fingerprint is not on a blocklist, or matches a trusted customer's previous payment method): [Capture the order](https://developer.revolut.com/docs/api/merchant#capture-order). - If you decide not to proceed with the payment (e.g., the fingerprint matches a known fraudulent fingerprint, or exhibits suspicious patterns): [Cancel the order](https://developer.revolut.com/docs/api/merchant#cancel-order).1aa7:T9bc,A unique identifier for a payment method, always 44 characters long. This fingerprint can be used to uniquely identify various payment methods. #### Fingerprint generation | Payment method | Description | | -------- | ----------- | | **All payment methods** | A fingerprint is generated for all payment methods, including cards, Revolut Pay (card, account-to-account payments), Apple Pay, and Google Pay. | | **Cards (Revolut Pay & Card Gateway)** | For cards, the fingerprint is based on the PAN. Cards processed via Revolut Pay and our card gateway will share the same fingerprint. Renewed cards (new expiry/CVV) retain the same fingerprint for efficient blocking. | | **Apple Pay & Google Pay** | Since Apple Pay and Google Pay provide us Device PANs (DPAN), the fingerprint is based on the DPAN provided by Apple/Google, not the connected card's PAN. This means that a new DPAN (and fingerprint) is generated for cards in case they are re-added to the customer's digital wallet, or added to different devices. | #### Detecting duplicate payment methods Fingerprints are a valuable tool for detecting duplicate payment methods by identifying if a payment method has been seen before. This capability, in turn, helps in preventing various types of misuse (e.g., exploitation of free trials, or association with known problematic accounts, which can be a form of fraud). To effectively use fingerprints for this purpose, you will need to create and maintain your own lists (e.g., blocklists of known problematic fingerprints, allowlists for trusted customers, or tracking frequently used fingerprints). The ideal way to utilise fingerprints is by combining them with a manual capture process. While automatic capture with subsequent refunds for problematic payments is possible, manual capture based on fingerprint validation is recommended. During your manual capture workflow, after a payment was authorised: - Check the fingerprint status by comparing it against your maintained lists and internal business rules. - If you decide to proceed with the payment (e.g., the fingerprint is not on a blocklist, or matches a trusted customer's previous payment method): [Capture the order](https://developer.revolut.com/docs/api/merchant#capture-order). - If you decide not to proceed with the payment (e.g., the fingerprint matches a known fraudulent fingerprint, or exhibits suspicious patterns): [Cancel the order](https://developer.revolut.com/docs/api/merchant#cancel-order).1ae8:T5ef,Object containing additional information about an airline booking associated with the order. Use this object to provide required data to enable **Revolut Flight Alerts**. This feature allows users to receive real-time flight updates such as check-in reminders, boarding alerts, and notifications for cancellations or delays in the Revolut app. To enable **Revolut Flight Alerts** functionalities in the Revolut app, the following fields are **required** on order creation or update, before capturing the order: ``` tickets_purchase, journey_legs, booking_url ``` :::note These are the specific data field requirements for merchants who must provide airline data. Note that these requirements can be extended on a case by case basis as decided by Revolut. | Required for airline/charter merchants | Required for OTA merchants | | -------------------------------------- | -------------------------- | |
  • `booking_id`
  • `fulfillment_date`
  • `passengers[].first_name`
  • `passengers[].last_name`
  • `journey_legs[].pnr`
  • `journey_legs[].sequence`
  • `journey_legs[].flight_number`
  • `journey_legs[].travel_date`
  • `journey_legs[].airline_code`
  • `journey_legs[].departure_airport_code`
  • `journey_legs[].arrival_airport_code`
|
  • `booking_id`
  • `fulfillment_date`
  • `passengers[].first_name`
  • `passengers[].last_name`
  • `journey_legs[].pnr`
  • `journey_legs[].arrival_airport_code`
| :::1b73:T480,You can set a dynamic statement descriptor for your orders by providing a custom suffix. A statement descriptor is the text shown on cardholders' bank or card statements, helping them recognise a transaction or merchant. This field can be used to send extra information with the statement descriptor for card transactions. The complete descriptor is built using the following format: `{base}*{suffix}`, where: - **`{base}`** is the existing descriptor configured in the Revolut Business dashboard (**Settings > Business account > Merchant profile > Statement descriptor**). - **`{suffix}`** is defined by the `statement_descriptor_suffix` field. :::note - If the combined descriptor's length (base + suffix) exceeds the character limits of card scheme providers, the final value will be truncated. For example if the limit is 22 characters, the base descriptor is `"base"` and the suffix is `"testdescriptorsuffix"`, the final descriptor becomes `"base*testdescriptorsuf"`. - The final statement descriptor shown on a cardholder's statement may vary by issuing bank, as some banks apply their own custom formatting or truncation rules. :::1b91:T50a,Object containing information about a customer. If you have it, we strongly advise providing at least either `id`, `phone`, or `email`. Using the [Customers operations](https://developer.revolut.com/docs/api/merchant#tag-customers), you can manage customer instances. The following behaviours apply to different use cases: | Use case | API behavior | | -------- | ------------ | | Existing customer | If `id` was provided, we ignore other customer details and associate the customer with the order.

If either `email`, `phone`, or `full_name` was provided (without an existing customer's `id`), we always create a new customer, irrespective of another, existing customer object having the same details. | | New customer | If either `email`, `phone`, or `full_name` was provided, we create a new customer, irrespective of another customer object having the same details.

If `id` of a non-existent customer was provided, we return a `404` error, irrespective of other details provided. | :::note To avoid unintentional duplication of customer records, search for an existing customer by email or phone using the [List customers](https://developer.revolut.com/docs/api/merchant#retrieve-customer-list) endpoint first, then provide `customer.id` in the order. :::1bc1:T4c1,Automatic cancellation period for uncaptured orders, specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. After this period, the authorised payment is automatically cancelled and the order is cancelled. Maximum: 7 days = `P7D`. :::note The following limitations apply: - Cannot be a negative value. - Cannot be updated if the new value is less than or equal to the elapsed time since authorisation. **Failing scenario:** - Original value: 7 days - Time since authorisation: 3 days - Update value: 2 days In this scenario, an error is returned. **Successful scenario:** - Original value: 7 days - Time since authorisation: 3 days - Update value: 4 days In this scenario, the parameter can be updated. - Cannot be updated if cancellation is ≤ 30 minutes away. **Failing scenario:** - Original value: 12 hours - Time since authorisation: 11 hours 40 minutes In this scenario, an error is returned. **Successful scenario:** - Original value: 12 hours - Time since authorisation: 11 hours 20 minutes In this scenario, the parameter can be updated. :::1bc6:T5ef,Object containing additional information about an airline booking associated with the order. Use this object to provide required data to enable **Revolut Flight Alerts**. This feature allows users to receive real-time flight updates such as check-in reminders, boarding alerts, and notifications for cancellations or delays in the Revolut app. To enable **Revolut Flight Alerts** functionalities in the Revolut app, the following fields are **required** on order creation or update, before capturing the order: ``` tickets_purchase, journey_legs, booking_url ``` :::note These are the specific data field requirements for merchants who must provide airline data. Note that these requirements can be extended on a case by case basis as decided by Revolut. | Required for airline/charter merchants | Required for OTA merchants | | -------------------------------------- | -------------------------- | |
  • `booking_id`
  • `fulfillment_date`
  • `passengers[].first_name`
  • `passengers[].last_name`
  • `journey_legs[].pnr`
  • `journey_legs[].sequence`
  • `journey_legs[].flight_number`
  • `journey_legs[].travel_date`
  • `journey_legs[].airline_code`
  • `journey_legs[].departure_airport_code`
  • `journey_legs[].arrival_airport_code`
|
  • `booking_id`
  • `fulfillment_date`
  • `passengers[].first_name`
  • `passengers[].last_name`
  • `journey_legs[].pnr`
  • `journey_legs[].arrival_airport_code`
| :::1c42:T480,You can set a dynamic statement descriptor for your orders by providing a custom suffix. A statement descriptor is the text shown on cardholders' bank or card statements, helping them recognise a transaction or merchant. This field can be used to send extra information with the statement descriptor for card transactions. The complete descriptor is built using the following format: `{base}*{suffix}`, where: - **`{base}`** is the existing descriptor configured in the Revolut Business dashboard (**Settings > Business account > Merchant profile > Statement descriptor**). - **`{suffix}`** is defined by the `statement_descriptor_suffix` field. :::note - If the combined descriptor's length (base + suffix) exceeds the character limits of card scheme providers, the final value will be truncated. For example if the limit is 22 characters, the base descriptor is `"base"` and the suffix is `"testdescriptorsuffix"`, the final descriptor becomes `"base*testdescriptorsuf"`. - The final statement descriptor shown on a cardholder's statement may vary by issuing bank, as some banks apply their own custom formatting or truncation rules. :::1b:["$","$7a","update-order",{"children":[["$","section",null,{"className":"y9a0do0","data-variant":"endpoint","children":["$","$L7b",null,{"responses":{"200":{"description":"Order updated","content":{"application/json":{"schema":{"title":"Order v5","type":"object","description":"To process the order from a credit or debit card, you create an `Order` object. You can then retrieve, capture, cancel, refund, or pay an order using its unique `id`. Alternatively, you can use its unique `token` to process a card payment with the Revolut Checkout Widget.","properties":{"id":{"type":"string","format":"uuid","description":"Permanent order ID used to retrieve, capture, cancel, or refund an order after authorization.","descriptionNode":"$L1a32"},"token":{"type":"string","description":"Temporary ID for the order, which expires when the payment is authorised.\n\nThe order `token` is used for [token-based initialisation](https://developer.revolut.com/docs/sdks/merchant-web-sdk/initialisation/token-based), and is returned by the `createOrder` callback in the following payment methods:\n\n- [Embedded Checkout](https://developer.revolut.com/docs/sdks/merchant-web-sdk/payment-methods/embedded-checkout#embedded-checkout-options-interface)\n- [Revolut Pay](https://developer.revolut.com/docs/sdks/merchant-web-sdk/payment-methods/revolut-pay#widget-payments-revolut-pay-options)\n- [Apple Pay and Google Pay](https://developer.revolut.com/docs/sdks/merchant-web-sdk/payment-methods/apple-pay-google-pay#payment-request-options-interface)\n- [Pay by Bank](https://developer.revolut.com/docs/sdks/merchant-web-sdk/payment-methods/pay-by-bank#pay-by-bank-options-interface)","descriptionNode":"$L1a33"},"type":{"type":"string","description":"The type of the order.","enum":"$19:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:orders:items:properties:type:enum","descriptionNode":"$L1a34"},"state":{"type":"string","description":"The state of the order in its lifecycle.\n\n| State | Description |\n|-------|-------------|\n| `pending` | Order created, awaiting payment |\n| `processing` | Payment is being processed |\n| `authorised` | Payment authorised but not yet captured (for manual capture) |\n| `completed` | Payment successfully captured and settled |\n| `cancelled` | Order was cancelled |\n| `failed` | Payment failed |\n\n:::info\nFor more information, see: [Order and payment lifecycle](https://developer.revolut.com/docs/guides/merchant/reference/order-lifecycle)\n:::","enum":"$19:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:orders:items:properties:state:enum","examples":"$19:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:orders:items:properties:state:examples","descriptionNode":"$L1a35"},"created_at":{"type":"string","description":"The date and time the order was created.","format":"date-time","descriptionNode":"$L1a36"},"updated_at":{"type":"string","description":"The date and time the order was last updated.","format":"date-time","descriptionNode":"$L1a37"},"description":{"type":"string","description":"The description of the order.","descriptionNode":"$L1a38"},"capture_mode":{"type":"string","description":"The capture mode of the order. `automatic` is used by default.\n\n| Parameter value | Description |\n| --------------- | ----------- |\n| `automatic` | The order is captured automatically after payment authorisation. |\n| `manual` | The order is not captured automatically. You must manually capture the order later. |\n\n:::info\nFor more information, see [Capture an order](https://developer.revolut.com/docs/api/merchant#capture-order).\n:::","default":"automatic","enum":"$19:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:orders:items:properties:capture_mode:enum","descriptionNode":"$L1a39"},"authorisation_type":{"type":"string","description":"The type of authorisation for the order. Used with manual capture mode. If omitted, `final` is used by default.\n\n### Pre-authorisation\n\nPre-authorisation allows you to reserve funds on a customer's card without immediately capturing them. This is useful for scenarios like:\n\n- Hotel bookings where the final amount may vary\n- Car rentals where additional charges may apply\n- Deposits that need to be held temporarily\n\n| Parameter value | Description |\n| --------------- | ----------- |\n| `final` | Standard authorisation for immediate or near-immediate capture. |\n| `pre_authorisation` | Reserve funds for later capture, used with manual capture mode. |\n\n:::note\nPre-authorisation must be used with `capture_mode: manual`. For more information, see [Capture an order](https://developer.revolut.com/docs/api/merchant#capture-order).\n:::","default":"final","enum":"$19:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:orders:items:properties:authorisation_type:enum","descriptionNode":"$L1a3a"},"cancel_authorised_after":{"type":"string","format":"duration","description":"$1a3b","descriptionNode":"$L1a3c"},"amount":{"type":"integer","description":"The order total expressed in minor currency units, according to the [ISO 4217 standard](https://en.wikipedia.org/wiki/ISO_4217). For example, `7034` in `EUR` corresponds to €70.34.\n\n:::info\n- Conversion between major and minor units varies by currency. For instance, `100` minor units equal £1.00 in `GBP`, whereas in `ISK` they represent 100 units. For more details, see the [ISO 4217 standard](https://en.wikipedia.org/wiki/ISO_4217).\n- If `line_items` are provided, the order `amount` must equal the sum of all line items' `total_amount`.\n- For card payments with a non-zero amount, the order `amount` must be at least **$0.005** (or equivalent in different currencies, calculated using Revolut's exchange rate on the payment date). Otherwise, card payments can't be performed.\n:::","descriptionNode":"$L1a3d"},"outstanding_amount":{"type":"integer","description":"The amount not yet paid for a given order (in minor currency units). For example, `7034` represents €70.34. \n\nThe value in this field may differ from `amount` if there are partial payments associated with the order.","descriptionNode":"$L1a3e"},"refunded_amount":{"type":"integer","description":"The amount that was refunded from the order (in minor currency units). For example, `7034` represents €70.34. \n\nThis applies to orders that have been refunded (i.e., orders of type `payment` that have a related `refund` order).","descriptionNode":"$L1a3f"},"currency":{"type":"string","format":"ISO 4217","minLength":3,"maxLength":3,"description":"[ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) currency code in upper case.\n\n:::info\nFor more information about the supported currencies, see: [Help Center](https://help.revolut.com/business/help/merchant-accounts/payments/in-which-currencies-can-i-accept-payments/).\n:::","descriptionNode":"$L1a40"},"settlement_currency":{"type":"string","description":"[ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) currency code in upper case. \n\nIf `settlement_currency` is different from the value of `currency`, the money will be exchanged when the amount is settled to your merchant account. In case of a refund or chargeback, the money will be exchanged to the order's initial `currency`.\n\nIf `settlement_currency` is not specified, this value is taken from `currency`.\n\n:::info\nFor more information about the supported currencies, see: [Help Center](https://help.revolut.com/business/help/merchant-accounts/payments/in-which-currencies-can-i-accept-payments/).\n:::","descriptionNode":"$L1a41"},"customer":{"type":"object","description":"$1a42","properties":{"id":{"type":"string","format":"uuid","description":"Permanent ID of a customer used to retrieve, update, delete a customer. This ID can also be used to link customer to an order.\n\n:::note\nIf you provide the customer's ID during order creation, no other customer data is required, they will be parsed automatically from the referenced customer object.\n:::","descriptionNode":"$L1a43"},"full_name":{"type":"string","description":"The full name of the customer.","descriptionNode":"$L1a44"},"phone":{"type":"string","description":"The phone number of the customer in [E.164 format](https://en.wikipedia.org/wiki/E.164).","descriptionNode":"$L1a45"},"email":{"type":"string","format":"email","description":"The email address of the customer.","descriptionNode":"$L1a46"},"date_of_birth":{"type":"string","format":"date","description":"The birth date of the customer.","descriptionNode":"$L1a47"}},"descriptionNode":"$L1a48"},"payments":{"type":"array","description":"The details of all the payments that have been made towards this order (successful or unsuccessful).","items":{"type":"object","description":"Represents a payment for an order.\n\nFor pre-authorised payments, the `authorised_amount` field tracks the currently authorised amount, which may differ from `amount` during incremental authorisation processing.","properties":{"id":{"type":"string","format":"uuid","description":"The ID of the payment.","descriptionNode":"$L1a49"},"state":{"type":"string","description":"The status of the payment.","enum":"$21:props:children:0:props:children:props:responses:200:content:application/json:schema:items:properties:state:enum","descriptionNode":"$L1a4a"},"decline_reason":{"type":"string","description":"The reason for a `failed` or `declined` payment.\n\nA failed or declined payment can result from multiple reasons. To learn more, check our [failure reasons](https://developer.revolut.com/docs/guides/merchant/reference/error-codes/decline-reasons).","enum":"$21:props:children:0:props:children:props:responses:200:content:application/json:schema:items:properties:decline_reason:enum","descriptionNode":"$L1a4b"},"bank_message":{"type":"string","description":"The reason for a `failed` or `declined` payment, sent by the financial institution processing the payment.","descriptionNode":"$L1a4c"},"created_at":{"type":"string","format":"date-time","description":"The date and time the payment was created.","descriptionNode":"$L1a4d"},"updated_at":{"type":"string","format":"date-time","description":"The date and time the payment was last updated.","descriptionNode":"$L1a4e"},"token":{"type":"string","format":"uuid","description":"Temporary token of the payment used to fetch the reward offer during checkout and link user registrations to the given offers. \n\nThe token is only valid for a limited time.","descriptionNode":"$L1a4f"},"amount":{"type":"integer","format":"int64","minimum":0,"description":"The payment amount in minor units (e.g., cents). The value of this field depends on the payment type and state.\n\n| Payment type | State | Amount value |\n|--------------|-------|--------------|\n| Standard payment | Any | Total payment amount |\n| Pre-authorised payment | `authorisation_started` | New amount being authorised (during increment processing) |\n| Pre-authorised payment | `authorised` | Currently authorised amount (equals `authorised_amount`) |\n\n:::info\nFor pre-authorised payments, see the `authorised_amount` field for tracking the currently authorised amount separately.\n:::","examples":"$21:props:children:0:props:children:props:responses:200:content:application/json:schema:items:properties:amount:examples","descriptionNode":"$L1a50"},"authorised_amount":{"type":"integer","description":"The currently authorised amount for this payment (in minor units).\n\nFor pre-authorised payments with incremental authorization:\n- Initially equals the `amount` field\n- Remains unchanged during increment processing\n- Updates to new amount upon successful increment\n- Remains at original amount if increment is declined\n\nFor standard payments, this field may not be present or will equal the `amount` field.","examples":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:authorised_amount:examples","descriptionNode":"$L1a51"},"currency":{"type":"string","format":"ISO 4217","minLength":3,"maxLength":3,"description":"[ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) currency code in upper case.\n\n:::info\nFor more information about the supported currencies, see: [Help Center](https://help.revolut.com/business/help/merchant-accounts/payments/in-which-currencies-can-i-accept-payments/).\n:::","descriptionNode":"$L1a52"},"settled_amount":{"type":"integer","description":"The amount of the settled payment (minor currency unit). For example, `7034` stands for €70.34.","descriptionNode":"$L1a53"},"settled_currency":{"type":"string","description":"The currency of the settled payment. [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) currency code in upper case.\n\n:::info\nFor more information about the supported currencies, see: [Help Center](https://help.revolut.com/business/help/merchant-accounts/payments/in-which-currencies-can-i-accept-payments/).\n:::","descriptionNode":"$L1a54"},"payment_method":{"type":"object","description":"The details of the payment method used to make the payment.","discriminator":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:discriminator","oneOf":[{"type":"object","description":"Object containing details of a card used via Apple Pay.","properties":{"id":{"type":"string","format":"uuid","description":"ID of the saved payment method.\n\n:::note\nThe `id` parameter is only returned when the payment method is saved.\n:::","descriptionNode":"$L1a55"},"type":{"type":"string","enum":"$21:props:children:0:props:children:props:responses:200:content:application/json:schema:items:properties:payment_method:oneOf:2:properties:type:enum","description":"The type of payment method used to pay for the order.\n\nAvailable values:\n\n| Payment method `type` | Description |\n| --------------------- | ----------- |\n| `apple_pay` | The customer paid the order using Apple Pay. |\n| `card` | The customer paid the order using their credit or debit card. |\n| `google_pay` | The customer paid the order using Google Pay. |\n| `revolut_pay_card` | The customer paid the order via Revolut Pay using their credit or debit card. |\n| `revolut_pay_account` | The customer paid the order via Revolut Pay using their Revolut account. |\n| `sepa_direct_debit` | The customer paid the order using SEPA Direct Debit. |","descriptionNode":"$L1a56"},"card_brand":{"type":"string","description":"The type of the card.","enum":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:0:properties:card_brand:enum","descriptionNode":"$L1a57"},"funding":{"type":"string","description":"The type of card funding.","enum":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:0:properties:funding:enum","descriptionNode":"$L1a58"},"card_country_code":{"type":"string","description":"The 2-letter country code of the country where the card was issued.","descriptionNode":"$L1a59"},"card_bin":{"type":"string","description":"The BIN of the card.","minLength":6,"maxLength":6,"descriptionNode":"$L1a5a"},"card_last_four":{"type":"string","description":"The last four digits of the card number.","minLength":4,"maxLength":4,"descriptionNode":"$L1a5b"},"card_expiry":{"type":"string","format":"MM/YY","description":"The expiry date of the card in the format of MM/YY.","descriptionNode":"$L1a5c"},"cardholder_name":{"type":"string","description":"The name of the cardholder.","descriptionNode":"$L1a5d"},"checks":{"type":"object","description":"The details of the check for card payment. Only for orders with successful payments.","properties":{"three_ds":{"type":"object","description":"The details of the 3D Secure check. Only for orders with successful payments.\n\n:::note\nNot returned for Apple Pay and Google Pay payments.\n:::","properties":{"eci":{"type":"string","description":"The Electronic Commerce Indicator (ECI) value corresponds to the authentication result and indicates the level of security used when the payment information was provided.","descriptionNode":"$L1a5e"},"state":{"type":"string","description":"The result of 3D Secure check.","enum":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:0:properties:checks:properties:three_ds:properties:state:enum","descriptionNode":"$L1a5f"},"version":{"type":"integer","description":"The 3D Secure version.","descriptionNode":"$L1a60"}},"descriptionNode":"$L1a61"},"cvv_verification":{"type":"string","description":"The result of CVV verification.\n\n| Parameter value | Description |\n| ----- | ----------- |\n| `match` | CVV matches the card's CVV |\n| `not_match` | CVV does not match the card's CVV |\n| `incorrect` | CVV format is incorrect for this type of card |\n| `not_processed` | CVV verification was not performed |","enum":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:0:properties:checks:properties:cvv_verification:enum","descriptionNode":"$L1a62"},"address":{"type":"string","description":"The result of address verification.","enum":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:0:properties:checks:properties:address:enum","descriptionNode":"$L1a63"},"postcode":{"type":"string","description":"The result of postcode verification.","enum":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:0:properties:checks:properties:postcode:enum","descriptionNode":"$L1a64"},"cardholder":{"type":"string","description":"The result of cardholder verification.","enum":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:0:properties:checks:properties:cardholder:enum","descriptionNode":"$L1a65"}},"descriptionNode":"$L1a66"},"authorisation_code":{"type":"string","description":"The authorisation code (or auth code) is a short, alphanumeric code returned by the cardholder's issuing bank to the merchant's terminal or payment gateway.\n\nIt serves as confirmation that the transaction has been approved and funds are available.","pattern":"^[a-zA-Z0-9]{2,6}$","minLength":2,"maxLength":6,"examples":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:0:properties:authorisation_code:examples","descriptionNode":"$L1a67"},"arn":{"type":"string","description":"Acquirer Reference Number (ARN) of the payment.\n\n:::note\nOnly returned for refund payments made by a card.\n:::","minLength":23,"maxLength":23,"examples":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:0:properties:arn:examples","descriptionNode":"$L1a68"},"capture_deadline":{"type":"string","format":"date-time","description":"The date and time by which the payment must be captured.\n\nAfter this deadline, the authorised funds may be automatically released by the card issuer.","descriptionNode":"$L1a69"},"terminal_hardware_id":{"type":"string","description":"The hardware identifier of the Revolut Terminal device used to process the payment.\n\n:::note\nOnly present for card-present transactions processed via Revolut Terminal.\n:::","descriptionNode":"$L1a6a"},"fingerprint":{"type":"string","minLength":44,"maxLength":44,"description":"$1a6b","examples":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:0:properties:fingerprint:examples","descriptionNode":"$L1a6c"},"network_transaction_id":{"type":"string","description":"The Network Transaction ID (NTI) is a unique identifier assigned by the card scheme (e.g., Visa or Mastercard) to a card transaction.\n\nIt can be used to trace the transaction across the payment network, link recurring or instalment payments to the original authorisation, and support dispute resolution.","descriptionNode":"$L1a6d"}},"required":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:0:required","descriptionNode":"$L1a6e"},{"type":"object","description":"Object containing details of the card used for the payment.","properties":{"id":{"type":"string","format":"uuid","description":"ID of the saved payment method.\n\n:::note\nThe `id` parameter is only returned when the payment method is saved.\n:::","descriptionNode":"$L1a6f"},"type":{"type":"string","enum":"$21:props:children:0:props:children:props:responses:200:content:application/json:schema:items:properties:payment_method:oneOf:2:properties:type:enum","description":"The type of payment method used to pay for the order.\n\nAvailable values:\n\n| Payment method `type` | Description |\n| --------------------- | ----------- |\n| `apple_pay` | The customer paid the order using Apple Pay. |\n| `card` | The customer paid the order using their credit or debit card. |\n| `google_pay` | The customer paid the order using Google Pay. |\n| `revolut_pay_card` | The customer paid the order via Revolut Pay using their credit or debit card. |\n| `revolut_pay_account` | The customer paid the order via Revolut Pay using their Revolut account. |\n| `sepa_direct_debit` | The customer paid the order using SEPA Direct Debit. |","descriptionNode":"$L1a70"},"card_brand":{"type":"string","description":"The type of the card.","enum":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:1:properties:card_brand:enum","descriptionNode":"$L1a71"},"funding":{"type":"string","description":"The type of card funding.","enum":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:1:properties:funding:enum","descriptionNode":"$L1a72"},"card_country_code":{"type":"string","description":"The 2-letter country code of the country where the card was issued.","descriptionNode":"$L1a73"},"card_bin":{"type":"string","description":"The BIN of the card.","minLength":6,"maxLength":6,"descriptionNode":"$L1a74"},"card_last_four":{"type":"string","description":"The last four digits of the card number.","minLength":4,"maxLength":4,"descriptionNode":"$L1a75"},"card_expiry":{"type":"string","format":"MM/YY","description":"The expiry date of the card in the format of MM/YY.","descriptionNode":"$L1a76"},"cardholder_name":{"type":"string","description":"The name of the cardholder.","descriptionNode":"$L1a77"},"checks":{"type":"object","description":"The details of the check for card payment. Only for orders with successful payments.","properties":{"three_ds":"$1b:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payments:items:properties:payment_method:oneOf:0:properties:checks:properties:three_ds","cvv_verification":"$1b:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payments:items:properties:payment_method:oneOf:0:properties:checks:properties:cvv_verification","address":"$1b:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payments:items:properties:payment_method:oneOf:0:properties:checks:properties:address","postcode":"$1b:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payments:items:properties:payment_method:oneOf:0:properties:checks:properties:postcode","cardholder":"$1b:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payments:items:properties:payment_method:oneOf:0:properties:checks:properties:cardholder"},"descriptionNode":"$L1a78"},"authorisation_code":{"type":"string","description":"The authorisation code (or auth code) is a short, alphanumeric code returned by the cardholder's issuing bank to the merchant's terminal or payment gateway.\n\nIt serves as confirmation that the transaction has been approved and funds are available.","pattern":"^[a-zA-Z0-9]{2,6}$","minLength":2,"maxLength":6,"examples":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:0:properties:authorisation_code:examples","descriptionNode":"$L1a79"},"arn":{"type":"string","description":"Acquirer Reference Number (ARN) of the payment.\n\n:::note\nOnly returned for refund payments made by a card.\n:::","minLength":23,"maxLength":23,"examples":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:0:properties:arn:examples","descriptionNode":"$L1a7a"},"capture_deadline":{"type":"string","format":"date-time","description":"The date and time by which the payment must be captured.\n\nAfter this deadline, the authorised funds may be automatically released by the card issuer.","descriptionNode":"$L1a7b"},"terminal_hardware_id":{"type":"string","description":"The hardware identifier of the Revolut Terminal device used to process the payment.\n\n:::note\nOnly present for card-present transactions processed via Revolut Terminal.\n:::","descriptionNode":"$L1a7c"},"fingerprint":{"type":"string","minLength":44,"maxLength":44,"description":"$1a7d","examples":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:0:properties:fingerprint:examples","descriptionNode":"$L1a7e"},"network_transaction_id":{"type":"string","description":"The Network Transaction ID (NTI) is a unique identifier assigned by the card scheme (e.g., Visa or Mastercard) to a card transaction.\n\nIt can be used to trace the transaction across the payment network, link recurring or instalment payments to the original authorisation, and support dispute resolution.","descriptionNode":"$L1a7f"}},"required":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:1:required","descriptionNode":"$L1a80"},{"type":"object","description":"Object containing details of a card used via Google Pay.","properties":{"id":{"type":"string","format":"uuid","description":"ID of the saved payment method.\n\n:::note\nThe `id` parameter is only returned when the payment method is saved.\n:::","descriptionNode":"$L1a81"},"type":{"type":"string","enum":"$21:props:children:0:props:children:props:responses:200:content:application/json:schema:items:properties:payment_method:oneOf:2:properties:type:enum","description":"The type of payment method used to pay for the order.\n\nAvailable values:\n\n| Payment method `type` | Description |\n| --------------------- | ----------- |\n| `apple_pay` | The customer paid the order using Apple Pay. |\n| `card` | The customer paid the order using their credit or debit card. |\n| `google_pay` | The customer paid the order using Google Pay. |\n| `revolut_pay_card` | The customer paid the order via Revolut Pay using their credit or debit card. |\n| `revolut_pay_account` | The customer paid the order via Revolut Pay using their Revolut account. |\n| `sepa_direct_debit` | The customer paid the order using SEPA Direct Debit. |","descriptionNode":"$L1a82"},"card_brand":{"type":"string","description":"The type of the card.","enum":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:2:properties:card_brand:enum","descriptionNode":"$L1a83"},"funding":{"type":"string","description":"The type of card funding.","enum":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:2:properties:funding:enum","descriptionNode":"$L1a84"},"card_country_code":{"type":"string","description":"The 2-letter country code of the country where the card was issued.","descriptionNode":"$L1a85"},"card_bin":{"type":"string","description":"The BIN of the card.","minLength":6,"maxLength":6,"descriptionNode":"$L1a86"},"card_last_four":{"type":"string","description":"The last four digits of the card number.","minLength":4,"maxLength":4,"descriptionNode":"$L1a87"},"card_expiry":{"type":"string","format":"MM/YY","description":"The expiry date of the card in the format of MM/YY.","descriptionNode":"$L1a88"},"cardholder_name":{"type":"string","description":"The name of the cardholder.","descriptionNode":"$L1a89"},"checks":{"type":"object","description":"The details of the check for card payment. Only for orders with successful payments.","properties":{"three_ds":"$1b:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payments:items:properties:payment_method:oneOf:0:properties:checks:properties:three_ds","cvv_verification":"$1b:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payments:items:properties:payment_method:oneOf:0:properties:checks:properties:cvv_verification","address":"$1b:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payments:items:properties:payment_method:oneOf:0:properties:checks:properties:address","postcode":"$1b:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payments:items:properties:payment_method:oneOf:0:properties:checks:properties:postcode","cardholder":"$1b:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payments:items:properties:payment_method:oneOf:0:properties:checks:properties:cardholder"},"descriptionNode":"$L1a8a"},"authorisation_code":{"type":"string","description":"The authorisation code (or auth code) is a short, alphanumeric code returned by the cardholder's issuing bank to the merchant's terminal or payment gateway.\n\nIt serves as confirmation that the transaction has been approved and funds are available.","pattern":"^[a-zA-Z0-9]{2,6}$","minLength":2,"maxLength":6,"examples":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:0:properties:authorisation_code:examples","descriptionNode":"$L1a8b"},"arn":{"type":"string","description":"Acquirer Reference Number (ARN) of the payment.\n\n:::note\nOnly returned for refund payments made by a card.\n:::","minLength":23,"maxLength":23,"examples":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:0:properties:arn:examples","descriptionNode":"$L1a8c"},"capture_deadline":{"type":"string","format":"date-time","description":"The date and time by which the payment must be captured.\n\nAfter this deadline, the authorised funds may be automatically released by the card issuer.","descriptionNode":"$L1a8d"},"terminal_hardware_id":{"type":"string","description":"The hardware identifier of the Revolut Terminal device used to process the payment.\n\n:::note\nOnly present for card-present transactions processed via Revolut Terminal.\n:::","descriptionNode":"$L1a8e"},"fingerprint":{"type":"string","minLength":44,"maxLength":44,"description":"$1a8f","examples":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:0:properties:fingerprint:examples","descriptionNode":"$L1a90"},"network_transaction_id":{"type":"string","description":"The Network Transaction ID (NTI) is a unique identifier assigned by the card scheme (e.g., Visa or Mastercard) to a card transaction.\n\nIt can be used to trace the transaction across the payment network, link recurring or instalment payments to the original authorisation, and support dispute resolution.","descriptionNode":"$L1a91"}},"required":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:2:required","descriptionNode":"$L1a92"},{"type":"object","description":"Object containing details of a card used via Revolut Pay.","properties":{"id":{"type":"string","format":"uuid","description":"ID of the saved payment method.\n\n:::note\nThe `id` parameter is only returned when the payment method is saved.\n:::","descriptionNode":"$L1a93"},"type":{"type":"string","enum":"$21:props:children:0:props:children:props:responses:200:content:application/json:schema:items:properties:payment_method:oneOf:2:properties:type:enum","description":"The type of payment method used to pay for the order.\n\nAvailable values:\n\n| Payment method `type` | Description |\n| --------------------- | ----------- |\n| `apple_pay` | The customer paid the order using Apple Pay. |\n| `card` | The customer paid the order using their credit or debit card. |\n| `google_pay` | The customer paid the order using Google Pay. |\n| `revolut_pay_card` | The customer paid the order via Revolut Pay using their credit or debit card. |\n| `revolut_pay_account` | The customer paid the order via Revolut Pay using their Revolut account. |\n| `sepa_direct_debit` | The customer paid the order using SEPA Direct Debit. |","descriptionNode":"$L1a94"},"card_brand":{"type":"string","description":"The type of the card.","enum":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:3:properties:card_brand:enum","descriptionNode":"$L1a95"},"funding":{"type":"string","description":"The type of card funding.","enum":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:3:properties:funding:enum","descriptionNode":"$L1a96"},"card_country_code":{"type":"string","description":"The 2-letter country code of the country where the card was issued.","descriptionNode":"$L1a97"},"card_bin":{"type":"string","description":"The BIN of the card.","minLength":6,"maxLength":6,"descriptionNode":"$L1a98"},"card_last_four":{"type":"string","description":"The last four digits of the card number.","minLength":4,"maxLength":4,"descriptionNode":"$L1a99"},"card_expiry":{"type":"string","format":"MM/YY","description":"The expiry date of the card in the format of MM/YY.","descriptionNode":"$L1a9a"},"cardholder_name":{"type":"string","description":"The name of the cardholder.","descriptionNode":"$L1a9b"},"checks":{"type":"object","description":"The details of the check for card payment. Only for orders with successful payments.","properties":{"three_ds":"$1b:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payments:items:properties:payment_method:oneOf:0:properties:checks:properties:three_ds","cvv_verification":"$1b:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payments:items:properties:payment_method:oneOf:0:properties:checks:properties:cvv_verification","address":"$1b:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payments:items:properties:payment_method:oneOf:0:properties:checks:properties:address","postcode":"$1b:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payments:items:properties:payment_method:oneOf:0:properties:checks:properties:postcode","cardholder":"$1b:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payments:items:properties:payment_method:oneOf:0:properties:checks:properties:cardholder"},"descriptionNode":"$L1a9c"},"authorisation_code":{"type":"string","description":"The authorisation code (or auth code) is a short, alphanumeric code returned by the cardholder's issuing bank to the merchant's terminal or payment gateway.\n\nIt serves as confirmation that the transaction has been approved and funds are available.","pattern":"^[a-zA-Z0-9]{2,6}$","minLength":2,"maxLength":6,"examples":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:0:properties:authorisation_code:examples","descriptionNode":"$L1a9d"},"arn":{"type":"string","description":"Acquirer Reference Number (ARN) of the payment.\n\n:::note\nOnly returned for refund payments made by a card.\n:::","minLength":23,"maxLength":23,"examples":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:0:properties:arn:examples","descriptionNode":"$L1a9e"},"capture_deadline":{"type":"string","format":"date-time","description":"The date and time by which the payment must be captured.\n\nAfter this deadline, the authorised funds may be automatically released by the card issuer.","descriptionNode":"$L1a9f"},"terminal_hardware_id":{"type":"string","description":"The hardware identifier of the Revolut Terminal device used to process the payment.\n\n:::note\nOnly present for card-present transactions processed via Revolut Terminal.\n:::","descriptionNode":"$L1aa0"},"fingerprint":{"type":"string","minLength":44,"maxLength":44,"description":"$1aa1","examples":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:0:properties:fingerprint:examples","descriptionNode":"$L1aa2"},"network_transaction_id":{"type":"string","description":"The Network Transaction ID (NTI) is a unique identifier assigned by the card scheme (e.g., Visa or Mastercard) to a card transaction.\n\nIt can be used to trace the transaction across the payment network, link recurring or instalment payments to the original authorisation, and support dispute resolution.","descriptionNode":"$L1aa3"}},"required":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:3:required","descriptionNode":"$L1aa4"},{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"ID of the saved payment method.\n\n:::note\nThe `id` parameter is only returned when the payment method is saved.\n:::","descriptionNode":"$L1aa5"},"type":{"type":"string","enum":"$21:props:children:0:props:children:props:responses:200:content:application/json:schema:items:properties:payment_method:oneOf:2:properties:type:enum","description":"The type of payment method used to pay for the order.\n\nAvailable values:\n\n| Payment method `type` | Description |\n| --------------------- | ----------- |\n| `apple_pay` | The customer paid the order using Apple Pay. |\n| `card` | The customer paid the order using their credit or debit card. |\n| `google_pay` | The customer paid the order using Google Pay. |\n| `revolut_pay_card` | The customer paid the order via Revolut Pay using their credit or debit card. |\n| `revolut_pay_account` | The customer paid the order via Revolut Pay using their Revolut account. |\n| `sepa_direct_debit` | The customer paid the order using SEPA Direct Debit. |","descriptionNode":"$L1aa6"},"fingerprint":{"type":"string","minLength":44,"maxLength":44,"description":"$1aa7","examples":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:0:properties:fingerprint:examples","descriptionNode":"$L1aa8"}},"required":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:4:required"},{"type":"object","description":"Object containing details of a SEPA Direct Debit payment.\n\n:::info\nFor more information, see: [SEPA Direct Debit server-to-server integration](https://developer.revolut.com/docs/guides/merchant/accept-payments/payment-methods/sepa-direct-debit/server-to-server)\n:::","properties":{"id":{"type":"string","format":"uuid","description":"ID of the saved payment method.\n\n:::note\nThe `id` parameter is only returned when the payment method is saved for the merchant.\n:::","descriptionNode":"$L1aa9"},"type":{"type":"string","enum":"$21:props:children:0:props:children:props:responses:200:content:application/json:schema:items:properties:payment_method:oneOf:2:properties:type:enum","description":"The type of payment method used to pay for the order.\n\nAvailable values:\n\n| Payment method `type` | Description |\n| --------------------- | ----------- |\n| `apple_pay` | The customer paid the order using Apple Pay. |\n| `card` | The customer paid the order using their credit or debit card. |\n| `google_pay` | The customer paid the order using Google Pay. |\n| `revolut_pay_card` | The customer paid the order via Revolut Pay using their credit or debit card. |\n| `revolut_pay_account` | The customer paid the order via Revolut Pay using their Revolut account. |\n| `sepa_direct_debit` | The customer paid the order using SEPA Direct Debit. |","descriptionNode":"$L1aaa"},"debtor_iban_last_four":{"type":"string","description":"The last four digits of the debtor's IBAN.","minLength":4,"maxLength":4,"descriptionNode":"$L1aab"},"debtor_name":{"type":"string","description":"The full name of the debtor as provided in the mandate.","descriptionNode":"$L1aac"},"mandate_reference":{"type":"string","description":"The unique mandate reference generated by Revolut. Include this in pre-debit notifications sent to your customers.","descriptionNode":"$L1aad"}},"required":"$21:props:children:0:props:children:props:responses:200:content:application/json:schema:items:properties:payment_method:oneOf:2:required","descriptionNode":"$L1aae"}],"descriptionNode":"$L1aaf"},"authentication_challenge":{"type":"object","description":"Details about the authentication challenge that should be performed to complete the authentication process. For more information about Revolut's 3DS solution, see: [3D Secure overview](https://developer.revolut.com/docs/guides/merchant/reference/3d-secure).\n\nOnly returned if the payment's state is `authentication_challenge`.","discriminator":"$21:props:children:0:props:children:props:responses:200:content:application/json:schema:items:properties:authentication_challenge:discriminator","oneOf":[{"title":"three_ds","type":"object","description":"Information about the 3DS challenge.","properties":{"type":{"type":"string","enum":"$21:props:children:0:props:children:props:responses:200:content:application/json:schema:items:properties:authentication_challenge:oneOf:0:properties:type:enum","description":"Type of the authentication challenge the payment triggers.","descriptionNode":"$L1ab0"},"acs_url":{"type":"string","format":"url","description":"The URL of the authentication challenge.","descriptionNode":"$L1ab1"}},"required":"$21:props:children:0:props:children:props:responses:200:content:application/json:schema:items:properties:authentication_challenge:oneOf:0:required","descriptionNode":"$L1ab2"},{"title":"three_ds_fingerprint","type":"object","description":"Information about the 3DS fingerprint challenge.","properties":{"type":{"type":"string","enum":"$21:props:children:0:props:children:props:responses:200:content:application/json:schema:items:properties:authentication_challenge:oneOf:0:properties:type:enum","description":"Type of the authentication challenge the payment triggers.","descriptionNode":"$L1ab3"},"fingerprint_url":{"type":"string","format":"url","description":"The URL of the fingerprint. (Used only internally by Revolut.)","descriptionNode":"$L1ab4"},"fingerprint_data":{"type":"string","format":"JSON","description":"Data about the fingerprint used for authentication. (Used only internally\nby Revolut.)","descriptionNode":"$L1ab5"}},"required":"$21:props:children:0:props:children:props:responses:200:content:application/json:schema:items:properties:authentication_challenge:oneOf:1:required","descriptionNode":"$L1ab6"}],"descriptionNode":"$L1ab7"},"billing_address":{"type":"object","description":"Object containing address details.","properties":{"street_line_1":{"type":"string","description":"Street line 1 information.","maxLength":100,"descriptionNode":"$L1ab8"},"street_line_2":{"type":"string","description":"Street line 2 information.","maxLength":100,"descriptionNode":"$L1ab9"},"region":{"type":"string","description":"The region associated with the address.","maxLength":100,"descriptionNode":"$L1aba"},"city":{"type":"string","description":"The city associated with the address.","maxLength":100,"descriptionNode":"$L1abb"},"country_code":{"type":"string","description":"The 2-letter country code of the country associated with the address.","maxLength":2,"descriptionNode":"$L1abc"},"postcode":{"type":"string","description":"The postcode associated with the address.","maxLength":100,"descriptionNode":"$L1abd"}},"required":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:billing_address:required","descriptionNode":"$L1abe"},"risk_level":{"type":"string","description":"The risk level of the card.\n\nIf the risk level is `high`, the payment might be declined.","enum":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:risk_level:enum","descriptionNode":"$L1abf"},"fees":{"type":"array","description":"The details of the order fee.","items":{"type":"object","properties":{"type":{"type":"string","description":"The type of the order fee.","enum":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:fees:items:properties:type:enum","descriptionNode":"$L1ac0"},"amount":{"type":"integer","description":"The amount of the payment fee (minor currency unit). For example, enter `7034` for €70.34 in the field.","descriptionNode":"$L1ac1"},"currency":{"type":"string","description":"The currency of the payment fee. [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) currency code in upper case.\n\n:::info\nFor more information about the supported currencies, see: [Help Center](https://help.revolut.com/business/help/merchant-accounts/payments/in-which-currencies-can-i-accept-payments/).\n:::","descriptionNode":"$L1ac2"}}},"descriptionNode":"$L1ac3"},"payer":{"title":"Payer","type":"object","description":"The person who made the payment. This object is present when an email or phone number is provided during the payment flow.\n\nCapturing payer details lets you identify exactly who authorised the charge, reach the right person for receipts or refund queries, and support compliance or fraud-review workflows where the paying identity matters.","properties":{"email":{"description":"The email of the person who made the payment.","type":"string","format":"email","descriptionNode":"$L1ac4"},"phone":{"description":"The phone number of the payer in [E.164 format](https://en.wikipedia.org/wiki/E.164).","type":"string","descriptionNode":"$L1ac5"}},"descriptionNode":"$L1ac6"}},"required":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payments:items:required","descriptionNode":"$L1ac7"},"descriptionNode":"$L1ac8"},"incremental_authorisations":{"type":"array","description":"History of incremental authorisation attempts for this order.\n\nOnly present for orders with `authorisation_type: pre_authorisation`.\n\nContains all increment attempts in chronological order.","items":{"type":"object","description":"Represents a single incremental authorisation attempt on an order.\n\nThe `incremental_authorisations` array tracks all increment attempts (successful and failed) in chronological order.","properties":{"new_amount":{"type":"integer","description":"The new total amount requested in this increment (in minor units).","examples":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:incremental_authorisations:items:properties:new_amount:examples","descriptionNode":"$L1ac9"},"old_amount":{"type":"integer","description":"The previously authorised amount before this increment (in minor units).","examples":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:incremental_authorisations:items:properties:old_amount:examples","descriptionNode":"$L1aca"},"state":{"type":"string","enum":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:incremental_authorisations:items:properties:state:enum","description":"The state of this incremental authorization attempt.\n\n| State | Description |\n|-------|-------------|\n| `pending` | Increment registered in system, not yet submitted to card network |\n| `processing` | Increment is being processed by card network |\n| `authorised` | Increment was successfully authorised |\n| `declined` | Increment was declined by card issuer |\n| `failed` | Increment failed due to technical error (not an issuer decline) |","descriptionNode":"$L1acb"},"reference":{"type":"string","maxLength":255,"description":"External reference for this incremental authorisation.\n\n:::tip\nUse your internal charge or invoice ID. This reference is returned in webhooks for easy matching to your system.\n:::","examples":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:incremental_authorisations:items:properties:reference:examples","descriptionNode":"$L1acc"},"line_items":{"type":"array","description":"Line items associated with this increment (if provided).\n\n:::note\nIf the increment is successful, these line items will override the existing order line items.\n:::","items":{"type":"object","properties":{"name":{"type":"string","maxLength":250,"description":"Name of the line item.","descriptionNode":"$L1acd"},"type":{"type":"string","enum":"$19:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:orders:items:properties:line_items:items:properties:type:enum","description":"Type of the line item.","descriptionNode":"$L1ace"},"quantity":{"type":"object","description":"Object representing the quantity details of a line item, including the amount and its associated unit of measurement.","properties":{"value":{"type":"number","format":"double","minimum":0,"description":"The number of units of the line item.","descriptionNode":"$L1acf"},"unit":{"type":"string","maxLength":100,"description":"The measurement unit for the quantity, such as `cm`, or `kg`.","descriptionNode":"$L1ad0"}},"required":"$19:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:orders:items:properties:line_items:items:properties:quantity:required","descriptionNode":"$L1ad1"},"unit_price_amount":{"type":"integer","format":"int64","minimum":0,"description":"The unit price of the line item.","descriptionNode":"$L1ad2"},"total_amount":{"type":"integer","format":"int64","description":"The total amount to be paid for the line item, including taxes and discounts.","descriptionNode":"$L1ad3"},"external_id":{"type":"string","maxLength":250,"description":"Unique identifier of line item in the merchant's system.","descriptionNode":"$L1ad4"},"discounts":{"type":"array","maxItems":50,"description":"A list of discounts applied to the line item. Each discount should be subtracted from the total amount payable for the item.","items":{"type":"object","description":"Details of a discount applied to the line item, including its name and monetary value.","properties":{"name":{"type":"string","maxLength":100,"description":"The specific name or label of the discount applied to the line item.","descriptionNode":"$L1ad5"},"amount":{"type":"integer","format":"int64","minimum":0,"description":"The monetary value of the discount. ","descriptionNode":"$L1ad6"}},"required":"$19:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:orders:items:properties:line_items:items:properties:discounts:items:required","descriptionNode":"$L1ad7"},"descriptionNode":"$L1ad8"},"taxes":{"type":"array","maxItems":50,"description":"A list of taxes applied to the line item. Each tax should be added to the total amount payable for the item.","items":{"type":"object","description":"Details about a tax applied to the line item, including its name and the corresponding amount.","properties":{"name":{"type":"string","description":"The specific name or designation of the tax applied to the line item.","maxLength":100,"descriptionNode":"$L1ad9"},"amount":{"type":"integer","format":"int64","description":"The monetary value of the tax in minor currency units (e.g., cents for EUR).","minimum":0,"descriptionNode":"$L1ada"}},"required":"$19:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:orders:items:properties:line_items:items:properties:taxes:items:required","descriptionNode":"$L1adb"},"descriptionNode":"$L1adc"},"image_urls":{"type":"array","maxItems":50,"description":"A list of URLs pointing to images related to the line item. These images can provide visual details or representations of the item.","items":{"type":"string","format":"uri","pattern":"^https?:\\/{2}.+/gi","maxLength":2000,"description":"URL to an image associated with the line item.\n\n:::warning\nRestrictions:\n- Must be a valid URI as defined by [RFC 3986](https://datatracker.ietf.org/doc/html/rfc3986)\n- URI scheme is required and must be either `http` or `https`\n- URI host is required and cannot be `localhost` or an IP address\n- Max length: `2000`\n- Reserved or invalid characters must be percent-encoded (for example, use `%20` instead of a space)\n:::","descriptionNode":"$L1add"},"descriptionNode":"$L1ade"},"description":{"type":"string","maxLength":1024,"description":"Description of the line item.","descriptionNode":"$L1adf"},"url":{"type":"string","format":"uri","pattern":"^https?:\\/{2}.+/gi","maxLength":2000,"description":"An HTTP/HTTPS URL that links to more information about the line item, such as a product page or details.\n\n:::warning\nRestrictions:\n- Must be a valid URI as defined by [RFC 3986](https://datatracker.ietf.org/doc/html/rfc3986)\n- URI scheme is required and must be either `http` or `https`\n- URI host is required and cannot be `localhost` or an IP address\n- Max length: `2000`\n- Reserved or invalid characters must be percent-encoded (for example, use `%20` instead of a space)\n:::","descriptionNode":"$L1ae0"}},"required":"$19:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:orders:items:properties:line_items:items:required"},"descriptionNode":"$L1ae1"},"reason":{"type":"string","description":"Reason why increment was declined or failed.\n\n:::note\nOnly present when `state` is `declined` or `failed`.\n:::","examples":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:incremental_authorisations:items:properties:reason:examples","descriptionNode":"$L1ae2"}},"descriptionNode":"$L1ae3"},"descriptionNode":"$L1ae4"},"location_id":{"type":"string","format":"uuid","description":"Unique ID representing the location where merchants sells products.\n\n:::info\nFor more information, see: [Locations](https://developer.revolut.com/docs/api/merchant#tag-locations).\n::: ","descriptionNode":"$L1ae5"},"metadata":{"type":"object","description":"Additional information to track your orders in your system, by providing custom metadata using `\"\" : \"\"` pairs.\n\n:::warning\n**Restrictions:**\n\n- Both keys and values must be `string`s\n- Values cannot be `null`.\n- Max number of key-value pairs: `50`\n- Max length of values: `500` characters\n- Format of keys: Must start with a letter and contain only letters, digits, and underscores. Max 40 characters. Pattern: `^[a-zA-Z][a-zA-Z\\\\d_]{0,39}$`\n:::","maxProperties":50,"additionalProperties":{"type":"string","maxLength":500,"description":"Additional metadata value provided with the corresponding metadata key.","descriptionNode":"$L1ae6"},"examples":"$19:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:orders:items:properties:metadata:examples","descriptionNode":"$L1ae7"},"industry_data":{"type":"object","description":"Object containing industry-specific information associated with the order.\n\n:::info\nIn the following cases, industry-specific info is required. Omitting this information may trigger additional scrutiny and risk mitigation actions by the Revolut risk team.\n\n | Transaction type | Required for |\n | ---------------- | ----------- |\n | `airline` | Airlines and Online Travel Agencies (OTAs). |\n | `car_rental` | Car Rental Merchants and Online Travel Agencies (OTAs). |\n | `crypto` | Crypto merchants. |\n | `marketplace` | Marketplace merchants. |\n | `event` | Event ticket sellers. |\n | `lodging` | Lodging providers. |\n:::","discriminator":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:discriminator","oneOf":[{"type":"object","description":"$1ae8","properties":{"type":{"type":"string","enum":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:0:properties:type:enum","description":"Type of the industry-specific data object, determining what additional data is expected.\n\nAvailable types:\n\n | Object type | Description |\n | ------------- | ----------- |\n | `airline` | Object containing information about a specific airline ticket purchase. |\n | `car_rental` | Object containing information about a car rental booking associated with the order. |\n | `crypto` | Object containing information about crypto transactions associated with the order. |\n | `marketplace` | This object is required by Mastercard and Visa for merchants operating as marketplaces under the **Merchant Category Code (MCC):** `5262`. The marketplace object ensures compliance with the card schemes' regulations by providing detailed information about the subseller involved in the transaction. |\n | `event` | Object containing information about event ticket bookings associated with the order. |\n | `lodging` | Object containing information about lodging bookings associated with the order. |","descriptionNode":"$L1ae9"},"booking_id":{"type":"string","description":"A unique identifier provided by the merchant associated with the order. \n\nThis `booking_id` is used to reference and correlate booking information with the Merchant API and the merchant's internal system.","descriptionNode":"$L1aea"},"fulfillment_date":{"type":"string","format":"date-time","description":"The UTC date and time of the final journey leg.\n\n:::warning\nThe following limitations apply:\n - When creating or updating an order, `fulfillment_date` cannot be set to a date in the past.\n - When updating an order, if the current `fulfillment_date` value is already in the past, it cannot be modified. The date must remain as is to maintain data integrity for completed transactions.\n:::","descriptionNode":"$L1aeb"},"tickets_purchase":{"type":"boolean","description":"Flag indicating whether the order includes actual ticket purchases. Set to `true` if the order contains ticket purchases, and `false` if it does not (e.g., it **only** contains seat reservations, or baggage upgrades). \n\n:::info\nThis field is required for activating **Revolut Flight Alerts** functionalities within the Revolut app.\n\nProvide the info on order creation or update, before capturing the order.\n:::","descriptionNode":"$L1aec"},"ticket_type":{"type":"string","enum":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:0:properties:ticket_type:enum","description":"The type of the ticket.\n\n| Parameter value | Description |\n| --------------- | ----------- |\n| `fixed` | Non-modifiable once confirmed. |\n| `flexible` | Allows modifications or cancellations under specified conditions. |","descriptionNode":"$L1aed"},"crs_code":{"type":"string","maxLength":4,"description":"The code of the Computer Reservation System (CRS) used to make the booking and purchase the ticket.","descriptionNode":"$L1aee"},"ticket_change_indicator":{"type":"string","enum":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:0:properties:ticket_change_indicator:enum","description":"Parameter indicating whether this order is related to a new ticket reservation or a modification of an existing one.","descriptionNode":"$L1aef"},"refundability":{"type":"string","enum":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:0:properties:refundability:enum","description":"Parameter indicating whether the booking is refundable, partially refundable, or not refundable.","descriptionNode":"$L1af0"},"passengers":{"type":"array","description":"Array containing information of passengers associated with the booking.","items":{"type":"object","properties":{"first_name":{"type":"string","description":"Passenger's first name.","descriptionNode":"$L1af1"},"last_name":{"type":"string","description":"Passenger's last name.","descriptionNode":"$L1af2"}},"required":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:0:properties:passengers:items:required"},"descriptionNode":"$L1af3"},"journey_legs":{"type":"array","description":"Array containing information of journey legs associated with the booking.\n\n:::info\nThis field is required for activating **Revolut Flight Alerts** functionalities within the Revolut app. \n\nThis information is used to compile a tracking widget that provides real-time updates on flight status and sends notifications, such as a check-in reminders, boarding alerts, and notifications for cancellations or delays. \n\nTo enable the widget the following fields are required on order creation or update, before capturing the order:\n\n ```\n sequence,\n departure_airport_code,\n arrival_airport_code,\n flight_number,\n travel_date,\n airline_name,\n airline_code,\n ```\n:::","items":{"type":"object","properties":{"sequence":{"type":"integer","description":"Sequence of the journey legs. Increment by 1 for each flight included in the ticket.\n\nFor example: For a `FRA > LHR > DUB > LHR > FRA` journey the sequence will be assigned as:\n - `FRA > LHR`: 1\n - `LHR > DUB`: 2\n - `DUB > LHR`: 3\n - `LHR > FRA`: 4","descriptionNode":"$L1af4"},"departure_airport_code":{"type":"string","description":"The [IATA](https://www.iata.org/en/services/codes) 3-letter airport code for the departure airport.","descriptionNode":"$L1af5"},"arrival_airport_code":{"type":"string","description":"The [IATA](https://www.iata.org/en/services/codes) 3-letter airport code for the arrival airport.","descriptionNode":"$L1af6"},"flight_number":{"type":"string","description":"The flight identifier, without airline code.","descriptionNode":"$L1af7"},"fare_base_code":{"type":"string","description":"The fare base code for the given journey leg.","descriptionNode":"$L1af8"},"travel_date":{"type":"string","format":"date-time","description":"The UTC date and time of the flight departure for the given journey leg.","descriptionNode":"$L1af9"},"airline_name":{"type":"string","description":"The name of the airline associated with the journey leg.","descriptionNode":"$L1afa"},"airline_code":{"type":"string","description":"The IATA 2-letter accounting code identifying the airline associated with the journey leg.","descriptionNode":"$L1afb"},"pnr":{"type":"string","format":"alphanumeric","pattern":"^[a-zA-Z0-9]*$","maxLength":20,"description":"The Passenger Name Record (PNR) for the journey leg issued by the airline. \n\nPNR is a unique identifier for the booking, acting as a digital certificate allowing passengers to retrieve or manage their booking details.\n\n:::warning\nThis is a required field for OTAs.\n:::","descriptionNode":"$L1afc"}},"required":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:0:properties:journey_legs:items:required"},"descriptionNode":"$L1afd"},"booking_url":{"type":"string","format":"uri","pattern":"^https?:\\/{2}.+/gi","maxLength":2000,"description":"URL to the online portal for managing the airline booking, which includes check-in functionality. This URL may be a personalised, pre-populated check-in link specific to the user or a generic link, and it is essential for enabling direct access to booking details within the Revolut app.\n\n:::info\nThis field is required for activating **Revolut Flight Alerts** functionalities within the Revolut app. \n\nProvide the info on order creation or update, before capturing the order.\n:::\n\n:::warning\nRestrictions:\n- Must be a valid URI as defined by [RFC 3986](https://datatracker.ietf.org/doc/html/rfc3986)\n- URI scheme is required and must be either `http` or `https`\n- URI host is required and cannot be `localhost` or an IP address\n- Max length: `2000`\n- Reserved or invalid characters must be percent-encoded (for example, use `%20` instead of a space)\n:::","descriptionNode":"$L1afe"}},"required":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:0:required","descriptionNode":"$L1aff"},{"type":"object","description":"Object containing additional information about a car rental booking associated with the order.\n\n:::info\nThese are the specific data field requirements for merchants offering car rental. Note that these requirements can be extended on a case by case basis as decided by Revolut.\n\n```\nbooking_id\ndrop_off_date\nrefundability\n```\n:::","properties":{"type":{"type":"string","enum":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:0:properties:type:enum","description":"Type of the industry-specific data object, determining what additional data is expected.\n\nAvailable types:\n\n | Object type | Description |\n | ------------- | ----------- |\n | `airline` | Object containing information about a specific airline ticket purchase. |\n | `car_rental` | Object containing information about a car rental booking associated with the order. |\n | `crypto` | Object containing information about crypto transactions associated with the order. |\n | `marketplace` | This object is required by Mastercard and Visa for merchants operating as marketplaces under the **Merchant Category Code (MCC):** `5262`. The marketplace object ensures compliance with the card schemes' regulations by providing detailed information about the subseller involved in the transaction. |\n | `event` | Object containing information about event ticket bookings associated with the order. |\n | `lodging` | Object containing information about lodging bookings associated with the order. |","descriptionNode":"$L1b00"},"booking_id":{"type":"string","description":"A unique identifier provided by the merchant associated with the order. \n\nThis `booking_id` is used to reference and correlate booking information with the Merchant API and the merchant's internal system.","descriptionNode":"$L1b01"},"pick_up_date":{"type":"string","format":"date-time","description":"The UTC date and time of the pick-up.","descriptionNode":"$L1b02"},"pick_up_location":{"type":"object","description":"Object containing address details.","properties":{"street_line_1":"$1b:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payments:items:properties:billing_address:properties:street_line_1","street_line_2":"$1b:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payments:items:properties:billing_address:properties:street_line_2","region":"$1b:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payments:items:properties:billing_address:properties:region","city":"$1b:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payments:items:properties:billing_address:properties:city","country_code":"$1b:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payments:items:properties:billing_address:properties:country_code","postcode":"$1b:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payments:items:properties:billing_address:properties:postcode"},"required":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:billing_address:required","descriptionNode":"$L1b03"},"drop_off_date":{"type":"string","format":"date-time","description":"The UTC date and time of the drop-off.","descriptionNode":"$L1b04"},"drop_off_location":{"type":"object","description":"Object containing address details.","properties":{"street_line_1":"$1b:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payments:items:properties:billing_address:properties:street_line_1","street_line_2":"$1b:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payments:items:properties:billing_address:properties:street_line_2","region":"$1b:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payments:items:properties:billing_address:properties:region","city":"$1b:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payments:items:properties:billing_address:properties:city","country_code":"$1b:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payments:items:properties:billing_address:properties:country_code","postcode":"$1b:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payments:items:properties:billing_address:properties:postcode"},"required":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:billing_address:required","descriptionNode":"$L1b05"},"refundability":{"type":"string","enum":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:0:properties:refundability:enum","description":"Parameter indicating whether the booking is refundable, partially refundable, or not refundable.","descriptionNode":"$L1b06"},"distance_limit":{"type":"object","description":"Object containing distance limit information.","properties":{"limit":{"type":"integer","description":"The maximum distance allowed.","descriptionNode":"$L1b07"},"unit":{"type":"string","description":"The unit of distance.","enum":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:1:properties:distance_limit:properties:unit:enum","descriptionNode":"$L1b08"},"additional_distance_cost":{"type":"object","description":"Cost for exceeding the distance limit.","properties":{"amount":{"type":"integer","description":"The amount of the cost in minor currency units. For example, enter `7034` for €70.34.","descriptionNode":"$L1b09"},"currency":{"type":"string","format":"ISO 4217","minLength":3,"maxLength":3,"description":"[ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) currency code in upper case.\n\n:::info\nFor more information about the supported currencies, see: [Help Center](https://help.revolut.com/business/help/merchant-accounts/payments/in-which-currencies-can-i-accept-payments/).\n:::","descriptionNode":"$L1b0a"}},"descriptionNode":"$L1b0b"}},"descriptionNode":"$L1b0c"}},"required":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:1:required","descriptionNode":"$L1b0d"},{"type":"object","description":"Object containing information about crypto transactions associated with the order.\n\n:::info\nProcessing crypto on-ramp transactions with Revolut has additional compliance requirements. Please reach out to your account executive for additional details.\n\n**Required data fields for crypto services:**\n\n```\ntransactions[].id\ntransactions[].status\ntransactions[].recipient_wallet_id\nseller.id\nseller.name\nseller.website\nseller.phone\nseller.address\nseller.mcc\ncustomer.full_name\ncustomer.date_of_birth\n```\n\nNote that these requirements can be extended on a case by case basis as decided by Revolut.\n:::","properties":{"type":{"type":"string","enum":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:0:properties:type:enum","description":"Type of the industry-specific data object, determining what additional data is expected.\n\nAvailable types:\n\n | Object type | Description |\n | ------------- | ----------- |\n | `airline` | Object containing information about a specific airline ticket purchase. |\n | `car_rental` | Object containing information about a car rental booking associated with the order. |\n | `crypto` | Object containing information about crypto transactions associated with the order. |\n | `marketplace` | This object is required by Mastercard and Visa for merchants operating as marketplaces under the **Merchant Category Code (MCC):** `5262`. The marketplace object ensures compliance with the card schemes' regulations by providing detailed information about the subseller involved in the transaction. |\n | `event` | Object containing information about event ticket bookings associated with the order. |\n | `lodging` | Object containing information about lodging bookings associated with the order. |","descriptionNode":"$L1b0e"},"transactions":{"type":"array","description":"Array of crypto transaction data associated with the order.","items":{"type":"object","properties":{"id":{"type":"string","maxLength":255,"description":"The public transaction hash of the crypto transaction.","descriptionNode":"$L1b0f"},"status":{"type":"string","enum":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:2:properties:transactions:items:properties:status:enum","description":"The status of the crypto transaction.","descriptionNode":"$L1b10"},"recipient_wallet_id":{"type":"string","maxLength":255,"description":"The wallet ID of the recipient.\n\n:::note\nAt least one of the parameters: `recipient_user_id` or `recipient_wallet_id` is required.\n::: ","descriptionNode":"$L1b11"},"recipient_user_id":{"type":"string","maxLength":255,"description":"The user ID of the recipient.\n\n:::note\nAt least one of the parameters: `recipient_user_id` or `recipient_wallet_id` is required.\n::: ","descriptionNode":"$L1b12"}},"required":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:2:properties:transactions:items:required"},"minItems":1,"descriptionNode":"$L1b13"},"seller":{"type":"object","description":"Information about the crypto conversion affiliate.\n\nThis should be provided when a customer completes a payment on a subseller's website rather than directly on the merchant's website, providing insight into the type of business conducted by the subseller.\n\n:::note\nThis needs to be provided only by crypto on-ramp providers for payments they are processing for conversion affiliates.\n\nFor their own payments, `seller` can be omitted.\n:::","properties":{"mcc":{"type":"string","description":"A string representing the four-digit [Merchant Category Code (MCC)](https://en.wikipedia.org/wiki/Merchant_category_code) of the conversion affiliate.","maxLength":4,"minLength":4,"pattern":"^\\d{4}$","descriptionNode":"$L1b14"},"id":{"type":"string","description":"The ID of the seller in the merchant's internal system.","minLength":1,"maxLength":15,"descriptionNode":"$L1b15"},"name":{"type":"string","description":"The business or legal name of the seller.","minLength":1,"maxLength":50,"descriptionNode":"$L1b16"},"website":{"type":"string","format":"uri","pattern":"^https?:\\/{2}.+/gi","maxLength":255,"description":"The URL of the website of the seller.\n\n:::warning\nRestrictions:\n- Must be a valid URI as defined by [RFC 3986](https://datatracker.ietf.org/doc/html/rfc3986)\n- URI scheme is required and must be either `http` or `https`\n- URI host is required and cannot be `localhost` or an IP address\n- Max length: `255`\n- Reserved or invalid characters must be percent-encoded (for example, use `%20` instead of a space)\n:::","descriptionNode":"$L1b17"},"phone":{"type":"string","description":"The phone number of the seller.","descriptionNode":"$L1b18"},"address":{"type":"object","description":"Details of a physical address.","properties":{"street_line_1":{"type":"string","description":"Primary address line.","maxLength":100,"descriptionNode":"$L1b19"},"street_line_2":{"type":"string","description":"Secondary address line, such as floor and apartment number.","maxLength":100,"descriptionNode":"$L1b1a"},"region":{"type":"string","description":"State or province of the address.","maxLength":100,"descriptionNode":"$L1b1b"},"city":{"type":"string","description":"City of the address.","maxLength":100,"descriptionNode":"$L1b1c"},"country_code":{"type":"string","pattern":"^[A-Z]{2}$","description":"ISO 2-letter country code.","minLength":2,"maxLength":2,"descriptionNode":"$L1b1d"},"country_subdivision_code":{"type":"string","pattern":"^[A-Z]{2}-[A-Z0-9]{1,3}$","description":"The subdivision code represents the state, province, or region within the country, following the [ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2) standard. This code uniquely identifies subdivisions within a country. \n\nFor example, for London in the United Kingdom, use `GB-LND`.\n\n:::warning\nThe parameter is required for countries listed on the [ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2) page.\n:::","minLength":5,"maxLength":6,"descriptionNode":"$L1b1e"},"postcode":{"type":"string","description":"Postal code of the address.","maxLength":100,"descriptionNode":"$L1b1f"}},"required":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:2:properties:seller:properties:address:required","descriptionNode":"$L1b20"}},"required":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:2:properties:seller:required","descriptionNode":"$L1b21"}},"required":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:2:required","descriptionNode":"$L1b22"},{"type":"object","description":"This object is required by Mastercard and Visa for merchants operating as marketplaces under the Merchant Category Code (MCC) `5262`. The marketplace object ensures compliance with the card schemes' regulations by providing detailed information about the seller involved in the transaction.\n\n:::info\nThese are the specific data field requirements for merchants who must provide marketplace data.\n\n```\nseller.id\nseller.name\nseller.website\nseller.phone\nseller.address\n```\n:::","properties":{"type":{"type":"string","enum":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:0:properties:type:enum","description":"Type of the industry-specific data object, determining what additional data is expected.\n\nAvailable types:\n\n | Object type | Description |\n | ------------- | ----------- |\n | `airline` | Object containing information about a specific airline ticket purchase. |\n | `car_rental` | Object containing information about a car rental booking associated with the order. |\n | `crypto` | Object containing information about crypto transactions associated with the order. |\n | `marketplace` | This object is required by Mastercard and Visa for merchants operating as marketplaces under the **Merchant Category Code (MCC):** `5262`. The marketplace object ensures compliance with the card schemes' regulations by providing detailed information about the subseller involved in the transaction. |\n | `event` | Object containing information about event ticket bookings associated with the order. |\n | `lodging` | Object containing information about lodging bookings associated with the order. |","descriptionNode":"$L1b23"},"seller":{"type":"object","description":"Information about the subseller on the marketplace platform.","properties":{"id":{"type":"string","description":"The ID of the seller in the merchant's internal system.","minLength":1,"maxLength":15,"descriptionNode":"$L1b24"},"name":{"type":"string","description":"The business or legal name of the seller.","minLength":1,"maxLength":50,"descriptionNode":"$L1b25"},"website":{"type":"string","format":"uri","pattern":"^https?:\\/{2}.+/gi","maxLength":255,"description":"The URL of the website of the seller.\n\n:::warning\nRestrictions:\n- Must be a valid URI as defined by [RFC 3986](https://datatracker.ietf.org/doc/html/rfc3986)\n- URI scheme is required and must be either `http` or `https`\n- URI host is required and cannot be `localhost` or an IP address\n- Max length: `255`\n- Reserved or invalid characters must be percent-encoded (for example, use `%20` instead of a space)\n:::","descriptionNode":"$L1b26"},"phone":{"type":"string","description":"The phone number of the seller.","descriptionNode":"$L1b27"},"address":{"type":"object","description":"Details of a physical address.","properties":{"street_line_1":"$1b:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:2:properties:seller:properties:address:properties:street_line_1","street_line_2":"$1b:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:2:properties:seller:properties:address:properties:street_line_2","region":"$1b:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:2:properties:seller:properties:address:properties:region","city":"$1b:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:2:properties:seller:properties:address:properties:city","country_code":"$1b:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:2:properties:seller:properties:address:properties:country_code","country_subdivision_code":"$1b:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:2:properties:seller:properties:address:properties:country_subdivision_code","postcode":"$1b:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:2:properties:seller:properties:address:properties:postcode"},"required":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:2:properties:seller:properties:address:required","descriptionNode":"$L1b28"}},"required":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:3:properties:seller:required","descriptionNode":"$L1b29"}},"required":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:3:required","descriptionNode":"$L1b2a"},{"type":"object","description":"Object containing booking information for a list of event tickets associated with the order.\n\n:::info\nThese are the specific data field requirements for merchants who must provide event data. Note that these requirements can be extended on a case by case basis as decided by Revolut.\n\n```\nbooking_id\nevents[].start_date\nevents[].end_date\nevents[].supplier\nevents[].tickets[].id\n```\n:::","properties":{"type":{"type":"string","enum":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:0:properties:type:enum","description":"Type of the industry-specific data object, determining what additional data is expected.\n\nAvailable types:\n\n | Object type | Description |\n | ------------- | ----------- |\n | `airline` | Object containing information about a specific airline ticket purchase. |\n | `car_rental` | Object containing information about a car rental booking associated with the order. |\n | `crypto` | Object containing information about crypto transactions associated with the order. |\n | `marketplace` | This object is required by Mastercard and Visa for merchants operating as marketplaces under the **Merchant Category Code (MCC):** `5262`. The marketplace object ensures compliance with the card schemes' regulations by providing detailed information about the subseller involved in the transaction. |\n | `event` | Object containing information about event ticket bookings associated with the order. |\n | `lodging` | Object containing information about lodging bookings associated with the order. |","descriptionNode":"$L1b2b"},"booking_id":{"type":"string","description":"A unique identifier provided by the merchant associated with the order. \n\nThis `booking_id` is used to reference and correlate booking information with the Merchant API and the merchant's internal system.","descriptionNode":"$L1b2c"},"events":{"type":"array","description":"A list of events associated with the booking.","items":{"type":"object","description":"Object containing booking information about a specific event. ","properties":{"start_date":{"type":"string","format":"date-time","description":"[ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time when the event starts.","descriptionNode":"$L1b2d"},"end_date":{"type":"string","format":"date-time","description":"[ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time when the event ends.","descriptionNode":"$L1b2e"},"supplier":{"type":"string","description":"Legal name of the ticket vendor/event organiser.","descriptionNode":"$L1b2f"},"supplier_payment_date":{"type":"string","format":"date-time","description":"[ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time when the funds are released to merchants.","descriptionNode":"$L1b30"},"name":{"type":"string","description":"The name of the event.","descriptionNode":"$L1b31"},"location":{"type":"object","description":"The address of the event location.","properties":{"street_line_1":{"type":"string","description":"Primary address line.","maxLength":100,"descriptionNode":"$L1b32"},"street_line_2":{"type":"string","description":"Secondary address line, such as floor and apartment number.","maxLength":100,"descriptionNode":"$L1b33"},"region":{"type":"string","description":"State or province of the address.","maxLength":100,"descriptionNode":"$L1b34"},"city":{"type":"string","description":"City of the address.","maxLength":100,"descriptionNode":"$L1b35"},"country_code":{"type":"string","pattern":"^[A-Z]{2}$","description":"ISO 2-letter country code.","minLength":2,"maxLength":2,"descriptionNode":"$L1b36"},"postcode":{"type":"string","description":"Postal code of the address.","maxLength":100,"descriptionNode":"$L1b37"}},"required":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:4:properties:events:items:properties:location:required","descriptionNode":"$L1b38"},"category":{"type":"string","enum":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:4:properties:events:items:properties:category:enum","description":"The type of the event.","descriptionNode":"$L1b39"},"market":{"type":"string","enum":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:4:properties:events:items:properties:market:enum","description":"Indicates the relationship between the ticket vendor and the event organiser. \n\n| Parameter value | Description |\n| --------------- | ----------- |\n| `primary` | The merchant is the organiser and primary distributor of the tickets. |\n| `secondary` | The merchant is a reseller, only distributing the tickets. |","descriptionNode":"$L1b3a"},"tickets":{"type":"array","items":{"type":"object","description":"Object containing information about a ticket associated with the booking.","properties":{"id":{"type":"string","description":"A unique identifier provided by the merchant associated with the ticket.","descriptionNode":"$L1b3b"},"transferable":{"type":"boolean","description":"Indicates whether the ticket is transferable to another buyer.","descriptionNode":"$L1b3c"},"refundability":{"type":"string","enum":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:0:properties:refundability:enum","description":"Parameter indicating whether the booking is refundable, partially refundable, or not refundable.","descriptionNode":"$L1b3d"}},"required":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:4:properties:events:items:properties:tickets:items:required","descriptionNode":"$L1b3e"},"description":"A list of tickets associated with the booking.","descriptionNode":"$L1b3f"}},"descriptionNode":"$L1b40"},"descriptionNode":"$L1b41"}},"required":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:4:required","descriptionNode":"$L1b42"},{"type":"object","description":"Object containing details of a lodging booking.\n\n:::info\nThese are the specific data field requirements for merchants who must provide lodging data. Note that these requirements can be extended on a case by case basis as decided by Revolut.\n\n```\nbooking_id\ncheck_in_date\ncheck_out_date\nsupplier_payment_date\n```\n:::","properties":{"type":{"type":"string","enum":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:0:properties:type:enum","description":"Type of the industry-specific data object, determining what additional data is expected.\n\nAvailable types:\n\n | Object type | Description |\n | ------------- | ----------- |\n | `airline` | Object containing information about a specific airline ticket purchase. |\n | `car_rental` | Object containing information about a car rental booking associated with the order. |\n | `crypto` | Object containing information about crypto transactions associated with the order. |\n | `marketplace` | This object is required by Mastercard and Visa for merchants operating as marketplaces under the **Merchant Category Code (MCC):** `5262`. The marketplace object ensures compliance with the card schemes' regulations by providing detailed information about the subseller involved in the transaction. |\n | `event` | Object containing information about event ticket bookings associated with the order. |\n | `lodging` | Object containing information about lodging bookings associated with the order. |","descriptionNode":"$L1b43"},"booking_id":{"type":"string","description":"A unique identifier provided by the merchant associated with the order. \n\nThis `booking_id` is used to reference and correlate booking information with the Merchant API and the merchant's internal system.","descriptionNode":"$L1b44"},"check_in_date":{"type":"string","format":"date-time","description":"[ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time of the check-in.","descriptionNode":"$L1b45"},"check_out_date":{"type":"string","format":"date-time","description":"[ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time of the check-out.","descriptionNode":"$L1b46"},"supplier_payment_date":{"type":"string","format":"date-time","description":"[ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time when the funds are released to merchants.","descriptionNode":"$L1b47"},"category":{"type":"string","enum":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:5:properties:category:enum","description":"The type of the accommodation associated with the booking.","descriptionNode":"$L1b48"},"booking_type":{"type":"string","enum":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:5:properties:booking_type:enum","description":"Indicates whether the booking terms are fixed or flexible.\n\n| Parameter value | Description |\n| --------------- | ----------- |\n| `fixed` | Non-modifiable once confirmed. |\n| `flexible` | Allows modifications or cancellations under specified conditions. |","descriptionNode":"$L1b49"},"refundability":{"type":"string","enum":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:0:properties:refundability:enum","description":"Parameter indicating whether the booking is refundable, partially refundable, or not refundable.","descriptionNode":"$L1b4a"},"location":{"type":"object","description":"Address of the accommodation.","properties":{"street_line_1":{"type":"string","description":"Primary address line.","maxLength":100,"descriptionNode":"$L1b4b"},"street_line_2":{"type":"string","description":"Secondary address line, such as floor and apartment number.","maxLength":100,"descriptionNode":"$L1b4c"},"region":{"type":"string","description":"State or province of the address.","maxLength":100,"descriptionNode":"$L1b4d"},"city":{"type":"string","description":"City of the address.","maxLength":100,"descriptionNode":"$L1b4e"},"country_code":{"type":"string","pattern":"^[A-Z]{2}$","description":"ISO 2-letter country code.","minLength":2,"maxLength":2,"descriptionNode":"$L1b4f"},"postcode":{"type":"string","description":"Postal code of the address.","maxLength":100,"descriptionNode":"$L1b50"}},"required":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:5:properties:location:required","descriptionNode":"$L1b51"},"guests":{"type":"array","items":{"type":"object","properties":{"first_name":{"type":"string","description":"Guest's first name.","descriptionNode":"$L1b52"},"last_name":{"type":"string","description":"Guest's last name.","descriptionNode":"$L1b53"}},"required":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:5:properties:guests:items:required"},"description":"List of guests associated with the booking.","descriptionNode":"$L1b54"}},"required":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:5:required","descriptionNode":"$L1b55"}],"descriptionNode":"$L1b56"},"merchant_order_data":{"type":"object","description":"Object for providing additional information stored in the merchant's order management system. ","properties":{"url":{"type":"string","format":"uri","pattern":"^https?:\\/{2}.+/gi","maxLength":2000,"description":"The URL of the order stored in the merchant's order management system.\n\nThis URL will be included in the order confirmation email for payments made via Revolut Pay. If specified, this URL will override the default link to the merchant's **Business website** configured in the Revolut Business account.\n\n:::warning\nRestrictions:\n- Must be a valid URI as defined by [RFC 3986](https://datatracker.ietf.org/doc/html/rfc3986)\n- URI scheme is required and must be either `http` or `https`\n- URI host is required and cannot be `localhost` or an IP address\n- Max length: `2000`\n- Reserved or invalid characters must be percent-encoded (for example, use `%20` instead of a space)\n:::","descriptionNode":"$L1b57"},"reference":{"type":"string","description":"Merchant order ID for external reference.\n\nUse this field to set the ID that your own system can use to easily track orders.","descriptionNode":"$L1b58"}},"descriptionNode":"$L1b59"},"upcoming_payment_data":{"type":"object","description":"Object containing information about upcoming payments associated with the order.","properties":{"date":{"type":"string","format":"date-time","description":"The date and time in [ISO 8601 format](https://en.wikipedia.org/wiki/ISO_8601) when the upcoming payment is scheduled to be executed.","descriptionNode":"$L1b5a"},"payment_method_id":{"type":"string","description":"The unique ID of the customer's payment method used to complete the scheduled payment.\n\n:::info\nFor more information about operations related to customer's payment methods, see:\n - [Retrieve payment method list of a customer](https://developer.revolut.com/docs/api/merchant#retrieve-payment-method-list)\n - [Retrieve a customer's payment method](https://developer.revolut.com/docs/api/merchant#retrieve-payment-method)\n - [Update a customer's payment method](https://developer.revolut.com/docs/api/merchant#update-payment-method)\n - [Delete a customer's payment method](https://developer.revolut.com/docs/api/merchant#delete-payment-method)\n:::","descriptionNode":"$L1b5b"}},"required":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:upcoming_payment_data:required","descriptionNode":"$L1b5c"},"checkout_url":{"type":"string","description":"Link to a checkout page hosted by Revolut.","format":"uri","descriptionNode":"$L1b5d"},"redirect_url":{"type":"string","format":"uri","pattern":"^https?:\\/{2}.+/gi","maxLength":2000,"description":"The URL your customer will be redirected to after a successful payment on the hosted checkout page (`checkout_url` parameter's value of the order).\n\n:::warning\nRestrictions:\n- Must be a valid URI as defined by [RFC 3986](https://datatracker.ietf.org/doc/html/rfc3986)\n- URI scheme is required and must be either `http` or `https`\n- URI host is required and cannot be `localhost` or an IP address\n- Max length: `2000`\n- Reserved or invalid characters must be percent-encoded (for example, use `%20` instead of a space)\n:::\n\n:::info\nFor more information on how to use the `redirect_url`, see: [Custom redirection via the API](https://developer.revolut.com/docs/guides/merchant/accept-payments/online-payments/hosted-checkout-page/api#custom-post-payment-redirection-optional)\n:::","descriptionNode":"$L1b5e"},"shipping":{"type":"object","description":"Details about the shipping related to the order, including address, contact information, and individual shipments.\n\n:::info\nRequired for merchants shipping physical goods. Omitting this information may trigger additional scrutiny and risk mitigation actions by Revolut.\n:::","properties":{"address":{"type":"object","description":"Details of a physical address.","properties":{"street_line_1":{"type":"string","description":"Primary address line.","maxLength":100,"descriptionNode":"$L1b5f"},"street_line_2":{"type":"string","description":"Secondary address line, such as floor and apartment number.","maxLength":100,"descriptionNode":"$L1b60"},"region":{"type":"string","description":"State or province of the address.","maxLength":100,"descriptionNode":"$L1b61"},"city":{"type":"string","description":"City of the address.","maxLength":100,"descriptionNode":"$L1b62"},"country_code":{"type":"string","pattern":"^[A-Z]{2}$","description":"ISO 2-letter country code.","minLength":2,"maxLength":2,"descriptionNode":"$L1b63"},"postcode":{"type":"string","description":"Postal code of the address.","maxLength":100,"descriptionNode":"$L1b64"}},"required":"$60:props:children:0:props:children:props:responses:200:content:application/json:schema:oneOf:1:properties:details:properties:address:required","descriptionNode":"$L1b65"},"contact":{"type":"object","description":"Contact details for someone responsible for the shipment.\n\n:::warning\nAt least `email` or `phone` is required.\n:::","properties":{"name":{"type":"string","description":"Full name of the contact person.","maxLength":250,"descriptionNode":"$L1b66"},"email":{"type":"string","format":"email","description":"Email address of the contact person.","descriptionNode":"$L1b67"},"phone":{"type":"string","description":"Phone number of the contact person.","descriptionNode":"$L1b68"}},"descriptionNode":"$L1b69"},"shipments":{"type":"array","description":"List of individual shipment details.","maxItems":50,"items":{"type":"object","description":"Details of an individual shipment.","properties":{"shipping_company_name":{"type":"string","maxLength":250,"description":"Name of the company handling the shipment.","descriptionNode":"$L1b6a"},"tracking_number":{"type":"string","maxLength":500,"description":"Unique tracking number for the shipment.","descriptionNode":"$L1b6b"},"estimated_delivery_date":{"type":"string","format":"date-time","description":"Estimated delivery date and time for the shipment. \nThe time should also include the customer's timezone.","descriptionNode":"$L1b6c"},"tracking_url":{"type":"string","format":"uri","pattern":"^https?:\\/{2}.+/gi","maxLength":2000,"description":"An HTTP/HTTPS URL where the shipment can be tracked.\n\n:::warning\nRestrictions:\n- Must be a valid URI as defined by [RFC 3986](https://datatracker.ietf.org/doc/html/rfc3986)\n- URI scheme is required and must be either `http` or `https`\n- URI host is required and cannot be `localhost` or an IP address\n- Max length: `2000`\n- Reserved or invalid characters must be percent-encoded (for example, use `%20` instead of a space)\n:::","descriptionNode":"$L1b6d"}},"required":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:shipping:properties:shipments:items:required","descriptionNode":"$L1b6e"},"descriptionNode":"$L1b6f"}},"descriptionNode":"$L1b70"},"enforce_challenge":{"type":"string","description":"The enforce challenge mode. `automatic` is used by default.\n\n| Parameter value | Description |\n| --------------- | ----------- |\n| `automatic` | The payments created for an order will have challenge requirement calculated by our fraud mechanisms. Not all payments will trigger a 3DS challenge. |\n| `forced` | The payments created for an order will always require a 3DS challenge. Currently only supported for card payments. |","default":"automatic","enum":"$19:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:orders:items:properties:enforce_challenge:enum","descriptionNode":"$L1b71"},"line_items":{"type":"array","maxItems":250,"description":"An array of line items included in the order. Each line item represents an individual product or service, along with its quantity, price, taxes, and discounts.\n\n:::info\nRequired for merchants collecting payment for one or multiple products/services in one transaction. Omitting this information may trigger additional scrutiny and risk mitigation actions by Revolut.\n:::","items":{"type":"object","properties":{"name":"$1b:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:incremental_authorisations:items:properties:line_items:items:properties:name","type":"$1b:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:incremental_authorisations:items:properties:line_items:items:properties:type","quantity":"$1b:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:incremental_authorisations:items:properties:line_items:items:properties:quantity","unit_price_amount":"$1b:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:incremental_authorisations:items:properties:line_items:items:properties:unit_price_amount","total_amount":"$1b:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:incremental_authorisations:items:properties:line_items:items:properties:total_amount","external_id":"$1b:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:incremental_authorisations:items:properties:line_items:items:properties:external_id","discounts":"$1b:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:incremental_authorisations:items:properties:line_items:items:properties:discounts","taxes":"$1b:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:incremental_authorisations:items:properties:line_items:items:properties:taxes","image_urls":"$1b:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:incremental_authorisations:items:properties:line_items:items:properties:image_urls","description":"$1b:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:incremental_authorisations:items:properties:line_items:items:properties:description","url":"$1b:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:incremental_authorisations:items:properties:line_items:items:properties:url"},"required":"$19:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:orders:items:properties:line_items:items:required"},"descriptionNode":"$L1b72"},"statement_descriptor_suffix":{"type":"string","description":"$1b73","minLength":1,"maxLength":19,"pattern":"^[^*\\n\\r\\\\]+$","descriptionNode":"$L1b74"},"related_order_id":{"type":"string","format":"uuid","description":"The unique ID of the original order that was refunded and this refund is associated with. You can use this ID to get more information about the related order using the [Retrieve an order](https://developer.revolut.com/docs/api/merchant#retrieve-order) operation.\n\n:::note\nThis field is only returned for orders with `type: refund`.\n:::","descriptionNode":"$L1b75"},"subscription_data":{"title":"Subscription data","type":"object","required":"$19:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:orders:items:properties:subscription_data:required","description":"Subscription details linked to the order. Use this object to match an order with its underlying subscription and understand the billing context in which the order was created.\n\nOnly present on orders created by a subscription.","properties":{"subscription_id":{"type":"string","format":"uuid","description":"Unique identifier for the subscription.","descriptionNode":"$L1b76"},"active_cycle_id":{"type":"string","format":"uuid","description":"The unique identifier of the active (pre-paid) subscription cycle that this order collects payment for.\n\nThis is the current billing cycle whose recurring charges are being collected in advance by this order. For example, if a subscription cycle covers 1-31 July and the order is generated on 1 July, this field identifies that July cycle.","descriptionNode":"$L1b77"},"settled_cycle_id":{"type":"string","format":"uuid","description":"The unique identifier of the settled (post-paid) subscription cycle whose usage-based charges this order collects.\n\nThis is the previous billing cycle whose usage is being settled by this order. For example, if a subscription cycle covers usage from 1-30 June and the order is generated on 10 July, this field identifies that June cycle.","descriptionNode":"$L1b78"},"billing_reason":{"type":"string","enum":"$19:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:orders:items:properties:subscription_data:properties:billing_reason:enum","description":"The reason this subscription order was created.\n\n| Value | Description |\n| ----- | ----------- |\n| `cycle_billing` | The order was automatically generated to collect payment for an ongoing subscription cycle. `active_cycle_id` is present; `settled_cycle_id` is present if the previous cycle included usage-based products. |\n| `final_settlement` | The order was automatically generated after the subscription ended to collect outstanding usage-based charges. `active_cycle_id` is absent; `settled_cycle_id` is present. |\n| `setup_intent` | The order was manually created by the merchant or customer to update the payment method on file. `active_cycle_id` is absent; `settled_cycle_id` is absent. |","descriptionNode":"$L1b79"}},"descriptionNode":"$L1b7a"}},"descriptionNode":"$L1b7b"},"examples":{"example_order_updated":{"summary":"Example order update response","value":{"id":"651a941a-02ef-af6f-9b6c-458c652e2c6a","token":"0aa685ee-8d86-441d-bedd-3f7fbf41731b","type":"payment","state":"pending","created_at":"2023-10-02T09:57:46.498026Z","updated_at":"2023-10-02T11:54:46.648414Z","amount":1000,"currency":"EUR","outstanding_amount":1000,"settlement_currency":"GBP","capture_mode":"manual","cancel_authorised_after":"P3D","checkout_url":"https://checkout.revolut.com/payment-link/0aa685ee-8d86-441d-bedd-3f7fbf41731b","metadata":{"example_key":"example_value"},"enforce_challenge":"automatic","merchant_order_data":{"url":"https://example.com/orders/12345"},"statement_descriptor_suffix":"12345"}}}}},"descriptionNode":"$L1b7c"},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"code":{"type":"string","description":"An identifier that can be used to determine what went wrong.\n\nError codes are not globally unique, but uniqueness is guaranteed within endpoints.","descriptionNode":"$L1b7d"},"message":{"type":"string","description":"Some human readable text describing what went wrong.","descriptionNode":"$L1b7e"},"timestamp":{"type":"integer","description":"The [UNIX timestamp](https://www.unixtimestamp.com/) of the date and time the error happened.","descriptionNode":"$L1b7f"}}},"examples":{"default":{"value":{"code":"bad_request","message":"Could not parse JSON","timestamp":1721049596461}}}}},"headers":{},"descriptionNode":"$L1b80"},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"code":{"type":"string","description":"An identifier that can be used to determine what went wrong.\n\nError codes are not globally unique, but uniqueness is guaranteed within endpoints.","descriptionNode":"$L1b81"},"message":{"type":"string","description":"Some human readable text describing what went wrong.","descriptionNode":"$L1b82"},"timestamp":{"type":"integer","description":"The [UNIX timestamp](https://www.unixtimestamp.com/) of the date and time the error happened.","descriptionNode":"$L1b83"}}},"examples":{"default":{"value":{"code":"unauthenticated","message":"Authentication failed","timestamp":1721049596461}}}}},"descriptionNode":"$L1b84"},"404":{"description":"Not Found","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"code":{"type":"string","description":"An identifier that can be used to determine what went wrong.\n\nError codes are not globally unique, but uniqueness is guaranteed within endpoints.","descriptionNode":"$L1b85"},"message":{"type":"string","description":"Some human readable text describing what went wrong.","descriptionNode":"$L1b86"},"timestamp":{"type":"integer","description":"The [UNIX timestamp](https://www.unixtimestamp.com/) of the date and time the error happened.","descriptionNode":"$L1b87"}}},"examples":{"default":{"value":{"code":"not_found","message":"Order with id abfa5bbd-a20c-4a0e-be66-30e733454518 was not found","timestamp":1721050063886}}}}},"descriptionNode":"$L1b88"},"422":{"description":"Unprocessable Entity","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"code":{"type":"string","description":"An identifier that can be used to determine what went wrong.\n\nError codes are not globally unique, but uniqueness is guaranteed within endpoints.","descriptionNode":"$L1b89"},"message":{"type":"string","description":"Some human readable text describing what went wrong.","descriptionNode":"$L1b8a"},"timestamp":{"type":"integer","description":"The [UNIX timestamp](https://www.unixtimestamp.com/) of the date and time the error happened.","descriptionNode":"$L1b8b"}}},"examples":{"default":{"value":{"code":"order_invalid_state","message":"Operation cannot be performed because order is in completed state and expected is [pending]","timestamp":1721049952145}}}}},"descriptionNode":"$L1b8c"}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","description":"Object schema containing information about order update body request parameters.","properties":{"amount":{"type":"integer","description":"The order total expressed in minor currency units, according to the [ISO 4217 standard](https://en.wikipedia.org/wiki/ISO_4217). For example, `7034` in `EUR` corresponds to €70.34.\n\n:::info\n- Conversion between major and minor units varies by currency. For instance, `100` minor units equal £1.00 in `GBP`, whereas in `ISK` they represent 100 units. For more details, see the [ISO 4217 standard](https://en.wikipedia.org/wiki/ISO_4217).\n- If `line_items` are provided, the order `amount` must equal the sum of all line items' `total_amount`.\n- For card payments with a non-zero amount, the order `amount` must be at least **$0.005** (or equivalent in different currencies, calculated using Revolut's exchange rate on the payment date). Otherwise, card payments can't be performed.\n:::","descriptionNode":"$L1b8d"},"currency":{"type":"string","format":"ISO 4217","minLength":3,"maxLength":3,"description":"[ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) currency code in upper case.\n\n:::info\nFor more information about the supported currencies, see: [Help Center](https://help.revolut.com/business/help/merchant-accounts/payments/in-which-currencies-can-i-accept-payments/).\n:::","descriptionNode":"$L1b8e"},"settlement_currency":{"type":"string","description":"[ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) currency code in upper case. \n\nIf `settlement_currency` is different from the value of `currency`, the money will be exchanged when the amount is settled to your merchant account. In case of a refund or chargeback, the money will be exchanged to the order's initial `currency`.\n\nIf `settlement_currency` is not specified, this value is taken from `currency`.\n\n:::info\nFor more information about the supported currencies, see: [Help Center](https://help.revolut.com/business/help/merchant-accounts/payments/in-which-currencies-can-i-accept-payments/).\n:::","descriptionNode":"$L1b8f"},"description":{"type":"string","description":"The description of the order.","descriptionNode":"$L1b90"},"customer":{"type":"object","description":"$1b91","properties":{"id":{"type":"string","format":"uuid","description":"Permanent ID of a customer used to retrieve, update, delete a customer. This ID can also be used to link customer to an order.\n\n:::note\nIf you provide the customer's ID during order creation, no other customer data is required, they will be parsed automatically from the referenced customer object.\n:::","descriptionNode":"$L1b92"},"full_name":{"type":"string","description":"The full name of the customer.","descriptionNode":"$L1b93"},"phone":{"type":"string","description":"The phone number of the customer in [E.164 format](https://en.wikipedia.org/wiki/E.164).","descriptionNode":"$L1b94"},"email":{"type":"string","format":"email","description":"The email address of the customer.","descriptionNode":"$L1b95"},"date_of_birth":{"type":"string","format":"date","description":"The birth date of the customer.","descriptionNode":"$L1b96"}},"descriptionNode":"$L1b97"},"enforce_challenge":{"type":"string","description":"The enforce challenge mode. `automatic` is used by default.\n\n| Parameter value | Description |\n| --------------- | ----------- |\n| `automatic` | The payments created for an order will have challenge requirement calculated by our fraud mechanisms. Not all payments will trigger a 3DS challenge. |\n| `forced` | The payments created for an order will always require a 3DS challenge. Currently only supported for card payments. |","default":"automatic","enum":"$19:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:orders:items:properties:enforce_challenge:enum","descriptionNode":"$L1b98"},"line_items":{"type":"array","maxItems":250,"description":"An array of line items included in the order. Each line item represents an individual product or service, along with its quantity, price, taxes, and discounts.\n\n:::info\nRequired for merchants collecting payment for one or multiple products/services in one transaction. Omitting this information may trigger additional scrutiny and risk mitigation actions by Revolut.\n:::","items":{"type":"object","properties":{"name":{"type":"string","maxLength":250,"description":"Name of the line item.","descriptionNode":"$L1b99"},"type":{"type":"string","enum":"$19:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:orders:items:properties:line_items:items:properties:type:enum","description":"Type of the line item.","descriptionNode":"$L1b9a"},"quantity":{"type":"object","description":"Object representing the quantity details of a line item, including the amount and its associated unit of measurement.","properties":{"value":{"type":"number","format":"double","minimum":0,"description":"The number of units of the line item.","descriptionNode":"$L1b9b"},"unit":{"type":"string","maxLength":100,"description":"The measurement unit for the quantity, such as `cm`, or `kg`.","descriptionNode":"$L1b9c"}},"required":"$19:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:orders:items:properties:line_items:items:properties:quantity:required","descriptionNode":"$L1b9d"},"unit_price_amount":{"type":"integer","format":"int64","minimum":0,"description":"The unit price of the line item.","descriptionNode":"$L1b9e"},"total_amount":{"type":"integer","format":"int64","description":"The total amount to be paid for the line item, including taxes and discounts.","descriptionNode":"$L1b9f"},"external_id":{"type":"string","maxLength":250,"description":"Unique identifier of line item in the merchant's system.","descriptionNode":"$L1ba0"},"discounts":{"type":"array","maxItems":50,"description":"A list of discounts applied to the line item. Each discount should be subtracted from the total amount payable for the item.","items":{"type":"object","description":"Details of a discount applied to the line item, including its name and monetary value.","properties":{"name":{"type":"string","maxLength":100,"description":"The specific name or label of the discount applied to the line item.","descriptionNode":"$L1ba1"},"amount":{"type":"integer","format":"int64","minimum":0,"description":"The monetary value of the discount. ","descriptionNode":"$L1ba2"}},"required":"$19:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:orders:items:properties:line_items:items:properties:discounts:items:required","descriptionNode":"$L1ba3"},"descriptionNode":"$L1ba4"},"taxes":{"type":"array","maxItems":50,"description":"A list of taxes applied to the line item. Each tax should be added to the total amount payable for the item.","items":{"type":"object","description":"Details about a tax applied to the line item, including its name and the corresponding amount.","properties":{"name":{"type":"string","description":"The specific name or designation of the tax applied to the line item.","maxLength":100,"descriptionNode":"$L1ba5"},"amount":{"type":"integer","format":"int64","description":"The monetary value of the tax in minor currency units (e.g., cents for EUR).","minimum":0,"descriptionNode":"$L1ba6"}},"required":"$19:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:orders:items:properties:line_items:items:properties:taxes:items:required","descriptionNode":"$L1ba7"},"descriptionNode":"$L1ba8"},"image_urls":{"type":"array","maxItems":50,"description":"A list of URLs pointing to images related to the line item. These images can provide visual details or representations of the item.","items":{"type":"string","format":"uri","pattern":"^https?:\\/{2}.+/gi","maxLength":2000,"description":"URL to an image associated with the line item.\n\n:::warning\nRestrictions:\n- Must be a valid URI as defined by [RFC 3986](https://datatracker.ietf.org/doc/html/rfc3986)\n- URI scheme is required and must be either `http` or `https`\n- URI host is required and cannot be `localhost` or an IP address\n- Max length: `2000`\n- Reserved or invalid characters must be percent-encoded (for example, use `%20` instead of a space)\n:::","descriptionNode":"$L1ba9"},"descriptionNode":"$L1baa"},"description":{"type":"string","maxLength":1024,"description":"Description of the line item.","descriptionNode":"$L1bab"},"url":{"type":"string","format":"uri","pattern":"^https?:\\/{2}.+/gi","maxLength":2000,"description":"An HTTP/HTTPS URL that links to more information about the line item, such as a product page or details.\n\n:::warning\nRestrictions:\n- Must be a valid URI as defined by [RFC 3986](https://datatracker.ietf.org/doc/html/rfc3986)\n- URI scheme is required and must be either `http` or `https`\n- URI host is required and cannot be `localhost` or an IP address\n- Max length: `2000`\n- Reserved or invalid characters must be percent-encoded (for example, use `%20` instead of a space)\n:::","descriptionNode":"$L1bac"}},"required":"$19:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:orders:items:properties:line_items:items:required"},"descriptionNode":"$L1bad"},"shipping":{"type":"object","description":"Details about the shipping related to the order, including address, contact information, and individual shipments.\n\n:::info\nRequired for merchants shipping physical goods. Omitting this information may trigger additional scrutiny and risk mitigation actions by Revolut.\n:::","properties":{"address":{"type":"object","description":"Details of a physical address.","properties":{"street_line_1":{"type":"string","description":"Primary address line.","maxLength":100,"descriptionNode":"$L1bae"},"street_line_2":{"type":"string","description":"Secondary address line, such as floor and apartment number.","maxLength":100,"descriptionNode":"$L1baf"},"region":{"type":"string","description":"State or province of the address.","maxLength":100,"descriptionNode":"$L1bb0"},"city":{"type":"string","description":"City of the address.","maxLength":100,"descriptionNode":"$L1bb1"},"country_code":{"type":"string","pattern":"^[A-Z]{2}$","description":"ISO 2-letter country code.","minLength":2,"maxLength":2,"descriptionNode":"$L1bb2"},"postcode":{"type":"string","description":"Postal code of the address.","maxLength":100,"descriptionNode":"$L1bb3"}},"required":"$60:props:children:0:props:children:props:responses:200:content:application/json:schema:oneOf:1:properties:details:properties:address:required","descriptionNode":"$L1bb4"},"contact":{"type":"object","description":"Contact details for someone responsible for the shipment.\n\n:::warning\nAt least `email` or `phone` is required.\n:::","properties":{"name":{"type":"string","description":"Full name of the contact person.","maxLength":250,"descriptionNode":"$L1bb5"},"email":{"type":"string","format":"email","description":"Email address of the contact person.","descriptionNode":"$L1bb6"},"phone":{"type":"string","description":"Phone number of the contact person.","descriptionNode":"$L1bb7"}},"descriptionNode":"$L1bb8"},"shipments":{"type":"array","description":"List of individual shipment details.","maxItems":50,"items":{"type":"object","description":"Details of an individual shipment.","properties":{"shipping_company_name":{"type":"string","maxLength":250,"description":"Name of the company handling the shipment.","descriptionNode":"$L1bb9"},"tracking_number":{"type":"string","maxLength":500,"description":"Unique tracking number for the shipment.","descriptionNode":"$L1bba"},"estimated_delivery_date":{"type":"string","format":"date-time","description":"Estimated delivery date and time for the shipment. \nThe time should also include the customer's timezone.","descriptionNode":"$L1bbb"},"tracking_url":{"type":"string","format":"uri","pattern":"^https?:\\/{2}.+/gi","maxLength":2000,"description":"An HTTP/HTTPS URL where the shipment can be tracked.\n\n:::warning\nRestrictions:\n- Must be a valid URI as defined by [RFC 3986](https://datatracker.ietf.org/doc/html/rfc3986)\n- URI scheme is required and must be either `http` or `https`\n- URI host is required and cannot be `localhost` or an IP address\n- Max length: `2000`\n- Reserved or invalid characters must be percent-encoded (for example, use `%20` instead of a space)\n:::","descriptionNode":"$L1bbc"}},"required":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:shipping:properties:shipments:items:required","descriptionNode":"$L1bbd"},"descriptionNode":"$L1bbe"}},"descriptionNode":"$L1bbf"},"capture_mode":{"type":"string","description":"The capture mode of the order. `automatic` is used by default.\n\n| Parameter value | Description |\n| --------------- | ----------- |\n| `automatic` | The order is captured automatically after payment authorisation. |\n| `manual` | The order is not captured automatically. You must manually capture the order later. |\n\n:::info\nFor more information, see [Capture an order](https://developer.revolut.com/docs/api/merchant#capture-order).\n:::","default":"automatic","enum":"$19:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:orders:items:properties:capture_mode:enum","descriptionNode":"$L1bc0"},"cancel_authorised_after":{"type":"string","format":"duration","description":"$1bc1","descriptionNode":"$L1bc2"},"expire_pending_after":{"type":"string","format":"duration","description":"Automatic expiration period for pending orders, specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format.\n\nOrders in `pending` state will be automatically failed if they stay unpaid for longer than the period specified.\n\nWhen the order expires, it transitions to the `failed` state and an `ORDER_FAILED` webhook event is triggered.\n\n:::note\n- This field can only be set during order creation and cannot be updated afterward.\n- Must be between `PT1M` (1 minute) and `PT720H` (30 days).\n- Cannot be a negative value.\n:::","examples":["PT15M"],"descriptionNode":"$L1bc3"},"metadata":{"type":"object","description":"Additional information to track your orders in your system, by providing custom metadata using `\"\" : \"\"` pairs.\n\n:::warning\n**Restrictions:**\n\n- Both keys and values must be `string`s\n- Values cannot be `null`.\n- Max number of key-value pairs: `50`\n- Max length of values: `500` characters\n- Format of keys: Must start with a letter and contain only letters, digits, and underscores. Max 40 characters. Pattern: `^[a-zA-Z][a-zA-Z\\\\d_]{0,39}$`\n:::","maxProperties":50,"additionalProperties":{"type":"string","maxLength":500,"description":"Additional metadata value provided with the corresponding metadata key.","descriptionNode":"$L1bc4"},"examples":"$19:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:orders:items:properties:metadata:examples","descriptionNode":"$L1bc5"},"industry_data":{"type":"object","description":"Object containing industry-specific information associated with the order.\n\n:::info\nIn the following cases, industry-specific info is required. Omitting this information may trigger additional scrutiny and risk mitigation actions by the Revolut risk team.\n\n | Transaction type | Required for |\n | ---------------- | ----------- |\n | `airline` | Airlines and Online Travel Agencies (OTAs). |\n | `car_rental` | Car Rental Merchants and Online Travel Agencies (OTAs). |\n | `crypto` | Crypto merchants. |\n | `marketplace` | Marketplace merchants. |\n | `event` | Event ticket sellers. |\n | `lodging` | Lodging providers. |\n:::","discriminator":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:discriminator","oneOf":[{"type":"object","description":"$1bc6","properties":{"type":{"type":"string","enum":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:0:properties:type:enum","description":"Type of the industry-specific data object, determining what additional data is expected.\n\nAvailable types:\n\n | Object type | Description |\n | ------------- | ----------- |\n | `airline` | Object containing information about a specific airline ticket purchase. |\n | `car_rental` | Object containing information about a car rental booking associated with the order. |\n | `crypto` | Object containing information about crypto transactions associated with the order. |\n | `marketplace` | This object is required by Mastercard and Visa for merchants operating as marketplaces under the **Merchant Category Code (MCC):** `5262`. The marketplace object ensures compliance with the card schemes' regulations by providing detailed information about the subseller involved in the transaction. |\n | `event` | Object containing information about event ticket bookings associated with the order. |\n | `lodging` | Object containing information about lodging bookings associated with the order. |","descriptionNode":"$L1bc7"},"booking_id":{"type":"string","description":"A unique identifier provided by the merchant associated with the order. \n\nThis `booking_id` is used to reference and correlate booking information with the Merchant API and the merchant's internal system.","descriptionNode":"$L1bc8"},"fulfillment_date":{"type":"string","format":"date-time","description":"The UTC date and time of the final journey leg.\n\n:::warning\nThe following limitations apply:\n - When creating or updating an order, `fulfillment_date` cannot be set to a date in the past.\n - When updating an order, if the current `fulfillment_date` value is already in the past, it cannot be modified. The date must remain as is to maintain data integrity for completed transactions.\n:::","descriptionNode":"$L1bc9"},"tickets_purchase":{"type":"boolean","description":"Flag indicating whether the order includes actual ticket purchases. Set to `true` if the order contains ticket purchases, and `false` if it does not (e.g., it **only** contains seat reservations, or baggage upgrades). \n\n:::info\nThis field is required for activating **Revolut Flight Alerts** functionalities within the Revolut app.\n\nProvide the info on order creation or update, before capturing the order.\n:::","descriptionNode":"$L1bca"},"ticket_type":{"type":"string","enum":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:0:properties:ticket_type:enum","description":"The type of the ticket.\n\n| Parameter value | Description |\n| --------------- | ----------- |\n| `fixed` | Non-modifiable once confirmed. |\n| `flexible` | Allows modifications or cancellations under specified conditions. |","descriptionNode":"$L1bcb"},"crs_code":{"type":"string","maxLength":4,"description":"The code of the Computer Reservation System (CRS) used to make the booking and purchase the ticket.","descriptionNode":"$L1bcc"},"ticket_change_indicator":{"type":"string","enum":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:0:properties:ticket_change_indicator:enum","description":"Parameter indicating whether this order is related to a new ticket reservation or a modification of an existing one.","descriptionNode":"$L1bcd"},"refundability":{"type":"string","enum":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:0:properties:refundability:enum","description":"Parameter indicating whether the booking is refundable, partially refundable, or not refundable.","descriptionNode":"$L1bce"},"passengers":{"type":"array","description":"Array containing information of passengers associated with the booking.","items":{"type":"object","properties":{"first_name":{"type":"string","description":"Passenger's first name.","descriptionNode":"$L1bcf"},"last_name":{"type":"string","description":"Passenger's last name.","descriptionNode":"$L1bd0"}},"required":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:0:properties:passengers:items:required"},"descriptionNode":"$L1bd1"},"journey_legs":{"type":"array","description":"Array containing information of journey legs associated with the booking.\n\n:::info\nThis field is required for activating **Revolut Flight Alerts** functionalities within the Revolut app. \n\nThis information is used to compile a tracking widget that provides real-time updates on flight status and sends notifications, such as a check-in reminders, boarding alerts, and notifications for cancellations or delays. \n\nTo enable the widget the following fields are required on order creation or update, before capturing the order:\n\n ```\n sequence,\n departure_airport_code,\n arrival_airport_code,\n flight_number,\n travel_date,\n airline_name,\n airline_code,\n ```\n:::","items":{"type":"object","properties":{"sequence":{"type":"integer","description":"Sequence of the journey legs. Increment by 1 for each flight included in the ticket.\n\nFor example: For a `FRA > LHR > DUB > LHR > FRA` journey the sequence will be assigned as:\n - `FRA > LHR`: 1\n - `LHR > DUB`: 2\n - `DUB > LHR`: 3\n - `LHR > FRA`: 4","descriptionNode":"$L1bd2"},"departure_airport_code":{"type":"string","description":"The [IATA](https://www.iata.org/en/services/codes) 3-letter airport code for the departure airport.","descriptionNode":"$L1bd3"},"arrival_airport_code":{"type":"string","description":"The [IATA](https://www.iata.org/en/services/codes) 3-letter airport code for the arrival airport.","descriptionNode":"$L1bd4"},"flight_number":{"type":"string","description":"The flight identifier, without airline code.","descriptionNode":"$L1bd5"},"fare_base_code":{"type":"string","description":"The fare base code for the given journey leg.","descriptionNode":"$L1bd6"},"travel_date":{"type":"string","format":"date-time","description":"The UTC date and time of the flight departure for the given journey leg.","descriptionNode":"$L1bd7"},"airline_name":{"type":"string","description":"The name of the airline associated with the journey leg.","descriptionNode":"$L1bd8"},"airline_code":{"type":"string","description":"The IATA 2-letter accounting code identifying the airline associated with the journey leg.","descriptionNode":"$L1bd9"},"pnr":{"type":"string","format":"alphanumeric","pattern":"^[a-zA-Z0-9]*$","maxLength":20,"description":"The Passenger Name Record (PNR) for the journey leg issued by the airline. \n\nPNR is a unique identifier for the booking, acting as a digital certificate allowing passengers to retrieve or manage their booking details.\n\n:::warning\nThis is a required field for OTAs.\n:::","descriptionNode":"$L1bda"}},"required":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:0:properties:journey_legs:items:required"},"descriptionNode":"$L1bdb"},"booking_url":{"type":"string","format":"uri","pattern":"^https?:\\/{2}.+/gi","maxLength":2000,"description":"URL to the online portal for managing the airline booking, which includes check-in functionality. This URL may be a personalised, pre-populated check-in link specific to the user or a generic link, and it is essential for enabling direct access to booking details within the Revolut app.\n\n:::info\nThis field is required for activating **Revolut Flight Alerts** functionalities within the Revolut app. \n\nProvide the info on order creation or update, before capturing the order.\n:::\n\n:::warning\nRestrictions:\n- Must be a valid URI as defined by [RFC 3986](https://datatracker.ietf.org/doc/html/rfc3986)\n- URI scheme is required and must be either `http` or `https`\n- URI host is required and cannot be `localhost` or an IP address\n- Max length: `2000`\n- Reserved or invalid characters must be percent-encoded (for example, use `%20` instead of a space)\n:::","descriptionNode":"$L1bdc"}},"required":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:0:required","descriptionNode":"$L1bdd"},{"type":"object","description":"Object containing additional information about a car rental booking associated with the order.\n\n:::info\nThese are the specific data field requirements for merchants offering car rental. Note that these requirements can be extended on a case by case basis as decided by Revolut.\n\n```\nbooking_id\ndrop_off_date\nrefundability\n```\n:::","properties":{"type":{"type":"string","enum":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:0:properties:type:enum","description":"Type of the industry-specific data object, determining what additional data is expected.\n\nAvailable types:\n\n | Object type | Description |\n | ------------- | ----------- |\n | `airline` | Object containing information about a specific airline ticket purchase. |\n | `car_rental` | Object containing information about a car rental booking associated with the order. |\n | `crypto` | Object containing information about crypto transactions associated with the order. |\n | `marketplace` | This object is required by Mastercard and Visa for merchants operating as marketplaces under the **Merchant Category Code (MCC):** `5262`. The marketplace object ensures compliance with the card schemes' regulations by providing detailed information about the subseller involved in the transaction. |\n | `event` | Object containing information about event ticket bookings associated with the order. |\n | `lodging` | Object containing information about lodging bookings associated with the order. |","descriptionNode":"$L1bde"},"booking_id":{"type":"string","description":"A unique identifier provided by the merchant associated with the order. \n\nThis `booking_id` is used to reference and correlate booking information with the Merchant API and the merchant's internal system.","descriptionNode":"$L1bdf"},"pick_up_date":{"type":"string","format":"date-time","description":"The UTC date and time of the pick-up.","descriptionNode":"$L1be0"},"pick_up_location":{"type":"object","description":"Object containing address details.","properties":{"street_line_1":{"type":"string","description":"Street line 1 information.","maxLength":100,"descriptionNode":"$L1be1"},"street_line_2":{"type":"string","description":"Street line 2 information.","maxLength":100,"descriptionNode":"$L1be2"},"region":{"type":"string","description":"The region associated with the address.","maxLength":100,"descriptionNode":"$L1be3"},"city":{"type":"string","description":"The city associated with the address.","maxLength":100,"descriptionNode":"$L1be4"},"country_code":{"type":"string","description":"The 2-letter country code of the country associated with the address.","maxLength":2,"descriptionNode":"$L1be5"},"postcode":{"type":"string","description":"The postcode associated with the address.","maxLength":100,"descriptionNode":"$L1be6"}},"required":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:billing_address:required","descriptionNode":"$L1be7"},"drop_off_date":{"type":"string","format":"date-time","description":"The UTC date and time of the drop-off.","descriptionNode":"$L1be8"},"drop_off_location":{"type":"object","description":"Object containing address details.","properties":{"street_line_1":"$1b:props:children:0:props:children:props:requestBody:content:application/json:schema:properties:industry_data:oneOf:1:properties:pick_up_location:properties:street_line_1","street_line_2":"$1b:props:children:0:props:children:props:requestBody:content:application/json:schema:properties:industry_data:oneOf:1:properties:pick_up_location:properties:street_line_2","region":"$1b:props:children:0:props:children:props:requestBody:content:application/json:schema:properties:industry_data:oneOf:1:properties:pick_up_location:properties:region","city":"$1b:props:children:0:props:children:props:requestBody:content:application/json:schema:properties:industry_data:oneOf:1:properties:pick_up_location:properties:city","country_code":"$1b:props:children:0:props:children:props:requestBody:content:application/json:schema:properties:industry_data:oneOf:1:properties:pick_up_location:properties:country_code","postcode":"$1b:props:children:0:props:children:props:requestBody:content:application/json:schema:properties:industry_data:oneOf:1:properties:pick_up_location:properties:postcode"},"required":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:billing_address:required","descriptionNode":"$L1be9"},"refundability":{"type":"string","enum":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:0:properties:refundability:enum","description":"Parameter indicating whether the booking is refundable, partially refundable, or not refundable.","descriptionNode":"$L1bea"},"distance_limit":{"type":"object","description":"Object containing distance limit information.","properties":{"limit":{"type":"integer","description":"The maximum distance allowed.","descriptionNode":"$L1beb"},"unit":{"type":"string","description":"The unit of distance.","enum":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:1:properties:distance_limit:properties:unit:enum","descriptionNode":"$L1bec"},"additional_distance_cost":{"type":"object","description":"Cost for exceeding the distance limit.","properties":{"amount":{"type":"integer","description":"The amount of the cost in minor currency units. For example, enter `7034` for €70.34.","descriptionNode":"$L1bed"},"currency":{"type":"string","format":"ISO 4217","minLength":3,"maxLength":3,"description":"[ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) currency code in upper case.\n\n:::info\nFor more information about the supported currencies, see: [Help Center](https://help.revolut.com/business/help/merchant-accounts/payments/in-which-currencies-can-i-accept-payments/).\n:::","descriptionNode":"$L1bee"}},"descriptionNode":"$L1bef"}},"descriptionNode":"$L1bf0"}},"required":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:1:required","descriptionNode":"$L1bf1"},{"type":"object","description":"Object containing information about crypto transactions associated with the order.\n\n:::info\nProcessing crypto on-ramp transactions with Revolut has additional compliance requirements. Please reach out to your account executive for additional details.\n\n**Required data fields for crypto services:**\n\n```\ntransactions[].id\ntransactions[].status\ntransactions[].recipient_wallet_id\nseller.id\nseller.name\nseller.website\nseller.phone\nseller.address\nseller.mcc\ncustomer.full_name\ncustomer.date_of_birth\n```\n\nNote that these requirements can be extended on a case by case basis as decided by Revolut.\n:::","properties":{"type":{"type":"string","enum":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:0:properties:type:enum","description":"Type of the industry-specific data object, determining what additional data is expected.\n\nAvailable types:\n\n | Object type | Description |\n | ------------- | ----------- |\n | `airline` | Object containing information about a specific airline ticket purchase. |\n | `car_rental` | Object containing information about a car rental booking associated with the order. |\n | `crypto` | Object containing information about crypto transactions associated with the order. |\n | `marketplace` | This object is required by Mastercard and Visa for merchants operating as marketplaces under the **Merchant Category Code (MCC):** `5262`. The marketplace object ensures compliance with the card schemes' regulations by providing detailed information about the subseller involved in the transaction. |\n | `event` | Object containing information about event ticket bookings associated with the order. |\n | `lodging` | Object containing information about lodging bookings associated with the order. |","descriptionNode":"$L1bf2"},"transactions":{"type":"array","description":"Array of crypto transaction data associated with the order.","items":{"type":"object","properties":{"id":{"type":"string","maxLength":255,"description":"The public transaction hash of the crypto transaction.","descriptionNode":"$L1bf3"},"status":{"type":"string","enum":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:2:properties:transactions:items:properties:status:enum","description":"The status of the crypto transaction.","descriptionNode":"$L1bf4"},"recipient_wallet_id":{"type":"string","maxLength":255,"description":"The wallet ID of the recipient.\n\n:::note\nAt least one of the parameters: `recipient_user_id` or `recipient_wallet_id` is required.\n::: ","descriptionNode":"$L1bf5"},"recipient_user_id":{"type":"string","maxLength":255,"description":"The user ID of the recipient.\n\n:::note\nAt least one of the parameters: `recipient_user_id` or `recipient_wallet_id` is required.\n::: ","descriptionNode":"$L1bf6"}},"required":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:2:properties:transactions:items:required"},"minItems":1,"descriptionNode":"$L1bf7"},"seller":{"type":"object","description":"Information about the crypto conversion affiliate.\n\nThis should be provided when a customer completes a payment on a subseller's website rather than directly on the merchant's website, providing insight into the type of business conducted by the subseller.\n\n:::note\nThis needs to be provided only by crypto on-ramp providers for payments they are processing for conversion affiliates.\n\nFor their own payments, `seller` can be omitted.\n:::","properties":{"mcc":{"type":"string","description":"A string representing the four-digit [Merchant Category Code (MCC)](https://en.wikipedia.org/wiki/Merchant_category_code) of the conversion affiliate.","maxLength":4,"minLength":4,"pattern":"^\\d{4}$","descriptionNode":"$L1bf8"},"id":{"type":"string","description":"The ID of the seller in the merchant's internal system.","minLength":1,"maxLength":15,"descriptionNode":"$L1bf9"},"name":{"type":"string","description":"The business or legal name of the seller.","minLength":1,"maxLength":50,"descriptionNode":"$L1bfa"},"website":{"type":"string","format":"uri","pattern":"^https?:\\/{2}.+/gi","maxLength":255,"description":"The URL of the website of the seller.\n\n:::warning\nRestrictions:\n- Must be a valid URI as defined by [RFC 3986](https://datatracker.ietf.org/doc/html/rfc3986)\n- URI scheme is required and must be either `http` or `https`\n- URI host is required and cannot be `localhost` or an IP address\n- Max length: `255`\n- Reserved or invalid characters must be percent-encoded (for example, use `%20` instead of a space)\n:::","descriptionNode":"$L1bfb"},"phone":{"type":"string","description":"The phone number of the seller.","descriptionNode":"$L1bfc"},"address":{"type":"object","description":"Details of a physical address.","properties":{"street_line_1":{"type":"string","description":"Primary address line.","maxLength":100,"descriptionNode":"$L1bfd"},"street_line_2":{"type":"string","description":"Secondary address line, such as floor and apartment number.","maxLength":100,"descriptionNode":"$L1bfe"},"region":{"type":"string","description":"State or province of the address.","maxLength":100,"descriptionNode":"$L1bff"},"city":{"type":"string","description":"City of the address.","maxLength":100,"descriptionNode":"$L1c00"},"country_code":{"type":"string","pattern":"^[A-Z]{2}$","description":"ISO 2-letter country code.","minLength":2,"maxLength":2,"descriptionNode":"$L1c01"},"country_subdivision_code":{"type":"string","pattern":"^[A-Z]{2}-[A-Z0-9]{1,3}$","description":"The subdivision code represents the state, province, or region within the country, following the [ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2) standard. This code uniquely identifies subdivisions within a country. \n\nFor example, for London in the United Kingdom, use `GB-LND`.\n\n:::warning\nThe parameter is required for countries listed on the [ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2) page.\n:::","minLength":5,"maxLength":6,"descriptionNode":"$L1c02"},"postcode":{"type":"string","description":"Postal code of the address.","maxLength":100,"descriptionNode":"$L1c03"}},"required":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:2:properties:seller:properties:address:required","descriptionNode":"$L1c04"}},"required":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:2:properties:seller:required","descriptionNode":"$L1c05"}},"required":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:2:required","descriptionNode":"$L1c06"},{"type":"object","description":"This object is required by Mastercard and Visa for merchants operating as marketplaces under the Merchant Category Code (MCC) `5262`. The marketplace object ensures compliance with the card schemes' regulations by providing detailed information about the seller involved in the transaction.\n\n:::info\nThese are the specific data field requirements for merchants who must provide marketplace data.\n\n```\nseller.id\nseller.name\nseller.website\nseller.phone\nseller.address\n```\n:::","properties":{"type":{"type":"string","enum":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:0:properties:type:enum","description":"Type of the industry-specific data object, determining what additional data is expected.\n\nAvailable types:\n\n | Object type | Description |\n | ------------- | ----------- |\n | `airline` | Object containing information about a specific airline ticket purchase. |\n | `car_rental` | Object containing information about a car rental booking associated with the order. |\n | `crypto` | Object containing information about crypto transactions associated with the order. |\n | `marketplace` | This object is required by Mastercard and Visa for merchants operating as marketplaces under the **Merchant Category Code (MCC):** `5262`. The marketplace object ensures compliance with the card schemes' regulations by providing detailed information about the subseller involved in the transaction. |\n | `event` | Object containing information about event ticket bookings associated with the order. |\n | `lodging` | Object containing information about lodging bookings associated with the order. |","descriptionNode":"$L1c07"},"seller":{"type":"object","description":"Information about the subseller on the marketplace platform.","properties":{"id":{"type":"string","description":"The ID of the seller in the merchant's internal system.","minLength":1,"maxLength":15,"descriptionNode":"$L1c08"},"name":{"type":"string","description":"The business or legal name of the seller.","minLength":1,"maxLength":50,"descriptionNode":"$L1c09"},"website":{"type":"string","format":"uri","pattern":"^https?:\\/{2}.+/gi","maxLength":255,"description":"The URL of the website of the seller.\n\n:::warning\nRestrictions:\n- Must be a valid URI as defined by [RFC 3986](https://datatracker.ietf.org/doc/html/rfc3986)\n- URI scheme is required and must be either `http` or `https`\n- URI host is required and cannot be `localhost` or an IP address\n- Max length: `255`\n- Reserved or invalid characters must be percent-encoded (for example, use `%20` instead of a space)\n:::","descriptionNode":"$L1c0a"},"phone":{"type":"string","description":"The phone number of the seller.","descriptionNode":"$L1c0b"},"address":{"type":"object","description":"Details of a physical address.","properties":{"street_line_1":"$1b:props:children:0:props:children:props:requestBody:content:application/json:schema:properties:industry_data:oneOf:2:properties:seller:properties:address:properties:street_line_1","street_line_2":"$1b:props:children:0:props:children:props:requestBody:content:application/json:schema:properties:industry_data:oneOf:2:properties:seller:properties:address:properties:street_line_2","region":"$1b:props:children:0:props:children:props:requestBody:content:application/json:schema:properties:industry_data:oneOf:2:properties:seller:properties:address:properties:region","city":"$1b:props:children:0:props:children:props:requestBody:content:application/json:schema:properties:industry_data:oneOf:2:properties:seller:properties:address:properties:city","country_code":"$1b:props:children:0:props:children:props:requestBody:content:application/json:schema:properties:industry_data:oneOf:2:properties:seller:properties:address:properties:country_code","country_subdivision_code":"$1b:props:children:0:props:children:props:requestBody:content:application/json:schema:properties:industry_data:oneOf:2:properties:seller:properties:address:properties:country_subdivision_code","postcode":"$1b:props:children:0:props:children:props:requestBody:content:application/json:schema:properties:industry_data:oneOf:2:properties:seller:properties:address:properties:postcode"},"required":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:2:properties:seller:properties:address:required","descriptionNode":"$L1c0c"}},"required":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:3:properties:seller:required","descriptionNode":"$L1c0d"}},"required":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:3:required","descriptionNode":"$L1c0e"},{"type":"object","description":"Object containing booking information for a list of event tickets associated with the order.\n\n:::info\nThese are the specific data field requirements for merchants who must provide event data. Note that these requirements can be extended on a case by case basis as decided by Revolut.\n\n```\nbooking_id\nevents[].start_date\nevents[].end_date\nevents[].supplier\nevents[].tickets[].id\n```\n:::","properties":{"type":{"type":"string","enum":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:0:properties:type:enum","description":"Type of the industry-specific data object, determining what additional data is expected.\n\nAvailable types:\n\n | Object type | Description |\n | ------------- | ----------- |\n | `airline` | Object containing information about a specific airline ticket purchase. |\n | `car_rental` | Object containing information about a car rental booking associated with the order. |\n | `crypto` | Object containing information about crypto transactions associated with the order. |\n | `marketplace` | This object is required by Mastercard and Visa for merchants operating as marketplaces under the **Merchant Category Code (MCC):** `5262`. The marketplace object ensures compliance with the card schemes' regulations by providing detailed information about the subseller involved in the transaction. |\n | `event` | Object containing information about event ticket bookings associated with the order. |\n | `lodging` | Object containing information about lodging bookings associated with the order. |","descriptionNode":"$L1c0f"},"booking_id":{"type":"string","description":"A unique identifier provided by the merchant associated with the order. \n\nThis `booking_id` is used to reference and correlate booking information with the Merchant API and the merchant's internal system.","descriptionNode":"$L1c10"},"events":{"type":"array","description":"A list of events associated with the booking.","items":{"type":"object","description":"Object containing booking information about a specific event. ","properties":{"start_date":{"type":"string","format":"date-time","description":"[ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time when the event starts.","descriptionNode":"$L1c11"},"end_date":{"type":"string","format":"date-time","description":"[ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time when the event ends.","descriptionNode":"$L1c12"},"supplier":{"type":"string","description":"Legal name of the ticket vendor/event organiser.","descriptionNode":"$L1c13"},"supplier_payment_date":{"type":"string","format":"date-time","description":"[ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time when the funds are released to merchants.","descriptionNode":"$L1c14"},"name":{"type":"string","description":"The name of the event.","descriptionNode":"$L1c15"},"location":{"type":"object","description":"The address of the event location.","properties":{"street_line_1":{"type":"string","description":"Primary address line.","maxLength":100,"descriptionNode":"$L1c16"},"street_line_2":{"type":"string","description":"Secondary address line, such as floor and apartment number.","maxLength":100,"descriptionNode":"$L1c17"},"region":{"type":"string","description":"State or province of the address.","maxLength":100,"descriptionNode":"$L1c18"},"city":{"type":"string","description":"City of the address.","maxLength":100,"descriptionNode":"$L1c19"},"country_code":{"type":"string","pattern":"^[A-Z]{2}$","description":"ISO 2-letter country code.","minLength":2,"maxLength":2,"descriptionNode":"$L1c1a"},"postcode":{"type":"string","description":"Postal code of the address.","maxLength":100,"descriptionNode":"$L1c1b"}},"required":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:4:properties:events:items:properties:location:required","descriptionNode":"$L1c1c"},"category":{"type":"string","enum":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:4:properties:events:items:properties:category:enum","description":"The type of the event.","descriptionNode":"$L1c1d"},"market":{"type":"string","enum":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:4:properties:events:items:properties:market:enum","description":"Indicates the relationship between the ticket vendor and the event organiser. \n\n| Parameter value | Description |\n| --------------- | ----------- |\n| `primary` | The merchant is the organiser and primary distributor of the tickets. |\n| `secondary` | The merchant is a reseller, only distributing the tickets. |","descriptionNode":"$L1c1e"},"tickets":{"type":"array","items":{"type":"object","description":"Object containing information about a ticket associated with the booking.","properties":{"id":{"type":"string","description":"A unique identifier provided by the merchant associated with the ticket.","descriptionNode":"$L1c1f"},"transferable":{"type":"boolean","description":"Indicates whether the ticket is transferable to another buyer.","descriptionNode":"$L1c20"},"refundability":{"type":"string","enum":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:0:properties:refundability:enum","description":"Parameter indicating whether the booking is refundable, partially refundable, or not refundable.","descriptionNode":"$L1c21"}},"required":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:4:properties:events:items:properties:tickets:items:required","descriptionNode":"$L1c22"},"description":"A list of tickets associated with the booking.","descriptionNode":"$L1c23"}},"descriptionNode":"$L1c24"},"descriptionNode":"$L1c25"}},"required":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:4:required","descriptionNode":"$L1c26"},{"type":"object","description":"Object containing details of a lodging booking.\n\n:::info\nThese are the specific data field requirements for merchants who must provide lodging data. Note that these requirements can be extended on a case by case basis as decided by Revolut.\n\n```\nbooking_id\ncheck_in_date\ncheck_out_date\nsupplier_payment_date\n```\n:::","properties":{"type":{"type":"string","enum":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:0:properties:type:enum","description":"Type of the industry-specific data object, determining what additional data is expected.\n\nAvailable types:\n\n | Object type | Description |\n | ------------- | ----------- |\n | `airline` | Object containing information about a specific airline ticket purchase. |\n | `car_rental` | Object containing information about a car rental booking associated with the order. |\n | `crypto` | Object containing information about crypto transactions associated with the order. |\n | `marketplace` | This object is required by Mastercard and Visa for merchants operating as marketplaces under the **Merchant Category Code (MCC):** `5262`. The marketplace object ensures compliance with the card schemes' regulations by providing detailed information about the subseller involved in the transaction. |\n | `event` | Object containing information about event ticket bookings associated with the order. |\n | `lodging` | Object containing information about lodging bookings associated with the order. |","descriptionNode":"$L1c27"},"booking_id":{"type":"string","description":"A unique identifier provided by the merchant associated with the order. \n\nThis `booking_id` is used to reference and correlate booking information with the Merchant API and the merchant's internal system.","descriptionNode":"$L1c28"},"check_in_date":{"type":"string","format":"date-time","description":"[ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time of the check-in.","descriptionNode":"$L1c29"},"check_out_date":{"type":"string","format":"date-time","description":"[ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time of the check-out.","descriptionNode":"$L1c2a"},"supplier_payment_date":{"type":"string","format":"date-time","description":"[ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time when the funds are released to merchants.","descriptionNode":"$L1c2b"},"category":{"type":"string","enum":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:5:properties:category:enum","description":"The type of the accommodation associated with the booking.","descriptionNode":"$L1c2c"},"booking_type":{"type":"string","enum":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:5:properties:booking_type:enum","description":"Indicates whether the booking terms are fixed or flexible.\n\n| Parameter value | Description |\n| --------------- | ----------- |\n| `fixed` | Non-modifiable once confirmed. |\n| `flexible` | Allows modifications or cancellations under specified conditions. |","descriptionNode":"$L1c2d"},"refundability":{"type":"string","enum":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:0:properties:refundability:enum","description":"Parameter indicating whether the booking is refundable, partially refundable, or not refundable.","descriptionNode":"$L1c2e"},"location":{"type":"object","description":"Address of the accommodation.","properties":{"street_line_1":{"type":"string","description":"Primary address line.","maxLength":100,"descriptionNode":"$L1c2f"},"street_line_2":{"type":"string","description":"Secondary address line, such as floor and apartment number.","maxLength":100,"descriptionNode":"$L1c30"},"region":{"type":"string","description":"State or province of the address.","maxLength":100,"descriptionNode":"$L1c31"},"city":{"type":"string","description":"City of the address.","maxLength":100,"descriptionNode":"$L1c32"},"country_code":{"type":"string","pattern":"^[A-Z]{2}$","description":"ISO 2-letter country code.","minLength":2,"maxLength":2,"descriptionNode":"$L1c33"},"postcode":{"type":"string","description":"Postal code of the address.","maxLength":100,"descriptionNode":"$L1c34"}},"required":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:5:properties:location:required","descriptionNode":"$L1c35"},"guests":{"type":"array","items":{"type":"object","properties":{"first_name":{"type":"string","description":"Guest's first name.","descriptionNode":"$L1c36"},"last_name":{"type":"string","description":"Guest's last name.","descriptionNode":"$L1c37"}},"required":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:5:properties:guests:items:required"},"description":"List of guests associated with the booking.","descriptionNode":"$L1c38"}},"required":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:5:required","descriptionNode":"$L1c39"}],"descriptionNode":"$L1c3a"},"merchant_order_data":{"type":"object","description":"Object for providing additional information stored in the merchant's order management system. ","properties":{"url":{"type":"string","format":"uri","pattern":"^https?:\\/{2}.+/gi","maxLength":2000,"description":"The URL of the order stored in the merchant's order management system.\n\nThis URL will be included in the order confirmation email for payments made via Revolut Pay. If specified, this URL will override the default link to the merchant's **Business website** configured in the Revolut Business account.\n\n:::warning\nRestrictions:\n- Must be a valid URI as defined by [RFC 3986](https://datatracker.ietf.org/doc/html/rfc3986)\n- URI scheme is required and must be either `http` or `https`\n- URI host is required and cannot be `localhost` or an IP address\n- Max length: `2000`\n- Reserved or invalid characters must be percent-encoded (for example, use `%20` instead of a space)\n:::","descriptionNode":"$L1c3b"},"reference":{"type":"string","description":"Merchant order ID for external reference.\n\nUse this field to set the ID that your own system can use to easily track orders.","descriptionNode":"$L1c3c"}},"descriptionNode":"$L1c3d"},"upcoming_payment_data":{"type":"object","description":"Object containing information about upcoming payments associated with the order.","properties":{"date":{"type":"string","format":"date-time","description":"The date and time in [ISO 8601 format](https://en.wikipedia.org/wiki/ISO_8601) when the upcoming payment is scheduled to be executed.","descriptionNode":"$L1c3e"},"payment_method_id":{"type":"string","description":"The unique ID of the customer's payment method used to complete the scheduled payment.\n\n:::info\nFor more information about operations related to customer's payment methods, see:\n - [Retrieve payment method list of a customer](https://developer.revolut.com/docs/api/merchant#retrieve-payment-method-list)\n - [Retrieve a customer's payment method](https://developer.revolut.com/docs/api/merchant#retrieve-payment-method)\n - [Update a customer's payment method](https://developer.revolut.com/docs/api/merchant#update-payment-method)\n - [Delete a customer's payment method](https://developer.revolut.com/docs/api/merchant#delete-payment-method)\n:::","descriptionNode":"$L1c3f"}},"required":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:upcoming_payment_data:required","descriptionNode":"$L1c40"},"redirect_url":{"type":"string","format":"uri","pattern":"^https?:\\/{2}.+/gi","maxLength":2000,"description":"The URL your customer will be redirected to after a successful payment on the hosted checkout page (`checkout_url` parameter's value of the order).\n\n:::warning\nRestrictions:\n- Must be a valid URI as defined by [RFC 3986](https://datatracker.ietf.org/doc/html/rfc3986)\n- URI scheme is required and must be either `http` or `https`\n- URI host is required and cannot be `localhost` or an IP address\n- Max length: `2000`\n- Reserved or invalid characters must be percent-encoded (for example, use `%20` instead of a space)\n:::\n\n:::info\nFor more information on how to use the `redirect_url`, see: [Custom redirection via the API](https://developer.revolut.com/docs/guides/merchant/accept-payments/online-payments/hosted-checkout-page/api#custom-post-payment-redirection-optional)\n:::","descriptionNode":"$L1c41"},"statement_descriptor_suffix":{"type":"string","description":"$1c42","minLength":1,"maxLength":19,"pattern":"^[^*\\n\\r\\\\]+$","descriptionNode":"$L1c43"}},"descriptionNode":"$L1c44"},"examples":{"example_update_order":{"summary":"Example order update","value":{"amount":1000,"currency":"EUR","settlement_currency":"GBP","capture_mode":"manual","cancel_authorised_after":"P3D","metadata":{"example_key":"example_value"},"merchant_order_data":{"url":"https://example.com/orders/12345"},"statement_descriptor_suffix":"12345"}}}}}},"variantLabels":[],"children":["$L1c45","$L1c46"]}]}],false]}] 1c45:["$","div",null,{"className":"ezz1n30","children":[["$","div",null,{"data-header":"$undefined","className":"ezz1n31","children":["$","div",null,{"className":"y9a0do1","children":[["$","h2",null,{"id":"update-order","children":[["$L1c47","$undefined"],["$","$L15",null,{"id":"update-order"}]]}],["$","$L16",null,{"url":"/docs/api/merchant/2025-10-16/operations/update-order.md"}]]}]}],"$undefined"]}] 1c4d:Tadd,
curl -X PATCH "https://merchant.revolut.com/api/orders/__RP_TOK_0__" \
  -H "Content-Type: application/json" \
  -H "Authorization: __RP_TOK_1__" \
  -H "Revolut-Api-Version: __RP_TOK_2__" \
  -d '{
  "amount": 1000,
  "currency": "EUR",
  "settlement_currency": "GBP",
  "capture_mode": "manual",
  "cancel_authorised_after": "P3D",
  "metadata": {
    "example_key": "example_value"
  },
  "merchant_order_data": {
    "url": "https://example.com/orders/12345"
  },
  "statement_descriptor_suffix": "12345"
}'
1c4e:T17be,
const payload = {
  "amount": 1000,
  "currency": "EUR",
  "settlement_currency": "GBP",
  "capture_mode": "manual",
  "cancel_authorised_after": "P3D",
  "metadata": {
    "example_key": "example_value"
  },
  "merchant_order_data": {
    "url": "https://example.com/orders/12345"
  },
  "statement_descriptor_suffix": "12345"
};
fetch("https://merchant.revolut.com/api/orders/__RP_TOK_0__", {
  method: "PATCH",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "__RP_TOK_1__",
    "Revolut-Api-Version": "__RP_TOK_2__"
  },
  body: JSON.stringify(payload)
})
  .then(response => response.json())
  .then(data => console.log(data));
1c4f:T1ac2,
package main

import (
  "fmt"
  "net/http"
  "bytes"
  "encoding/json"
)

func main() {
  url := "https://merchant.revolut.com/api/orders/__RP_TOK_0__"
  jsonData := []byte(`
{
  "amount": 1000,
  "currency": "EUR",
  "settlement_currency": "GBP",
  "capture_mode": "manual",
  "cancel_authorised_after": "P3D",
  "metadata": {
    "example_key": "example_value"
  },
  "merchant_order_data": {
    "url": "https://example.com/orders/12345"
  },
  "statement_descriptor_suffix": "12345"
}
  `)
  req, _ := http.NewRequest("PATCH", url, bytes.NewBuffer(jsonData))
  req.Header.Add("Content-Type", "application/json")
  req.Header.Add("Authorization", "__RP_TOK_1__")
  req.Header.Add("Revolut-Api-Version", "__RP_TOK_2__")

  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  fmt.Println(res)
}
1c50:T14f2,
import requests

url = "https://merchant.revolut.com/api/orders/__RP_TOK_0__"
headers = {
  "Content-Type": "application/json",
  "Authorization": "__RP_TOK_1__",
  "Revolut-Api-Version": "__RP_TOK_2__"
}
payload = {
  "amount": 1000,
  "currency": "EUR",
  "settlement_currency": "GBP",
  "capture_mode": "manual",
  "cancel_authorised_after": "P3D",
  "metadata": {
    "example_key": "example_value"
  },
  "merchant_order_data": {
    "url": "https://example.com/orders/12345"
  },
  "statement_descriptor_suffix": "12345"
}

response = requests.patch(url, headers=headers, json=payload)
print(response.json())
1c51:T44e,import java.net.http.HttpClient; import java.net.http.HttpRequest; import java.net.http.HttpResponse; import java.net.URI; public class Main { public static void main(String[] args) { HttpClient client = HttpClient.newHttpClient(); String body = """ { "amount": 1000, "currency": "EUR", "settlement_currency": "GBP", "capture_mode": "manual", "cancel_authorised_after": "P3D", "metadata": { "example_key": "example_value" }, "merchant_order_data": { "url": "https://example.com/orders/12345" }, "statement_descriptor_suffix": "12345" } """; HttpRequest request = HttpRequest.newBuilder() .uri(URI.create("https://merchant.revolut.com/api/orders/__RP_TOK_0__")) .header("Content-Type", "application/json") .header("Authorization", "__RP_TOK_1__") .header("Revolut-Api-Version", "__RP_TOK_2__") .PATCH(HttpRequest.BodyPublishers.ofString(body)) .build(); client.sendAsync(request, HttpResponse.BodyHandlers.ofString()) .thenApply(HttpResponse::body) .thenAccept(System.out::println) .join(); } }1c52:T2026,
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;

public class Main {
  public static void main(String[] args) {
    HttpClient client = HttpClient.newHttpClient();
    String body = """
{
  "amount": 1000,
  "currency": "EUR",
  "settlement_currency": "GBP",
  "capture_mode": "manual",
  "cancel_authorised_after": "P3D",
  "metadata": {
    "example_key": "example_value"
  },
  "merchant_order_data": {
    "url": "https://example.com/orders/12345"
  },
  "statement_descriptor_suffix": "12345"
}
    """;

    HttpRequest request = HttpRequest.newBuilder()
      .uri(URI.create("https://merchant.revolut.com/api/orders/__RP_TOK_0__"))
      .header("Content-Type", "application/json")
      .header("Authorization", "__RP_TOK_1__")
      .header("Revolut-Api-Version", "__RP_TOK_2__")
      .PATCH(HttpRequest.BodyPublishers.ofString(body))
      .build();

    client.sendAsync(request, HttpResponse.BodyHandlers.ofString())
      .thenApply(HttpResponse::body)
      .thenAccept(System.out::println)
      .join();
  }
}
1c53:T2ce4,
using System.Net.Http;
using System.Net.Http.Headers;

var client = new HttpClient();
var request = new HttpRequestMessage
{
  Method = HttpMethod.Patch,
  RequestUri = new Uri("https://merchant.revolut.com/api/orders/__RP_TOK_0__"),
  Headers =
  {
    { "Authorization", "__RP_TOK_1__" },
    { "Revolut-Api-Version", "__RP_TOK_2__" },
  },
  Content = new StringContent(@"{
  ""amount"": 1000,
  ""currency"": ""EUR"",
  ""settlement_currency"": ""GBP"",
  ""capture_mode"": ""manual"",
  ""cancel_authorised_after"": ""P3D"",
  ""metadata"": {
    ""example_key"": ""example_value""
  },
  ""merchant_order_data"": {
    ""url"": ""https://example.com/orders/12345""
  },
  ""statement_descriptor_suffix"": ""12345""
}")
  {
    Headers =
    {
      ContentType = new MediaTypeHeaderValue("application/json")
    }
  }
};

using (var response = await client.SendAsync(request))
{
  response.EnsureSuccessStatusCode();
  var body = await response.Content.ReadAsStringAsync();
  Console.WriteLine(body);
}
1c54:Tae5,
curl -X PATCH "https://sandbox-merchant.revolut.com/api/orders/__RP_TOK_0__" \
  -H "Content-Type: application/json" \
  -H "Authorization: __RP_TOK_1__" \
  -H "Revolut-Api-Version: __RP_TOK_2__" \
  -d '{
  "amount": 1000,
  "currency": "EUR",
  "settlement_currency": "GBP",
  "capture_mode": "manual",
  "cancel_authorised_after": "P3D",
  "metadata": {
    "example_key": "example_value"
  },
  "merchant_order_data": {
    "url": "https://example.com/orders/12345"
  },
  "statement_descriptor_suffix": "12345"
}'
1c55:T17c6,
const payload = {
  "amount": 1000,
  "currency": "EUR",
  "settlement_currency": "GBP",
  "capture_mode": "manual",
  "cancel_authorised_after": "P3D",
  "metadata": {
    "example_key": "example_value"
  },
  "merchant_order_data": {
    "url": "https://example.com/orders/12345"
  },
  "statement_descriptor_suffix": "12345"
};
fetch("https://sandbox-merchant.revolut.com/api/orders/__RP_TOK_0__", {
  method: "PATCH",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "__RP_TOK_1__",
    "Revolut-Api-Version": "__RP_TOK_2__"
  },
  body: JSON.stringify(payload)
})
  .then(response => response.json())
  .then(data => console.log(data));
1c56:T1aca,
package main

import (
  "fmt"
  "net/http"
  "bytes"
  "encoding/json"
)

func main() {
  url := "https://sandbox-merchant.revolut.com/api/orders/__RP_TOK_0__"
  jsonData := []byte(`
{
  "amount": 1000,
  "currency": "EUR",
  "settlement_currency": "GBP",
  "capture_mode": "manual",
  "cancel_authorised_after": "P3D",
  "metadata": {
    "example_key": "example_value"
  },
  "merchant_order_data": {
    "url": "https://example.com/orders/12345"
  },
  "statement_descriptor_suffix": "12345"
}
  `)
  req, _ := http.NewRequest("PATCH", url, bytes.NewBuffer(jsonData))
  req.Header.Add("Content-Type", "application/json")
  req.Header.Add("Authorization", "__RP_TOK_1__")
  req.Header.Add("Revolut-Api-Version", "__RP_TOK_2__")

  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  fmt.Println(res)
}
1c57:T14fa,
import requests

url = "https://sandbox-merchant.revolut.com/api/orders/__RP_TOK_0__"
headers = {
  "Content-Type": "application/json",
  "Authorization": "__RP_TOK_1__",
  "Revolut-Api-Version": "__RP_TOK_2__"
}
payload = {
  "amount": 1000,
  "currency": "EUR",
  "settlement_currency": "GBP",
  "capture_mode": "manual",
  "cancel_authorised_after": "P3D",
  "metadata": {
    "example_key": "example_value"
  },
  "merchant_order_data": {
    "url": "https://example.com/orders/12345"
  },
  "statement_descriptor_suffix": "12345"
}

response = requests.patch(url, headers=headers, json=payload)
print(response.json())
1c58:T456,import java.net.http.HttpClient; import java.net.http.HttpRequest; import java.net.http.HttpResponse; import java.net.URI; public class Main { public static void main(String[] args) { HttpClient client = HttpClient.newHttpClient(); String body = """ { "amount": 1000, "currency": "EUR", "settlement_currency": "GBP", "capture_mode": "manual", "cancel_authorised_after": "P3D", "metadata": { "example_key": "example_value" }, "merchant_order_data": { "url": "https://example.com/orders/12345" }, "statement_descriptor_suffix": "12345" } """; HttpRequest request = HttpRequest.newBuilder() .uri(URI.create("https://sandbox-merchant.revolut.com/api/orders/__RP_TOK_0__")) .header("Content-Type", "application/json") .header("Authorization", "__RP_TOK_1__") .header("Revolut-Api-Version", "__RP_TOK_2__") .PATCH(HttpRequest.BodyPublishers.ofString(body)) .build(); client.sendAsync(request, HttpResponse.BodyHandlers.ofString()) .thenApply(HttpResponse::body) .thenAccept(System.out::println) .join(); } }1c59:T202e,
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;

public class Main {
  public static void main(String[] args) {
    HttpClient client = HttpClient.newHttpClient();
    String body = """
{
  "amount": 1000,
  "currency": "EUR",
  "settlement_currency": "GBP",
  "capture_mode": "manual",
  "cancel_authorised_after": "P3D",
  "metadata": {
    "example_key": "example_value"
  },
  "merchant_order_data": {
    "url": "https://example.com/orders/12345"
  },
  "statement_descriptor_suffix": "12345"
}
    """;

    HttpRequest request = HttpRequest.newBuilder()
      .uri(URI.create("https://sandbox-merchant.revolut.com/api/orders/__RP_TOK_0__"))
      .header("Content-Type", "application/json")
      .header("Authorization", "__RP_TOK_1__")
      .header("Revolut-Api-Version", "__RP_TOK_2__")
      .PATCH(HttpRequest.BodyPublishers.ofString(body))
      .build();

    client.sendAsync(request, HttpResponse.BodyHandlers.ofString())
      .thenApply(HttpResponse::body)
      .thenAccept(System.out::println)
      .join();
  }
}
1c5a:T2cec,
using System.Net.Http;
using System.Net.Http.Headers;

var client = new HttpClient();
var request = new HttpRequestMessage
{
  Method = HttpMethod.Patch,
  RequestUri = new Uri("https://sandbox-merchant.revolut.com/api/orders/__RP_TOK_0__"),
  Headers =
  {
    { "Authorization", "__RP_TOK_1__" },
    { "Revolut-Api-Version", "__RP_TOK_2__" },
  },
  Content = new StringContent(@"{
  ""amount"": 1000,
  ""currency"": ""EUR"",
  ""settlement_currency"": ""GBP"",
  ""capture_mode"": ""manual"",
  ""cancel_authorised_after"": ""P3D"",
  ""metadata"": {
    ""example_key"": ""example_value""
  },
  ""merchant_order_data"": {
    ""url"": ""https://example.com/orders/12345""
  },
  ""statement_descriptor_suffix"": ""12345""
}")
  {
    Headers =
    {
      ContentType = new MediaTypeHeaderValue("application/json")
    }
  }
};

using (var response = await client.SendAsync(request))
{
  response.EnsureSuccessStatusCode();
  var body = await response.Content.ReadAsStringAsync();
  Console.WriteLine(body);
}
1c46:["$","div",null,{"className":"ezz1n30","children":[["$","div",null,{"data-header":"$undefined","className":"ezz1n31","children":["$L1c48",["$","$L85",null,{"parameters":[{"name":"Authorization","in":"header","schema":{"type":"string","format":"Bearer ","examples":"$62:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:0:schema:examples"},"required":true,"description":"This parameter accepts the [Merchant API Secret key](https://business.revolut.com/settings/apis?tab=merchant-api) to authorise requests coming from the merchant's backend. \n\nIt ensures that ensures that each request is authenticated and authorised by verifying the secret key. The secret key should be included in all request headers as a `Bearer` token.\n\n:::info\nFor more information, see: [Authentication](https://developer.revolut.com/docs/api/merchant#authentication)\n:::","descriptionNode":"$L1c49"},{"name":"Revolut-Api-Version","in":"header","schema":{"type":"string","format":"date","enum":"$36:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:1:schema:enum","examples":"$36:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:1:schema:examples"},"required":true,"description":"The version of the Merchant API, specified in `YYYY-MM-DD` format.\n\nIf not specified, you will receive an error.\n\n\n:::info\nFor more information about API versioning, see: [API versions](https://developer.revolut.com/docs/guides/merchant/reference/versioning/api-versions).\n:::","x-config-always-visible-in-example":true,"example":"2025-10-16","descriptionNode":"$L1c4a"},{"name":"order_id","in":"path","schema":{"type":"string","format":"uuid","description":"A UUID string, typically used to identify resources.","descriptionNode":"$L1c4b"},"required":true,"description":"The ID of the `Order` object.","descriptionNode":"$L1c4c"}],"requestBody":"$1b:props:children:0:props:children:props:requestBody","heading":"Request","requestBodySchemaTitle":"Request body","headingAs":"h3"}],["$","$L89",null,{"responses":"$1b:props:children:0:props:children:props:responses","headingAs":"h3"}]]}],["$","div",null,{"className":"ezz1n32","children":[[["$","$L8a",null,{"itemsByServer":{"https://merchant.revolut.com":[{"id":"curl","label":"cURL","templateCode":"curl -X PATCH \"https://merchant.revolut.com/api/orders/__RP_TOK_0__\" \\\n -H \"Content-Type: application/json\" \\\n -H \"Authorization: __RP_TOK_1__\" \\\n -H \"Revolut-Api-Version: __RP_TOK_2__\" \\\n -d '{\n \"amount\": 1000,\n \"currency\": \"EUR\",\n \"settlement_currency\": \"GBP\",\n \"capture_mode\": \"manual\",\n \"cancel_authorised_after\": \"P3D\",\n \"metadata\": {\n \"example_key\": \"example_value\"\n },\n \"merchant_order_data\": {\n \"url\": \"https://example.com/orders/12345\"\n },\n \"statement_descriptor_suffix\": \"12345\"\n}'","templateHtml":"$1c4d","tokens":[{"marker":"__RP_TOK_0__","paramName":"order_id","paramIn":"path","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["shell-double-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:order_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"javascript","label":"JavaScript","templateCode":"const payload = {\n \"amount\": 1000,\n \"currency\": \"EUR\",\n \"settlement_currency\": \"GBP\",\n \"capture_mode\": \"manual\",\n \"cancel_authorised_after\": \"P3D\",\n \"metadata\": {\n \"example_key\": \"example_value\"\n },\n \"merchant_order_data\": {\n \"url\": \"https://example.com/orders/12345\"\n },\n \"statement_descriptor_suffix\": \"12345\"\n};\nfetch(\"https://merchant.revolut.com/api/orders/__RP_TOK_0__\", {\n method: \"PATCH\",\n headers: {\n \"Content-Type\": \"application/json\",\n \"Authorization\": \"__RP_TOK_1__\",\n \"Revolut-Api-Version\": \"__RP_TOK_2__\"\n },\n body: JSON.stringify(payload)\n})\n .then(response => response.json())\n .then(data => console.log(data));","templateHtml":"$1c4e","tokens":[{"marker":"__RP_TOK_0__","paramName":"order_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:order_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"go","label":"Go","templateCode":"package main\n\nimport (\n \"fmt\"\n \"net/http\"\n \"bytes\"\n \"encoding/json\"\n)\n\nfunc main() {\n url := \"https://merchant.revolut.com/api/orders/__RP_TOK_0__\"\n jsonData := []byte(`\n{\n \"amount\": 1000,\n \"currency\": \"EUR\",\n \"settlement_currency\": \"GBP\",\n \"capture_mode\": \"manual\",\n \"cancel_authorised_after\": \"P3D\",\n \"metadata\": {\n \"example_key\": \"example_value\"\n },\n \"merchant_order_data\": {\n \"url\": \"https://example.com/orders/12345\"\n },\n \"statement_descriptor_suffix\": \"12345\"\n}\n `)\n req, _ := http.NewRequest(\"PATCH\", url, bytes.NewBuffer(jsonData))\n req.Header.Add(\"Content-Type\", \"application/json\")\n req.Header.Add(\"Authorization\", \"__RP_TOK_1__\")\n req.Header.Add(\"Revolut-Api-Version\", \"__RP_TOK_2__\")\n\n res, _ := http.DefaultClient.Do(req)\n defer res.Body.Close()\n fmt.Println(res)\n}","templateHtml":"$1c4f","tokens":[{"marker":"__RP_TOK_0__","paramName":"order_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:order_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"python","label":"Python","templateCode":"import requests\n\nurl = \"https://merchant.revolut.com/api/orders/__RP_TOK_0__\"\nheaders = {\n \"Content-Type\": \"application/json\",\n \"Authorization\": \"__RP_TOK_1__\",\n \"Revolut-Api-Version\": \"__RP_TOK_2__\"\n}\npayload = {\n \"amount\": 1000,\n \"currency\": \"EUR\",\n \"settlement_currency\": \"GBP\",\n \"capture_mode\": \"manual\",\n \"cancel_authorised_after\": \"P3D\",\n \"metadata\": {\n \"example_key\": \"example_value\"\n },\n \"merchant_order_data\": {\n \"url\": \"https://example.com/orders/12345\"\n },\n \"statement_descriptor_suffix\": \"12345\"\n}\n\nresponse = requests.patch(url, headers=headers, json=payload)\nprint(response.json())","templateHtml":"$1c50","tokens":[{"marker":"__RP_TOK_0__","paramName":"order_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:order_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"java","label":"Java","templateCode":"$1c51","templateHtml":"$1c52","tokens":[{"marker":"__RP_TOK_0__","paramName":"order_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:order_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"csharp","label":"C#","templateCode":"using System.Net.Http;\nusing System.Net.Http.Headers;\n\nvar client = new HttpClient();\nvar request = new HttpRequestMessage\n{\n Method = HttpMethod.Patch,\n RequestUri = new Uri(\"https://merchant.revolut.com/api/orders/__RP_TOK_0__\"),\n Headers =\n {\n { \"Authorization\", \"__RP_TOK_1__\" },\n { \"Revolut-Api-Version\", \"__RP_TOK_2__\" },\n },\n Content = new StringContent(@\"{\n \"\"amount\"\": 1000,\n \"\"currency\"\": \"\"EUR\"\",\n \"\"settlement_currency\"\": \"\"GBP\"\",\n \"\"capture_mode\"\": \"\"manual\"\",\n \"\"cancel_authorised_after\"\": \"\"P3D\"\",\n \"\"metadata\"\": {\n \"\"example_key\"\": \"\"example_value\"\"\n },\n \"\"merchant_order_data\"\": {\n \"\"url\"\": \"\"https://example.com/orders/12345\"\"\n },\n \"\"statement_descriptor_suffix\"\": \"\"12345\"\"\n}\")\n {\n Headers =\n {\n ContentType = new MediaTypeHeaderValue(\"application/json\")\n }\n }\n};\n\nusing (var response = await client.SendAsync(request))\n{\n response.EnsureSuccessStatusCode();\n var body = await response.Content.ReadAsStringAsync();\n Console.WriteLine(body);\n}","templateHtml":"$1c53","tokens":[{"marker":"__RP_TOK_0__","paramName":"order_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:order_id":"123e4567-e89b-12d3-a456-426614174000"}}],"https://sandbox-merchant.revolut.com":[{"id":"curl","label":"cURL","templateCode":"curl -X PATCH \"https://sandbox-merchant.revolut.com/api/orders/__RP_TOK_0__\" \\\n -H \"Content-Type: application/json\" \\\n -H \"Authorization: __RP_TOK_1__\" \\\n -H \"Revolut-Api-Version: __RP_TOK_2__\" \\\n -d '{\n \"amount\": 1000,\n \"currency\": \"EUR\",\n \"settlement_currency\": \"GBP\",\n \"capture_mode\": \"manual\",\n \"cancel_authorised_after\": \"P3D\",\n \"metadata\": {\n \"example_key\": \"example_value\"\n },\n \"merchant_order_data\": {\n \"url\": \"https://example.com/orders/12345\"\n },\n \"statement_descriptor_suffix\": \"12345\"\n}'","templateHtml":"$1c54","tokens":[{"marker":"__RP_TOK_0__","paramName":"order_id","paramIn":"path","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["shell-double-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:order_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"javascript","label":"JavaScript","templateCode":"const payload = {\n \"amount\": 1000,\n \"currency\": \"EUR\",\n \"settlement_currency\": \"GBP\",\n \"capture_mode\": \"manual\",\n \"cancel_authorised_after\": \"P3D\",\n \"metadata\": {\n \"example_key\": \"example_value\"\n },\n \"merchant_order_data\": {\n \"url\": \"https://example.com/orders/12345\"\n },\n \"statement_descriptor_suffix\": \"12345\"\n};\nfetch(\"https://sandbox-merchant.revolut.com/api/orders/__RP_TOK_0__\", {\n method: \"PATCH\",\n headers: {\n \"Content-Type\": \"application/json\",\n \"Authorization\": \"__RP_TOK_1__\",\n \"Revolut-Api-Version\": \"__RP_TOK_2__\"\n },\n body: JSON.stringify(payload)\n})\n .then(response => response.json())\n .then(data => console.log(data));","templateHtml":"$1c55","tokens":[{"marker":"__RP_TOK_0__","paramName":"order_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:order_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"go","label":"Go","templateCode":"package main\n\nimport (\n \"fmt\"\n \"net/http\"\n \"bytes\"\n \"encoding/json\"\n)\n\nfunc main() {\n url := \"https://sandbox-merchant.revolut.com/api/orders/__RP_TOK_0__\"\n jsonData := []byte(`\n{\n \"amount\": 1000,\n \"currency\": \"EUR\",\n \"settlement_currency\": \"GBP\",\n \"capture_mode\": \"manual\",\n \"cancel_authorised_after\": \"P3D\",\n \"metadata\": {\n \"example_key\": \"example_value\"\n },\n \"merchant_order_data\": {\n \"url\": \"https://example.com/orders/12345\"\n },\n \"statement_descriptor_suffix\": \"12345\"\n}\n `)\n req, _ := http.NewRequest(\"PATCH\", url, bytes.NewBuffer(jsonData))\n req.Header.Add(\"Content-Type\", \"application/json\")\n req.Header.Add(\"Authorization\", \"__RP_TOK_1__\")\n req.Header.Add(\"Revolut-Api-Version\", \"__RP_TOK_2__\")\n\n res, _ := http.DefaultClient.Do(req)\n defer res.Body.Close()\n fmt.Println(res)\n}","templateHtml":"$1c56","tokens":[{"marker":"__RP_TOK_0__","paramName":"order_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:order_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"python","label":"Python","templateCode":"import requests\n\nurl = \"https://sandbox-merchant.revolut.com/api/orders/__RP_TOK_0__\"\nheaders = {\n \"Content-Type\": \"application/json\",\n \"Authorization\": \"__RP_TOK_1__\",\n \"Revolut-Api-Version\": \"__RP_TOK_2__\"\n}\npayload = {\n \"amount\": 1000,\n \"currency\": \"EUR\",\n \"settlement_currency\": \"GBP\",\n \"capture_mode\": \"manual\",\n \"cancel_authorised_after\": \"P3D\",\n \"metadata\": {\n \"example_key\": \"example_value\"\n },\n \"merchant_order_data\": {\n \"url\": \"https://example.com/orders/12345\"\n },\n \"statement_descriptor_suffix\": \"12345\"\n}\n\nresponse = requests.patch(url, headers=headers, json=payload)\nprint(response.json())","templateHtml":"$1c57","tokens":[{"marker":"__RP_TOK_0__","paramName":"order_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:order_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"java","label":"Java","templateCode":"$1c58","templateHtml":"$1c59","tokens":[{"marker":"__RP_TOK_0__","paramName":"order_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:order_id":"123e4567-e89b-12d3-a456-426614174000"}},{"id":"csharp","label":"C#","templateCode":"using System.Net.Http;\nusing System.Net.Http.Headers;\n\nvar client = new HttpClient();\nvar request = new HttpRequestMessage\n{\n Method = HttpMethod.Patch,\n RequestUri = new Uri(\"https://sandbox-merchant.revolut.com/api/orders/__RP_TOK_0__\"),\n Headers =\n {\n { \"Authorization\", \"__RP_TOK_1__\" },\n { \"Revolut-Api-Version\", \"__RP_TOK_2__\" },\n },\n Content = new StringContent(@\"{\n \"\"amount\"\": 1000,\n \"\"currency\"\": \"\"EUR\"\",\n \"\"settlement_currency\"\": \"\"GBP\"\",\n \"\"capture_mode\"\": \"\"manual\"\",\n \"\"cancel_authorised_after\"\": \"\"P3D\"\",\n \"\"metadata\"\": {\n \"\"example_key\"\": \"\"example_value\"\"\n },\n \"\"merchant_order_data\"\": {\n \"\"url\"\": \"\"https://example.com/orders/12345\"\"\n },\n \"\"statement_descriptor_suffix\"\": \"\"12345\"\"\n}\")\n {\n Headers =\n {\n ContentType = new MediaTypeHeaderValue(\"application/json\")\n }\n }\n};\n\nusing (var response = await client.SendAsync(request))\n{\n response.EnsureSuccessStatusCode();\n var body = await response.Content.ReadAsStringAsync();\n Console.WriteLine(body);\n}","templateHtml":"$1c5a","tokens":[{"marker":"__RP_TOK_0__","paramName":"order_id","paramIn":"path","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_2__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16","path:order_id":"123e4567-e89b-12d3-a456-426614174000"}}]},"method":"patch","servers":"$62:props:children:0:props:children:props:children:1:props:children:1:props:children:0:0:props:servers","path":"/api/orders/{order_id}","parameters":["$1c46:props:children:0:props:children:1:props:parameters:0","$1c46:props:children:0:props:children:1:props:parameters:1","$1c46:props:children:0:props:children:1:props:parameters:2"]}],"$L1c5b"],"$L1c5c","$L1c5d"]}]]}] 1c5b:["$","$L10d",null,{"security":[{"Api-Key":[]}],"authorization":{"Api-Key":{"type":"apiKey","in":"header","name":"Authorization","description":"Each Merchant API request must contain an authorization header in the following format:\n\n```\n'Authorization: Bearer '\n```\n\nTo use this API, you need to generate API keys from your Revolut Business account. The Secret key is used in the authorization header for all server calls, while the Public key is provided with payment methods at checkout.\n\n:::info\nFor detailed instructions on generating your API keys, see: [Generate API keys](https://developer.revolut.com/docs/guides/merchant/get-started#generate-api-keys).\n:::","descriptionNode":"$L1c5e"}}}] 1c5c:["$","$L10f",null,{"exampleBlocks":{"application/json":{"variants":[{"key":"example_update_order","label":"Example order update","rawValue":"$1b:props:children:0:props:children:props:requestBody:content:application/json:examples:example_update_order:value","block":"$L1c5f"}],"syncedPropertyName":"$undefined"}},"title":"Request body samples","headingAs":"h4"}] 1c5d:["$","$L110",null,{"exampleBlocks":{"200":{"application/json":{"variants":[{"key":"example_order_updated","label":"Example order update response","rawValue":"$1b:props:children:0:props:children:props:responses:200:content:application/json:examples:example_order_updated:value","block":"$L1c60"}],"syncedPropertyName":"$undefined"}},"400":{"application/json":{"variants":[{"key":"default","label":"default","rawValue":"$1b:props:children:0:props:children:props:responses:400:content:application/json:examples:default:value","block":"$L1c61"}],"syncedPropertyName":"$undefined"}},"401":{"application/json":{"variants":[{"key":"default","label":"default","rawValue":"$1b:props:children:0:props:children:props:responses:401:content:application/json:examples:default:value","block":"$L1c62"}],"syncedPropertyName":"$undefined"}},"404":{"application/json":{"variants":[{"key":"default","label":"default","rawValue":"$1b:props:children:0:props:children:props:responses:404:content:application/json:examples:default:value","block":"$L1c63"}],"syncedPropertyName":"$undefined"}},"422":{"application/json":{"variants":[{"key":"default","label":"default","rawValue":"$1b:props:children:0:props:children:props:responses:422:content:application/json:examples:default:value","block":"$L1c64"}],"syncedPropertyName":"$undefined"}}},"headingAs":"h4"}] 1c6e:T4c1,Automatic cancellation period for uncaptured orders, specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. After this period, the authorised payment is automatically cancelled and the order is cancelled. Maximum: 7 days = `P7D`. :::note The following limitations apply: - Cannot be a negative value. - Cannot be updated if the new value is less than or equal to the elapsed time since authorisation. **Failing scenario:** - Original value: 7 days - Time since authorisation: 3 days - Update value: 2 days In this scenario, an error is returned. **Successful scenario:** - Original value: 7 days - Time since authorisation: 3 days - Update value: 4 days In this scenario, the parameter can be updated. - Cannot be updated if cancellation is ≤ 30 minutes away. **Failing scenario:** - Original value: 12 hours - Time since authorisation: 11 hours 40 minutes In this scenario, an error is returned. **Successful scenario:** - Original value: 12 hours - Time since authorisation: 11 hours 20 minutes In this scenario, the parameter can be updated. :::1c75:T50a,Object containing information about a customer. If you have it, we strongly advise providing at least either `id`, `phone`, or `email`. Using the [Customers operations](https://developer.revolut.com/docs/api/merchant#tag-customers), you can manage customer instances. The following behaviours apply to different use cases: | Use case | API behavior | | -------- | ------------ | | Existing customer | If `id` was provided, we ignore other customer details and associate the customer with the order.

If either `email`, `phone`, or `full_name` was provided (without an existing customer's `id`), we always create a new customer, irrespective of another, existing customer object having the same details. | | New customer | If either `email`, `phone`, or `full_name` was provided, we create a new customer, irrespective of another customer object having the same details.

If `id` of a non-existent customer was provided, we return a `404` error, irrespective of other details provided. | :::note To avoid unintentional duplication of customer records, search for an existing customer by email or phone using the [List customers](https://developer.revolut.com/docs/api/merchant#retrieve-customer-list) endpoint first, then provide `customer.id` in the order. :::1c9e:T9bc,A unique identifier for a payment method, always 44 characters long. This fingerprint can be used to uniquely identify various payment methods. #### Fingerprint generation | Payment method | Description | | -------- | ----------- | | **All payment methods** | A fingerprint is generated for all payment methods, including cards, Revolut Pay (card, account-to-account payments), Apple Pay, and Google Pay. | | **Cards (Revolut Pay & Card Gateway)** | For cards, the fingerprint is based on the PAN. Cards processed via Revolut Pay and our card gateway will share the same fingerprint. Renewed cards (new expiry/CVV) retain the same fingerprint for efficient blocking. | | **Apple Pay & Google Pay** | Since Apple Pay and Google Pay provide us Device PANs (DPAN), the fingerprint is based on the DPAN provided by Apple/Google, not the connected card's PAN. This means that a new DPAN (and fingerprint) is generated for cards in case they are re-added to the customer's digital wallet, or added to different devices. | #### Detecting duplicate payment methods Fingerprints are a valuable tool for detecting duplicate payment methods by identifying if a payment method has been seen before. This capability, in turn, helps in preventing various types of misuse (e.g., exploitation of free trials, or association with known problematic accounts, which can be a form of fraud). To effectively use fingerprints for this purpose, you will need to create and maintain your own lists (e.g., blocklists of known problematic fingerprints, allowlists for trusted customers, or tracking frequently used fingerprints). The ideal way to utilise fingerprints is by combining them with a manual capture process. While automatic capture with subsequent refunds for problematic payments is possible, manual capture based on fingerprint validation is recommended. During your manual capture workflow, after a payment was authorised: - Check the fingerprint status by comparing it against your maintained lists and internal business rules. - If you decide to proceed with the payment (e.g., the fingerprint is not on a blocklist, or matches a trusted customer's previous payment method): [Capture the order](https://developer.revolut.com/docs/api/merchant#capture-order). - If you decide not to proceed with the payment (e.g., the fingerprint matches a known fraudulent fingerprint, or exhibits suspicious patterns): [Cancel the order](https://developer.revolut.com/docs/api/merchant#cancel-order).1cb0:T9bc,A unique identifier for a payment method, always 44 characters long. This fingerprint can be used to uniquely identify various payment methods. #### Fingerprint generation | Payment method | Description | | -------- | ----------- | | **All payment methods** | A fingerprint is generated for all payment methods, including cards, Revolut Pay (card, account-to-account payments), Apple Pay, and Google Pay. | | **Cards (Revolut Pay & Card Gateway)** | For cards, the fingerprint is based on the PAN. Cards processed via Revolut Pay and our card gateway will share the same fingerprint. Renewed cards (new expiry/CVV) retain the same fingerprint for efficient blocking. | | **Apple Pay & Google Pay** | Since Apple Pay and Google Pay provide us Device PANs (DPAN), the fingerprint is based on the DPAN provided by Apple/Google, not the connected card's PAN. This means that a new DPAN (and fingerprint) is generated for cards in case they are re-added to the customer's digital wallet, or added to different devices. | #### Detecting duplicate payment methods Fingerprints are a valuable tool for detecting duplicate payment methods by identifying if a payment method has been seen before. This capability, in turn, helps in preventing various types of misuse (e.g., exploitation of free trials, or association with known problematic accounts, which can be a form of fraud). To effectively use fingerprints for this purpose, you will need to create and maintain your own lists (e.g., blocklists of known problematic fingerprints, allowlists for trusted customers, or tracking frequently used fingerprints). The ideal way to utilise fingerprints is by combining them with a manual capture process. While automatic capture with subsequent refunds for problematic payments is possible, manual capture based on fingerprint validation is recommended. During your manual capture workflow, after a payment was authorised: - Check the fingerprint status by comparing it against your maintained lists and internal business rules. - If you decide to proceed with the payment (e.g., the fingerprint is not on a blocklist, or matches a trusted customer's previous payment method): [Capture the order](https://developer.revolut.com/docs/api/merchant#capture-order). - If you decide not to proceed with the payment (e.g., the fingerprint matches a known fraudulent fingerprint, or exhibits suspicious patterns): [Cancel the order](https://developer.revolut.com/docs/api/merchant#cancel-order).1cc2:T9bc,A unique identifier for a payment method, always 44 characters long. This fingerprint can be used to uniquely identify various payment methods. #### Fingerprint generation | Payment method | Description | | -------- | ----------- | | **All payment methods** | A fingerprint is generated for all payment methods, including cards, Revolut Pay (card, account-to-account payments), Apple Pay, and Google Pay. | | **Cards (Revolut Pay & Card Gateway)** | For cards, the fingerprint is based on the PAN. Cards processed via Revolut Pay and our card gateway will share the same fingerprint. Renewed cards (new expiry/CVV) retain the same fingerprint for efficient blocking. | | **Apple Pay & Google Pay** | Since Apple Pay and Google Pay provide us Device PANs (DPAN), the fingerprint is based on the DPAN provided by Apple/Google, not the connected card's PAN. This means that a new DPAN (and fingerprint) is generated for cards in case they are re-added to the customer's digital wallet, or added to different devices. | #### Detecting duplicate payment methods Fingerprints are a valuable tool for detecting duplicate payment methods by identifying if a payment method has been seen before. This capability, in turn, helps in preventing various types of misuse (e.g., exploitation of free trials, or association with known problematic accounts, which can be a form of fraud). To effectively use fingerprints for this purpose, you will need to create and maintain your own lists (e.g., blocklists of known problematic fingerprints, allowlists for trusted customers, or tracking frequently used fingerprints). The ideal way to utilise fingerprints is by combining them with a manual capture process. While automatic capture with subsequent refunds for problematic payments is possible, manual capture based on fingerprint validation is recommended. During your manual capture workflow, after a payment was authorised: - Check the fingerprint status by comparing it against your maintained lists and internal business rules. - If you decide to proceed with the payment (e.g., the fingerprint is not on a blocklist, or matches a trusted customer's previous payment method): [Capture the order](https://developer.revolut.com/docs/api/merchant#capture-order). - If you decide not to proceed with the payment (e.g., the fingerprint matches a known fraudulent fingerprint, or exhibits suspicious patterns): [Cancel the order](https://developer.revolut.com/docs/api/merchant#cancel-order).1cd4:T9bc,A unique identifier for a payment method, always 44 characters long. This fingerprint can be used to uniquely identify various payment methods. #### Fingerprint generation | Payment method | Description | | -------- | ----------- | | **All payment methods** | A fingerprint is generated for all payment methods, including cards, Revolut Pay (card, account-to-account payments), Apple Pay, and Google Pay. | | **Cards (Revolut Pay & Card Gateway)** | For cards, the fingerprint is based on the PAN. Cards processed via Revolut Pay and our card gateway will share the same fingerprint. Renewed cards (new expiry/CVV) retain the same fingerprint for efficient blocking. | | **Apple Pay & Google Pay** | Since Apple Pay and Google Pay provide us Device PANs (DPAN), the fingerprint is based on the DPAN provided by Apple/Google, not the connected card's PAN. This means that a new DPAN (and fingerprint) is generated for cards in case they are re-added to the customer's digital wallet, or added to different devices. | #### Detecting duplicate payment methods Fingerprints are a valuable tool for detecting duplicate payment methods by identifying if a payment method has been seen before. This capability, in turn, helps in preventing various types of misuse (e.g., exploitation of free trials, or association with known problematic accounts, which can be a form of fraud). To effectively use fingerprints for this purpose, you will need to create and maintain your own lists (e.g., blocklists of known problematic fingerprints, allowlists for trusted customers, or tracking frequently used fingerprints). The ideal way to utilise fingerprints is by combining them with a manual capture process. While automatic capture with subsequent refunds for problematic payments is possible, manual capture based on fingerprint validation is recommended. During your manual capture workflow, after a payment was authorised: - Check the fingerprint status by comparing it against your maintained lists and internal business rules. - If you decide to proceed with the payment (e.g., the fingerprint is not on a blocklist, or matches a trusted customer's previous payment method): [Capture the order](https://developer.revolut.com/docs/api/merchant#capture-order). - If you decide not to proceed with the payment (e.g., the fingerprint matches a known fraudulent fingerprint, or exhibits suspicious patterns): [Cancel the order](https://developer.revolut.com/docs/api/merchant#cancel-order).1cda:T9bc,A unique identifier for a payment method, always 44 characters long. This fingerprint can be used to uniquely identify various payment methods. #### Fingerprint generation | Payment method | Description | | -------- | ----------- | | **All payment methods** | A fingerprint is generated for all payment methods, including cards, Revolut Pay (card, account-to-account payments), Apple Pay, and Google Pay. | | **Cards (Revolut Pay & Card Gateway)** | For cards, the fingerprint is based on the PAN. Cards processed via Revolut Pay and our card gateway will share the same fingerprint. Renewed cards (new expiry/CVV) retain the same fingerprint for efficient blocking. | | **Apple Pay & Google Pay** | Since Apple Pay and Google Pay provide us Device PANs (DPAN), the fingerprint is based on the DPAN provided by Apple/Google, not the connected card's PAN. This means that a new DPAN (and fingerprint) is generated for cards in case they are re-added to the customer's digital wallet, or added to different devices. | #### Detecting duplicate payment methods Fingerprints are a valuable tool for detecting duplicate payment methods by identifying if a payment method has been seen before. This capability, in turn, helps in preventing various types of misuse (e.g., exploitation of free trials, or association with known problematic accounts, which can be a form of fraud). To effectively use fingerprints for this purpose, you will need to create and maintain your own lists (e.g., blocklists of known problematic fingerprints, allowlists for trusted customers, or tracking frequently used fingerprints). The ideal way to utilise fingerprints is by combining them with a manual capture process. While automatic capture with subsequent refunds for problematic payments is possible, manual capture based on fingerprint validation is recommended. During your manual capture workflow, after a payment was authorised: - Check the fingerprint status by comparing it against your maintained lists and internal business rules. - If you decide to proceed with the payment (e.g., the fingerprint is not on a blocklist, or matches a trusted customer's previous payment method): [Capture the order](https://developer.revolut.com/docs/api/merchant#capture-order). - If you decide not to proceed with the payment (e.g., the fingerprint matches a known fraudulent fingerprint, or exhibits suspicious patterns): [Cancel the order](https://developer.revolut.com/docs/api/merchant#cancel-order).1d1b:T5ef,Object containing additional information about an airline booking associated with the order. Use this object to provide required data to enable **Revolut Flight Alerts**. This feature allows users to receive real-time flight updates such as check-in reminders, boarding alerts, and notifications for cancellations or delays in the Revolut app. To enable **Revolut Flight Alerts** functionalities in the Revolut app, the following fields are **required** on order creation or update, before capturing the order: ``` tickets_purchase, journey_legs, booking_url ``` :::note These are the specific data field requirements for merchants who must provide airline data. Note that these requirements can be extended on a case by case basis as decided by Revolut. | Required for airline/charter merchants | Required for OTA merchants | | -------------------------------------- | -------------------------- | |
  • `booking_id`
  • `fulfillment_date`
  • `passengers[].first_name`
  • `passengers[].last_name`
  • `journey_legs[].pnr`
  • `journey_legs[].sequence`
  • `journey_legs[].flight_number`
  • `journey_legs[].travel_date`
  • `journey_legs[].airline_code`
  • `journey_legs[].departure_airport_code`
  • `journey_legs[].arrival_airport_code`
|
  • `booking_id`
  • `fulfillment_date`
  • `passengers[].first_name`
  • `passengers[].last_name`
  • `journey_legs[].pnr`
  • `journey_legs[].arrival_airport_code`
| :::1da6:T480,You can set a dynamic statement descriptor for your orders by providing a custom suffix. A statement descriptor is the text shown on cardholders' bank or card statements, helping them recognise a transaction or merchant. This field can be used to send extra information with the statement descriptor for card transactions. The complete descriptor is built using the following format: `{base}*{suffix}`, where: - **`{base}`** is the existing descriptor configured in the Revolut Business dashboard (**Settings > Business account > Merchant profile > Statement descriptor**). - **`{suffix}`** is defined by the `statement_descriptor_suffix` field. :::note - If the combined descriptor's length (base + suffix) exceeds the character limits of card scheme providers, the final value will be truncated. For example if the limit is 22 characters, the base descriptor is `"base"` and the suffix is `"testdescriptorsuffix"`, the final descriptor becomes `"base*testdescriptorsuf"`. - The final statement descriptor shown on a cardholder's statement may vary by issuing bank, as some banks apply their own custom formatting or truncation rules. :::1dc0:T50a,Object containing information about a customer. If you have it, we strongly advise providing at least either `id`, `phone`, or `email`. Using the [Customers operations](https://developer.revolut.com/docs/api/merchant#tag-customers), you can manage customer instances. The following behaviours apply to different use cases: | Use case | API behavior | | -------- | ------------ | | Existing customer | If `id` was provided, we ignore other customer details and associate the customer with the order.

If either `email`, `phone`, or `full_name` was provided (without an existing customer's `id`), we always create a new customer, irrespective of another, existing customer object having the same details. | | New customer | If either `email`, `phone`, or `full_name` was provided, we create a new customer, irrespective of another customer object having the same details.

If `id` of a non-existent customer was provided, we return a `404` error, irrespective of other details provided. | :::note To avoid unintentional duplication of customer records, search for an existing customer by email or phone using the [List customers](https://developer.revolut.com/docs/api/merchant#retrieve-customer-list) endpoint first, then provide `customer.id` in the order. :::1df1:T4c1,Automatic cancellation period for uncaptured orders, specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. After this period, the authorised payment is automatically cancelled and the order is cancelled. Maximum: 7 days = `P7D`. :::note The following limitations apply: - Cannot be a negative value. - Cannot be updated if the new value is less than or equal to the elapsed time since authorisation. **Failing scenario:** - Original value: 7 days - Time since authorisation: 3 days - Update value: 2 days In this scenario, an error is returned. **Successful scenario:** - Original value: 7 days - Time since authorisation: 3 days - Update value: 4 days In this scenario, the parameter can be updated. - Cannot be updated if cancellation is ≤ 30 minutes away. **Failing scenario:** - Original value: 12 hours - Time since authorisation: 11 hours 40 minutes In this scenario, an error is returned. **Successful scenario:** - Original value: 12 hours - Time since authorisation: 11 hours 20 minutes In this scenario, the parameter can be updated. :::1df7:T5ef,Object containing additional information about an airline booking associated with the order. Use this object to provide required data to enable **Revolut Flight Alerts**. This feature allows users to receive real-time flight updates such as check-in reminders, boarding alerts, and notifications for cancellations or delays in the Revolut app. To enable **Revolut Flight Alerts** functionalities in the Revolut app, the following fields are **required** on order creation or update, before capturing the order: ``` tickets_purchase, journey_legs, booking_url ``` :::note These are the specific data field requirements for merchants who must provide airline data. Note that these requirements can be extended on a case by case basis as decided by Revolut. | Required for airline/charter merchants | Required for OTA merchants | | -------------------------------------- | -------------------------- | |
  • `booking_id`
  • `fulfillment_date`
  • `passengers[].first_name`
  • `passengers[].last_name`
  • `journey_legs[].pnr`
  • `journey_legs[].sequence`
  • `journey_legs[].flight_number`
  • `journey_legs[].travel_date`
  • `journey_legs[].airline_code`
  • `journey_legs[].departure_airport_code`
  • `journey_legs[].arrival_airport_code`
|
  • `booking_id`
  • `fulfillment_date`
  • `passengers[].first_name`
  • `passengers[].last_name`
  • `journey_legs[].pnr`
  • `journey_legs[].arrival_airport_code`
| :::1e73:T480,You can set a dynamic statement descriptor for your orders by providing a custom suffix. A statement descriptor is the text shown on cardholders' bank or card statements, helping them recognise a transaction or merchant. This field can be used to send extra information with the statement descriptor for card transactions. The complete descriptor is built using the following format: `{base}*{suffix}`, where: - **`{base}`** is the existing descriptor configured in the Revolut Business dashboard (**Settings > Business account > Merchant profile > Statement descriptor**). - **`{suffix}`** is defined by the `statement_descriptor_suffix` field. :::note - If the combined descriptor's length (base + suffix) exceeds the character limits of card scheme providers, the final value will be truncated. For example if the limit is 22 characters, the base descriptor is `"base"` and the suffix is `"testdescriptorsuffix"`, the final descriptor becomes `"base*testdescriptorsuf"`. - The final statement descriptor shown on a cardholder's statement may vary by issuing bank, as some banks apply their own custom formatting or truncation rules. :::18:["$","$7a","create-order",{"children":[["$","section",null,{"className":"y9a0do0","data-variant":"endpoint","children":["$","$L7b",null,{"responses":{"201":{"description":"Order created","content":{"application/json":{"schema":{"title":"Order v5","type":"object","description":"To process the order from a credit or debit card, you create an `Order` object. You can then retrieve, capture, cancel, refund, or pay an order using its unique `id`. Alternatively, you can use its unique `token` to process a card payment with the Revolut Checkout Widget.","properties":{"id":{"type":"string","format":"uuid","description":"Permanent order ID used to retrieve, capture, cancel, or refund an order after authorization.","descriptionNode":"$L1c65"},"token":{"type":"string","description":"Temporary ID for the order, which expires when the payment is authorised.\n\nThe order `token` is used for [token-based initialisation](https://developer.revolut.com/docs/sdks/merchant-web-sdk/initialisation/token-based), and is returned by the `createOrder` callback in the following payment methods:\n\n- [Embedded Checkout](https://developer.revolut.com/docs/sdks/merchant-web-sdk/payment-methods/embedded-checkout#embedded-checkout-options-interface)\n- [Revolut Pay](https://developer.revolut.com/docs/sdks/merchant-web-sdk/payment-methods/revolut-pay#widget-payments-revolut-pay-options)\n- [Apple Pay and Google Pay](https://developer.revolut.com/docs/sdks/merchant-web-sdk/payment-methods/apple-pay-google-pay#payment-request-options-interface)\n- [Pay by Bank](https://developer.revolut.com/docs/sdks/merchant-web-sdk/payment-methods/pay-by-bank#pay-by-bank-options-interface)","descriptionNode":"$L1c66"},"type":{"type":"string","description":"The type of the order.","enum":"$19:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:orders:items:properties:type:enum","descriptionNode":"$L1c67"},"state":{"type":"string","description":"The state of the order in its lifecycle.\n\n| State | Description |\n|-------|-------------|\n| `pending` | Order created, awaiting payment |\n| `processing` | Payment is being processed |\n| `authorised` | Payment authorised but not yet captured (for manual capture) |\n| `completed` | Payment successfully captured and settled |\n| `cancelled` | Order was cancelled |\n| `failed` | Payment failed |\n\n:::info\nFor more information, see: [Order and payment lifecycle](https://developer.revolut.com/docs/guides/merchant/reference/order-lifecycle)\n:::","enum":"$19:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:orders:items:properties:state:enum","examples":"$19:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:orders:items:properties:state:examples","descriptionNode":"$L1c68"},"created_at":{"type":"string","description":"The date and time the order was created.","format":"date-time","descriptionNode":"$L1c69"},"updated_at":{"type":"string","description":"The date and time the order was last updated.","format":"date-time","descriptionNode":"$L1c6a"},"description":{"type":"string","description":"The description of the order.","descriptionNode":"$L1c6b"},"capture_mode":{"type":"string","description":"The capture mode of the order. `automatic` is used by default.\n\n| Parameter value | Description |\n| --------------- | ----------- |\n| `automatic` | The order is captured automatically after payment authorisation. |\n| `manual` | The order is not captured automatically. You must manually capture the order later. |\n\n:::info\nFor more information, see [Capture an order](https://developer.revolut.com/docs/api/merchant#capture-order).\n:::","default":"automatic","enum":"$19:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:orders:items:properties:capture_mode:enum","descriptionNode":"$L1c6c"},"authorisation_type":{"type":"string","description":"The type of authorisation for the order. Used with manual capture mode. If omitted, `final` is used by default.\n\n### Pre-authorisation\n\nPre-authorisation allows you to reserve funds on a customer's card without immediately capturing them. This is useful for scenarios like:\n\n- Hotel bookings where the final amount may vary\n- Car rentals where additional charges may apply\n- Deposits that need to be held temporarily\n\n| Parameter value | Description |\n| --------------- | ----------- |\n| `final` | Standard authorisation for immediate or near-immediate capture. |\n| `pre_authorisation` | Reserve funds for later capture, used with manual capture mode. |\n\n:::note\nPre-authorisation must be used with `capture_mode: manual`. For more information, see [Capture an order](https://developer.revolut.com/docs/api/merchant#capture-order).\n:::","default":"final","enum":"$19:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:orders:items:properties:authorisation_type:enum","descriptionNode":"$L1c6d"},"cancel_authorised_after":{"type":"string","format":"duration","description":"$1c6e","descriptionNode":"$L1c6f"},"amount":{"type":"integer","description":"The order total expressed in minor currency units, according to the [ISO 4217 standard](https://en.wikipedia.org/wiki/ISO_4217). For example, `7034` in `EUR` corresponds to €70.34.\n\n:::info\n- Conversion between major and minor units varies by currency. For instance, `100` minor units equal £1.00 in `GBP`, whereas in `ISK` they represent 100 units. For more details, see the [ISO 4217 standard](https://en.wikipedia.org/wiki/ISO_4217).\n- If `line_items` are provided, the order `amount` must equal the sum of all line items' `total_amount`.\n- For card payments with a non-zero amount, the order `amount` must be at least **$0.005** (or equivalent in different currencies, calculated using Revolut's exchange rate on the payment date). Otherwise, card payments can't be performed.\n:::","descriptionNode":"$L1c70"},"outstanding_amount":{"type":"integer","description":"The amount not yet paid for a given order (in minor currency units). For example, `7034` represents €70.34. \n\nThe value in this field may differ from `amount` if there are partial payments associated with the order.","descriptionNode":"$L1c71"},"refunded_amount":{"type":"integer","description":"The amount that was refunded from the order (in minor currency units). For example, `7034` represents €70.34. \n\nThis applies to orders that have been refunded (i.e., orders of type `payment` that have a related `refund` order).","descriptionNode":"$L1c72"},"currency":{"type":"string","format":"ISO 4217","minLength":3,"maxLength":3,"description":"[ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) currency code in upper case.\n\n:::info\nFor more information about the supported currencies, see: [Help Center](https://help.revolut.com/business/help/merchant-accounts/payments/in-which-currencies-can-i-accept-payments/).\n:::","descriptionNode":"$L1c73"},"settlement_currency":{"type":"string","description":"[ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) currency code in upper case. \n\nIf `settlement_currency` is different from the value of `currency`, the money will be exchanged when the amount is settled to your merchant account. In case of a refund or chargeback, the money will be exchanged to the order's initial `currency`.\n\nIf `settlement_currency` is not specified, this value is taken from `currency`.\n\n:::info\nFor more information about the supported currencies, see: [Help Center](https://help.revolut.com/business/help/merchant-accounts/payments/in-which-currencies-can-i-accept-payments/).\n:::","descriptionNode":"$L1c74"},"customer":{"type":"object","description":"$1c75","properties":{"id":{"type":"string","format":"uuid","description":"Permanent ID of a customer used to retrieve, update, delete a customer. This ID can also be used to link customer to an order.\n\n:::note\nIf you provide the customer's ID during order creation, no other customer data is required, they will be parsed automatically from the referenced customer object.\n:::","descriptionNode":"$L1c76"},"full_name":{"type":"string","description":"The full name of the customer.","descriptionNode":"$L1c77"},"phone":{"type":"string","description":"The phone number of the customer in [E.164 format](https://en.wikipedia.org/wiki/E.164).","descriptionNode":"$L1c78"},"email":{"type":"string","format":"email","description":"The email address of the customer.","descriptionNode":"$L1c79"},"date_of_birth":{"type":"string","format":"date","description":"The birth date of the customer.","descriptionNode":"$L1c7a"}},"descriptionNode":"$L1c7b"},"payments":{"type":"array","description":"The details of all the payments that have been made towards this order (successful or unsuccessful).","items":{"type":"object","description":"Represents a payment for an order.\n\nFor pre-authorised payments, the `authorised_amount` field tracks the currently authorised amount, which may differ from `amount` during incremental authorisation processing.","properties":{"id":{"type":"string","format":"uuid","description":"The ID of the payment.","descriptionNode":"$L1c7c"},"state":{"type":"string","description":"The status of the payment.","enum":"$21:props:children:0:props:children:props:responses:200:content:application/json:schema:items:properties:state:enum","descriptionNode":"$L1c7d"},"decline_reason":{"type":"string","description":"The reason for a `failed` or `declined` payment.\n\nA failed or declined payment can result from multiple reasons. To learn more, check our [failure reasons](https://developer.revolut.com/docs/guides/merchant/reference/error-codes/decline-reasons).","enum":"$21:props:children:0:props:children:props:responses:200:content:application/json:schema:items:properties:decline_reason:enum","descriptionNode":"$L1c7e"},"bank_message":{"type":"string","description":"The reason for a `failed` or `declined` payment, sent by the financial institution processing the payment.","descriptionNode":"$L1c7f"},"created_at":{"type":"string","format":"date-time","description":"The date and time the payment was created.","descriptionNode":"$L1c80"},"updated_at":{"type":"string","format":"date-time","description":"The date and time the payment was last updated.","descriptionNode":"$L1c81"},"token":{"type":"string","format":"uuid","description":"Temporary token of the payment used to fetch the reward offer during checkout and link user registrations to the given offers. \n\nThe token is only valid for a limited time.","descriptionNode":"$L1c82"},"amount":{"type":"integer","format":"int64","minimum":0,"description":"The payment amount in minor units (e.g., cents). The value of this field depends on the payment type and state.\n\n| Payment type | State | Amount value |\n|--------------|-------|--------------|\n| Standard payment | Any | Total payment amount |\n| Pre-authorised payment | `authorisation_started` | New amount being authorised (during increment processing) |\n| Pre-authorised payment | `authorised` | Currently authorised amount (equals `authorised_amount`) |\n\n:::info\nFor pre-authorised payments, see the `authorised_amount` field for tracking the currently authorised amount separately.\n:::","examples":"$21:props:children:0:props:children:props:responses:200:content:application/json:schema:items:properties:amount:examples","descriptionNode":"$L1c83"},"authorised_amount":{"type":"integer","description":"The currently authorised amount for this payment (in minor units).\n\nFor pre-authorised payments with incremental authorization:\n- Initially equals the `amount` field\n- Remains unchanged during increment processing\n- Updates to new amount upon successful increment\n- Remains at original amount if increment is declined\n\nFor standard payments, this field may not be present or will equal the `amount` field.","examples":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:authorised_amount:examples","descriptionNode":"$L1c84"},"currency":{"type":"string","format":"ISO 4217","minLength":3,"maxLength":3,"description":"[ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) currency code in upper case.\n\n:::info\nFor more information about the supported currencies, see: [Help Center](https://help.revolut.com/business/help/merchant-accounts/payments/in-which-currencies-can-i-accept-payments/).\n:::","descriptionNode":"$L1c85"},"settled_amount":{"type":"integer","description":"The amount of the settled payment (minor currency unit). For example, `7034` stands for €70.34.","descriptionNode":"$L1c86"},"settled_currency":{"type":"string","description":"The currency of the settled payment. [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) currency code in upper case.\n\n:::info\nFor more information about the supported currencies, see: [Help Center](https://help.revolut.com/business/help/merchant-accounts/payments/in-which-currencies-can-i-accept-payments/).\n:::","descriptionNode":"$L1c87"},"payment_method":{"type":"object","description":"The details of the payment method used to make the payment.","discriminator":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:discriminator","oneOf":[{"type":"object","description":"Object containing details of a card used via Apple Pay.","properties":{"id":{"type":"string","format":"uuid","description":"ID of the saved payment method.\n\n:::note\nThe `id` parameter is only returned when the payment method is saved.\n:::","descriptionNode":"$L1c88"},"type":{"type":"string","enum":"$21:props:children:0:props:children:props:responses:200:content:application/json:schema:items:properties:payment_method:oneOf:2:properties:type:enum","description":"The type of payment method used to pay for the order.\n\nAvailable values:\n\n| Payment method `type` | Description |\n| --------------------- | ----------- |\n| `apple_pay` | The customer paid the order using Apple Pay. |\n| `card` | The customer paid the order using their credit or debit card. |\n| `google_pay` | The customer paid the order using Google Pay. |\n| `revolut_pay_card` | The customer paid the order via Revolut Pay using their credit or debit card. |\n| `revolut_pay_account` | The customer paid the order via Revolut Pay using their Revolut account. |\n| `sepa_direct_debit` | The customer paid the order using SEPA Direct Debit. |","descriptionNode":"$L1c89"},"card_brand":{"type":"string","description":"The type of the card.","enum":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:0:properties:card_brand:enum","descriptionNode":"$L1c8a"},"funding":{"type":"string","description":"The type of card funding.","enum":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:0:properties:funding:enum","descriptionNode":"$L1c8b"},"card_country_code":{"type":"string","description":"The 2-letter country code of the country where the card was issued.","descriptionNode":"$L1c8c"},"card_bin":{"type":"string","description":"The BIN of the card.","minLength":6,"maxLength":6,"descriptionNode":"$L1c8d"},"card_last_four":{"type":"string","description":"The last four digits of the card number.","minLength":4,"maxLength":4,"descriptionNode":"$L1c8e"},"card_expiry":{"type":"string","format":"MM/YY","description":"The expiry date of the card in the format of MM/YY.","descriptionNode":"$L1c8f"},"cardholder_name":{"type":"string","description":"The name of the cardholder.","descriptionNode":"$L1c90"},"checks":{"type":"object","description":"The details of the check for card payment. Only for orders with successful payments.","properties":{"three_ds":{"type":"object","description":"The details of the 3D Secure check. Only for orders with successful payments.\n\n:::note\nNot returned for Apple Pay and Google Pay payments.\n:::","properties":{"eci":{"type":"string","description":"The Electronic Commerce Indicator (ECI) value corresponds to the authentication result and indicates the level of security used when the payment information was provided.","descriptionNode":"$L1c91"},"state":{"type":"string","description":"The result of 3D Secure check.","enum":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:0:properties:checks:properties:three_ds:properties:state:enum","descriptionNode":"$L1c92"},"version":{"type":"integer","description":"The 3D Secure version.","descriptionNode":"$L1c93"}},"descriptionNode":"$L1c94"},"cvv_verification":{"type":"string","description":"The result of CVV verification.\n\n| Parameter value | Description |\n| ----- | ----------- |\n| `match` | CVV matches the card's CVV |\n| `not_match` | CVV does not match the card's CVV |\n| `incorrect` | CVV format is incorrect for this type of card |\n| `not_processed` | CVV verification was not performed |","enum":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:0:properties:checks:properties:cvv_verification:enum","descriptionNode":"$L1c95"},"address":{"type":"string","description":"The result of address verification.","enum":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:0:properties:checks:properties:address:enum","descriptionNode":"$L1c96"},"postcode":{"type":"string","description":"The result of postcode verification.","enum":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:0:properties:checks:properties:postcode:enum","descriptionNode":"$L1c97"},"cardholder":{"type":"string","description":"The result of cardholder verification.","enum":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:0:properties:checks:properties:cardholder:enum","descriptionNode":"$L1c98"}},"descriptionNode":"$L1c99"},"authorisation_code":{"type":"string","description":"The authorisation code (or auth code) is a short, alphanumeric code returned by the cardholder's issuing bank to the merchant's terminal or payment gateway.\n\nIt serves as confirmation that the transaction has been approved and funds are available.","pattern":"^[a-zA-Z0-9]{2,6}$","minLength":2,"maxLength":6,"examples":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:0:properties:authorisation_code:examples","descriptionNode":"$L1c9a"},"arn":{"type":"string","description":"Acquirer Reference Number (ARN) of the payment.\n\n:::note\nOnly returned for refund payments made by a card.\n:::","minLength":23,"maxLength":23,"examples":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:0:properties:arn:examples","descriptionNode":"$L1c9b"},"capture_deadline":{"type":"string","format":"date-time","description":"The date and time by which the payment must be captured.\n\nAfter this deadline, the authorised funds may be automatically released by the card issuer.","descriptionNode":"$L1c9c"},"terminal_hardware_id":{"type":"string","description":"The hardware identifier of the Revolut Terminal device used to process the payment.\n\n:::note\nOnly present for card-present transactions processed via Revolut Terminal.\n:::","descriptionNode":"$L1c9d"},"fingerprint":{"type":"string","minLength":44,"maxLength":44,"description":"$1c9e","examples":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:0:properties:fingerprint:examples","descriptionNode":"$L1c9f"},"network_transaction_id":{"type":"string","description":"The Network Transaction ID (NTI) is a unique identifier assigned by the card scheme (e.g., Visa or Mastercard) to a card transaction.\n\nIt can be used to trace the transaction across the payment network, link recurring or instalment payments to the original authorisation, and support dispute resolution.","descriptionNode":"$L1ca0"}},"required":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:0:required","descriptionNode":"$L1ca1"},{"type":"object","description":"Object containing details of the card used for the payment.","properties":{"id":{"type":"string","format":"uuid","description":"ID of the saved payment method.\n\n:::note\nThe `id` parameter is only returned when the payment method is saved.\n:::","descriptionNode":"$L1ca2"},"type":{"type":"string","enum":"$21:props:children:0:props:children:props:responses:200:content:application/json:schema:items:properties:payment_method:oneOf:2:properties:type:enum","description":"The type of payment method used to pay for the order.\n\nAvailable values:\n\n| Payment method `type` | Description |\n| --------------------- | ----------- |\n| `apple_pay` | The customer paid the order using Apple Pay. |\n| `card` | The customer paid the order using their credit or debit card. |\n| `google_pay` | The customer paid the order using Google Pay. |\n| `revolut_pay_card` | The customer paid the order via Revolut Pay using their credit or debit card. |\n| `revolut_pay_account` | The customer paid the order via Revolut Pay using their Revolut account. |\n| `sepa_direct_debit` | The customer paid the order using SEPA Direct Debit. |","descriptionNode":"$L1ca3"},"card_brand":{"type":"string","description":"The type of the card.","enum":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:1:properties:card_brand:enum","descriptionNode":"$L1ca4"},"funding":{"type":"string","description":"The type of card funding.","enum":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:1:properties:funding:enum","descriptionNode":"$L1ca5"},"card_country_code":{"type":"string","description":"The 2-letter country code of the country where the card was issued.","descriptionNode":"$L1ca6"},"card_bin":{"type":"string","description":"The BIN of the card.","minLength":6,"maxLength":6,"descriptionNode":"$L1ca7"},"card_last_four":{"type":"string","description":"The last four digits of the card number.","minLength":4,"maxLength":4,"descriptionNode":"$L1ca8"},"card_expiry":{"type":"string","format":"MM/YY","description":"The expiry date of the card in the format of MM/YY.","descriptionNode":"$L1ca9"},"cardholder_name":{"type":"string","description":"The name of the cardholder.","descriptionNode":"$L1caa"},"checks":{"type":"object","description":"The details of the check for card payment. Only for orders with successful payments.","properties":{"three_ds":"$18:props:children:0:props:children:props:responses:201:content:application/json:schema:properties:payments:items:properties:payment_method:oneOf:0:properties:checks:properties:three_ds","cvv_verification":"$18:props:children:0:props:children:props:responses:201:content:application/json:schema:properties:payments:items:properties:payment_method:oneOf:0:properties:checks:properties:cvv_verification","address":"$18:props:children:0:props:children:props:responses:201:content:application/json:schema:properties:payments:items:properties:payment_method:oneOf:0:properties:checks:properties:address","postcode":"$18:props:children:0:props:children:props:responses:201:content:application/json:schema:properties:payments:items:properties:payment_method:oneOf:0:properties:checks:properties:postcode","cardholder":"$18:props:children:0:props:children:props:responses:201:content:application/json:schema:properties:payments:items:properties:payment_method:oneOf:0:properties:checks:properties:cardholder"},"descriptionNode":"$L1cab"},"authorisation_code":{"type":"string","description":"The authorisation code (or auth code) is a short, alphanumeric code returned by the cardholder's issuing bank to the merchant's terminal or payment gateway.\n\nIt serves as confirmation that the transaction has been approved and funds are available.","pattern":"^[a-zA-Z0-9]{2,6}$","minLength":2,"maxLength":6,"examples":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:0:properties:authorisation_code:examples","descriptionNode":"$L1cac"},"arn":{"type":"string","description":"Acquirer Reference Number (ARN) of the payment.\n\n:::note\nOnly returned for refund payments made by a card.\n:::","minLength":23,"maxLength":23,"examples":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:0:properties:arn:examples","descriptionNode":"$L1cad"},"capture_deadline":{"type":"string","format":"date-time","description":"The date and time by which the payment must be captured.\n\nAfter this deadline, the authorised funds may be automatically released by the card issuer.","descriptionNode":"$L1cae"},"terminal_hardware_id":{"type":"string","description":"The hardware identifier of the Revolut Terminal device used to process the payment.\n\n:::note\nOnly present for card-present transactions processed via Revolut Terminal.\n:::","descriptionNode":"$L1caf"},"fingerprint":{"type":"string","minLength":44,"maxLength":44,"description":"$1cb0","examples":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:0:properties:fingerprint:examples","descriptionNode":"$L1cb1"},"network_transaction_id":{"type":"string","description":"The Network Transaction ID (NTI) is a unique identifier assigned by the card scheme (e.g., Visa or Mastercard) to a card transaction.\n\nIt can be used to trace the transaction across the payment network, link recurring or instalment payments to the original authorisation, and support dispute resolution.","descriptionNode":"$L1cb2"}},"required":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:1:required","descriptionNode":"$L1cb3"},{"type":"object","description":"Object containing details of a card used via Google Pay.","properties":{"id":{"type":"string","format":"uuid","description":"ID of the saved payment method.\n\n:::note\nThe `id` parameter is only returned when the payment method is saved.\n:::","descriptionNode":"$L1cb4"},"type":{"type":"string","enum":"$21:props:children:0:props:children:props:responses:200:content:application/json:schema:items:properties:payment_method:oneOf:2:properties:type:enum","description":"The type of payment method used to pay for the order.\n\nAvailable values:\n\n| Payment method `type` | Description |\n| --------------------- | ----------- |\n| `apple_pay` | The customer paid the order using Apple Pay. |\n| `card` | The customer paid the order using their credit or debit card. |\n| `google_pay` | The customer paid the order using Google Pay. |\n| `revolut_pay_card` | The customer paid the order via Revolut Pay using their credit or debit card. |\n| `revolut_pay_account` | The customer paid the order via Revolut Pay using their Revolut account. |\n| `sepa_direct_debit` | The customer paid the order using SEPA Direct Debit. |","descriptionNode":"$L1cb5"},"card_brand":{"type":"string","description":"The type of the card.","enum":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:2:properties:card_brand:enum","descriptionNode":"$L1cb6"},"funding":{"type":"string","description":"The type of card funding.","enum":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:2:properties:funding:enum","descriptionNode":"$L1cb7"},"card_country_code":{"type":"string","description":"The 2-letter country code of the country where the card was issued.","descriptionNode":"$L1cb8"},"card_bin":{"type":"string","description":"The BIN of the card.","minLength":6,"maxLength":6,"descriptionNode":"$L1cb9"},"card_last_four":{"type":"string","description":"The last four digits of the card number.","minLength":4,"maxLength":4,"descriptionNode":"$L1cba"},"card_expiry":{"type":"string","format":"MM/YY","description":"The expiry date of the card in the format of MM/YY.","descriptionNode":"$L1cbb"},"cardholder_name":{"type":"string","description":"The name of the cardholder.","descriptionNode":"$L1cbc"},"checks":{"type":"object","description":"The details of the check for card payment. Only for orders with successful payments.","properties":{"three_ds":"$18:props:children:0:props:children:props:responses:201:content:application/json:schema:properties:payments:items:properties:payment_method:oneOf:0:properties:checks:properties:three_ds","cvv_verification":"$18:props:children:0:props:children:props:responses:201:content:application/json:schema:properties:payments:items:properties:payment_method:oneOf:0:properties:checks:properties:cvv_verification","address":"$18:props:children:0:props:children:props:responses:201:content:application/json:schema:properties:payments:items:properties:payment_method:oneOf:0:properties:checks:properties:address","postcode":"$18:props:children:0:props:children:props:responses:201:content:application/json:schema:properties:payments:items:properties:payment_method:oneOf:0:properties:checks:properties:postcode","cardholder":"$18:props:children:0:props:children:props:responses:201:content:application/json:schema:properties:payments:items:properties:payment_method:oneOf:0:properties:checks:properties:cardholder"},"descriptionNode":"$L1cbd"},"authorisation_code":{"type":"string","description":"The authorisation code (or auth code) is a short, alphanumeric code returned by the cardholder's issuing bank to the merchant's terminal or payment gateway.\n\nIt serves as confirmation that the transaction has been approved and funds are available.","pattern":"^[a-zA-Z0-9]{2,6}$","minLength":2,"maxLength":6,"examples":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:0:properties:authorisation_code:examples","descriptionNode":"$L1cbe"},"arn":{"type":"string","description":"Acquirer Reference Number (ARN) of the payment.\n\n:::note\nOnly returned for refund payments made by a card.\n:::","minLength":23,"maxLength":23,"examples":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:0:properties:arn:examples","descriptionNode":"$L1cbf"},"capture_deadline":{"type":"string","format":"date-time","description":"The date and time by which the payment must be captured.\n\nAfter this deadline, the authorised funds may be automatically released by the card issuer.","descriptionNode":"$L1cc0"},"terminal_hardware_id":{"type":"string","description":"The hardware identifier of the Revolut Terminal device used to process the payment.\n\n:::note\nOnly present for card-present transactions processed via Revolut Terminal.\n:::","descriptionNode":"$L1cc1"},"fingerprint":{"type":"string","minLength":44,"maxLength":44,"description":"$1cc2","examples":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:0:properties:fingerprint:examples","descriptionNode":"$L1cc3"},"network_transaction_id":{"type":"string","description":"The Network Transaction ID (NTI) is a unique identifier assigned by the card scheme (e.g., Visa or Mastercard) to a card transaction.\n\nIt can be used to trace the transaction across the payment network, link recurring or instalment payments to the original authorisation, and support dispute resolution.","descriptionNode":"$L1cc4"}},"required":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:2:required","descriptionNode":"$L1cc5"},{"type":"object","description":"Object containing details of a card used via Revolut Pay.","properties":{"id":{"type":"string","format":"uuid","description":"ID of the saved payment method.\n\n:::note\nThe `id` parameter is only returned when the payment method is saved.\n:::","descriptionNode":"$L1cc6"},"type":{"type":"string","enum":"$21:props:children:0:props:children:props:responses:200:content:application/json:schema:items:properties:payment_method:oneOf:2:properties:type:enum","description":"The type of payment method used to pay for the order.\n\nAvailable values:\n\n| Payment method `type` | Description |\n| --------------------- | ----------- |\n| `apple_pay` | The customer paid the order using Apple Pay. |\n| `card` | The customer paid the order using their credit or debit card. |\n| `google_pay` | The customer paid the order using Google Pay. |\n| `revolut_pay_card` | The customer paid the order via Revolut Pay using their credit or debit card. |\n| `revolut_pay_account` | The customer paid the order via Revolut Pay using their Revolut account. |\n| `sepa_direct_debit` | The customer paid the order using SEPA Direct Debit. |","descriptionNode":"$L1cc7"},"card_brand":{"type":"string","description":"The type of the card.","enum":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:3:properties:card_brand:enum","descriptionNode":"$L1cc8"},"funding":{"type":"string","description":"The type of card funding.","enum":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:3:properties:funding:enum","descriptionNode":"$L1cc9"},"card_country_code":{"type":"string","description":"The 2-letter country code of the country where the card was issued.","descriptionNode":"$L1cca"},"card_bin":{"type":"string","description":"The BIN of the card.","minLength":6,"maxLength":6,"descriptionNode":"$L1ccb"},"card_last_four":{"type":"string","description":"The last four digits of the card number.","minLength":4,"maxLength":4,"descriptionNode":"$L1ccc"},"card_expiry":{"type":"string","format":"MM/YY","description":"The expiry date of the card in the format of MM/YY.","descriptionNode":"$L1ccd"},"cardholder_name":{"type":"string","description":"The name of the cardholder.","descriptionNode":"$L1cce"},"checks":{"type":"object","description":"The details of the check for card payment. Only for orders with successful payments.","properties":{"three_ds":"$18:props:children:0:props:children:props:responses:201:content:application/json:schema:properties:payments:items:properties:payment_method:oneOf:0:properties:checks:properties:three_ds","cvv_verification":"$18:props:children:0:props:children:props:responses:201:content:application/json:schema:properties:payments:items:properties:payment_method:oneOf:0:properties:checks:properties:cvv_verification","address":"$18:props:children:0:props:children:props:responses:201:content:application/json:schema:properties:payments:items:properties:payment_method:oneOf:0:properties:checks:properties:address","postcode":"$18:props:children:0:props:children:props:responses:201:content:application/json:schema:properties:payments:items:properties:payment_method:oneOf:0:properties:checks:properties:postcode","cardholder":"$18:props:children:0:props:children:props:responses:201:content:application/json:schema:properties:payments:items:properties:payment_method:oneOf:0:properties:checks:properties:cardholder"},"descriptionNode":"$L1ccf"},"authorisation_code":{"type":"string","description":"The authorisation code (or auth code) is a short, alphanumeric code returned by the cardholder's issuing bank to the merchant's terminal or payment gateway.\n\nIt serves as confirmation that the transaction has been approved and funds are available.","pattern":"^[a-zA-Z0-9]{2,6}$","minLength":2,"maxLength":6,"examples":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:0:properties:authorisation_code:examples","descriptionNode":"$L1cd0"},"arn":{"type":"string","description":"Acquirer Reference Number (ARN) of the payment.\n\n:::note\nOnly returned for refund payments made by a card.\n:::","minLength":23,"maxLength":23,"examples":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:0:properties:arn:examples","descriptionNode":"$L1cd1"},"capture_deadline":{"type":"string","format":"date-time","description":"The date and time by which the payment must be captured.\n\nAfter this deadline, the authorised funds may be automatically released by the card issuer.","descriptionNode":"$L1cd2"},"terminal_hardware_id":{"type":"string","description":"The hardware identifier of the Revolut Terminal device used to process the payment.\n\n:::note\nOnly present for card-present transactions processed via Revolut Terminal.\n:::","descriptionNode":"$L1cd3"},"fingerprint":{"type":"string","minLength":44,"maxLength":44,"description":"$1cd4","examples":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:0:properties:fingerprint:examples","descriptionNode":"$L1cd5"},"network_transaction_id":{"type":"string","description":"The Network Transaction ID (NTI) is a unique identifier assigned by the card scheme (e.g., Visa or Mastercard) to a card transaction.\n\nIt can be used to trace the transaction across the payment network, link recurring or instalment payments to the original authorisation, and support dispute resolution.","descriptionNode":"$L1cd6"}},"required":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:3:required","descriptionNode":"$L1cd7"},{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"ID of the saved payment method.\n\n:::note\nThe `id` parameter is only returned when the payment method is saved.\n:::","descriptionNode":"$L1cd8"},"type":{"type":"string","enum":"$21:props:children:0:props:children:props:responses:200:content:application/json:schema:items:properties:payment_method:oneOf:2:properties:type:enum","description":"The type of payment method used to pay for the order.\n\nAvailable values:\n\n| Payment method `type` | Description |\n| --------------------- | ----------- |\n| `apple_pay` | The customer paid the order using Apple Pay. |\n| `card` | The customer paid the order using their credit or debit card. |\n| `google_pay` | The customer paid the order using Google Pay. |\n| `revolut_pay_card` | The customer paid the order via Revolut Pay using their credit or debit card. |\n| `revolut_pay_account` | The customer paid the order via Revolut Pay using their Revolut account. |\n| `sepa_direct_debit` | The customer paid the order using SEPA Direct Debit. |","descriptionNode":"$L1cd9"},"fingerprint":{"type":"string","minLength":44,"maxLength":44,"description":"$1cda","examples":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:0:properties:fingerprint:examples","descriptionNode":"$L1cdb"}},"required":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payment_method:oneOf:4:required"},{"type":"object","description":"Object containing details of a SEPA Direct Debit payment.\n\n:::info\nFor more information, see: [SEPA Direct Debit server-to-server integration](https://developer.revolut.com/docs/guides/merchant/accept-payments/payment-methods/sepa-direct-debit/server-to-server)\n:::","properties":{"id":{"type":"string","format":"uuid","description":"ID of the saved payment method.\n\n:::note\nThe `id` parameter is only returned when the payment method is saved for the merchant.\n:::","descriptionNode":"$L1cdc"},"type":{"type":"string","enum":"$21:props:children:0:props:children:props:responses:200:content:application/json:schema:items:properties:payment_method:oneOf:2:properties:type:enum","description":"The type of payment method used to pay for the order.\n\nAvailable values:\n\n| Payment method `type` | Description |\n| --------------------- | ----------- |\n| `apple_pay` | The customer paid the order using Apple Pay. |\n| `card` | The customer paid the order using their credit or debit card. |\n| `google_pay` | The customer paid the order using Google Pay. |\n| `revolut_pay_card` | The customer paid the order via Revolut Pay using their credit or debit card. |\n| `revolut_pay_account` | The customer paid the order via Revolut Pay using their Revolut account. |\n| `sepa_direct_debit` | The customer paid the order using SEPA Direct Debit. |","descriptionNode":"$L1cdd"},"debtor_iban_last_four":{"type":"string","description":"The last four digits of the debtor's IBAN.","minLength":4,"maxLength":4,"descriptionNode":"$L1cde"},"debtor_name":{"type":"string","description":"The full name of the debtor as provided in the mandate.","descriptionNode":"$L1cdf"},"mandate_reference":{"type":"string","description":"The unique mandate reference generated by Revolut. Include this in pre-debit notifications sent to your customers.","descriptionNode":"$L1ce0"}},"required":"$21:props:children:0:props:children:props:responses:200:content:application/json:schema:items:properties:payment_method:oneOf:2:required","descriptionNode":"$L1ce1"}],"descriptionNode":"$L1ce2"},"authentication_challenge":{"type":"object","description":"Details about the authentication challenge that should be performed to complete the authentication process. For more information about Revolut's 3DS solution, see: [3D Secure overview](https://developer.revolut.com/docs/guides/merchant/reference/3d-secure).\n\nOnly returned if the payment's state is `authentication_challenge`.","discriminator":"$21:props:children:0:props:children:props:responses:200:content:application/json:schema:items:properties:authentication_challenge:discriminator","oneOf":[{"title":"three_ds","type":"object","description":"Information about the 3DS challenge.","properties":{"type":{"type":"string","enum":"$21:props:children:0:props:children:props:responses:200:content:application/json:schema:items:properties:authentication_challenge:oneOf:0:properties:type:enum","description":"Type of the authentication challenge the payment triggers.","descriptionNode":"$L1ce3"},"acs_url":{"type":"string","format":"url","description":"The URL of the authentication challenge.","descriptionNode":"$L1ce4"}},"required":"$21:props:children:0:props:children:props:responses:200:content:application/json:schema:items:properties:authentication_challenge:oneOf:0:required","descriptionNode":"$L1ce5"},{"title":"three_ds_fingerprint","type":"object","description":"Information about the 3DS fingerprint challenge.","properties":{"type":{"type":"string","enum":"$21:props:children:0:props:children:props:responses:200:content:application/json:schema:items:properties:authentication_challenge:oneOf:0:properties:type:enum","description":"Type of the authentication challenge the payment triggers.","descriptionNode":"$L1ce6"},"fingerprint_url":{"type":"string","format":"url","description":"The URL of the fingerprint. (Used only internally by Revolut.)","descriptionNode":"$L1ce7"},"fingerprint_data":{"type":"string","format":"JSON","description":"Data about the fingerprint used for authentication. (Used only internally\nby Revolut.)","descriptionNode":"$L1ce8"}},"required":"$21:props:children:0:props:children:props:responses:200:content:application/json:schema:items:properties:authentication_challenge:oneOf:1:required","descriptionNode":"$L1ce9"}],"descriptionNode":"$L1cea"},"billing_address":{"type":"object","description":"Object containing address details.","properties":{"street_line_1":{"type":"string","description":"Street line 1 information.","maxLength":100,"descriptionNode":"$L1ceb"},"street_line_2":{"type":"string","description":"Street line 2 information.","maxLength":100,"descriptionNode":"$L1cec"},"region":{"type":"string","description":"The region associated with the address.","maxLength":100,"descriptionNode":"$L1ced"},"city":{"type":"string","description":"The city associated with the address.","maxLength":100,"descriptionNode":"$L1cee"},"country_code":{"type":"string","description":"The 2-letter country code of the country associated with the address.","maxLength":2,"descriptionNode":"$L1cef"},"postcode":{"type":"string","description":"The postcode associated with the address.","maxLength":100,"descriptionNode":"$L1cf0"}},"required":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:billing_address:required","descriptionNode":"$L1cf1"},"risk_level":{"type":"string","description":"The risk level of the card.\n\nIf the risk level is `high`, the payment might be declined.","enum":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:risk_level:enum","descriptionNode":"$L1cf2"},"fees":{"type":"array","description":"The details of the order fee.","items":{"type":"object","properties":{"type":{"type":"string","description":"The type of the order fee.","enum":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:fees:items:properties:type:enum","descriptionNode":"$L1cf3"},"amount":{"type":"integer","description":"The amount of the payment fee (minor currency unit). For example, enter `7034` for €70.34 in the field.","descriptionNode":"$L1cf4"},"currency":{"type":"string","description":"The currency of the payment fee. [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) currency code in upper case.\n\n:::info\nFor more information about the supported currencies, see: [Help Center](https://help.revolut.com/business/help/merchant-accounts/payments/in-which-currencies-can-i-accept-payments/).\n:::","descriptionNode":"$L1cf5"}}},"descriptionNode":"$L1cf6"},"payer":{"title":"Payer","type":"object","description":"The person who made the payment. This object is present when an email or phone number is provided during the payment flow.\n\nCapturing payer details lets you identify exactly who authorised the charge, reach the right person for receipts or refund queries, and support compliance or fraud-review workflows where the paying identity matters.","properties":{"email":{"description":"The email of the person who made the payment.","type":"string","format":"email","descriptionNode":"$L1cf7"},"phone":{"description":"The phone number of the payer in [E.164 format](https://en.wikipedia.org/wiki/E.164).","type":"string","descriptionNode":"$L1cf8"}},"descriptionNode":"$L1cf9"}},"required":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:payments:items:required","descriptionNode":"$L1cfa"},"descriptionNode":"$L1cfb"},"incremental_authorisations":{"type":"array","description":"History of incremental authorisation attempts for this order.\n\nOnly present for orders with `authorisation_type: pre_authorisation`.\n\nContains all increment attempts in chronological order.","items":{"type":"object","description":"Represents a single incremental authorisation attempt on an order.\n\nThe `incremental_authorisations` array tracks all increment attempts (successful and failed) in chronological order.","properties":{"new_amount":{"type":"integer","description":"The new total amount requested in this increment (in minor units).","examples":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:incremental_authorisations:items:properties:new_amount:examples","descriptionNode":"$L1cfc"},"old_amount":{"type":"integer","description":"The previously authorised amount before this increment (in minor units).","examples":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:incremental_authorisations:items:properties:old_amount:examples","descriptionNode":"$L1cfd"},"state":{"type":"string","enum":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:incremental_authorisations:items:properties:state:enum","description":"The state of this incremental authorization attempt.\n\n| State | Description |\n|-------|-------------|\n| `pending` | Increment registered in system, not yet submitted to card network |\n| `processing` | Increment is being processed by card network |\n| `authorised` | Increment was successfully authorised |\n| `declined` | Increment was declined by card issuer |\n| `failed` | Increment failed due to technical error (not an issuer decline) |","descriptionNode":"$L1cfe"},"reference":{"type":"string","maxLength":255,"description":"External reference for this incremental authorisation.\n\n:::tip\nUse your internal charge or invoice ID. This reference is returned in webhooks for easy matching to your system.\n:::","examples":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:incremental_authorisations:items:properties:reference:examples","descriptionNode":"$L1cff"},"line_items":{"type":"array","description":"Line items associated with this increment (if provided).\n\n:::note\nIf the increment is successful, these line items will override the existing order line items.\n:::","items":{"type":"object","properties":{"name":{"type":"string","maxLength":250,"description":"Name of the line item.","descriptionNode":"$L1d00"},"type":{"type":"string","enum":"$19:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:orders:items:properties:line_items:items:properties:type:enum","description":"Type of the line item.","descriptionNode":"$L1d01"},"quantity":{"type":"object","description":"Object representing the quantity details of a line item, including the amount and its associated unit of measurement.","properties":{"value":{"type":"number","format":"double","minimum":0,"description":"The number of units of the line item.","descriptionNode":"$L1d02"},"unit":{"type":"string","maxLength":100,"description":"The measurement unit for the quantity, such as `cm`, or `kg`.","descriptionNode":"$L1d03"}},"required":"$19:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:orders:items:properties:line_items:items:properties:quantity:required","descriptionNode":"$L1d04"},"unit_price_amount":{"type":"integer","format":"int64","minimum":0,"description":"The unit price of the line item.","descriptionNode":"$L1d05"},"total_amount":{"type":"integer","format":"int64","description":"The total amount to be paid for the line item, including taxes and discounts.","descriptionNode":"$L1d06"},"external_id":{"type":"string","maxLength":250,"description":"Unique identifier of line item in the merchant's system.","descriptionNode":"$L1d07"},"discounts":{"type":"array","maxItems":50,"description":"A list of discounts applied to the line item. Each discount should be subtracted from the total amount payable for the item.","items":{"type":"object","description":"Details of a discount applied to the line item, including its name and monetary value.","properties":{"name":{"type":"string","maxLength":100,"description":"The specific name or label of the discount applied to the line item.","descriptionNode":"$L1d08"},"amount":{"type":"integer","format":"int64","minimum":0,"description":"The monetary value of the discount. ","descriptionNode":"$L1d09"}},"required":"$19:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:orders:items:properties:line_items:items:properties:discounts:items:required","descriptionNode":"$L1d0a"},"descriptionNode":"$L1d0b"},"taxes":{"type":"array","maxItems":50,"description":"A list of taxes applied to the line item. Each tax should be added to the total amount payable for the item.","items":{"type":"object","description":"Details about a tax applied to the line item, including its name and the corresponding amount.","properties":{"name":{"type":"string","description":"The specific name or designation of the tax applied to the line item.","maxLength":100,"descriptionNode":"$L1d0c"},"amount":{"type":"integer","format":"int64","description":"The monetary value of the tax in minor currency units (e.g., cents for EUR).","minimum":0,"descriptionNode":"$L1d0d"}},"required":"$19:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:orders:items:properties:line_items:items:properties:taxes:items:required","descriptionNode":"$L1d0e"},"descriptionNode":"$L1d0f"},"image_urls":{"type":"array","maxItems":50,"description":"A list of URLs pointing to images related to the line item. These images can provide visual details or representations of the item.","items":{"type":"string","format":"uri","pattern":"^https?:\\/{2}.+/gi","maxLength":2000,"description":"URL to an image associated with the line item.\n\n:::warning\nRestrictions:\n- Must be a valid URI as defined by [RFC 3986](https://datatracker.ietf.org/doc/html/rfc3986)\n- URI scheme is required and must be either `http` or `https`\n- URI host is required and cannot be `localhost` or an IP address\n- Max length: `2000`\n- Reserved or invalid characters must be percent-encoded (for example, use `%20` instead of a space)\n:::","descriptionNode":"$L1d10"},"descriptionNode":"$L1d11"},"description":{"type":"string","maxLength":1024,"description":"Description of the line item.","descriptionNode":"$L1d12"},"url":{"type":"string","format":"uri","pattern":"^https?:\\/{2}.+/gi","maxLength":2000,"description":"An HTTP/HTTPS URL that links to more information about the line item, such as a product page or details.\n\n:::warning\nRestrictions:\n- Must be a valid URI as defined by [RFC 3986](https://datatracker.ietf.org/doc/html/rfc3986)\n- URI scheme is required and must be either `http` or `https`\n- URI host is required and cannot be `localhost` or an IP address\n- Max length: `2000`\n- Reserved or invalid characters must be percent-encoded (for example, use `%20` instead of a space)\n:::","descriptionNode":"$L1d13"}},"required":"$19:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:orders:items:properties:line_items:items:required"},"descriptionNode":"$L1d14"},"reason":{"type":"string","description":"Reason why increment was declined or failed.\n\n:::note\nOnly present when `state` is `declined` or `failed`.\n:::","examples":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:incremental_authorisations:items:properties:reason:examples","descriptionNode":"$L1d15"}},"descriptionNode":"$L1d16"},"descriptionNode":"$L1d17"},"location_id":{"type":"string","format":"uuid","description":"Unique ID representing the location where merchants sells products.\n\n:::info\nFor more information, see: [Locations](https://developer.revolut.com/docs/api/merchant#tag-locations).\n::: ","descriptionNode":"$L1d18"},"metadata":{"type":"object","description":"Additional information to track your orders in your system, by providing custom metadata using `\"\" : \"\"` pairs.\n\n:::warning\n**Restrictions:**\n\n- Both keys and values must be `string`s\n- Values cannot be `null`.\n- Max number of key-value pairs: `50`\n- Max length of values: `500` characters\n- Format of keys: Must start with a letter and contain only letters, digits, and underscores. Max 40 characters. Pattern: `^[a-zA-Z][a-zA-Z\\\\d_]{0,39}$`\n:::","maxProperties":50,"additionalProperties":{"type":"string","maxLength":500,"description":"Additional metadata value provided with the corresponding metadata key.","descriptionNode":"$L1d19"},"examples":"$19:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:orders:items:properties:metadata:examples","descriptionNode":"$L1d1a"},"industry_data":{"type":"object","description":"Object containing industry-specific information associated with the order.\n\n:::info\nIn the following cases, industry-specific info is required. Omitting this information may trigger additional scrutiny and risk mitigation actions by the Revolut risk team.\n\n | Transaction type | Required for |\n | ---------------- | ----------- |\n | `airline` | Airlines and Online Travel Agencies (OTAs). |\n | `car_rental` | Car Rental Merchants and Online Travel Agencies (OTAs). |\n | `crypto` | Crypto merchants. |\n | `marketplace` | Marketplace merchants. |\n | `event` | Event ticket sellers. |\n | `lodging` | Lodging providers. |\n:::","discriminator":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:discriminator","oneOf":[{"type":"object","description":"$1d1b","properties":{"type":{"type":"string","enum":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:0:properties:type:enum","description":"Type of the industry-specific data object, determining what additional data is expected.\n\nAvailable types:\n\n | Object type | Description |\n | ------------- | ----------- |\n | `airline` | Object containing information about a specific airline ticket purchase. |\n | `car_rental` | Object containing information about a car rental booking associated with the order. |\n | `crypto` | Object containing information about crypto transactions associated with the order. |\n | `marketplace` | This object is required by Mastercard and Visa for merchants operating as marketplaces under the **Merchant Category Code (MCC):** `5262`. The marketplace object ensures compliance with the card schemes' regulations by providing detailed information about the subseller involved in the transaction. |\n | `event` | Object containing information about event ticket bookings associated with the order. |\n | `lodging` | Object containing information about lodging bookings associated with the order. |","descriptionNode":"$L1d1c"},"booking_id":{"type":"string","description":"A unique identifier provided by the merchant associated with the order. \n\nThis `booking_id` is used to reference and correlate booking information with the Merchant API and the merchant's internal system.","descriptionNode":"$L1d1d"},"fulfillment_date":{"type":"string","format":"date-time","description":"The UTC date and time of the final journey leg.\n\n:::warning\nThe following limitations apply:\n - When creating or updating an order, `fulfillment_date` cannot be set to a date in the past.\n - When updating an order, if the current `fulfillment_date` value is already in the past, it cannot be modified. The date must remain as is to maintain data integrity for completed transactions.\n:::","descriptionNode":"$L1d1e"},"tickets_purchase":{"type":"boolean","description":"Flag indicating whether the order includes actual ticket purchases. Set to `true` if the order contains ticket purchases, and `false` if it does not (e.g., it **only** contains seat reservations, or baggage upgrades). \n\n:::info\nThis field is required for activating **Revolut Flight Alerts** functionalities within the Revolut app.\n\nProvide the info on order creation or update, before capturing the order.\n:::","descriptionNode":"$L1d1f"},"ticket_type":{"type":"string","enum":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:0:properties:ticket_type:enum","description":"The type of the ticket.\n\n| Parameter value | Description |\n| --------------- | ----------- |\n| `fixed` | Non-modifiable once confirmed. |\n| `flexible` | Allows modifications or cancellations under specified conditions. |","descriptionNode":"$L1d20"},"crs_code":{"type":"string","maxLength":4,"description":"The code of the Computer Reservation System (CRS) used to make the booking and purchase the ticket.","descriptionNode":"$L1d21"},"ticket_change_indicator":{"type":"string","enum":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:0:properties:ticket_change_indicator:enum","description":"Parameter indicating whether this order is related to a new ticket reservation or a modification of an existing one.","descriptionNode":"$L1d22"},"refundability":{"type":"string","enum":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:0:properties:refundability:enum","description":"Parameter indicating whether the booking is refundable, partially refundable, or not refundable.","descriptionNode":"$L1d23"},"passengers":{"type":"array","description":"Array containing information of passengers associated with the booking.","items":{"type":"object","properties":{"first_name":{"type":"string","description":"Passenger's first name.","descriptionNode":"$L1d24"},"last_name":{"type":"string","description":"Passenger's last name.","descriptionNode":"$L1d25"}},"required":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:0:properties:passengers:items:required"},"descriptionNode":"$L1d26"},"journey_legs":{"type":"array","description":"Array containing information of journey legs associated with the booking.\n\n:::info\nThis field is required for activating **Revolut Flight Alerts** functionalities within the Revolut app. \n\nThis information is used to compile a tracking widget that provides real-time updates on flight status and sends notifications, such as a check-in reminders, boarding alerts, and notifications for cancellations or delays. \n\nTo enable the widget the following fields are required on order creation or update, before capturing the order:\n\n ```\n sequence,\n departure_airport_code,\n arrival_airport_code,\n flight_number,\n travel_date,\n airline_name,\n airline_code,\n ```\n:::","items":{"type":"object","properties":{"sequence":{"type":"integer","description":"Sequence of the journey legs. Increment by 1 for each flight included in the ticket.\n\nFor example: For a `FRA > LHR > DUB > LHR > FRA` journey the sequence will be assigned as:\n - `FRA > LHR`: 1\n - `LHR > DUB`: 2\n - `DUB > LHR`: 3\n - `LHR > FRA`: 4","descriptionNode":"$L1d27"},"departure_airport_code":{"type":"string","description":"The [IATA](https://www.iata.org/en/services/codes) 3-letter airport code for the departure airport.","descriptionNode":"$L1d28"},"arrival_airport_code":{"type":"string","description":"The [IATA](https://www.iata.org/en/services/codes) 3-letter airport code for the arrival airport.","descriptionNode":"$L1d29"},"flight_number":{"type":"string","description":"The flight identifier, without airline code.","descriptionNode":"$L1d2a"},"fare_base_code":{"type":"string","description":"The fare base code for the given journey leg.","descriptionNode":"$L1d2b"},"travel_date":{"type":"string","format":"date-time","description":"The UTC date and time of the flight departure for the given journey leg.","descriptionNode":"$L1d2c"},"airline_name":{"type":"string","description":"The name of the airline associated with the journey leg.","descriptionNode":"$L1d2d"},"airline_code":{"type":"string","description":"The IATA 2-letter accounting code identifying the airline associated with the journey leg.","descriptionNode":"$L1d2e"},"pnr":{"type":"string","format":"alphanumeric","pattern":"^[a-zA-Z0-9]*$","maxLength":20,"description":"The Passenger Name Record (PNR) for the journey leg issued by the airline. \n\nPNR is a unique identifier for the booking, acting as a digital certificate allowing passengers to retrieve or manage their booking details.\n\n:::warning\nThis is a required field for OTAs.\n:::","descriptionNode":"$L1d2f"}},"required":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:0:properties:journey_legs:items:required"},"descriptionNode":"$L1d30"},"booking_url":{"type":"string","format":"uri","pattern":"^https?:\\/{2}.+/gi","maxLength":2000,"description":"URL to the online portal for managing the airline booking, which includes check-in functionality. This URL may be a personalised, pre-populated check-in link specific to the user or a generic link, and it is essential for enabling direct access to booking details within the Revolut app.\n\n:::info\nThis field is required for activating **Revolut Flight Alerts** functionalities within the Revolut app. \n\nProvide the info on order creation or update, before capturing the order.\n:::\n\n:::warning\nRestrictions:\n- Must be a valid URI as defined by [RFC 3986](https://datatracker.ietf.org/doc/html/rfc3986)\n- URI scheme is required and must be either `http` or `https`\n- URI host is required and cannot be `localhost` or an IP address\n- Max length: `2000`\n- Reserved or invalid characters must be percent-encoded (for example, use `%20` instead of a space)\n:::","descriptionNode":"$L1d31"}},"required":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:0:required","descriptionNode":"$L1d32"},{"type":"object","description":"Object containing additional information about a car rental booking associated with the order.\n\n:::info\nThese are the specific data field requirements for merchants offering car rental. Note that these requirements can be extended on a case by case basis as decided by Revolut.\n\n```\nbooking_id\ndrop_off_date\nrefundability\n```\n:::","properties":{"type":{"type":"string","enum":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:0:properties:type:enum","description":"Type of the industry-specific data object, determining what additional data is expected.\n\nAvailable types:\n\n | Object type | Description |\n | ------------- | ----------- |\n | `airline` | Object containing information about a specific airline ticket purchase. |\n | `car_rental` | Object containing information about a car rental booking associated with the order. |\n | `crypto` | Object containing information about crypto transactions associated with the order. |\n | `marketplace` | This object is required by Mastercard and Visa for merchants operating as marketplaces under the **Merchant Category Code (MCC):** `5262`. The marketplace object ensures compliance with the card schemes' regulations by providing detailed information about the subseller involved in the transaction. |\n | `event` | Object containing information about event ticket bookings associated with the order. |\n | `lodging` | Object containing information about lodging bookings associated with the order. |","descriptionNode":"$L1d33"},"booking_id":{"type":"string","description":"A unique identifier provided by the merchant associated with the order. \n\nThis `booking_id` is used to reference and correlate booking information with the Merchant API and the merchant's internal system.","descriptionNode":"$L1d34"},"pick_up_date":{"type":"string","format":"date-time","description":"The UTC date and time of the pick-up.","descriptionNode":"$L1d35"},"pick_up_location":{"type":"object","description":"Object containing address details.","properties":{"street_line_1":"$18:props:children:0:props:children:props:responses:201:content:application/json:schema:properties:payments:items:properties:billing_address:properties:street_line_1","street_line_2":"$18:props:children:0:props:children:props:responses:201:content:application/json:schema:properties:payments:items:properties:billing_address:properties:street_line_2","region":"$18:props:children:0:props:children:props:responses:201:content:application/json:schema:properties:payments:items:properties:billing_address:properties:region","city":"$18:props:children:0:props:children:props:responses:201:content:application/json:schema:properties:payments:items:properties:billing_address:properties:city","country_code":"$18:props:children:0:props:children:props:responses:201:content:application/json:schema:properties:payments:items:properties:billing_address:properties:country_code","postcode":"$18:props:children:0:props:children:props:responses:201:content:application/json:schema:properties:payments:items:properties:billing_address:properties:postcode"},"required":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:billing_address:required","descriptionNode":"$L1d36"},"drop_off_date":{"type":"string","format":"date-time","description":"The UTC date and time of the drop-off.","descriptionNode":"$L1d37"},"drop_off_location":{"type":"object","description":"Object containing address details.","properties":{"street_line_1":"$18:props:children:0:props:children:props:responses:201:content:application/json:schema:properties:payments:items:properties:billing_address:properties:street_line_1","street_line_2":"$18:props:children:0:props:children:props:responses:201:content:application/json:schema:properties:payments:items:properties:billing_address:properties:street_line_2","region":"$18:props:children:0:props:children:props:responses:201:content:application/json:schema:properties:payments:items:properties:billing_address:properties:region","city":"$18:props:children:0:props:children:props:responses:201:content:application/json:schema:properties:payments:items:properties:billing_address:properties:city","country_code":"$18:props:children:0:props:children:props:responses:201:content:application/json:schema:properties:payments:items:properties:billing_address:properties:country_code","postcode":"$18:props:children:0:props:children:props:responses:201:content:application/json:schema:properties:payments:items:properties:billing_address:properties:postcode"},"required":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:billing_address:required","descriptionNode":"$L1d38"},"refundability":{"type":"string","enum":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:0:properties:refundability:enum","description":"Parameter indicating whether the booking is refundable, partially refundable, or not refundable.","descriptionNode":"$L1d39"},"distance_limit":{"type":"object","description":"Object containing distance limit information.","properties":{"limit":{"type":"integer","description":"The maximum distance allowed.","descriptionNode":"$L1d3a"},"unit":{"type":"string","description":"The unit of distance.","enum":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:1:properties:distance_limit:properties:unit:enum","descriptionNode":"$L1d3b"},"additional_distance_cost":{"type":"object","description":"Cost for exceeding the distance limit.","properties":{"amount":{"type":"integer","description":"The amount of the cost in minor currency units. For example, enter `7034` for €70.34.","descriptionNode":"$L1d3c"},"currency":{"type":"string","format":"ISO 4217","minLength":3,"maxLength":3,"description":"[ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) currency code in upper case.\n\n:::info\nFor more information about the supported currencies, see: [Help Center](https://help.revolut.com/business/help/merchant-accounts/payments/in-which-currencies-can-i-accept-payments/).\n:::","descriptionNode":"$L1d3d"}},"descriptionNode":"$L1d3e"}},"descriptionNode":"$L1d3f"}},"required":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:1:required","descriptionNode":"$L1d40"},{"type":"object","description":"Object containing information about crypto transactions associated with the order.\n\n:::info\nProcessing crypto on-ramp transactions with Revolut has additional compliance requirements. Please reach out to your account executive for additional details.\n\n**Required data fields for crypto services:**\n\n```\ntransactions[].id\ntransactions[].status\ntransactions[].recipient_wallet_id\nseller.id\nseller.name\nseller.website\nseller.phone\nseller.address\nseller.mcc\ncustomer.full_name\ncustomer.date_of_birth\n```\n\nNote that these requirements can be extended on a case by case basis as decided by Revolut.\n:::","properties":{"type":{"type":"string","enum":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:0:properties:type:enum","description":"Type of the industry-specific data object, determining what additional data is expected.\n\nAvailable types:\n\n | Object type | Description |\n | ------------- | ----------- |\n | `airline` | Object containing information about a specific airline ticket purchase. |\n | `car_rental` | Object containing information about a car rental booking associated with the order. |\n | `crypto` | Object containing information about crypto transactions associated with the order. |\n | `marketplace` | This object is required by Mastercard and Visa for merchants operating as marketplaces under the **Merchant Category Code (MCC):** `5262`. The marketplace object ensures compliance with the card schemes' regulations by providing detailed information about the subseller involved in the transaction. |\n | `event` | Object containing information about event ticket bookings associated with the order. |\n | `lodging` | Object containing information about lodging bookings associated with the order. |","descriptionNode":"$L1d41"},"transactions":{"type":"array","description":"Array of crypto transaction data associated with the order.","items":{"type":"object","properties":{"id":{"type":"string","maxLength":255,"description":"The public transaction hash of the crypto transaction.","descriptionNode":"$L1d42"},"status":{"type":"string","enum":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:2:properties:transactions:items:properties:status:enum","description":"The status of the crypto transaction.","descriptionNode":"$L1d43"},"recipient_wallet_id":{"type":"string","maxLength":255,"description":"The wallet ID of the recipient.\n\n:::note\nAt least one of the parameters: `recipient_user_id` or `recipient_wallet_id` is required.\n::: ","descriptionNode":"$L1d44"},"recipient_user_id":{"type":"string","maxLength":255,"description":"The user ID of the recipient.\n\n:::note\nAt least one of the parameters: `recipient_user_id` or `recipient_wallet_id` is required.\n::: ","descriptionNode":"$L1d45"}},"required":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:2:properties:transactions:items:required"},"minItems":1,"descriptionNode":"$L1d46"},"seller":{"type":"object","description":"Information about the crypto conversion affiliate.\n\nThis should be provided when a customer completes a payment on a subseller's website rather than directly on the merchant's website, providing insight into the type of business conducted by the subseller.\n\n:::note\nThis needs to be provided only by crypto on-ramp providers for payments they are processing for conversion affiliates.\n\nFor their own payments, `seller` can be omitted.\n:::","properties":{"mcc":{"type":"string","description":"A string representing the four-digit [Merchant Category Code (MCC)](https://en.wikipedia.org/wiki/Merchant_category_code) of the conversion affiliate.","maxLength":4,"minLength":4,"pattern":"^\\d{4}$","descriptionNode":"$L1d47"},"id":{"type":"string","description":"The ID of the seller in the merchant's internal system.","minLength":1,"maxLength":15,"descriptionNode":"$L1d48"},"name":{"type":"string","description":"The business or legal name of the seller.","minLength":1,"maxLength":50,"descriptionNode":"$L1d49"},"website":{"type":"string","format":"uri","pattern":"^https?:\\/{2}.+/gi","maxLength":255,"description":"The URL of the website of the seller.\n\n:::warning\nRestrictions:\n- Must be a valid URI as defined by [RFC 3986](https://datatracker.ietf.org/doc/html/rfc3986)\n- URI scheme is required and must be either `http` or `https`\n- URI host is required and cannot be `localhost` or an IP address\n- Max length: `255`\n- Reserved or invalid characters must be percent-encoded (for example, use `%20` instead of a space)\n:::","descriptionNode":"$L1d4a"},"phone":{"type":"string","description":"The phone number of the seller.","descriptionNode":"$L1d4b"},"address":{"type":"object","description":"Details of a physical address.","properties":{"street_line_1":{"type":"string","description":"Primary address line.","maxLength":100,"descriptionNode":"$L1d4c"},"street_line_2":{"type":"string","description":"Secondary address line, such as floor and apartment number.","maxLength":100,"descriptionNode":"$L1d4d"},"region":{"type":"string","description":"State or province of the address.","maxLength":100,"descriptionNode":"$L1d4e"},"city":{"type":"string","description":"City of the address.","maxLength":100,"descriptionNode":"$L1d4f"},"country_code":{"type":"string","pattern":"^[A-Z]{2}$","description":"ISO 2-letter country code.","minLength":2,"maxLength":2,"descriptionNode":"$L1d50"},"country_subdivision_code":{"type":"string","pattern":"^[A-Z]{2}-[A-Z0-9]{1,3}$","description":"The subdivision code represents the state, province, or region within the country, following the [ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2) standard. This code uniquely identifies subdivisions within a country. \n\nFor example, for London in the United Kingdom, use `GB-LND`.\n\n:::warning\nThe parameter is required for countries listed on the [ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2) page.\n:::","minLength":5,"maxLength":6,"descriptionNode":"$L1d51"},"postcode":{"type":"string","description":"Postal code of the address.","maxLength":100,"descriptionNode":"$L1d52"}},"required":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:2:properties:seller:properties:address:required","descriptionNode":"$L1d53"}},"required":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:2:properties:seller:required","descriptionNode":"$L1d54"}},"required":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:2:required","descriptionNode":"$L1d55"},{"type":"object","description":"This object is required by Mastercard and Visa for merchants operating as marketplaces under the Merchant Category Code (MCC) `5262`. The marketplace object ensures compliance with the card schemes' regulations by providing detailed information about the seller involved in the transaction.\n\n:::info\nThese are the specific data field requirements for merchants who must provide marketplace data.\n\n```\nseller.id\nseller.name\nseller.website\nseller.phone\nseller.address\n```\n:::","properties":{"type":{"type":"string","enum":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:0:properties:type:enum","description":"Type of the industry-specific data object, determining what additional data is expected.\n\nAvailable types:\n\n | Object type | Description |\n | ------------- | ----------- |\n | `airline` | Object containing information about a specific airline ticket purchase. |\n | `car_rental` | Object containing information about a car rental booking associated with the order. |\n | `crypto` | Object containing information about crypto transactions associated with the order. |\n | `marketplace` | This object is required by Mastercard and Visa for merchants operating as marketplaces under the **Merchant Category Code (MCC):** `5262`. The marketplace object ensures compliance with the card schemes' regulations by providing detailed information about the subseller involved in the transaction. |\n | `event` | Object containing information about event ticket bookings associated with the order. |\n | `lodging` | Object containing information about lodging bookings associated with the order. |","descriptionNode":"$L1d56"},"seller":{"type":"object","description":"Information about the subseller on the marketplace platform.","properties":{"id":{"type":"string","description":"The ID of the seller in the merchant's internal system.","minLength":1,"maxLength":15,"descriptionNode":"$L1d57"},"name":{"type":"string","description":"The business or legal name of the seller.","minLength":1,"maxLength":50,"descriptionNode":"$L1d58"},"website":{"type":"string","format":"uri","pattern":"^https?:\\/{2}.+/gi","maxLength":255,"description":"The URL of the website of the seller.\n\n:::warning\nRestrictions:\n- Must be a valid URI as defined by [RFC 3986](https://datatracker.ietf.org/doc/html/rfc3986)\n- URI scheme is required and must be either `http` or `https`\n- URI host is required and cannot be `localhost` or an IP address\n- Max length: `255`\n- Reserved or invalid characters must be percent-encoded (for example, use `%20` instead of a space)\n:::","descriptionNode":"$L1d59"},"phone":{"type":"string","description":"The phone number of the seller.","descriptionNode":"$L1d5a"},"address":{"type":"object","description":"Details of a physical address.","properties":{"street_line_1":"$18:props:children:0:props:children:props:responses:201:content:application/json:schema:properties:industry_data:oneOf:2:properties:seller:properties:address:properties:street_line_1","street_line_2":"$18:props:children:0:props:children:props:responses:201:content:application/json:schema:properties:industry_data:oneOf:2:properties:seller:properties:address:properties:street_line_2","region":"$18:props:children:0:props:children:props:responses:201:content:application/json:schema:properties:industry_data:oneOf:2:properties:seller:properties:address:properties:region","city":"$18:props:children:0:props:children:props:responses:201:content:application/json:schema:properties:industry_data:oneOf:2:properties:seller:properties:address:properties:city","country_code":"$18:props:children:0:props:children:props:responses:201:content:application/json:schema:properties:industry_data:oneOf:2:properties:seller:properties:address:properties:country_code","country_subdivision_code":"$18:props:children:0:props:children:props:responses:201:content:application/json:schema:properties:industry_data:oneOf:2:properties:seller:properties:address:properties:country_subdivision_code","postcode":"$18:props:children:0:props:children:props:responses:201:content:application/json:schema:properties:industry_data:oneOf:2:properties:seller:properties:address:properties:postcode"},"required":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:2:properties:seller:properties:address:required","descriptionNode":"$L1d5b"}},"required":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:3:properties:seller:required","descriptionNode":"$L1d5c"}},"required":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:3:required","descriptionNode":"$L1d5d"},{"type":"object","description":"Object containing booking information for a list of event tickets associated with the order.\n\n:::info\nThese are the specific data field requirements for merchants who must provide event data. Note that these requirements can be extended on a case by case basis as decided by Revolut.\n\n```\nbooking_id\nevents[].start_date\nevents[].end_date\nevents[].supplier\nevents[].tickets[].id\n```\n:::","properties":{"type":{"type":"string","enum":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:0:properties:type:enum","description":"Type of the industry-specific data object, determining what additional data is expected.\n\nAvailable types:\n\n | Object type | Description |\n | ------------- | ----------- |\n | `airline` | Object containing information about a specific airline ticket purchase. |\n | `car_rental` | Object containing information about a car rental booking associated with the order. |\n | `crypto` | Object containing information about crypto transactions associated with the order. |\n | `marketplace` | This object is required by Mastercard and Visa for merchants operating as marketplaces under the **Merchant Category Code (MCC):** `5262`. The marketplace object ensures compliance with the card schemes' regulations by providing detailed information about the subseller involved in the transaction. |\n | `event` | Object containing information about event ticket bookings associated with the order. |\n | `lodging` | Object containing information about lodging bookings associated with the order. |","descriptionNode":"$L1d5e"},"booking_id":{"type":"string","description":"A unique identifier provided by the merchant associated with the order. \n\nThis `booking_id` is used to reference and correlate booking information with the Merchant API and the merchant's internal system.","descriptionNode":"$L1d5f"},"events":{"type":"array","description":"A list of events associated with the booking.","items":{"type":"object","description":"Object containing booking information about a specific event. ","properties":{"start_date":{"type":"string","format":"date-time","description":"[ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time when the event starts.","descriptionNode":"$L1d60"},"end_date":{"type":"string","format":"date-time","description":"[ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time when the event ends.","descriptionNode":"$L1d61"},"supplier":{"type":"string","description":"Legal name of the ticket vendor/event organiser.","descriptionNode":"$L1d62"},"supplier_payment_date":{"type":"string","format":"date-time","description":"[ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time when the funds are released to merchants.","descriptionNode":"$L1d63"},"name":{"type":"string","description":"The name of the event.","descriptionNode":"$L1d64"},"location":{"type":"object","description":"The address of the event location.","properties":{"street_line_1":{"type":"string","description":"Primary address line.","maxLength":100,"descriptionNode":"$L1d65"},"street_line_2":{"type":"string","description":"Secondary address line, such as floor and apartment number.","maxLength":100,"descriptionNode":"$L1d66"},"region":{"type":"string","description":"State or province of the address.","maxLength":100,"descriptionNode":"$L1d67"},"city":{"type":"string","description":"City of the address.","maxLength":100,"descriptionNode":"$L1d68"},"country_code":{"type":"string","pattern":"^[A-Z]{2}$","description":"ISO 2-letter country code.","minLength":2,"maxLength":2,"descriptionNode":"$L1d69"},"postcode":{"type":"string","description":"Postal code of the address.","maxLength":100,"descriptionNode":"$L1d6a"}},"required":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:4:properties:events:items:properties:location:required","descriptionNode":"$L1d6b"},"category":{"type":"string","enum":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:4:properties:events:items:properties:category:enum","description":"The type of the event.","descriptionNode":"$L1d6c"},"market":{"type":"string","enum":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:4:properties:events:items:properties:market:enum","description":"Indicates the relationship between the ticket vendor and the event organiser. \n\n| Parameter value | Description |\n| --------------- | ----------- |\n| `primary` | The merchant is the organiser and primary distributor of the tickets. |\n| `secondary` | The merchant is a reseller, only distributing the tickets. |","descriptionNode":"$L1d6d"},"tickets":{"type":"array","items":{"type":"object","description":"Object containing information about a ticket associated with the booking.","properties":{"id":{"type":"string","description":"A unique identifier provided by the merchant associated with the ticket.","descriptionNode":"$L1d6e"},"transferable":{"type":"boolean","description":"Indicates whether the ticket is transferable to another buyer.","descriptionNode":"$L1d6f"},"refundability":{"type":"string","enum":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:0:properties:refundability:enum","description":"Parameter indicating whether the booking is refundable, partially refundable, or not refundable.","descriptionNode":"$L1d70"}},"required":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:4:properties:events:items:properties:tickets:items:required","descriptionNode":"$L1d71"},"description":"A list of tickets associated with the booking.","descriptionNode":"$L1d72"}},"descriptionNode":"$L1d73"},"descriptionNode":"$L1d74"}},"required":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:4:required","descriptionNode":"$L1d75"},{"type":"object","description":"Object containing details of a lodging booking.\n\n:::info\nThese are the specific data field requirements for merchants who must provide lodging data. Note that these requirements can be extended on a case by case basis as decided by Revolut.\n\n```\nbooking_id\ncheck_in_date\ncheck_out_date\nsupplier_payment_date\n```\n:::","properties":{"type":{"type":"string","enum":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:0:properties:type:enum","description":"Type of the industry-specific data object, determining what additional data is expected.\n\nAvailable types:\n\n | Object type | Description |\n | ------------- | ----------- |\n | `airline` | Object containing information about a specific airline ticket purchase. |\n | `car_rental` | Object containing information about a car rental booking associated with the order. |\n | `crypto` | Object containing information about crypto transactions associated with the order. |\n | `marketplace` | This object is required by Mastercard and Visa for merchants operating as marketplaces under the **Merchant Category Code (MCC):** `5262`. The marketplace object ensures compliance with the card schemes' regulations by providing detailed information about the subseller involved in the transaction. |\n | `event` | Object containing information about event ticket bookings associated with the order. |\n | `lodging` | Object containing information about lodging bookings associated with the order. |","descriptionNode":"$L1d76"},"booking_id":{"type":"string","description":"A unique identifier provided by the merchant associated with the order. \n\nThis `booking_id` is used to reference and correlate booking information with the Merchant API and the merchant's internal system.","descriptionNode":"$L1d77"},"check_in_date":{"type":"string","format":"date-time","description":"[ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time of the check-in.","descriptionNode":"$L1d78"},"check_out_date":{"type":"string","format":"date-time","description":"[ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time of the check-out.","descriptionNode":"$L1d79"},"supplier_payment_date":{"type":"string","format":"date-time","description":"[ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time when the funds are released to merchants.","descriptionNode":"$L1d7a"},"category":{"type":"string","enum":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:5:properties:category:enum","description":"The type of the accommodation associated with the booking.","descriptionNode":"$L1d7b"},"booking_type":{"type":"string","enum":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:5:properties:booking_type:enum","description":"Indicates whether the booking terms are fixed or flexible.\n\n| Parameter value | Description |\n| --------------- | ----------- |\n| `fixed` | Non-modifiable once confirmed. |\n| `flexible` | Allows modifications or cancellations under specified conditions. |","descriptionNode":"$L1d7c"},"refundability":{"type":"string","enum":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:0:properties:refundability:enum","description":"Parameter indicating whether the booking is refundable, partially refundable, or not refundable.","descriptionNode":"$L1d7d"},"location":{"type":"object","description":"Address of the accommodation.","properties":{"street_line_1":{"type":"string","description":"Primary address line.","maxLength":100,"descriptionNode":"$L1d7e"},"street_line_2":{"type":"string","description":"Secondary address line, such as floor and apartment number.","maxLength":100,"descriptionNode":"$L1d7f"},"region":{"type":"string","description":"State or province of the address.","maxLength":100,"descriptionNode":"$L1d80"},"city":{"type":"string","description":"City of the address.","maxLength":100,"descriptionNode":"$L1d81"},"country_code":{"type":"string","pattern":"^[A-Z]{2}$","description":"ISO 2-letter country code.","minLength":2,"maxLength":2,"descriptionNode":"$L1d82"},"postcode":{"type":"string","description":"Postal code of the address.","maxLength":100,"descriptionNode":"$L1d83"}},"required":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:5:properties:location:required","descriptionNode":"$L1d84"},"guests":{"type":"array","items":{"type":"object","properties":{"first_name":{"type":"string","description":"Guest's first name.","descriptionNode":"$L1d85"},"last_name":{"type":"string","description":"Guest's last name.","descriptionNode":"$L1d86"}},"required":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:5:properties:guests:items:required"},"description":"List of guests associated with the booking.","descriptionNode":"$L1d87"}},"required":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:5:required","descriptionNode":"$L1d88"}],"descriptionNode":"$L1d89"},"merchant_order_data":{"type":"object","description":"Object for providing additional information stored in the merchant's order management system. ","properties":{"url":{"type":"string","format":"uri","pattern":"^https?:\\/{2}.+/gi","maxLength":2000,"description":"The URL of the order stored in the merchant's order management system.\n\nThis URL will be included in the order confirmation email for payments made via Revolut Pay. If specified, this URL will override the default link to the merchant's **Business website** configured in the Revolut Business account.\n\n:::warning\nRestrictions:\n- Must be a valid URI as defined by [RFC 3986](https://datatracker.ietf.org/doc/html/rfc3986)\n- URI scheme is required and must be either `http` or `https`\n- URI host is required and cannot be `localhost` or an IP address\n- Max length: `2000`\n- Reserved or invalid characters must be percent-encoded (for example, use `%20` instead of a space)\n:::","descriptionNode":"$L1d8a"},"reference":{"type":"string","description":"Merchant order ID for external reference.\n\nUse this field to set the ID that your own system can use to easily track orders.","descriptionNode":"$L1d8b"}},"descriptionNode":"$L1d8c"},"upcoming_payment_data":{"type":"object","description":"Object containing information about upcoming payments associated with the order.","properties":{"date":{"type":"string","format":"date-time","description":"The date and time in [ISO 8601 format](https://en.wikipedia.org/wiki/ISO_8601) when the upcoming payment is scheduled to be executed.","descriptionNode":"$L1d8d"},"payment_method_id":{"type":"string","description":"The unique ID of the customer's payment method used to complete the scheduled payment.\n\n:::info\nFor more information about operations related to customer's payment methods, see:\n - [Retrieve payment method list of a customer](https://developer.revolut.com/docs/api/merchant#retrieve-payment-method-list)\n - [Retrieve a customer's payment method](https://developer.revolut.com/docs/api/merchant#retrieve-payment-method)\n - [Update a customer's payment method](https://developer.revolut.com/docs/api/merchant#update-payment-method)\n - [Delete a customer's payment method](https://developer.revolut.com/docs/api/merchant#delete-payment-method)\n:::","descriptionNode":"$L1d8e"}},"required":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:upcoming_payment_data:required","descriptionNode":"$L1d8f"},"checkout_url":{"type":"string","description":"Link to a checkout page hosted by Revolut.","format":"uri","descriptionNode":"$L1d90"},"redirect_url":{"type":"string","format":"uri","pattern":"^https?:\\/{2}.+/gi","maxLength":2000,"description":"The URL your customer will be redirected to after a successful payment on the hosted checkout page (`checkout_url` parameter's value of the order).\n\n:::warning\nRestrictions:\n- Must be a valid URI as defined by [RFC 3986](https://datatracker.ietf.org/doc/html/rfc3986)\n- URI scheme is required and must be either `http` or `https`\n- URI host is required and cannot be `localhost` or an IP address\n- Max length: `2000`\n- Reserved or invalid characters must be percent-encoded (for example, use `%20` instead of a space)\n:::\n\n:::info\nFor more information on how to use the `redirect_url`, see: [Custom redirection via the API](https://developer.revolut.com/docs/guides/merchant/accept-payments/online-payments/hosted-checkout-page/api#custom-post-payment-redirection-optional)\n:::","descriptionNode":"$L1d91"},"shipping":{"type":"object","description":"Details about the shipping related to the order, including address, contact information, and individual shipments.\n\n:::info\nRequired for merchants shipping physical goods. Omitting this information may trigger additional scrutiny and risk mitigation actions by Revolut.\n:::","properties":{"address":{"type":"object","description":"Details of a physical address.","properties":{"street_line_1":{"type":"string","description":"Primary address line.","maxLength":100,"descriptionNode":"$L1d92"},"street_line_2":{"type":"string","description":"Secondary address line, such as floor and apartment number.","maxLength":100,"descriptionNode":"$L1d93"},"region":{"type":"string","description":"State or province of the address.","maxLength":100,"descriptionNode":"$L1d94"},"city":{"type":"string","description":"City of the address.","maxLength":100,"descriptionNode":"$L1d95"},"country_code":{"type":"string","pattern":"^[A-Z]{2}$","description":"ISO 2-letter country code.","minLength":2,"maxLength":2,"descriptionNode":"$L1d96"},"postcode":{"type":"string","description":"Postal code of the address.","maxLength":100,"descriptionNode":"$L1d97"}},"required":"$60:props:children:0:props:children:props:responses:200:content:application/json:schema:oneOf:1:properties:details:properties:address:required","descriptionNode":"$L1d98"},"contact":{"type":"object","description":"Contact details for someone responsible for the shipment.\n\n:::warning\nAt least `email` or `phone` is required.\n:::","properties":{"name":{"type":"string","description":"Full name of the contact person.","maxLength":250,"descriptionNode":"$L1d99"},"email":{"type":"string","format":"email","description":"Email address of the contact person.","descriptionNode":"$L1d9a"},"phone":{"type":"string","description":"Phone number of the contact person.","descriptionNode":"$L1d9b"}},"descriptionNode":"$L1d9c"},"shipments":{"type":"array","description":"List of individual shipment details.","maxItems":50,"items":{"type":"object","description":"Details of an individual shipment.","properties":{"shipping_company_name":{"type":"string","maxLength":250,"description":"Name of the company handling the shipment.","descriptionNode":"$L1d9d"},"tracking_number":{"type":"string","maxLength":500,"description":"Unique tracking number for the shipment.","descriptionNode":"$L1d9e"},"estimated_delivery_date":{"type":"string","format":"date-time","description":"Estimated delivery date and time for the shipment. \nThe time should also include the customer's timezone.","descriptionNode":"$L1d9f"},"tracking_url":{"type":"string","format":"uri","pattern":"^https?:\\/{2}.+/gi","maxLength":2000,"description":"An HTTP/HTTPS URL where the shipment can be tracked.\n\n:::warning\nRestrictions:\n- Must be a valid URI as defined by [RFC 3986](https://datatracker.ietf.org/doc/html/rfc3986)\n- URI scheme is required and must be either `http` or `https`\n- URI host is required and cannot be `localhost` or an IP address\n- Max length: `2000`\n- Reserved or invalid characters must be percent-encoded (for example, use `%20` instead of a space)\n:::","descriptionNode":"$L1da0"}},"required":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:shipping:properties:shipments:items:required","descriptionNode":"$L1da1"},"descriptionNode":"$L1da2"}},"descriptionNode":"$L1da3"},"enforce_challenge":{"type":"string","description":"The enforce challenge mode. `automatic` is used by default.\n\n| Parameter value | Description |\n| --------------- | ----------- |\n| `automatic` | The payments created for an order will have challenge requirement calculated by our fraud mechanisms. Not all payments will trigger a 3DS challenge. |\n| `forced` | The payments created for an order will always require a 3DS challenge. Currently only supported for card payments. |","default":"automatic","enum":"$19:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:orders:items:properties:enforce_challenge:enum","descriptionNode":"$L1da4"},"line_items":{"type":"array","maxItems":250,"description":"An array of line items included in the order. Each line item represents an individual product or service, along with its quantity, price, taxes, and discounts.\n\n:::info\nRequired for merchants collecting payment for one or multiple products/services in one transaction. Omitting this information may trigger additional scrutiny and risk mitigation actions by Revolut.\n:::","items":{"type":"object","properties":{"name":"$18:props:children:0:props:children:props:responses:201:content:application/json:schema:properties:incremental_authorisations:items:properties:line_items:items:properties:name","type":"$18:props:children:0:props:children:props:responses:201:content:application/json:schema:properties:incremental_authorisations:items:properties:line_items:items:properties:type","quantity":"$18:props:children:0:props:children:props:responses:201:content:application/json:schema:properties:incremental_authorisations:items:properties:line_items:items:properties:quantity","unit_price_amount":"$18:props:children:0:props:children:props:responses:201:content:application/json:schema:properties:incremental_authorisations:items:properties:line_items:items:properties:unit_price_amount","total_amount":"$18:props:children:0:props:children:props:responses:201:content:application/json:schema:properties:incremental_authorisations:items:properties:line_items:items:properties:total_amount","external_id":"$18:props:children:0:props:children:props:responses:201:content:application/json:schema:properties:incremental_authorisations:items:properties:line_items:items:properties:external_id","discounts":"$18:props:children:0:props:children:props:responses:201:content:application/json:schema:properties:incremental_authorisations:items:properties:line_items:items:properties:discounts","taxes":"$18:props:children:0:props:children:props:responses:201:content:application/json:schema:properties:incremental_authorisations:items:properties:line_items:items:properties:taxes","image_urls":"$18:props:children:0:props:children:props:responses:201:content:application/json:schema:properties:incremental_authorisations:items:properties:line_items:items:properties:image_urls","description":"$18:props:children:0:props:children:props:responses:201:content:application/json:schema:properties:incremental_authorisations:items:properties:line_items:items:properties:description","url":"$18:props:children:0:props:children:props:responses:201:content:application/json:schema:properties:incremental_authorisations:items:properties:line_items:items:properties:url"},"required":"$19:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:orders:items:properties:line_items:items:required"},"descriptionNode":"$L1da5"},"statement_descriptor_suffix":{"type":"string","description":"$1da6","minLength":1,"maxLength":19,"pattern":"^[^*\\n\\r\\\\]+$","descriptionNode":"$L1da7"},"related_order_id":{"type":"string","format":"uuid","description":"The unique ID of the original order that was refunded and this refund is associated with. You can use this ID to get more information about the related order using the [Retrieve an order](https://developer.revolut.com/docs/api/merchant#retrieve-order) operation.\n\n:::note\nThis field is only returned for orders with `type: refund`.\n:::","descriptionNode":"$L1da8"},"subscription_data":{"title":"Subscription data","type":"object","required":"$19:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:orders:items:properties:subscription_data:required","description":"Subscription details linked to the order. Use this object to match an order with its underlying subscription and understand the billing context in which the order was created.\n\nOnly present on orders created by a subscription.","properties":{"subscription_id":{"type":"string","format":"uuid","description":"Unique identifier for the subscription.","descriptionNode":"$L1da9"},"active_cycle_id":{"type":"string","format":"uuid","description":"The unique identifier of the active (pre-paid) subscription cycle that this order collects payment for.\n\nThis is the current billing cycle whose recurring charges are being collected in advance by this order. For example, if a subscription cycle covers 1-31 July and the order is generated on 1 July, this field identifies that July cycle.","descriptionNode":"$L1daa"},"settled_cycle_id":{"type":"string","format":"uuid","description":"The unique identifier of the settled (post-paid) subscription cycle whose usage-based charges this order collects.\n\nThis is the previous billing cycle whose usage is being settled by this order. For example, if a subscription cycle covers usage from 1-30 June and the order is generated on 10 July, this field identifies that June cycle.","descriptionNode":"$L1dab"},"billing_reason":{"type":"string","enum":"$19:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:orders:items:properties:subscription_data:properties:billing_reason:enum","description":"The reason this subscription order was created.\n\n| Value | Description |\n| ----- | ----------- |\n| `cycle_billing` | The order was automatically generated to collect payment for an ongoing subscription cycle. `active_cycle_id` is present; `settled_cycle_id` is present if the previous cycle included usage-based products. |\n| `final_settlement` | The order was automatically generated after the subscription ended to collect outstanding usage-based charges. `active_cycle_id` is absent; `settled_cycle_id` is present. |\n| `setup_intent` | The order was manually created by the merchant or customer to update the payment method on file. `active_cycle_id` is absent; `settled_cycle_id` is absent. |","descriptionNode":"$L1dac"}},"descriptionNode":"$L1dad"}},"descriptionNode":"$L1dae"},"examples":{"example_order_min_params":{"summary":"Example order response with minimal required parameters","value":"$1a:props:children:0:props:children:props:responses:200:content:application/json:examples:example_order_min_params:value"},"example_order_additional":{"summary":"Example order response with additional parameters","value":"$1a:props:children:0:props:children:props:responses:200:content:application/json:examples:example_order_additional:value"},"example_order_pre_auth":{"summary":"Example order response with pre-authorisation and card payment","value":"$1a:props:children:0:props:children:props:responses:200:content:application/json:examples:example_order_pre_auth:value"},"example_order_line_items":{"description":"Example order response with line items","value":"$1a:props:children:0:props:children:props:responses:200:content:application/json:examples:example_order_line_items:value"},"example_order_shipping":{"summary":"Example order response with shipping details","value":"$1a:props:children:0:props:children:props:responses:200:content:application/json:examples:example_order_shipping:value"},"example_order_airline":{"summary":"Example order response with additional airline data","value":"$1a:props:children:0:props:children:props:responses:200:content:application/json:examples:example_order_airline:value"},"example_order_car_rental":{"summary":"Example order response with additional car rental data","value":"$1a:props:children:0:props:children:props:responses:200:content:application/json:examples:example_order_car_rental:value"},"example_order_crypto":{"summary":"Example order response with additional crypto transaction data","value":"$1a:props:children:0:props:children:props:responses:200:content:application/json:examples:example_order_crypto:value"},"example_order_marketplace":{"summary":"Example order response with additional marketplace data","value":"$1a:props:children:0:props:children:props:responses:200:content:application/json:examples:example_order_marketplace:value"},"example_order_event":{"summary":"Example order response with additional event data","value":"$1a:props:children:0:props:children:props:responses:200:content:application/json:examples:example_order_event:value"},"example_order_lodging":{"summary":"Example order response with additional lodging data","value":"$1a:props:children:0:props:children:props:responses:200:content:application/json:examples:example_order_lodging:value"}}}},"descriptionNode":"$L1daf"},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"code":{"type":"string","description":"An identifier that can be used to determine what went wrong.\n\nError codes are not globally unique, but uniqueness is guaranteed within endpoints.","descriptionNode":"$L1db0"},"message":{"type":"string","description":"Some human readable text describing what went wrong.","descriptionNode":"$L1db1"},"timestamp":{"type":"integer","description":"The [UNIX timestamp](https://www.unixtimestamp.com/) of the date and time the error happened.","descriptionNode":"$L1db2"}}},"examples":{"default":{"value":{"code":"bad_request","message":"Could not parse JSON","timestamp":1721049596461}}}}},"headers":{},"descriptionNode":"$L1db3"},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"code":{"type":"string","description":"An identifier that can be used to determine what went wrong.\n\nError codes are not globally unique, but uniqueness is guaranteed within endpoints.","descriptionNode":"$L1db4"},"message":{"type":"string","description":"Some human readable text describing what went wrong.","descriptionNode":"$L1db5"},"timestamp":{"type":"integer","description":"The [UNIX timestamp](https://www.unixtimestamp.com/) of the date and time the error happened.","descriptionNode":"$L1db6"}}},"examples":{"default":{"value":{"code":"unauthenticated","message":"Authentication failed","timestamp":1721049596461}}}}},"descriptionNode":"$L1db7"},"404":{"description":"Not Found","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"code":{"type":"string","description":"An identifier that can be used to determine what went wrong.\n\nError codes are not globally unique, but uniqueness is guaranteed within endpoints.","descriptionNode":"$L1db8"},"message":{"type":"string","description":"Some human readable text describing what went wrong.","descriptionNode":"$L1db9"},"timestamp":{"type":"integer","description":"The [UNIX timestamp](https://www.unixtimestamp.com/) of the date and time the error happened.","descriptionNode":"$L1dba"}}}}},"descriptionNode":"$L1dbb"}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","description":"Object schema containing information about order creation body request parameters.","properties":{"amount":{"type":"integer","description":"The order total expressed in minor currency units, according to the [ISO 4217 standard](https://en.wikipedia.org/wiki/ISO_4217). For example, `7034` in `EUR` corresponds to €70.34.\n\n:::info\n- Conversion between major and minor units varies by currency. For instance, `100` minor units equal £1.00 in `GBP`, whereas in `ISK` they represent 100 units. For more details, see the [ISO 4217 standard](https://en.wikipedia.org/wiki/ISO_4217).\n- If `line_items` are provided, the order `amount` must equal the sum of all line items' `total_amount`.\n- For card payments with a non-zero amount, the order `amount` must be at least **$0.005** (or equivalent in different currencies, calculated using Revolut's exchange rate on the payment date). Otherwise, card payments can't be performed.\n:::","descriptionNode":"$L1dbc"},"currency":{"type":"string","format":"ISO 4217","minLength":3,"maxLength":3,"description":"[ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) currency code in upper case.\n\n:::info\nFor more information about the supported currencies, see: [Help Center](https://help.revolut.com/business/help/merchant-accounts/payments/in-which-currencies-can-i-accept-payments/).\n:::","descriptionNode":"$L1dbd"},"settlement_currency":{"type":"string","description":"[ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) currency code in upper case. \n\nIf `settlement_currency` is different from the value of `currency`, the money will be exchanged when the amount is settled to your merchant account. In case of a refund or chargeback, the money will be exchanged to the order's initial `currency`.\n\nIf `settlement_currency` is not specified, this value is taken from `currency`.\n\n:::info\nFor more information about the supported currencies, see: [Help Center](https://help.revolut.com/business/help/merchant-accounts/payments/in-which-currencies-can-i-accept-payments/).\n:::","descriptionNode":"$L1dbe"},"description":{"type":"string","description":"The description of the order.","descriptionNode":"$L1dbf"},"customer":{"type":"object","description":"$1dc0","properties":{"id":{"type":"string","format":"uuid","description":"Permanent ID of a customer used to retrieve, update, delete a customer. This ID can also be used to link customer to an order.\n\n:::note\nIf you provide the customer's ID during order creation, no other customer data is required, they will be parsed automatically from the referenced customer object.\n:::","descriptionNode":"$L1dc1"},"full_name":{"type":"string","description":"The full name of the customer.","descriptionNode":"$L1dc2"},"phone":{"type":"string","description":"The phone number of the customer in [E.164 format](https://en.wikipedia.org/wiki/E.164).","descriptionNode":"$L1dc3"},"email":{"type":"string","format":"email","description":"The email address of the customer.","descriptionNode":"$L1dc4"},"date_of_birth":{"type":"string","format":"date","description":"The birth date of the customer.","descriptionNode":"$L1dc5"}},"descriptionNode":"$L1dc6"},"enforce_challenge":{"type":"string","description":"The enforce challenge mode. `automatic` is used by default.\n\n| Parameter value | Description |\n| --------------- | ----------- |\n| `automatic` | The payments created for an order will have challenge requirement calculated by our fraud mechanisms. Not all payments will trigger a 3DS challenge. |\n| `forced` | The payments created for an order will always require a 3DS challenge. Currently only supported for card payments. |","default":"automatic","enum":"$19:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:orders:items:properties:enforce_challenge:enum","descriptionNode":"$L1dc7"},"line_items":{"type":"array","maxItems":250,"description":"An array of line items included in the order. Each line item represents an individual product or service, along with its quantity, price, taxes, and discounts.\n\n:::info\nRequired for merchants collecting payment for one or multiple products/services in one transaction. Omitting this information may trigger additional scrutiny and risk mitigation actions by Revolut.\n:::","items":{"type":"object","properties":{"name":{"type":"string","maxLength":250,"description":"Name of the line item.","descriptionNode":"$L1dc8"},"type":{"type":"string","enum":"$19:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:orders:items:properties:line_items:items:properties:type:enum","description":"Type of the line item.","descriptionNode":"$L1dc9"},"quantity":{"type":"object","description":"Object representing the quantity details of a line item, including the amount and its associated unit of measurement.","properties":{"value":{"type":"number","format":"double","minimum":0,"description":"The number of units of the line item.","descriptionNode":"$L1dca"},"unit":{"type":"string","maxLength":100,"description":"The measurement unit for the quantity, such as `cm`, or `kg`.","descriptionNode":"$L1dcb"}},"required":"$19:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:orders:items:properties:line_items:items:properties:quantity:required","descriptionNode":"$L1dcc"},"unit_price_amount":{"type":"integer","format":"int64","minimum":0,"description":"The unit price of the line item.","descriptionNode":"$L1dcd"},"total_amount":{"type":"integer","format":"int64","description":"The total amount to be paid for the line item, including taxes and discounts.","descriptionNode":"$L1dce"},"external_id":{"type":"string","maxLength":250,"description":"Unique identifier of line item in the merchant's system.","descriptionNode":"$L1dcf"},"discounts":{"type":"array","maxItems":50,"description":"A list of discounts applied to the line item. Each discount should be subtracted from the total amount payable for the item.","items":{"type":"object","description":"Details of a discount applied to the line item, including its name and monetary value.","properties":{"name":{"type":"string","maxLength":100,"description":"The specific name or label of the discount applied to the line item.","descriptionNode":"$L1dd0"},"amount":{"type":"integer","format":"int64","minimum":0,"description":"The monetary value of the discount. ","descriptionNode":"$L1dd1"}},"required":"$19:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:orders:items:properties:line_items:items:properties:discounts:items:required","descriptionNode":"$L1dd2"},"descriptionNode":"$L1dd3"},"taxes":{"type":"array","maxItems":50,"description":"A list of taxes applied to the line item. Each tax should be added to the total amount payable for the item.","items":{"type":"object","description":"Details about a tax applied to the line item, including its name and the corresponding amount.","properties":{"name":{"type":"string","description":"The specific name or designation of the tax applied to the line item.","maxLength":100,"descriptionNode":"$L1dd4"},"amount":{"type":"integer","format":"int64","description":"The monetary value of the tax in minor currency units (e.g., cents for EUR).","minimum":0,"descriptionNode":"$L1dd5"}},"required":"$19:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:orders:items:properties:line_items:items:properties:taxes:items:required","descriptionNode":"$L1dd6"},"descriptionNode":"$L1dd7"},"image_urls":{"type":"array","maxItems":50,"description":"A list of URLs pointing to images related to the line item. These images can provide visual details or representations of the item.","items":{"type":"string","format":"uri","pattern":"^https?:\\/{2}.+/gi","maxLength":2000,"description":"URL to an image associated with the line item.\n\n:::warning\nRestrictions:\n- Must be a valid URI as defined by [RFC 3986](https://datatracker.ietf.org/doc/html/rfc3986)\n- URI scheme is required and must be either `http` or `https`\n- URI host is required and cannot be `localhost` or an IP address\n- Max length: `2000`\n- Reserved or invalid characters must be percent-encoded (for example, use `%20` instead of a space)\n:::","descriptionNode":"$L1dd8"},"descriptionNode":"$L1dd9"},"description":{"type":"string","maxLength":1024,"description":"Description of the line item.","descriptionNode":"$L1dda"},"url":{"type":"string","format":"uri","pattern":"^https?:\\/{2}.+/gi","maxLength":2000,"description":"An HTTP/HTTPS URL that links to more information about the line item, such as a product page or details.\n\n:::warning\nRestrictions:\n- Must be a valid URI as defined by [RFC 3986](https://datatracker.ietf.org/doc/html/rfc3986)\n- URI scheme is required and must be either `http` or `https`\n- URI host is required and cannot be `localhost` or an IP address\n- Max length: `2000`\n- Reserved or invalid characters must be percent-encoded (for example, use `%20` instead of a space)\n:::","descriptionNode":"$L1ddb"}},"required":"$19:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:orders:items:properties:line_items:items:required"},"descriptionNode":"$L1ddc"},"shipping":{"type":"object","description":"Details about the shipping related to the order, including address, contact information, and individual shipments.\n\n:::info\nRequired for merchants shipping physical goods. Omitting this information may trigger additional scrutiny and risk mitigation actions by Revolut.\n:::","properties":{"address":{"type":"object","description":"Details of a physical address.","properties":{"street_line_1":{"type":"string","description":"Primary address line.","maxLength":100,"descriptionNode":"$L1ddd"},"street_line_2":{"type":"string","description":"Secondary address line, such as floor and apartment number.","maxLength":100,"descriptionNode":"$L1dde"},"region":{"type":"string","description":"State or province of the address.","maxLength":100,"descriptionNode":"$L1ddf"},"city":{"type":"string","description":"City of the address.","maxLength":100,"descriptionNode":"$L1de0"},"country_code":{"type":"string","pattern":"^[A-Z]{2}$","description":"ISO 2-letter country code.","minLength":2,"maxLength":2,"descriptionNode":"$L1de1"},"postcode":{"type":"string","description":"Postal code of the address.","maxLength":100,"descriptionNode":"$L1de2"}},"required":"$60:props:children:0:props:children:props:responses:200:content:application/json:schema:oneOf:1:properties:details:properties:address:required","descriptionNode":"$L1de3"},"contact":{"type":"object","description":"Contact details for someone responsible for the shipment.\n\n:::warning\nAt least `email` or `phone` is required.\n:::","properties":{"name":{"type":"string","description":"Full name of the contact person.","maxLength":250,"descriptionNode":"$L1de4"},"email":{"type":"string","format":"email","description":"Email address of the contact person.","descriptionNode":"$L1de5"},"phone":{"type":"string","description":"Phone number of the contact person.","descriptionNode":"$L1de6"}},"descriptionNode":"$L1de7"},"shipments":{"type":"array","description":"List of individual shipment details.","maxItems":50,"items":{"type":"object","description":"Details of an individual shipment.","properties":{"shipping_company_name":{"type":"string","maxLength":250,"description":"Name of the company handling the shipment.","descriptionNode":"$L1de8"},"tracking_number":{"type":"string","maxLength":500,"description":"Unique tracking number for the shipment.","descriptionNode":"$L1de9"},"estimated_delivery_date":{"type":"string","format":"date-time","description":"Estimated delivery date and time for the shipment. \nThe time should also include the customer's timezone.","descriptionNode":"$L1dea"},"tracking_url":{"type":"string","format":"uri","pattern":"^https?:\\/{2}.+/gi","maxLength":2000,"description":"An HTTP/HTTPS URL where the shipment can be tracked.\n\n:::warning\nRestrictions:\n- Must be a valid URI as defined by [RFC 3986](https://datatracker.ietf.org/doc/html/rfc3986)\n- URI scheme is required and must be either `http` or `https`\n- URI host is required and cannot be `localhost` or an IP address\n- Max length: `2000`\n- Reserved or invalid characters must be percent-encoded (for example, use `%20` instead of a space)\n:::","descriptionNode":"$L1deb"}},"required":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:shipping:properties:shipments:items:required","descriptionNode":"$L1dec"},"descriptionNode":"$L1ded"}},"descriptionNode":"$L1dee"},"capture_mode":{"type":"string","description":"The capture mode of the order. `automatic` is used by default.\n\n| Parameter value | Description |\n| --------------- | ----------- |\n| `automatic` | The order is captured automatically after payment authorisation. |\n| `manual` | The order is not captured automatically. You must manually capture the order later. |\n\n:::info\nFor more information, see [Capture an order](https://developer.revolut.com/docs/api/merchant#capture-order).\n:::","default":"automatic","enum":"$19:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:orders:items:properties:capture_mode:enum","descriptionNode":"$L1def"},"authorisation_type":{"type":"string","description":"The type of authorisation for the order. Used with manual capture mode. If omitted, `final` is used by default.\n\n### Pre-authorisation\n\nPre-authorisation allows you to reserve funds on a customer's card without immediately capturing them. This is useful for scenarios like:\n\n- Hotel bookings where the final amount may vary\n- Car rentals where additional charges may apply\n- Deposits that need to be held temporarily\n\n| Parameter value | Description |\n| --------------- | ----------- |\n| `final` | Standard authorisation for immediate or near-immediate capture. |\n| `pre_authorisation` | Reserve funds for later capture, used with manual capture mode. |\n\n:::note\nPre-authorisation must be used with `capture_mode: manual`. For more information, see [Capture an order](https://developer.revolut.com/docs/api/merchant#capture-order).\n:::","default":"final","enum":"$19:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:orders:items:properties:authorisation_type:enum","descriptionNode":"$L1df0"},"cancel_authorised_after":{"type":"string","format":"duration","description":"$1df1","descriptionNode":"$L1df2"},"expire_pending_after":{"type":"string","format":"duration","description":"Automatic expiration period for pending orders, specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format.\n\nOrders in `pending` state will be automatically failed if they stay unpaid for longer than the period specified.\n\nWhen the order expires, it transitions to the `failed` state and an `ORDER_FAILED` webhook event is triggered.\n\n:::note\n- This field can only be set during order creation and cannot be updated afterward.\n- Must be between `PT1M` (1 minute) and `PT720H` (30 days).\n- Cannot be a negative value.\n:::","examples":"$1b:props:children:0:props:children:props:requestBody:content:application/json:schema:properties:expire_pending_after:examples","descriptionNode":"$L1df3"},"location_id":{"type":"string","format":"uuid","description":"Unique ID representing the location where merchants sells products.\n\n:::info\nFor more information, see: [Locations](https://developer.revolut.com/docs/api/merchant#tag-locations).\n::: ","descriptionNode":"$L1df4"},"metadata":{"type":"object","description":"Additional information to track your orders in your system, by providing custom metadata using `\"\" : \"\"` pairs.\n\n:::warning\n**Restrictions:**\n\n- Both keys and values must be `string`s\n- Values cannot be `null`.\n- Max number of key-value pairs: `50`\n- Max length of values: `500` characters\n- Format of keys: Must start with a letter and contain only letters, digits, and underscores. Max 40 characters. Pattern: `^[a-zA-Z][a-zA-Z\\\\d_]{0,39}$`\n:::","maxProperties":50,"additionalProperties":{"type":"string","maxLength":500,"description":"Additional metadata value provided with the corresponding metadata key.","descriptionNode":"$L1df5"},"examples":"$19:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:orders:items:properties:metadata:examples","descriptionNode":"$L1df6"},"industry_data":{"type":"object","description":"Object containing industry-specific information associated with the order.\n\n:::info\nIn the following cases, industry-specific info is required. Omitting this information may trigger additional scrutiny and risk mitigation actions by the Revolut risk team.\n\n | Transaction type | Required for |\n | ---------------- | ----------- |\n | `airline` | Airlines and Online Travel Agencies (OTAs). |\n | `car_rental` | Car Rental Merchants and Online Travel Agencies (OTAs). |\n | `crypto` | Crypto merchants. |\n | `marketplace` | Marketplace merchants. |\n | `event` | Event ticket sellers. |\n | `lodging` | Lodging providers. |\n:::","discriminator":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:discriminator","oneOf":[{"type":"object","description":"$1df7","properties":{"type":{"type":"string","enum":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:0:properties:type:enum","description":"Type of the industry-specific data object, determining what additional data is expected.\n\nAvailable types:\n\n | Object type | Description |\n | ------------- | ----------- |\n | `airline` | Object containing information about a specific airline ticket purchase. |\n | `car_rental` | Object containing information about a car rental booking associated with the order. |\n | `crypto` | Object containing information about crypto transactions associated with the order. |\n | `marketplace` | This object is required by Mastercard and Visa for merchants operating as marketplaces under the **Merchant Category Code (MCC):** `5262`. The marketplace object ensures compliance with the card schemes' regulations by providing detailed information about the subseller involved in the transaction. |\n | `event` | Object containing information about event ticket bookings associated with the order. |\n | `lodging` | Object containing information about lodging bookings associated with the order. |","descriptionNode":"$L1df8"},"booking_id":{"type":"string","description":"A unique identifier provided by the merchant associated with the order. \n\nThis `booking_id` is used to reference and correlate booking information with the Merchant API and the merchant's internal system.","descriptionNode":"$L1df9"},"fulfillment_date":{"type":"string","format":"date-time","description":"The UTC date and time of the final journey leg.\n\n:::warning\nThe following limitations apply:\n - When creating or updating an order, `fulfillment_date` cannot be set to a date in the past.\n - When updating an order, if the current `fulfillment_date` value is already in the past, it cannot be modified. The date must remain as is to maintain data integrity for completed transactions.\n:::","descriptionNode":"$L1dfa"},"tickets_purchase":{"type":"boolean","description":"Flag indicating whether the order includes actual ticket purchases. Set to `true` if the order contains ticket purchases, and `false` if it does not (e.g., it **only** contains seat reservations, or baggage upgrades). \n\n:::info\nThis field is required for activating **Revolut Flight Alerts** functionalities within the Revolut app.\n\nProvide the info on order creation or update, before capturing the order.\n:::","descriptionNode":"$L1dfb"},"ticket_type":{"type":"string","enum":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:0:properties:ticket_type:enum","description":"The type of the ticket.\n\n| Parameter value | Description |\n| --------------- | ----------- |\n| `fixed` | Non-modifiable once confirmed. |\n| `flexible` | Allows modifications or cancellations under specified conditions. |","descriptionNode":"$L1dfc"},"crs_code":{"type":"string","maxLength":4,"description":"The code of the Computer Reservation System (CRS) used to make the booking and purchase the ticket.","descriptionNode":"$L1dfd"},"ticket_change_indicator":{"type":"string","enum":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:0:properties:ticket_change_indicator:enum","description":"Parameter indicating whether this order is related to a new ticket reservation or a modification of an existing one.","descriptionNode":"$L1dfe"},"refundability":{"type":"string","enum":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:0:properties:refundability:enum","description":"Parameter indicating whether the booking is refundable, partially refundable, or not refundable.","descriptionNode":"$L1dff"},"passengers":{"type":"array","description":"Array containing information of passengers associated with the booking.","items":{"type":"object","properties":{"first_name":{"type":"string","description":"Passenger's first name.","descriptionNode":"$L1e00"},"last_name":{"type":"string","description":"Passenger's last name.","descriptionNode":"$L1e01"}},"required":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:0:properties:passengers:items:required"},"descriptionNode":"$L1e02"},"journey_legs":{"type":"array","description":"Array containing information of journey legs associated with the booking.\n\n:::info\nThis field is required for activating **Revolut Flight Alerts** functionalities within the Revolut app. \n\nThis information is used to compile a tracking widget that provides real-time updates on flight status and sends notifications, such as a check-in reminders, boarding alerts, and notifications for cancellations or delays. \n\nTo enable the widget the following fields are required on order creation or update, before capturing the order:\n\n ```\n sequence,\n departure_airport_code,\n arrival_airport_code,\n flight_number,\n travel_date,\n airline_name,\n airline_code,\n ```\n:::","items":{"type":"object","properties":{"sequence":{"type":"integer","description":"Sequence of the journey legs. Increment by 1 for each flight included in the ticket.\n\nFor example: For a `FRA > LHR > DUB > LHR > FRA` journey the sequence will be assigned as:\n - `FRA > LHR`: 1\n - `LHR > DUB`: 2\n - `DUB > LHR`: 3\n - `LHR > FRA`: 4","descriptionNode":"$L1e03"},"departure_airport_code":{"type":"string","description":"The [IATA](https://www.iata.org/en/services/codes) 3-letter airport code for the departure airport.","descriptionNode":"$L1e04"},"arrival_airport_code":{"type":"string","description":"The [IATA](https://www.iata.org/en/services/codes) 3-letter airport code for the arrival airport.","descriptionNode":"$L1e05"},"flight_number":{"type":"string","description":"The flight identifier, without airline code.","descriptionNode":"$L1e06"},"fare_base_code":{"type":"string","description":"The fare base code for the given journey leg.","descriptionNode":"$L1e07"},"travel_date":{"type":"string","format":"date-time","description":"The UTC date and time of the flight departure for the given journey leg.","descriptionNode":"$L1e08"},"airline_name":{"type":"string","description":"The name of the airline associated with the journey leg.","descriptionNode":"$L1e09"},"airline_code":{"type":"string","description":"The IATA 2-letter accounting code identifying the airline associated with the journey leg.","descriptionNode":"$L1e0a"},"pnr":{"type":"string","format":"alphanumeric","pattern":"^[a-zA-Z0-9]*$","maxLength":20,"description":"The Passenger Name Record (PNR) for the journey leg issued by the airline. \n\nPNR is a unique identifier for the booking, acting as a digital certificate allowing passengers to retrieve or manage their booking details.\n\n:::warning\nThis is a required field for OTAs.\n:::","descriptionNode":"$L1e0b"}},"required":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:0:properties:journey_legs:items:required"},"descriptionNode":"$L1e0c"},"booking_url":{"type":"string","format":"uri","pattern":"^https?:\\/{2}.+/gi","maxLength":2000,"description":"URL to the online portal for managing the airline booking, which includes check-in functionality. This URL may be a personalised, pre-populated check-in link specific to the user or a generic link, and it is essential for enabling direct access to booking details within the Revolut app.\n\n:::info\nThis field is required for activating **Revolut Flight Alerts** functionalities within the Revolut app. \n\nProvide the info on order creation or update, before capturing the order.\n:::\n\n:::warning\nRestrictions:\n- Must be a valid URI as defined by [RFC 3986](https://datatracker.ietf.org/doc/html/rfc3986)\n- URI scheme is required and must be either `http` or `https`\n- URI host is required and cannot be `localhost` or an IP address\n- Max length: `2000`\n- Reserved or invalid characters must be percent-encoded (for example, use `%20` instead of a space)\n:::","descriptionNode":"$L1e0d"}},"required":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:0:required","descriptionNode":"$L1e0e"},{"type":"object","description":"Object containing additional information about a car rental booking associated with the order.\n\n:::info\nThese are the specific data field requirements for merchants offering car rental. Note that these requirements can be extended on a case by case basis as decided by Revolut.\n\n```\nbooking_id\ndrop_off_date\nrefundability\n```\n:::","properties":{"type":{"type":"string","enum":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:0:properties:type:enum","description":"Type of the industry-specific data object, determining what additional data is expected.\n\nAvailable types:\n\n | Object type | Description |\n | ------------- | ----------- |\n | `airline` | Object containing information about a specific airline ticket purchase. |\n | `car_rental` | Object containing information about a car rental booking associated with the order. |\n | `crypto` | Object containing information about crypto transactions associated with the order. |\n | `marketplace` | This object is required by Mastercard and Visa for merchants operating as marketplaces under the **Merchant Category Code (MCC):** `5262`. The marketplace object ensures compliance with the card schemes' regulations by providing detailed information about the subseller involved in the transaction. |\n | `event` | Object containing information about event ticket bookings associated with the order. |\n | `lodging` | Object containing information about lodging bookings associated with the order. |","descriptionNode":"$L1e0f"},"booking_id":{"type":"string","description":"A unique identifier provided by the merchant associated with the order. \n\nThis `booking_id` is used to reference and correlate booking information with the Merchant API and the merchant's internal system.","descriptionNode":"$L1e10"},"pick_up_date":{"type":"string","format":"date-time","description":"The UTC date and time of the pick-up.","descriptionNode":"$L1e11"},"pick_up_location":{"type":"object","description":"Object containing address details.","properties":{"street_line_1":{"type":"string","description":"Street line 1 information.","maxLength":100,"descriptionNode":"$L1e12"},"street_line_2":{"type":"string","description":"Street line 2 information.","maxLength":100,"descriptionNode":"$L1e13"},"region":{"type":"string","description":"The region associated with the address.","maxLength":100,"descriptionNode":"$L1e14"},"city":{"type":"string","description":"The city associated with the address.","maxLength":100,"descriptionNode":"$L1e15"},"country_code":{"type":"string","description":"The 2-letter country code of the country associated with the address.","maxLength":2,"descriptionNode":"$L1e16"},"postcode":{"type":"string","description":"The postcode associated with the address.","maxLength":100,"descriptionNode":"$L1e17"}},"required":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:billing_address:required","descriptionNode":"$L1e18"},"drop_off_date":{"type":"string","format":"date-time","description":"The UTC date and time of the drop-off.","descriptionNode":"$L1e19"},"drop_off_location":{"type":"object","description":"Object containing address details.","properties":{"street_line_1":"$18:props:children:0:props:children:props:requestBody:content:application/json:schema:properties:industry_data:oneOf:1:properties:pick_up_location:properties:street_line_1","street_line_2":"$18:props:children:0:props:children:props:requestBody:content:application/json:schema:properties:industry_data:oneOf:1:properties:pick_up_location:properties:street_line_2","region":"$18:props:children:0:props:children:props:requestBody:content:application/json:schema:properties:industry_data:oneOf:1:properties:pick_up_location:properties:region","city":"$18:props:children:0:props:children:props:requestBody:content:application/json:schema:properties:industry_data:oneOf:1:properties:pick_up_location:properties:city","country_code":"$18:props:children:0:props:children:props:requestBody:content:application/json:schema:properties:industry_data:oneOf:1:properties:pick_up_location:properties:country_code","postcode":"$18:props:children:0:props:children:props:requestBody:content:application/json:schema:properties:industry_data:oneOf:1:properties:pick_up_location:properties:postcode"},"required":"$2d:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:billing_address:required","descriptionNode":"$L1e1a"},"refundability":{"type":"string","enum":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:0:properties:refundability:enum","description":"Parameter indicating whether the booking is refundable, partially refundable, or not refundable.","descriptionNode":"$L1e1b"},"distance_limit":{"type":"object","description":"Object containing distance limit information.","properties":{"limit":{"type":"integer","description":"The maximum distance allowed.","descriptionNode":"$L1e1c"},"unit":{"type":"string","description":"The unit of distance.","enum":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:1:properties:distance_limit:properties:unit:enum","descriptionNode":"$L1e1d"},"additional_distance_cost":{"type":"object","description":"Cost for exceeding the distance limit.","properties":{"amount":{"type":"integer","description":"The amount of the cost in minor currency units. For example, enter `7034` for €70.34.","descriptionNode":"$L1e1e"},"currency":{"type":"string","format":"ISO 4217","minLength":3,"maxLength":3,"description":"[ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) currency code in upper case.\n\n:::info\nFor more information about the supported currencies, see: [Help Center](https://help.revolut.com/business/help/merchant-accounts/payments/in-which-currencies-can-i-accept-payments/).\n:::","descriptionNode":"$L1e1f"}},"descriptionNode":"$L1e20"}},"descriptionNode":"$L1e21"}},"required":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:1:required","descriptionNode":"$L1e22"},{"type":"object","description":"Object containing information about crypto transactions associated with the order.\n\n:::info\nProcessing crypto on-ramp transactions with Revolut has additional compliance requirements. Please reach out to your account executive for additional details.\n\n**Required data fields for crypto services:**\n\n```\ntransactions[].id\ntransactions[].status\ntransactions[].recipient_wallet_id\nseller.id\nseller.name\nseller.website\nseller.phone\nseller.address\nseller.mcc\ncustomer.full_name\ncustomer.date_of_birth\n```\n\nNote that these requirements can be extended on a case by case basis as decided by Revolut.\n:::","properties":{"type":{"type":"string","enum":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:0:properties:type:enum","description":"Type of the industry-specific data object, determining what additional data is expected.\n\nAvailable types:\n\n | Object type | Description |\n | ------------- | ----------- |\n | `airline` | Object containing information about a specific airline ticket purchase. |\n | `car_rental` | Object containing information about a car rental booking associated with the order. |\n | `crypto` | Object containing information about crypto transactions associated with the order. |\n | `marketplace` | This object is required by Mastercard and Visa for merchants operating as marketplaces under the **Merchant Category Code (MCC):** `5262`. The marketplace object ensures compliance with the card schemes' regulations by providing detailed information about the subseller involved in the transaction. |\n | `event` | Object containing information about event ticket bookings associated with the order. |\n | `lodging` | Object containing information about lodging bookings associated with the order. |","descriptionNode":"$L1e23"},"transactions":{"type":"array","description":"Array of crypto transaction data associated with the order.","items":{"type":"object","properties":{"id":{"type":"string","maxLength":255,"description":"The public transaction hash of the crypto transaction.","descriptionNode":"$L1e24"},"status":{"type":"string","enum":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:2:properties:transactions:items:properties:status:enum","description":"The status of the crypto transaction.","descriptionNode":"$L1e25"},"recipient_wallet_id":{"type":"string","maxLength":255,"description":"The wallet ID of the recipient.\n\n:::note\nAt least one of the parameters: `recipient_user_id` or `recipient_wallet_id` is required.\n::: ","descriptionNode":"$L1e26"},"recipient_user_id":{"type":"string","maxLength":255,"description":"The user ID of the recipient.\n\n:::note\nAt least one of the parameters: `recipient_user_id` or `recipient_wallet_id` is required.\n::: ","descriptionNode":"$L1e27"}},"required":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:2:properties:transactions:items:required"},"minItems":1,"descriptionNode":"$L1e28"},"seller":{"type":"object","description":"Information about the crypto conversion affiliate.\n\nThis should be provided when a customer completes a payment on a subseller's website rather than directly on the merchant's website, providing insight into the type of business conducted by the subseller.\n\n:::note\nThis needs to be provided only by crypto on-ramp providers for payments they are processing for conversion affiliates.\n\nFor their own payments, `seller` can be omitted.\n:::","properties":{"mcc":{"type":"string","description":"A string representing the four-digit [Merchant Category Code (MCC)](https://en.wikipedia.org/wiki/Merchant_category_code) of the conversion affiliate.","maxLength":4,"minLength":4,"pattern":"^\\d{4}$","descriptionNode":"$L1e29"},"id":{"type":"string","description":"The ID of the seller in the merchant's internal system.","minLength":1,"maxLength":15,"descriptionNode":"$L1e2a"},"name":{"type":"string","description":"The business or legal name of the seller.","minLength":1,"maxLength":50,"descriptionNode":"$L1e2b"},"website":{"type":"string","format":"uri","pattern":"^https?:\\/{2}.+/gi","maxLength":255,"description":"The URL of the website of the seller.\n\n:::warning\nRestrictions:\n- Must be a valid URI as defined by [RFC 3986](https://datatracker.ietf.org/doc/html/rfc3986)\n- URI scheme is required and must be either `http` or `https`\n- URI host is required and cannot be `localhost` or an IP address\n- Max length: `255`\n- Reserved or invalid characters must be percent-encoded (for example, use `%20` instead of a space)\n:::","descriptionNode":"$L1e2c"},"phone":{"type":"string","description":"The phone number of the seller.","descriptionNode":"$L1e2d"},"address":{"type":"object","description":"Details of a physical address.","properties":{"street_line_1":{"type":"string","description":"Primary address line.","maxLength":100,"descriptionNode":"$L1e2e"},"street_line_2":{"type":"string","description":"Secondary address line, such as floor and apartment number.","maxLength":100,"descriptionNode":"$L1e2f"},"region":{"type":"string","description":"State or province of the address.","maxLength":100,"descriptionNode":"$L1e30"},"city":{"type":"string","description":"City of the address.","maxLength":100,"descriptionNode":"$L1e31"},"country_code":{"type":"string","pattern":"^[A-Z]{2}$","description":"ISO 2-letter country code.","minLength":2,"maxLength":2,"descriptionNode":"$L1e32"},"country_subdivision_code":{"type":"string","pattern":"^[A-Z]{2}-[A-Z0-9]{1,3}$","description":"The subdivision code represents the state, province, or region within the country, following the [ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2) standard. This code uniquely identifies subdivisions within a country. \n\nFor example, for London in the United Kingdom, use `GB-LND`.\n\n:::warning\nThe parameter is required for countries listed on the [ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2) page.\n:::","minLength":5,"maxLength":6,"descriptionNode":"$L1e33"},"postcode":{"type":"string","description":"Postal code of the address.","maxLength":100,"descriptionNode":"$L1e34"}},"required":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:2:properties:seller:properties:address:required","descriptionNode":"$L1e35"}},"required":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:2:properties:seller:required","descriptionNode":"$L1e36"}},"required":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:2:required","descriptionNode":"$L1e37"},{"type":"object","description":"This object is required by Mastercard and Visa for merchants operating as marketplaces under the Merchant Category Code (MCC) `5262`. The marketplace object ensures compliance with the card schemes' regulations by providing detailed information about the seller involved in the transaction.\n\n:::info\nThese are the specific data field requirements for merchants who must provide marketplace data.\n\n```\nseller.id\nseller.name\nseller.website\nseller.phone\nseller.address\n```\n:::","properties":{"type":{"type":"string","enum":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:0:properties:type:enum","description":"Type of the industry-specific data object, determining what additional data is expected.\n\nAvailable types:\n\n | Object type | Description |\n | ------------- | ----------- |\n | `airline` | Object containing information about a specific airline ticket purchase. |\n | `car_rental` | Object containing information about a car rental booking associated with the order. |\n | `crypto` | Object containing information about crypto transactions associated with the order. |\n | `marketplace` | This object is required by Mastercard and Visa for merchants operating as marketplaces under the **Merchant Category Code (MCC):** `5262`. The marketplace object ensures compliance with the card schemes' regulations by providing detailed information about the subseller involved in the transaction. |\n | `event` | Object containing information about event ticket bookings associated with the order. |\n | `lodging` | Object containing information about lodging bookings associated with the order. |","descriptionNode":"$L1e38"},"seller":{"type":"object","description":"Information about the subseller on the marketplace platform.","properties":{"id":{"type":"string","description":"The ID of the seller in the merchant's internal system.","minLength":1,"maxLength":15,"descriptionNode":"$L1e39"},"name":{"type":"string","description":"The business or legal name of the seller.","minLength":1,"maxLength":50,"descriptionNode":"$L1e3a"},"website":{"type":"string","format":"uri","pattern":"^https?:\\/{2}.+/gi","maxLength":255,"description":"The URL of the website of the seller.\n\n:::warning\nRestrictions:\n- Must be a valid URI as defined by [RFC 3986](https://datatracker.ietf.org/doc/html/rfc3986)\n- URI scheme is required and must be either `http` or `https`\n- URI host is required and cannot be `localhost` or an IP address\n- Max length: `255`\n- Reserved or invalid characters must be percent-encoded (for example, use `%20` instead of a space)\n:::","descriptionNode":"$L1e3b"},"phone":{"type":"string","description":"The phone number of the seller.","descriptionNode":"$L1e3c"},"address":{"type":"object","description":"Details of a physical address.","properties":{"street_line_1":"$18:props:children:0:props:children:props:requestBody:content:application/json:schema:properties:industry_data:oneOf:2:properties:seller:properties:address:properties:street_line_1","street_line_2":"$18:props:children:0:props:children:props:requestBody:content:application/json:schema:properties:industry_data:oneOf:2:properties:seller:properties:address:properties:street_line_2","region":"$18:props:children:0:props:children:props:requestBody:content:application/json:schema:properties:industry_data:oneOf:2:properties:seller:properties:address:properties:region","city":"$18:props:children:0:props:children:props:requestBody:content:application/json:schema:properties:industry_data:oneOf:2:properties:seller:properties:address:properties:city","country_code":"$18:props:children:0:props:children:props:requestBody:content:application/json:schema:properties:industry_data:oneOf:2:properties:seller:properties:address:properties:country_code","country_subdivision_code":"$18:props:children:0:props:children:props:requestBody:content:application/json:schema:properties:industry_data:oneOf:2:properties:seller:properties:address:properties:country_subdivision_code","postcode":"$18:props:children:0:props:children:props:requestBody:content:application/json:schema:properties:industry_data:oneOf:2:properties:seller:properties:address:properties:postcode"},"required":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:2:properties:seller:properties:address:required","descriptionNode":"$L1e3d"}},"required":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:3:properties:seller:required","descriptionNode":"$L1e3e"}},"required":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:3:required","descriptionNode":"$L1e3f"},{"type":"object","description":"Object containing booking information for a list of event tickets associated with the order.\n\n:::info\nThese are the specific data field requirements for merchants who must provide event data. Note that these requirements can be extended on a case by case basis as decided by Revolut.\n\n```\nbooking_id\nevents[].start_date\nevents[].end_date\nevents[].supplier\nevents[].tickets[].id\n```\n:::","properties":{"type":{"type":"string","enum":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:0:properties:type:enum","description":"Type of the industry-specific data object, determining what additional data is expected.\n\nAvailable types:\n\n | Object type | Description |\n | ------------- | ----------- |\n | `airline` | Object containing information about a specific airline ticket purchase. |\n | `car_rental` | Object containing information about a car rental booking associated with the order. |\n | `crypto` | Object containing information about crypto transactions associated with the order. |\n | `marketplace` | This object is required by Mastercard and Visa for merchants operating as marketplaces under the **Merchant Category Code (MCC):** `5262`. The marketplace object ensures compliance with the card schemes' regulations by providing detailed information about the subseller involved in the transaction. |\n | `event` | Object containing information about event ticket bookings associated with the order. |\n | `lodging` | Object containing information about lodging bookings associated with the order. |","descriptionNode":"$L1e40"},"booking_id":{"type":"string","description":"A unique identifier provided by the merchant associated with the order. \n\nThis `booking_id` is used to reference and correlate booking information with the Merchant API and the merchant's internal system.","descriptionNode":"$L1e41"},"events":{"type":"array","description":"A list of events associated with the booking.","items":{"type":"object","description":"Object containing booking information about a specific event. ","properties":{"start_date":{"type":"string","format":"date-time","description":"[ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time when the event starts.","descriptionNode":"$L1e42"},"end_date":{"type":"string","format":"date-time","description":"[ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time when the event ends.","descriptionNode":"$L1e43"},"supplier":{"type":"string","description":"Legal name of the ticket vendor/event organiser.","descriptionNode":"$L1e44"},"supplier_payment_date":{"type":"string","format":"date-time","description":"[ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time when the funds are released to merchants.","descriptionNode":"$L1e45"},"name":{"type":"string","description":"The name of the event.","descriptionNode":"$L1e46"},"location":{"type":"object","description":"The address of the event location.","properties":{"street_line_1":{"type":"string","description":"Primary address line.","maxLength":100,"descriptionNode":"$L1e47"},"street_line_2":{"type":"string","description":"Secondary address line, such as floor and apartment number.","maxLength":100,"descriptionNode":"$L1e48"},"region":{"type":"string","description":"State or province of the address.","maxLength":100,"descriptionNode":"$L1e49"},"city":{"type":"string","description":"City of the address.","maxLength":100,"descriptionNode":"$L1e4a"},"country_code":{"type":"string","pattern":"^[A-Z]{2}$","description":"ISO 2-letter country code.","minLength":2,"maxLength":2,"descriptionNode":"$L1e4b"},"postcode":{"type":"string","description":"Postal code of the address.","maxLength":100,"descriptionNode":"$L1e4c"}},"required":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:4:properties:events:items:properties:location:required","descriptionNode":"$L1e4d"},"category":{"type":"string","enum":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:4:properties:events:items:properties:category:enum","description":"The type of the event.","descriptionNode":"$L1e4e"},"market":{"type":"string","enum":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:4:properties:events:items:properties:market:enum","description":"Indicates the relationship between the ticket vendor and the event organiser. \n\n| Parameter value | Description |\n| --------------- | ----------- |\n| `primary` | The merchant is the organiser and primary distributor of the tickets. |\n| `secondary` | The merchant is a reseller, only distributing the tickets. |","descriptionNode":"$L1e4f"},"tickets":{"type":"array","items":{"type":"object","description":"Object containing information about a ticket associated with the booking.","properties":{"id":{"type":"string","description":"A unique identifier provided by the merchant associated with the ticket.","descriptionNode":"$L1e50"},"transferable":{"type":"boolean","description":"Indicates whether the ticket is transferable to another buyer.","descriptionNode":"$L1e51"},"refundability":{"type":"string","enum":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:0:properties:refundability:enum","description":"Parameter indicating whether the booking is refundable, partially refundable, or not refundable.","descriptionNode":"$L1e52"}},"required":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:4:properties:events:items:properties:tickets:items:required","descriptionNode":"$L1e53"},"description":"A list of tickets associated with the booking.","descriptionNode":"$L1e54"}},"descriptionNode":"$L1e55"},"descriptionNode":"$L1e56"}},"required":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:4:required","descriptionNode":"$L1e57"},{"type":"object","description":"Object containing details of a lodging booking.\n\n:::info\nThese are the specific data field requirements for merchants who must provide lodging data. Note that these requirements can be extended on a case by case basis as decided by Revolut.\n\n```\nbooking_id\ncheck_in_date\ncheck_out_date\nsupplier_payment_date\n```\n:::","properties":{"type":{"type":"string","enum":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:0:properties:type:enum","description":"Type of the industry-specific data object, determining what additional data is expected.\n\nAvailable types:\n\n | Object type | Description |\n | ------------- | ----------- |\n | `airline` | Object containing information about a specific airline ticket purchase. |\n | `car_rental` | Object containing information about a car rental booking associated with the order. |\n | `crypto` | Object containing information about crypto transactions associated with the order. |\n | `marketplace` | This object is required by Mastercard and Visa for merchants operating as marketplaces under the **Merchant Category Code (MCC):** `5262`. The marketplace object ensures compliance with the card schemes' regulations by providing detailed information about the subseller involved in the transaction. |\n | `event` | Object containing information about event ticket bookings associated with the order. |\n | `lodging` | Object containing information about lodging bookings associated with the order. |","descriptionNode":"$L1e58"},"booking_id":{"type":"string","description":"A unique identifier provided by the merchant associated with the order. \n\nThis `booking_id` is used to reference and correlate booking information with the Merchant API and the merchant's internal system.","descriptionNode":"$L1e59"},"check_in_date":{"type":"string","format":"date-time","description":"[ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time of the check-in.","descriptionNode":"$L1e5a"},"check_out_date":{"type":"string","format":"date-time","description":"[ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time of the check-out.","descriptionNode":"$L1e5b"},"supplier_payment_date":{"type":"string","format":"date-time","description":"[ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time when the funds are released to merchants.","descriptionNode":"$L1e5c"},"category":{"type":"string","enum":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:5:properties:category:enum","description":"The type of the accommodation associated with the booking.","descriptionNode":"$L1e5d"},"booking_type":{"type":"string","enum":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:5:properties:booking_type:enum","description":"Indicates whether the booking terms are fixed or flexible.\n\n| Parameter value | Description |\n| --------------- | ----------- |\n| `fixed` | Non-modifiable once confirmed. |\n| `flexible` | Allows modifications or cancellations under specified conditions. |","descriptionNode":"$L1e5e"},"refundability":{"type":"string","enum":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:0:properties:refundability:enum","description":"Parameter indicating whether the booking is refundable, partially refundable, or not refundable.","descriptionNode":"$L1e5f"},"location":{"type":"object","description":"Address of the accommodation.","properties":{"street_line_1":{"type":"string","description":"Primary address line.","maxLength":100,"descriptionNode":"$L1e60"},"street_line_2":{"type":"string","description":"Secondary address line, such as floor and apartment number.","maxLength":100,"descriptionNode":"$L1e61"},"region":{"type":"string","description":"State or province of the address.","maxLength":100,"descriptionNode":"$L1e62"},"city":{"type":"string","description":"City of the address.","maxLength":100,"descriptionNode":"$L1e63"},"country_code":{"type":"string","pattern":"^[A-Z]{2}$","description":"ISO 2-letter country code.","minLength":2,"maxLength":2,"descriptionNode":"$L1e64"},"postcode":{"type":"string","description":"Postal code of the address.","maxLength":100,"descriptionNode":"$L1e65"}},"required":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:5:properties:location:required","descriptionNode":"$L1e66"},"guests":{"type":"array","items":{"type":"object","properties":{"first_name":{"type":"string","description":"Guest's first name.","descriptionNode":"$L1e67"},"last_name":{"type":"string","description":"Guest's last name.","descriptionNode":"$L1e68"}},"required":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:5:properties:guests:items:required"},"description":"List of guests associated with the booking.","descriptionNode":"$L1e69"}},"required":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:industry_data:oneOf:5:required","descriptionNode":"$L1e6a"}],"descriptionNode":"$L1e6b"},"merchant_order_data":{"type":"object","description":"Object for providing additional information stored in the merchant's order management system. ","properties":{"url":{"type":"string","format":"uri","pattern":"^https?:\\/{2}.+/gi","maxLength":2000,"description":"The URL of the order stored in the merchant's order management system.\n\nThis URL will be included in the order confirmation email for payments made via Revolut Pay. If specified, this URL will override the default link to the merchant's **Business website** configured in the Revolut Business account.\n\n:::warning\nRestrictions:\n- Must be a valid URI as defined by [RFC 3986](https://datatracker.ietf.org/doc/html/rfc3986)\n- URI scheme is required and must be either `http` or `https`\n- URI host is required and cannot be `localhost` or an IP address\n- Max length: `2000`\n- Reserved or invalid characters must be percent-encoded (for example, use `%20` instead of a space)\n:::","descriptionNode":"$L1e6c"},"reference":{"type":"string","description":"Merchant order ID for external reference.\n\nUse this field to set the ID that your own system can use to easily track orders.","descriptionNode":"$L1e6d"}},"descriptionNode":"$L1e6e"},"upcoming_payment_data":{"type":"object","description":"Object containing information about upcoming payments associated with the order.","properties":{"date":{"type":"string","format":"date-time","description":"The date and time in [ISO 8601 format](https://en.wikipedia.org/wiki/ISO_8601) when the upcoming payment is scheduled to be executed.","descriptionNode":"$L1e6f"},"payment_method_id":{"type":"string","description":"The unique ID of the customer's payment method used to complete the scheduled payment.\n\n:::info\nFor more information about operations related to customer's payment methods, see:\n - [Retrieve payment method list of a customer](https://developer.revolut.com/docs/api/merchant#retrieve-payment-method-list)\n - [Retrieve a customer's payment method](https://developer.revolut.com/docs/api/merchant#retrieve-payment-method)\n - [Update a customer's payment method](https://developer.revolut.com/docs/api/merchant#update-payment-method)\n - [Delete a customer's payment method](https://developer.revolut.com/docs/api/merchant#delete-payment-method)\n:::","descriptionNode":"$L1e70"}},"required":"$1a:props:children:0:props:children:props:responses:200:content:application/json:schema:properties:upcoming_payment_data:required","descriptionNode":"$L1e71"},"redirect_url":{"type":"string","format":"uri","pattern":"^https?:\\/{2}.+/gi","maxLength":2000,"description":"The URL your customer will be redirected to after a successful payment on the hosted checkout page (`checkout_url` parameter's value of the order).\n\n:::warning\nRestrictions:\n- Must be a valid URI as defined by [RFC 3986](https://datatracker.ietf.org/doc/html/rfc3986)\n- URI scheme is required and must be either `http` or `https`\n- URI host is required and cannot be `localhost` or an IP address\n- Max length: `2000`\n- Reserved or invalid characters must be percent-encoded (for example, use `%20` instead of a space)\n:::\n\n:::info\nFor more information on how to use the `redirect_url`, see: [Custom redirection via the API](https://developer.revolut.com/docs/guides/merchant/accept-payments/online-payments/hosted-checkout-page/api#custom-post-payment-redirection-optional)\n:::","descriptionNode":"$L1e72"},"statement_descriptor_suffix":{"type":"string","description":"$1e73","minLength":1,"maxLength":19,"pattern":"^[^*\\n\\r\\\\]+$","descriptionNode":"$L1e74"}},"required":["amount","currency"],"descriptionNode":"$L1e75"},"examples":{"example_order_min_params":{"summary":"Example order with minimal required parameters","value":{"amount":500,"currency":"GBP"}},"example_order_additional":{"summary":"Example order with additional parameters","value":{"amount":500,"currency":"GBP","capture_mode":"manual","cancel_authorised_after":"PT30M","expire_pending_after":"PT15M","customer":{"email":"example@example.com","date_of_birth":"1990-01-01"},"description":"Example product","shipping":{"address":{"street_line_1":"7 Westferry Circus","city":"London","country_code":"GB","postcode":"E14 4HD"}},"enforce_challenge":"forced","metadata":{"product_type":"Example"},"merchant_order_data":{"url":"https://www.example.com/orders/12345"},"redirect_url":"https://www.example.com/redirect","statement_descriptor_suffix":"12345"}},"example_order_pre_auth":{"summary":"Example order with pre-authorisation","value":{"amount":5000,"currency":"GBP","capture_mode":"manual","authorisation_type":"pre_authorisation","description":"Hotel reservation deposit","cancel_authorised_after":"PT72H"}},"example_order_line_items":{"summary":"Example order with line items","value":{"amount":770,"currency":"GBP","line_items":[{"name":"Example item 1","type":"physical","quantity":{"value":2,"unit":"kg"},"unit_price_amount":100,"total_amount":170,"external_id":"external_id_123","discounts":[{"name":"Discount 1","amount":50}],"taxes":[{"name":"10% VAT","amount":20}],"image_urls":["https://www.example.com/line-item-image1","https://www.example.com/line-item-image2"],"description":"First line item","url":"https://www.example.com"},{"name":"Example item 2","type":"service","quantity":{"value":10,"unit":"pieces"},"unit_price_amount":100,"total_amount":600,"external_id":"external_id_456","discounts":[{"name":"Discount 2","amount":500}],"taxes":[{"name":"10% VAT","amount":100}],"image_urls":["https://www.example.com/line-item-image3","https://www.example.com/line-item-image4"],"description":"Second line item","url":"https://www.example.com"}]}},"example_order_shipping":{"summary":"Example order with shipping details","value":{"amount":500,"currency":"GBP","shipping":{"address":{"street_line_1":"Example Street 123","street_line_2":"II/123","region":"London","city":"London","country_code":"GB","postcode":"123456"},"contact":{"name":"Example Contact","email":"example.contact@example.com","phone":"+441234567890"},"shipments":[{"shipping_company_name":"Example Shipping Co.","tracking_number":"123456789","estimated_delivery_date":"2024-12-03T10:15:30+02:00[Europe/Paris]","tracking_url":"https://www.example.com/tracking/123456789"}]}}},"example_order_airline":{"summary":"Example order with additional airline data","value":{"amount":500,"currency":"GBP","settlement_currency":"EUR","description":"Example order description","customer":{"full_name":"Example Customer","phone":"+441234567890","email":"example@example.com"},"enforce_challenge":"forced","capture_mode":"manual","cancel_authorised_after":"PT30M","industry_data":{"type":"airline","booking_id":"unique-booking-id-12345","fulfillment_date":"2023-07-10T14:00:00.069624Z","ticket_type":"flexible","crs_code":"DATS","ticket_change_indicator":"new","refundability":"refundable","passengers":[{"first_name":"Example","last_name":"Customer"},{"first_name":"John","last_name":"Doe"}],"journey_legs":[{"sequence":1,"departure_airport_code":"FRA","arrival_airport_code":"LHR","flight_number":"670","fare_base_code":"J","travel_date":"2023-07-10T10:00:00.069624Z","airline_name":"AerLingus","airline_code":"EI"},{"sequence":2,"departure_airport_code":"LHR","arrival_airport_code":"DUB","flight_number":"678","fare_base_code":"J","travel_date":"2023-07-10T15:00:00.069624Z","airline_name":"AerLingus","airline_code":"EI"},{"sequence":3,"departure_airport_code":"DUB","arrival_airport_code":"LHR","flight_number":"679","fare_base_code":"F","travel_date":"2023-07-15T10:00:00.069624Z","airline_name":"AerLingus","airline_code":"EI"},{"sequence":4,"departure_airport_code":"LHR","arrival_airport_code":"FRA","flight_number":"671","fare_base_code":"F","travel_date":"2023-07-10T14:00:00.069624Z","airline_name":"AerLingus","airline_code":"EI"}],"booking_url":"https://example.com/bookings/1234"},"merchant_order_data":{"url":"https://www.example.com/ticketnumber-12345","reference":"example_airline_reference"},"redirect_url":"https://www.example.com/redirect"}},"example_order_car_rental":{"summary":"Example order with additional car rental data","value":{"amount":500,"currency":"GBP","settlement_currency":"GBP","description":"Example car rental order","customer":{"full_name":"Example Customer","phone":"+447700900000","email":"example@example.com"},"enforce_challenge":"forced","capture_mode":"manual","cancel_authorised_after":"PT30M","industry_data":{"type":"car_rental","booking_id":"example_booking_id","pick_up_date":"2026-03-01T11:00:00Z","drop_off_date":"2026-03-05T16:30:00Z","refundability":"partially_refundable","pick_up_location":{"street_line_1":"1 Example Street","city":"London","country_code":"GB","postcode":"SW1A 1AA"},"drop_off_location":{"street_line_1":"10 Another Road","city":"Manchester","country_code":"GB","postcode":"M1 1AA"},"distance_limit":{"limit":500,"unit":"miles","additional_distance_cost":{"amount":150,"currency":"GBP"}}},"merchant_order_data":{"url":"https://www.example.com/rental/example_booking_id","reference":"example_car_rental_reference"},"redirect_url":"https://www.example.com/redirect"}},"example_order_crypto":{"summary":"Example order with additional crypto transaction data","value":{"amount":26100,"currency":"EUR","settlement_currency":"EUR","description":"Customer wants to buy 0.01 BTC","customer":{"id":"db186257-3031-4726-98ea-f2260ea115f0"},"capture_mode":"manual","cancel_authorised_after":"PT30M","industry_data":{"type":"crypto","transactions":[{"id":"7b2a8ed4-5889-4c0c-a8cc-299aff1c881b","status":"pending","recipient_wallet_id":"64a6f159-0a60-a446-880e-e449a1f62f7c"}],"seller":{"id":"a13638ab-3e90-4b05-9f69-23abc655775b","name":"Ramp Provider Company Name","website":"https://example.com","phone":"123456789","mcc":"6051","address":{"street_line_1":"456 Crypto Ave","city":"New York","postcode":"10001","country_code":"US"}}},"merchant_order_data":{"url":"https://www.example.com/cryptotransactionnumber-12345","reference":"example_crypto_reference"},"redirect_url":"https://www.example.com/redirect"}},"example_order_marketplace":{"summary":"Example order with additional marketplace data","value":{"amount":10000,"currency":"EUR","industry_data":{"type":"marketplace","seller":{"id":"123-45-67","name":"Example Seller","website":"https://example.com/123-45-67","phone":"+441234567890","address":{"street_line_1":"1 Canada Square","street_line_2":"Revolut LTD, Level 39","postcode":"E14 4HD","country_code":"GB","country_subdivision_code":"GB-LND","city":"London","region":"Greater London"}}}}},"example_order_event":{"summary":"Example order with additional event data","value":{"amount":100,"currency":"GBP","industry_data":{"type":"event","booking_id":"example_booking_123","events":[{"start_date":"2025-03-04T14:00:00Z","end_date":"2025-03-04T17:00:00Z","supplier":"Example Supplier","supplier_payment_date":"2025-03-03T14:00:15Z","name":"Example Event","location":{"street_line_1":"Example Street 123","street_line_2":"II/123","region":"London","city":"London","country_code":"GB","postcode":"123456"},"category":"exhibition","market":"primary","tickets":[{"id":"example_ticket_1","transferable":false,"refundability":"partially_refundable"},{"id":"example_ticket_2","transferable":true,"refundability":"non_refundable"},{"id":"example_ticket_3"}]}]}}},"example_order_lodging":{"summary":"Example order with additional lodging data","value":{"amount":100,"currency":"GBP","industry_data":{"type":"lodging","booking_id":"example_booking_123","check_in_date":"2025-05-01T15:00:00Z","check_out_date":"2025-05-05T11:00:00Z","supplier_payment_date":"2025-05-05T11:00:00Z","category":"bed_and_breakfast","booking_type":"flexible","refundability":"partially_refundable","location":{"street_line_1":"Example Street 123","street_line_2":"II/123","region":"London","city":"London","country_code":"GB","postcode":"123456"},"guests":[{"first_name":"First","last_name":"Guest"},{"first_name":"Second","last_name":"Guest"}]}}}}}}},"variantLabels":["Example order response with minimal required parameters","Example order response with additional parameters","Example order response with pre-authorisation and card payment","example_order_line_items","Example order response with shipping details","Example order response with additional airline data","Example order response with additional car rental data","Example order response with additional crypto transaction data","Example order response with additional marketplace data","Example order response with additional event data","Example order response with additional lodging data"],"children":["$L1e76","$L1e77"]}]}],false]}] 1c47:"Update an order" 1e76:["$","div",null,{"className":"ezz1n30","children":[["$","div",null,{"data-header":"$undefined","className":"ezz1n31","children":["$","div",null,{"className":"y9a0do1","children":[["$","h2",null,{"id":"create-order","children":[["$L1e78","$undefined"],["$","$L15",null,{"id":"create-order"}]]}],["$","$L16",null,{"url":"/docs/api/merchant/2025-10-16/operations/create-order.md"}]]}]}],"$undefined"]}] 1e7c:T68a,
curl -X POST "https://merchant.revolut.com/api/orders" \
  -H "Content-Type: application/json" \
  -H "Authorization: __RP_TOK_0__" \
  -H "Revolut-Api-Version: __RP_TOK_1__" \
  -d '{
  "amount": 500,
  "currency": "GBP"
}'
1e7d:Tf7b,
const payload = {
  "amount": 500,
  "currency": "GBP"
};
fetch("https://merchant.revolut.com/api/orders", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "__RP_TOK_0__",
    "Revolut-Api-Version": "__RP_TOK_1__"
  },
  body: JSON.stringify(payload)
})
  .then(response => response.json())
  .then(data => console.log(data));
1e7e:T166f,
package main

import (
  "fmt"
  "net/http"
  "bytes"
  "encoding/json"
)

func main() {
  url := "https://merchant.revolut.com/api/orders"
  jsonData := []byte(`
{
  "amount": 500,
  "currency": "GBP"
}
  `)
  req, _ := http.NewRequest("POST", url, bytes.NewBuffer(jsonData))
  req.Header.Add("Content-Type", "application/json")
  req.Header.Add("Authorization", "__RP_TOK_0__")
  req.Header.Add("Revolut-Api-Version", "__RP_TOK_1__")

  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  fmt.Println(res)
}
1e7f:Tcaf,
import requests

url = "https://merchant.revolut.com/api/orders"
headers = {
  "Content-Type": "application/json",
  "Authorization": "__RP_TOK_0__",
  "Revolut-Api-Version": "__RP_TOK_1__"
}
payload = {
  "amount": 500,
  "currency": "GBP"
}

response = requests.post(url, headers=headers, json=payload)
print(response.json())
1e80:T1bd3,
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;

public class Main {
  public static void main(String[] args) {
    HttpClient client = HttpClient.newHttpClient();
    String body = """
{
  "amount": 500,
  "currency": "GBP"
}
    """;

    HttpRequest request = HttpRequest.newBuilder()
      .uri(URI.create("https://merchant.revolut.com/api/orders"))
      .header("Content-Type", "application/json")
      .header("Authorization", "__RP_TOK_0__")
      .header("Revolut-Api-Version", "__RP_TOK_1__")
      .POST(HttpRequest.BodyPublishers.ofString(body))
      .build();

    client.sendAsync(request, HttpResponse.BodyHandlers.ofString())
      .thenApply(HttpResponse::body)
      .thenAccept(System.out::println)
      .join();
  }
}
1e81:T1e65,
using System.Net.Http;
using System.Net.Http.Headers;

var client = new HttpClient();
var request = new HttpRequestMessage
{
  Method = HttpMethod.Post,
  RequestUri = new Uri("https://merchant.revolut.com/api/orders"),
  Headers =
  {
    { "Authorization", "__RP_TOK_0__" },
    { "Revolut-Api-Version", "__RP_TOK_1__" },
  },
  Content = new StringContent(@"{
  ""amount"": 500,
  ""currency"": ""GBP""
}")
  {
    Headers =
    {
      ContentType = new MediaTypeHeaderValue("application/json")
    }
  }
};

using (var response = await client.SendAsync(request))
{
  response.EnsureSuccessStatusCode();
  var body = await response.Content.ReadAsStringAsync();
  Console.WriteLine(body);
}
1e82:T692,
curl -X POST "https://sandbox-merchant.revolut.com/api/orders" \
  -H "Content-Type: application/json" \
  -H "Authorization: __RP_TOK_0__" \
  -H "Revolut-Api-Version: __RP_TOK_1__" \
  -d '{
  "amount": 500,
  "currency": "GBP"
}'
1e83:Tf83,
const payload = {
  "amount": 500,
  "currency": "GBP"
};
fetch("https://sandbox-merchant.revolut.com/api/orders", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "__RP_TOK_0__",
    "Revolut-Api-Version": "__RP_TOK_1__"
  },
  body: JSON.stringify(payload)
})
  .then(response => response.json())
  .then(data => console.log(data));
1e84:T1677,
package main

import (
  "fmt"
  "net/http"
  "bytes"
  "encoding/json"
)

func main() {
  url := "https://sandbox-merchant.revolut.com/api/orders"
  jsonData := []byte(`
{
  "amount": 500,
  "currency": "GBP"
}
  `)
  req, _ := http.NewRequest("POST", url, bytes.NewBuffer(jsonData))
  req.Header.Add("Content-Type", "application/json")
  req.Header.Add("Authorization", "__RP_TOK_0__")
  req.Header.Add("Revolut-Api-Version", "__RP_TOK_1__")

  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  fmt.Println(res)
}
1e85:Tcb7,
import requests

url = "https://sandbox-merchant.revolut.com/api/orders"
headers = {
  "Content-Type": "application/json",
  "Authorization": "__RP_TOK_0__",
  "Revolut-Api-Version": "__RP_TOK_1__"
}
payload = {
  "amount": 500,
  "currency": "GBP"
}

response = requests.post(url, headers=headers, json=payload)
print(response.json())
1e86:T1bdb,
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;

public class Main {
  public static void main(String[] args) {
    HttpClient client = HttpClient.newHttpClient();
    String body = """
{
  "amount": 500,
  "currency": "GBP"
}
    """;

    HttpRequest request = HttpRequest.newBuilder()
      .uri(URI.create("https://sandbox-merchant.revolut.com/api/orders"))
      .header("Content-Type", "application/json")
      .header("Authorization", "__RP_TOK_0__")
      .header("Revolut-Api-Version", "__RP_TOK_1__")
      .POST(HttpRequest.BodyPublishers.ofString(body))
      .build();

    client.sendAsync(request, HttpResponse.BodyHandlers.ofString())
      .thenApply(HttpResponse::body)
      .thenAccept(System.out::println)
      .join();
  }
}
1e87:T1e6d,
using System.Net.Http;
using System.Net.Http.Headers;

var client = new HttpClient();
var request = new HttpRequestMessage
{
  Method = HttpMethod.Post,
  RequestUri = new Uri("https://sandbox-merchant.revolut.com/api/orders"),
  Headers =
  {
    { "Authorization", "__RP_TOK_0__" },
    { "Revolut-Api-Version", "__RP_TOK_1__" },
  },
  Content = new StringContent(@"{
  ""amount"": 500,
  ""currency"": ""GBP""
}")
  {
    Headers =
    {
      ContentType = new MediaTypeHeaderValue("application/json")
    }
  }
};

using (var response = await client.SendAsync(request))
{
  response.EnsureSuccessStatusCode();
  var body = await response.Content.ReadAsStringAsync();
  Console.WriteLine(body);
}
1e77:["$","div",null,{"className":"ezz1n30","children":[["$","div",null,{"data-header":"$undefined","className":"ezz1n31","children":["$L1e79",["$","$L85",null,{"parameters":[{"name":"Authorization","in":"header","schema":{"type":"string","format":"Bearer ","examples":"$62:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:0:schema:examples"},"required":true,"description":"This parameter accepts the [Merchant API Secret key](https://business.revolut.com/settings/apis?tab=merchant-api) to authorise requests coming from the merchant's backend. \n\nIt ensures that ensures that each request is authenticated and authorised by verifying the secret key. The secret key should be included in all request headers as a `Bearer` token.\n\n:::info\nFor more information, see: [Authentication](https://developer.revolut.com/docs/api/merchant#authentication)\n:::","descriptionNode":"$L1e7a"},{"name":"Revolut-Api-Version","in":"header","schema":{"type":"string","format":"date","enum":"$36:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:1:schema:enum","examples":"$36:props:children:0:props:children:props:children:1:props:children:0:props:children:1:props:parameters:1:schema:examples"},"required":true,"description":"The version of the Merchant API, specified in `YYYY-MM-DD` format.\n\nIf not specified, you will receive an error.\n\n\n:::info\nFor more information about API versioning, see: [API versions](https://developer.revolut.com/docs/guides/merchant/reference/versioning/api-versions).\n:::","x-config-always-visible-in-example":true,"example":"2025-10-16","descriptionNode":"$L1e7b"}],"requestBody":"$18:props:children:0:props:children:props:requestBody","heading":"Request","requestBodySchemaTitle":"Request body","headingAs":"h3"}],["$","$L89",null,{"responses":"$18:props:children:0:props:children:props:responses","headingAs":"h3"}]]}],["$","div",null,{"className":"ezz1n32","children":[[["$","$L8a",null,{"itemsByServer":{"https://merchant.revolut.com":[{"id":"curl","label":"cURL","templateCode":"curl -X POST \"https://merchant.revolut.com/api/orders\" \\\n -H \"Content-Type: application/json\" \\\n -H \"Authorization: __RP_TOK_0__\" \\\n -H \"Revolut-Api-Version: __RP_TOK_1__\" \\\n -d '{\n \"amount\": 500,\n \"currency\": \"GBP\"\n}'","templateHtml":"$1e7c","tokens":[{"marker":"__RP_TOK_0__","paramName":"Authorization","paramIn":"header","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_1__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["shell-double-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16"}},{"id":"javascript","label":"JavaScript","templateCode":"const payload = {\n \"amount\": 500,\n \"currency\": \"GBP\"\n};\nfetch(\"https://merchant.revolut.com/api/orders\", {\n method: \"POST\",\n headers: {\n \"Content-Type\": \"application/json\",\n \"Authorization\": \"__RP_TOK_0__\",\n \"Revolut-Api-Version\": \"__RP_TOK_1__\"\n },\n body: JSON.stringify(payload)\n})\n .then(response => response.json())\n .then(data => console.log(data));","templateHtml":"$1e7d","tokens":[{"marker":"__RP_TOK_0__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16"}},{"id":"go","label":"Go","templateCode":"package main\n\nimport (\n \"fmt\"\n \"net/http\"\n \"bytes\"\n \"encoding/json\"\n)\n\nfunc main() {\n url := \"https://merchant.revolut.com/api/orders\"\n jsonData := []byte(`\n{\n \"amount\": 500,\n \"currency\": \"GBP\"\n}\n `)\n req, _ := http.NewRequest(\"POST\", url, bytes.NewBuffer(jsonData))\n req.Header.Add(\"Content-Type\", \"application/json\")\n req.Header.Add(\"Authorization\", \"__RP_TOK_0__\")\n req.Header.Add(\"Revolut-Api-Version\", \"__RP_TOK_1__\")\n\n res, _ := http.DefaultClient.Do(req)\n defer res.Body.Close()\n fmt.Println(res)\n}","templateHtml":"$1e7e","tokens":[{"marker":"__RP_TOK_0__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16"}},{"id":"python","label":"Python","templateCode":"import requests\n\nurl = \"https://merchant.revolut.com/api/orders\"\nheaders = {\n \"Content-Type\": \"application/json\",\n \"Authorization\": \"__RP_TOK_0__\",\n \"Revolut-Api-Version\": \"__RP_TOK_1__\"\n}\npayload = {\n \"amount\": 500,\n \"currency\": \"GBP\"\n}\n\nresponse = requests.post(url, headers=headers, json=payload)\nprint(response.json())","templateHtml":"$1e7f","tokens":[{"marker":"__RP_TOK_0__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16"}},{"id":"java","label":"Java","templateCode":"import java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\nimport java.net.URI;\n\npublic class Main {\n public static void main(String[] args) {\n HttpClient client = HttpClient.newHttpClient();\n String body = \"\"\"\n{\n \"amount\": 500,\n \"currency\": \"GBP\"\n}\n \"\"\";\n\n HttpRequest request = HttpRequest.newBuilder()\n .uri(URI.create(\"https://merchant.revolut.com/api/orders\"))\n .header(\"Content-Type\", \"application/json\")\n .header(\"Authorization\", \"__RP_TOK_0__\")\n .header(\"Revolut-Api-Version\", \"__RP_TOK_1__\")\n .POST(HttpRequest.BodyPublishers.ofString(body))\n .build();\n\n client.sendAsync(request, HttpResponse.BodyHandlers.ofString())\n .thenApply(HttpResponse::body)\n .thenAccept(System.out::println)\n .join();\n }\n}","templateHtml":"$1e80","tokens":[{"marker":"__RP_TOK_0__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16"}},{"id":"csharp","label":"C#","templateCode":"using System.Net.Http;\nusing System.Net.Http.Headers;\n\nvar client = new HttpClient();\nvar request = new HttpRequestMessage\n{\n Method = HttpMethod.Post,\n RequestUri = new Uri(\"https://merchant.revolut.com/api/orders\"),\n Headers =\n {\n { \"Authorization\", \"__RP_TOK_0__\" },\n { \"Revolut-Api-Version\", \"__RP_TOK_1__\" },\n },\n Content = new StringContent(@\"{\n \"\"amount\"\": 500,\n \"\"currency\"\": \"\"GBP\"\"\n}\")\n {\n Headers =\n {\n ContentType = new MediaTypeHeaderValue(\"application/json\")\n }\n }\n};\n\nusing (var response = await client.SendAsync(request))\n{\n response.EnsureSuccessStatusCode();\n var body = await response.Content.ReadAsStringAsync();\n Console.WriteLine(body);\n}","templateHtml":"$1e81","tokens":[{"marker":"__RP_TOK_0__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16"}}],"https://sandbox-merchant.revolut.com":[{"id":"curl","label":"cURL","templateCode":"curl -X POST \"https://sandbox-merchant.revolut.com/api/orders\" \\\n -H \"Content-Type: application/json\" \\\n -H \"Authorization: __RP_TOK_0__\" \\\n -H \"Revolut-Api-Version: __RP_TOK_1__\" \\\n -d '{\n \"amount\": 500,\n \"currency\": \"GBP\"\n}'","templateHtml":"$1e82","tokens":[{"marker":"__RP_TOK_0__","paramName":"Authorization","paramIn":"header","pipeline":["shell-double-inner"]},{"marker":"__RP_TOK_1__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["shell-double-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16"}},{"id":"javascript","label":"JavaScript","templateCode":"const payload = {\n \"amount\": 500,\n \"currency\": \"GBP\"\n};\nfetch(\"https://sandbox-merchant.revolut.com/api/orders\", {\n method: \"POST\",\n headers: {\n \"Content-Type\": \"application/json\",\n \"Authorization\": \"__RP_TOK_0__\",\n \"Revolut-Api-Version\": \"__RP_TOK_1__\"\n },\n body: JSON.stringify(payload)\n})\n .then(response => response.json())\n .then(data => console.log(data));","templateHtml":"$1e83","tokens":[{"marker":"__RP_TOK_0__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16"}},{"id":"go","label":"Go","templateCode":"package main\n\nimport (\n \"fmt\"\n \"net/http\"\n \"bytes\"\n \"encoding/json\"\n)\n\nfunc main() {\n url := \"https://sandbox-merchant.revolut.com/api/orders\"\n jsonData := []byte(`\n{\n \"amount\": 500,\n \"currency\": \"GBP\"\n}\n `)\n req, _ := http.NewRequest(\"POST\", url, bytes.NewBuffer(jsonData))\n req.Header.Add(\"Content-Type\", \"application/json\")\n req.Header.Add(\"Authorization\", \"__RP_TOK_0__\")\n req.Header.Add(\"Revolut-Api-Version\", \"__RP_TOK_1__\")\n\n res, _ := http.DefaultClient.Do(req)\n defer res.Body.Close()\n fmt.Println(res)\n}","templateHtml":"$1e84","tokens":[{"marker":"__RP_TOK_0__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16"}},{"id":"python","label":"Python","templateCode":"import requests\n\nurl = \"https://sandbox-merchant.revolut.com/api/orders\"\nheaders = {\n \"Content-Type\": \"application/json\",\n \"Authorization\": \"__RP_TOK_0__\",\n \"Revolut-Api-Version\": \"__RP_TOK_1__\"\n}\npayload = {\n \"amount\": 500,\n \"currency\": \"GBP\"\n}\n\nresponse = requests.post(url, headers=headers, json=payload)\nprint(response.json())","templateHtml":"$1e85","tokens":[{"marker":"__RP_TOK_0__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16"}},{"id":"java","label":"Java","templateCode":"import java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\nimport java.net.URI;\n\npublic class Main {\n public static void main(String[] args) {\n HttpClient client = HttpClient.newHttpClient();\n String body = \"\"\"\n{\n \"amount\": 500,\n \"currency\": \"GBP\"\n}\n \"\"\";\n\n HttpRequest request = HttpRequest.newBuilder()\n .uri(URI.create(\"https://sandbox-merchant.revolut.com/api/orders\"))\n .header(\"Content-Type\", \"application/json\")\n .header(\"Authorization\", \"__RP_TOK_0__\")\n .header(\"Revolut-Api-Version\", \"__RP_TOK_1__\")\n .POST(HttpRequest.BodyPublishers.ofString(body))\n .build();\n\n client.sendAsync(request, HttpResponse.BodyHandlers.ofString())\n .thenApply(HttpResponse::body)\n .thenAccept(System.out::println)\n .join();\n }\n}","templateHtml":"$1e86","tokens":[{"marker":"__RP_TOK_0__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16"}},{"id":"csharp","label":"C#","templateCode":"using System.Net.Http;\nusing System.Net.Http.Headers;\n\nvar client = new HttpClient();\nvar request = new HttpRequestMessage\n{\n Method = HttpMethod.Post,\n RequestUri = new Uri(\"https://sandbox-merchant.revolut.com/api/orders\"),\n Headers =\n {\n { \"Authorization\", \"__RP_TOK_0__\" },\n { \"Revolut-Api-Version\", \"__RP_TOK_1__\" },\n },\n Content = new StringContent(@\"{\n \"\"amount\"\": 500,\n \"\"currency\"\": \"\"GBP\"\"\n}\")\n {\n Headers =\n {\n ContentType = new MediaTypeHeaderValue(\"application/json\")\n }\n }\n};\n\nusing (var response = await client.SendAsync(request))\n{\n response.EnsureSuccessStatusCode();\n var body = await response.Content.ReadAsStringAsync();\n Console.WriteLine(body);\n}","templateHtml":"$1e87","tokens":[{"marker":"__RP_TOK_0__","paramName":"Authorization","paramIn":"header","pipeline":["json-string-inner"]},{"marker":"__RP_TOK_1__","paramName":"Revolut-Api-Version","paramIn":"header","pipeline":["json-string-inner"]}],"defaults":{"header:Authorization":"Bearer ","header:Revolut-Api-Version":"2025-10-16"}}]},"method":"post","servers":"$62:props:children:0:props:children:props:children:1:props:children:1:props:children:0:0:props:servers","path":"/api/orders","parameters":["$1e77:props:children:0:props:children:1:props:parameters:0","$1e77:props:children:0:props:children:1:props:parameters:1"]}],"$L1e88"],"$L1e89","$L1e8a"]}]]}] 1a32:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Permanent order ID used to retrieve, capture, cancel, or refund an order after authorization."}]]}] 1a33:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Temporary ID for the order, which expires when the payment is authorised."}],"\n",["$","p","p-1",{"children":["The order ",["$","code","code-0",{"children":"token"}]," is used for ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/sdks/merchant-web-sdk/initialisation/token-based","target":"_blank","rel":"noreferrer","children":"token-based initialisation"}],", and is returned by the ",["$","code","code-1",{"children":"createOrder"}]," callback in the following payment methods:"]}],"\n",["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["$","a","a-0",{"href":"https://developer.revolut.com/docs/sdks/merchant-web-sdk/payment-methods/embedded-checkout#embedded-checkout-options-interface","target":"_blank","rel":"noreferrer","children":"Embedded Checkout"}]}],"\n",["$","li","li-1",{"children":["$","a","a-0",{"href":"https://developer.revolut.com/docs/sdks/merchant-web-sdk/payment-methods/revolut-pay#widget-payments-revolut-pay-options","target":"_blank","rel":"noreferrer","children":"Revolut Pay"}]}],"\n",["$","li","li-2",{"children":["$","a","a-0",{"href":"https://developer.revolut.com/docs/sdks/merchant-web-sdk/payment-methods/apple-pay-google-pay#payment-request-options-interface","target":"_blank","rel":"noreferrer","children":"Apple Pay and Google Pay"}]}],"\n",["$","li","li-3",{"children":["$","a","a-0",{"href":"https://developer.revolut.com/docs/sdks/merchant-web-sdk/payment-methods/pay-by-bank#pay-by-bank-options-interface","target":"_blank","rel":"noreferrer","children":"Pay by Bank"}]}],"\n"]}]]}] 1a34:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of the order."}]]}] 1a35:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The state of the order in its lifecycle."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"State","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"pending"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Order created, awaiting payment","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"processing"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Payment is being processed","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"authorised"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Payment authorised but not yet captured (for manual capture)","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"completed"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Payment successfully captured and settled","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-4",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"cancelled"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Order was cancelled","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-5",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"failed"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Payment failed","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/reference/order-lifecycle","target":"_blank","rel":"noreferrer","children":"Order and payment lifecycle"}]]}]}]]}]]}] 1a36:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The date and time the order was created."}]]}] 1a37:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The date and time the order was last updated."}]]}] 1a38:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The description of the order."}]]}] 1a39:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The capture mode of the order. ",["$","code","code-0",{"children":"automatic"}]," is used by default."]}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Parameter value","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"automatic"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The order is captured automatically after payment authorisation.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"manual"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The order is not captured automatically. You must manually capture the order later.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information, see ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#capture-order","target":"_blank","rel":"noreferrer","children":"Capture an order"}],"."]}]}]]}]]}] 1e88:["$","$L10d",null,{"security":[{"Api-Key":[]}],"authorization":{"Api-Key":{"type":"apiKey","in":"header","name":"Authorization","description":"Each Merchant API request must contain an authorization header in the following format:\n\n```\n'Authorization: Bearer '\n```\n\nTo use this API, you need to generate API keys from your Revolut Business account. The Secret key is used in the authorization header for all server calls, while the Public key is provided with payment methods at checkout.\n\n:::info\nFor detailed instructions on generating your API keys, see: [Generate API keys](https://developer.revolut.com/docs/guides/merchant/get-started#generate-api-keys).\n:::","descriptionNode":"$L1e8b"}}}] 1e89:["$","$L10f",null,{"exampleBlocks":{"application/json":{"variants":[{"key":"example_order_min_params","label":"Example order with minimal required parameters","rawValue":"$18:props:children:0:props:children:props:requestBody:content:application/json:examples:example_order_min_params:value","block":"$L1e8c"},{"key":"example_order_additional","label":"Example order with additional parameters","rawValue":"$18:props:children:0:props:children:props:requestBody:content:application/json:examples:example_order_additional:value","block":"$L1e8d"},{"key":"example_order_pre_auth","label":"Example order with pre-authorisation","rawValue":"$18:props:children:0:props:children:props:requestBody:content:application/json:examples:example_order_pre_auth:value","block":"$L1e8e"},{"key":"example_order_line_items","label":"Example order with line items","rawValue":"$18:props:children:0:props:children:props:requestBody:content:application/json:examples:example_order_line_items:value","block":"$L1e8f"},{"key":"example_order_shipping","label":"Example order with shipping details","rawValue":"$18:props:children:0:props:children:props:requestBody:content:application/json:examples:example_order_shipping:value","block":"$L1e90"},{"key":"example_order_airline","label":"Example order with additional airline data","rawValue":"$18:props:children:0:props:children:props:requestBody:content:application/json:examples:example_order_airline:value","block":"$L1e91"},{"key":"example_order_car_rental","label":"Example order with additional car rental data","rawValue":"$18:props:children:0:props:children:props:requestBody:content:application/json:examples:example_order_car_rental:value","block":"$L1e92"},{"key":"example_order_crypto","label":"Example order with additional crypto transaction data","rawValue":"$18:props:children:0:props:children:props:requestBody:content:application/json:examples:example_order_crypto:value","block":"$L1e93"},{"key":"example_order_marketplace","label":"Example order with additional marketplace data","rawValue":"$18:props:children:0:props:children:props:requestBody:content:application/json:examples:example_order_marketplace:value","block":"$L1e94"},{"key":"example_order_event","label":"Example order with additional event data","rawValue":"$18:props:children:0:props:children:props:requestBody:content:application/json:examples:example_order_event:value","block":"$L1e95"},{"key":"example_order_lodging","label":"Example order with additional lodging data","rawValue":"$18:props:children:0:props:children:props:requestBody:content:application/json:examples:example_order_lodging:value","block":"$L1e96"}],"syncedPropertyName":"$undefined"}},"title":"Request body samples","headingAs":"h4"}] 1e8a:["$","$L110",null,{"exampleBlocks":{"201":{"application/json":{"variants":[{"key":"example_order_min_params","label":"Example order response with minimal required parameters","rawValue":"$1a:props:children:0:props:children:props:responses:200:content:application/json:examples:example_order_min_params:value","block":"$L1e97"},{"key":"example_order_additional","label":"Example order response with additional parameters","rawValue":"$1a:props:children:0:props:children:props:responses:200:content:application/json:examples:example_order_additional:value","block":"$L1e98"},{"key":"example_order_pre_auth","label":"Example order response with pre-authorisation and card payment","rawValue":"$1a:props:children:0:props:children:props:responses:200:content:application/json:examples:example_order_pre_auth:value","block":"$L1e99"},{"key":"example_order_line_items","label":"example_order_line_items","rawValue":"$1a:props:children:0:props:children:props:responses:200:content:application/json:examples:example_order_line_items:value","block":"$L1e9a"},{"key":"example_order_shipping","label":"Example order response with shipping details","rawValue":"$1a:props:children:0:props:children:props:responses:200:content:application/json:examples:example_order_shipping:value","block":"$L1e9b"},{"key":"example_order_airline","label":"Example order response with additional airline data","rawValue":"$1a:props:children:0:props:children:props:responses:200:content:application/json:examples:example_order_airline:value","block":"$L1e9c"},{"key":"example_order_car_rental","label":"Example order response with additional car rental data","rawValue":"$1a:props:children:0:props:children:props:responses:200:content:application/json:examples:example_order_car_rental:value","block":"$L1e9d"},{"key":"example_order_crypto","label":"Example order response with additional crypto transaction data","rawValue":"$1a:props:children:0:props:children:props:responses:200:content:application/json:examples:example_order_crypto:value","block":"$L1e9e"},{"key":"example_order_marketplace","label":"Example order response with additional marketplace data","rawValue":"$1a:props:children:0:props:children:props:responses:200:content:application/json:examples:example_order_marketplace:value","block":"$L1e9f"},{"key":"example_order_event","label":"Example order response with additional event data","rawValue":"$1a:props:children:0:props:children:props:responses:200:content:application/json:examples:example_order_event:value","block":"$L1ea0"},{"key":"example_order_lodging","label":"Example order response with additional lodging data","rawValue":"$1a:props:children:0:props:children:props:responses:200:content:application/json:examples:example_order_lodging:value","block":"$L1ea1"}],"syncedPropertyName":"$undefined"}},"400":{"application/json":{"variants":[{"key":"default","label":"default","rawValue":"$18:props:children:0:props:children:props:responses:400:content:application/json:examples:default:value","block":"$L1ea2"}],"syncedPropertyName":"$undefined"}},"401":{"application/json":{"variants":[{"key":"default","label":"default","rawValue":"$18:props:children:0:props:children:props:responses:401:content:application/json:examples:default:value","block":"$L1ea3"}],"syncedPropertyName":"$undefined"}},"404":{"application/json":{"variants":[{"key":"default","label":"Example","rawValue":{"code":"string","message":"string","timestamp":123},"block":"$L1ea4"}],"syncedPropertyName":"$undefined"}}},"headingAs":"h4"}] 1a3a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The type of authorisation for the order. Used with manual capture mode. If omitted, ",["$","code","code-0",{"children":"final"}]," is used by default."]}],"\n",["$","h1","h1-0",{"children":"Pre-authorisation"}],"\n",["$","p","p-1",{"children":"Pre-authorisation allows you to reserve funds on a customer's card without immediately capturing them. This is useful for scenarios like:"}],"\n",["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":"Hotel bookings where the final amount may vary"}],"\n",["$","li","li-1",{"children":"Car rentals where additional charges may apply"}],"\n",["$","li","li-2",{"children":"Deposits that need to be held temporarily"}],"\n"]}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Parameter value","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"final"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Standard authorisation for immediate or near-immediate capture.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"pre_authorisation"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Reserve funds for later capture, used with manual capture mode.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["Pre-authorisation must be used with ",["$","code","code-0",{"children":"capture_mode: manual"}],". For more information, see ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#capture-order","target":"_blank","rel":"noreferrer","children":"Capture an order"}],"."]}]}]]}]]}] 1a3c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["Automatic cancellation period for uncaptured orders, specified in ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_8601","target":"_blank","rel":"noreferrer","children":"ISO 8601"}]," format."]}],"\n",["$","p","p-1",{"children":["After this period, the authorised payment is automatically cancelled and the order is cancelled. Maximum: 7 days = ",["$","code","code-0",{"children":"P7D"}],"."]}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"The following limitations apply:"}],["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["\n",["$","p","p-0",{"children":"Cannot be a negative value."}],"\n"]}],"\n",["$","li","li-1",{"children":["\n",["$","p","p-0",{"children":"Cannot be updated if the new value is less than or equal to the elapsed time since authorisation."}],"\n",["$","p","p-1",{"children":["$","strong","strong-0",{"children":"Failing scenario:"}]}],"\n",["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":"Original value: 7 days"}],"\n",["$","li","li-1",{"children":"Time since authorisation: 3 days"}],"\n",["$","li","li-2",{"children":"Update value: 2 days"}],"\n"]}],"\n",["$","p","p-2",{"children":"In this scenario, an error is returned."}],"\n",["$","p","p-3",{"children":["$","strong","strong-0",{"children":"Successful scenario:"}]}],"\n",["$","ul","ul-1",{"children":["\n",["$","li","li-0",{"children":"Original value: 7 days"}],"\n",["$","li","li-1",{"children":"Time since authorisation: 3 days"}],"\n",["$","li","li-2",{"children":"Update value: 4 days"}],"\n"]}],"\n",["$","p","p-4",{"children":"In this scenario, the parameter can be updated."}],"\n"]}],"\n",["$","li","li-2",{"children":["\n",["$","p","p-0",{"children":"Cannot be updated if cancellation is ≤ 30 minutes away."}],"\n",["$","p","p-1",{"children":["$","strong","strong-0",{"children":"Failing scenario:"}]}],"\n",["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":"Original value: 12 hours"}],"\n",["$","li","li-1",{"children":"Time since authorisation: 11 hours 40 minutes"}],"\n"]}],"\n",["$","p","p-2",{"children":"In this scenario, an error is returned."}],"\n",["$","p","p-3",{"children":["$","strong","strong-0",{"children":"Successful scenario:"}]}],"\n",["$","ul","ul-1",{"children":["\n",["$","li","li-0",{"children":"Original value: 12 hours"}],"\n",["$","li","li-1",{"children":"Time since authorisation: 11 hours 20 minutes"}],"\n"]}],"\n",["$","p","p-4",{"children":"In this scenario, the parameter can be updated."}],"\n"]}],"\n"]}]]}]]}]]}] 1a3d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The order total expressed in minor currency units, according to the ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_4217","target":"_blank","rel":"noreferrer","children":"ISO 4217 standard"}],". For example, ",["$","code","code-0",{"children":"7034"}]," in ",["$","code","code-1",{"children":"EUR"}]," corresponds to €70.34."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["Conversion between major and minor units varies by currency. For instance, ",["$","code","code-0",{"children":"100"}]," minor units equal £1.00 in ",["$","code","code-1",{"children":"GBP"}],", whereas in ",["$","code","code-2",{"children":"ISK"}]," they represent 100 units. For more details, see the ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_4217","target":"_blank","rel":"noreferrer","children":"ISO 4217 standard"}],"."]}],"\n",["$","li","li-1",{"children":["If ",["$","code","code-0",{"children":"line_items"}]," are provided, the order ",["$","code","code-1",{"children":"amount"}]," must equal the sum of all line items' ",["$","code","code-2",{"children":"total_amount"}],"."]}],"\n",["$","li","li-2",{"children":["For card payments with a non-zero amount, the order ",["$","code","code-0",{"children":"amount"}]," must be at least ",["$","strong","strong-0",{"children":"$$0.005"}]," (or equivalent in different currencies, calculated using Revolut's exchange rate on the payment date). Otherwise, card payments can't be performed."]}],"\n"]}]}]]}]]}] 1a3e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The amount not yet paid for a given order (in minor currency units). For example, ",["$","code","code-0",{"children":"7034"}]," represents €70.34."]}],"\n",["$","p","p-1",{"children":["The value in this field may differ from ",["$","code","code-0",{"children":"amount"}]," if there are partial payments associated with the order."]}]]}] 1a3f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The amount that was refunded from the order (in minor currency units). For example, ",["$","code","code-0",{"children":"7034"}]," represents €70.34."]}],"\n",["$","p","p-1",{"children":["This applies to orders that have been refunded (i.e., orders of type ",["$","code","code-0",{"children":"payment"}]," that have a related ",["$","code","code-1",{"children":"refund"}]," order)."]}]]}] 1a40:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":[["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_4217","target":"_blank","rel":"noreferrer","children":"ISO 4217"}]," currency code in upper case."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information about the supported currencies, see: ",["$","a","a-0",{"href":"https://help.revolut.com/business/help/merchant-accounts/payments/in-which-currencies-can-i-accept-payments/","target":"_blank","rel":"noreferrer","children":"Help Center"}],"."]}]}]]}]]}] 1a41:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":[["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_4217","target":"_blank","rel":"noreferrer","children":"ISO 4217"}]," currency code in upper case."]}],"\n",["$","p","p-1",{"children":["If ",["$","code","code-0",{"children":"settlement_currency"}]," is different from the value of ",["$","code","code-1",{"children":"currency"}],", the money will be exchanged when the amount is settled to your merchant account. In case of a refund or chargeback, the money will be exchanged to the order's initial ",["$","code","code-2",{"children":"currency"}],"."]}],"\n",["$","p","p-2",{"children":["If ",["$","code","code-0",{"children":"settlement_currency"}]," is not specified, this value is taken from ",["$","code","code-1",{"children":"currency"}],"."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information about the supported currencies, see: ",["$","a","a-0",{"href":"https://help.revolut.com/business/help/merchant-accounts/payments/in-which-currencies-can-i-accept-payments/","target":"_blank","rel":"noreferrer","children":"Help Center"}],"."]}]}]]}]]}] 1a43:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Permanent ID of a customer used to retrieve, update, delete a customer. This ID can also be used to link customer to an order."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":"If you provide the customer's ID during order creation, no other customer data is required, they will be parsed automatically from the referenced customer object."}]}]]}]]}] 1a44:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The full name of the customer."}]]}] 1a45:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The phone number of the customer in ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/E.164","target":"_blank","rel":"noreferrer","children":"E.164 format"}],"."]}]]}] 1a46:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The email address of the customer."}]]}] 1a47:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The birth date of the customer."}]]}] 1a48:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object containing information about a customer."}],"\n",["$","p","p-1",{"children":["If you have it, we strongly advise providing at least either ",["$","code","code-0",{"children":"id"}],", ",["$","code","code-1",{"children":"phone"}],", or ",["$","code","code-2",{"children":"email"}],"."]}],"\n",["$","p","p-2",{"children":["Using the ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#tag-customers","target":"_blank","rel":"noreferrer","children":"Customers operations"}],", you can manage customer instances."]}],"\n",["$","p","p-3",{"children":"The following behaviours apply to different use cases:"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Use case","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"API behavior","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":"Existing customer","className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["If ",["$","code","code-0",{"children":"id"}]," was provided, we ignore other customer details and associate the customer with the order.",["$","br","br-0",{}],["$","br","br-1",{}],"If either ",["$","code","code-1",{"children":"email"}],", ",["$","code","code-2",{"children":"phone"}],", or ",["$","code","code-3",{"children":"full_name"}]," was provided (without an existing customer's ",["$","code","code-4",{"children":"id"}],"), we always create a new customer, irrespective of another, existing customer object having the same details."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":"New customer","className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["If either ",["$","code","code-0",{"children":"email"}],", ",["$","code","code-1",{"children":"phone"}],", or ",["$","code","code-2",{"children":"full_name"}]," was provided, we create a new customer, irrespective of another customer object having the same details. ",["$","br","br-0",{}],["$","br","br-1",{}],"If ",["$","code","code-3",{"children":"id"}]," of a non-existent customer was provided, we return a ",["$","code","code-4",{"children":"404"}]," error, irrespective of other details provided."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["To avoid unintentional duplication of customer records, search for an existing customer by email or phone using the ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#retrieve-customer-list","target":"_blank","rel":"noreferrer","children":"List customers"}]," endpoint first, then provide ",["$","code","code-0",{"children":"customer.id"}]," in the order."]}]}]]}]]}] 1a49:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The ID of the payment."}]]}] 1a4a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The status of the payment."}]]}] 1a4b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The reason for a ",["$","code","code-0",{"children":"failed"}]," or ",["$","code","code-1",{"children":"declined"}]," payment."]}],"\n",["$","p","p-1",{"children":["A failed or declined payment can result from multiple reasons. To learn more, check our ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/reference/error-codes/decline-reasons","target":"_blank","rel":"noreferrer","children":"failure reasons"}],"."]}]]}] 1a4c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The reason for a ",["$","code","code-0",{"children":"failed"}]," or ",["$","code","code-1",{"children":"declined"}]," payment, sent by the financial institution processing the payment."]}]]}] 1a4d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The date and time the payment was created."}]]}] 1a4e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The date and time the payment was last updated."}]]}] 1a4f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Temporary token of the payment used to fetch the reward offer during checkout and link user registrations to the given offers."}],"\n",["$","p","p-1",{"children":"The token is only valid for a limited time."}]]}] 1a50:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The payment amount in minor units (e.g., cents). The value of this field depends on the payment type and state."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Payment type","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"State","className":"eowryt6","ref":"$undefined"}],["$","th","th-2",{"children":"Amount value","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":"Standard payment","className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Any","className":"eowryt7","ref":"$undefined"}],["$","td","td-2",{"children":"Total payment amount","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":"Pre-authorised payment","className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["$","code","code-0",{"children":"authorisation_started"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-2",{"children":"New amount being authorised (during increment processing)","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":"Pre-authorised payment","className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["$","code","code-0",{"children":"authorised"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-2",{"children":["Currently authorised amount (equals ",["$","code","code-0",{"children":"authorised_amount"}],")"],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For pre-authorised payments, see the ",["$","code","code-0",{"children":"authorised_amount"}]," field for tracking the currently authorised amount separately."]}]}]]}]]}] 1a51:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The currently authorised amount for this payment (in minor units)."}],"\n",["$","p","p-1",{"children":"For pre-authorised payments with incremental authorization:"}],"\n",["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["Initially equals the ",["$","code","code-0",{"children":"amount"}]," field"]}],"\n",["$","li","li-1",{"children":"Remains unchanged during increment processing"}],"\n",["$","li","li-2",{"children":"Updates to new amount upon successful increment"}],"\n",["$","li","li-3",{"children":"Remains at original amount if increment is declined"}],"\n"]}],"\n",["$","p","p-2",{"children":["For standard payments, this field may not be present or will equal the ",["$","code","code-0",{"children":"amount"}]," field."]}]]}] 1a52:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":[["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_4217","target":"_blank","rel":"noreferrer","children":"ISO 4217"}]," currency code in upper case."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information about the supported currencies, see: ",["$","a","a-0",{"href":"https://help.revolut.com/business/help/merchant-accounts/payments/in-which-currencies-can-i-accept-payments/","target":"_blank","rel":"noreferrer","children":"Help Center"}],"."]}]}]]}]]}] 1a53:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The amount of the settled payment (minor currency unit). For example, ",["$","code","code-0",{"children":"7034"}]," stands for €70.34."]}]]}] 1a54:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The currency of the settled payment. ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_4217","target":"_blank","rel":"noreferrer","children":"ISO 4217"}]," currency code in upper case."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information about the supported currencies, see: ",["$","a","a-0",{"href":"https://help.revolut.com/business/help/merchant-accounts/payments/in-which-currencies-can-i-accept-payments/","target":"_blank","rel":"noreferrer","children":"Help Center"}],"."]}]}]]}]]}] 1a55:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"ID of the saved payment method."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["The ",["$","code","code-0",{"children":"id"}]," parameter is only returned when the payment method is saved."]}]}]]}]]}] 1a56:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of payment method used to pay for the order."}],"\n",["$","p","p-1",{"children":"Available values:"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":["Payment method ",["$","code","code-0",{"children":"type"}]],"className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"apple_pay"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using Apple Pay.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"card"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using their credit or debit card.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"google_pay"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using Google Pay.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"revolut_pay_card"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order via Revolut Pay using their credit or debit card.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-4",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"revolut_pay_account"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order via Revolut Pay using their Revolut account.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-5",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"sepa_direct_debit"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using SEPA Direct Debit.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 1a57:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of the card."}]]}] 1a58:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of card funding."}]]}] 1a59:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The 2-letter country code of the country where the card was issued."}]]}] 1a5a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The BIN of the card."}]]}] 1a5b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The last four digits of the card number."}]]}] 1a5c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The expiry date of the card in the format of MM/YY."}]]}] 1a5d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The name of the cardholder."}]]}] 1a5e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The Electronic Commerce Indicator (ECI) value corresponds to the authentication result and indicates the level of security used when the payment information was provided."}]]}] 1a5f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The result of 3D Secure check."}]]}] 1a60:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The 3D Secure version."}]]}] 1a61:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The details of the 3D Secure check. Only for orders with successful payments."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":"Not returned for Apple Pay and Google Pay payments."}]}]]}]]}] 1a62:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The result of CVV verification."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Parameter value","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"match"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"CVV matches the card's CVV","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"not_match"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"CVV does not match the card's CVV","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"incorrect"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"CVV format is incorrect for this type of card","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"not_processed"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"CVV verification was not performed","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 1a63:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The result of address verification."}]]}] 1a64:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The result of postcode verification."}]]}] 1a65:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The result of cardholder verification."}]]}] 1a66:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The details of the check for card payment. Only for orders with successful payments."}]]}] 1a67:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The authorisation code (or auth code) is a short, alphanumeric code returned by the cardholder's issuing bank to the merchant's terminal or payment gateway."}],"\n",["$","p","p-1",{"children":"It serves as confirmation that the transaction has been approved and funds are available."}]]}] 1a68:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Acquirer Reference Number (ARN) of the payment."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":"Only returned for refund payments made by a card."}]}]]}]]}] 1a69:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The date and time by which the payment must be captured."}],"\n",["$","p","p-1",{"children":"After this deadline, the authorised funds may be automatically released by the card issuer."}]]}] 1a6a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The hardware identifier of the Revolut Terminal device used to process the payment."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":"Only present for card-present transactions processed via Revolut Terminal."}]}]]}]]}] 1a6c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A unique identifier for a payment method, always 44 characters long. This fingerprint can be used to uniquely identify various payment methods."}],"\n",["$","h1","h1-0",{"children":"Fingerprint generation"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Payment method","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","strong","strong-0",{"children":"All payment methods"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"A fingerprint is generated for all payment methods, including cards, Revolut Pay (card, account-to-account payments), Apple Pay, and Google Pay.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","strong","strong-0",{"children":"Cards (Revolut Pay & Card Gateway)"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"For cards, the fingerprint is based on the PAN. Cards processed via Revolut Pay and our card gateway will share the same fingerprint. Renewed cards (new expiry/CVV) retain the same fingerprint for efficient blocking.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","strong","strong-0",{"children":"Apple Pay & Google Pay"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Since Apple Pay and Google Pay provide us Device PANs (DPAN), the fingerprint is based on the DPAN provided by Apple/Google, not the connected card's PAN. This means that a new DPAN (and fingerprint) is generated for cards in case they are re-added to the customer's digital wallet, or added to different devices.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}],"\n",["$","h4","h4-0",{"children":"Detecting duplicate payment methods"}],"\n",["$","p","p-1",{"children":"Fingerprints are a valuable tool for detecting duplicate payment methods by identifying if a payment method has been seen before. This capability, in turn, helps in preventing various types of misuse (e.g., exploitation of free trials, or association with known problematic accounts, which can be a form of fraud). To effectively use fingerprints for this purpose, you will need to create and maintain your own lists (e.g., blocklists of known problematic fingerprints, allowlists for trusted customers, or tracking frequently used fingerprints)."}],"\n",["$","p","p-2",{"children":"The ideal way to utilise fingerprints is by combining them with a manual capture process. While automatic capture with subsequent refunds for problematic payments is possible, manual capture based on fingerprint validation is recommended."}],"\n",["$","p","p-3",{"children":"During your manual capture workflow, after a payment was authorised:"}],"\n",["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":"Check the fingerprint status by comparing it against your maintained lists and internal business rules."}],"\n",["$","li","li-1",{"children":["If you decide to proceed with the payment (e.g., the fingerprint is not on a blocklist, or matches a trusted customer's previous payment method): ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#capture-order","target":"_blank","rel":"noreferrer","children":"Capture the order"}],"."]}],"\n",["$","li","li-2",{"children":["If you decide not to proceed with the payment (e.g., the fingerprint matches a known fraudulent fingerprint, or exhibits suspicious patterns): ","$L1ea5","."]}],"\n"]}]]}] 1a6d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The Network Transaction ID (NTI) is a unique identifier assigned by the card scheme (e.g., Visa or Mastercard) to a card transaction."}],"\n",["$","p","p-1",{"children":"It can be used to trace the transaction across the payment network, link recurring or instalment payments to the original authorisation, and support dispute resolution."}]]}] 1a6e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object containing details of a card used via Apple Pay."}]]}] 1a6f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"ID of the saved payment method."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["The ",["$","code","code-0",{"children":"id"}]," parameter is only returned when the payment method is saved."]}]}]]}]]}] 1a70:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of payment method used to pay for the order."}],"\n",["$","p","p-1",{"children":"Available values:"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":["Payment method ",["$","code","code-0",{"children":"type"}]],"className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"apple_pay"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using Apple Pay.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"card"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using their credit or debit card.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"google_pay"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using Google Pay.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"revolut_pay_card"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order via Revolut Pay using their credit or debit card.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-4",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"revolut_pay_account"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order via Revolut Pay using their Revolut account.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-5",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"sepa_direct_debit"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using SEPA Direct Debit.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 1a71:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of the card."}]]}] 1a72:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of card funding."}]]}] 1a73:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The 2-letter country code of the country where the card was issued."}]]}] 1a74:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The BIN of the card."}]]}] 1a75:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The last four digits of the card number."}]]}] 1a76:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The expiry date of the card in the format of MM/YY."}]]}] 1a77:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The name of the cardholder."}]]}] 1a78:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The details of the check for card payment. Only for orders with successful payments."}]]}] 1a79:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The authorisation code (or auth code) is a short, alphanumeric code returned by the cardholder's issuing bank to the merchant's terminal or payment gateway."}],"\n",["$","p","p-1",{"children":"It serves as confirmation that the transaction has been approved and funds are available."}]]}] 1a7a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Acquirer Reference Number (ARN) of the payment."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":"Only returned for refund payments made by a card."}]}]]}]]}] 1a7b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The date and time by which the payment must be captured."}],"\n",["$","p","p-1",{"children":"After this deadline, the authorised funds may be automatically released by the card issuer."}]]}] 1a7c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The hardware identifier of the Revolut Terminal device used to process the payment."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":"Only present for card-present transactions processed via Revolut Terminal."}]}]]}]]}] 1a7e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A unique identifier for a payment method, always 44 characters long. This fingerprint can be used to uniquely identify various payment methods."}],"\n",["$","h1","h1-0",{"children":"Fingerprint generation"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Payment method","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","strong","strong-0",{"children":"All payment methods"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"A fingerprint is generated for all payment methods, including cards, Revolut Pay (card, account-to-account payments), Apple Pay, and Google Pay.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","strong","strong-0",{"children":"Cards (Revolut Pay & Card Gateway)"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"For cards, the fingerprint is based on the PAN. Cards processed via Revolut Pay and our card gateway will share the same fingerprint. Renewed cards (new expiry/CVV) retain the same fingerprint for efficient blocking.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","strong","strong-0",{"children":"Apple Pay & Google Pay"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Since Apple Pay and Google Pay provide us Device PANs (DPAN), the fingerprint is based on the DPAN provided by Apple/Google, not the connected card's PAN. This means that a new DPAN (and fingerprint) is generated for cards in case they are re-added to the customer's digital wallet, or added to different devices.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}],"\n",["$","h4","h4-0",{"children":"Detecting duplicate payment methods"}],"\n",["$","p","p-1",{"children":"Fingerprints are a valuable tool for detecting duplicate payment methods by identifying if a payment method has been seen before. This capability, in turn, helps in preventing various types of misuse (e.g., exploitation of free trials, or association with known problematic accounts, which can be a form of fraud). To effectively use fingerprints for this purpose, you will need to create and maintain your own lists (e.g., blocklists of known problematic fingerprints, allowlists for trusted customers, or tracking frequently used fingerprints)."}],"\n",["$","p","p-2",{"children":"The ideal way to utilise fingerprints is by combining them with a manual capture process. While automatic capture with subsequent refunds for problematic payments is possible, manual capture based on fingerprint validation is recommended."}],"\n",["$","p","p-3",{"children":"During your manual capture workflow, after a payment was authorised:"}],"\n",["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":"Check the fingerprint status by comparing it against your maintained lists and internal business rules."}],"\n",["$","li","li-1",{"children":["If you decide to proceed with the payment (e.g., the fingerprint is not on a blocklist, or matches a trusted customer's previous payment method): ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#capture-order","target":"_blank","rel":"noreferrer","children":"Capture the order"}],"."]}],"\n",["$","li","li-2",{"children":["If you decide not to proceed with the payment (e.g., the fingerprint matches a known fraudulent fingerprint, or exhibits suspicious patterns): ","$L1ea6","."]}],"\n"]}]]}] 1a7f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The Network Transaction ID (NTI) is a unique identifier assigned by the card scheme (e.g., Visa or Mastercard) to a card transaction."}],"\n",["$","p","p-1",{"children":"It can be used to trace the transaction across the payment network, link recurring or instalment payments to the original authorisation, and support dispute resolution."}]]}] 1a80:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object containing details of the card used for the payment."}]]}] 1a81:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"ID of the saved payment method."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["The ",["$","code","code-0",{"children":"id"}]," parameter is only returned when the payment method is saved."]}]}]]}]]}] 1a82:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of payment method used to pay for the order."}],"\n",["$","p","p-1",{"children":"Available values:"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":["Payment method ",["$","code","code-0",{"children":"type"}]],"className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"apple_pay"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using Apple Pay.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"card"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using their credit or debit card.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"google_pay"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using Google Pay.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"revolut_pay_card"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order via Revolut Pay using their credit or debit card.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-4",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"revolut_pay_account"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order via Revolut Pay using their Revolut account.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-5",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"sepa_direct_debit"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using SEPA Direct Debit.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 1a83:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of the card."}]]}] 1a84:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of card funding."}]]}] 1a85:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The 2-letter country code of the country where the card was issued."}]]}] 1a86:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The BIN of the card."}]]}] 1a87:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The last four digits of the card number."}]]}] 1a88:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The expiry date of the card in the format of MM/YY."}]]}] 1a89:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The name of the cardholder."}]]}] 1a8a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The details of the check for card payment. Only for orders with successful payments."}]]}] 1a8b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The authorisation code (or auth code) is a short, alphanumeric code returned by the cardholder's issuing bank to the merchant's terminal or payment gateway."}],"\n",["$","p","p-1",{"children":"It serves as confirmation that the transaction has been approved and funds are available."}]]}] 1a8c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Acquirer Reference Number (ARN) of the payment."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":"Only returned for refund payments made by a card."}]}]]}]]}] 1a8d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The date and time by which the payment must be captured."}],"\n",["$","p","p-1",{"children":"After this deadline, the authorised funds may be automatically released by the card issuer."}]]}] 1a8e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The hardware identifier of the Revolut Terminal device used to process the payment."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":"Only present for card-present transactions processed via Revolut Terminal."}]}]]}]]}] 1a90:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A unique identifier for a payment method, always 44 characters long. This fingerprint can be used to uniquely identify various payment methods."}],"\n",["$","h1","h1-0",{"children":"Fingerprint generation"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Payment method","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","strong","strong-0",{"children":"All payment methods"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"A fingerprint is generated for all payment methods, including cards, Revolut Pay (card, account-to-account payments), Apple Pay, and Google Pay.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","strong","strong-0",{"children":"Cards (Revolut Pay & Card Gateway)"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"For cards, the fingerprint is based on the PAN. Cards processed via Revolut Pay and our card gateway will share the same fingerprint. Renewed cards (new expiry/CVV) retain the same fingerprint for efficient blocking.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","strong","strong-0",{"children":"Apple Pay & Google Pay"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Since Apple Pay and Google Pay provide us Device PANs (DPAN), the fingerprint is based on the DPAN provided by Apple/Google, not the connected card's PAN. This means that a new DPAN (and fingerprint) is generated for cards in case they are re-added to the customer's digital wallet, or added to different devices.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}],"\n",["$","h4","h4-0",{"children":"Detecting duplicate payment methods"}],"\n",["$","p","p-1",{"children":"Fingerprints are a valuable tool for detecting duplicate payment methods by identifying if a payment method has been seen before. This capability, in turn, helps in preventing various types of misuse (e.g., exploitation of free trials, or association with known problematic accounts, which can be a form of fraud). To effectively use fingerprints for this purpose, you will need to create and maintain your own lists (e.g., blocklists of known problematic fingerprints, allowlists for trusted customers, or tracking frequently used fingerprints)."}],"\n",["$","p","p-2",{"children":"The ideal way to utilise fingerprints is by combining them with a manual capture process. While automatic capture with subsequent refunds for problematic payments is possible, manual capture based on fingerprint validation is recommended."}],"\n",["$","p","p-3",{"children":"During your manual capture workflow, after a payment was authorised:"}],"\n",["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":"Check the fingerprint status by comparing it against your maintained lists and internal business rules."}],"\n",["$","li","li-1",{"children":["If you decide to proceed with the payment (e.g., the fingerprint is not on a blocklist, or matches a trusted customer's previous payment method): ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#capture-order","target":"_blank","rel":"noreferrer","children":"Capture the order"}],"."]}],"\n",["$","li","li-2",{"children":["If you decide not to proceed with the payment (e.g., the fingerprint matches a known fraudulent fingerprint, or exhibits suspicious patterns): ","$L1ea7","."]}],"\n"]}]]}] 1a91:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The Network Transaction ID (NTI) is a unique identifier assigned by the card scheme (e.g., Visa or Mastercard) to a card transaction."}],"\n",["$","p","p-1",{"children":"It can be used to trace the transaction across the payment network, link recurring or instalment payments to the original authorisation, and support dispute resolution."}]]}] 1a92:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object containing details of a card used via Google Pay."}]]}] 1a93:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"ID of the saved payment method."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["The ",["$","code","code-0",{"children":"id"}]," parameter is only returned when the payment method is saved."]}]}]]}]]}] 1a94:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of payment method used to pay for the order."}],"\n",["$","p","p-1",{"children":"Available values:"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":["Payment method ",["$","code","code-0",{"children":"type"}]],"className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"apple_pay"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using Apple Pay.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"card"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using their credit or debit card.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"google_pay"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using Google Pay.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"revolut_pay_card"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order via Revolut Pay using their credit or debit card.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-4",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"revolut_pay_account"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order via Revolut Pay using their Revolut account.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-5",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"sepa_direct_debit"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using SEPA Direct Debit.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 1a95:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of the card."}]]}] 1a96:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of card funding."}]]}] 1a97:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The 2-letter country code of the country where the card was issued."}]]}] 1a98:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The BIN of the card."}]]}] 1a99:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The last four digits of the card number."}]]}] 1a9a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The expiry date of the card in the format of MM/YY."}]]}] 1a9b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The name of the cardholder."}]]}] 1a9c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The details of the check for card payment. Only for orders with successful payments."}]]}] 1a9d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The authorisation code (or auth code) is a short, alphanumeric code returned by the cardholder's issuing bank to the merchant's terminal or payment gateway."}],"\n",["$","p","p-1",{"children":"It serves as confirmation that the transaction has been approved and funds are available."}]]}] 1a9e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Acquirer Reference Number (ARN) of the payment."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":"Only returned for refund payments made by a card."}]}]]}]]}] 1a9f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The date and time by which the payment must be captured."}],"\n",["$","p","p-1",{"children":"After this deadline, the authorised funds may be automatically released by the card issuer."}]]}] 1aa0:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The hardware identifier of the Revolut Terminal device used to process the payment."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":"Only present for card-present transactions processed via Revolut Terminal."}]}]]}]]}] 1aa2:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A unique identifier for a payment method, always 44 characters long. This fingerprint can be used to uniquely identify various payment methods."}],"\n",["$","h1","h1-0",{"children":"Fingerprint generation"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Payment method","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","strong","strong-0",{"children":"All payment methods"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"A fingerprint is generated for all payment methods, including cards, Revolut Pay (card, account-to-account payments), Apple Pay, and Google Pay.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","strong","strong-0",{"children":"Cards (Revolut Pay & Card Gateway)"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"For cards, the fingerprint is based on the PAN. Cards processed via Revolut Pay and our card gateway will share the same fingerprint. Renewed cards (new expiry/CVV) retain the same fingerprint for efficient blocking.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","strong","strong-0",{"children":"Apple Pay & Google Pay"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Since Apple Pay and Google Pay provide us Device PANs (DPAN), the fingerprint is based on the DPAN provided by Apple/Google, not the connected card's PAN. This means that a new DPAN (and fingerprint) is generated for cards in case they are re-added to the customer's digital wallet, or added to different devices.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}],"\n",["$","h4","h4-0",{"children":"Detecting duplicate payment methods"}],"\n",["$","p","p-1",{"children":"Fingerprints are a valuable tool for detecting duplicate payment methods by identifying if a payment method has been seen before. This capability, in turn, helps in preventing various types of misuse (e.g., exploitation of free trials, or association with known problematic accounts, which can be a form of fraud). To effectively use fingerprints for this purpose, you will need to create and maintain your own lists (e.g., blocklists of known problematic fingerprints, allowlists for trusted customers, or tracking frequently used fingerprints)."}],"\n",["$","p","p-2",{"children":"The ideal way to utilise fingerprints is by combining them with a manual capture process. While automatic capture with subsequent refunds for problematic payments is possible, manual capture based on fingerprint validation is recommended."}],"\n",["$","p","p-3",{"children":"During your manual capture workflow, after a payment was authorised:"}],"\n",["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":"Check the fingerprint status by comparing it against your maintained lists and internal business rules."}],"\n",["$","li","li-1",{"children":["If you decide to proceed with the payment (e.g., the fingerprint is not on a blocklist, or matches a trusted customer's previous payment method): ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#capture-order","target":"_blank","rel":"noreferrer","children":"Capture the order"}],"."]}],"\n",["$","li","li-2",{"children":["If you decide not to proceed with the payment (e.g., the fingerprint matches a known fraudulent fingerprint, or exhibits suspicious patterns): ","$L1ea8","."]}],"\n"]}]]}] 1aa3:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The Network Transaction ID (NTI) is a unique identifier assigned by the card scheme (e.g., Visa or Mastercard) to a card transaction."}],"\n",["$","p","p-1",{"children":"It can be used to trace the transaction across the payment network, link recurring or instalment payments to the original authorisation, and support dispute resolution."}]]}] 1aa4:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object containing details of a card used via Revolut Pay."}]]}] 1aa5:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"ID of the saved payment method."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["The ",["$","code","code-0",{"children":"id"}]," parameter is only returned when the payment method is saved."]}]}]]}]]}] 1aa6:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of payment method used to pay for the order."}],"\n",["$","p","p-1",{"children":"Available values:"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":["Payment method ",["$","code","code-0",{"children":"type"}]],"className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"apple_pay"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using Apple Pay.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"card"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using their credit or debit card.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"google_pay"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using Google Pay.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"revolut_pay_card"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order via Revolut Pay using their credit or debit card.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-4",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"revolut_pay_account"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order via Revolut Pay using their Revolut account.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-5",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"sepa_direct_debit"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using SEPA Direct Debit.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 1aa8:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A unique identifier for a payment method, always 44 characters long. This fingerprint can be used to uniquely identify various payment methods."}],"\n",["$","h1","h1-0",{"children":"Fingerprint generation"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Payment method","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","strong","strong-0",{"children":"All payment methods"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"A fingerprint is generated for all payment methods, including cards, Revolut Pay (card, account-to-account payments), Apple Pay, and Google Pay.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","strong","strong-0",{"children":"Cards (Revolut Pay & Card Gateway)"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"For cards, the fingerprint is based on the PAN. Cards processed via Revolut Pay and our card gateway will share the same fingerprint. Renewed cards (new expiry/CVV) retain the same fingerprint for efficient blocking.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","strong","strong-0",{"children":"Apple Pay & Google Pay"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Since Apple Pay and Google Pay provide us Device PANs (DPAN), the fingerprint is based on the DPAN provided by Apple/Google, not the connected card's PAN. This means that a new DPAN (and fingerprint) is generated for cards in case they are re-added to the customer's digital wallet, or added to different devices.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}],"\n",["$","h4","h4-0",{"children":"Detecting duplicate payment methods"}],"\n",["$","p","p-1",{"children":"Fingerprints are a valuable tool for detecting duplicate payment methods by identifying if a payment method has been seen before. This capability, in turn, helps in preventing various types of misuse (e.g., exploitation of free trials, or association with known problematic accounts, which can be a form of fraud). To effectively use fingerprints for this purpose, you will need to create and maintain your own lists (e.g., blocklists of known problematic fingerprints, allowlists for trusted customers, or tracking frequently used fingerprints)."}],"\n",["$","p","p-2",{"children":"The ideal way to utilise fingerprints is by combining them with a manual capture process. While automatic capture with subsequent refunds for problematic payments is possible, manual capture based on fingerprint validation is recommended."}],"\n",["$","p","p-3",{"children":"During your manual capture workflow, after a payment was authorised:"}],"\n",["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":"Check the fingerprint status by comparing it against your maintained lists and internal business rules."}],"\n",["$","li","li-1",{"children":["If you decide to proceed with the payment (e.g., the fingerprint is not on a blocklist, or matches a trusted customer's previous payment method): ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#capture-order","target":"_blank","rel":"noreferrer","children":"Capture the order"}],"."]}],"\n",["$","li","li-2",{"children":["If you decide not to proceed with the payment (e.g., the fingerprint matches a known fraudulent fingerprint, or exhibits suspicious patterns): ","$L1ea9","."]}],"\n"]}]]}] 1aa9:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"ID of the saved payment method."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["The ",["$","code","code-0",{"children":"id"}]," parameter is only returned when the payment method is saved for the merchant."]}]}]]}]]}] 1aaa:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of payment method used to pay for the order."}],"\n",["$","p","p-1",{"children":"Available values:"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":["Payment method ",["$","code","code-0",{"children":"type"}]],"className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"apple_pay"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using Apple Pay.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"card"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using their credit or debit card.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"google_pay"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using Google Pay.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"revolut_pay_card"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order via Revolut Pay using their credit or debit card.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-4",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"revolut_pay_account"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order via Revolut Pay using their Revolut account.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-5",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"sepa_direct_debit"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using SEPA Direct Debit.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 1aab:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The last four digits of the debtor's IBAN."}]]}] 1aac:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The full name of the debtor as provided in the mandate."}]]}] 1aad:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The unique mandate reference generated by Revolut. Include this in pre-debit notifications sent to your customers."}]]}] 1aae:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object containing details of a SEPA Direct Debit payment."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/accept-payments/payment-methods/sepa-direct-debit/server-to-server","target":"_blank","rel":"noreferrer","children":"SEPA Direct Debit server-to-server integration"}]]}]}]]}]]}] 1aaf:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The details of the payment method used to make the payment."}]]}] 1ab0:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Type of the authentication challenge the payment triggers."}]]}] 1ab1:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The URL of the authentication challenge."}]]}] 1ab2:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Information about the 3DS challenge."}]]}] 1ab3:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Type of the authentication challenge the payment triggers."}]]}] 1ab4:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The URL of the fingerprint. (Used only internally by Revolut.)"}]]}] 1ab5:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Data about the fingerprint used for authentication. (Used only internally\nby Revolut.)"}]]}] 1ab6:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Information about the 3DS fingerprint challenge."}]]}] 1ab7:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["Details about the authentication challenge that should be performed to complete the authentication process. For more information about Revolut's 3DS solution, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/reference/3d-secure","target":"_blank","rel":"noreferrer","children":"3D Secure overview"}],"."]}],"\n",["$","p","p-1",{"children":["Only returned if the payment's state is ",["$","code","code-0",{"children":"authentication_challenge"}],"."]}]]}] 1ab8:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Street line 1 information."}]]}] 1ab9:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Street line 2 information."}]]}] 1aba:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The region associated with the address."}]]}] 1abb:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The city associated with the address."}]]}] 1abc:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The 2-letter country code of the country associated with the address."}]]}] 1abd:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The postcode associated with the address."}]]}] 1abe:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object containing address details."}]]}] 1abf:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The risk level of the card."}],"\n",["$","p","p-1",{"children":["If the risk level is ",["$","code","code-0",{"children":"high"}],", the payment might be declined."]}]]}] 1ac0:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of the order fee."}]]}] 1ac1:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The amount of the payment fee (minor currency unit). For example, enter ",["$","code","code-0",{"children":"7034"}]," for €70.34 in the field."]}]]}] 1ac2:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The currency of the payment fee. ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_4217","target":"_blank","rel":"noreferrer","children":"ISO 4217"}]," currency code in upper case."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information about the supported currencies, see: ",["$","a","a-0",{"href":"https://help.revolut.com/business/help/merchant-accounts/payments/in-which-currencies-can-i-accept-payments/","target":"_blank","rel":"noreferrer","children":"Help Center"}],"."]}]}]]}]]}] 1ac3:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The details of the order fee."}]]}] 1ac4:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The email of the person who made the payment."}]]}] 1ac5:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The phone number of the payer in ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/E.164","target":"_blank","rel":"noreferrer","children":"E.164 format"}],"."]}]]}] 1ac6:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The person who made the payment. This object is present when an email or phone number is provided during the payment flow."}],"\n",["$","p","p-1",{"children":"Capturing payer details lets you identify exactly who authorised the charge, reach the right person for receipts or refund queries, and support compliance or fraud-review workflows where the paying identity matters."}]]}] 1ac7:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Represents a payment for an order."}],"\n",["$","p","p-1",{"children":["For pre-authorised payments, the ",["$","code","code-0",{"children":"authorised_amount"}]," field tracks the currently authorised amount, which may differ from ",["$","code","code-1",{"children":"amount"}]," during incremental authorisation processing."]}]]}] 1ac8:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The details of all the payments that have been made towards this order (successful or unsuccessful)."}]]}] 1ac9:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The new total amount requested in this increment (in minor units)."}]]}] 1aca:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The previously authorised amount before this increment (in minor units)."}]]}] 1acb:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The state of this incremental authorization attempt."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"State","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"pending"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Increment registered in system, not yet submitted to card network","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"processing"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Increment is being processed by card network","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"authorised"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Increment was successfully authorised","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"declined"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Increment was declined by card issuer","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-4",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"failed"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Increment failed due to technical error (not an issuer decline)","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 1acc:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"External reference for this incremental authorisation."}],"\n",["$","div","inlinealert-0",{"data-type":"tip","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"Lightbulb","color":"var(--rui-color-success)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":"Use your internal charge or invoice ID. This reference is returned in webhooks for easy matching to your system."}]}]]}]]}] 1acd:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Name of the line item."}]]}] 1ace:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Type of the line item."}]]}] 1acf:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The number of units of the line item."}]]}] 1ad0:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The measurement unit for the quantity, such as ",["$","code","code-0",{"children":"cm"}],", or ",["$","code","code-1",{"children":"kg"}],"."]}]]}] 1ad1:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object representing the quantity details of a line item, including the amount and its associated unit of measurement."}]]}] 1ad2:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The unit price of the line item."}]]}] 1ad3:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The total amount to be paid for the line item, including taxes and discounts."}]]}] 1ad4:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unique identifier of line item in the merchant's system."}]]}] 1ad5:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The specific name or label of the discount applied to the line item."}]]}] 1ad6:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The monetary value of the discount."}]]}] 1ad7:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Details of a discount applied to the line item, including its name and monetary value."}]]}] 1ad8:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A list of discounts applied to the line item. Each discount should be subtracted from the total amount payable for the item."}]]}] 1ad9:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The specific name or designation of the tax applied to the line item."}]]}] 1ada:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The monetary value of the tax in minor currency units (e.g., cents for EUR)."}]]}] 1adb:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Details about a tax applied to the line item, including its name and the corresponding amount."}]]}] 1adc:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A list of taxes applied to the line item. Each tax should be added to the total amount payable for the item."}]]}] 1add:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"URL to an image associated with the line item."}],"\n",["$","div","inlinealert-0",{"data-type":"warning","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMark","color":"var(--rui-color-warning)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"Restrictions:"}],["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["Must be a valid URI as defined by ",["$","a","a-0",{"href":"https://datatracker.ietf.org/doc/html/rfc3986","target":"_blank","rel":"noreferrer","children":"RFC 3986"}]]}],"\n",["$","li","li-1",{"children":["URI scheme is required and must be either ",["$","code","code-0",{"children":"http"}]," or ",["$","code","code-1",{"children":"https"}]]}],"\n",["$","li","li-2",{"children":["URI host is required and cannot be ",["$","code","code-0",{"children":"localhost"}]," or an IP address"]}],"\n",["$","li","li-3",{"children":["Max length: ",["$","code","code-0",{"children":"2000"}]]}],"\n",["$","li","li-4",{"children":["Reserved or invalid characters must be percent-encoded (for example, use ",["$","code","code-0",{"children":"%20"}]," instead of a space)"]}],"\n"]}]]}]]}]]}] 1ade:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A list of URLs pointing to images related to the line item. These images can provide visual details or representations of the item."}]]}] 1adf:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Description of the line item."}]]}] 1ae0:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An HTTP/HTTPS URL that links to more information about the line item, such as a product page or details."}],"\n",["$","div","inlinealert-0",{"data-type":"warning","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMark","color":"var(--rui-color-warning)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"Restrictions:"}],["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["Must be a valid URI as defined by ",["$","a","a-0",{"href":"https://datatracker.ietf.org/doc/html/rfc3986","target":"_blank","rel":"noreferrer","children":"RFC 3986"}]]}],"\n",["$","li","li-1",{"children":["URI scheme is required and must be either ",["$","code","code-0",{"children":"http"}]," or ",["$","code","code-1",{"children":"https"}]]}],"\n",["$","li","li-2",{"children":["URI host is required and cannot be ",["$","code","code-0",{"children":"localhost"}]," or an IP address"]}],"\n",["$","li","li-3",{"children":["Max length: ",["$","code","code-0",{"children":"2000"}]]}],"\n",["$","li","li-4",{"children":["Reserved or invalid characters must be percent-encoded (for example, use ",["$","code","code-0",{"children":"%20"}]," instead of a space)"]}],"\n"]}]]}]]}]]}] 1ae1:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Line items associated with this increment (if provided)."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":"If the increment is successful, these line items will override the existing order line items."}]}]]}]]}] 1ae2:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Reason why increment was declined or failed."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["Only present when ",["$","code","code-0",{"children":"state"}]," is ",["$","code","code-1",{"children":"declined"}]," or ",["$","code","code-2",{"children":"failed"}],"."]}]}]]}]]}] 1ae3:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Represents a single incremental authorisation attempt on an order."}],"\n",["$","p","p-1",{"children":["The ",["$","code","code-0",{"children":"incremental_authorisations"}]," array tracks all increment attempts (successful and failed) in chronological order."]}]]}] 1ae4:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"History of incremental authorisation attempts for this order."}],"\n",["$","p","p-1",{"children":["Only present for orders with ",["$","code","code-0",{"children":"authorisation_type: pre_authorisation"}],"."]}],"\n",["$","p","p-2",{"children":"Contains all increment attempts in chronological order."}]]}] 1ae5:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unique ID representing the location where merchants sells products."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#tag-locations","target":"_blank","rel":"noreferrer","children":"Locations"}],"."]}]}]]}]]}] 1ae6:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Additional metadata value provided with the corresponding metadata key."}]]}] 1ae7:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["Additional information to track your orders in your system, by providing custom metadata using ",["$","code","code-0",{"children":"\"\" : \"\""}]," pairs."]}],"\n",["$","div","inlinealert-0",{"data-type":"warning","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMark","color":"var(--rui-color-warning)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":["$","strong","strong-0",{"children":"Restrictions:"}]}],["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["Both keys and values must be ",["$","code","code-0",{"children":"string"}],"s"]}],"\n",["$","li","li-1",{"children":["Values cannot be ",["$","code","code-0",{"children":"null"}],"."]}],"\n",["$","li","li-2",{"children":["Max number of key-value pairs: ",["$","code","code-0",{"children":"50"}]]}],"\n",["$","li","li-3",{"children":["Max length of values: ",["$","code","code-0",{"children":"500"}]," characters"]}],"\n",["$","li","li-4",{"children":["Format of keys: Must start with a letter and contain only letters, digits, and underscores. Max 40 characters. Pattern: ",["$","code","code-0",{"children":"^[a-zA-Z][a-zA-Z\\\\d_]{0,39}$"}]]}],"\n"]}]]}]]}]]}] 1ae9:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Type of the industry-specific data object, determining what additional data is expected."}],"\n",["$","p","p-1",{"children":"Available types:"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Object type","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"airline"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about a specific airline ticket purchase.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"car_rental"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about a car rental booking associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"crypto"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about crypto transactions associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"marketplace"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["This object is required by Mastercard and Visa for merchants operating as marketplaces under the ",["$","strong","strong-0",{"children":"Merchant Category Code (MCC):"}]," ",["$","code","code-0",{"children":"5262"}],". The marketplace object ensures compliance with the card schemes' regulations by providing detailed information about the subseller involved in the transaction."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-4",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"event"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about event ticket bookings associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-5",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"lodging"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about lodging bookings associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 1aea:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A unique identifier provided by the merchant associated with the order."}],"\n",["$","p","p-1",{"children":["This ",["$","code","code-0",{"children":"booking_id"}]," is used to reference and correlate booking information with the Merchant API and the merchant's internal system."]}]]}] 1aeb:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The UTC date and time of the final journey leg."}],"\n",["$","div","inlinealert-0",{"data-type":"warning","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMark","color":"var(--rui-color-warning)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"The following limitations apply:"}],["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["When creating or updating an order, ",["$","code","code-0",{"children":"fulfillment_date"}]," cannot be set to a date in the past."]}],"\n",["$","li","li-1",{"children":["When updating an order, if the current ",["$","code","code-0",{"children":"fulfillment_date"}]," value is already in the past, it cannot be modified. The date must remain as is to maintain data integrity for completed transactions."]}],"\n"]}]]}]]}]]}] 1aec:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["Flag indicating whether the order includes actual ticket purchases. Set to ",["$","code","code-0",{"children":"true"}]," if the order contains ticket purchases, and ",["$","code","code-1",{"children":"false"}]," if it does not (e.g., it ",["$","strong","strong-0",{"children":"only"}]," contains seat reservations, or baggage upgrades)."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":["This field is required for activating ",["$","strong","strong-0",{"children":"Revolut Flight Alerts"}]," functionalities within the Revolut app."]}],["$","p","p-1",{"children":"Provide the info on order creation or update, before capturing the order."}]]}]]}]]}] 1aed:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of the ticket."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Parameter value","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"fixed"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Non-modifiable once confirmed.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"flexible"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Allows modifications or cancellations under specified conditions.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 1aee:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The code of the Computer Reservation System (CRS) used to make the booking and purchase the ticket."}]]}] 1aef:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Parameter indicating whether this order is related to a new ticket reservation or a modification of an existing one."}]]}] 1af0:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Parameter indicating whether the booking is refundable, partially refundable, or not refundable."}]]}] 1af1:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Passenger's first name."}]]}] 1af2:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Passenger's last name."}]]}] 1af3:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Array containing information of passengers associated with the booking."}]]}] 1af4:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Sequence of the journey legs. Increment by 1 for each flight included in the ticket."}],"\n",["$","p","p-1",{"children":["For example: For a ",["$","code","code-0",{"children":"FRA > LHR > DUB > LHR > FRA"}]," journey the sequence will be assigned as:"]}],"\n",["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":[["$","code","code-0",{"children":"FRA > LHR"}],": 1"]}],"\n",["$","li","li-1",{"children":[["$","code","code-0",{"children":"LHR > DUB"}],": 2"]}],"\n",["$","li","li-2",{"children":[["$","code","code-0",{"children":"DUB > LHR"}],": 3"]}],"\n",["$","li","li-3",{"children":[["$","code","code-0",{"children":"LHR > FRA"}],": 4"]}],"\n"]}]]}] 1af5:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://www.iata.org/en/services/codes","target":"_blank","rel":"noreferrer","children":"IATA"}]," 3-letter airport code for the departure airport."]}]]}] 1af6:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://www.iata.org/en/services/codes","target":"_blank","rel":"noreferrer","children":"IATA"}]," 3-letter airport code for the arrival airport."]}]]}] 1af7:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The flight identifier, without airline code."}]]}] 1af8:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The fare base code for the given journey leg."}]]}] 1af9:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The UTC date and time of the flight departure for the given journey leg."}]]}] 1afa:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The name of the airline associated with the journey leg."}]]}] 1afb:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The IATA 2-letter accounting code identifying the airline associated with the journey leg."}]]}] 1afc:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The Passenger Name Record (PNR) for the journey leg issued by the airline."}],"\n",["$","p","p-1",{"children":"PNR is a unique identifier for the booking, acting as a digital certificate allowing passengers to retrieve or manage their booking details."}],"\n",["$","div","inlinealert-0",{"data-type":"warning","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMark","color":"var(--rui-color-warning)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":"This is a required field for OTAs."}]}]]}]]}] 1afd:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Array containing information of journey legs associated with the booking."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":["This field is required for activating ",["$","strong","strong-0",{"children":"Revolut Flight Alerts"}]," functionalities within the Revolut app."]}],["$","p","p-1",{"children":"This information is used to compile a tracking widget that provides real-time updates on flight status and sends notifications, such as a check-in reminders, boarding alerts, and notifications for cancellations or delays."}],["$","p","p-2",{"children":"To enable the widget the following fields are required on order creation or update, before capturing the order:"}],"$L1eaa"]}]]}]]}] 1afe:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"URL to the online portal for managing the airline booking, which includes check-in functionality. This URL may be a personalised, pre-populated check-in link specific to the user or a generic link, and it is essential for enabling direct access to booking details within the Revolut app."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":["This field is required for activating ",["$","strong","strong-0",{"children":"Revolut Flight Alerts"}]," functionalities within the Revolut app."]}],["$","p","p-1",{"children":"Provide the info on order creation or update, before capturing the order."}]]}]]}],"\n",["$","div","inlinealert-1",{"data-type":"warning","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMark","color":"var(--rui-color-warning)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"Restrictions:"}],["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["Must be a valid URI as defined by ",["$","a","a-0",{"href":"https://datatracker.ietf.org/doc/html/rfc3986","target":"_blank","rel":"noreferrer","children":"RFC 3986"}]]}],"\n",["$","li","li-1",{"children":["URI scheme is required and must be either ",["$","code","code-0",{"children":"http"}]," or ",["$","code","code-1",{"children":"https"}]]}],"\n",["$","li","li-2",{"children":["URI host is required and cannot be ",["$","code","code-0",{"children":"localhost"}]," or an IP address"]}],"\n",["$","li","li-3",{"children":["Max length: ",["$","code","code-0",{"children":"2000"}]]}],"\n",["$","li","li-4",{"children":["Reserved or invalid characters must be percent-encoded (for example, use ",["$","code","code-0",{"children":"%20"}]," instead of a space)"]}],"\n"]}]]}]]}]]}] 1aff:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object containing additional information about an airline booking associated with the order."}],"\n",["$","p","p-1",{"children":["Use this object to provide required data to enable ",["$","strong","strong-0",{"children":"Revolut Flight Alerts"}],". This feature allows users to receive real-time flight updates such as check-in reminders, boarding alerts, and notifications for cancellations or delays in the Revolut app."]}],"\n",["$","p","p-2",{"children":["To enable ",["$","strong","strong-0",{"children":"Revolut Flight Alerts"}]," functionalities in the Revolut app, the following fields are ",["$","strong","strong-1",{"children":"required"}]," on order creation or update, before capturing the order:"]}],"\n","$L1eab","\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"These are the specific data field requirements for merchants who must provide airline data. Note that these requirements can be extended on a case by case basis as decided by Revolut."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Required for airline/charter merchants","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Required for OTA merchants","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","ul","ul-0",{"children":[["$","li","li-0",{"children":["$","code","code-0",{"children":"booking_id"}]}],["$","li","li-1",{"children":["$","code","code-0",{"children":"fulfillment_date"}]}],["$","li","li-2",{"children":["$","code","code-0",{"children":"passengers[].first_name"}]}],["$","li","li-3",{"children":["$","code","code-0",{"children":"passengers[].last_name"}]}],["$","li","li-4",{"children":["$","code","code-0",{"children":"journey_legs[].pnr"}]}],["$","li","li-5",{"children":["$","code","code-0",{"children":"journey_legs[].sequence"}]}],["$","li","li-6",{"children":["$","code","code-0",{"children":"journey_legs[].flight_number"}]}],["$","li","li-7",{"children":["$","code","code-0",{"children":"journey_legs[].travel_date"}]}],["$","li","li-8",{"children":["$","code","code-0",{"children":"journey_legs[].airline_code"}]}],["$","li","li-9",{"children":["$","code","code-0",{"children":"journey_legs[].departure_airport_code"}]}],["$","li","li-10",{"children":["$","code","code-0",{"children":"journey_legs[].arrival_airport_code"}]}]]}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["$","ul","ul-0",{"children":[["$","li","li-0",{"children":["$","code","code-0",{"children":"booking_id"}]}],["$","li","li-1",{"children":["$","code","code-0",{"children":"fulfillment_date"}]}],["$","li","li-2",{"children":["$","code","code-0",{"children":"passengers[].first_name"}]}],["$","li","li-3",{"children":["$","code","code-0",{"children":"passengers[].last_name"}]}],["$","li","li-4",{"children":["$","code","code-0",{"children":"journey_legs[].pnr"}]}],["$","li","li-5",{"children":["$","code","code-0",{"children":"journey_legs[].arrival_airport_code"}]}]]}],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt3","ref":"$undefined"}]]}]}]]}]]}]]}] 1b00:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Type of the industry-specific data object, determining what additional data is expected."}],"\n",["$","p","p-1",{"children":"Available types:"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Object type","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"airline"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about a specific airline ticket purchase.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"car_rental"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about a car rental booking associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"crypto"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about crypto transactions associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"marketplace"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["This object is required by Mastercard and Visa for merchants operating as marketplaces under the ",["$","strong","strong-0",{"children":"Merchant Category Code (MCC):"}]," ",["$","code","code-0",{"children":"5262"}],". The marketplace object ensures compliance with the card schemes' regulations by providing detailed information about the subseller involved in the transaction."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-4",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"event"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about event ticket bookings associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-5",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"lodging"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about lodging bookings associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 1b01:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A unique identifier provided by the merchant associated with the order."}],"\n",["$","p","p-1",{"children":["This ",["$","code","code-0",{"children":"booking_id"}]," is used to reference and correlate booking information with the Merchant API and the merchant's internal system."]}]]}] 1b02:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The UTC date and time of the pick-up."}]]}] 1b03:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object containing address details."}]]}] 1b04:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The UTC date and time of the drop-off."}]]}] 1b05:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object containing address details."}]]}] 1b06:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Parameter indicating whether the booking is refundable, partially refundable, or not refundable."}]]}] 1b07:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The maximum distance allowed."}]]}] 1b08:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The unit of distance."}]]}] 1b09:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The amount of the cost in minor currency units. For example, enter ",["$","code","code-0",{"children":"7034"}]," for €70.34."]}]]}] 1b0a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":[["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_4217","target":"_blank","rel":"noreferrer","children":"ISO 4217"}]," currency code in upper case."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information about the supported currencies, see: ",["$","a","a-0",{"href":"https://help.revolut.com/business/help/merchant-accounts/payments/in-which-currencies-can-i-accept-payments/","target":"_blank","rel":"noreferrer","children":"Help Center"}],"."]}]}]]}]]}] 1b0b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Cost for exceeding the distance limit."}]]}] 1b0c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object containing distance limit information."}]]}] 1b0d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object containing additional information about a car rental booking associated with the order."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"These are the specific data field requirements for merchants offering car rental. Note that these requirements can be extended on a case by case basis as decided by Revolut."}],"$L1eac"]}]]}]]}] 1b0e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Type of the industry-specific data object, determining what additional data is expected."}],"\n",["$","p","p-1",{"children":"Available types:"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Object type","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"airline"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about a specific airline ticket purchase.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"car_rental"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about a car rental booking associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"crypto"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about crypto transactions associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"marketplace"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["This object is required by Mastercard and Visa for merchants operating as marketplaces under the ",["$","strong","strong-0",{"children":"Merchant Category Code (MCC):"}]," ",["$","code","code-0",{"children":"5262"}],". The marketplace object ensures compliance with the card schemes' regulations by providing detailed information about the subseller involved in the transaction."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-4",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"event"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about event ticket bookings associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-5",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"lodging"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about lodging bookings associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 1b0f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The public transaction hash of the crypto transaction."}]]}] 1b10:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The status of the crypto transaction."}]]}] 1b11:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The wallet ID of the recipient."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["At least one of the parameters: ",["$","code","code-0",{"children":"recipient_user_id"}]," or ",["$","code","code-1",{"children":"recipient_wallet_id"}]," is required."]}]}]]}]]}] 1b12:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The user ID of the recipient."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["At least one of the parameters: ",["$","code","code-0",{"children":"recipient_user_id"}]," or ",["$","code","code-1",{"children":"recipient_wallet_id"}]," is required."]}]}]]}]]}] 1b13:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Array of crypto transaction data associated with the order."}]]}] 1b14:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["A string representing the four-digit ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/Merchant_category_code","target":"_blank","rel":"noreferrer","children":"Merchant Category Code (MCC)"}]," of the conversion affiliate."]}]]}] 1b15:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The ID of the seller in the merchant's internal system."}]]}] 1b16:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The business or legal name of the seller."}]]}] 1b17:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The URL of the website of the seller."}],"\n",["$","div","inlinealert-0",{"data-type":"warning","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMark","color":"var(--rui-color-warning)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"Restrictions:"}],["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["Must be a valid URI as defined by ",["$","a","a-0",{"href":"https://datatracker.ietf.org/doc/html/rfc3986","target":"_blank","rel":"noreferrer","children":"RFC 3986"}]]}],"\n",["$","li","li-1",{"children":["URI scheme is required and must be either ",["$","code","code-0",{"children":"http"}]," or ",["$","code","code-1",{"children":"https"}]]}],"\n",["$","li","li-2",{"children":["URI host is required and cannot be ",["$","code","code-0",{"children":"localhost"}]," or an IP address"]}],"\n",["$","li","li-3",{"children":["Max length: ",["$","code","code-0",{"children":"255"}]]}],"\n",["$","li","li-4",{"children":["Reserved or invalid characters must be percent-encoded (for example, use ",["$","code","code-0",{"children":"%20"}]," instead of a space)"]}],"\n"]}]]}]]}]]}] 1b18:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The phone number of the seller."}]]}] 1b19:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Primary address line."}]]}] 1b1a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Secondary address line, such as floor and apartment number."}]]}] 1b1b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"State or province of the address."}]]}] 1b1c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"City of the address."}]]}] 1b1d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"ISO 2-letter country code."}]]}] 1b1e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The subdivision code represents the state, province, or region within the country, following the ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_3166-2","target":"_blank","rel":"noreferrer","children":"ISO 3166-2"}]," standard. This code uniquely identifies subdivisions within a country."]}],"\n",["$","p","p-1",{"children":["For example, for London in the United Kingdom, use ",["$","code","code-0",{"children":"GB-LND"}],"."]}],"\n",["$","div","inlinealert-0",{"data-type":"warning","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMark","color":"var(--rui-color-warning)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["The parameter is required for countries listed on the ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_3166-2","target":"_blank","rel":"noreferrer","children":"ISO 3166-2"}]," page."]}]}]]}]]}] 1b1f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Postal code of the address."}]]}] 1b20:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Details of a physical address."}]]}] 1b21:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Information about the crypto conversion affiliate."}],"\n",["$","p","p-1",{"children":"This should be provided when a customer completes a payment on a subseller's website rather than directly on the merchant's website, providing insight into the type of business conducted by the subseller."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"This needs to be provided only by crypto on-ramp providers for payments they are processing for conversion affiliates."}],["$","p","p-1",{"children":["For their own payments, ",["$","code","code-0",{"children":"seller"}]," can be omitted."]}]]}]]}]]}] 1b22:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object containing information about crypto transactions associated with the order."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"Processing crypto on-ramp transactions with Revolut has additional compliance requirements. Please reach out to your account executive for additional details."}],["$","p","p-1",{"children":["$","strong","strong-0",{"children":"Required data fields for crypto services:"}]}],"$L1ead",["$","p","p-2",{"children":"Note that these requirements can be extended on a case by case basis as decided by Revolut."}]]}]]}]]}] 1b23:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Type of the industry-specific data object, determining what additional data is expected."}],"\n",["$","p","p-1",{"children":"Available types:"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Object type","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"airline"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about a specific airline ticket purchase.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"car_rental"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about a car rental booking associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"crypto"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about crypto transactions associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"marketplace"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["This object is required by Mastercard and Visa for merchants operating as marketplaces under the ",["$","strong","strong-0",{"children":"Merchant Category Code (MCC):"}]," ",["$","code","code-0",{"children":"5262"}],". The marketplace object ensures compliance with the card schemes' regulations by providing detailed information about the subseller involved in the transaction."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-4",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"event"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about event ticket bookings associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-5",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"lodging"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about lodging bookings associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 1b24:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The ID of the seller in the merchant's internal system."}]]}] 1b25:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The business or legal name of the seller."}]]}] 1b26:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The URL of the website of the seller."}],"\n",["$","div","inlinealert-0",{"data-type":"warning","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMark","color":"var(--rui-color-warning)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"Restrictions:"}],["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["Must be a valid URI as defined by ",["$","a","a-0",{"href":"https://datatracker.ietf.org/doc/html/rfc3986","target":"_blank","rel":"noreferrer","children":"RFC 3986"}]]}],"\n",["$","li","li-1",{"children":["URI scheme is required and must be either ",["$","code","code-0",{"children":"http"}]," or ",["$","code","code-1",{"children":"https"}]]}],"\n",["$","li","li-2",{"children":["URI host is required and cannot be ",["$","code","code-0",{"children":"localhost"}]," or an IP address"]}],"\n",["$","li","li-3",{"children":["Max length: ",["$","code","code-0",{"children":"255"}]]}],"\n",["$","li","li-4",{"children":["Reserved or invalid characters must be percent-encoded (for example, use ",["$","code","code-0",{"children":"%20"}]," instead of a space)"]}],"\n"]}]]}]]}]]}] 1b27:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The phone number of the seller."}]]}] 1b28:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Details of a physical address."}]]}] 1b29:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Information about the subseller on the marketplace platform."}]]}] 1b2a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["This object is required by Mastercard and Visa for merchants operating as marketplaces under the Merchant Category Code (MCC) ",["$","code","code-0",{"children":"5262"}],". The marketplace object ensures compliance with the card schemes' regulations by providing detailed information about the seller involved in the transaction."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"These are the specific data field requirements for merchants who must provide marketplace data."}],"$L1eae"]}]]}]]}] 1b2b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Type of the industry-specific data object, determining what additional data is expected."}],"\n",["$","p","p-1",{"children":"Available types:"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Object type","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"airline"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about a specific airline ticket purchase.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"car_rental"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about a car rental booking associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"crypto"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about crypto transactions associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"marketplace"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["This object is required by Mastercard and Visa for merchants operating as marketplaces under the ",["$","strong","strong-0",{"children":"Merchant Category Code (MCC):"}]," ",["$","code","code-0",{"children":"5262"}],". The marketplace object ensures compliance with the card schemes' regulations by providing detailed information about the subseller involved in the transaction."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-4",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"event"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about event ticket bookings associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-5",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"lodging"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about lodging bookings associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 1b2c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A unique identifier provided by the merchant associated with the order."}],"\n",["$","p","p-1",{"children":["This ",["$","code","code-0",{"children":"booking_id"}]," is used to reference and correlate booking information with the Merchant API and the merchant's internal system."]}]]}] 1b2d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":[["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_8601","target":"_blank","rel":"noreferrer","children":"ISO 8601"}]," date and time when the event starts."]}]]}] 1b2e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":[["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_8601","target":"_blank","rel":"noreferrer","children":"ISO 8601"}]," date and time when the event ends."]}]]}] 1b2f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Legal name of the ticket vendor/event organiser."}]]}] 1b30:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":[["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_8601","target":"_blank","rel":"noreferrer","children":"ISO 8601"}]," date and time when the funds are released to merchants."]}]]}] 1b31:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The name of the event."}]]}] 1b32:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Primary address line."}]]}] 1b33:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Secondary address line, such as floor and apartment number."}]]}] 1b34:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"State or province of the address."}]]}] 1b35:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"City of the address."}]]}] 1b36:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"ISO 2-letter country code."}]]}] 1b37:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Postal code of the address."}]]}] 1b38:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The address of the event location."}]]}] 1b39:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of the event."}]]}] 1b3a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Indicates the relationship between the ticket vendor and the event organiser."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Parameter value","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"primary"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The merchant is the organiser and primary distributor of the tickets.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"secondary"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The merchant is a reseller, only distributing the tickets.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 1b3b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A unique identifier provided by the merchant associated with the ticket."}]]}] 1b3c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Indicates whether the ticket is transferable to another buyer."}]]}] 1b3d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Parameter indicating whether the booking is refundable, partially refundable, or not refundable."}]]}] 1b3e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object containing information about a ticket associated with the booking."}]]}] 1b3f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A list of tickets associated with the booking."}]]}] 1b40:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object containing booking information about a specific event."}]]}] 1b41:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A list of events associated with the booking."}]]}] 1b42:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object containing booking information for a list of event tickets associated with the order."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"These are the specific data field requirements for merchants who must provide event data. Note that these requirements can be extended on a case by case basis as decided by Revolut."}],"$L1eaf"]}]]}]]}] 1b43:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Type of the industry-specific data object, determining what additional data is expected."}],"\n",["$","p","p-1",{"children":"Available types:"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Object type","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"airline"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about a specific airline ticket purchase.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"car_rental"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about a car rental booking associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"crypto"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about crypto transactions associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"marketplace"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["This object is required by Mastercard and Visa for merchants operating as marketplaces under the ",["$","strong","strong-0",{"children":"Merchant Category Code (MCC):"}]," ",["$","code","code-0",{"children":"5262"}],". The marketplace object ensures compliance with the card schemes' regulations by providing detailed information about the subseller involved in the transaction."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-4",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"event"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about event ticket bookings associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-5",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"lodging"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about lodging bookings associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 1b44:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A unique identifier provided by the merchant associated with the order."}],"\n",["$","p","p-1",{"children":["This ",["$","code","code-0",{"children":"booking_id"}]," is used to reference and correlate booking information with the Merchant API and the merchant's internal system."]}]]}] 1b45:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":[["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_8601","target":"_blank","rel":"noreferrer","children":"ISO 8601"}]," date and time of the check-in."]}]]}] 1b46:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":[["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_8601","target":"_blank","rel":"noreferrer","children":"ISO 8601"}]," date and time of the check-out."]}]]}] 1b47:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":[["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_8601","target":"_blank","rel":"noreferrer","children":"ISO 8601"}]," date and time when the funds are released to merchants."]}]]}] 1b48:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of the accommodation associated with the booking."}]]}] 1b49:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Indicates whether the booking terms are fixed or flexible."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Parameter value","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"fixed"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Non-modifiable once confirmed.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"flexible"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Allows modifications or cancellations under specified conditions.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 1b4a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Parameter indicating whether the booking is refundable, partially refundable, or not refundable."}]]}] 1b4b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Primary address line."}]]}] 1b4c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Secondary address line, such as floor and apartment number."}]]}] 1b4d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"State or province of the address."}]]}] 1b4e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"City of the address."}]]}] 1b4f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"ISO 2-letter country code."}]]}] 1b50:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Postal code of the address."}]]}] 1b51:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Address of the accommodation."}]]}] 1b52:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Guest's first name."}]]}] 1b53:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Guest's last name."}]]}] 1b54:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"List of guests associated with the booking."}]]}] 1b55:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object containing details of a lodging booking."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"These are the specific data field requirements for merchants who must provide lodging data. Note that these requirements can be extended on a case by case basis as decided by Revolut."}],"$L1eb0"]}]]}]]}] 1b56:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object containing industry-specific information associated with the order."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"In the following cases, industry-specific info is required. Omitting this information may trigger additional scrutiny and risk mitigation actions by the Revolut risk team."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Transaction type","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Required for","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"airline"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Airlines and Online Travel Agencies (OTAs).","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"car_rental"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Car Rental Merchants and Online Travel Agencies (OTAs).","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"crypto"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Crypto merchants.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"marketplace"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Marketplace merchants.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-4",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"event"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Event ticket sellers.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-5",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"lodging"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Lodging providers.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}]]}]]}] 1b57:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The URL of the order stored in the merchant's order management system."}],"\n",["$","p","p-1",{"children":["This URL will be included in the order confirmation email for payments made via Revolut Pay. If specified, this URL will override the default link to the merchant's ",["$","strong","strong-0",{"children":"Business website"}]," configured in the Revolut Business account."]}],"\n",["$","div","inlinealert-0",{"data-type":"warning","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMark","color":"var(--rui-color-warning)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"Restrictions:"}],["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["Must be a valid URI as defined by ",["$","a","a-0",{"href":"https://datatracker.ietf.org/doc/html/rfc3986","target":"_blank","rel":"noreferrer","children":"RFC 3986"}]]}],"\n",["$","li","li-1",{"children":["URI scheme is required and must be either ",["$","code","code-0",{"children":"http"}]," or ",["$","code","code-1",{"children":"https"}]]}],"\n",["$","li","li-2",{"children":["URI host is required and cannot be ",["$","code","code-0",{"children":"localhost"}]," or an IP address"]}],"\n",["$","li","li-3",{"children":["Max length: ",["$","code","code-0",{"children":"2000"}]]}],"\n",["$","li","li-4",{"children":["Reserved or invalid characters must be percent-encoded (for example, use ",["$","code","code-0",{"children":"%20"}]," instead of a space)"]}],"\n"]}]]}]]}]]}] 1b58:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Merchant order ID for external reference."}],"\n",["$","p","p-1",{"children":"Use this field to set the ID that your own system can use to easily track orders."}]]}] 1b59:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object for providing additional information stored in the merchant's order management system."}]]}] 1b5a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The date and time in ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_8601","target":"_blank","rel":"noreferrer","children":"ISO 8601 format"}]," when the upcoming payment is scheduled to be executed."]}]]}] 1b5b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The unique ID of the customer's payment method used to complete the scheduled payment."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"For more information about operations related to customer's payment methods, see:"}],["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#retrieve-payment-method-list","target":"_blank","rel":"noreferrer","children":"Retrieve payment method list of a customer"}]}],"\n",["$","li","li-1",{"children":["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#retrieve-payment-method","target":"_blank","rel":"noreferrer","children":"Retrieve a customer's payment method"}]}],"\n",["$","li","li-2",{"children":["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#update-payment-method","target":"_blank","rel":"noreferrer","children":"Update a customer's payment method"}]}],"\n",["$","li","li-3",{"children":["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#delete-payment-method","target":"_blank","rel":"noreferrer","children":"Delete a customer's payment method"}]}],"\n"]}]]}]]}]]}] 1b5c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object containing information about upcoming payments associated with the order."}]]}] 1b5d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Link to a checkout page hosted by Revolut."}]]}] 1b5e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The URL your customer will be redirected to after a successful payment on the hosted checkout page (",["$","code","code-0",{"children":"checkout_url"}]," parameter's value of the order)."]}],"\n",["$","div","inlinealert-0",{"data-type":"warning","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMark","color":"var(--rui-color-warning)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"Restrictions:"}],["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["Must be a valid URI as defined by ",["$","a","a-0",{"href":"https://datatracker.ietf.org/doc/html/rfc3986","target":"_blank","rel":"noreferrer","children":"RFC 3986"}]]}],"\n",["$","li","li-1",{"children":["URI scheme is required and must be either ",["$","code","code-0",{"children":"http"}]," or ",["$","code","code-1",{"children":"https"}]]}],"\n",["$","li","li-2",{"children":["URI host is required and cannot be ",["$","code","code-0",{"children":"localhost"}]," or an IP address"]}],"\n",["$","li","li-3",{"children":["Max length: ",["$","code","code-0",{"children":"2000"}]]}],"\n",["$","li","li-4",{"children":["Reserved or invalid characters must be percent-encoded (for example, use ",["$","code","code-0",{"children":"%20"}]," instead of a space)"]}],"\n"]}]]}]]}],"\n",["$","div","inlinealert-1",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information on how to use the ",["$","code","code-0",{"children":"redirect_url"}],", see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/accept-payments/online-payments/hosted-checkout-page/api#custom-post-payment-redirection-optional","target":"_blank","rel":"noreferrer","children":"Custom redirection via the API"}]]}]}]]}]]}] 1b5f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Primary address line."}]]}] 1b60:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Secondary address line, such as floor and apartment number."}]]}] 1b61:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"State or province of the address."}]]}] 1b62:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"City of the address."}]]}] 1b63:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"ISO 2-letter country code."}]]}] 1b64:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Postal code of the address."}]]}] 1b65:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Details of a physical address."}]]}] 1b66:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Full name of the contact person."}]]}] 1b67:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Email address of the contact person."}]]}] 1b68:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Phone number of the contact person."}]]}] 1b69:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Contact details for someone responsible for the shipment."}],"\n",["$","div","inlinealert-0",{"data-type":"warning","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMark","color":"var(--rui-color-warning)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["At least ",["$","code","code-0",{"children":"email"}]," or ",["$","code","code-1",{"children":"phone"}]," is required."]}]}]]}]]}] 1b6a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Name of the company handling the shipment."}]]}] 1b6b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unique tracking number for the shipment."}]]}] 1b6c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Estimated delivery date and time for the shipment.\nThe time should also include the customer's timezone."}]]}] 1b6d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An HTTP/HTTPS URL where the shipment can be tracked."}],"\n",["$","div","inlinealert-0",{"data-type":"warning","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMark","color":"var(--rui-color-warning)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"Restrictions:"}],["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["Must be a valid URI as defined by ",["$","a","a-0",{"href":"https://datatracker.ietf.org/doc/html/rfc3986","target":"_blank","rel":"noreferrer","children":"RFC 3986"}]]}],"\n",["$","li","li-1",{"children":["URI scheme is required and must be either ",["$","code","code-0",{"children":"http"}]," or ",["$","code","code-1",{"children":"https"}]]}],"\n",["$","li","li-2",{"children":["URI host is required and cannot be ",["$","code","code-0",{"children":"localhost"}]," or an IP address"]}],"\n",["$","li","li-3",{"children":["Max length: ",["$","code","code-0",{"children":"2000"}]]}],"\n",["$","li","li-4",{"children":["Reserved or invalid characters must be percent-encoded (for example, use ",["$","code","code-0",{"children":"%20"}]," instead of a space)"]}],"\n"]}]]}]]}]]}] 1b6e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Details of an individual shipment."}]]}] 1b6f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"List of individual shipment details."}]]}] 1b70:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Details about the shipping related to the order, including address, contact information, and individual shipments."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":"Required for merchants shipping physical goods. Omitting this information may trigger additional scrutiny and risk mitigation actions by Revolut."}]}]]}]]}] 1b71:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The enforce challenge mode. ",["$","code","code-0",{"children":"automatic"}]," is used by default."]}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Parameter value","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"automatic"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The payments created for an order will have challenge requirement calculated by our fraud mechanisms. Not all payments will trigger a 3DS challenge.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"forced"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The payments created for an order will always require a 3DS challenge. Currently only supported for card payments.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 1b72:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An array of line items included in the order. Each line item represents an individual product or service, along with its quantity, price, taxes, and discounts."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":"Required for merchants collecting payment for one or multiple products/services in one transaction. Omitting this information may trigger additional scrutiny and risk mitigation actions by Revolut."}]}]]}]]}] 1b74:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"You can set a dynamic statement descriptor for your orders by providing a custom suffix."}],"\n",["$","p","p-1",{"children":"A statement descriptor is the text shown on cardholders' bank or card statements, helping them recognise a transaction or merchant. This field can be used to send extra information with the statement descriptor for card transactions."}],"\n",["$","p","p-2",{"children":["The complete descriptor is built using the following format: ",["$","code","code-0",{"children":"{base}*{suffix}"}],", where:"]}],"\n",["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":[["$","strong","strong-0",{"children":["$","code","code-0",{"children":"{base}"}]}]," is the existing descriptor configured in the Revolut Business dashboard (",["$","strong","strong-1",{"children":"Settings > Business account > Merchant profile > Statement descriptor"}],")."]}],"\n",["$","li","li-1",{"children":[["$","strong","strong-0",{"children":["$","code","code-0",{"children":"{suffix}"}]}]," is defined by the ",["$","code","code-0",{"children":"statement_descriptor_suffix"}]," field."]}],"\n"]}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["If the combined descriptor's length (base + suffix) exceeds the character limits of card scheme providers, the final value will be truncated. For example if the limit is 22 characters, the base descriptor is ",["$","code","code-0",{"children":"\"base\""}]," and the suffix is ",["$","code","code-1",{"children":"\"testdescriptorsuffix\""}],", the final descriptor becomes ",["$","code","code-2",{"children":"\"base*testdescriptorsuf\""}],"."]}],"\n",["$","li","li-1",{"children":"The final statement descriptor shown on a cardholder's statement may vary by issuing bank, as some banks apply their own custom formatting or truncation rules."}],"\n"]}]}]]}]]}] 1b75:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The unique ID of the original order that was refunded and this refund is associated with. You can use this ID to get more information about the related order using the ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#retrieve-order","target":"_blank","rel":"noreferrer","children":"Retrieve an order"}]," operation."]}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["This field is only returned for orders with ",["$","code","code-0",{"children":"type: refund"}],"."]}]}]]}]]}] 1b76:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unique identifier for the subscription."}]]}] 1b77:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The unique identifier of the active (pre-paid) subscription cycle that this order collects payment for."}],"\n",["$","p","p-1",{"children":"This is the current billing cycle whose recurring charges are being collected in advance by this order. For example, if a subscription cycle covers 1-31 July and the order is generated on 1 July, this field identifies that July cycle."}]]}] 1b78:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The unique identifier of the settled (post-paid) subscription cycle whose usage-based charges this order collects."}],"\n",["$","p","p-1",{"children":"This is the previous billing cycle whose usage is being settled by this order. For example, if a subscription cycle covers usage from 1-30 June and the order is generated on 10 July, this field identifies that June cycle."}]]}] 1b79:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The reason this subscription order was created."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Value","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"cycle_billing"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["The order was automatically generated to collect payment for an ongoing subscription cycle. ",["$","code","code-0",{"children":"active_cycle_id"}]," is present; ",["$","code","code-1",{"children":"settled_cycle_id"}]," is present if the previous cycle included usage-based products."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"final_settlement"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["The order was automatically generated after the subscription ended to collect outstanding usage-based charges. ",["$","code","code-0",{"children":"active_cycle_id"}]," is absent; ",["$","code","code-1",{"children":"settled_cycle_id"}]," is present."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"setup_intent"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["The order was manually created by the merchant or customer to update the payment method on file. ",["$","code","code-0",{"children":"active_cycle_id"}]," is absent; ",["$","code","code-1",{"children":"settled_cycle_id"}]," is absent."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 1b7a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Subscription details linked to the order. Use this object to match an order with its underlying subscription and understand the billing context in which the order was created."}],"\n",["$","p","p-1",{"children":"Only present on orders created by a subscription."}]]}] 1b7b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["To process the order from a credit or debit card, you create an ",["$","code","code-0",{"children":"Order"}]," object. You can then retrieve, capture, cancel, refund, or pay an order using its unique ",["$","code","code-1",{"children":"id"}],". Alternatively, you can use its unique ",["$","code","code-2",{"children":"token"}]," to process a card payment with the Revolut Checkout Widget."]}]]}] 1b7c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Order updated"}]]}] 1b7d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An identifier that can be used to determine what went wrong."}],"\n",["$","p","p-1",{"children":"Error codes are not globally unique, but uniqueness is guaranteed within endpoints."}]]}] 1b7e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Some human readable text describing what went wrong."}]]}] 1b7f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://www.unixtimestamp.com/","target":"_blank","rel":"noreferrer","children":"UNIX timestamp"}]," of the date and time the error happened."]}]]}] 1b80:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Bad Request"}]]}] 1b81:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An identifier that can be used to determine what went wrong."}],"\n",["$","p","p-1",{"children":"Error codes are not globally unique, but uniqueness is guaranteed within endpoints."}]]}] 1b82:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Some human readable text describing what went wrong."}]]}] 1b83:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://www.unixtimestamp.com/","target":"_blank","rel":"noreferrer","children":"UNIX timestamp"}]," of the date and time the error happened."]}]]}] 1b84:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unauthorized"}]]}] 1b85:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An identifier that can be used to determine what went wrong."}],"\n",["$","p","p-1",{"children":"Error codes are not globally unique, but uniqueness is guaranteed within endpoints."}]]}] 1b86:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Some human readable text describing what went wrong."}]]}] 1b87:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://www.unixtimestamp.com/","target":"_blank","rel":"noreferrer","children":"UNIX timestamp"}]," of the date and time the error happened."]}]]}] 1b88:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Not Found"}]]}] 1b89:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An identifier that can be used to determine what went wrong."}],"\n",["$","p","p-1",{"children":"Error codes are not globally unique, but uniqueness is guaranteed within endpoints."}]]}] 1b8a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Some human readable text describing what went wrong."}]]}] 1b8b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://www.unixtimestamp.com/","target":"_blank","rel":"noreferrer","children":"UNIX timestamp"}]," of the date and time the error happened."]}]]}] 1b8c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unprocessable Entity"}]]}] 1b8d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The order total expressed in minor currency units, according to the ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_4217","target":"_blank","rel":"noreferrer","children":"ISO 4217 standard"}],". For example, ",["$","code","code-0",{"children":"7034"}]," in ",["$","code","code-1",{"children":"EUR"}]," corresponds to €70.34."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["Conversion between major and minor units varies by currency. For instance, ",["$","code","code-0",{"children":"100"}]," minor units equal £1.00 in ",["$","code","code-1",{"children":"GBP"}],", whereas in ",["$","code","code-2",{"children":"ISK"}]," they represent 100 units. For more details, see the ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_4217","target":"_blank","rel":"noreferrer","children":"ISO 4217 standard"}],"."]}],"\n",["$","li","li-1",{"children":["If ",["$","code","code-0",{"children":"line_items"}]," are provided, the order ",["$","code","code-1",{"children":"amount"}]," must equal the sum of all line items' ",["$","code","code-2",{"children":"total_amount"}],"."]}],"\n",["$","li","li-2",{"children":["For card payments with a non-zero amount, the order ",["$","code","code-0",{"children":"amount"}]," must be at least ",["$","strong","strong-0",{"children":"$$0.005"}]," (or equivalent in different currencies, calculated using Revolut's exchange rate on the payment date). Otherwise, card payments can't be performed."]}],"\n"]}]}]]}]]}] 1b8e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":[["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_4217","target":"_blank","rel":"noreferrer","children":"ISO 4217"}]," currency code in upper case."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information about the supported currencies, see: ",["$","a","a-0",{"href":"https://help.revolut.com/business/help/merchant-accounts/payments/in-which-currencies-can-i-accept-payments/","target":"_blank","rel":"noreferrer","children":"Help Center"}],"."]}]}]]}]]}] 1b8f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":[["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_4217","target":"_blank","rel":"noreferrer","children":"ISO 4217"}]," currency code in upper case."]}],"\n",["$","p","p-1",{"children":["If ",["$","code","code-0",{"children":"settlement_currency"}]," is different from the value of ",["$","code","code-1",{"children":"currency"}],", the money will be exchanged when the amount is settled to your merchant account. In case of a refund or chargeback, the money will be exchanged to the order's initial ",["$","code","code-2",{"children":"currency"}],"."]}],"\n",["$","p","p-2",{"children":["If ",["$","code","code-0",{"children":"settlement_currency"}]," is not specified, this value is taken from ",["$","code","code-1",{"children":"currency"}],"."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information about the supported currencies, see: ",["$","a","a-0",{"href":"https://help.revolut.com/business/help/merchant-accounts/payments/in-which-currencies-can-i-accept-payments/","target":"_blank","rel":"noreferrer","children":"Help Center"}],"."]}]}]]}]]}] 1b90:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The description of the order."}]]}] 1b92:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Permanent ID of a customer used to retrieve, update, delete a customer. This ID can also be used to link customer to an order."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":"If you provide the customer's ID during order creation, no other customer data is required, they will be parsed automatically from the referenced customer object."}]}]]}]]}] 1b93:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The full name of the customer."}]]}] 1b94:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The phone number of the customer in ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/E.164","target":"_blank","rel":"noreferrer","children":"E.164 format"}],"."]}]]}] 1b95:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The email address of the customer."}]]}] 1b96:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The birth date of the customer."}]]}] 1b97:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object containing information about a customer."}],"\n",["$","p","p-1",{"children":["If you have it, we strongly advise providing at least either ",["$","code","code-0",{"children":"id"}],", ",["$","code","code-1",{"children":"phone"}],", or ",["$","code","code-2",{"children":"email"}],"."]}],"\n",["$","p","p-2",{"children":["Using the ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#tag-customers","target":"_blank","rel":"noreferrer","children":"Customers operations"}],", you can manage customer instances."]}],"\n",["$","p","p-3",{"children":"The following behaviours apply to different use cases:"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Use case","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"API behavior","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":"Existing customer","className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["If ",["$","code","code-0",{"children":"id"}]," was provided, we ignore other customer details and associate the customer with the order.",["$","br","br-0",{}],["$","br","br-1",{}],"If either ",["$","code","code-1",{"children":"email"}],", ",["$","code","code-2",{"children":"phone"}],", or ",["$","code","code-3",{"children":"full_name"}]," was provided (without an existing customer's ",["$","code","code-4",{"children":"id"}],"), we always create a new customer, irrespective of another, existing customer object having the same details."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":"New customer","className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["If either ",["$","code","code-0",{"children":"email"}],", ",["$","code","code-1",{"children":"phone"}],", or ",["$","code","code-2",{"children":"full_name"}]," was provided, we create a new customer, irrespective of another customer object having the same details. ",["$","br","br-0",{}],["$","br","br-1",{}],"If ",["$","code","code-3",{"children":"id"}]," of a non-existent customer was provided, we return a ",["$","code","code-4",{"children":"404"}]," error, irrespective of other details provided."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["To avoid unintentional duplication of customer records, search for an existing customer by email or phone using the ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#retrieve-customer-list","target":"_blank","rel":"noreferrer","children":"List customers"}]," endpoint first, then provide ",["$","code","code-0",{"children":"customer.id"}]," in the order."]}]}]]}]]}] 1b98:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The enforce challenge mode. ",["$","code","code-0",{"children":"automatic"}]," is used by default."]}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Parameter value","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"automatic"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The payments created for an order will have challenge requirement calculated by our fraud mechanisms. Not all payments will trigger a 3DS challenge.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"forced"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The payments created for an order will always require a 3DS challenge. Currently only supported for card payments.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 1b99:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Name of the line item."}]]}] 1b9a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Type of the line item."}]]}] 1b9b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The number of units of the line item."}]]}] 1b9c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The measurement unit for the quantity, such as ",["$","code","code-0",{"children":"cm"}],", or ",["$","code","code-1",{"children":"kg"}],"."]}]]}] 1b9d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object representing the quantity details of a line item, including the amount and its associated unit of measurement."}]]}] 1b9e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The unit price of the line item."}]]}] 1b9f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The total amount to be paid for the line item, including taxes and discounts."}]]}] 1ba0:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unique identifier of line item in the merchant's system."}]]}] 1ba1:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The specific name or label of the discount applied to the line item."}]]}] 1ba2:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The monetary value of the discount."}]]}] 1ba3:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Details of a discount applied to the line item, including its name and monetary value."}]]}] 1ba4:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A list of discounts applied to the line item. Each discount should be subtracted from the total amount payable for the item."}]]}] 1ba5:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The specific name or designation of the tax applied to the line item."}]]}] 1ba6:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The monetary value of the tax in minor currency units (e.g., cents for EUR)."}]]}] 1ba7:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Details about a tax applied to the line item, including its name and the corresponding amount."}]]}] 1ba8:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A list of taxes applied to the line item. Each tax should be added to the total amount payable for the item."}]]}] 1ba9:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"URL to an image associated with the line item."}],"\n",["$","div","inlinealert-0",{"data-type":"warning","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMark","color":"var(--rui-color-warning)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"Restrictions:"}],["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["Must be a valid URI as defined by ",["$","a","a-0",{"href":"https://datatracker.ietf.org/doc/html/rfc3986","target":"_blank","rel":"noreferrer","children":"RFC 3986"}]]}],"\n",["$","li","li-1",{"children":["URI scheme is required and must be either ",["$","code","code-0",{"children":"http"}]," or ",["$","code","code-1",{"children":"https"}]]}],"\n",["$","li","li-2",{"children":["URI host is required and cannot be ",["$","code","code-0",{"children":"localhost"}]," or an IP address"]}],"\n",["$","li","li-3",{"children":["Max length: ",["$","code","code-0",{"children":"2000"}]]}],"\n",["$","li","li-4",{"children":["Reserved or invalid characters must be percent-encoded (for example, use ",["$","code","code-0",{"children":"%20"}]," instead of a space)"]}],"\n"]}]]}]]}]]}] 1baa:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A list of URLs pointing to images related to the line item. These images can provide visual details or representations of the item."}]]}] 1bab:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Description of the line item."}]]}] 1bac:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An HTTP/HTTPS URL that links to more information about the line item, such as a product page or details."}],"\n",["$","div","inlinealert-0",{"data-type":"warning","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMark","color":"var(--rui-color-warning)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"Restrictions:"}],["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["Must be a valid URI as defined by ",["$","a","a-0",{"href":"https://datatracker.ietf.org/doc/html/rfc3986","target":"_blank","rel":"noreferrer","children":"RFC 3986"}]]}],"\n",["$","li","li-1",{"children":["URI scheme is required and must be either ",["$","code","code-0",{"children":"http"}]," or ",["$","code","code-1",{"children":"https"}]]}],"\n",["$","li","li-2",{"children":["URI host is required and cannot be ",["$","code","code-0",{"children":"localhost"}]," or an IP address"]}],"\n",["$","li","li-3",{"children":["Max length: ",["$","code","code-0",{"children":"2000"}]]}],"\n",["$","li","li-4",{"children":["Reserved or invalid characters must be percent-encoded (for example, use ",["$","code","code-0",{"children":"%20"}]," instead of a space)"]}],"\n"]}]]}]]}]]}] 1bad:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An array of line items included in the order. Each line item represents an individual product or service, along with its quantity, price, taxes, and discounts."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":"Required for merchants collecting payment for one or multiple products/services in one transaction. Omitting this information may trigger additional scrutiny and risk mitigation actions by Revolut."}]}]]}]]}] 1bae:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Primary address line."}]]}] 1baf:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Secondary address line, such as floor and apartment number."}]]}] 1bb0:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"State or province of the address."}]]}] 1bb1:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"City of the address."}]]}] 1bb2:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"ISO 2-letter country code."}]]}] 1bb3:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Postal code of the address."}]]}] 1bb4:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Details of a physical address."}]]}] 1bb5:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Full name of the contact person."}]]}] 1bb6:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Email address of the contact person."}]]}] 1bb7:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Phone number of the contact person."}]]}] 1bb8:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Contact details for someone responsible for the shipment."}],"\n",["$","div","inlinealert-0",{"data-type":"warning","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMark","color":"var(--rui-color-warning)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["At least ",["$","code","code-0",{"children":"email"}]," or ",["$","code","code-1",{"children":"phone"}]," is required."]}]}]]}]]}] 1bb9:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Name of the company handling the shipment."}]]}] 1bba:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unique tracking number for the shipment."}]]}] 1bbb:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Estimated delivery date and time for the shipment.\nThe time should also include the customer's timezone."}]]}] 1bbc:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An HTTP/HTTPS URL where the shipment can be tracked."}],"\n",["$","div","inlinealert-0",{"data-type":"warning","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMark","color":"var(--rui-color-warning)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"Restrictions:"}],["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["Must be a valid URI as defined by ",["$","a","a-0",{"href":"https://datatracker.ietf.org/doc/html/rfc3986","target":"_blank","rel":"noreferrer","children":"RFC 3986"}]]}],"\n",["$","li","li-1",{"children":["URI scheme is required and must be either ",["$","code","code-0",{"children":"http"}]," or ",["$","code","code-1",{"children":"https"}]]}],"\n",["$","li","li-2",{"children":["URI host is required and cannot be ",["$","code","code-0",{"children":"localhost"}]," or an IP address"]}],"\n",["$","li","li-3",{"children":["Max length: ",["$","code","code-0",{"children":"2000"}]]}],"\n",["$","li","li-4",{"children":["Reserved or invalid characters must be percent-encoded (for example, use ",["$","code","code-0",{"children":"%20"}]," instead of a space)"]}],"\n"]}]]}]]}]]}] 1bbd:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Details of an individual shipment."}]]}] 1bbe:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"List of individual shipment details."}]]}] 1bbf:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Details about the shipping related to the order, including address, contact information, and individual shipments."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":"Required for merchants shipping physical goods. Omitting this information may trigger additional scrutiny and risk mitigation actions by Revolut."}]}]]}]]}] 1bc0:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The capture mode of the order. ",["$","code","code-0",{"children":"automatic"}]," is used by default."]}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Parameter value","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"automatic"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The order is captured automatically after payment authorisation.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"manual"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The order is not captured automatically. You must manually capture the order later.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information, see ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#capture-order","target":"_blank","rel":"noreferrer","children":"Capture an order"}],"."]}]}]]}]]}] 1bc2:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["Automatic cancellation period for uncaptured orders, specified in ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_8601","target":"_blank","rel":"noreferrer","children":"ISO 8601"}]," format."]}],"\n",["$","p","p-1",{"children":["After this period, the authorised payment is automatically cancelled and the order is cancelled. Maximum: 7 days = ",["$","code","code-0",{"children":"P7D"}],"."]}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"The following limitations apply:"}],["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["\n",["$","p","p-0",{"children":"Cannot be a negative value."}],"\n"]}],"\n",["$","li","li-1",{"children":["\n",["$","p","p-0",{"children":"Cannot be updated if the new value is less than or equal to the elapsed time since authorisation."}],"\n",["$","p","p-1",{"children":["$","strong","strong-0",{"children":"Failing scenario:"}]}],"\n",["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":"Original value: 7 days"}],"\n",["$","li","li-1",{"children":"Time since authorisation: 3 days"}],"\n",["$","li","li-2",{"children":"Update value: 2 days"}],"\n"]}],"\n",["$","p","p-2",{"children":"In this scenario, an error is returned."}],"\n",["$","p","p-3",{"children":["$","strong","strong-0",{"children":"Successful scenario:"}]}],"\n",["$","ul","ul-1",{"children":["\n",["$","li","li-0",{"children":"Original value: 7 days"}],"\n",["$","li","li-1",{"children":"Time since authorisation: 3 days"}],"\n",["$","li","li-2",{"children":"Update value: 4 days"}],"\n"]}],"\n",["$","p","p-4",{"children":"In this scenario, the parameter can be updated."}],"\n"]}],"\n",["$","li","li-2",{"children":["\n",["$","p","p-0",{"children":"Cannot be updated if cancellation is ≤ 30 minutes away."}],"\n",["$","p","p-1",{"children":["$","strong","strong-0",{"children":"Failing scenario:"}]}],"\n",["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":"Original value: 12 hours"}],"\n",["$","li","li-1",{"children":"Time since authorisation: 11 hours 40 minutes"}],"\n"]}],"\n",["$","p","p-2",{"children":"In this scenario, an error is returned."}],"\n",["$","p","p-3",{"children":["$","strong","strong-0",{"children":"Successful scenario:"}]}],"\n",["$","ul","ul-1",{"children":["\n",["$","li","li-0",{"children":"Original value: 12 hours"}],"\n",["$","li","li-1",{"children":"Time since authorisation: 11 hours 20 minutes"}],"\n"]}],"\n",["$","p","p-4",{"children":"In this scenario, the parameter can be updated."}],"\n"]}],"\n"]}]]}]]}]]}] 1bc3:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["Automatic expiration period for pending orders, specified in ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_8601","target":"_blank","rel":"noreferrer","children":"ISO 8601"}]," format."]}],"\n",["$","p","p-1",{"children":["Orders in ",["$","code","code-0",{"children":"pending"}]," state will be automatically failed if they stay unpaid for longer than the period specified."]}],"\n",["$","p","p-2",{"children":["When the order expires, it transitions to the ",["$","code","code-0",{"children":"failed"}]," state and an ",["$","code","code-1",{"children":"ORDER_FAILED"}]," webhook event is triggered."]}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":"This field can only be set during order creation and cannot be updated afterward."}],"\n",["$","li","li-1",{"children":["Must be between ",["$","code","code-0",{"children":"PT1M"}]," (1 minute) and ",["$","code","code-1",{"children":"PT720H"}]," (30 days)."]}],"\n",["$","li","li-2",{"children":"Cannot be a negative value."}],"\n"]}]}]]}]]}] 1bc4:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Additional metadata value provided with the corresponding metadata key."}]]}] 1bc5:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["Additional information to track your orders in your system, by providing custom metadata using ",["$","code","code-0",{"children":"\"\" : \"\""}]," pairs."]}],"\n",["$","div","inlinealert-0",{"data-type":"warning","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMark","color":"var(--rui-color-warning)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":["$","strong","strong-0",{"children":"Restrictions:"}]}],["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["Both keys and values must be ",["$","code","code-0",{"children":"string"}],"s"]}],"\n",["$","li","li-1",{"children":["Values cannot be ",["$","code","code-0",{"children":"null"}],"."]}],"\n",["$","li","li-2",{"children":["Max number of key-value pairs: ",["$","code","code-0",{"children":"50"}]]}],"\n",["$","li","li-3",{"children":["Max length of values: ",["$","code","code-0",{"children":"500"}]," characters"]}],"\n",["$","li","li-4",{"children":["Format of keys: Must start with a letter and contain only letters, digits, and underscores. Max 40 characters. Pattern: ",["$","code","code-0",{"children":"^[a-zA-Z][a-zA-Z\\\\d_]{0,39}$"}]]}],"\n"]}]]}]]}]]}] 1bc7:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Type of the industry-specific data object, determining what additional data is expected."}],"\n",["$","p","p-1",{"children":"Available types:"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Object type","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"airline"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about a specific airline ticket purchase.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"car_rental"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about a car rental booking associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"crypto"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about crypto transactions associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"marketplace"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["This object is required by Mastercard and Visa for merchants operating as marketplaces under the ",["$","strong","strong-0",{"children":"Merchant Category Code (MCC):"}]," ",["$","code","code-0",{"children":"5262"}],". The marketplace object ensures compliance with the card schemes' regulations by providing detailed information about the subseller involved in the transaction."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-4",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"event"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about event ticket bookings associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-5",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"lodging"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about lodging bookings associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 1bc8:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A unique identifier provided by the merchant associated with the order."}],"\n",["$","p","p-1",{"children":["This ",["$","code","code-0",{"children":"booking_id"}]," is used to reference and correlate booking information with the Merchant API and the merchant's internal system."]}]]}] 1bc9:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The UTC date and time of the final journey leg."}],"\n",["$","div","inlinealert-0",{"data-type":"warning","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMark","color":"var(--rui-color-warning)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"The following limitations apply:"}],["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["When creating or updating an order, ",["$","code","code-0",{"children":"fulfillment_date"}]," cannot be set to a date in the past."]}],"\n",["$","li","li-1",{"children":["When updating an order, if the current ",["$","code","code-0",{"children":"fulfillment_date"}]," value is already in the past, it cannot be modified. The date must remain as is to maintain data integrity for completed transactions."]}],"\n"]}]]}]]}]]}] 1bca:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["Flag indicating whether the order includes actual ticket purchases. Set to ",["$","code","code-0",{"children":"true"}]," if the order contains ticket purchases, and ",["$","code","code-1",{"children":"false"}]," if it does not (e.g., it ",["$","strong","strong-0",{"children":"only"}]," contains seat reservations, or baggage upgrades)."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":["This field is required for activating ",["$","strong","strong-0",{"children":"Revolut Flight Alerts"}]," functionalities within the Revolut app."]}],["$","p","p-1",{"children":"Provide the info on order creation or update, before capturing the order."}]]}]]}]]}] 1bcb:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of the ticket."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Parameter value","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"fixed"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Non-modifiable once confirmed.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"flexible"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Allows modifications or cancellations under specified conditions.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 1bcc:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The code of the Computer Reservation System (CRS) used to make the booking and purchase the ticket."}]]}] 1bcd:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Parameter indicating whether this order is related to a new ticket reservation or a modification of an existing one."}]]}] 1bce:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Parameter indicating whether the booking is refundable, partially refundable, or not refundable."}]]}] 1bcf:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Passenger's first name."}]]}] 1bd0:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Passenger's last name."}]]}] 1bd1:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Array containing information of passengers associated with the booking."}]]}] 1bd2:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Sequence of the journey legs. Increment by 1 for each flight included in the ticket."}],"\n",["$","p","p-1",{"children":["For example: For a ",["$","code","code-0",{"children":"FRA > LHR > DUB > LHR > FRA"}]," journey the sequence will be assigned as:"]}],"\n",["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":[["$","code","code-0",{"children":"FRA > LHR"}],": 1"]}],"\n",["$","li","li-1",{"children":[["$","code","code-0",{"children":"LHR > DUB"}],": 2"]}],"\n",["$","li","li-2",{"children":[["$","code","code-0",{"children":"DUB > LHR"}],": 3"]}],"\n",["$","li","li-3",{"children":[["$","code","code-0",{"children":"LHR > FRA"}],": 4"]}],"\n"]}]]}] 1bd3:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://www.iata.org/en/services/codes","target":"_blank","rel":"noreferrer","children":"IATA"}]," 3-letter airport code for the departure airport."]}]]}] 1bd4:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://www.iata.org/en/services/codes","target":"_blank","rel":"noreferrer","children":"IATA"}]," 3-letter airport code for the arrival airport."]}]]}] 1bd5:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The flight identifier, without airline code."}]]}] 1bd6:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The fare base code for the given journey leg."}]]}] 1bd7:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The UTC date and time of the flight departure for the given journey leg."}]]}] 1bd8:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The name of the airline associated with the journey leg."}]]}] 1bd9:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The IATA 2-letter accounting code identifying the airline associated with the journey leg."}]]}] 1bda:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The Passenger Name Record (PNR) for the journey leg issued by the airline."}],"\n",["$","p","p-1",{"children":"PNR is a unique identifier for the booking, acting as a digital certificate allowing passengers to retrieve or manage their booking details."}],"\n",["$","div","inlinealert-0",{"data-type":"warning","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMark","color":"var(--rui-color-warning)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":"This is a required field for OTAs."}]}]]}]]}] 1bdb:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Array containing information of journey legs associated with the booking."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":["This field is required for activating ",["$","strong","strong-0",{"children":"Revolut Flight Alerts"}]," functionalities within the Revolut app."]}],["$","p","p-1",{"children":"This information is used to compile a tracking widget that provides real-time updates on flight status and sends notifications, such as a check-in reminders, boarding alerts, and notifications for cancellations or delays."}],["$","p","p-2",{"children":"To enable the widget the following fields are required on order creation or update, before capturing the order:"}],"$L1eb1"]}]]}]]}] 1bdc:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"URL to the online portal for managing the airline booking, which includes check-in functionality. This URL may be a personalised, pre-populated check-in link specific to the user or a generic link, and it is essential for enabling direct access to booking details within the Revolut app."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":["This field is required for activating ",["$","strong","strong-0",{"children":"Revolut Flight Alerts"}]," functionalities within the Revolut app."]}],["$","p","p-1",{"children":"Provide the info on order creation or update, before capturing the order."}]]}]]}],"\n",["$","div","inlinealert-1",{"data-type":"warning","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMark","color":"var(--rui-color-warning)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"Restrictions:"}],["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["Must be a valid URI as defined by ",["$","a","a-0",{"href":"https://datatracker.ietf.org/doc/html/rfc3986","target":"_blank","rel":"noreferrer","children":"RFC 3986"}]]}],"\n",["$","li","li-1",{"children":["URI scheme is required and must be either ",["$","code","code-0",{"children":"http"}]," or ",["$","code","code-1",{"children":"https"}]]}],"\n",["$","li","li-2",{"children":["URI host is required and cannot be ",["$","code","code-0",{"children":"localhost"}]," or an IP address"]}],"\n",["$","li","li-3",{"children":["Max length: ",["$","code","code-0",{"children":"2000"}]]}],"\n",["$","li","li-4",{"children":["Reserved or invalid characters must be percent-encoded (for example, use ",["$","code","code-0",{"children":"%20"}]," instead of a space)"]}],"\n"]}]]}]]}]]}] 1bdd:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object containing additional information about an airline booking associated with the order."}],"\n",["$","p","p-1",{"children":["Use this object to provide required data to enable ",["$","strong","strong-0",{"children":"Revolut Flight Alerts"}],". This feature allows users to receive real-time flight updates such as check-in reminders, boarding alerts, and notifications for cancellations or delays in the Revolut app."]}],"\n",["$","p","p-2",{"children":["To enable ",["$","strong","strong-0",{"children":"Revolut Flight Alerts"}]," functionalities in the Revolut app, the following fields are ",["$","strong","strong-1",{"children":"required"}]," on order creation or update, before capturing the order:"]}],"\n","$L1eb2","\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"These are the specific data field requirements for merchants who must provide airline data. Note that these requirements can be extended on a case by case basis as decided by Revolut."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Required for airline/charter merchants","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Required for OTA merchants","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","ul","ul-0",{"children":[["$","li","li-0",{"children":["$","code","code-0",{"children":"booking_id"}]}],["$","li","li-1",{"children":["$","code","code-0",{"children":"fulfillment_date"}]}],["$","li","li-2",{"children":["$","code","code-0",{"children":"passengers[].first_name"}]}],["$","li","li-3",{"children":["$","code","code-0",{"children":"passengers[].last_name"}]}],["$","li","li-4",{"children":["$","code","code-0",{"children":"journey_legs[].pnr"}]}],["$","li","li-5",{"children":["$","code","code-0",{"children":"journey_legs[].sequence"}]}],["$","li","li-6",{"children":["$","code","code-0",{"children":"journey_legs[].flight_number"}]}],["$","li","li-7",{"children":["$","code","code-0",{"children":"journey_legs[].travel_date"}]}],["$","li","li-8",{"children":["$","code","code-0",{"children":"journey_legs[].airline_code"}]}],["$","li","li-9",{"children":["$","code","code-0",{"children":"journey_legs[].departure_airport_code"}]}],["$","li","li-10",{"children":["$","code","code-0",{"children":"journey_legs[].arrival_airport_code"}]}]]}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["$","ul","ul-0",{"children":[["$","li","li-0",{"children":["$","code","code-0",{"children":"booking_id"}]}],["$","li","li-1",{"children":["$","code","code-0",{"children":"fulfillment_date"}]}],["$","li","li-2",{"children":["$","code","code-0",{"children":"passengers[].first_name"}]}],["$","li","li-3",{"children":["$","code","code-0",{"children":"passengers[].last_name"}]}],["$","li","li-4",{"children":["$","code","code-0",{"children":"journey_legs[].pnr"}]}],["$","li","li-5",{"children":["$","code","code-0",{"children":"journey_legs[].arrival_airport_code"}]}]]}],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt3","ref":"$undefined"}]]}]}]]}]]}]]}] 1bde:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Type of the industry-specific data object, determining what additional data is expected."}],"\n",["$","p","p-1",{"children":"Available types:"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Object type","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"airline"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about a specific airline ticket purchase.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"car_rental"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about a car rental booking associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"crypto"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about crypto transactions associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"marketplace"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["This object is required by Mastercard and Visa for merchants operating as marketplaces under the ",["$","strong","strong-0",{"children":"Merchant Category Code (MCC):"}]," ",["$","code","code-0",{"children":"5262"}],". The marketplace object ensures compliance with the card schemes' regulations by providing detailed information about the subseller involved in the transaction."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-4",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"event"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about event ticket bookings associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-5",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"lodging"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about lodging bookings associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 1bdf:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A unique identifier provided by the merchant associated with the order."}],"\n",["$","p","p-1",{"children":["This ",["$","code","code-0",{"children":"booking_id"}]," is used to reference and correlate booking information with the Merchant API and the merchant's internal system."]}]]}] 1be0:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The UTC date and time of the pick-up."}]]}] 1be1:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Street line 1 information."}]]}] 1be2:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Street line 2 information."}]]}] 1be3:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The region associated with the address."}]]}] 1be4:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The city associated with the address."}]]}] 1be5:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The 2-letter country code of the country associated with the address."}]]}] 1be6:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The postcode associated with the address."}]]}] 1be7:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object containing address details."}]]}] 1be8:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The UTC date and time of the drop-off."}]]}] 1be9:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object containing address details."}]]}] 1bea:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Parameter indicating whether the booking is refundable, partially refundable, or not refundable."}]]}] 1beb:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The maximum distance allowed."}]]}] 1bec:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The unit of distance."}]]}] 1bed:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The amount of the cost in minor currency units. For example, enter ",["$","code","code-0",{"children":"7034"}]," for €70.34."]}]]}] 1bee:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":[["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_4217","target":"_blank","rel":"noreferrer","children":"ISO 4217"}]," currency code in upper case."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information about the supported currencies, see: ",["$","a","a-0",{"href":"https://help.revolut.com/business/help/merchant-accounts/payments/in-which-currencies-can-i-accept-payments/","target":"_blank","rel":"noreferrer","children":"Help Center"}],"."]}]}]]}]]}] 1bef:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Cost for exceeding the distance limit."}]]}] 1bf0:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object containing distance limit information."}]]}] 1bf1:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object containing additional information about a car rental booking associated with the order."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"These are the specific data field requirements for merchants offering car rental. Note that these requirements can be extended on a case by case basis as decided by Revolut."}],"$L1eb3"]}]]}]]}] 1bf2:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Type of the industry-specific data object, determining what additional data is expected."}],"\n",["$","p","p-1",{"children":"Available types:"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Object type","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"airline"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about a specific airline ticket purchase.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"car_rental"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about a car rental booking associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"crypto"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about crypto transactions associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"marketplace"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["This object is required by Mastercard and Visa for merchants operating as marketplaces under the ",["$","strong","strong-0",{"children":"Merchant Category Code (MCC):"}]," ",["$","code","code-0",{"children":"5262"}],". The marketplace object ensures compliance with the card schemes' regulations by providing detailed information about the subseller involved in the transaction."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-4",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"event"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about event ticket bookings associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-5",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"lodging"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about lodging bookings associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 1bf3:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The public transaction hash of the crypto transaction."}]]}] 1bf4:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The status of the crypto transaction."}]]}] 1bf5:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The wallet ID of the recipient."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["At least one of the parameters: ",["$","code","code-0",{"children":"recipient_user_id"}]," or ",["$","code","code-1",{"children":"recipient_wallet_id"}]," is required."]}]}]]}]]}] 1bf6:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The user ID of the recipient."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["At least one of the parameters: ",["$","code","code-0",{"children":"recipient_user_id"}]," or ",["$","code","code-1",{"children":"recipient_wallet_id"}]," is required."]}]}]]}]]}] 1bf7:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Array of crypto transaction data associated with the order."}]]}] 1bf8:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["A string representing the four-digit ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/Merchant_category_code","target":"_blank","rel":"noreferrer","children":"Merchant Category Code (MCC)"}]," of the conversion affiliate."]}]]}] 1bf9:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The ID of the seller in the merchant's internal system."}]]}] 1bfa:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The business or legal name of the seller."}]]}] 1bfb:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The URL of the website of the seller."}],"\n",["$","div","inlinealert-0",{"data-type":"warning","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMark","color":"var(--rui-color-warning)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"Restrictions:"}],["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["Must be a valid URI as defined by ",["$","a","a-0",{"href":"https://datatracker.ietf.org/doc/html/rfc3986","target":"_blank","rel":"noreferrer","children":"RFC 3986"}]]}],"\n",["$","li","li-1",{"children":["URI scheme is required and must be either ",["$","code","code-0",{"children":"http"}]," or ",["$","code","code-1",{"children":"https"}]]}],"\n",["$","li","li-2",{"children":["URI host is required and cannot be ",["$","code","code-0",{"children":"localhost"}]," or an IP address"]}],"\n",["$","li","li-3",{"children":["Max length: ",["$","code","code-0",{"children":"255"}]]}],"\n",["$","li","li-4",{"children":["Reserved or invalid characters must be percent-encoded (for example, use ",["$","code","code-0",{"children":"%20"}]," instead of a space)"]}],"\n"]}]]}]]}]]}] 1bfc:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The phone number of the seller."}]]}] 1bfd:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Primary address line."}]]}] 1bfe:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Secondary address line, such as floor and apartment number."}]]}] 1bff:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"State or province of the address."}]]}] 1c00:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"City of the address."}]]}] 1c01:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"ISO 2-letter country code."}]]}] 1c02:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The subdivision code represents the state, province, or region within the country, following the ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_3166-2","target":"_blank","rel":"noreferrer","children":"ISO 3166-2"}]," standard. This code uniquely identifies subdivisions within a country."]}],"\n",["$","p","p-1",{"children":["For example, for London in the United Kingdom, use ",["$","code","code-0",{"children":"GB-LND"}],"."]}],"\n",["$","div","inlinealert-0",{"data-type":"warning","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMark","color":"var(--rui-color-warning)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["The parameter is required for countries listed on the ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_3166-2","target":"_blank","rel":"noreferrer","children":"ISO 3166-2"}]," page."]}]}]]}]]}] 1c03:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Postal code of the address."}]]}] 1c04:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Details of a physical address."}]]}] 1c05:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Information about the crypto conversion affiliate."}],"\n",["$","p","p-1",{"children":"This should be provided when a customer completes a payment on a subseller's website rather than directly on the merchant's website, providing insight into the type of business conducted by the subseller."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"This needs to be provided only by crypto on-ramp providers for payments they are processing for conversion affiliates."}],["$","p","p-1",{"children":["For their own payments, ",["$","code","code-0",{"children":"seller"}]," can be omitted."]}]]}]]}]]}] 1c06:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object containing information about crypto transactions associated with the order."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"Processing crypto on-ramp transactions with Revolut has additional compliance requirements. Please reach out to your account executive for additional details."}],["$","p","p-1",{"children":["$","strong","strong-0",{"children":"Required data fields for crypto services:"}]}],"$L1eb4",["$","p","p-2",{"children":"Note that these requirements can be extended on a case by case basis as decided by Revolut."}]]}]]}]]}] 1c07:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Type of the industry-specific data object, determining what additional data is expected."}],"\n",["$","p","p-1",{"children":"Available types:"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Object type","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"airline"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about a specific airline ticket purchase.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"car_rental"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about a car rental booking associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"crypto"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about crypto transactions associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"marketplace"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["This object is required by Mastercard and Visa for merchants operating as marketplaces under the ",["$","strong","strong-0",{"children":"Merchant Category Code (MCC):"}]," ",["$","code","code-0",{"children":"5262"}],". The marketplace object ensures compliance with the card schemes' regulations by providing detailed information about the subseller involved in the transaction."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-4",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"event"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about event ticket bookings associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-5",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"lodging"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about lodging bookings associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 1c08:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The ID of the seller in the merchant's internal system."}]]}] 1c09:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The business or legal name of the seller."}]]}] 1c0a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The URL of the website of the seller."}],"\n",["$","div","inlinealert-0",{"data-type":"warning","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMark","color":"var(--rui-color-warning)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"Restrictions:"}],["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["Must be a valid URI as defined by ",["$","a","a-0",{"href":"https://datatracker.ietf.org/doc/html/rfc3986","target":"_blank","rel":"noreferrer","children":"RFC 3986"}]]}],"\n",["$","li","li-1",{"children":["URI scheme is required and must be either ",["$","code","code-0",{"children":"http"}]," or ",["$","code","code-1",{"children":"https"}]]}],"\n",["$","li","li-2",{"children":["URI host is required and cannot be ",["$","code","code-0",{"children":"localhost"}]," or an IP address"]}],"\n",["$","li","li-3",{"children":["Max length: ",["$","code","code-0",{"children":"255"}]]}],"\n",["$","li","li-4",{"children":["Reserved or invalid characters must be percent-encoded (for example, use ",["$","code","code-0",{"children":"%20"}]," instead of a space)"]}],"\n"]}]]}]]}]]}] 1c0b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The phone number of the seller."}]]}] 1c0c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Details of a physical address."}]]}] 1c0d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Information about the subseller on the marketplace platform."}]]}] 1c0e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["This object is required by Mastercard and Visa for merchants operating as marketplaces under the Merchant Category Code (MCC) ",["$","code","code-0",{"children":"5262"}],". The marketplace object ensures compliance with the card schemes' regulations by providing detailed information about the seller involved in the transaction."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"These are the specific data field requirements for merchants who must provide marketplace data."}],"$L1eb5"]}]]}]]}] 1c0f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Type of the industry-specific data object, determining what additional data is expected."}],"\n",["$","p","p-1",{"children":"Available types:"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Object type","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"airline"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about a specific airline ticket purchase.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"car_rental"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about a car rental booking associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"crypto"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about crypto transactions associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"marketplace"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["This object is required by Mastercard and Visa for merchants operating as marketplaces under the ",["$","strong","strong-0",{"children":"Merchant Category Code (MCC):"}]," ",["$","code","code-0",{"children":"5262"}],". The marketplace object ensures compliance with the card schemes' regulations by providing detailed information about the subseller involved in the transaction."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-4",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"event"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about event ticket bookings associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-5",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"lodging"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about lodging bookings associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 1c10:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A unique identifier provided by the merchant associated with the order."}],"\n",["$","p","p-1",{"children":["This ",["$","code","code-0",{"children":"booking_id"}]," is used to reference and correlate booking information with the Merchant API and the merchant's internal system."]}]]}] 1c11:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":[["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_8601","target":"_blank","rel":"noreferrer","children":"ISO 8601"}]," date and time when the event starts."]}]]}] 1c12:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":[["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_8601","target":"_blank","rel":"noreferrer","children":"ISO 8601"}]," date and time when the event ends."]}]]}] 1c13:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Legal name of the ticket vendor/event organiser."}]]}] 1c14:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":[["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_8601","target":"_blank","rel":"noreferrer","children":"ISO 8601"}]," date and time when the funds are released to merchants."]}]]}] 1c15:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The name of the event."}]]}] 1c16:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Primary address line."}]]}] 1c17:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Secondary address line, such as floor and apartment number."}]]}] 1c18:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"State or province of the address."}]]}] 1c19:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"City of the address."}]]}] 1c1a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"ISO 2-letter country code."}]]}] 1c1b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Postal code of the address."}]]}] 1c1c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The address of the event location."}]]}] 1c1d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of the event."}]]}] 1c1e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Indicates the relationship between the ticket vendor and the event organiser."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Parameter value","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"primary"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The merchant is the organiser and primary distributor of the tickets.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"secondary"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The merchant is a reseller, only distributing the tickets.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 1c1f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A unique identifier provided by the merchant associated with the ticket."}]]}] 1c20:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Indicates whether the ticket is transferable to another buyer."}]]}] 1c21:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Parameter indicating whether the booking is refundable, partially refundable, or not refundable."}]]}] 1c22:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object containing information about a ticket associated with the booking."}]]}] 1c23:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A list of tickets associated with the booking."}]]}] 1c24:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object containing booking information about a specific event."}]]}] 1c25:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A list of events associated with the booking."}]]}] 1c26:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object containing booking information for a list of event tickets associated with the order."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"These are the specific data field requirements for merchants who must provide event data. Note that these requirements can be extended on a case by case basis as decided by Revolut."}],"$L1eb6"]}]]}]]}] 1c27:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Type of the industry-specific data object, determining what additional data is expected."}],"\n",["$","p","p-1",{"children":"Available types:"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Object type","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"airline"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about a specific airline ticket purchase.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"car_rental"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about a car rental booking associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"crypto"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about crypto transactions associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"marketplace"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["This object is required by Mastercard and Visa for merchants operating as marketplaces under the ",["$","strong","strong-0",{"children":"Merchant Category Code (MCC):"}]," ",["$","code","code-0",{"children":"5262"}],". The marketplace object ensures compliance with the card schemes' regulations by providing detailed information about the subseller involved in the transaction."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-4",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"event"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about event ticket bookings associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-5",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"lodging"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about lodging bookings associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 1c28:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A unique identifier provided by the merchant associated with the order."}],"\n",["$","p","p-1",{"children":["This ",["$","code","code-0",{"children":"booking_id"}]," is used to reference and correlate booking information with the Merchant API and the merchant's internal system."]}]]}] 1c29:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":[["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_8601","target":"_blank","rel":"noreferrer","children":"ISO 8601"}]," date and time of the check-in."]}]]}] 1c2a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":[["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_8601","target":"_blank","rel":"noreferrer","children":"ISO 8601"}]," date and time of the check-out."]}]]}] 1c2b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":[["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_8601","target":"_blank","rel":"noreferrer","children":"ISO 8601"}]," date and time when the funds are released to merchants."]}]]}] 1c2c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of the accommodation associated with the booking."}]]}] 1c2d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Indicates whether the booking terms are fixed or flexible."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Parameter value","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"fixed"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Non-modifiable once confirmed.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"flexible"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Allows modifications or cancellations under specified conditions.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 1c2e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Parameter indicating whether the booking is refundable, partially refundable, or not refundable."}]]}] 1c2f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Primary address line."}]]}] 1c30:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Secondary address line, such as floor and apartment number."}]]}] 1c31:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"State or province of the address."}]]}] 1c32:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"City of the address."}]]}] 1c33:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"ISO 2-letter country code."}]]}] 1c34:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Postal code of the address."}]]}] 1c35:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Address of the accommodation."}]]}] 1c36:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Guest's first name."}]]}] 1c37:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Guest's last name."}]]}] 1c38:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"List of guests associated with the booking."}]]}] 1c39:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object containing details of a lodging booking."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"These are the specific data field requirements for merchants who must provide lodging data. Note that these requirements can be extended on a case by case basis as decided by Revolut."}],"$L1eb7"]}]]}]]}] 1c3a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object containing industry-specific information associated with the order."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"In the following cases, industry-specific info is required. Omitting this information may trigger additional scrutiny and risk mitigation actions by the Revolut risk team."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Transaction type","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Required for","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"airline"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Airlines and Online Travel Agencies (OTAs).","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"car_rental"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Car Rental Merchants and Online Travel Agencies (OTAs).","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"crypto"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Crypto merchants.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"marketplace"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Marketplace merchants.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-4",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"event"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Event ticket sellers.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-5",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"lodging"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Lodging providers.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}]]}]]}] 1c3b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The URL of the order stored in the merchant's order management system."}],"\n",["$","p","p-1",{"children":["This URL will be included in the order confirmation email for payments made via Revolut Pay. If specified, this URL will override the default link to the merchant's ",["$","strong","strong-0",{"children":"Business website"}]," configured in the Revolut Business account."]}],"\n",["$","div","inlinealert-0",{"data-type":"warning","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMark","color":"var(--rui-color-warning)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"Restrictions:"}],["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["Must be a valid URI as defined by ",["$","a","a-0",{"href":"https://datatracker.ietf.org/doc/html/rfc3986","target":"_blank","rel":"noreferrer","children":"RFC 3986"}]]}],"\n",["$","li","li-1",{"children":["URI scheme is required and must be either ",["$","code","code-0",{"children":"http"}]," or ",["$","code","code-1",{"children":"https"}]]}],"\n",["$","li","li-2",{"children":["URI host is required and cannot be ",["$","code","code-0",{"children":"localhost"}]," or an IP address"]}],"\n",["$","li","li-3",{"children":["Max length: ",["$","code","code-0",{"children":"2000"}]]}],"\n",["$","li","li-4",{"children":["Reserved or invalid characters must be percent-encoded (for example, use ",["$","code","code-0",{"children":"%20"}]," instead of a space)"]}],"\n"]}]]}]]}]]}] 1c3c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Merchant order ID for external reference."}],"\n",["$","p","p-1",{"children":"Use this field to set the ID that your own system can use to easily track orders."}]]}] 1c3d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object for providing additional information stored in the merchant's order management system."}]]}] 1c3e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The date and time in ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_8601","target":"_blank","rel":"noreferrer","children":"ISO 8601 format"}]," when the upcoming payment is scheduled to be executed."]}]]}] 1c3f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The unique ID of the customer's payment method used to complete the scheduled payment."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"For more information about operations related to customer's payment methods, see:"}],["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#retrieve-payment-method-list","target":"_blank","rel":"noreferrer","children":"Retrieve payment method list of a customer"}]}],"\n",["$","li","li-1",{"children":["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#retrieve-payment-method","target":"_blank","rel":"noreferrer","children":"Retrieve a customer's payment method"}]}],"\n",["$","li","li-2",{"children":["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#update-payment-method","target":"_blank","rel":"noreferrer","children":"Update a customer's payment method"}]}],"\n",["$","li","li-3",{"children":["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#delete-payment-method","target":"_blank","rel":"noreferrer","children":"Delete a customer's payment method"}]}],"\n"]}]]}]]}]]}] 1c40:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object containing information about upcoming payments associated with the order."}]]}] 1c41:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The URL your customer will be redirected to after a successful payment on the hosted checkout page (",["$","code","code-0",{"children":"checkout_url"}]," parameter's value of the order)."]}],"\n",["$","div","inlinealert-0",{"data-type":"warning","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMark","color":"var(--rui-color-warning)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"Restrictions:"}],["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["Must be a valid URI as defined by ",["$","a","a-0",{"href":"https://datatracker.ietf.org/doc/html/rfc3986","target":"_blank","rel":"noreferrer","children":"RFC 3986"}]]}],"\n",["$","li","li-1",{"children":["URI scheme is required and must be either ",["$","code","code-0",{"children":"http"}]," or ",["$","code","code-1",{"children":"https"}]]}],"\n",["$","li","li-2",{"children":["URI host is required and cannot be ",["$","code","code-0",{"children":"localhost"}]," or an IP address"]}],"\n",["$","li","li-3",{"children":["Max length: ",["$","code","code-0",{"children":"2000"}]]}],"\n",["$","li","li-4",{"children":["Reserved or invalid characters must be percent-encoded (for example, use ",["$","code","code-0",{"children":"%20"}]," instead of a space)"]}],"\n"]}]]}]]}],"\n",["$","div","inlinealert-1",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information on how to use the ",["$","code","code-0",{"children":"redirect_url"}],", see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/accept-payments/online-payments/hosted-checkout-page/api#custom-post-payment-redirection-optional","target":"_blank","rel":"noreferrer","children":"Custom redirection via the API"}]]}]}]]}]]}] 1c43:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"You can set a dynamic statement descriptor for your orders by providing a custom suffix."}],"\n",["$","p","p-1",{"children":"A statement descriptor is the text shown on cardholders' bank or card statements, helping them recognise a transaction or merchant. This field can be used to send extra information with the statement descriptor for card transactions."}],"\n",["$","p","p-2",{"children":["The complete descriptor is built using the following format: ",["$","code","code-0",{"children":"{base}*{suffix}"}],", where:"]}],"\n",["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":[["$","strong","strong-0",{"children":["$","code","code-0",{"children":"{base}"}]}]," is the existing descriptor configured in the Revolut Business dashboard (",["$","strong","strong-1",{"children":"Settings > Business account > Merchant profile > Statement descriptor"}],")."]}],"\n",["$","li","li-1",{"children":[["$","strong","strong-0",{"children":["$","code","code-0",{"children":"{suffix}"}]}]," is defined by the ",["$","code","code-0",{"children":"statement_descriptor_suffix"}]," field."]}],"\n"]}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["If the combined descriptor's length (base + suffix) exceeds the character limits of card scheme providers, the final value will be truncated. For example if the limit is 22 characters, the base descriptor is ",["$","code","code-0",{"children":"\"base\""}]," and the suffix is ",["$","code","code-1",{"children":"\"testdescriptorsuffix\""}],", the final descriptor becomes ",["$","code","code-2",{"children":"\"base*testdescriptorsuf\""}],"."]}],"\n",["$","li","li-1",{"children":"The final statement descriptor shown on a cardholder's statement may vary by issuing bank, as some banks apply their own custom formatting or truncation rules."}],"\n"]}]}]]}]]}] 1c44:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object schema containing information about order update body request parameters."}]]}] 1c48:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Update the details of an order."}],"\n",["$","p","p-1",{"children":["You can update an order and specific parameters based on the value of the ",["$","code","code-0",{"children":"state"}]," parameter:"]}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"State parameter value","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Modifiable parameters","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"pending"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"You can modify all listed parameters.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"authorised"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["You can modify the following parameters: ",["$","br","br-0",{}],["$","br","br-1",{}]," ",["$","ul","ul-0",{"children":[["$","li","li-0",{"children":["$","code","code-0",{"children":"merchant_order_data.reference"}]}],["$","li","li-1",{"children":["$","code","code-0",{"children":"description"}]}],["$","li","li-2",{"children":["$","code","code-0",{"children":"metadata"}]}],["$","li","li-3",{"children":["$","code","code-0",{"children":"shipping"}]}],["$","li","li-4",{"children":["$","code","code-0",{"children":"industry_data"}]}],["$","li","li-5",{"children":["$","code","code-0",{"children":"cancel_authorised_after"}]}]]}]],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"completed"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["You can modify the following parameters: ",["$","br","br-0",{}],["$","br","br-1",{}]," ",["$","ul","ul-0",{"children":[["$","li","li-0",{"children":["$","code","code-0",{"children":"merchant_order_data.reference"}]}],["$","li","li-1",{"children":["$","code","code-0",{"children":"description"}]}],["$","li","li-2",{"children":["$","code","code-0",{"children":"metadata"}]}],["$","li","li-3",{"children":["$","code","code-0",{"children":"shipping"}]}],["$","li","li-4",{"children":["$","code","code-0",{"children":"industry_data"}]}]]}]],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"processing"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"You cannot modify parameters.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information about the order lifecycle, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/reference/order-lifecycle","target":"_blank","rel":"noreferrer","children":"Order and payment lifecycle"}],"."]}]}]]}]]}] 1c49:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["This parameter accepts the ",["$","a","a-0",{"href":"https://business.revolut.com/settings/apis?tab=merchant-api","target":"_blank","rel":"noreferrer","children":"Merchant API Secret key"}]," to authorise requests coming from the merchant's backend."]}],"\n",["$","p","p-1",{"children":["It ensures that ensures that each request is authenticated and authorised by verifying the secret key. The secret key should be included in all request headers as a ",["$","code","code-0",{"children":"Bearer"}]," token."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#authentication","target":"_blank","rel":"noreferrer","children":"Authentication"}]]}]}]]}]]}] 1c4a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The version of the Merchant API, specified in ",["$","code","code-0",{"children":"YYYY-MM-DD"}]," format."]}],"\n",["$","p","p-1",{"children":"If not specified, you will receive an error."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information about API versioning, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/reference/versioning/api-versions","target":"_blank","rel":"noreferrer","children":"API versions"}],"."]}]}]]}]]}] 1c4b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A UUID string, typically used to identify resources."}]]}] 1c4c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ID of the ",["$","code","code-0",{"children":"Order"}]," object."]}]]}] 1ea5:["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#cancel-order","target":"_blank","rel":"noreferrer","children":"Cancel the order"}] 1ea6:["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#cancel-order","target":"_blank","rel":"noreferrer","children":"Cancel the order"}] 1ea7:["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#cancel-order","target":"_blank","rel":"noreferrer","children":"Cancel the order"}] 1ea8:["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#cancel-order","target":"_blank","rel":"noreferrer","children":"Cancel the order"}] 1ea9:["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#cancel-order","target":"_blank","rel":"noreferrer","children":"Cancel the order"}] 1c5e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Each Merchant API request must contain an authorization header in the following format:"}],"\n","$L1eb8","\n",["$","p","p-1",{"children":"To use this API, you need to generate API keys from your Revolut Business account. The Secret key is used in the authorization header for all server calls, while the Public key is provided with payment methods at checkout."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For detailed instructions on generating your API keys, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/get-started#generate-api-keys","target":"_blank","rel":"noreferrer","children":"Generate API keys"}],"."]}]}]]}]]}] 1e78:"Create an order" 1c65:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Permanent order ID used to retrieve, capture, cancel, or refund an order after authorization."}]]}] 1c66:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Temporary ID for the order, which expires when the payment is authorised."}],"\n",["$","p","p-1",{"children":["The order ",["$","code","code-0",{"children":"token"}]," is used for ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/sdks/merchant-web-sdk/initialisation/token-based","target":"_blank","rel":"noreferrer","children":"token-based initialisation"}],", and is returned by the ",["$","code","code-1",{"children":"createOrder"}]," callback in the following payment methods:"]}],"\n",["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["$","a","a-0",{"href":"https://developer.revolut.com/docs/sdks/merchant-web-sdk/payment-methods/embedded-checkout#embedded-checkout-options-interface","target":"_blank","rel":"noreferrer","children":"Embedded Checkout"}]}],"\n",["$","li","li-1",{"children":["$","a","a-0",{"href":"https://developer.revolut.com/docs/sdks/merchant-web-sdk/payment-methods/revolut-pay#widget-payments-revolut-pay-options","target":"_blank","rel":"noreferrer","children":"Revolut Pay"}]}],"\n",["$","li","li-2",{"children":["$","a","a-0",{"href":"https://developer.revolut.com/docs/sdks/merchant-web-sdk/payment-methods/apple-pay-google-pay#payment-request-options-interface","target":"_blank","rel":"noreferrer","children":"Apple Pay and Google Pay"}]}],"\n",["$","li","li-3",{"children":["$","a","a-0",{"href":"https://developer.revolut.com/docs/sdks/merchant-web-sdk/payment-methods/pay-by-bank#pay-by-bank-options-interface","target":"_blank","rel":"noreferrer","children":"Pay by Bank"}]}],"\n"]}]]}] 1c67:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of the order."}]]}] 1c68:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The state of the order in its lifecycle."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"State","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"pending"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Order created, awaiting payment","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"processing"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Payment is being processed","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"authorised"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Payment authorised but not yet captured (for manual capture)","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"completed"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Payment successfully captured and settled","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-4",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"cancelled"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Order was cancelled","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-5",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"failed"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Payment failed","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/reference/order-lifecycle","target":"_blank","rel":"noreferrer","children":"Order and payment lifecycle"}]]}]}]]}]]}] 1c69:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The date and time the order was created."}]]}] 1c6a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The date and time the order was last updated."}]]}] 1c6b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The description of the order."}]]}] 1c6c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The capture mode of the order. ",["$","code","code-0",{"children":"automatic"}]," is used by default."]}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Parameter value","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"automatic"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The order is captured automatically after payment authorisation.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"manual"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The order is not captured automatically. You must manually capture the order later.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information, see ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#capture-order","target":"_blank","rel":"noreferrer","children":"Capture an order"}],"."]}]}]]}]]}] 1c6d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The type of authorisation for the order. Used with manual capture mode. If omitted, ",["$","code","code-0",{"children":"final"}]," is used by default."]}],"\n",["$","h1","h1-0",{"children":"Pre-authorisation"}],"\n",["$","p","p-1",{"children":"Pre-authorisation allows you to reserve funds on a customer's card without immediately capturing them. This is useful for scenarios like:"}],"\n",["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":"Hotel bookings where the final amount may vary"}],"\n",["$","li","li-1",{"children":"Car rentals where additional charges may apply"}],"\n",["$","li","li-2",{"children":"Deposits that need to be held temporarily"}],"\n"]}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Parameter value","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"final"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Standard authorisation for immediate or near-immediate capture.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"pre_authorisation"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Reserve funds for later capture, used with manual capture mode.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["Pre-authorisation must be used with ",["$","code","code-0",{"children":"capture_mode: manual"}],". For more information, see ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#capture-order","target":"_blank","rel":"noreferrer","children":"Capture an order"}],"."]}]}]]}]]}] 1c6f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["Automatic cancellation period for uncaptured orders, specified in ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_8601","target":"_blank","rel":"noreferrer","children":"ISO 8601"}]," format."]}],"\n",["$","p","p-1",{"children":["After this period, the authorised payment is automatically cancelled and the order is cancelled. Maximum: 7 days = ",["$","code","code-0",{"children":"P7D"}],"."]}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"The following limitations apply:"}],["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["\n",["$","p","p-0",{"children":"Cannot be a negative value."}],"\n"]}],"\n",["$","li","li-1",{"children":["\n",["$","p","p-0",{"children":"Cannot be updated if the new value is less than or equal to the elapsed time since authorisation."}],"\n",["$","p","p-1",{"children":["$","strong","strong-0",{"children":"Failing scenario:"}]}],"\n",["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":"Original value: 7 days"}],"\n",["$","li","li-1",{"children":"Time since authorisation: 3 days"}],"\n",["$","li","li-2",{"children":"Update value: 2 days"}],"\n"]}],"\n",["$","p","p-2",{"children":"In this scenario, an error is returned."}],"\n",["$","p","p-3",{"children":["$","strong","strong-0",{"children":"Successful scenario:"}]}],"\n",["$","ul","ul-1",{"children":["\n",["$","li","li-0",{"children":"Original value: 7 days"}],"\n",["$","li","li-1",{"children":"Time since authorisation: 3 days"}],"\n",["$","li","li-2",{"children":"Update value: 4 days"}],"\n"]}],"\n",["$","p","p-4",{"children":"In this scenario, the parameter can be updated."}],"\n"]}],"\n",["$","li","li-2",{"children":["\n",["$","p","p-0",{"children":"Cannot be updated if cancellation is ≤ 30 minutes away."}],"\n",["$","p","p-1",{"children":["$","strong","strong-0",{"children":"Failing scenario:"}]}],"\n",["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":"Original value: 12 hours"}],"\n",["$","li","li-1",{"children":"Time since authorisation: 11 hours 40 minutes"}],"\n"]}],"\n",["$","p","p-2",{"children":"In this scenario, an error is returned."}],"\n",["$","p","p-3",{"children":["$","strong","strong-0",{"children":"Successful scenario:"}]}],"\n",["$","ul","ul-1",{"children":["\n",["$","li","li-0",{"children":"Original value: 12 hours"}],"\n",["$","li","li-1",{"children":"Time since authorisation: 11 hours 20 minutes"}],"\n"]}],"\n",["$","p","p-4",{"children":"In this scenario, the parameter can be updated."}],"\n"]}],"\n"]}]]}]]}]]}] 1c70:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The order total expressed in minor currency units, according to the ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_4217","target":"_blank","rel":"noreferrer","children":"ISO 4217 standard"}],". For example, ",["$","code","code-0",{"children":"7034"}]," in ",["$","code","code-1",{"children":"EUR"}]," corresponds to €70.34."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["Conversion between major and minor units varies by currency. For instance, ",["$","code","code-0",{"children":"100"}]," minor units equal £1.00 in ",["$","code","code-1",{"children":"GBP"}],", whereas in ",["$","code","code-2",{"children":"ISK"}]," they represent 100 units. For more details, see the ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_4217","target":"_blank","rel":"noreferrer","children":"ISO 4217 standard"}],"."]}],"\n",["$","li","li-1",{"children":["If ",["$","code","code-0",{"children":"line_items"}]," are provided, the order ",["$","code","code-1",{"children":"amount"}]," must equal the sum of all line items' ",["$","code","code-2",{"children":"total_amount"}],"."]}],"\n",["$","li","li-2",{"children":["For card payments with a non-zero amount, the order ",["$","code","code-0",{"children":"amount"}]," must be at least ",["$","strong","strong-0",{"children":"$$0.005"}]," (or equivalent in different currencies, calculated using Revolut's exchange rate on the payment date). Otherwise, card payments can't be performed."]}],"\n"]}]}]]}]]}] 1c71:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The amount not yet paid for a given order (in minor currency units). For example, ",["$","code","code-0",{"children":"7034"}]," represents €70.34."]}],"\n",["$","p","p-1",{"children":["The value in this field may differ from ",["$","code","code-0",{"children":"amount"}]," if there are partial payments associated with the order."]}]]}] 1c72:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The amount that was refunded from the order (in minor currency units). For example, ",["$","code","code-0",{"children":"7034"}]," represents €70.34."]}],"\n",["$","p","p-1",{"children":["This applies to orders that have been refunded (i.e., orders of type ",["$","code","code-0",{"children":"payment"}]," that have a related ",["$","code","code-1",{"children":"refund"}]," order)."]}]]}] 1c73:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":[["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_4217","target":"_blank","rel":"noreferrer","children":"ISO 4217"}]," currency code in upper case."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information about the supported currencies, see: ",["$","a","a-0",{"href":"https://help.revolut.com/business/help/merchant-accounts/payments/in-which-currencies-can-i-accept-payments/","target":"_blank","rel":"noreferrer","children":"Help Center"}],"."]}]}]]}]]}] 1c74:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":[["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_4217","target":"_blank","rel":"noreferrer","children":"ISO 4217"}]," currency code in upper case."]}],"\n",["$","p","p-1",{"children":["If ",["$","code","code-0",{"children":"settlement_currency"}]," is different from the value of ",["$","code","code-1",{"children":"currency"}],", the money will be exchanged when the amount is settled to your merchant account. In case of a refund or chargeback, the money will be exchanged to the order's initial ",["$","code","code-2",{"children":"currency"}],"."]}],"\n",["$","p","p-2",{"children":["If ",["$","code","code-0",{"children":"settlement_currency"}]," is not specified, this value is taken from ",["$","code","code-1",{"children":"currency"}],"."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information about the supported currencies, see: ",["$","a","a-0",{"href":"https://help.revolut.com/business/help/merchant-accounts/payments/in-which-currencies-can-i-accept-payments/","target":"_blank","rel":"noreferrer","children":"Help Center"}],"."]}]}]]}]]}] 1c76:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Permanent ID of a customer used to retrieve, update, delete a customer. This ID can also be used to link customer to an order."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":"If you provide the customer's ID during order creation, no other customer data is required, they will be parsed automatically from the referenced customer object."}]}]]}]]}] 1c77:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The full name of the customer."}]]}] 1c78:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The phone number of the customer in ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/E.164","target":"_blank","rel":"noreferrer","children":"E.164 format"}],"."]}]]}] 1c79:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The email address of the customer."}]]}] 1c7a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The birth date of the customer."}]]}] 1c7b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object containing information about a customer."}],"\n",["$","p","p-1",{"children":["If you have it, we strongly advise providing at least either ",["$","code","code-0",{"children":"id"}],", ",["$","code","code-1",{"children":"phone"}],", or ",["$","code","code-2",{"children":"email"}],"."]}],"\n",["$","p","p-2",{"children":["Using the ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#tag-customers","target":"_blank","rel":"noreferrer","children":"Customers operations"}],", you can manage customer instances."]}],"\n",["$","p","p-3",{"children":"The following behaviours apply to different use cases:"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Use case","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"API behavior","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":"Existing customer","className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["If ",["$","code","code-0",{"children":"id"}]," was provided, we ignore other customer details and associate the customer with the order.",["$","br","br-0",{}],["$","br","br-1",{}],"If either ",["$","code","code-1",{"children":"email"}],", ",["$","code","code-2",{"children":"phone"}],", or ",["$","code","code-3",{"children":"full_name"}]," was provided (without an existing customer's ",["$","code","code-4",{"children":"id"}],"), we always create a new customer, irrespective of another, existing customer object having the same details."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":"New customer","className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["If either ",["$","code","code-0",{"children":"email"}],", ",["$","code","code-1",{"children":"phone"}],", or ",["$","code","code-2",{"children":"full_name"}]," was provided, we create a new customer, irrespective of another customer object having the same details. ",["$","br","br-0",{}],["$","br","br-1",{}],"If ",["$","code","code-3",{"children":"id"}]," of a non-existent customer was provided, we return a ",["$","code","code-4",{"children":"404"}]," error, irrespective of other details provided."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["To avoid unintentional duplication of customer records, search for an existing customer by email or phone using the ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#retrieve-customer-list","target":"_blank","rel":"noreferrer","children":"List customers"}]," endpoint first, then provide ",["$","code","code-0",{"children":"customer.id"}]," in the order."]}]}]]}]]}] 1c7c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The ID of the payment."}]]}] 1c7d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The status of the payment."}]]}] 1c7e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The reason for a ",["$","code","code-0",{"children":"failed"}]," or ",["$","code","code-1",{"children":"declined"}]," payment."]}],"\n",["$","p","p-1",{"children":["A failed or declined payment can result from multiple reasons. To learn more, check our ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/reference/error-codes/decline-reasons","target":"_blank","rel":"noreferrer","children":"failure reasons"}],"."]}]]}] 1c7f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The reason for a ",["$","code","code-0",{"children":"failed"}]," or ",["$","code","code-1",{"children":"declined"}]," payment, sent by the financial institution processing the payment."]}]]}] 1c80:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The date and time the payment was created."}]]}] 1c81:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The date and time the payment was last updated."}]]}] 1c82:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Temporary token of the payment used to fetch the reward offer during checkout and link user registrations to the given offers."}],"\n",["$","p","p-1",{"children":"The token is only valid for a limited time."}]]}] 1c83:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The payment amount in minor units (e.g., cents). The value of this field depends on the payment type and state."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Payment type","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"State","className":"eowryt6","ref":"$undefined"}],["$","th","th-2",{"children":"Amount value","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":"Standard payment","className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Any","className":"eowryt7","ref":"$undefined"}],["$","td","td-2",{"children":"Total payment amount","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":"Pre-authorised payment","className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["$","code","code-0",{"children":"authorisation_started"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-2",{"children":"New amount being authorised (during increment processing)","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":"Pre-authorised payment","className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["$","code","code-0",{"children":"authorised"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-2",{"children":["Currently authorised amount (equals ",["$","code","code-0",{"children":"authorised_amount"}],")"],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For pre-authorised payments, see the ",["$","code","code-0",{"children":"authorised_amount"}]," field for tracking the currently authorised amount separately."]}]}]]}]]}] 1c84:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The currently authorised amount for this payment (in minor units)."}],"\n",["$","p","p-1",{"children":"For pre-authorised payments with incremental authorization:"}],"\n",["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["Initially equals the ",["$","code","code-0",{"children":"amount"}]," field"]}],"\n",["$","li","li-1",{"children":"Remains unchanged during increment processing"}],"\n",["$","li","li-2",{"children":"Updates to new amount upon successful increment"}],"\n",["$","li","li-3",{"children":"Remains at original amount if increment is declined"}],"\n"]}],"\n",["$","p","p-2",{"children":["For standard payments, this field may not be present or will equal the ",["$","code","code-0",{"children":"amount"}]," field."]}]]}] 1c85:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":[["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_4217","target":"_blank","rel":"noreferrer","children":"ISO 4217"}]," currency code in upper case."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information about the supported currencies, see: ",["$","a","a-0",{"href":"https://help.revolut.com/business/help/merchant-accounts/payments/in-which-currencies-can-i-accept-payments/","target":"_blank","rel":"noreferrer","children":"Help Center"}],"."]}]}]]}]]}] 1c86:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The amount of the settled payment (minor currency unit). For example, ",["$","code","code-0",{"children":"7034"}]," stands for €70.34."]}]]}] 1c87:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The currency of the settled payment. ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_4217","target":"_blank","rel":"noreferrer","children":"ISO 4217"}]," currency code in upper case."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information about the supported currencies, see: ",["$","a","a-0",{"href":"https://help.revolut.com/business/help/merchant-accounts/payments/in-which-currencies-can-i-accept-payments/","target":"_blank","rel":"noreferrer","children":"Help Center"}],"."]}]}]]}]]}] 1c88:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"ID of the saved payment method."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["The ",["$","code","code-0",{"children":"id"}]," parameter is only returned when the payment method is saved."]}]}]]}]]}] 1c89:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of payment method used to pay for the order."}],"\n",["$","p","p-1",{"children":"Available values:"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":["Payment method ",["$","code","code-0",{"children":"type"}]],"className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"apple_pay"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using Apple Pay.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"card"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using their credit or debit card.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"google_pay"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using Google Pay.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"revolut_pay_card"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order via Revolut Pay using their credit or debit card.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-4",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"revolut_pay_account"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order via Revolut Pay using their Revolut account.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-5",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"sepa_direct_debit"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using SEPA Direct Debit.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 1c8a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of the card."}]]}] 1c8b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of card funding."}]]}] 1c8c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The 2-letter country code of the country where the card was issued."}]]}] 1c8d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The BIN of the card."}]]}] 1c8e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The last four digits of the card number."}]]}] 1c8f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The expiry date of the card in the format of MM/YY."}]]}] 1c90:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The name of the cardholder."}]]}] 1c91:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The Electronic Commerce Indicator (ECI) value corresponds to the authentication result and indicates the level of security used when the payment information was provided."}]]}] 1c92:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The result of 3D Secure check."}]]}] 1c93:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The 3D Secure version."}]]}] 1c94:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The details of the 3D Secure check. Only for orders with successful payments."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":"Not returned for Apple Pay and Google Pay payments."}]}]]}]]}] 1c95:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The result of CVV verification."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Parameter value","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"match"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"CVV matches the card's CVV","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"not_match"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"CVV does not match the card's CVV","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"incorrect"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"CVV format is incorrect for this type of card","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"not_processed"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"CVV verification was not performed","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 1c96:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The result of address verification."}]]}] 1c97:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The result of postcode verification."}]]}] 1c98:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The result of cardholder verification."}]]}] 1c99:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The details of the check for card payment. Only for orders with successful payments."}]]}] 1c9a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The authorisation code (or auth code) is a short, alphanumeric code returned by the cardholder's issuing bank to the merchant's terminal or payment gateway."}],"\n",["$","p","p-1",{"children":"It serves as confirmation that the transaction has been approved and funds are available."}]]}] 1c9b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Acquirer Reference Number (ARN) of the payment."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":"Only returned for refund payments made by a card."}]}]]}]]}] 1c9c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The date and time by which the payment must be captured."}],"\n",["$","p","p-1",{"children":"After this deadline, the authorised funds may be automatically released by the card issuer."}]]}] 1c9d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The hardware identifier of the Revolut Terminal device used to process the payment."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":"Only present for card-present transactions processed via Revolut Terminal."}]}]]}]]}] 1c9f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A unique identifier for a payment method, always 44 characters long. This fingerprint can be used to uniquely identify various payment methods."}],"\n",["$","h1","h1-0",{"children":"Fingerprint generation"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Payment method","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","strong","strong-0",{"children":"All payment methods"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"A fingerprint is generated for all payment methods, including cards, Revolut Pay (card, account-to-account payments), Apple Pay, and Google Pay.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","strong","strong-0",{"children":"Cards (Revolut Pay & Card Gateway)"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"For cards, the fingerprint is based on the PAN. Cards processed via Revolut Pay and our card gateway will share the same fingerprint. Renewed cards (new expiry/CVV) retain the same fingerprint for efficient blocking.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","strong","strong-0",{"children":"Apple Pay & Google Pay"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Since Apple Pay and Google Pay provide us Device PANs (DPAN), the fingerprint is based on the DPAN provided by Apple/Google, not the connected card's PAN. This means that a new DPAN (and fingerprint) is generated for cards in case they are re-added to the customer's digital wallet, or added to different devices.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}],"\n",["$","h4","h4-0",{"children":"Detecting duplicate payment methods"}],"\n",["$","p","p-1",{"children":"Fingerprints are a valuable tool for detecting duplicate payment methods by identifying if a payment method has been seen before. This capability, in turn, helps in preventing various types of misuse (e.g., exploitation of free trials, or association with known problematic accounts, which can be a form of fraud). To effectively use fingerprints for this purpose, you will need to create and maintain your own lists (e.g., blocklists of known problematic fingerprints, allowlists for trusted customers, or tracking frequently used fingerprints)."}],"\n",["$","p","p-2",{"children":"The ideal way to utilise fingerprints is by combining them with a manual capture process. While automatic capture with subsequent refunds for problematic payments is possible, manual capture based on fingerprint validation is recommended."}],"\n",["$","p","p-3",{"children":"During your manual capture workflow, after a payment was authorised:"}],"\n",["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":"Check the fingerprint status by comparing it against your maintained lists and internal business rules."}],"\n",["$","li","li-1",{"children":["If you decide to proceed with the payment (e.g., the fingerprint is not on a blocklist, or matches a trusted customer's previous payment method): ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#capture-order","target":"_blank","rel":"noreferrer","children":"Capture the order"}],"."]}],"\n",["$","li","li-2",{"children":["If you decide not to proceed with the payment (e.g., the fingerprint matches a known fraudulent fingerprint, or exhibits suspicious patterns): ","$L1eb9","."]}],"\n"]}]]}] 1ca0:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The Network Transaction ID (NTI) is a unique identifier assigned by the card scheme (e.g., Visa or Mastercard) to a card transaction."}],"\n",["$","p","p-1",{"children":"It can be used to trace the transaction across the payment network, link recurring or instalment payments to the original authorisation, and support dispute resolution."}]]}] 1ca1:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object containing details of a card used via Apple Pay."}]]}] 1ca2:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"ID of the saved payment method."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["The ",["$","code","code-0",{"children":"id"}]," parameter is only returned when the payment method is saved."]}]}]]}]]}] 1ca3:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of payment method used to pay for the order."}],"\n",["$","p","p-1",{"children":"Available values:"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":["Payment method ",["$","code","code-0",{"children":"type"}]],"className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"apple_pay"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using Apple Pay.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"card"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using their credit or debit card.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"google_pay"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using Google Pay.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"revolut_pay_card"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order via Revolut Pay using their credit or debit card.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-4",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"revolut_pay_account"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order via Revolut Pay using their Revolut account.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-5",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"sepa_direct_debit"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using SEPA Direct Debit.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 1ca4:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of the card."}]]}] 1ca5:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of card funding."}]]}] 1ca6:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The 2-letter country code of the country where the card was issued."}]]}] 1ca7:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The BIN of the card."}]]}] 1ca8:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The last four digits of the card number."}]]}] 1ca9:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The expiry date of the card in the format of MM/YY."}]]}] 1caa:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The name of the cardholder."}]]}] 1cab:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The details of the check for card payment. Only for orders with successful payments."}]]}] 1cac:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The authorisation code (or auth code) is a short, alphanumeric code returned by the cardholder's issuing bank to the merchant's terminal or payment gateway."}],"\n",["$","p","p-1",{"children":"It serves as confirmation that the transaction has been approved and funds are available."}]]}] 1cad:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Acquirer Reference Number (ARN) of the payment."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":"Only returned for refund payments made by a card."}]}]]}]]}] 1cae:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The date and time by which the payment must be captured."}],"\n",["$","p","p-1",{"children":"After this deadline, the authorised funds may be automatically released by the card issuer."}]]}] 1caf:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The hardware identifier of the Revolut Terminal device used to process the payment."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":"Only present for card-present transactions processed via Revolut Terminal."}]}]]}]]}] 1cb1:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A unique identifier for a payment method, always 44 characters long. This fingerprint can be used to uniquely identify various payment methods."}],"\n",["$","h1","h1-0",{"children":"Fingerprint generation"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Payment method","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","strong","strong-0",{"children":"All payment methods"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"A fingerprint is generated for all payment methods, including cards, Revolut Pay (card, account-to-account payments), Apple Pay, and Google Pay.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","strong","strong-0",{"children":"Cards (Revolut Pay & Card Gateway)"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"For cards, the fingerprint is based on the PAN. Cards processed via Revolut Pay and our card gateway will share the same fingerprint. Renewed cards (new expiry/CVV) retain the same fingerprint for efficient blocking.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","strong","strong-0",{"children":"Apple Pay & Google Pay"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Since Apple Pay and Google Pay provide us Device PANs (DPAN), the fingerprint is based on the DPAN provided by Apple/Google, not the connected card's PAN. This means that a new DPAN (and fingerprint) is generated for cards in case they are re-added to the customer's digital wallet, or added to different devices.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}],"\n",["$","h4","h4-0",{"children":"Detecting duplicate payment methods"}],"\n",["$","p","p-1",{"children":"Fingerprints are a valuable tool for detecting duplicate payment methods by identifying if a payment method has been seen before. This capability, in turn, helps in preventing various types of misuse (e.g., exploitation of free trials, or association with known problematic accounts, which can be a form of fraud). To effectively use fingerprints for this purpose, you will need to create and maintain your own lists (e.g., blocklists of known problematic fingerprints, allowlists for trusted customers, or tracking frequently used fingerprints)."}],"\n",["$","p","p-2",{"children":"The ideal way to utilise fingerprints is by combining them with a manual capture process. While automatic capture with subsequent refunds for problematic payments is possible, manual capture based on fingerprint validation is recommended."}],"\n",["$","p","p-3",{"children":"During your manual capture workflow, after a payment was authorised:"}],"\n",["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":"Check the fingerprint status by comparing it against your maintained lists and internal business rules."}],"\n",["$","li","li-1",{"children":["If you decide to proceed with the payment (e.g., the fingerprint is not on a blocklist, or matches a trusted customer's previous payment method): ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#capture-order","target":"_blank","rel":"noreferrer","children":"Capture the order"}],"."]}],"\n",["$","li","li-2",{"children":["If you decide not to proceed with the payment (e.g., the fingerprint matches a known fraudulent fingerprint, or exhibits suspicious patterns): ","$L1eba","."]}],"\n"]}]]}] 1cb2:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The Network Transaction ID (NTI) is a unique identifier assigned by the card scheme (e.g., Visa or Mastercard) to a card transaction."}],"\n",["$","p","p-1",{"children":"It can be used to trace the transaction across the payment network, link recurring or instalment payments to the original authorisation, and support dispute resolution."}]]}] 1cb3:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object containing details of the card used for the payment."}]]}] 1cb4:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"ID of the saved payment method."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["The ",["$","code","code-0",{"children":"id"}]," parameter is only returned when the payment method is saved."]}]}]]}]]}] 1cb5:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of payment method used to pay for the order."}],"\n",["$","p","p-1",{"children":"Available values:"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":["Payment method ",["$","code","code-0",{"children":"type"}]],"className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"apple_pay"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using Apple Pay.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"card"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using their credit or debit card.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"google_pay"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using Google Pay.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"revolut_pay_card"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order via Revolut Pay using their credit or debit card.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-4",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"revolut_pay_account"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order via Revolut Pay using their Revolut account.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-5",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"sepa_direct_debit"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using SEPA Direct Debit.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 1cb6:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of the card."}]]}] 1cb7:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of card funding."}]]}] 1cb8:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The 2-letter country code of the country where the card was issued."}]]}] 1cb9:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The BIN of the card."}]]}] 1cba:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The last four digits of the card number."}]]}] 1cbb:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The expiry date of the card in the format of MM/YY."}]]}] 1cbc:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The name of the cardholder."}]]}] 1cbd:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The details of the check for card payment. Only for orders with successful payments."}]]}] 1cbe:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The authorisation code (or auth code) is a short, alphanumeric code returned by the cardholder's issuing bank to the merchant's terminal or payment gateway."}],"\n",["$","p","p-1",{"children":"It serves as confirmation that the transaction has been approved and funds are available."}]]}] 1cbf:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Acquirer Reference Number (ARN) of the payment."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":"Only returned for refund payments made by a card."}]}]]}]]}] 1cc0:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The date and time by which the payment must be captured."}],"\n",["$","p","p-1",{"children":"After this deadline, the authorised funds may be automatically released by the card issuer."}]]}] 1cc1:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The hardware identifier of the Revolut Terminal device used to process the payment."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":"Only present for card-present transactions processed via Revolut Terminal."}]}]]}]]}] 1cc3:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A unique identifier for a payment method, always 44 characters long. This fingerprint can be used to uniquely identify various payment methods."}],"\n",["$","h1","h1-0",{"children":"Fingerprint generation"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Payment method","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","strong","strong-0",{"children":"All payment methods"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"A fingerprint is generated for all payment methods, including cards, Revolut Pay (card, account-to-account payments), Apple Pay, and Google Pay.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","strong","strong-0",{"children":"Cards (Revolut Pay & Card Gateway)"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"For cards, the fingerprint is based on the PAN. Cards processed via Revolut Pay and our card gateway will share the same fingerprint. Renewed cards (new expiry/CVV) retain the same fingerprint for efficient blocking.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","strong","strong-0",{"children":"Apple Pay & Google Pay"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Since Apple Pay and Google Pay provide us Device PANs (DPAN), the fingerprint is based on the DPAN provided by Apple/Google, not the connected card's PAN. This means that a new DPAN (and fingerprint) is generated for cards in case they are re-added to the customer's digital wallet, or added to different devices.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}],"\n",["$","h4","h4-0",{"children":"Detecting duplicate payment methods"}],"\n",["$","p","p-1",{"children":"Fingerprints are a valuable tool for detecting duplicate payment methods by identifying if a payment method has been seen before. This capability, in turn, helps in preventing various types of misuse (e.g., exploitation of free trials, or association with known problematic accounts, which can be a form of fraud). To effectively use fingerprints for this purpose, you will need to create and maintain your own lists (e.g., blocklists of known problematic fingerprints, allowlists for trusted customers, or tracking frequently used fingerprints)."}],"\n",["$","p","p-2",{"children":"The ideal way to utilise fingerprints is by combining them with a manual capture process. While automatic capture with subsequent refunds for problematic payments is possible, manual capture based on fingerprint validation is recommended."}],"\n",["$","p","p-3",{"children":"During your manual capture workflow, after a payment was authorised:"}],"\n",["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":"Check the fingerprint status by comparing it against your maintained lists and internal business rules."}],"\n",["$","li","li-1",{"children":["If you decide to proceed with the payment (e.g., the fingerprint is not on a blocklist, or matches a trusted customer's previous payment method): ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#capture-order","target":"_blank","rel":"noreferrer","children":"Capture the order"}],"."]}],"\n",["$","li","li-2",{"children":["If you decide not to proceed with the payment (e.g., the fingerprint matches a known fraudulent fingerprint, or exhibits suspicious patterns): ","$L1ebb","."]}],"\n"]}]]}] 1cc4:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The Network Transaction ID (NTI) is a unique identifier assigned by the card scheme (e.g., Visa or Mastercard) to a card transaction."}],"\n",["$","p","p-1",{"children":"It can be used to trace the transaction across the payment network, link recurring or instalment payments to the original authorisation, and support dispute resolution."}]]}] 1cc5:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object containing details of a card used via Google Pay."}]]}] 1cc6:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"ID of the saved payment method."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["The ",["$","code","code-0",{"children":"id"}]," parameter is only returned when the payment method is saved."]}]}]]}]]}] 1cc7:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of payment method used to pay for the order."}],"\n",["$","p","p-1",{"children":"Available values:"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":["Payment method ",["$","code","code-0",{"children":"type"}]],"className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"apple_pay"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using Apple Pay.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"card"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using their credit or debit card.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"google_pay"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using Google Pay.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"revolut_pay_card"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order via Revolut Pay using their credit or debit card.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-4",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"revolut_pay_account"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order via Revolut Pay using their Revolut account.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-5",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"sepa_direct_debit"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using SEPA Direct Debit.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 1cc8:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of the card."}]]}] 1cc9:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of card funding."}]]}] 1cca:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The 2-letter country code of the country where the card was issued."}]]}] 1ccb:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The BIN of the card."}]]}] 1ccc:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The last four digits of the card number."}]]}] 1ccd:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The expiry date of the card in the format of MM/YY."}]]}] 1cce:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The name of the cardholder."}]]}] 1ccf:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The details of the check for card payment. Only for orders with successful payments."}]]}] 1cd0:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The authorisation code (or auth code) is a short, alphanumeric code returned by the cardholder's issuing bank to the merchant's terminal or payment gateway."}],"\n",["$","p","p-1",{"children":"It serves as confirmation that the transaction has been approved and funds are available."}]]}] 1cd1:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Acquirer Reference Number (ARN) of the payment."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":"Only returned for refund payments made by a card."}]}]]}]]}] 1cd2:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The date and time by which the payment must be captured."}],"\n",["$","p","p-1",{"children":"After this deadline, the authorised funds may be automatically released by the card issuer."}]]}] 1cd3:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The hardware identifier of the Revolut Terminal device used to process the payment."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":"Only present for card-present transactions processed via Revolut Terminal."}]}]]}]]}] 1cd5:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A unique identifier for a payment method, always 44 characters long. This fingerprint can be used to uniquely identify various payment methods."}],"\n",["$","h1","h1-0",{"children":"Fingerprint generation"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Payment method","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","strong","strong-0",{"children":"All payment methods"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"A fingerprint is generated for all payment methods, including cards, Revolut Pay (card, account-to-account payments), Apple Pay, and Google Pay.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","strong","strong-0",{"children":"Cards (Revolut Pay & Card Gateway)"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"For cards, the fingerprint is based on the PAN. Cards processed via Revolut Pay and our card gateway will share the same fingerprint. Renewed cards (new expiry/CVV) retain the same fingerprint for efficient blocking.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","strong","strong-0",{"children":"Apple Pay & Google Pay"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Since Apple Pay and Google Pay provide us Device PANs (DPAN), the fingerprint is based on the DPAN provided by Apple/Google, not the connected card's PAN. This means that a new DPAN (and fingerprint) is generated for cards in case they are re-added to the customer's digital wallet, or added to different devices.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}],"\n",["$","h4","h4-0",{"children":"Detecting duplicate payment methods"}],"\n",["$","p","p-1",{"children":"Fingerprints are a valuable tool for detecting duplicate payment methods by identifying if a payment method has been seen before. This capability, in turn, helps in preventing various types of misuse (e.g., exploitation of free trials, or association with known problematic accounts, which can be a form of fraud). To effectively use fingerprints for this purpose, you will need to create and maintain your own lists (e.g., blocklists of known problematic fingerprints, allowlists for trusted customers, or tracking frequently used fingerprints)."}],"\n",["$","p","p-2",{"children":"The ideal way to utilise fingerprints is by combining them with a manual capture process. While automatic capture with subsequent refunds for problematic payments is possible, manual capture based on fingerprint validation is recommended."}],"\n",["$","p","p-3",{"children":"During your manual capture workflow, after a payment was authorised:"}],"\n",["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":"Check the fingerprint status by comparing it against your maintained lists and internal business rules."}],"\n",["$","li","li-1",{"children":["If you decide to proceed with the payment (e.g., the fingerprint is not on a blocklist, or matches a trusted customer's previous payment method): ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#capture-order","target":"_blank","rel":"noreferrer","children":"Capture the order"}],"."]}],"\n",["$","li","li-2",{"children":["If you decide not to proceed with the payment (e.g., the fingerprint matches a known fraudulent fingerprint, or exhibits suspicious patterns): ","$L1ebc","."]}],"\n"]}]]}] 1cd6:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The Network Transaction ID (NTI) is a unique identifier assigned by the card scheme (e.g., Visa or Mastercard) to a card transaction."}],"\n",["$","p","p-1",{"children":"It can be used to trace the transaction across the payment network, link recurring or instalment payments to the original authorisation, and support dispute resolution."}]]}] 1cd7:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object containing details of a card used via Revolut Pay."}]]}] 1cd8:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"ID of the saved payment method."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["The ",["$","code","code-0",{"children":"id"}]," parameter is only returned when the payment method is saved."]}]}]]}]]}] 1cd9:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of payment method used to pay for the order."}],"\n",["$","p","p-1",{"children":"Available values:"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":["Payment method ",["$","code","code-0",{"children":"type"}]],"className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"apple_pay"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using Apple Pay.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"card"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using their credit or debit card.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"google_pay"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using Google Pay.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"revolut_pay_card"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order via Revolut Pay using their credit or debit card.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-4",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"revolut_pay_account"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order via Revolut Pay using their Revolut account.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-5",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"sepa_direct_debit"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using SEPA Direct Debit.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 1cdb:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A unique identifier for a payment method, always 44 characters long. This fingerprint can be used to uniquely identify various payment methods."}],"\n",["$","h1","h1-0",{"children":"Fingerprint generation"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Payment method","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","strong","strong-0",{"children":"All payment methods"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"A fingerprint is generated for all payment methods, including cards, Revolut Pay (card, account-to-account payments), Apple Pay, and Google Pay.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","strong","strong-0",{"children":"Cards (Revolut Pay & Card Gateway)"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"For cards, the fingerprint is based on the PAN. Cards processed via Revolut Pay and our card gateway will share the same fingerprint. Renewed cards (new expiry/CVV) retain the same fingerprint for efficient blocking.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","strong","strong-0",{"children":"Apple Pay & Google Pay"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Since Apple Pay and Google Pay provide us Device PANs (DPAN), the fingerprint is based on the DPAN provided by Apple/Google, not the connected card's PAN. This means that a new DPAN (and fingerprint) is generated for cards in case they are re-added to the customer's digital wallet, or added to different devices.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}],"\n",["$","h4","h4-0",{"children":"Detecting duplicate payment methods"}],"\n",["$","p","p-1",{"children":"Fingerprints are a valuable tool for detecting duplicate payment methods by identifying if a payment method has been seen before. This capability, in turn, helps in preventing various types of misuse (e.g., exploitation of free trials, or association with known problematic accounts, which can be a form of fraud). To effectively use fingerprints for this purpose, you will need to create and maintain your own lists (e.g., blocklists of known problematic fingerprints, allowlists for trusted customers, or tracking frequently used fingerprints)."}],"\n",["$","p","p-2",{"children":"The ideal way to utilise fingerprints is by combining them with a manual capture process. While automatic capture with subsequent refunds for problematic payments is possible, manual capture based on fingerprint validation is recommended."}],"\n",["$","p","p-3",{"children":"During your manual capture workflow, after a payment was authorised:"}],"\n",["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":"Check the fingerprint status by comparing it against your maintained lists and internal business rules."}],"\n",["$","li","li-1",{"children":["If you decide to proceed with the payment (e.g., the fingerprint is not on a blocklist, or matches a trusted customer's previous payment method): ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#capture-order","target":"_blank","rel":"noreferrer","children":"Capture the order"}],"."]}],"\n",["$","li","li-2",{"children":["If you decide not to proceed with the payment (e.g., the fingerprint matches a known fraudulent fingerprint, or exhibits suspicious patterns): ","$L1ebd","."]}],"\n"]}]]}] 1cdc:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"ID of the saved payment method."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["The ",["$","code","code-0",{"children":"id"}]," parameter is only returned when the payment method is saved for the merchant."]}]}]]}]]}] 1cdd:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of payment method used to pay for the order."}],"\n",["$","p","p-1",{"children":"Available values:"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":["Payment method ",["$","code","code-0",{"children":"type"}]],"className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"apple_pay"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using Apple Pay.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"card"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using their credit or debit card.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"google_pay"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using Google Pay.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"revolut_pay_card"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order via Revolut Pay using their credit or debit card.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-4",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"revolut_pay_account"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order via Revolut Pay using their Revolut account.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-5",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"sepa_direct_debit"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The customer paid the order using SEPA Direct Debit.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 1cde:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The last four digits of the debtor's IBAN."}]]}] 1cdf:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The full name of the debtor as provided in the mandate."}]]}] 1ce0:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The unique mandate reference generated by Revolut. Include this in pre-debit notifications sent to your customers."}]]}] 1ce1:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object containing details of a SEPA Direct Debit payment."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/accept-payments/payment-methods/sepa-direct-debit/server-to-server","target":"_blank","rel":"noreferrer","children":"SEPA Direct Debit server-to-server integration"}]]}]}]]}]]}] 1ce2:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The details of the payment method used to make the payment."}]]}] 1ce3:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Type of the authentication challenge the payment triggers."}]]}] 1ce4:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The URL of the authentication challenge."}]]}] 1ce5:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Information about the 3DS challenge."}]]}] 1ce6:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Type of the authentication challenge the payment triggers."}]]}] 1ce7:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The URL of the fingerprint. (Used only internally by Revolut.)"}]]}] 1ce8:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Data about the fingerprint used for authentication. (Used only internally\nby Revolut.)"}]]}] 1ce9:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Information about the 3DS fingerprint challenge."}]]}] 1cea:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["Details about the authentication challenge that should be performed to complete the authentication process. For more information about Revolut's 3DS solution, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/reference/3d-secure","target":"_blank","rel":"noreferrer","children":"3D Secure overview"}],"."]}],"\n",["$","p","p-1",{"children":["Only returned if the payment's state is ",["$","code","code-0",{"children":"authentication_challenge"}],"."]}]]}] 1ceb:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Street line 1 information."}]]}] 1cec:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Street line 2 information."}]]}] 1ced:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The region associated with the address."}]]}] 1cee:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The city associated with the address."}]]}] 1cef:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The 2-letter country code of the country associated with the address."}]]}] 1cf0:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The postcode associated with the address."}]]}] 1cf1:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object containing address details."}]]}] 1cf2:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The risk level of the card."}],"\n",["$","p","p-1",{"children":["If the risk level is ",["$","code","code-0",{"children":"high"}],", the payment might be declined."]}]]}] 1cf3:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of the order fee."}]]}] 1cf4:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The amount of the payment fee (minor currency unit). For example, enter ",["$","code","code-0",{"children":"7034"}]," for €70.34 in the field."]}]]}] 1cf5:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The currency of the payment fee. ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_4217","target":"_blank","rel":"noreferrer","children":"ISO 4217"}]," currency code in upper case."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information about the supported currencies, see: ",["$","a","a-0",{"href":"https://help.revolut.com/business/help/merchant-accounts/payments/in-which-currencies-can-i-accept-payments/","target":"_blank","rel":"noreferrer","children":"Help Center"}],"."]}]}]]}]]}] 1cf6:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The details of the order fee."}]]}] 1cf7:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The email of the person who made the payment."}]]}] 1cf8:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The phone number of the payer in ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/E.164","target":"_blank","rel":"noreferrer","children":"E.164 format"}],"."]}]]}] 1cf9:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The person who made the payment. This object is present when an email or phone number is provided during the payment flow."}],"\n",["$","p","p-1",{"children":"Capturing payer details lets you identify exactly who authorised the charge, reach the right person for receipts or refund queries, and support compliance or fraud-review workflows where the paying identity matters."}]]}] 1cfa:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Represents a payment for an order."}],"\n",["$","p","p-1",{"children":["For pre-authorised payments, the ",["$","code","code-0",{"children":"authorised_amount"}]," field tracks the currently authorised amount, which may differ from ",["$","code","code-1",{"children":"amount"}]," during incremental authorisation processing."]}]]}] 1cfb:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The details of all the payments that have been made towards this order (successful or unsuccessful)."}]]}] 1cfc:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The new total amount requested in this increment (in minor units)."}]]}] 1cfd:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The previously authorised amount before this increment (in minor units)."}]]}] 1cfe:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The state of this incremental authorization attempt."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"State","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"pending"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Increment registered in system, not yet submitted to card network","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"processing"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Increment is being processed by card network","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"authorised"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Increment was successfully authorised","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"declined"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Increment was declined by card issuer","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-4",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"failed"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Increment failed due to technical error (not an issuer decline)","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 1cff:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"External reference for this incremental authorisation."}],"\n",["$","div","inlinealert-0",{"data-type":"tip","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"Lightbulb","color":"var(--rui-color-success)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":"Use your internal charge or invoice ID. This reference is returned in webhooks for easy matching to your system."}]}]]}]]}] 1d00:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Name of the line item."}]]}] 1d01:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Type of the line item."}]]}] 1d02:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The number of units of the line item."}]]}] 1d03:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The measurement unit for the quantity, such as ",["$","code","code-0",{"children":"cm"}],", or ",["$","code","code-1",{"children":"kg"}],"."]}]]}] 1d04:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object representing the quantity details of a line item, including the amount and its associated unit of measurement."}]]}] 1d05:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The unit price of the line item."}]]}] 1d06:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The total amount to be paid for the line item, including taxes and discounts."}]]}] 1d07:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unique identifier of line item in the merchant's system."}]]}] 1d08:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The specific name or label of the discount applied to the line item."}]]}] 1d09:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The monetary value of the discount."}]]}] 1d0a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Details of a discount applied to the line item, including its name and monetary value."}]]}] 1d0b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A list of discounts applied to the line item. Each discount should be subtracted from the total amount payable for the item."}]]}] 1d0c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The specific name or designation of the tax applied to the line item."}]]}] 1d0d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The monetary value of the tax in minor currency units (e.g., cents for EUR)."}]]}] 1d0e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Details about a tax applied to the line item, including its name and the corresponding amount."}]]}] 1d0f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A list of taxes applied to the line item. Each tax should be added to the total amount payable for the item."}]]}] 1d10:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"URL to an image associated with the line item."}],"\n",["$","div","inlinealert-0",{"data-type":"warning","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMark","color":"var(--rui-color-warning)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"Restrictions:"}],["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["Must be a valid URI as defined by ",["$","a","a-0",{"href":"https://datatracker.ietf.org/doc/html/rfc3986","target":"_blank","rel":"noreferrer","children":"RFC 3986"}]]}],"\n",["$","li","li-1",{"children":["URI scheme is required and must be either ",["$","code","code-0",{"children":"http"}]," or ",["$","code","code-1",{"children":"https"}]]}],"\n",["$","li","li-2",{"children":["URI host is required and cannot be ",["$","code","code-0",{"children":"localhost"}]," or an IP address"]}],"\n",["$","li","li-3",{"children":["Max length: ",["$","code","code-0",{"children":"2000"}]]}],"\n",["$","li","li-4",{"children":["Reserved or invalid characters must be percent-encoded (for example, use ",["$","code","code-0",{"children":"%20"}]," instead of a space)"]}],"\n"]}]]}]]}]]}] 1d11:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A list of URLs pointing to images related to the line item. These images can provide visual details or representations of the item."}]]}] 1d12:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Description of the line item."}]]}] 1d13:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An HTTP/HTTPS URL that links to more information about the line item, such as a product page or details."}],"\n",["$","div","inlinealert-0",{"data-type":"warning","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMark","color":"var(--rui-color-warning)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"Restrictions:"}],["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["Must be a valid URI as defined by ",["$","a","a-0",{"href":"https://datatracker.ietf.org/doc/html/rfc3986","target":"_blank","rel":"noreferrer","children":"RFC 3986"}]]}],"\n",["$","li","li-1",{"children":["URI scheme is required and must be either ",["$","code","code-0",{"children":"http"}]," or ",["$","code","code-1",{"children":"https"}]]}],"\n",["$","li","li-2",{"children":["URI host is required and cannot be ",["$","code","code-0",{"children":"localhost"}]," or an IP address"]}],"\n",["$","li","li-3",{"children":["Max length: ",["$","code","code-0",{"children":"2000"}]]}],"\n",["$","li","li-4",{"children":["Reserved or invalid characters must be percent-encoded (for example, use ",["$","code","code-0",{"children":"%20"}]," instead of a space)"]}],"\n"]}]]}]]}]]}] 1d14:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Line items associated with this increment (if provided)."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":"If the increment is successful, these line items will override the existing order line items."}]}]]}]]}] 1d15:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Reason why increment was declined or failed."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["Only present when ",["$","code","code-0",{"children":"state"}]," is ",["$","code","code-1",{"children":"declined"}]," or ",["$","code","code-2",{"children":"failed"}],"."]}]}]]}]]}] 1d16:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Represents a single incremental authorisation attempt on an order."}],"\n",["$","p","p-1",{"children":["The ",["$","code","code-0",{"children":"incremental_authorisations"}]," array tracks all increment attempts (successful and failed) in chronological order."]}]]}] 1d17:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"History of incremental authorisation attempts for this order."}],"\n",["$","p","p-1",{"children":["Only present for orders with ",["$","code","code-0",{"children":"authorisation_type: pre_authorisation"}],"."]}],"\n",["$","p","p-2",{"children":"Contains all increment attempts in chronological order."}]]}] 1d18:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unique ID representing the location where merchants sells products."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#tag-locations","target":"_blank","rel":"noreferrer","children":"Locations"}],"."]}]}]]}]]}] 1d19:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Additional metadata value provided with the corresponding metadata key."}]]}] 1d1a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["Additional information to track your orders in your system, by providing custom metadata using ",["$","code","code-0",{"children":"\"\" : \"\""}]," pairs."]}],"\n",["$","div","inlinealert-0",{"data-type":"warning","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMark","color":"var(--rui-color-warning)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":["$","strong","strong-0",{"children":"Restrictions:"}]}],["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["Both keys and values must be ",["$","code","code-0",{"children":"string"}],"s"]}],"\n",["$","li","li-1",{"children":["Values cannot be ",["$","code","code-0",{"children":"null"}],"."]}],"\n",["$","li","li-2",{"children":["Max number of key-value pairs: ",["$","code","code-0",{"children":"50"}]]}],"\n",["$","li","li-3",{"children":["Max length of values: ",["$","code","code-0",{"children":"500"}]," characters"]}],"\n",["$","li","li-4",{"children":["Format of keys: Must start with a letter and contain only letters, digits, and underscores. Max 40 characters. Pattern: ",["$","code","code-0",{"children":"^[a-zA-Z][a-zA-Z\\\\d_]{0,39}$"}]]}],"\n"]}]]}]]}]]}] 1d1c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Type of the industry-specific data object, determining what additional data is expected."}],"\n",["$","p","p-1",{"children":"Available types:"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Object type","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"airline"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about a specific airline ticket purchase.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"car_rental"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about a car rental booking associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"crypto"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about crypto transactions associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"marketplace"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["This object is required by Mastercard and Visa for merchants operating as marketplaces under the ",["$","strong","strong-0",{"children":"Merchant Category Code (MCC):"}]," ",["$","code","code-0",{"children":"5262"}],". The marketplace object ensures compliance with the card schemes' regulations by providing detailed information about the subseller involved in the transaction."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-4",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"event"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about event ticket bookings associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-5",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"lodging"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about lodging bookings associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 1d1d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A unique identifier provided by the merchant associated with the order."}],"\n",["$","p","p-1",{"children":["This ",["$","code","code-0",{"children":"booking_id"}]," is used to reference and correlate booking information with the Merchant API and the merchant's internal system."]}]]}] 1d1e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The UTC date and time of the final journey leg."}],"\n",["$","div","inlinealert-0",{"data-type":"warning","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMark","color":"var(--rui-color-warning)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"The following limitations apply:"}],["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["When creating or updating an order, ",["$","code","code-0",{"children":"fulfillment_date"}]," cannot be set to a date in the past."]}],"\n",["$","li","li-1",{"children":["When updating an order, if the current ",["$","code","code-0",{"children":"fulfillment_date"}]," value is already in the past, it cannot be modified. The date must remain as is to maintain data integrity for completed transactions."]}],"\n"]}]]}]]}]]}] 1d1f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["Flag indicating whether the order includes actual ticket purchases. Set to ",["$","code","code-0",{"children":"true"}]," if the order contains ticket purchases, and ",["$","code","code-1",{"children":"false"}]," if it does not (e.g., it ",["$","strong","strong-0",{"children":"only"}]," contains seat reservations, or baggage upgrades)."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":["This field is required for activating ",["$","strong","strong-0",{"children":"Revolut Flight Alerts"}]," functionalities within the Revolut app."]}],["$","p","p-1",{"children":"Provide the info on order creation or update, before capturing the order."}]]}]]}]]}] 1d20:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of the ticket."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Parameter value","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"fixed"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Non-modifiable once confirmed.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"flexible"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Allows modifications or cancellations under specified conditions.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 1d21:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The code of the Computer Reservation System (CRS) used to make the booking and purchase the ticket."}]]}] 1d22:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Parameter indicating whether this order is related to a new ticket reservation or a modification of an existing one."}]]}] 1d23:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Parameter indicating whether the booking is refundable, partially refundable, or not refundable."}]]}] 1d24:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Passenger's first name."}]]}] 1d25:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Passenger's last name."}]]}] 1d26:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Array containing information of passengers associated with the booking."}]]}] 1d27:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Sequence of the journey legs. Increment by 1 for each flight included in the ticket."}],"\n",["$","p","p-1",{"children":["For example: For a ",["$","code","code-0",{"children":"FRA > LHR > DUB > LHR > FRA"}]," journey the sequence will be assigned as:"]}],"\n",["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":[["$","code","code-0",{"children":"FRA > LHR"}],": 1"]}],"\n",["$","li","li-1",{"children":[["$","code","code-0",{"children":"LHR > DUB"}],": 2"]}],"\n",["$","li","li-2",{"children":[["$","code","code-0",{"children":"DUB > LHR"}],": 3"]}],"\n",["$","li","li-3",{"children":[["$","code","code-0",{"children":"LHR > FRA"}],": 4"]}],"\n"]}]]}] 1d28:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://www.iata.org/en/services/codes","target":"_blank","rel":"noreferrer","children":"IATA"}]," 3-letter airport code for the departure airport."]}]]}] 1d29:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://www.iata.org/en/services/codes","target":"_blank","rel":"noreferrer","children":"IATA"}]," 3-letter airport code for the arrival airport."]}]]}] 1d2a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The flight identifier, without airline code."}]]}] 1d2b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The fare base code for the given journey leg."}]]}] 1d2c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The UTC date and time of the flight departure for the given journey leg."}]]}] 1d2d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The name of the airline associated with the journey leg."}]]}] 1d2e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The IATA 2-letter accounting code identifying the airline associated with the journey leg."}]]}] 1d2f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The Passenger Name Record (PNR) for the journey leg issued by the airline."}],"\n",["$","p","p-1",{"children":"PNR is a unique identifier for the booking, acting as a digital certificate allowing passengers to retrieve or manage their booking details."}],"\n",["$","div","inlinealert-0",{"data-type":"warning","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMark","color":"var(--rui-color-warning)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":"This is a required field for OTAs."}]}]]}]]}] 1d30:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Array containing information of journey legs associated with the booking."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":["This field is required for activating ",["$","strong","strong-0",{"children":"Revolut Flight Alerts"}]," functionalities within the Revolut app."]}],["$","p","p-1",{"children":"This information is used to compile a tracking widget that provides real-time updates on flight status and sends notifications, such as a check-in reminders, boarding alerts, and notifications for cancellations or delays."}],["$","p","p-2",{"children":"To enable the widget the following fields are required on order creation or update, before capturing the order:"}],"$L1ebe"]}]]}]]}] 1d31:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"URL to the online portal for managing the airline booking, which includes check-in functionality. This URL may be a personalised, pre-populated check-in link specific to the user or a generic link, and it is essential for enabling direct access to booking details within the Revolut app."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":["This field is required for activating ",["$","strong","strong-0",{"children":"Revolut Flight Alerts"}]," functionalities within the Revolut app."]}],["$","p","p-1",{"children":"Provide the info on order creation or update, before capturing the order."}]]}]]}],"\n",["$","div","inlinealert-1",{"data-type":"warning","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMark","color":"var(--rui-color-warning)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"Restrictions:"}],["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["Must be a valid URI as defined by ",["$","a","a-0",{"href":"https://datatracker.ietf.org/doc/html/rfc3986","target":"_blank","rel":"noreferrer","children":"RFC 3986"}]]}],"\n",["$","li","li-1",{"children":["URI scheme is required and must be either ",["$","code","code-0",{"children":"http"}]," or ",["$","code","code-1",{"children":"https"}]]}],"\n",["$","li","li-2",{"children":["URI host is required and cannot be ",["$","code","code-0",{"children":"localhost"}]," or an IP address"]}],"\n",["$","li","li-3",{"children":["Max length: ",["$","code","code-0",{"children":"2000"}]]}],"\n",["$","li","li-4",{"children":["Reserved or invalid characters must be percent-encoded (for example, use ",["$","code","code-0",{"children":"%20"}]," instead of a space)"]}],"\n"]}]]}]]}]]}] 1d32:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object containing additional information about an airline booking associated with the order."}],"\n",["$","p","p-1",{"children":["Use this object to provide required data to enable ",["$","strong","strong-0",{"children":"Revolut Flight Alerts"}],". This feature allows users to receive real-time flight updates such as check-in reminders, boarding alerts, and notifications for cancellations or delays in the Revolut app."]}],"\n",["$","p","p-2",{"children":["To enable ",["$","strong","strong-0",{"children":"Revolut Flight Alerts"}]," functionalities in the Revolut app, the following fields are ",["$","strong","strong-1",{"children":"required"}]," on order creation or update, before capturing the order:"]}],"\n","$L1ebf","\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"These are the specific data field requirements for merchants who must provide airline data. Note that these requirements can be extended on a case by case basis as decided by Revolut."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Required for airline/charter merchants","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Required for OTA merchants","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","ul","ul-0",{"children":[["$","li","li-0",{"children":["$","code","code-0",{"children":"booking_id"}]}],["$","li","li-1",{"children":["$","code","code-0",{"children":"fulfillment_date"}]}],["$","li","li-2",{"children":["$","code","code-0",{"children":"passengers[].first_name"}]}],["$","li","li-3",{"children":["$","code","code-0",{"children":"passengers[].last_name"}]}],["$","li","li-4",{"children":["$","code","code-0",{"children":"journey_legs[].pnr"}]}],["$","li","li-5",{"children":["$","code","code-0",{"children":"journey_legs[].sequence"}]}],["$","li","li-6",{"children":["$","code","code-0",{"children":"journey_legs[].flight_number"}]}],["$","li","li-7",{"children":["$","code","code-0",{"children":"journey_legs[].travel_date"}]}],["$","li","li-8",{"children":["$","code","code-0",{"children":"journey_legs[].airline_code"}]}],["$","li","li-9",{"children":["$","code","code-0",{"children":"journey_legs[].departure_airport_code"}]}],["$","li","li-10",{"children":["$","code","code-0",{"children":"journey_legs[].arrival_airport_code"}]}]]}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["$","ul","ul-0",{"children":[["$","li","li-0",{"children":["$","code","code-0",{"children":"booking_id"}]}],["$","li","li-1",{"children":["$","code","code-0",{"children":"fulfillment_date"}]}],["$","li","li-2",{"children":["$","code","code-0",{"children":"passengers[].first_name"}]}],["$","li","li-3",{"children":["$","code","code-0",{"children":"passengers[].last_name"}]}],["$","li","li-4",{"children":["$","code","code-0",{"children":"journey_legs[].pnr"}]}],["$","li","li-5",{"children":["$","code","code-0",{"children":"journey_legs[].arrival_airport_code"}]}]]}],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt3","ref":"$undefined"}]]}]}]]}]]}]]}] 1d33:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Type of the industry-specific data object, determining what additional data is expected."}],"\n",["$","p","p-1",{"children":"Available types:"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Object type","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"airline"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about a specific airline ticket purchase.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"car_rental"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about a car rental booking associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"crypto"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about crypto transactions associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"marketplace"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["This object is required by Mastercard and Visa for merchants operating as marketplaces under the ",["$","strong","strong-0",{"children":"Merchant Category Code (MCC):"}]," ",["$","code","code-0",{"children":"5262"}],". The marketplace object ensures compliance with the card schemes' regulations by providing detailed information about the subseller involved in the transaction."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-4",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"event"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about event ticket bookings associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-5",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"lodging"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about lodging bookings associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 1d34:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A unique identifier provided by the merchant associated with the order."}],"\n",["$","p","p-1",{"children":["This ",["$","code","code-0",{"children":"booking_id"}]," is used to reference and correlate booking information with the Merchant API and the merchant's internal system."]}]]}] 1d35:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The UTC date and time of the pick-up."}]]}] 1d36:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object containing address details."}]]}] 1d37:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The UTC date and time of the drop-off."}]]}] 1d38:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object containing address details."}]]}] 1d39:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Parameter indicating whether the booking is refundable, partially refundable, or not refundable."}]]}] 1d3a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The maximum distance allowed."}]]}] 1d3b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The unit of distance."}]]}] 1d3c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The amount of the cost in minor currency units. For example, enter ",["$","code","code-0",{"children":"7034"}]," for €70.34."]}]]}] 1d3d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":[["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_4217","target":"_blank","rel":"noreferrer","children":"ISO 4217"}]," currency code in upper case."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information about the supported currencies, see: ",["$","a","a-0",{"href":"https://help.revolut.com/business/help/merchant-accounts/payments/in-which-currencies-can-i-accept-payments/","target":"_blank","rel":"noreferrer","children":"Help Center"}],"."]}]}]]}]]}] 1d3e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Cost for exceeding the distance limit."}]]}] 1d3f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object containing distance limit information."}]]}] 1d40:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object containing additional information about a car rental booking associated with the order."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"These are the specific data field requirements for merchants offering car rental. Note that these requirements can be extended on a case by case basis as decided by Revolut."}],"$L1ec0"]}]]}]]}] 1d41:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Type of the industry-specific data object, determining what additional data is expected."}],"\n",["$","p","p-1",{"children":"Available types:"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Object type","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"airline"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about a specific airline ticket purchase.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"car_rental"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about a car rental booking associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"crypto"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about crypto transactions associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"marketplace"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["This object is required by Mastercard and Visa for merchants operating as marketplaces under the ",["$","strong","strong-0",{"children":"Merchant Category Code (MCC):"}]," ",["$","code","code-0",{"children":"5262"}],". The marketplace object ensures compliance with the card schemes' regulations by providing detailed information about the subseller involved in the transaction."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-4",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"event"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about event ticket bookings associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-5",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"lodging"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about lodging bookings associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 1d42:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The public transaction hash of the crypto transaction."}]]}] 1d43:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The status of the crypto transaction."}]]}] 1d44:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The wallet ID of the recipient."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["At least one of the parameters: ",["$","code","code-0",{"children":"recipient_user_id"}]," or ",["$","code","code-1",{"children":"recipient_wallet_id"}]," is required."]}]}]]}]]}] 1d45:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The user ID of the recipient."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["At least one of the parameters: ",["$","code","code-0",{"children":"recipient_user_id"}]," or ",["$","code","code-1",{"children":"recipient_wallet_id"}]," is required."]}]}]]}]]}] 1d46:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Array of crypto transaction data associated with the order."}]]}] 1d47:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["A string representing the four-digit ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/Merchant_category_code","target":"_blank","rel":"noreferrer","children":"Merchant Category Code (MCC)"}]," of the conversion affiliate."]}]]}] 1d48:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The ID of the seller in the merchant's internal system."}]]}] 1d49:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The business or legal name of the seller."}]]}] 1d4a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The URL of the website of the seller."}],"\n",["$","div","inlinealert-0",{"data-type":"warning","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMark","color":"var(--rui-color-warning)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"Restrictions:"}],["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["Must be a valid URI as defined by ",["$","a","a-0",{"href":"https://datatracker.ietf.org/doc/html/rfc3986","target":"_blank","rel":"noreferrer","children":"RFC 3986"}]]}],"\n",["$","li","li-1",{"children":["URI scheme is required and must be either ",["$","code","code-0",{"children":"http"}]," or ",["$","code","code-1",{"children":"https"}]]}],"\n",["$","li","li-2",{"children":["URI host is required and cannot be ",["$","code","code-0",{"children":"localhost"}]," or an IP address"]}],"\n",["$","li","li-3",{"children":["Max length: ",["$","code","code-0",{"children":"255"}]]}],"\n",["$","li","li-4",{"children":["Reserved or invalid characters must be percent-encoded (for example, use ",["$","code","code-0",{"children":"%20"}]," instead of a space)"]}],"\n"]}]]}]]}]]}] 1d4b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The phone number of the seller."}]]}] 1d4c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Primary address line."}]]}] 1d4d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Secondary address line, such as floor and apartment number."}]]}] 1d4e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"State or province of the address."}]]}] 1d4f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"City of the address."}]]}] 1d50:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"ISO 2-letter country code."}]]}] 1d51:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The subdivision code represents the state, province, or region within the country, following the ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_3166-2","target":"_blank","rel":"noreferrer","children":"ISO 3166-2"}]," standard. This code uniquely identifies subdivisions within a country."]}],"\n",["$","p","p-1",{"children":["For example, for London in the United Kingdom, use ",["$","code","code-0",{"children":"GB-LND"}],"."]}],"\n",["$","div","inlinealert-0",{"data-type":"warning","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMark","color":"var(--rui-color-warning)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["The parameter is required for countries listed on the ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_3166-2","target":"_blank","rel":"noreferrer","children":"ISO 3166-2"}]," page."]}]}]]}]]}] 1d52:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Postal code of the address."}]]}] 1d53:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Details of a physical address."}]]}] 1d54:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Information about the crypto conversion affiliate."}],"\n",["$","p","p-1",{"children":"This should be provided when a customer completes a payment on a subseller's website rather than directly on the merchant's website, providing insight into the type of business conducted by the subseller."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"This needs to be provided only by crypto on-ramp providers for payments they are processing for conversion affiliates."}],["$","p","p-1",{"children":["For their own payments, ",["$","code","code-0",{"children":"seller"}]," can be omitted."]}]]}]]}]]}] 1d55:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object containing information about crypto transactions associated with the order."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"Processing crypto on-ramp transactions with Revolut has additional compliance requirements. Please reach out to your account executive for additional details."}],["$","p","p-1",{"children":["$","strong","strong-0",{"children":"Required data fields for crypto services:"}]}],"$L1ec1",["$","p","p-2",{"children":"Note that these requirements can be extended on a case by case basis as decided by Revolut."}]]}]]}]]}] 1d56:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Type of the industry-specific data object, determining what additional data is expected."}],"\n",["$","p","p-1",{"children":"Available types:"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Object type","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"airline"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about a specific airline ticket purchase.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"car_rental"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about a car rental booking associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"crypto"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about crypto transactions associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"marketplace"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["This object is required by Mastercard and Visa for merchants operating as marketplaces under the ",["$","strong","strong-0",{"children":"Merchant Category Code (MCC):"}]," ",["$","code","code-0",{"children":"5262"}],". The marketplace object ensures compliance with the card schemes' regulations by providing detailed information about the subseller involved in the transaction."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-4",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"event"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about event ticket bookings associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-5",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"lodging"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about lodging bookings associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 1d57:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The ID of the seller in the merchant's internal system."}]]}] 1d58:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The business or legal name of the seller."}]]}] 1d59:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The URL of the website of the seller."}],"\n",["$","div","inlinealert-0",{"data-type":"warning","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMark","color":"var(--rui-color-warning)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"Restrictions:"}],["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["Must be a valid URI as defined by ",["$","a","a-0",{"href":"https://datatracker.ietf.org/doc/html/rfc3986","target":"_blank","rel":"noreferrer","children":"RFC 3986"}]]}],"\n",["$","li","li-1",{"children":["URI scheme is required and must be either ",["$","code","code-0",{"children":"http"}]," or ",["$","code","code-1",{"children":"https"}]]}],"\n",["$","li","li-2",{"children":["URI host is required and cannot be ",["$","code","code-0",{"children":"localhost"}]," or an IP address"]}],"\n",["$","li","li-3",{"children":["Max length: ",["$","code","code-0",{"children":"255"}]]}],"\n",["$","li","li-4",{"children":["Reserved or invalid characters must be percent-encoded (for example, use ",["$","code","code-0",{"children":"%20"}]," instead of a space)"]}],"\n"]}]]}]]}]]}] 1d5a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The phone number of the seller."}]]}] 1d5b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Details of a physical address."}]]}] 1d5c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Information about the subseller on the marketplace platform."}]]}] 1d5d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["This object is required by Mastercard and Visa for merchants operating as marketplaces under the Merchant Category Code (MCC) ",["$","code","code-0",{"children":"5262"}],". The marketplace object ensures compliance with the card schemes' regulations by providing detailed information about the seller involved in the transaction."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"These are the specific data field requirements for merchants who must provide marketplace data."}],"$L1ec2"]}]]}]]}] 1d5e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Type of the industry-specific data object, determining what additional data is expected."}],"\n",["$","p","p-1",{"children":"Available types:"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Object type","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"airline"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about a specific airline ticket purchase.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"car_rental"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about a car rental booking associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"crypto"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about crypto transactions associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"marketplace"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["This object is required by Mastercard and Visa for merchants operating as marketplaces under the ",["$","strong","strong-0",{"children":"Merchant Category Code (MCC):"}]," ",["$","code","code-0",{"children":"5262"}],". The marketplace object ensures compliance with the card schemes' regulations by providing detailed information about the subseller involved in the transaction."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-4",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"event"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about event ticket bookings associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-5",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"lodging"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about lodging bookings associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 1d5f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A unique identifier provided by the merchant associated with the order."}],"\n",["$","p","p-1",{"children":["This ",["$","code","code-0",{"children":"booking_id"}]," is used to reference and correlate booking information with the Merchant API and the merchant's internal system."]}]]}] 1d60:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":[["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_8601","target":"_blank","rel":"noreferrer","children":"ISO 8601"}]," date and time when the event starts."]}]]}] 1d61:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":[["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_8601","target":"_blank","rel":"noreferrer","children":"ISO 8601"}]," date and time when the event ends."]}]]}] 1d62:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Legal name of the ticket vendor/event organiser."}]]}] 1d63:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":[["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_8601","target":"_blank","rel":"noreferrer","children":"ISO 8601"}]," date and time when the funds are released to merchants."]}]]}] 1d64:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The name of the event."}]]}] 1d65:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Primary address line."}]]}] 1d66:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Secondary address line, such as floor and apartment number."}]]}] 1d67:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"State or province of the address."}]]}] 1d68:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"City of the address."}]]}] 1d69:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"ISO 2-letter country code."}]]}] 1d6a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Postal code of the address."}]]}] 1d6b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The address of the event location."}]]}] 1d6c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of the event."}]]}] 1d6d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Indicates the relationship between the ticket vendor and the event organiser."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Parameter value","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"primary"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The merchant is the organiser and primary distributor of the tickets.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"secondary"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The merchant is a reseller, only distributing the tickets.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 1d6e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A unique identifier provided by the merchant associated with the ticket."}]]}] 1d6f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Indicates whether the ticket is transferable to another buyer."}]]}] 1d70:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Parameter indicating whether the booking is refundable, partially refundable, or not refundable."}]]}] 1d71:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object containing information about a ticket associated with the booking."}]]}] 1d72:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A list of tickets associated with the booking."}]]}] 1d73:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object containing booking information about a specific event."}]]}] 1d74:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A list of events associated with the booking."}]]}] 1d75:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object containing booking information for a list of event tickets associated with the order."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"These are the specific data field requirements for merchants who must provide event data. Note that these requirements can be extended on a case by case basis as decided by Revolut."}],"$L1ec3"]}]]}]]}] 1d76:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Type of the industry-specific data object, determining what additional data is expected."}],"\n",["$","p","p-1",{"children":"Available types:"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Object type","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"airline"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about a specific airline ticket purchase.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"car_rental"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about a car rental booking associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"crypto"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about crypto transactions associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"marketplace"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["This object is required by Mastercard and Visa for merchants operating as marketplaces under the ",["$","strong","strong-0",{"children":"Merchant Category Code (MCC):"}]," ",["$","code","code-0",{"children":"5262"}],". The marketplace object ensures compliance with the card schemes' regulations by providing detailed information about the subseller involved in the transaction."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-4",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"event"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about event ticket bookings associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-5",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"lodging"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about lodging bookings associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 1d77:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A unique identifier provided by the merchant associated with the order."}],"\n",["$","p","p-1",{"children":["This ",["$","code","code-0",{"children":"booking_id"}]," is used to reference and correlate booking information with the Merchant API and the merchant's internal system."]}]]}] 1d78:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":[["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_8601","target":"_blank","rel":"noreferrer","children":"ISO 8601"}]," date and time of the check-in."]}]]}] 1d79:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":[["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_8601","target":"_blank","rel":"noreferrer","children":"ISO 8601"}]," date and time of the check-out."]}]]}] 1d7a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":[["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_8601","target":"_blank","rel":"noreferrer","children":"ISO 8601"}]," date and time when the funds are released to merchants."]}]]}] 1d7b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of the accommodation associated with the booking."}]]}] 1d7c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Indicates whether the booking terms are fixed or flexible."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Parameter value","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"fixed"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Non-modifiable once confirmed.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"flexible"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Allows modifications or cancellations under specified conditions.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 1d7d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Parameter indicating whether the booking is refundable, partially refundable, or not refundable."}]]}] 1d7e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Primary address line."}]]}] 1d7f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Secondary address line, such as floor and apartment number."}]]}] 1d80:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"State or province of the address."}]]}] 1d81:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"City of the address."}]]}] 1d82:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"ISO 2-letter country code."}]]}] 1d83:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Postal code of the address."}]]}] 1d84:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Address of the accommodation."}]]}] 1d85:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Guest's first name."}]]}] 1d86:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Guest's last name."}]]}] 1d87:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"List of guests associated with the booking."}]]}] 1d88:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object containing details of a lodging booking."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"These are the specific data field requirements for merchants who must provide lodging data. Note that these requirements can be extended on a case by case basis as decided by Revolut."}],"$L1ec4"]}]]}]]}] 1d89:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object containing industry-specific information associated with the order."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"In the following cases, industry-specific info is required. Omitting this information may trigger additional scrutiny and risk mitigation actions by the Revolut risk team."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Transaction type","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Required for","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"airline"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Airlines and Online Travel Agencies (OTAs).","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"car_rental"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Car Rental Merchants and Online Travel Agencies (OTAs).","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"crypto"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Crypto merchants.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"marketplace"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Marketplace merchants.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-4",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"event"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Event ticket sellers.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-5",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"lodging"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Lodging providers.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}]]}]]}] 1d8a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The URL of the order stored in the merchant's order management system."}],"\n",["$","p","p-1",{"children":["This URL will be included in the order confirmation email for payments made via Revolut Pay. If specified, this URL will override the default link to the merchant's ",["$","strong","strong-0",{"children":"Business website"}]," configured in the Revolut Business account."]}],"\n",["$","div","inlinealert-0",{"data-type":"warning","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMark","color":"var(--rui-color-warning)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"Restrictions:"}],["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["Must be a valid URI as defined by ",["$","a","a-0",{"href":"https://datatracker.ietf.org/doc/html/rfc3986","target":"_blank","rel":"noreferrer","children":"RFC 3986"}]]}],"\n",["$","li","li-1",{"children":["URI scheme is required and must be either ",["$","code","code-0",{"children":"http"}]," or ",["$","code","code-1",{"children":"https"}]]}],"\n",["$","li","li-2",{"children":["URI host is required and cannot be ",["$","code","code-0",{"children":"localhost"}]," or an IP address"]}],"\n",["$","li","li-3",{"children":["Max length: ",["$","code","code-0",{"children":"2000"}]]}],"\n",["$","li","li-4",{"children":["Reserved or invalid characters must be percent-encoded (for example, use ",["$","code","code-0",{"children":"%20"}]," instead of a space)"]}],"\n"]}]]}]]}]]}] 1d8b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Merchant order ID for external reference."}],"\n",["$","p","p-1",{"children":"Use this field to set the ID that your own system can use to easily track orders."}]]}] 1d8c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object for providing additional information stored in the merchant's order management system."}]]}] 1d8d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The date and time in ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_8601","target":"_blank","rel":"noreferrer","children":"ISO 8601 format"}]," when the upcoming payment is scheduled to be executed."]}]]}] 1d8e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The unique ID of the customer's payment method used to complete the scheduled payment."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"For more information about operations related to customer's payment methods, see:"}],["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#retrieve-payment-method-list","target":"_blank","rel":"noreferrer","children":"Retrieve payment method list of a customer"}]}],"\n",["$","li","li-1",{"children":["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#retrieve-payment-method","target":"_blank","rel":"noreferrer","children":"Retrieve a customer's payment method"}]}],"\n",["$","li","li-2",{"children":["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#update-payment-method","target":"_blank","rel":"noreferrer","children":"Update a customer's payment method"}]}],"\n",["$","li","li-3",{"children":["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#delete-payment-method","target":"_blank","rel":"noreferrer","children":"Delete a customer's payment method"}]}],"\n"]}]]}]]}]]}] 1d8f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object containing information about upcoming payments associated with the order."}]]}] 1d90:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Link to a checkout page hosted by Revolut."}]]}] 1d91:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The URL your customer will be redirected to after a successful payment on the hosted checkout page (",["$","code","code-0",{"children":"checkout_url"}]," parameter's value of the order)."]}],"\n",["$","div","inlinealert-0",{"data-type":"warning","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMark","color":"var(--rui-color-warning)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"Restrictions:"}],["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["Must be a valid URI as defined by ",["$","a","a-0",{"href":"https://datatracker.ietf.org/doc/html/rfc3986","target":"_blank","rel":"noreferrer","children":"RFC 3986"}]]}],"\n",["$","li","li-1",{"children":["URI scheme is required and must be either ",["$","code","code-0",{"children":"http"}]," or ",["$","code","code-1",{"children":"https"}]]}],"\n",["$","li","li-2",{"children":["URI host is required and cannot be ",["$","code","code-0",{"children":"localhost"}]," or an IP address"]}],"\n",["$","li","li-3",{"children":["Max length: ",["$","code","code-0",{"children":"2000"}]]}],"\n",["$","li","li-4",{"children":["Reserved or invalid characters must be percent-encoded (for example, use ",["$","code","code-0",{"children":"%20"}]," instead of a space)"]}],"\n"]}]]}]]}],"\n",["$","div","inlinealert-1",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information on how to use the ",["$","code","code-0",{"children":"redirect_url"}],", see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/accept-payments/online-payments/hosted-checkout-page/api#custom-post-payment-redirection-optional","target":"_blank","rel":"noreferrer","children":"Custom redirection via the API"}]]}]}]]}]]}] 1d92:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Primary address line."}]]}] 1d93:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Secondary address line, such as floor and apartment number."}]]}] 1d94:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"State or province of the address."}]]}] 1d95:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"City of the address."}]]}] 1d96:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"ISO 2-letter country code."}]]}] 1d97:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Postal code of the address."}]]}] 1d98:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Details of a physical address."}]]}] 1d99:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Full name of the contact person."}]]}] 1d9a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Email address of the contact person."}]]}] 1d9b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Phone number of the contact person."}]]}] 1d9c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Contact details for someone responsible for the shipment."}],"\n",["$","div","inlinealert-0",{"data-type":"warning","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMark","color":"var(--rui-color-warning)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["At least ",["$","code","code-0",{"children":"email"}]," or ",["$","code","code-1",{"children":"phone"}]," is required."]}]}]]}]]}] 1d9d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Name of the company handling the shipment."}]]}] 1d9e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unique tracking number for the shipment."}]]}] 1d9f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Estimated delivery date and time for the shipment.\nThe time should also include the customer's timezone."}]]}] 1da0:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An HTTP/HTTPS URL where the shipment can be tracked."}],"\n",["$","div","inlinealert-0",{"data-type":"warning","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMark","color":"var(--rui-color-warning)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"Restrictions:"}],["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["Must be a valid URI as defined by ",["$","a","a-0",{"href":"https://datatracker.ietf.org/doc/html/rfc3986","target":"_blank","rel":"noreferrer","children":"RFC 3986"}]]}],"\n",["$","li","li-1",{"children":["URI scheme is required and must be either ",["$","code","code-0",{"children":"http"}]," or ",["$","code","code-1",{"children":"https"}]]}],"\n",["$","li","li-2",{"children":["URI host is required and cannot be ",["$","code","code-0",{"children":"localhost"}]," or an IP address"]}],"\n",["$","li","li-3",{"children":["Max length: ",["$","code","code-0",{"children":"2000"}]]}],"\n",["$","li","li-4",{"children":["Reserved or invalid characters must be percent-encoded (for example, use ",["$","code","code-0",{"children":"%20"}]," instead of a space)"]}],"\n"]}]]}]]}]]}] 1da1:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Details of an individual shipment."}]]}] 1da2:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"List of individual shipment details."}]]}] 1da3:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Details about the shipping related to the order, including address, contact information, and individual shipments."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":"Required for merchants shipping physical goods. Omitting this information may trigger additional scrutiny and risk mitigation actions by Revolut."}]}]]}]]}] 1da4:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The enforce challenge mode. ",["$","code","code-0",{"children":"automatic"}]," is used by default."]}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Parameter value","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"automatic"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The payments created for an order will have challenge requirement calculated by our fraud mechanisms. Not all payments will trigger a 3DS challenge.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"forced"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The payments created for an order will always require a 3DS challenge. Currently only supported for card payments.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 1da5:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An array of line items included in the order. Each line item represents an individual product or service, along with its quantity, price, taxes, and discounts."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":"Required for merchants collecting payment for one or multiple products/services in one transaction. Omitting this information may trigger additional scrutiny and risk mitigation actions by Revolut."}]}]]}]]}] 1da7:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"You can set a dynamic statement descriptor for your orders by providing a custom suffix."}],"\n",["$","p","p-1",{"children":"A statement descriptor is the text shown on cardholders' bank or card statements, helping them recognise a transaction or merchant. This field can be used to send extra information with the statement descriptor for card transactions."}],"\n",["$","p","p-2",{"children":["The complete descriptor is built using the following format: ",["$","code","code-0",{"children":"{base}*{suffix}"}],", where:"]}],"\n",["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":[["$","strong","strong-0",{"children":["$","code","code-0",{"children":"{base}"}]}]," is the existing descriptor configured in the Revolut Business dashboard (",["$","strong","strong-1",{"children":"Settings > Business account > Merchant profile > Statement descriptor"}],")."]}],"\n",["$","li","li-1",{"children":[["$","strong","strong-0",{"children":["$","code","code-0",{"children":"{suffix}"}]}]," is defined by the ",["$","code","code-0",{"children":"statement_descriptor_suffix"}]," field."]}],"\n"]}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["If the combined descriptor's length (base + suffix) exceeds the character limits of card scheme providers, the final value will be truncated. For example if the limit is 22 characters, the base descriptor is ",["$","code","code-0",{"children":"\"base\""}]," and the suffix is ",["$","code","code-1",{"children":"\"testdescriptorsuffix\""}],", the final descriptor becomes ",["$","code","code-2",{"children":"\"base*testdescriptorsuf\""}],"."]}],"\n",["$","li","li-1",{"children":"The final statement descriptor shown on a cardholder's statement may vary by issuing bank, as some banks apply their own custom formatting or truncation rules."}],"\n"]}]}]]}]]}] 1da8:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The unique ID of the original order that was refunded and this refund is associated with. You can use this ID to get more information about the related order using the ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#retrieve-order","target":"_blank","rel":"noreferrer","children":"Retrieve an order"}]," operation."]}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["This field is only returned for orders with ",["$","code","code-0",{"children":"type: refund"}],"."]}]}]]}]]}] 1da9:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unique identifier for the subscription."}]]}] 1daa:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The unique identifier of the active (pre-paid) subscription cycle that this order collects payment for."}],"\n",["$","p","p-1",{"children":"This is the current billing cycle whose recurring charges are being collected in advance by this order. For example, if a subscription cycle covers 1-31 July and the order is generated on 1 July, this field identifies that July cycle."}]]}] 1dab:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The unique identifier of the settled (post-paid) subscription cycle whose usage-based charges this order collects."}],"\n",["$","p","p-1",{"children":"This is the previous billing cycle whose usage is being settled by this order. For example, if a subscription cycle covers usage from 1-30 June and the order is generated on 10 July, this field identifies that June cycle."}]]}] 1dac:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The reason this subscription order was created."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Value","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"cycle_billing"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["The order was automatically generated to collect payment for an ongoing subscription cycle. ",["$","code","code-0",{"children":"active_cycle_id"}]," is present; ",["$","code","code-1",{"children":"settled_cycle_id"}]," is present if the previous cycle included usage-based products."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"final_settlement"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["The order was automatically generated after the subscription ended to collect outstanding usage-based charges. ",["$","code","code-0",{"children":"active_cycle_id"}]," is absent; ",["$","code","code-1",{"children":"settled_cycle_id"}]," is present."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"setup_intent"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["The order was manually created by the merchant or customer to update the payment method on file. ",["$","code","code-0",{"children":"active_cycle_id"}]," is absent; ",["$","code","code-1",{"children":"settled_cycle_id"}]," is absent."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 1dad:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Subscription details linked to the order. Use this object to match an order with its underlying subscription and understand the billing context in which the order was created."}],"\n",["$","p","p-1",{"children":"Only present on orders created by a subscription."}]]}] 1dae:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["To process the order from a credit or debit card, you create an ",["$","code","code-0",{"children":"Order"}]," object. You can then retrieve, capture, cancel, refund, or pay an order using its unique ",["$","code","code-1",{"children":"id"}],". Alternatively, you can use its unique ",["$","code","code-2",{"children":"token"}]," to process a card payment with the Revolut Checkout Widget."]}]]}] 1daf:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Order created"}]]}] 1db0:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An identifier that can be used to determine what went wrong."}],"\n",["$","p","p-1",{"children":"Error codes are not globally unique, but uniqueness is guaranteed within endpoints."}]]}] 1db1:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Some human readable text describing what went wrong."}]]}] 1db2:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://www.unixtimestamp.com/","target":"_blank","rel":"noreferrer","children":"UNIX timestamp"}]," of the date and time the error happened."]}]]}] 1db3:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Bad Request"}]]}] 1db4:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An identifier that can be used to determine what went wrong."}],"\n",["$","p","p-1",{"children":"Error codes are not globally unique, but uniqueness is guaranteed within endpoints."}]]}] 1db5:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Some human readable text describing what went wrong."}]]}] 1db6:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://www.unixtimestamp.com/","target":"_blank","rel":"noreferrer","children":"UNIX timestamp"}]," of the date and time the error happened."]}]]}] 1db7:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unauthorized"}]]}] 1db8:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An identifier that can be used to determine what went wrong."}],"\n",["$","p","p-1",{"children":"Error codes are not globally unique, but uniqueness is guaranteed within endpoints."}]]}] 1db9:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Some human readable text describing what went wrong."}]]}] 1dba:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://www.unixtimestamp.com/","target":"_blank","rel":"noreferrer","children":"UNIX timestamp"}]," of the date and time the error happened."]}]]}] 1dbb:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Not Found"}]]}] 1dbc:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The order total expressed in minor currency units, according to the ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_4217","target":"_blank","rel":"noreferrer","children":"ISO 4217 standard"}],". For example, ",["$","code","code-0",{"children":"7034"}]," in ",["$","code","code-1",{"children":"EUR"}]," corresponds to €70.34."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["Conversion between major and minor units varies by currency. For instance, ",["$","code","code-0",{"children":"100"}]," minor units equal £1.00 in ",["$","code","code-1",{"children":"GBP"}],", whereas in ",["$","code","code-2",{"children":"ISK"}]," they represent 100 units. For more details, see the ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_4217","target":"_blank","rel":"noreferrer","children":"ISO 4217 standard"}],"."]}],"\n",["$","li","li-1",{"children":["If ",["$","code","code-0",{"children":"line_items"}]," are provided, the order ",["$","code","code-1",{"children":"amount"}]," must equal the sum of all line items' ",["$","code","code-2",{"children":"total_amount"}],"."]}],"\n",["$","li","li-2",{"children":["For card payments with a non-zero amount, the order ",["$","code","code-0",{"children":"amount"}]," must be at least ",["$","strong","strong-0",{"children":"$$0.005"}]," (or equivalent in different currencies, calculated using Revolut's exchange rate on the payment date). Otherwise, card payments can't be performed."]}],"\n"]}]}]]}]]}] 1dbd:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":[["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_4217","target":"_blank","rel":"noreferrer","children":"ISO 4217"}]," currency code in upper case."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information about the supported currencies, see: ",["$","a","a-0",{"href":"https://help.revolut.com/business/help/merchant-accounts/payments/in-which-currencies-can-i-accept-payments/","target":"_blank","rel":"noreferrer","children":"Help Center"}],"."]}]}]]}]]}] 1dbe:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":[["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_4217","target":"_blank","rel":"noreferrer","children":"ISO 4217"}]," currency code in upper case."]}],"\n",["$","p","p-1",{"children":["If ",["$","code","code-0",{"children":"settlement_currency"}]," is different from the value of ",["$","code","code-1",{"children":"currency"}],", the money will be exchanged when the amount is settled to your merchant account. In case of a refund or chargeback, the money will be exchanged to the order's initial ",["$","code","code-2",{"children":"currency"}],"."]}],"\n",["$","p","p-2",{"children":["If ",["$","code","code-0",{"children":"settlement_currency"}]," is not specified, this value is taken from ",["$","code","code-1",{"children":"currency"}],"."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information about the supported currencies, see: ",["$","a","a-0",{"href":"https://help.revolut.com/business/help/merchant-accounts/payments/in-which-currencies-can-i-accept-payments/","target":"_blank","rel":"noreferrer","children":"Help Center"}],"."]}]}]]}]]}] 1dbf:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The description of the order."}]]}] 1dc1:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Permanent ID of a customer used to retrieve, update, delete a customer. This ID can also be used to link customer to an order."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":"If you provide the customer's ID during order creation, no other customer data is required, they will be parsed automatically from the referenced customer object."}]}]]}]]}] 1dc2:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The full name of the customer."}]]}] 1dc3:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The phone number of the customer in ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/E.164","target":"_blank","rel":"noreferrer","children":"E.164 format"}],"."]}]]}] 1dc4:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The email address of the customer."}]]}] 1dc5:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The birth date of the customer."}]]}] 1dc6:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object containing information about a customer."}],"\n",["$","p","p-1",{"children":["If you have it, we strongly advise providing at least either ",["$","code","code-0",{"children":"id"}],", ",["$","code","code-1",{"children":"phone"}],", or ",["$","code","code-2",{"children":"email"}],"."]}],"\n",["$","p","p-2",{"children":["Using the ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#tag-customers","target":"_blank","rel":"noreferrer","children":"Customers operations"}],", you can manage customer instances."]}],"\n",["$","p","p-3",{"children":"The following behaviours apply to different use cases:"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Use case","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"API behavior","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":"Existing customer","className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["If ",["$","code","code-0",{"children":"id"}]," was provided, we ignore other customer details and associate the customer with the order.",["$","br","br-0",{}],["$","br","br-1",{}],"If either ",["$","code","code-1",{"children":"email"}],", ",["$","code","code-2",{"children":"phone"}],", or ",["$","code","code-3",{"children":"full_name"}]," was provided (without an existing customer's ",["$","code","code-4",{"children":"id"}],"), we always create a new customer, irrespective of another, existing customer object having the same details."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":"New customer","className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["If either ",["$","code","code-0",{"children":"email"}],", ",["$","code","code-1",{"children":"phone"}],", or ",["$","code","code-2",{"children":"full_name"}]," was provided, we create a new customer, irrespective of another customer object having the same details. ",["$","br","br-0",{}],["$","br","br-1",{}],"If ",["$","code","code-3",{"children":"id"}]," of a non-existent customer was provided, we return a ",["$","code","code-4",{"children":"404"}]," error, irrespective of other details provided."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["To avoid unintentional duplication of customer records, search for an existing customer by email or phone using the ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#retrieve-customer-list","target":"_blank","rel":"noreferrer","children":"List customers"}]," endpoint first, then provide ",["$","code","code-0",{"children":"customer.id"}]," in the order."]}]}]]}]]}] 1dc7:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The enforce challenge mode. ",["$","code","code-0",{"children":"automatic"}]," is used by default."]}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Parameter value","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"automatic"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The payments created for an order will have challenge requirement calculated by our fraud mechanisms. Not all payments will trigger a 3DS challenge.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"forced"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The payments created for an order will always require a 3DS challenge. Currently only supported for card payments.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 1dc8:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Name of the line item."}]]}] 1dc9:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Type of the line item."}]]}] 1dca:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The number of units of the line item."}]]}] 1dcb:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The measurement unit for the quantity, such as ",["$","code","code-0",{"children":"cm"}],", or ",["$","code","code-1",{"children":"kg"}],"."]}]]}] 1dcc:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object representing the quantity details of a line item, including the amount and its associated unit of measurement."}]]}] 1dcd:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The unit price of the line item."}]]}] 1dce:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The total amount to be paid for the line item, including taxes and discounts."}]]}] 1dcf:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unique identifier of line item in the merchant's system."}]]}] 1dd0:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The specific name or label of the discount applied to the line item."}]]}] 1dd1:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The monetary value of the discount."}]]}] 1dd2:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Details of a discount applied to the line item, including its name and monetary value."}]]}] 1dd3:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A list of discounts applied to the line item. Each discount should be subtracted from the total amount payable for the item."}]]}] 1dd4:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The specific name or designation of the tax applied to the line item."}]]}] 1dd5:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The monetary value of the tax in minor currency units (e.g., cents for EUR)."}]]}] 1dd6:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Details about a tax applied to the line item, including its name and the corresponding amount."}]]}] 1dd7:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A list of taxes applied to the line item. Each tax should be added to the total amount payable for the item."}]]}] 1dd8:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"URL to an image associated with the line item."}],"\n",["$","div","inlinealert-0",{"data-type":"warning","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMark","color":"var(--rui-color-warning)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"Restrictions:"}],["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["Must be a valid URI as defined by ",["$","a","a-0",{"href":"https://datatracker.ietf.org/doc/html/rfc3986","target":"_blank","rel":"noreferrer","children":"RFC 3986"}]]}],"\n",["$","li","li-1",{"children":["URI scheme is required and must be either ",["$","code","code-0",{"children":"http"}]," or ",["$","code","code-1",{"children":"https"}]]}],"\n",["$","li","li-2",{"children":["URI host is required and cannot be ",["$","code","code-0",{"children":"localhost"}]," or an IP address"]}],"\n",["$","li","li-3",{"children":["Max length: ",["$","code","code-0",{"children":"2000"}]]}],"\n",["$","li","li-4",{"children":["Reserved or invalid characters must be percent-encoded (for example, use ",["$","code","code-0",{"children":"%20"}]," instead of a space)"]}],"\n"]}]]}]]}]]}] 1dd9:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A list of URLs pointing to images related to the line item. These images can provide visual details or representations of the item."}]]}] 1dda:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Description of the line item."}]]}] 1ddb:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An HTTP/HTTPS URL that links to more information about the line item, such as a product page or details."}],"\n",["$","div","inlinealert-0",{"data-type":"warning","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMark","color":"var(--rui-color-warning)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"Restrictions:"}],["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["Must be a valid URI as defined by ",["$","a","a-0",{"href":"https://datatracker.ietf.org/doc/html/rfc3986","target":"_blank","rel":"noreferrer","children":"RFC 3986"}]]}],"\n",["$","li","li-1",{"children":["URI scheme is required and must be either ",["$","code","code-0",{"children":"http"}]," or ",["$","code","code-1",{"children":"https"}]]}],"\n",["$","li","li-2",{"children":["URI host is required and cannot be ",["$","code","code-0",{"children":"localhost"}]," or an IP address"]}],"\n",["$","li","li-3",{"children":["Max length: ",["$","code","code-0",{"children":"2000"}]]}],"\n",["$","li","li-4",{"children":["Reserved or invalid characters must be percent-encoded (for example, use ",["$","code","code-0",{"children":"%20"}]," instead of a space)"]}],"\n"]}]]}]]}]]}] 1ddc:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An array of line items included in the order. Each line item represents an individual product or service, along with its quantity, price, taxes, and discounts."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":"Required for merchants collecting payment for one or multiple products/services in one transaction. Omitting this information may trigger additional scrutiny and risk mitigation actions by Revolut."}]}]]}]]}] 1ddd:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Primary address line."}]]}] 1dde:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Secondary address line, such as floor and apartment number."}]]}] 1ddf:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"State or province of the address."}]]}] 1de0:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"City of the address."}]]}] 1de1:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"ISO 2-letter country code."}]]}] 1de2:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Postal code of the address."}]]}] 1de3:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Details of a physical address."}]]}] 1de4:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Full name of the contact person."}]]}] 1de5:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Email address of the contact person."}]]}] 1de6:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Phone number of the contact person."}]]}] 1de7:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Contact details for someone responsible for the shipment."}],"\n",["$","div","inlinealert-0",{"data-type":"warning","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMark","color":"var(--rui-color-warning)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["At least ",["$","code","code-0",{"children":"email"}]," or ",["$","code","code-1",{"children":"phone"}]," is required."]}]}]]}]]}] 1de8:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Name of the company handling the shipment."}]]}] 1de9:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unique tracking number for the shipment."}]]}] 1dea:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Estimated delivery date and time for the shipment.\nThe time should also include the customer's timezone."}]]}] 1deb:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"An HTTP/HTTPS URL where the shipment can be tracked."}],"\n",["$","div","inlinealert-0",{"data-type":"warning","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMark","color":"var(--rui-color-warning)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"Restrictions:"}],["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["Must be a valid URI as defined by ",["$","a","a-0",{"href":"https://datatracker.ietf.org/doc/html/rfc3986","target":"_blank","rel":"noreferrer","children":"RFC 3986"}]]}],"\n",["$","li","li-1",{"children":["URI scheme is required and must be either ",["$","code","code-0",{"children":"http"}]," or ",["$","code","code-1",{"children":"https"}]]}],"\n",["$","li","li-2",{"children":["URI host is required and cannot be ",["$","code","code-0",{"children":"localhost"}]," or an IP address"]}],"\n",["$","li","li-3",{"children":["Max length: ",["$","code","code-0",{"children":"2000"}]]}],"\n",["$","li","li-4",{"children":["Reserved or invalid characters must be percent-encoded (for example, use ",["$","code","code-0",{"children":"%20"}]," instead of a space)"]}],"\n"]}]]}]]}]]}] 1dec:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Details of an individual shipment."}]]}] 1ded:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"List of individual shipment details."}]]}] 1dee:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Details about the shipping related to the order, including address, contact information, and individual shipments."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":"Required for merchants shipping physical goods. Omitting this information may trigger additional scrutiny and risk mitigation actions by Revolut."}]}]]}]]}] 1def:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The capture mode of the order. ",["$","code","code-0",{"children":"automatic"}]," is used by default."]}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Parameter value","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"automatic"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The order is captured automatically after payment authorisation.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"manual"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The order is not captured automatically. You must manually capture the order later.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information, see ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#capture-order","target":"_blank","rel":"noreferrer","children":"Capture an order"}],"."]}]}]]}]]}] 1df0:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The type of authorisation for the order. Used with manual capture mode. If omitted, ",["$","code","code-0",{"children":"final"}]," is used by default."]}],"\n",["$","h1","h1-0",{"children":"Pre-authorisation"}],"\n",["$","p","p-1",{"children":"Pre-authorisation allows you to reserve funds on a customer's card without immediately capturing them. This is useful for scenarios like:"}],"\n",["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":"Hotel bookings where the final amount may vary"}],"\n",["$","li","li-1",{"children":"Car rentals where additional charges may apply"}],"\n",["$","li","li-2",{"children":"Deposits that need to be held temporarily"}],"\n"]}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Parameter value","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"final"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Standard authorisation for immediate or near-immediate capture.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"pre_authorisation"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Reserve funds for later capture, used with manual capture mode.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["Pre-authorisation must be used with ",["$","code","code-0",{"children":"capture_mode: manual"}],". For more information, see ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#capture-order","target":"_blank","rel":"noreferrer","children":"Capture an order"}],"."]}]}]]}]]}] 1df2:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["Automatic cancellation period for uncaptured orders, specified in ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_8601","target":"_blank","rel":"noreferrer","children":"ISO 8601"}]," format."]}],"\n",["$","p","p-1",{"children":["After this period, the authorised payment is automatically cancelled and the order is cancelled. Maximum: 7 days = ",["$","code","code-0",{"children":"P7D"}],"."]}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"The following limitations apply:"}],["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["\n",["$","p","p-0",{"children":"Cannot be a negative value."}],"\n"]}],"\n",["$","li","li-1",{"children":["\n",["$","p","p-0",{"children":"Cannot be updated if the new value is less than or equal to the elapsed time since authorisation."}],"\n",["$","p","p-1",{"children":["$","strong","strong-0",{"children":"Failing scenario:"}]}],"\n",["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":"Original value: 7 days"}],"\n",["$","li","li-1",{"children":"Time since authorisation: 3 days"}],"\n",["$","li","li-2",{"children":"Update value: 2 days"}],"\n"]}],"\n",["$","p","p-2",{"children":"In this scenario, an error is returned."}],"\n",["$","p","p-3",{"children":["$","strong","strong-0",{"children":"Successful scenario:"}]}],"\n",["$","ul","ul-1",{"children":["\n",["$","li","li-0",{"children":"Original value: 7 days"}],"\n",["$","li","li-1",{"children":"Time since authorisation: 3 days"}],"\n",["$","li","li-2",{"children":"Update value: 4 days"}],"\n"]}],"\n",["$","p","p-4",{"children":"In this scenario, the parameter can be updated."}],"\n"]}],"\n",["$","li","li-2",{"children":["\n",["$","p","p-0",{"children":"Cannot be updated if cancellation is ≤ 30 minutes away."}],"\n",["$","p","p-1",{"children":["$","strong","strong-0",{"children":"Failing scenario:"}]}],"\n",["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":"Original value: 12 hours"}],"\n",["$","li","li-1",{"children":"Time since authorisation: 11 hours 40 minutes"}],"\n"]}],"\n",["$","p","p-2",{"children":"In this scenario, an error is returned."}],"\n",["$","p","p-3",{"children":["$","strong","strong-0",{"children":"Successful scenario:"}]}],"\n",["$","ul","ul-1",{"children":["\n",["$","li","li-0",{"children":"Original value: 12 hours"}],"\n",["$","li","li-1",{"children":"Time since authorisation: 11 hours 20 minutes"}],"\n"]}],"\n",["$","p","p-4",{"children":"In this scenario, the parameter can be updated."}],"\n"]}],"\n"]}]]}]]}]]}] 1df3:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["Automatic expiration period for pending orders, specified in ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_8601","target":"_blank","rel":"noreferrer","children":"ISO 8601"}]," format."]}],"\n",["$","p","p-1",{"children":["Orders in ",["$","code","code-0",{"children":"pending"}]," state will be automatically failed if they stay unpaid for longer than the period specified."]}],"\n",["$","p","p-2",{"children":["When the order expires, it transitions to the ",["$","code","code-0",{"children":"failed"}]," state and an ",["$","code","code-1",{"children":"ORDER_FAILED"}]," webhook event is triggered."]}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":"This field can only be set during order creation and cannot be updated afterward."}],"\n",["$","li","li-1",{"children":["Must be between ",["$","code","code-0",{"children":"PT1M"}]," (1 minute) and ",["$","code","code-1",{"children":"PT720H"}]," (30 days)."]}],"\n",["$","li","li-2",{"children":"Cannot be a negative value."}],"\n"]}]}]]}]]}] 1df4:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Unique ID representing the location where merchants sells products."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#tag-locations","target":"_blank","rel":"noreferrer","children":"Locations"}],"."]}]}]]}]]}] 1df5:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Additional metadata value provided with the corresponding metadata key."}]]}] 1df6:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["Additional information to track your orders in your system, by providing custom metadata using ",["$","code","code-0",{"children":"\"\" : \"\""}]," pairs."]}],"\n",["$","div","inlinealert-0",{"data-type":"warning","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMark","color":"var(--rui-color-warning)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":["$","strong","strong-0",{"children":"Restrictions:"}]}],["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["Both keys and values must be ",["$","code","code-0",{"children":"string"}],"s"]}],"\n",["$","li","li-1",{"children":["Values cannot be ",["$","code","code-0",{"children":"null"}],"."]}],"\n",["$","li","li-2",{"children":["Max number of key-value pairs: ",["$","code","code-0",{"children":"50"}]]}],"\n",["$","li","li-3",{"children":["Max length of values: ",["$","code","code-0",{"children":"500"}]," characters"]}],"\n",["$","li","li-4",{"children":["Format of keys: Must start with a letter and contain only letters, digits, and underscores. Max 40 characters. Pattern: ",["$","code","code-0",{"children":"^[a-zA-Z][a-zA-Z\\\\d_]{0,39}$"}]]}],"\n"]}]]}]]}]]}] 1df8:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Type of the industry-specific data object, determining what additional data is expected."}],"\n",["$","p","p-1",{"children":"Available types:"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Object type","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"airline"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about a specific airline ticket purchase.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"car_rental"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about a car rental booking associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"crypto"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about crypto transactions associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"marketplace"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["This object is required by Mastercard and Visa for merchants operating as marketplaces under the ",["$","strong","strong-0",{"children":"Merchant Category Code (MCC):"}]," ",["$","code","code-0",{"children":"5262"}],". The marketplace object ensures compliance with the card schemes' regulations by providing detailed information about the subseller involved in the transaction."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-4",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"event"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about event ticket bookings associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-5",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"lodging"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about lodging bookings associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 1df9:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A unique identifier provided by the merchant associated with the order."}],"\n",["$","p","p-1",{"children":["This ",["$","code","code-0",{"children":"booking_id"}]," is used to reference and correlate booking information with the Merchant API and the merchant's internal system."]}]]}] 1dfa:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The UTC date and time of the final journey leg."}],"\n",["$","div","inlinealert-0",{"data-type":"warning","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMark","color":"var(--rui-color-warning)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"The following limitations apply:"}],["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["When creating or updating an order, ",["$","code","code-0",{"children":"fulfillment_date"}]," cannot be set to a date in the past."]}],"\n",["$","li","li-1",{"children":["When updating an order, if the current ",["$","code","code-0",{"children":"fulfillment_date"}]," value is already in the past, it cannot be modified. The date must remain as is to maintain data integrity for completed transactions."]}],"\n"]}]]}]]}]]}] 1dfb:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["Flag indicating whether the order includes actual ticket purchases. Set to ",["$","code","code-0",{"children":"true"}]," if the order contains ticket purchases, and ",["$","code","code-1",{"children":"false"}]," if it does not (e.g., it ",["$","strong","strong-0",{"children":"only"}]," contains seat reservations, or baggage upgrades)."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":["This field is required for activating ",["$","strong","strong-0",{"children":"Revolut Flight Alerts"}]," functionalities within the Revolut app."]}],["$","p","p-1",{"children":"Provide the info on order creation or update, before capturing the order."}]]}]]}]]}] 1dfc:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of the ticket."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Parameter value","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"fixed"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Non-modifiable once confirmed.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"flexible"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Allows modifications or cancellations under specified conditions.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 1dfd:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The code of the Computer Reservation System (CRS) used to make the booking and purchase the ticket."}]]}] 1dfe:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Parameter indicating whether this order is related to a new ticket reservation or a modification of an existing one."}]]}] 1dff:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Parameter indicating whether the booking is refundable, partially refundable, or not refundable."}]]}] 1e00:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Passenger's first name."}]]}] 1e01:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Passenger's last name."}]]}] 1e02:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Array containing information of passengers associated with the booking."}]]}] 1e03:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Sequence of the journey legs. Increment by 1 for each flight included in the ticket."}],"\n",["$","p","p-1",{"children":["For example: For a ",["$","code","code-0",{"children":"FRA > LHR > DUB > LHR > FRA"}]," journey the sequence will be assigned as:"]}],"\n",["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":[["$","code","code-0",{"children":"FRA > LHR"}],": 1"]}],"\n",["$","li","li-1",{"children":[["$","code","code-0",{"children":"LHR > DUB"}],": 2"]}],"\n",["$","li","li-2",{"children":[["$","code","code-0",{"children":"DUB > LHR"}],": 3"]}],"\n",["$","li","li-3",{"children":[["$","code","code-0",{"children":"LHR > FRA"}],": 4"]}],"\n"]}]]}] 1e04:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://www.iata.org/en/services/codes","target":"_blank","rel":"noreferrer","children":"IATA"}]," 3-letter airport code for the departure airport."]}]]}] 1e05:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The ",["$","a","a-0",{"href":"https://www.iata.org/en/services/codes","target":"_blank","rel":"noreferrer","children":"IATA"}]," 3-letter airport code for the arrival airport."]}]]}] 1e06:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The flight identifier, without airline code."}]]}] 1e07:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The fare base code for the given journey leg."}]]}] 1e08:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The UTC date and time of the flight departure for the given journey leg."}]]}] 1e09:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The name of the airline associated with the journey leg."}]]}] 1e0a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The IATA 2-letter accounting code identifying the airline associated with the journey leg."}]]}] 1e0b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The Passenger Name Record (PNR) for the journey leg issued by the airline."}],"\n",["$","p","p-1",{"children":"PNR is a unique identifier for the booking, acting as a digital certificate allowing passengers to retrieve or manage their booking details."}],"\n",["$","div","inlinealert-0",{"data-type":"warning","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMark","color":"var(--rui-color-warning)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":"This is a required field for OTAs."}]}]]}]]}] 1e0c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Array containing information of journey legs associated with the booking."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":["This field is required for activating ",["$","strong","strong-0",{"children":"Revolut Flight Alerts"}]," functionalities within the Revolut app."]}],["$","p","p-1",{"children":"This information is used to compile a tracking widget that provides real-time updates on flight status and sends notifications, such as a check-in reminders, boarding alerts, and notifications for cancellations or delays."}],["$","p","p-2",{"children":"To enable the widget the following fields are required on order creation or update, before capturing the order:"}],"$L1ec5"]}]]}]]}] 1e0d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"URL to the online portal for managing the airline booking, which includes check-in functionality. This URL may be a personalised, pre-populated check-in link specific to the user or a generic link, and it is essential for enabling direct access to booking details within the Revolut app."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":["This field is required for activating ",["$","strong","strong-0",{"children":"Revolut Flight Alerts"}]," functionalities within the Revolut app."]}],["$","p","p-1",{"children":"Provide the info on order creation or update, before capturing the order."}]]}]]}],"\n",["$","div","inlinealert-1",{"data-type":"warning","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMark","color":"var(--rui-color-warning)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"Restrictions:"}],["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["Must be a valid URI as defined by ",["$","a","a-0",{"href":"https://datatracker.ietf.org/doc/html/rfc3986","target":"_blank","rel":"noreferrer","children":"RFC 3986"}]]}],"\n",["$","li","li-1",{"children":["URI scheme is required and must be either ",["$","code","code-0",{"children":"http"}]," or ",["$","code","code-1",{"children":"https"}]]}],"\n",["$","li","li-2",{"children":["URI host is required and cannot be ",["$","code","code-0",{"children":"localhost"}]," or an IP address"]}],"\n",["$","li","li-3",{"children":["Max length: ",["$","code","code-0",{"children":"2000"}]]}],"\n",["$","li","li-4",{"children":["Reserved or invalid characters must be percent-encoded (for example, use ",["$","code","code-0",{"children":"%20"}]," instead of a space)"]}],"\n"]}]]}]]}]]}] 1e0e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object containing additional information about an airline booking associated with the order."}],"\n",["$","p","p-1",{"children":["Use this object to provide required data to enable ",["$","strong","strong-0",{"children":"Revolut Flight Alerts"}],". This feature allows users to receive real-time flight updates such as check-in reminders, boarding alerts, and notifications for cancellations or delays in the Revolut app."]}],"\n",["$","p","p-2",{"children":["To enable ",["$","strong","strong-0",{"children":"Revolut Flight Alerts"}]," functionalities in the Revolut app, the following fields are ",["$","strong","strong-1",{"children":"required"}]," on order creation or update, before capturing the order:"]}],"\n","$L1ec6","\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"These are the specific data field requirements for merchants who must provide airline data. Note that these requirements can be extended on a case by case basis as decided by Revolut."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Required for airline/charter merchants","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Required for OTA merchants","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","ul","ul-0",{"children":[["$","li","li-0",{"children":["$","code","code-0",{"children":"booking_id"}]}],["$","li","li-1",{"children":["$","code","code-0",{"children":"fulfillment_date"}]}],["$","li","li-2",{"children":["$","code","code-0",{"children":"passengers[].first_name"}]}],["$","li","li-3",{"children":["$","code","code-0",{"children":"passengers[].last_name"}]}],["$","li","li-4",{"children":["$","code","code-0",{"children":"journey_legs[].pnr"}]}],["$","li","li-5",{"children":["$","code","code-0",{"children":"journey_legs[].sequence"}]}],["$","li","li-6",{"children":["$","code","code-0",{"children":"journey_legs[].flight_number"}]}],["$","li","li-7",{"children":["$","code","code-0",{"children":"journey_legs[].travel_date"}]}],["$","li","li-8",{"children":["$","code","code-0",{"children":"journey_legs[].airline_code"}]}],["$","li","li-9",{"children":["$","code","code-0",{"children":"journey_legs[].departure_airport_code"}]}],["$","li","li-10",{"children":["$","code","code-0",{"children":"journey_legs[].arrival_airport_code"}]}]]}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["$","ul","ul-0",{"children":[["$","li","li-0",{"children":["$","code","code-0",{"children":"booking_id"}]}],["$","li","li-1",{"children":["$","code","code-0",{"children":"fulfillment_date"}]}],["$","li","li-2",{"children":["$","code","code-0",{"children":"passengers[].first_name"}]}],["$","li","li-3",{"children":["$","code","code-0",{"children":"passengers[].last_name"}]}],["$","li","li-4",{"children":["$","code","code-0",{"children":"journey_legs[].pnr"}]}],["$","li","li-5",{"children":["$","code","code-0",{"children":"journey_legs[].arrival_airport_code"}]}]]}],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt3","ref":"$undefined"}]]}]}]]}]]}]]}] 1e0f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Type of the industry-specific data object, determining what additional data is expected."}],"\n",["$","p","p-1",{"children":"Available types:"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Object type","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"airline"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about a specific airline ticket purchase.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"car_rental"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about a car rental booking associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"crypto"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about crypto transactions associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"marketplace"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["This object is required by Mastercard and Visa for merchants operating as marketplaces under the ",["$","strong","strong-0",{"children":"Merchant Category Code (MCC):"}]," ",["$","code","code-0",{"children":"5262"}],". The marketplace object ensures compliance with the card schemes' regulations by providing detailed information about the subseller involved in the transaction."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-4",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"event"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about event ticket bookings associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-5",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"lodging"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about lodging bookings associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 1e10:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A unique identifier provided by the merchant associated with the order."}],"\n",["$","p","p-1",{"children":["This ",["$","code","code-0",{"children":"booking_id"}]," is used to reference and correlate booking information with the Merchant API and the merchant's internal system."]}]]}] 1e11:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The UTC date and time of the pick-up."}]]}] 1e12:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Street line 1 information."}]]}] 1e13:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Street line 2 information."}]]}] 1e14:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The region associated with the address."}]]}] 1e15:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The city associated with the address."}]]}] 1e16:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The 2-letter country code of the country associated with the address."}]]}] 1e17:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The postcode associated with the address."}]]}] 1e18:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object containing address details."}]]}] 1e19:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The UTC date and time of the drop-off."}]]}] 1e1a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object containing address details."}]]}] 1e1b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Parameter indicating whether the booking is refundable, partially refundable, or not refundable."}]]}] 1e1c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The maximum distance allowed."}]]}] 1e1d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The unit of distance."}]]}] 1e1e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The amount of the cost in minor currency units. For example, enter ",["$","code","code-0",{"children":"7034"}]," for €70.34."]}]]}] 1e1f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":[["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_4217","target":"_blank","rel":"noreferrer","children":"ISO 4217"}]," currency code in upper case."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information about the supported currencies, see: ",["$","a","a-0",{"href":"https://help.revolut.com/business/help/merchant-accounts/payments/in-which-currencies-can-i-accept-payments/","target":"_blank","rel":"noreferrer","children":"Help Center"}],"."]}]}]]}]]}] 1e20:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Cost for exceeding the distance limit."}]]}] 1e21:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object containing distance limit information."}]]}] 1e22:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object containing additional information about a car rental booking associated with the order."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"These are the specific data field requirements for merchants offering car rental. Note that these requirements can be extended on a case by case basis as decided by Revolut."}],"$L1ec7"]}]]}]]}] 1e23:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Type of the industry-specific data object, determining what additional data is expected."}],"\n",["$","p","p-1",{"children":"Available types:"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Object type","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"airline"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about a specific airline ticket purchase.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"car_rental"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about a car rental booking associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"crypto"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about crypto transactions associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"marketplace"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["This object is required by Mastercard and Visa for merchants operating as marketplaces under the ",["$","strong","strong-0",{"children":"Merchant Category Code (MCC):"}]," ",["$","code","code-0",{"children":"5262"}],". The marketplace object ensures compliance with the card schemes' regulations by providing detailed information about the subseller involved in the transaction."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-4",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"event"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about event ticket bookings associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-5",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"lodging"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about lodging bookings associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 1e24:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The public transaction hash of the crypto transaction."}]]}] 1e25:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The status of the crypto transaction."}]]}] 1e26:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The wallet ID of the recipient."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["At least one of the parameters: ",["$","code","code-0",{"children":"recipient_user_id"}]," or ",["$","code","code-1",{"children":"recipient_wallet_id"}]," is required."]}]}]]}]]}] 1e27:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The user ID of the recipient."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["At least one of the parameters: ",["$","code","code-0",{"children":"recipient_user_id"}]," or ",["$","code","code-1",{"children":"recipient_wallet_id"}]," is required."]}]}]]}]]}] 1e28:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Array of crypto transaction data associated with the order."}]]}] 1e29:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["A string representing the four-digit ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/Merchant_category_code","target":"_blank","rel":"noreferrer","children":"Merchant Category Code (MCC)"}]," of the conversion affiliate."]}]]}] 1e2a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The ID of the seller in the merchant's internal system."}]]}] 1e2b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The business or legal name of the seller."}]]}] 1e2c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The URL of the website of the seller."}],"\n",["$","div","inlinealert-0",{"data-type":"warning","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMark","color":"var(--rui-color-warning)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"Restrictions:"}],["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["Must be a valid URI as defined by ",["$","a","a-0",{"href":"https://datatracker.ietf.org/doc/html/rfc3986","target":"_blank","rel":"noreferrer","children":"RFC 3986"}]]}],"\n",["$","li","li-1",{"children":["URI scheme is required and must be either ",["$","code","code-0",{"children":"http"}]," or ",["$","code","code-1",{"children":"https"}]]}],"\n",["$","li","li-2",{"children":["URI host is required and cannot be ",["$","code","code-0",{"children":"localhost"}]," or an IP address"]}],"\n",["$","li","li-3",{"children":["Max length: ",["$","code","code-0",{"children":"255"}]]}],"\n",["$","li","li-4",{"children":["Reserved or invalid characters must be percent-encoded (for example, use ",["$","code","code-0",{"children":"%20"}]," instead of a space)"]}],"\n"]}]]}]]}]]}] 1e2d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The phone number of the seller."}]]}] 1e2e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Primary address line."}]]}] 1e2f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Secondary address line, such as floor and apartment number."}]]}] 1e30:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"State or province of the address."}]]}] 1e31:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"City of the address."}]]}] 1e32:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"ISO 2-letter country code."}]]}] 1e33:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The subdivision code represents the state, province, or region within the country, following the ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_3166-2","target":"_blank","rel":"noreferrer","children":"ISO 3166-2"}]," standard. This code uniquely identifies subdivisions within a country."]}],"\n",["$","p","p-1",{"children":["For example, for London in the United Kingdom, use ",["$","code","code-0",{"children":"GB-LND"}],"."]}],"\n",["$","div","inlinealert-0",{"data-type":"warning","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMark","color":"var(--rui-color-warning)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["The parameter is required for countries listed on the ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_3166-2","target":"_blank","rel":"noreferrer","children":"ISO 3166-2"}]," page."]}]}]]}]]}] 1e34:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Postal code of the address."}]]}] 1e35:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Details of a physical address."}]]}] 1e36:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Information about the crypto conversion affiliate."}],"\n",["$","p","p-1",{"children":"This should be provided when a customer completes a payment on a subseller's website rather than directly on the merchant's website, providing insight into the type of business conducted by the subseller."}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"This needs to be provided only by crypto on-ramp providers for payments they are processing for conversion affiliates."}],["$","p","p-1",{"children":["For their own payments, ",["$","code","code-0",{"children":"seller"}]," can be omitted."]}]]}]]}]]}] 1e37:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object containing information about crypto transactions associated with the order."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"Processing crypto on-ramp transactions with Revolut has additional compliance requirements. Please reach out to your account executive for additional details."}],["$","p","p-1",{"children":["$","strong","strong-0",{"children":"Required data fields for crypto services:"}]}],"$L1ec8",["$","p","p-2",{"children":"Note that these requirements can be extended on a case by case basis as decided by Revolut."}]]}]]}]]}] 1e38:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Type of the industry-specific data object, determining what additional data is expected."}],"\n",["$","p","p-1",{"children":"Available types:"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Object type","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"airline"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about a specific airline ticket purchase.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"car_rental"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about a car rental booking associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"crypto"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about crypto transactions associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"marketplace"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["This object is required by Mastercard and Visa for merchants operating as marketplaces under the ",["$","strong","strong-0",{"children":"Merchant Category Code (MCC):"}]," ",["$","code","code-0",{"children":"5262"}],". The marketplace object ensures compliance with the card schemes' regulations by providing detailed information about the subseller involved in the transaction."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-4",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"event"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about event ticket bookings associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-5",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"lodging"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about lodging bookings associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 1e39:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The ID of the seller in the merchant's internal system."}]]}] 1e3a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The business or legal name of the seller."}]]}] 1e3b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The URL of the website of the seller."}],"\n",["$","div","inlinealert-0",{"data-type":"warning","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMark","color":"var(--rui-color-warning)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"Restrictions:"}],["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["Must be a valid URI as defined by ",["$","a","a-0",{"href":"https://datatracker.ietf.org/doc/html/rfc3986","target":"_blank","rel":"noreferrer","children":"RFC 3986"}]]}],"\n",["$","li","li-1",{"children":["URI scheme is required and must be either ",["$","code","code-0",{"children":"http"}]," or ",["$","code","code-1",{"children":"https"}]]}],"\n",["$","li","li-2",{"children":["URI host is required and cannot be ",["$","code","code-0",{"children":"localhost"}]," or an IP address"]}],"\n",["$","li","li-3",{"children":["Max length: ",["$","code","code-0",{"children":"255"}]]}],"\n",["$","li","li-4",{"children":["Reserved or invalid characters must be percent-encoded (for example, use ",["$","code","code-0",{"children":"%20"}]," instead of a space)"]}],"\n"]}]]}]]}]]}] 1e3c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The phone number of the seller."}]]}] 1e3d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Details of a physical address."}]]}] 1e3e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Information about the subseller on the marketplace platform."}]]}] 1e3f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["This object is required by Mastercard and Visa for merchants operating as marketplaces under the Merchant Category Code (MCC) ",["$","code","code-0",{"children":"5262"}],". The marketplace object ensures compliance with the card schemes' regulations by providing detailed information about the seller involved in the transaction."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"These are the specific data field requirements for merchants who must provide marketplace data."}],"$L1ec9"]}]]}]]}] 1e40:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Type of the industry-specific data object, determining what additional data is expected."}],"\n",["$","p","p-1",{"children":"Available types:"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Object type","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"airline"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about a specific airline ticket purchase.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"car_rental"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about a car rental booking associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"crypto"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about crypto transactions associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"marketplace"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["This object is required by Mastercard and Visa for merchants operating as marketplaces under the ",["$","strong","strong-0",{"children":"Merchant Category Code (MCC):"}]," ",["$","code","code-0",{"children":"5262"}],". The marketplace object ensures compliance with the card schemes' regulations by providing detailed information about the subseller involved in the transaction."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-4",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"event"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about event ticket bookings associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-5",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"lodging"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about lodging bookings associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 1e41:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A unique identifier provided by the merchant associated with the order."}],"\n",["$","p","p-1",{"children":["This ",["$","code","code-0",{"children":"booking_id"}]," is used to reference and correlate booking information with the Merchant API and the merchant's internal system."]}]]}] 1e42:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":[["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_8601","target":"_blank","rel":"noreferrer","children":"ISO 8601"}]," date and time when the event starts."]}]]}] 1e43:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":[["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_8601","target":"_blank","rel":"noreferrer","children":"ISO 8601"}]," date and time when the event ends."]}]]}] 1e44:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Legal name of the ticket vendor/event organiser."}]]}] 1e45:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":[["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_8601","target":"_blank","rel":"noreferrer","children":"ISO 8601"}]," date and time when the funds are released to merchants."]}]]}] 1e46:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The name of the event."}]]}] 1e47:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Primary address line."}]]}] 1e48:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Secondary address line, such as floor and apartment number."}]]}] 1e49:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"State or province of the address."}]]}] 1e4a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"City of the address."}]]}] 1e4b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"ISO 2-letter country code."}]]}] 1e4c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Postal code of the address."}]]}] 1e4d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The address of the event location."}]]}] 1e4e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of the event."}]]}] 1e4f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Indicates the relationship between the ticket vendor and the event organiser."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Parameter value","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"primary"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The merchant is the organiser and primary distributor of the tickets.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"secondary"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"The merchant is a reseller, only distributing the tickets.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 1e50:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A unique identifier provided by the merchant associated with the ticket."}]]}] 1e51:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Indicates whether the ticket is transferable to another buyer."}]]}] 1e52:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Parameter indicating whether the booking is refundable, partially refundable, or not refundable."}]]}] 1e53:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object containing information about a ticket associated with the booking."}]]}] 1e54:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A list of tickets associated with the booking."}]]}] 1e55:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object containing booking information about a specific event."}]]}] 1e56:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A list of events associated with the booking."}]]}] 1e57:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object containing booking information for a list of event tickets associated with the order."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"These are the specific data field requirements for merchants who must provide event data. Note that these requirements can be extended on a case by case basis as decided by Revolut."}],"$L1eca"]}]]}]]}] 1e58:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Type of the industry-specific data object, determining what additional data is expected."}],"\n",["$","p","p-1",{"children":"Available types:"}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Object type","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"airline"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about a specific airline ticket purchase.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"car_rental"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about a car rental booking associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"crypto"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about crypto transactions associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"marketplace"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":["This object is required by Mastercard and Visa for merchants operating as marketplaces under the ",["$","strong","strong-0",{"children":"Merchant Category Code (MCC):"}]," ",["$","code","code-0",{"children":"5262"}],". The marketplace object ensures compliance with the card schemes' regulations by providing detailed information about the subseller involved in the transaction."],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-4",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"event"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about event ticket bookings associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-5",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"lodging"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Object containing information about lodging bookings associated with the order.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 1e59:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"A unique identifier provided by the merchant associated with the order."}],"\n",["$","p","p-1",{"children":["This ",["$","code","code-0",{"children":"booking_id"}]," is used to reference and correlate booking information with the Merchant API and the merchant's internal system."]}]]}] 1e5a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":[["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_8601","target":"_blank","rel":"noreferrer","children":"ISO 8601"}]," date and time of the check-in."]}]]}] 1e5b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":[["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_8601","target":"_blank","rel":"noreferrer","children":"ISO 8601"}]," date and time of the check-out."]}]]}] 1e5c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":[["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_8601","target":"_blank","rel":"noreferrer","children":"ISO 8601"}]," date and time when the funds are released to merchants."]}]]}] 1e5d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The type of the accommodation associated with the booking."}]]}] 1e5e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Indicates whether the booking terms are fixed or flexible."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Parameter value","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Description","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"fixed"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Non-modifiable once confirmed.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"flexible"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Allows modifications or cancellations under specified conditions.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}] 1e5f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Parameter indicating whether the booking is refundable, partially refundable, or not refundable."}]]}] 1e60:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Primary address line."}]]}] 1e61:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Secondary address line, such as floor and apartment number."}]]}] 1e62:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"State or province of the address."}]]}] 1e63:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"City of the address."}]]}] 1e64:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"ISO 2-letter country code."}]]}] 1e65:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Postal code of the address."}]]}] 1e66:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Address of the accommodation."}]]}] 1e67:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Guest's first name."}]]}] 1e68:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Guest's last name."}]]}] 1e69:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"List of guests associated with the booking."}]]}] 1e6a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object containing details of a lodging booking."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"These are the specific data field requirements for merchants who must provide lodging data. Note that these requirements can be extended on a case by case basis as decided by Revolut."}],"$L1ecb"]}]]}]]}] 1e6b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object containing industry-specific information associated with the order."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"In the following cases, industry-specific info is required. Omitting this information may trigger additional scrutiny and risk mitigation actions by the Revolut risk team."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Transaction type","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Required for","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"airline"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Airlines and Online Travel Agencies (OTAs).","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"car_rental"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Car Rental Merchants and Online Travel Agencies (OTAs).","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"crypto"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Crypto merchants.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"marketplace"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Marketplace merchants.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-4",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"event"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Event ticket sellers.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-5",{"children":[["$","td","td-0",{"children":["$","code","code-0",{"children":"lodging"}],"className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":"Lodging providers.","className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}]]}]]}]]}] 1e6c:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The URL of the order stored in the merchant's order management system."}],"\n",["$","p","p-1",{"children":["This URL will be included in the order confirmation email for payments made via Revolut Pay. If specified, this URL will override the default link to the merchant's ",["$","strong","strong-0",{"children":"Business website"}]," configured in the Revolut Business account."]}],"\n",["$","div","inlinealert-0",{"data-type":"warning","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMark","color":"var(--rui-color-warning)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"Restrictions:"}],["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["Must be a valid URI as defined by ",["$","a","a-0",{"href":"https://datatracker.ietf.org/doc/html/rfc3986","target":"_blank","rel":"noreferrer","children":"RFC 3986"}]]}],"\n",["$","li","li-1",{"children":["URI scheme is required and must be either ",["$","code","code-0",{"children":"http"}]," or ",["$","code","code-1",{"children":"https"}]]}],"\n",["$","li","li-2",{"children":["URI host is required and cannot be ",["$","code","code-0",{"children":"localhost"}]," or an IP address"]}],"\n",["$","li","li-3",{"children":["Max length: ",["$","code","code-0",{"children":"2000"}]]}],"\n",["$","li","li-4",{"children":["Reserved or invalid characters must be percent-encoded (for example, use ",["$","code","code-0",{"children":"%20"}]," instead of a space)"]}],"\n"]}]]}]]}]]}] 1e6d:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Merchant order ID for external reference."}],"\n",["$","p","p-1",{"children":"Use this field to set the ID that your own system can use to easily track orders."}]]}] 1e6e:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object for providing additional information stored in the merchant's order management system."}]]}] 1e6f:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The date and time in ",["$","a","a-0",{"href":"https://en.wikipedia.org/wiki/ISO_8601","target":"_blank","rel":"noreferrer","children":"ISO 8601 format"}]," when the upcoming payment is scheduled to be executed."]}]]}] 1e70:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"The unique ID of the customer's payment method used to complete the scheduled payment."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"For more information about operations related to customer's payment methods, see:"}],["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#retrieve-payment-method-list","target":"_blank","rel":"noreferrer","children":"Retrieve payment method list of a customer"}]}],"\n",["$","li","li-1",{"children":["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#retrieve-payment-method","target":"_blank","rel":"noreferrer","children":"Retrieve a customer's payment method"}]}],"\n",["$","li","li-2",{"children":["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#update-payment-method","target":"_blank","rel":"noreferrer","children":"Update a customer's payment method"}]}],"\n",["$","li","li-3",{"children":["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#delete-payment-method","target":"_blank","rel":"noreferrer","children":"Delete a customer's payment method"}]}],"\n"]}]]}]]}]]}] 1e71:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object containing information about upcoming payments associated with the order."}]]}] 1e72:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The URL your customer will be redirected to after a successful payment on the hosted checkout page (",["$","code","code-0",{"children":"checkout_url"}]," parameter's value of the order)."]}],"\n",["$","div","inlinealert-0",{"data-type":"warning","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMark","color":"var(--rui-color-warning)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"Restrictions:"}],["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["Must be a valid URI as defined by ",["$","a","a-0",{"href":"https://datatracker.ietf.org/doc/html/rfc3986","target":"_blank","rel":"noreferrer","children":"RFC 3986"}]]}],"\n",["$","li","li-1",{"children":["URI scheme is required and must be either ",["$","code","code-0",{"children":"http"}]," or ",["$","code","code-1",{"children":"https"}]]}],"\n",["$","li","li-2",{"children":["URI host is required and cannot be ",["$","code","code-0",{"children":"localhost"}]," or an IP address"]}],"\n",["$","li","li-3",{"children":["Max length: ",["$","code","code-0",{"children":"2000"}]]}],"\n",["$","li","li-4",{"children":["Reserved or invalid characters must be percent-encoded (for example, use ",["$","code","code-0",{"children":"%20"}]," instead of a space)"]}],"\n"]}]]}]]}],"\n",["$","div","inlinealert-1",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information on how to use the ",["$","code","code-0",{"children":"redirect_url"}],", see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/accept-payments/online-payments/hosted-checkout-page/api#custom-post-payment-redirection-optional","target":"_blank","rel":"noreferrer","children":"Custom redirection via the API"}]]}]}]]}]]}] 1e74:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"You can set a dynamic statement descriptor for your orders by providing a custom suffix."}],"\n",["$","p","p-1",{"children":"A statement descriptor is the text shown on cardholders' bank or card statements, helping them recognise a transaction or merchant. This field can be used to send extra information with the statement descriptor for card transactions."}],"\n",["$","p","p-2",{"children":["The complete descriptor is built using the following format: ",["$","code","code-0",{"children":"{base}*{suffix}"}],", where:"]}],"\n",["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":[["$","strong","strong-0",{"children":["$","code","code-0",{"children":"{base}"}]}]," is the existing descriptor configured in the Revolut Business dashboard (",["$","strong","strong-1",{"children":"Settings > Business account > Merchant profile > Statement descriptor"}],")."]}],"\n",["$","li","li-1",{"children":[["$","strong","strong-0",{"children":["$","code","code-0",{"children":"{suffix}"}]}]," is defined by the ",["$","code","code-0",{"children":"statement_descriptor_suffix"}]," field."]}],"\n"]}],"\n",["$","div","inlinealert-0",{"data-type":"note","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"InfoOutline","color":"var(--rui-color-grey-tone-50)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["If the combined descriptor's length (base + suffix) exceeds the character limits of card scheme providers, the final value will be truncated. For example if the limit is 22 characters, the base descriptor is ",["$","code","code-0",{"children":"\"base\""}]," and the suffix is ",["$","code","code-1",{"children":"\"testdescriptorsuffix\""}],", the final descriptor becomes ",["$","code","code-2",{"children":"\"base*testdescriptorsuf\""}],"."]}],"\n",["$","li","li-1",{"children":"The final statement descriptor shown on a cardholder's statement may vary by issuing bank, as some banks apply their own custom formatting or truncation rules."}],"\n"]}]}]]}]]}] 1e75:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Object schema containing information about order creation body request parameters."}]]}] 1e79:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["Create an ",["$","code","code-0",{"children":"Order"}]," object."]}],"\n",["$","p","p-1",{"children":"Creating orders is one of the basic operations of the Merchant API. Most of the other operations are related to creating orders. Furthermore, the payment methods merchants can use to take payments for their orders are also built on order creation."}],"\n",["$","p","p-2",{"children":"To learn more about how you can accept payments, see:"}],"\n",["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/accept-payments/online-payments/revolut-pay/introduction","target":"_blank","rel":"noreferrer","children":"Revolut Pay"}]}],"\n",["$","li","li-1",{"children":["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/accept-payments/online-payments/card-payments/introduction","target":"_blank","rel":"noreferrer","children":"Card payments"}]}],"\n",["$","li","li-2",{"children":["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/accept-payments/online-payments/apple-pay-google-pay/introduction","target":"_blank","rel":"noreferrer","children":"Apple Pay and Google Pay"}]}],"\n",["$","li","li-3",{"children":["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/accept-payments/online-payments/pay-by-bank/introduction","target":"_blank","rel":"noreferrer","children":"Pay by Bank"}]}],"\n",["$","li","li-4",{"children":["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/accept-payments/online-payments/revolut-checkout/introduction","target":"_blank","rel":"noreferrer","children":"Revolut Checkout"}]}],"\n",["$","li","li-5",{"children":["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/accept-payments/online-payments/hosted-checkout-page/introduction","target":"_blank","rel":"noreferrer","children":"Hosted Checkout Page"}]}],"\n"]}],"\n",["$","h3","h3-0",{"children":"Pre-authorisation and incremental authorisation"}],"\n",["$","p","p-3",{"children":["Orders can be created with ",["$","code","code-0",{"children":"authorisation_type: pre_authorisation"}]," to enable incremental authorisation. This allows you to increase the authorised amount after the initial authorisation."]}],"\n",["$","p","p-4",{"children":["$","strong","strong-0",{"children":"Requirements:"}]}],"\n",["$","ul","ul-1",{"children":["\n",["$","li","li-0",{"children":[["$","code","code-0",{"children":"capture_mode"}]," must be set to ",["$","code","code-1",{"children":"manual"}]]}],"\n",["$","li","li-1",{"children":[["$","code","code-0",{"children":"authorisation_type"}]," must be set to ",["$","code","code-1",{"children":"pre_authorisation"}]]}],"\n",["$","li","li-2",{"children":"Only supported for card payments currently"}],"\n"]}],"\n",["$","p","p-5",{"children":["$","strong","strong-0",{"children":"Example use cases:"}]}],"\n",["$","ul","ul-2",{"children":["\n",["$","li","li-0",{"children":"Hotels: authorise deposit, then increment for room service and minibar"}],"\n",["$","li","li-1",{"children":"Car rentals: authorise deposit, then increment for damages or fuel"}],"\n"]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":[["$","p","p-0",{"children":"For more information, see:"}],["$","ul","ul-0",{"children":["\n",["$","li","li-0",{"children":["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/operations/capture-and-settlement/advanced-authorisation/pre-authorisation","target":"_blank","rel":"noreferrer","children":"Pre-authorisation guide"}]}],"\n",["$","li","li-1",{"children":["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/operations/capture-and-settlement/advanced-authorisation/incremental-authorisation","target":"_blank","rel":"noreferrer","children":"Incremental authorisation guide"}]}],"\n","$L1ecc","\n"]}]]}]]}],"\n","$L1ecd"]}] 1e7a:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["This parameter accepts the ",["$","a","a-0",{"href":"https://business.revolut.com/settings/apis?tab=merchant-api","target":"_blank","rel":"noreferrer","children":"Merchant API Secret key"}]," to authorise requests coming from the merchant's backend."]}],"\n",["$","p","p-1",{"children":["It ensures that ensures that each request is authenticated and authorised by verifying the secret key. The secret key should be included in all request headers as a ",["$","code","code-0",{"children":"Bearer"}]," token."]}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#authentication","target":"_blank","rel":"noreferrer","children":"Authentication"}]]}]}]]}]]}] 1e7b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":["The version of the Merchant API, specified in ",["$","code","code-0",{"children":"YYYY-MM-DD"}]," format."]}],"\n",["$","p","p-1",{"children":"If not specified, you will receive an error."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For more information about API versioning, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/reference/versioning/api-versions","target":"_blank","rel":"noreferrer","children":"API versions"}],"."]}]}]]}]]}] 1eb9:["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#cancel-order","target":"_blank","rel":"noreferrer","children":"Cancel the order"}] 1eba:["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#cancel-order","target":"_blank","rel":"noreferrer","children":"Cancel the order"}] 1ebb:["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#cancel-order","target":"_blank","rel":"noreferrer","children":"Cancel the order"}] 1ebc:["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#cancel-order","target":"_blank","rel":"noreferrer","children":"Cancel the order"}] 1ebd:["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant#cancel-order","target":"_blank","rel":"noreferrer","children":"Cancel the order"}] 1ecc:["$","li","li-2",{"children":["$","a","a-0",{"href":"https://developer.revolut.com/docs/api/merchant/2025-10-16#increment-authorisation","target":"_blank","rel":"noreferrer","children":"Increment authorisation endpoint"}]}] 1ecd:["$","$L5f9","Expandable-0",{"title":"Industry-specific requirements","children":["\n","\n",["$","p","p-0",{"children":"If you operate in any of the industries listed below, sharing industry-specific data is mandatory. Not providing the necessary information will result in further scrutiny from Revolut and/or the imposition of risk mitigation actions."}],"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",["$","div","table-0",{"className":"eowryt0","children":["$","table",null,{"className":"eowryt1","children":[["$","thead","thead-0",{"children":["$","tr","tr-0",{"children":[["$","th","th-0",{"children":"Industry","className":"eowryt6","ref":"$undefined"}],["$","th","th-1",{"children":"Related fields","className":"eowryt6","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],"className":"eowryt2","ref":"$undefined"}],["$","tbody","tbody-0",{"children":[["$","tr","tr-0",{"children":[["$","td","td-0",{"children":"Retail merchants","className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":[["$","code","code-0",{"children":"line_items"}],", ",["$","code","code-1",{"children":"shipping"}]],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-1",{"children":[["$","td","td-0",{"children":"Airlines","className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":[["$","code","code-0",{"children":"industry_data"}]," with ",["$","code","code-1",{"children":"type: airline"}]],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-2",{"children":[["$","td","td-0",{"children":"Car rentals","className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":[["$","code","code-0",{"children":"industry_data"}]," with ",["$","code","code-1",{"children":"type: car_rental"}]],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-3",{"children":[["$","td","td-0",{"children":"Hotels & accommodation","className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":[["$","code","code-0",{"children":"industry_data"}]," with ",["$","code","code-1",{"children":"type: lodging"}]],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-4",{"children":[["$","td","td-0",{"children":"Travel agencies (OTAs)","className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":[["$","code","code-0",{"children":"industry_data"}]," with ",["$","code","code-1",{"children":"type: airline"}]," or ",["$","code","code-2",{"children":"industry_data"}]," with ",["$","code","code-3",{"children":"type: lodging"}]],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-5",{"children":[["$","td","td-0",{"children":"Crypto merchants","className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":[["$","code","code-0",{"children":"industry_data"}]," with ",["$","code","code-1",{"children":"type: crypto"}],"; ",["$","code","code-2",{"children":"customer.full_name"}],", ",["$","code","code-3",{"children":"customer.date_of_birth"}]],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-6",{"children":[["$","td","td-0",{"children":"Financial institutions","className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":[["$","code","code-0",{"children":"customer.full_name"}],", ",["$","code","code-1",{"children":"customer.date_of_birth"}]],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-7",{"children":[["$","td","td-0",{"children":"Stored value / Wallets","className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":[["$","code","code-0",{"children":"customer.full_name"}],", ",["$","code","code-1",{"children":"customer.date_of_birth"}]],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-8",{"children":[["$","td","td-0",{"children":"Event ticket sellers","className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":[["$","code","code-0",{"children":"industry_data"}]," with ",["$","code","code-1",{"children":"type: event"}]],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}],["$","tr","tr-9",{"children":[["$","td","td-0",{"children":"Marketplace merchants","className":"eowryt7","ref":"$undefined"}],["$","td","td-1",{"children":[["$","code","code-0",{"children":"industry_data"}]," with ",["$","code","code-1",{"children":"type: marketplace"}]],"className":"eowryt7","ref":"$undefined"}]],"className":"eowryt5","ref":"$undefined"}]],"className":"eowryt3","ref":"$undefined"}]]}]}],"\n"]}] 1e8b:["$","article",null,{"className":"_8qmzte0","children":[["$","p","p-0",{"children":"Each Merchant API request must contain an authorization header in the following format:"}],"\n","$L1ece","\n",["$","p","p-1",{"children":"To use this API, you need to generate API keys from your Revolut Business account. The Secret key is used in the authorization header for all server calls, while the Public key is provided with payment methods at checkout."}],"\n",["$","div","inlinealert-0",{"data-type":"info","className":"_25vm6y0","children":[["$","div",null,{"className":"_25vm6y1","children":["$","$L73",null,{"name":"ExclamationMarkOutline","color":"var(--rui-color-accent)","inline":true}]}],null,["$","div",null,{"className":"_25vm6y3","children":["$","p","p-0",{"children":["For detailed instructions on generating your API keys, see: ",["$","a","a-0",{"href":"https://developer.revolut.com/docs/guides/merchant/get-started#generate-api-keys","target":"_blank","rel":"noreferrer","children":"Generate API keys"}],"."]}]}]]}]]}] 1ecf:Tb6f,
{
  "amount": 1000,
  "currency": "EUR",
  "settlement_currency": "GBP",
  "capture_mode": "manual",
  "cancel_authorised_after": "P3D",
  "metadata": {
    "example_key": "example_value"
  },
  "merchant_order_data": {
    "url": "https://example.com/orders/12345"
  },
  "statement_descriptor_suffix": "12345"
}
1c5f:["$","div","request-application/json-example_update_order",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$1ecf"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"amount\": 1000,\n \"currency\": \"EUR\",\n \"settlement_currency\": \"GBP\",\n \"capture_mode\": \"manual\",\n \"cancel_authorised_after\": \"P3D\",\n \"metadata\": {\n \"example_key\": \"example_value\"\n },\n \"merchant_order_data\": {\n \"url\": \"https://example.com/orders/12345\"\n },\n \"statement_descriptor_suffix\": \"12345\"\n}"}]}]]}] 1ed0:T15cb,
{
  "id": "651a941a-02ef-af6f-9b6c-458c652e2c6a",
  "token": "0aa685ee-8d86-441d-bedd-3f7fbf41731b",
  "type": "payment",
  "state": "pending",
  "created_at": "2023-10-02T09:57:46.498026Z",
  "updated_at": "2023-10-02T11:54:46.648414Z",
  "amount": 1000,
  "currency": "EUR",
  "outstanding_amount": 1000,
  "settlement_currency": "GBP",
  "capture_mode": "manual",
  "cancel_authorised_after": "P3D",
  "checkout_url": "https://checkout.revolut.com/payment-link/0aa685ee-8d86-441d-bedd-3f7fbf41731b",
  "metadata": {
    "example_key": "example_value"
  },
  "enforce_challenge": "automatic",
  "merchant_order_data": {
    "url": "https://example.com/orders/12345"
  },
  "statement_descriptor_suffix": "12345"
}
1c60:["$","div","200-application/json-example_order_updated",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$1ed0"}}]}]],"$L1ed1"]}] 1ed2:T46a,
{
  "code": "bad_request",
  "message": "Could not parse JSON",
  "timestamp": 1721049596461
}
1c61:["$","div","400-application/json-default",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$1ed2"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"code\": \"bad_request\",\n \"message\": \"Could not parse JSON\",\n \"timestamp\": 1721049596461\n}"}]}]]}] 1ed3:T46f,
{
  "code": "unauthenticated",
  "message": "Authentication failed",
  "timestamp": 1721049596461
}
1c62:["$","div","401-application/json-default",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$1ed3"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"code\": \"unauthenticated\",\n \"message\": \"Authentication failed\",\n \"timestamp\": 1721049596461\n}"}]}]]}] 1ed4:T494,
{
  "code": "not_found",
  "message": "Order with id abfa5bbd-a20c-4a0e-be66-30e733454518 was not found",
  "timestamp": 1721050063886
}
1c63:["$","div","404-application/json-default",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$1ed4"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"code\": \"not_found\",\n \"message\": \"Order with id abfa5bbd-a20c-4a0e-be66-30e733454518 was not found\",\n \"timestamp\": 1721050063886\n}"}]}]]}] 1ed5:T4b9,
{
  "code": "order_invalid_state",
  "message": "Operation cannot be performed because order is in completed state and expected is [pending]",
  "timestamp": 1721049952145
}
1c64:["$","div","422-application/json-default",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$1ed5"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"code\": \"order_invalid_state\",\n \"message\": \"Operation cannot be performed because order is in completed state and expected is [pending]\",\n \"timestamp\": 1721049952145\n}"}]}]]}] 1ed1:["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"id\": \"651a941a-02ef-af6f-9b6c-458c652e2c6a\",\n \"token\": \"0aa685ee-8d86-441d-bedd-3f7fbf41731b\",\n \"type\": \"payment\",\n \"state\": \"pending\",\n \"created_at\": \"2023-10-02T09:57:46.498026Z\",\n \"updated_at\": \"2023-10-02T11:54:46.648414Z\",\n \"amount\": 1000,\n \"currency\": \"EUR\",\n \"outstanding_amount\": 1000,\n \"settlement_currency\": \"GBP\",\n \"capture_mode\": \"manual\",\n \"cancel_authorised_after\": \"P3D\",\n \"checkout_url\": \"https://checkout.revolut.com/payment-link/0aa685ee-8d86-441d-bedd-3f7fbf41731b\",\n \"metadata\": {\n \"example_key\": \"example_value\"\n },\n \"enforce_challenge\": \"automatic\",\n \"merchant_order_data\": {\n \"url\": \"https://example.com/orders/12345\"\n },\n \"statement_descriptor_suffix\": \"12345\"\n}"}]}] 1e8c:["$","div","request-application/json-example_order_min_params",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"
{\n  \"amount\": 500,\n  \"currency\": \"GBP\"\n}
"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"amount\": 500,\n \"currency\": \"GBP\"\n}"}]}]]}] 1ed6:T17df,
{
  "amount": 500,
  "currency": "GBP",
  "capture_mode": "manual",
  "cancel_authorised_after": "PT30M",
  "expire_pending_after": "PT15M",
  "customer": {
    "email": "example@example.com",
    "date_of_birth": "1990-01-01"
  },
  "description": "Example product",
  "shipping": {
    "address": {
      "street_line_1": "7 Westferry Circus",
      "city": "London",
      "country_code": "GB",
      "postcode": "E14 4HD"
    }
  },
  "enforce_challenge": "forced",
  "metadata": {
    "product_type": "Example"
  },
  "merchant_order_data": {
    "url": "https://www.example.com/orders/12345"
  },
  "redirect_url": "https://www.example.com/redirect",
  "statement_descriptor_suffix": "12345"
}
1e8d:["$","div","request-application/json-example_order_additional",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$1ed6"}}]}]],"$L1ed7"]}] 1ed8:T7c0,
{
  "amount": 5000,
  "currency": "GBP",
  "capture_mode": "manual",
  "authorisation_type": "pre_authorisation",
  "description": "Hotel reservation deposit",
  "cancel_authorised_after": "PT72H"
}
1e8e:["$","div","request-application/json-example_order_pre_auth",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$1ed8"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"amount\": 5000,\n \"currency\": \"GBP\",\n \"capture_mode\": \"manual\",\n \"authorisation_type\": \"pre_authorisation\",\n \"description\": \"Hotel reservation deposit\",\n \"cancel_authorised_after\": \"PT72H\"\n}"}]}]]}] 1ed9:T2d9f,
{
  "amount": 770,
  "currency": "GBP",
  "line_items": [
    {
      "name": "Example item 1",
      "type": "physical",
      "quantity": {
        "value": 2,
        "unit": "kg"
      },
      "unit_price_amount": 100,
      "total_amount": 170,
      "external_id": "external_id_123",
      "discounts": [
        {
          "name": "Discount 1",
          "amount": 50
        }
      ],
      "taxes": [
        {
          "name": "10% VAT",
          "amount": 20
        }
      ],
      "image_urls": [
        "https://www.example.com/line-item-image1",
        "https://www.example.com/line-item-image2"
      ],
      "description": "First line item",
      "url": "https://www.example.com"
    },
    {
      "name": "Example item 2",
      "type": "service",
      "quantity": {
        "value": 10,
        "unit": "pieces"
      },
      "unit_price_amount": 100,
      "total_amount": 600,
      "external_id": "external_id_456",
      "discounts": [
        {
          "name": "Discount 2",
          "amount": 500
        }
      ],
      "taxes": [
        {
          "name": "10% VAT",
          "amount": 100
        }
      ],
      "image_urls": [
        "https://www.example.com/line-item-image3",
        "https://www.example.com/line-item-image4"
      ],
      "description": "Second line item",
      "url": "https://www.example.com"
    }
  ]
}
1e8f:["$","div","request-application/json-example_order_line_items",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$1ed9"}}]}]],"$L1eda"]}] 1edb:T1617,
{
  "amount": 500,
  "currency": "GBP",
  "shipping": {
    "address": {
      "street_line_1": "Example Street 123",
      "street_line_2": "II/123",
      "region": "London",
      "city": "London",
      "country_code": "GB",
      "postcode": "123456"
    },
    "contact": {
      "name": "Example Contact",
      "email": "example.contact@example.com",
      "phone": "+441234567890"
    },
    "shipments": [
      {
        "shipping_company_name": "Example Shipping Co.",
        "tracking_number": "123456789",
        "estimated_delivery_date": "2024-12-03T10:15:30+02:00[Europe/Paris]",
        "tracking_url": "https://www.example.com/tracking/123456789"
      }
    ]
  }
}
1e90:["$","div","request-application/json-example_order_shipping",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$1edb"}}]}]],"$L1edc"]}] 1edd:T47de,
{
  "amount": 500,
  "currency": "GBP",
  "settlement_currency": "EUR",
  "description": "Example order description",
  "customer": {
    "full_name": "Example Customer",
    "phone": "+441234567890",
    "email": "example@example.com"
  },
  "enforce_challenge": "forced",
  "capture_mode": "manual",
  "cancel_authorised_after": "PT30M",
  "industry_data": {
    "type": "airline",
    "booking_id": "unique-booking-id-12345",
    "fulfillment_date": "2023-07-10T14:00:00.069624Z",
    "ticket_type": "flexible",
    "crs_code": "DATS",
    "ticket_change_indicator": "new",
    "refundability": "refundable",
    "passengers": [
      {
        "first_name": "Example",
        "last_name": "Customer"
      },
      {
        "first_name": "John",
        "last_name": "Doe"
      }
    ],
    "journey_legs": [
      {
        "sequence": 1,
        "departure_airport_code": "FRA",
        "arrival_airport_code": "LHR",
        "flight_number": "670",
        "fare_base_code": "J",
        "travel_date": "2023-07-10T10:00:00.069624Z",
        "airline_name": "AerLingus",
        "airline_code": "EI"
      },
      {
        "sequence": 2,
        "departure_airport_code": "LHR",
        "arrival_airport_code": "DUB",
        "flight_number": "678",
        "fare_base_code": "J",
        "travel_date": "2023-07-10T15:00:00.069624Z",
        "airline_name": "AerLingus",
        "airline_code": "EI"
      },
      {
        "sequence": 3,
        "departure_airport_code": "DUB",
        "arrival_airport_code": "LHR",
        "flight_number": "679",
        "fare_base_code": "F",
        "travel_date": "2023-07-15T10:00:00.069624Z",
        "airline_name": "AerLingus",
        "airline_code": "EI"
      },
      {
        "sequence": 4,
        "departure_airport_code": "LHR",
        "arrival_airport_code": "FRA",
        "flight_number": "671",
        "fare_base_code": "F",
        "travel_date": "2023-07-10T14:00:00.069624Z",
        "airline_name": "AerLingus",
        "airline_code": "EI"
      }
    ],
    "booking_url": "https://example.com/bookings/1234"
  },
  "merchant_order_data": {
    "url": "https://www.example.com/ticketnumber-12345",
    "reference": "example_airline_reference"
  },
  "redirect_url": "https://www.example.com/redirect"
}
1e91:["$","div","request-application/json-example_order_airline",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$1edd"}}]}]],"$L1ede"]}] 1edf:T2833,
{
  "amount": 500,
  "currency": "GBP",
  "settlement_currency": "GBP",
  "description": "Example car rental order",
  "customer": {
    "full_name": "Example Customer",
    "phone": "+447700900000",
    "email": "example@example.com"
  },
  "enforce_challenge": "forced",
  "capture_mode": "manual",
  "cancel_authorised_after": "PT30M",
  "industry_data": {
    "type": "car_rental",
    "booking_id": "example_booking_id",
    "pick_up_date": "2026-03-01T11:00:00Z",
    "drop_off_date": "2026-03-05T16:30:00Z",
    "refundability": "partially_refundable",
    "pick_up_location": {
      "street_line_1": "1 Example Street",
      "city": "London",
      "country_code": "GB",
      "postcode": "SW1A 1AA"
    },
    "drop_off_location": {
      "street_line_1": "10 Another Road",
      "city": "Manchester",
      "country_code": "GB",
      "postcode": "M1 1AA"
    },
    "distance_limit": {
      "limit": 500,
      "unit": "miles",
      "additional_distance_cost": {
        "amount": 150,
        "currency": "GBP"
      }
    }
  },
  "merchant_order_data": {
    "url": "https://www.example.com/rental/example_booking_id",
    "reference": "example_car_rental_reference"
  },
  "redirect_url": "https://www.example.com/redirect"
}
1e92:["$","div","request-application/json-example_order_car_rental",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$1edf"}}]}]],"$L1ee0"]}] 1ee1:T20ac,
{
  "amount": 26100,
  "currency": "EUR",
  "settlement_currency": "EUR",
  "description": "Customer wants to buy 0.01 BTC",
  "customer": {
    "id": "db186257-3031-4726-98ea-f2260ea115f0"
  },
  "capture_mode": "manual",
  "cancel_authorised_after": "PT30M",
  "industry_data": {
    "type": "crypto",
    "transactions": [
      {
        "id": "7b2a8ed4-5889-4c0c-a8cc-299aff1c881b",
        "status": "pending",
        "recipient_wallet_id": "64a6f159-0a60-a446-880e-e449a1f62f7c"
      }
    ],
    "seller": {
      "id": "a13638ab-3e90-4b05-9f69-23abc655775b",
      "name": "Ramp Provider Company Name",
      "website": "https://example.com",
      "phone": "123456789",
      "mcc": "6051",
      "address": {
        "street_line_1": "456 Crypto Ave",
        "city": "New York",
        "postcode": "10001",
        "country_code": "US"
      }
    }
  },
  "merchant_order_data": {
    "url": "https://www.example.com/cryptotransactionnumber-12345",
    "reference": "example_crypto_reference"
  },
  "redirect_url": "https://www.example.com/redirect"
}
1e93:["$","div","request-application/json-example_order_crypto",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$1ee1"}}]}]],"$L1ee2"]}] 1ee3:T137f,
{
  "amount": 10000,
  "currency": "EUR",
  "industry_data": {
    "type": "marketplace",
    "seller": {
      "id": "123-45-67",
      "name": "Example Seller",
      "website": "https://example.com/123-45-67",
      "phone": "+441234567890",
      "address": {
        "street_line_1": "1 Canada Square",
        "street_line_2": "Revolut LTD, Level 39",
        "postcode": "E14 4HD",
        "country_code": "GB",
        "country_subdivision_code": "GB-LND",
        "city": "London",
        "region": "Greater London"
      }
    }
  }
}
1e94:["$","div","request-application/json-example_order_marketplace",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$1ee3"}}]}]],"$L1ee4"]}] 1ee5:T2218,
{
  "amount": 100,
  "currency": "GBP",
  "industry_data": {
    "type": "event",
    "booking_id": "example_booking_123",
    "events": [
      {
        "start_date": "2025-03-04T14:00:00Z",
        "end_date": "2025-03-04T17:00:00Z",
        "supplier": "Example Supplier",
        "supplier_payment_date": "2025-03-03T14:00:15Z",
        "name": "Example Event",
        "location": {
          "street_line_1": "Example Street 123",
          "street_line_2": "II/123",
          "region": "London",
          "city": "London",
          "country_code": "GB",
          "postcode": "123456"
        },
        "category": "exhibition",
        "market": "primary",
        "tickets": [
          {
            "id": "example_ticket_1",
            "transferable": false,
            "refundability": "partially_refundable"
          },
          {
            "id": "example_ticket_2",
            "transferable": true,
            "refundability": "non_refundable"
          },
          {
            "id": "example_ticket_3"
          }
        ]
      }
    ]
  }
}
1e95:["$","div","request-application/json-example_order_event",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$1ee5"}}]}]],"$L1ee6"]}] 1ee7:T1b16,
{
  "amount": 100,
  "currency": "GBP",
  "industry_data": {
    "type": "lodging",
    "booking_id": "example_booking_123",
    "check_in_date": "2025-05-01T15:00:00Z",
    "check_out_date": "2025-05-05T11:00:00Z",
    "supplier_payment_date": "2025-05-05T11:00:00Z",
    "category": "bed_and_breakfast",
    "booking_type": "flexible",
    "refundability": "partially_refundable",
    "location": {
      "street_line_1": "Example Street 123",
      "street_line_2": "II/123",
      "region": "London",
      "city": "London",
      "country_code": "GB",
      "postcode": "123456"
    },
    "guests": [
      {
        "first_name": "First",
        "last_name": "Guest"
      },
      {
        "first_name": "Second",
        "last_name": "Guest"
      }
    ]
  }
}
1e96:["$","div","request-application/json-example_order_lodging",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$1ee7"}}]}]],"$L1ee8"]}] 1ee9:Tfc9,
{
  "id": "6516e61c-d279-a454-a837-bc52ce55ed49",
  "token": "0adc0e3c-ab44-4f33-bcc0-534ded7354ce",
  "type": "payment",
  "state": "pending",
  "created_at": "2023-09-29T14:58:36.079398Z",
  "updated_at": "2023-09-29T14:58:36.079398Z",
  "amount": 500,
  "currency": "GBP",
  "outstanding_amount": 500,
  "capture_mode": "automatic",
  "authorisation_type": "final",
  "checkout_url": "https://checkout.revolut.com/payment-link/0adc0e3c-ab44-4f33-bcc0-534ded7354ce",
  "enforce_challenge": "automatic"
}
1e97:["$","div","201-application/json-example_order_min_params",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$1ee9"}}]}]],"$L1eea"]}] 1eeb:T2242,
{
  "id": "6516e6ec-c7f7-a0fb-a6d3-add05fa46d2f",
  "token": "1058031d-1e71-4d07-9f97-5ad388a1346c",
  "type": "payment",
  "state": "pending",
  "created_at": "2023-09-29T15:02:04.083787Z",
  "updated_at": "2023-09-29T15:02:04.083787Z",
  "amount": 500,
  "currency": "GBP",
  "outstanding_amount": 500,
  "capture_mode": "manual",
  "authorisation_type": "final",
  "cancel_authorised_after": "PT30M",
  "description": "Example product",
  "checkout_url": "https://checkout.revolut.com/payment-link/1058031d-1e71-4d07-9f97-5ad388a1346c",
  "redirect_url": "https://www.example.com/redirect",
  "shipping": {
    "address": {
      "street_line_1": "7 Westferry Circus",
      "city": "London",
      "country_code": "GB",
      "postcode": "E14 4HD"
    }
  },
  "metadata": {
    "product_type": "Example"
  },
  "enforce_challenge": "forced",
  "customer": {
    "id": "467646d6-e452-4d1e-a401-703f09cd3818",
    "email": "example@example.com",
    "date_of_birth": "1990-01-01"
  },
  "merchant_order_data": {
    "url": "https://example.com/orders/12345"
  },
  "statement_descriptor_suffix": "12345"
}
1e98:["$","div","201-application/json-example_order_additional",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$1eeb"}}]}]],"$L1eec"]}] 1eed:T31d6,
{
  "id": "6516e61c-d279-a454-a837-bc52ce55ed49",
  "token": "0adc0e3c-ab44-4f33-bcc0-534ded7354ce",
  "type": "payment",
  "state": "authorised",
  "created_at": "2023-09-29T14:58:36.079398Z",
  "updated_at": "2023-09-29T14:58:36.079398Z",
  "amount": 5000,
  "currency": "GBP",
  "outstanding_amount": 5000,
  "capture_mode": "manual",
  "authorisation_type": "pre_authorisation",
  "cancel_authorised_after": "PT72H",
  "description": "Hotel reservation deposit",
  "checkout_url": "https://checkout.revolut.com/payment-link/0adc0e3c-ab44-4f33-bcc0-534ded7354ce",
  "enforce_challenge": "automatic",
  "payments": [
    {
      "id": "6516f38a-a12b-aca3-83f2-6ed16d6ed246",
      "state": "authorised",
      "created_at": "2023-09-29T14:55:54.579311Z",
      "updated_at": "2023-09-29T14:56:38.403232Z",
      "amount": 5000,
      "currency": "GBP",
      "settled_amount": 5000,
      "settled_currency": "GBP",
      "billing_address": {
        "country_code": "GB",
        "postcode": "SW1A 1AA"
      },
      "risk_level": "low",
      "fees": [],
      "payer": {
        "email": "example.payer@example.com",
        "phone": "+447911123456"
      },
      "payment_method": {
        "type": "card",
        "card_brand": "visa",
        "funding": "credit",
        "card_country_code": "GB",
        "card_bin": "411111",
        "card_last_four": "1111",
        "card_expiry": "12/25",
        "cardholder_name": "Example Holder",
        "capture_deadline": "2023-10-06T14:55:54.579311Z",
        "fingerprint": "1JAllfQY4POhBV8DaddAQ4LC5RbMP8LMLvUdJW4s5JY=",
        "network_transaction_id": "1234567890123456"
      }
    }
  ]
}
1e99:["$","div","201-application/json-example_order_pre_auth",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$1eed"}}]}]],"$L1eee"]}] 1eef:T3a2e,
{
  "id": "66bcc998-4209-ac6e-96fe-2910b949c516",
  "token": "0bcfcc1d-9ee9-4476-b36c-cf4abba2e45a",
  "type": "payment",
  "state": "pending",
  "created_at": "2024-08-14T15:13:28.814729Z",
  "updated_at": "2024-08-14T15:13:28.814729Z",
  "amount": 770,
  "currency": "GBP",
  "outstanding_amount": 770,
  "capture_mode": "automatic",
  "authorisation_type": "final",
  "checkout_url": "https://checkout.revolut.com/payment-link/0bcfcc1d-9ee9-4476-b36c-cf4abba2e45a",
  "enforce_challenge": "automatic",
  "line_items": [
    {
      "name": "Example item 1",
      "unit_price_amount": 100,
      "quantity": {
        "value": 2,
        "unit": "kg"
      },
      "type": "physical",
      "discounts": [
        {
          "name": "Discount 1",
          "amount": 50
        }
      ],
      "taxes": [
        {
          "name": "10% VAT",
          "amount": 20
        }
      ],
      "total_amount": 170,
      "image_urls": [
        "https://www.example.com/line-item-image1",
        "https://www.example.com/line-item-image2"
      ],
      "description": "First line item",
      "external_id": "external_id_123",
      "url": "https://www.example.com"
    },
    {
      "name": "Example item 2",
      "unit_price_amount": 100,
      "quantity": {
        "value": 10,
        "unit": "pieces"
      },
      "type": "service",
      "discounts": [
        {
          "name": "Discount 2",
          "amount": 500
        }
      ],
      "taxes": [
        {
          "name": "10% VAT",
          "amount": 100
        }
      ],
      "total_amount": 600,
      "image_urls": [
        "https://www.example.com/line_item_image3",
        "https://www.example.com/line_item_image4"
      ],
      "description": "Second line item",
      "external_id": "external_id_456",
      "url": "https://www.example.com"
    }
  ]
}
1e9a:["$","div","201-application/json-example_order_line_items",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$1eef"}}]}]],"$L1ef0"]}] 1ef1:T226e,
{
  "id": "66c5e449-36d3-af78-a832-328150ddc6a3",
  "token": "b1145e3e-30c7-4dd6-b84c-680dccd39dde",
  "type": "payment",
  "state": "pending",
  "created_at": "2024-08-21T12:57:45.793605Z",
  "updated_at": "2024-08-21T12:57:45.793605Z",
  "amount": 770,
  "currency": "GBP",
  "outstanding_amount": 770,
  "capture_mode": "automatic",
  "authorisation_type": "final",
  "checkout_url": "https://checkout.revolut.com/payment-link/b1145e3e-30c7-4dd6-b84c-680dccd39dde",
  "shipping": {
    "address": {
      "street_line_1": "Example Street 123",
      "street_line_2": "II/123",
      "region": "London",
      "city": "London",
      "country_code": "GB",
      "postcode": "123456"
    },
    "contact": {
      "name": "Example Contact",
      "email": "example.contact@example.com",
      "phone": "+441234567890"
    },
    "shipments": [
      {
        "shipping_company_name": "Example Shipping Co.",
        "tracking_number": "123456789",
        "estimated_delivery_date": "2024-12-03T10:15:30+02:00[Europe/Paris]",
        "tracking_url": "https://www.example.com/tracking/123456789"
      }
    ]
  },
  "enforce_challenge": "automatic"
}
1e9b:["$","div","201-application/json-example_order_shipping",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$1ef1"}}]}]],"$L1ef2"]}] 1ef3:T539a,
{
  "id": "6516ed0c-098f-aa19-80e5-9d92f52b35e0",
  "token": "061f2c63-e36b-421e-9ece-5adfcd580886",
  "type": "payment",
  "state": "pending",
  "created_at": "2023-09-29T15:28:12.114992Z",
  "updated_at": "2023-09-29T15:28:12.114992Z",
  "amount": 500,
  "currency": "GBP",
  "outstanding_amount": 500,
  "settlement_currency": "EUR",
  "capture_mode": "manual",
  "authorisation_type": "final",
  "description": "Example order description",
  "checkout_url": "https://checkout.revolut.com/payment-link/061f2c63-e36b-421e-9ece-5adfcd580886",
  "redirect_url": "https://www.example.com/redirect",
  "cancel_authorised_after": "PT30M",
  "industry_data": {
    "type": "airline",
    "booking_id": "unique-booking-id-12345",
    "fulfillment_date": "2023-07-10T14:00:00.069624Z",
    "ticket_type": "flexible",
    "crs_code": "DATS",
    "ticket_change_indicator": "new",
    "refundability": "refundable",
    "passengers": [
      {
        "first_name": "Example",
        "last_name": "Customer"
      },
      {
        "first_name": "John",
        "last_name": "Doe"
      }
    ],
    "journey_legs": [
      {
        "sequence": 1,
        "departure_airport_code": "FRA",
        "arrival_airport_code": "LHR",
        "flight_number": "670",
        "fare_base_code": "J",
        "travel_date": "2023-07-10T10:00:00.069624Z",
        "airline_name": "AerLingus",
        "airline_code": "EI"
      },
      {
        "sequence": 2,
        "departure_airport_code": "LHR",
        "arrival_airport_code": "DUB",
        "flight_number": "678",
        "fare_base_code": "J",
        "travel_date": "2023-07-10T15:00:00.069624Z",
        "airline_name": "AerLingus",
        "airline_code": "EI"
      },
      {
        "sequence": 3,
        "departure_airport_code": "DUB",
        "arrival_airport_code": "LHR",
        "flight_number": "679",
        "fare_base_code": "F",
        "travel_date": "2023-07-15T10:00:00.069624Z",
        "airline_name": "AerLingus",
        "airline_code": "EI"
      },
      {
        "sequence": 4,
        "departure_airport_code": "LHR",
        "arrival_airport_code": "FRA",
        "flight_number": "671",
        "fare_base_code": "F",
        "travel_date": "2023-07-10T14:00:00.069624Z",
        "airline_name": "AerLingus",
        "airline_code": "EI"
      }
    ],
    "booking_url": "https://example.com/bookings/1234"
  },
  "enforce_challenge": "forced",
  "customer": {
    "id": "db186257-3031-4726-98ea-f2260ea115f0",
    "email": "example@example.com",
    "phone": "+441234567890",
    "full_name": "Example Customer"
  },
  "merchant_order_data": {
    "url": "https://www.example.com/ticketnumber-12345",
    "reference": "example_airline_reference"
  }
}
1e9c:["$","div","201-application/json-example_order_airline",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$1ef3"}}]}]],"$L1ef4"]}] 1ef5:T33ef,
{
  "id": "6516ed0c-098f-aa19-80e5-9d92f52b35e0",
  "token": "061f2c63-e36b-421e-9ece-5adfcd580886",
  "type": "payment",
  "state": "pending",
  "created_at": "2025-01-29T15:28:12.114992Z",
  "updated_at": "2025-01-29T15:28:12.114992Z",
  "amount": 500,
  "currency": "GBP",
  "outstanding_amount": 500,
  "settlement_currency": "GBP",
  "capture_mode": "manual",
  "authorisation_type": "final",
  "description": "Example car rental order",
  "checkout_url": "https://checkout.revolut.com/payment-link/061f2c63-e36b-421e-9ece-5adfcd580886",
  "redirect_url": "https://www.example.com/redirect",
  "cancel_authorised_after": "PT30M",
  "industry_data": {
    "type": "car_rental",
    "booking_id": "example_booking_id",
    "pick_up_date": "2026-03-01T11:00:00Z",
    "drop_off_date": "2026-03-05T16:30:00Z",
    "refundability": "partially_refundable",
    "pick_up_location": {
      "street_line_1": "1 Example Street",
      "city": "London",
      "country_code": "GB",
      "postcode": "SW1A 1AA"
    },
    "drop_off_location": {
      "street_line_1": "10 Another Road",
      "city": "Manchester",
      "country_code": "GB",
      "postcode": "M1 1AA"
    },
    "distance_limit": {
      "limit": 500,
      "unit": "miles",
      "additional_distance_cost": {
        "amount": 150,
        "currency": "GBP"
      }
    }
  },
  "enforce_challenge": "forced",
  "customer": {
    "id": "db186257-3031-4726-98ea-f2260ea115f0",
    "email": "example@example.com",
    "phone": "+447700900000",
    "full_name": "Example Customer"
  },
  "merchant_order_data": {
    "url": "https://www.example.com/rental/example_booking_id",
    "reference": "example_car_rental_reference"
  }
}
1e9d:["$","div","201-application/json-example_order_car_rental",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$1ef5"}}]}]],"$L1ef6"]}] 1ef7:T2e90,
{
  "id": "6516edb9-74af-ae47-829b-1475e807a8d7",
  "token": "1e619c26-d954-4d45-94ab-aba1e407fcee",
  "type": "payment",
  "state": "pending",
  "created_at": "2023-09-29T15:31:05.746826Z",
  "updated_at": "2023-09-29T15:31:05.746826Z",
  "amount": 26100,
  "currency": "EUR",
  "outstanding_amount": 26100,
  "settlement_currency": "EUR",
  "capture_mode": "manual",
  "authorisation_type": "final",
  "description": "Customer wants to buy 0.01 BTC",
  "checkout_url": "https://checkout.revolut.com/payment-link/1e619c26-d954-4d45-94ab-aba1e407fcee",
  "redirect_url": "https://www.example.com/redirect",
  "industry_data": {
    "type": "crypto",
    "transactions": [
      {
        "id": "7b2a8ed4-5889-4c0c-a8cc-299aff1c881b",
        "status": "pending",
        "recipient_wallet_id": "64a6f159-0a60-a446-880e-e449a1f62f7c"
      }
    ],
    "seller": {
      "id": "a13638ab-3e90-4b05-9f69-23abc655775b",
      "name": "Ramp Provider Company Name",
      "website": "https://example.com",
      "phone": "123456789",
      "mcc": "6051",
      "address": {
        "street_line_1": "456 Crypto Ave",
        "city": "New York",
        "postcode": "10001",
        "country_code": "US"
      }
    }
  },
  "enforce_challenge": "automatic",
  "customer": {
    "id": "db186257-3031-4726-98ea-f2260ea115f0",
    "email": "example@example.com",
    "phone": "+44123456789",
    "full_name": "Example Customer"
  },
  "merchant_order_data": {
    "url": "https://www.example.com/cryptotransactionnumber-12345",
    "reference": "example_crypto_reference"
  }
}
1e9e:["$","div","201-application/json-example_order_crypto",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$1ef7"}}]}]],"$L1ef8"]}] 1ef9:T1fa0,
{
  "id": "670920dc-d343-abf8-963a-68ae1bc8ae58",
  "token": "41aabe45-b444-45e6-8363-f0433452e138",
  "type": "payment",
  "state": "pending",
  "created_at": "2024-10-11T12:58:04.826974Z",
  "updated_at": "2024-10-11T12:58:04.826974Z",
  "amount": 10000,
  "currency": "EUR",
  "outstanding_amount": 10000,
  "capture_mode": "automatic",
  "authorisation_type": "final",
  "checkout_url": "https://checkout.revolut.com/payment-link/41aabe45-b444-45e6-8363-f0433452e138",
  "industry_data": {
    "type": "marketplace",
    "seller": {
      "id": "123-45-67",
      "name": "Example Seller",
      "address": {
        "street_line_1": "1 Canada Square",
        "street_line_2": "Revolut LTD, Level 39",
        "region": "Greater London",
        "city": "London",
        "country_code": "GB",
        "country_subdivision_code": "GB-LND",
        "postcode": "E14 4HD"
      },
      "website": "https://example.com/123-45-67",
      "phone": "+441234567890"
    }
  },
  "enforce_challenge": "automatic"
}
1e9f:["$","div","201-application/json-example_order_marketplace",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$1ef9"}}]}]],"$L1efa"]}] 1efb:T2e6f,
{
  "id": "67bf20c4-59a5-a7a9-81ad-052fda5f80eb",
  "token": "8737a497-9bae-4647-90bf-1abe2fd9162a",
  "type": "payment",
  "state": "pending",
  "created_at": "2025-02-26T14:10:12.804901Z",
  "updated_at": "2025-02-26T14:10:12.804901Z",
  "amount": 100,
  "currency": "GBP",
  "outstanding_amount": 100,
  "capture_mode": "automatic",
  "authorisation_type": "final",
  "checkout_url": "https://checkout.revolut.com/payment-link/8737a497-9bae-4647-90bf-1abe2fd9162a",
  "industry_data": {
    "type": "event",
    "booking_id": "example_booking_123",
    "events": [
      {
        "start_date": "2025-03-04T14:00:00Z",
        "end_date": "2025-03-04T17:00:00Z",
        "supplier": "Example Supplier",
        "supplier_payment_date": "2025-03-03T14:00:15Z",
        "name": "Example Event",
        "location": {
          "street_line_1": "Example Street 123",
          "street_line_2": "II/123",
          "region": "London",
          "city": "London",
          "country_code": "GB",
          "postcode": "123456"
        },
        "category": "exhibition",
        "market": "primary",
        "tickets": [
          {
            "id": "example_ticket_1",
            "transferable": false,
            "refundability": "partially_refundable"
          },
          {
            "id": "example_ticket_2",
            "transferable": true,
            "refundability": "non_refundable"
          },
          {
            "id": "example_ticket_3"
          }
        ]
      }
    ]
  },
  "enforce_challenge": "automatic"
}
1ea0:["$","div","201-application/json-example_order_event",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$1efb"}}]}]],"$L1efc"]}] 1efd:T2735,
{
  "id": "67c70d42-1545-a73d-a4a5-35b7ac49e1da",
  "token": "9effe2b6-8907-4954-9e9b-696f763f7e08",
  "type": "payment",
  "state": "pending",
  "created_at": "2025-03-04T14:25:06.099782Z",
  "updated_at": "2025-03-04T14:25:06.099782Z",
  "amount": 100,
  "currency": "GBP",
  "outstanding_amount": 100,
  "capture_mode": "automatic",
  "authorisation_type": "final",
  "checkout_url": "https://checkout.revolut.com/payment-link/9effe2b6-8907-4954-9e9b-696f763f7e08",
  "industry_data": {
    "type": "lodging",
    "booking_id": "example_booking_123",
    "check_out_date": "2025-05-05T11:00:00Z",
    "booking_type": "flexible",
    "refundability": "partially_refundable",
    "location": {
      "street_line_1": "Example Street 123",
      "street_line_2": "II/123",
      "region": "London",
      "city": "London",
      "country_code": "GB",
      "postcode": "123456"
    },
    "guests": [
      {
        "first_name": "First",
        "last_name": "Guest"
      },
      {
        "first_name": "Second",
        "last_name": "Guest"
      }
    ],
    "check_in_date": "2025-05-01T15:00:00Z",
    "supplier_payment_date": "2025-05-05T11:00:00Z",
    "category": "bed_and_breakfast"
  },
  "enforce_challenge": "automatic"
}
1ea1:["$","div","201-application/json-example_order_lodging",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$1efd"}}]}]],"$L1efe"]}] 1eff:T46a,
{
  "code": "bad_request",
  "message": "Could not parse JSON",
  "timestamp": 1721049596461
}
1ea2:["$","div","400-application/json-default",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$1eff"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"code\": \"bad_request\",\n \"message\": \"Could not parse JSON\",\n \"timestamp\": 1721049596461\n}"}]}]]}] 1f00:T46f,
{
  "code": "unauthenticated",
  "message": "Authentication failed",
  "timestamp": 1721049596461
}
1ea3:["$","div","401-application/json-default",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$1f00"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"code\": \"unauthenticated\",\n \"message\": \"Authentication failed\",\n \"timestamp\": 1721049596461\n}"}]}]]}] 1f01:T44d,
{
  "code": "string",
  "message": "string",
  "timestamp": 123
}
1ea4:["$","div","404-application/json-default",{"className":"wzy01m0 _18b50nc0 y9a0do3","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"$1f01"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"code\": \"string\",\n \"message\": \"string\",\n \"timestamp\": 123\n}"}]}]]}] 1eaa:["$","div","CodeBlock-0",{"className":"wzy01m0 _18b50nc0","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"
sequence,\ndeparture_airport_code,\narrival_airport_code,\nflight_number,\ntravel_date,\nairline_name,\nairline_code,
"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"sequence,\ndeparture_airport_code,\narrival_airport_code,\nflight_number,\ntravel_date,\nairline_name,\nairline_code,\n"}]}]]}] 1eab:["$","div","CodeBlock-0",{"className":"wzy01m0 _18b50nc0","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"
tickets_purchase,\njourney_legs,\nbooking_url
"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"tickets_purchase,\njourney_legs,\nbooking_url\n"}]}]]}] 1eac:["$","div","CodeBlock-0",{"className":"wzy01m0 _18b50nc0","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"
booking_id\ndrop_off_date\nrefundability
"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"booking_id\ndrop_off_date\nrefundability\n"}]}]]}] 1ead:["$","div","CodeBlock-0",{"className":"wzy01m0 _18b50nc0","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"
transactions[].id\ntransactions[].status\ntransactions[].recipient_wallet_id\nseller.id\nseller.name\nseller.website\nseller.phone\nseller.address\nseller.mcc\ncustomer.full_name\ncustomer.date_of_birth
"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"transactions[].id\ntransactions[].status\ntransactions[].recipient_wallet_id\nseller.id\nseller.name\nseller.website\nseller.phone\nseller.address\nseller.mcc\ncustomer.full_name\ncustomer.date_of_birth\n"}]}]]}] 1eae:["$","div","CodeBlock-0",{"className":"wzy01m0 _18b50nc0","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"
seller.id\nseller.name\nseller.website\nseller.phone\nseller.address
"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"seller.id\nseller.name\nseller.website\nseller.phone\nseller.address\n"}]}]]}] 1eaf:["$","div","CodeBlock-0",{"className":"wzy01m0 _18b50nc0","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"
booking_id\nevents[].start_date\nevents[].end_date\nevents[].supplier\nevents[].tickets[].id
"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"booking_id\nevents[].start_date\nevents[].end_date\nevents[].supplier\nevents[].tickets[].id\n"}]}]]}] 1eb0:["$","div","CodeBlock-0",{"className":"wzy01m0 _18b50nc0","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"
booking_id\ncheck_in_date\ncheck_out_date\nsupplier_payment_date
"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"booking_id\ncheck_in_date\ncheck_out_date\nsupplier_payment_date\n"}]}]]}] 1eb1:["$","div","CodeBlock-0",{"className":"wzy01m0 _18b50nc0","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"
sequence,\ndeparture_airport_code,\narrival_airport_code,\nflight_number,\ntravel_date,\nairline_name,\nairline_code,
"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"sequence,\ndeparture_airport_code,\narrival_airport_code,\nflight_number,\ntravel_date,\nairline_name,\nairline_code,\n"}]}]]}] 1eb2:["$","div","CodeBlock-0",{"className":"wzy01m0 _18b50nc0","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"
tickets_purchase,\njourney_legs,\nbooking_url
"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"tickets_purchase,\njourney_legs,\nbooking_url\n"}]}]]}] 1eb3:["$","div","CodeBlock-0",{"className":"wzy01m0 _18b50nc0","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"
booking_id\ndrop_off_date\nrefundability
"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"booking_id\ndrop_off_date\nrefundability\n"}]}]]}] 1eb4:["$","div","CodeBlock-0",{"className":"wzy01m0 _18b50nc0","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"
transactions[].id\ntransactions[].status\ntransactions[].recipient_wallet_id\nseller.id\nseller.name\nseller.website\nseller.phone\nseller.address\nseller.mcc\ncustomer.full_name\ncustomer.date_of_birth
"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"transactions[].id\ntransactions[].status\ntransactions[].recipient_wallet_id\nseller.id\nseller.name\nseller.website\nseller.phone\nseller.address\nseller.mcc\ncustomer.full_name\ncustomer.date_of_birth\n"}]}]]}] 1eb5:["$","div","CodeBlock-0",{"className":"wzy01m0 _18b50nc0","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"
seller.id\nseller.name\nseller.website\nseller.phone\nseller.address
"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"seller.id\nseller.name\nseller.website\nseller.phone\nseller.address\n"}]}]]}] 1eb6:["$","div","CodeBlock-0",{"className":"wzy01m0 _18b50nc0","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"
booking_id\nevents[].start_date\nevents[].end_date\nevents[].supplier\nevents[].tickets[].id
"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"booking_id\nevents[].start_date\nevents[].end_date\nevents[].supplier\nevents[].tickets[].id\n"}]}]]}] 1eb7:["$","div","CodeBlock-0",{"className":"wzy01m0 _18b50nc0","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"
booking_id\ncheck_in_date\ncheck_out_date\nsupplier_payment_date
"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"booking_id\ncheck_in_date\ncheck_out_date\nsupplier_payment_date\n"}]}]]}] 1ed7:["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"amount\": 500,\n \"currency\": \"GBP\",\n \"capture_mode\": \"manual\",\n \"cancel_authorised_after\": \"PT30M\",\n \"expire_pending_after\": \"PT15M\",\n \"customer\": {\n \"email\": \"example@example.com\",\n \"date_of_birth\": \"1990-01-01\"\n },\n \"description\": \"Example product\",\n \"shipping\": {\n \"address\": {\n \"street_line_1\": \"7 Westferry Circus\",\n \"city\": \"London\",\n \"country_code\": \"GB\",\n \"postcode\": \"E14 4HD\"\n }\n },\n \"enforce_challenge\": \"forced\",\n \"metadata\": {\n \"product_type\": \"Example\"\n },\n \"merchant_order_data\": {\n \"url\": \"https://www.example.com/orders/12345\"\n },\n \"redirect_url\": \"https://www.example.com/redirect\",\n \"statement_descriptor_suffix\": \"12345\"\n}"}]}] 1f02:T565,{ "amount": 770, "currency": "GBP", "line_items": [ { "name": "Example item 1", "type": "physical", "quantity": { "value": 2, "unit": "kg" }, "unit_price_amount": 100, "total_amount": 170, "external_id": "external_id_123", "discounts": [ { "name": "Discount 1", "amount": 50 } ], "taxes": [ { "name": "10% VAT", "amount": 20 } ], "image_urls": [ "https://www.example.com/line-item-image1", "https://www.example.com/line-item-image2" ], "description": "First line item", "url": "https://www.example.com" }, { "name": "Example item 2", "type": "service", "quantity": { "value": 10, "unit": "pieces" }, "unit_price_amount": 100, "total_amount": 600, "external_id": "external_id_456", "discounts": [ { "name": "Discount 2", "amount": 500 } ], "taxes": [ { "name": "10% VAT", "amount": 100 } ], "image_urls": [ "https://www.example.com/line-item-image3", "https://www.example.com/line-item-image4" ], "description": "Second line item", "url": "https://www.example.com" } ] }1eda:["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"$1f02"}]}] 1edc:["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"amount\": 500,\n \"currency\": \"GBP\",\n \"shipping\": {\n \"address\": {\n \"street_line_1\": \"Example Street 123\",\n \"street_line_2\": \"II/123\",\n \"region\": \"London\",\n \"city\": \"London\",\n \"country_code\": \"GB\",\n \"postcode\": \"123456\"\n },\n \"contact\": {\n \"name\": \"Example Contact\",\n \"email\": \"example.contact@example.com\",\n \"phone\": \"+441234567890\"\n },\n \"shipments\": [\n {\n \"shipping_company_name\": \"Example Shipping Co.\",\n \"tracking_number\": \"123456789\",\n \"estimated_delivery_date\": \"2024-12-03T10:15:30+02:00[Europe/Paris]\",\n \"tracking_url\": \"https://www.example.com/tracking/123456789\"\n }\n ]\n }\n}"}]}] 1f03:T8ea,{ "amount": 500, "currency": "GBP", "settlement_currency": "EUR", "description": "Example order description", "customer": { "full_name": "Example Customer", "phone": "+441234567890", "email": "example@example.com" }, "enforce_challenge": "forced", "capture_mode": "manual", "cancel_authorised_after": "PT30M", "industry_data": { "type": "airline", "booking_id": "unique-booking-id-12345", "fulfillment_date": "2023-07-10T14:00:00.069624Z", "ticket_type": "flexible", "crs_code": "DATS", "ticket_change_indicator": "new", "refundability": "refundable", "passengers": [ { "first_name": "Example", "last_name": "Customer" }, { "first_name": "John", "last_name": "Doe" } ], "journey_legs": [ { "sequence": 1, "departure_airport_code": "FRA", "arrival_airport_code": "LHR", "flight_number": "670", "fare_base_code": "J", "travel_date": "2023-07-10T10:00:00.069624Z", "airline_name": "AerLingus", "airline_code": "EI" }, { "sequence": 2, "departure_airport_code": "LHR", "arrival_airport_code": "DUB", "flight_number": "678", "fare_base_code": "J", "travel_date": "2023-07-10T15:00:00.069624Z", "airline_name": "AerLingus", "airline_code": "EI" }, { "sequence": 3, "departure_airport_code": "DUB", "arrival_airport_code": "LHR", "flight_number": "679", "fare_base_code": "F", "travel_date": "2023-07-15T10:00:00.069624Z", "airline_name": "AerLingus", "airline_code": "EI" }, { "sequence": 4, "departure_airport_code": "LHR", "arrival_airport_code": "FRA", "flight_number": "671", "fare_base_code": "F", "travel_date": "2023-07-10T14:00:00.069624Z", "airline_name": "AerLingus", "airline_code": "EI" } ], "booking_url": "https://example.com/bookings/1234" }, "merchant_order_data": { "url": "https://www.example.com/ticketnumber-12345", "reference": "example_airline_reference" }, "redirect_url": "https://www.example.com/redirect" }1ede:["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"$1f03"}]}] 1f04:T4dd,{ "amount": 500, "currency": "GBP", "settlement_currency": "GBP", "description": "Example car rental order", "customer": { "full_name": "Example Customer", "phone": "+447700900000", "email": "example@example.com" }, "enforce_challenge": "forced", "capture_mode": "manual", "cancel_authorised_after": "PT30M", "industry_data": { "type": "car_rental", "booking_id": "example_booking_id", "pick_up_date": "2026-03-01T11:00:00Z", "drop_off_date": "2026-03-05T16:30:00Z", "refundability": "partially_refundable", "pick_up_location": { "street_line_1": "1 Example Street", "city": "London", "country_code": "GB", "postcode": "SW1A 1AA" }, "drop_off_location": { "street_line_1": "10 Another Road", "city": "Manchester", "country_code": "GB", "postcode": "M1 1AA" }, "distance_limit": { "limit": 500, "unit": "miles", "additional_distance_cost": { "amount": 150, "currency": "GBP" } } }, "merchant_order_data": { "url": "https://www.example.com/rental/example_booking_id", "reference": "example_car_rental_reference" }, "redirect_url": "https://www.example.com/redirect" }1ee0:["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"$1f04"}]}] 1f05:T42c,{ "amount": 26100, "currency": "EUR", "settlement_currency": "EUR", "description": "Customer wants to buy 0.01 BTC", "customer": { "id": "db186257-3031-4726-98ea-f2260ea115f0" }, "capture_mode": "manual", "cancel_authorised_after": "PT30M", "industry_data": { "type": "crypto", "transactions": [ { "id": "7b2a8ed4-5889-4c0c-a8cc-299aff1c881b", "status": "pending", "recipient_wallet_id": "64a6f159-0a60-a446-880e-e449a1f62f7c" } ], "seller": { "id": "a13638ab-3e90-4b05-9f69-23abc655775b", "name": "Ramp Provider Company Name", "website": "https://example.com", "phone": "123456789", "mcc": "6051", "address": { "street_line_1": "456 Crypto Ave", "city": "New York", "postcode": "10001", "country_code": "US" } } }, "merchant_order_data": { "url": "https://www.example.com/cryptotransactionnumber-12345", "reference": "example_crypto_reference" }, "redirect_url": "https://www.example.com/redirect" }1ee2:["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"$1f05"}]}] 1ee4:["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"amount\": 10000,\n \"currency\": \"EUR\",\n \"industry_data\": {\n \"type\": \"marketplace\",\n \"seller\": {\n \"id\": \"123-45-67\",\n \"name\": \"Example Seller\",\n \"website\": \"https://example.com/123-45-67\",\n \"phone\": \"+441234567890\",\n \"address\": {\n \"street_line_1\": \"1 Canada Square\",\n \"street_line_2\": \"Revolut LTD, Level 39\",\n \"postcode\": \"E14 4HD\",\n \"country_code\": \"GB\",\n \"country_subdivision_code\": \"GB-LND\",\n \"city\": \"London\",\n \"region\": \"Greater London\"\n }\n }\n }\n}"}]}] 1f06:T432,{ "amount": 100, "currency": "GBP", "industry_data": { "type": "event", "booking_id": "example_booking_123", "events": [ { "start_date": "2025-03-04T14:00:00Z", "end_date": "2025-03-04T17:00:00Z", "supplier": "Example Supplier", "supplier_payment_date": "2025-03-03T14:00:15Z", "name": "Example Event", "location": { "street_line_1": "Example Street 123", "street_line_2": "II/123", "region": "London", "city": "London", "country_code": "GB", "postcode": "123456" }, "category": "exhibition", "market": "primary", "tickets": [ { "id": "example_ticket_1", "transferable": false, "refundability": "partially_refundable" }, { "id": "example_ticket_2", "transferable": true, "refundability": "non_refundable" }, { "id": "example_ticket_3" } ] } ] } }1ee6:["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"$1f06"}]}] 1ee8:["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"amount\": 100,\n \"currency\": \"GBP\",\n \"industry_data\": {\n \"type\": \"lodging\",\n \"booking_id\": \"example_booking_123\",\n \"check_in_date\": \"2025-05-01T15:00:00Z\",\n \"check_out_date\": \"2025-05-05T11:00:00Z\",\n \"supplier_payment_date\": \"2025-05-05T11:00:00Z\",\n \"category\": \"bed_and_breakfast\",\n \"booking_type\": \"flexible\",\n \"refundability\": \"partially_refundable\",\n \"location\": {\n \"street_line_1\": \"Example Street 123\",\n \"street_line_2\": \"II/123\",\n \"region\": \"London\",\n \"city\": \"London\",\n \"country_code\": \"GB\",\n \"postcode\": \"123456\"\n },\n \"guests\": [\n {\n \"first_name\": \"First\",\n \"last_name\": \"Guest\"\n },\n {\n \"first_name\": \"Second\",\n \"last_name\": \"Guest\"\n }\n ]\n }\n}"}]}] 1eea:["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"id\": \"6516e61c-d279-a454-a837-bc52ce55ed49\",\n \"token\": \"0adc0e3c-ab44-4f33-bcc0-534ded7354ce\",\n \"type\": \"payment\",\n \"state\": \"pending\",\n \"created_at\": \"2023-09-29T14:58:36.079398Z\",\n \"updated_at\": \"2023-09-29T14:58:36.079398Z\",\n \"amount\": 500,\n \"currency\": \"GBP\",\n \"outstanding_amount\": 500,\n \"capture_mode\": \"automatic\",\n \"authorisation_type\": \"final\",\n \"checkout_url\": \"https://checkout.revolut.com/payment-link/0adc0e3c-ab44-4f33-bcc0-534ded7354ce\",\n \"enforce_challenge\": \"automatic\"\n}"}]}] 1f07:T454,{ "id": "6516e6ec-c7f7-a0fb-a6d3-add05fa46d2f", "token": "1058031d-1e71-4d07-9f97-5ad388a1346c", "type": "payment", "state": "pending", "created_at": "2023-09-29T15:02:04.083787Z", "updated_at": "2023-09-29T15:02:04.083787Z", "amount": 500, "currency": "GBP", "outstanding_amount": 500, "capture_mode": "manual", "authorisation_type": "final", "cancel_authorised_after": "PT30M", "description": "Example product", "checkout_url": "https://checkout.revolut.com/payment-link/1058031d-1e71-4d07-9f97-5ad388a1346c", "redirect_url": "https://www.example.com/redirect", "shipping": { "address": { "street_line_1": "7 Westferry Circus", "city": "London", "country_code": "GB", "postcode": "E14 4HD" } }, "metadata": { "product_type": "Example" }, "enforce_challenge": "forced", "customer": { "id": "467646d6-e452-4d1e-a401-703f09cd3818", "email": "example@example.com", "date_of_birth": "1990-01-01" }, "merchant_order_data": { "url": "https://example.com/orders/12345" }, "statement_descriptor_suffix": "12345" }1eec:["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"$1f07"}]}] 1f08:T674,{ "id": "6516e61c-d279-a454-a837-bc52ce55ed49", "token": "0adc0e3c-ab44-4f33-bcc0-534ded7354ce", "type": "payment", "state": "authorised", "created_at": "2023-09-29T14:58:36.079398Z", "updated_at": "2023-09-29T14:58:36.079398Z", "amount": 5000, "currency": "GBP", "outstanding_amount": 5000, "capture_mode": "manual", "authorisation_type": "pre_authorisation", "cancel_authorised_after": "PT72H", "description": "Hotel reservation deposit", "checkout_url": "https://checkout.revolut.com/payment-link/0adc0e3c-ab44-4f33-bcc0-534ded7354ce", "enforce_challenge": "automatic", "payments": [ { "id": "6516f38a-a12b-aca3-83f2-6ed16d6ed246", "state": "authorised", "created_at": "2023-09-29T14:55:54.579311Z", "updated_at": "2023-09-29T14:56:38.403232Z", "amount": 5000, "currency": "GBP", "settled_amount": 5000, "settled_currency": "GBP", "billing_address": { "country_code": "GB", "postcode": "SW1A 1AA" }, "risk_level": "low", "fees": [], "payer": { "email": "example.payer@example.com", "phone": "+447911123456" }, "payment_method": { "type": "card", "card_brand": "visa", "funding": "credit", "card_country_code": "GB", "card_bin": "411111", "card_last_four": "1111", "card_expiry": "12/25", "cardholder_name": "Example Holder", "capture_deadline": "2023-10-06T14:55:54.579311Z", "fingerprint": "1JAllfQY4POhBV8DaddAQ4LC5RbMP8LMLvUdJW4s5JY=", "network_transaction_id": "1234567890123456" } } ] }1eee:["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"$1f08"}]}] 1f09:T736,{ "id": "66bcc998-4209-ac6e-96fe-2910b949c516", "token": "0bcfcc1d-9ee9-4476-b36c-cf4abba2e45a", "type": "payment", "state": "pending", "created_at": "2024-08-14T15:13:28.814729Z", "updated_at": "2024-08-14T15:13:28.814729Z", "amount": 770, "currency": "GBP", "outstanding_amount": 770, "capture_mode": "automatic", "authorisation_type": "final", "checkout_url": "https://checkout.revolut.com/payment-link/0bcfcc1d-9ee9-4476-b36c-cf4abba2e45a", "enforce_challenge": "automatic", "line_items": [ { "name": "Example item 1", "unit_price_amount": 100, "quantity": { "value": 2, "unit": "kg" }, "type": "physical", "discounts": [ { "name": "Discount 1", "amount": 50 } ], "taxes": [ { "name": "10% VAT", "amount": 20 } ], "total_amount": 170, "image_urls": [ "https://www.example.com/line-item-image1", "https://www.example.com/line-item-image2" ], "description": "First line item", "external_id": "external_id_123", "url": "https://www.example.com" }, { "name": "Example item 2", "unit_price_amount": 100, "quantity": { "value": 10, "unit": "pieces" }, "type": "service", "discounts": [ { "name": "Discount 2", "amount": 500 } ], "taxes": [ { "name": "10% VAT", "amount": 100 } ], "total_amount": 600, "image_urls": [ "https://www.example.com/line_item_image3", "https://www.example.com/line_item_image4" ], "description": "Second line item", "external_id": "external_id_456", "url": "https://www.example.com" } ] }1ef0:["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"$1f09"}]}] 1f0a:T480,{ "id": "66c5e449-36d3-af78-a832-328150ddc6a3", "token": "b1145e3e-30c7-4dd6-b84c-680dccd39dde", "type": "payment", "state": "pending", "created_at": "2024-08-21T12:57:45.793605Z", "updated_at": "2024-08-21T12:57:45.793605Z", "amount": 770, "currency": "GBP", "outstanding_amount": 770, "capture_mode": "automatic", "authorisation_type": "final", "checkout_url": "https://checkout.revolut.com/payment-link/b1145e3e-30c7-4dd6-b84c-680dccd39dde", "shipping": { "address": { "street_line_1": "Example Street 123", "street_line_2": "II/123", "region": "London", "city": "London", "country_code": "GB", "postcode": "123456" }, "contact": { "name": "Example Contact", "email": "example.contact@example.com", "phone": "+441234567890" }, "shipments": [ { "shipping_company_name": "Example Shipping Co.", "tracking_number": "123456789", "estimated_delivery_date": "2024-12-03T10:15:30+02:00[Europe/Paris]", "tracking_url": "https://www.example.com/tracking/123456789" } ] }, "enforce_challenge": "automatic" }1ef2:["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"$1f0a"}]}] 1f0b:Taaa,{ "id": "6516ed0c-098f-aa19-80e5-9d92f52b35e0", "token": "061f2c63-e36b-421e-9ece-5adfcd580886", "type": "payment", "state": "pending", "created_at": "2023-09-29T15:28:12.114992Z", "updated_at": "2023-09-29T15:28:12.114992Z", "amount": 500, "currency": "GBP", "outstanding_amount": 500, "settlement_currency": "EUR", "capture_mode": "manual", "authorisation_type": "final", "description": "Example order description", "checkout_url": "https://checkout.revolut.com/payment-link/061f2c63-e36b-421e-9ece-5adfcd580886", "redirect_url": "https://www.example.com/redirect", "cancel_authorised_after": "PT30M", "industry_data": { "type": "airline", "booking_id": "unique-booking-id-12345", "fulfillment_date": "2023-07-10T14:00:00.069624Z", "ticket_type": "flexible", "crs_code": "DATS", "ticket_change_indicator": "new", "refundability": "refundable", "passengers": [ { "first_name": "Example", "last_name": "Customer" }, { "first_name": "John", "last_name": "Doe" } ], "journey_legs": [ { "sequence": 1, "departure_airport_code": "FRA", "arrival_airport_code": "LHR", "flight_number": "670", "fare_base_code": "J", "travel_date": "2023-07-10T10:00:00.069624Z", "airline_name": "AerLingus", "airline_code": "EI" }, { "sequence": 2, "departure_airport_code": "LHR", "arrival_airport_code": "DUB", "flight_number": "678", "fare_base_code": "J", "travel_date": "2023-07-10T15:00:00.069624Z", "airline_name": "AerLingus", "airline_code": "EI" }, { "sequence": 3, "departure_airport_code": "DUB", "arrival_airport_code": "LHR", "flight_number": "679", "fare_base_code": "F", "travel_date": "2023-07-15T10:00:00.069624Z", "airline_name": "AerLingus", "airline_code": "EI" }, { "sequence": 4, "departure_airport_code": "LHR", "arrival_airport_code": "FRA", "flight_number": "671", "fare_base_code": "F", "travel_date": "2023-07-10T14:00:00.069624Z", "airline_name": "AerLingus", "airline_code": "EI" } ], "booking_url": "https://example.com/bookings/1234" }, "enforce_challenge": "forced", "customer": { "id": "db186257-3031-4726-98ea-f2260ea115f0", "email": "example@example.com", "phone": "+441234567890", "full_name": "Example Customer" }, "merchant_order_data": { "url": "https://www.example.com/ticketnumber-12345", "reference": "example_airline_reference" } }1ef4:["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"$1f0b"}]}] 1f0c:T69d,{ "id": "6516ed0c-098f-aa19-80e5-9d92f52b35e0", "token": "061f2c63-e36b-421e-9ece-5adfcd580886", "type": "payment", "state": "pending", "created_at": "2025-01-29T15:28:12.114992Z", "updated_at": "2025-01-29T15:28:12.114992Z", "amount": 500, "currency": "GBP", "outstanding_amount": 500, "settlement_currency": "GBP", "capture_mode": "manual", "authorisation_type": "final", "description": "Example car rental order", "checkout_url": "https://checkout.revolut.com/payment-link/061f2c63-e36b-421e-9ece-5adfcd580886", "redirect_url": "https://www.example.com/redirect", "cancel_authorised_after": "PT30M", "industry_data": { "type": "car_rental", "booking_id": "example_booking_id", "pick_up_date": "2026-03-01T11:00:00Z", "drop_off_date": "2026-03-05T16:30:00Z", "refundability": "partially_refundable", "pick_up_location": { "street_line_1": "1 Example Street", "city": "London", "country_code": "GB", "postcode": "SW1A 1AA" }, "drop_off_location": { "street_line_1": "10 Another Road", "city": "Manchester", "country_code": "GB", "postcode": "M1 1AA" }, "distance_limit": { "limit": 500, "unit": "miles", "additional_distance_cost": { "amount": 150, "currency": "GBP" } } }, "enforce_challenge": "forced", "customer": { "id": "db186257-3031-4726-98ea-f2260ea115f0", "email": "example@example.com", "phone": "+447700900000", "full_name": "Example Customer" }, "merchant_order_data": { "url": "https://www.example.com/rental/example_booking_id", "reference": "example_car_rental_reference" } }1ef6:["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"$1f0c"}]}] 1f0d:T620,{ "id": "6516edb9-74af-ae47-829b-1475e807a8d7", "token": "1e619c26-d954-4d45-94ab-aba1e407fcee", "type": "payment", "state": "pending", "created_at": "2023-09-29T15:31:05.746826Z", "updated_at": "2023-09-29T15:31:05.746826Z", "amount": 26100, "currency": "EUR", "outstanding_amount": 26100, "settlement_currency": "EUR", "capture_mode": "manual", "authorisation_type": "final", "description": "Customer wants to buy 0.01 BTC", "checkout_url": "https://checkout.revolut.com/payment-link/1e619c26-d954-4d45-94ab-aba1e407fcee", "redirect_url": "https://www.example.com/redirect", "industry_data": { "type": "crypto", "transactions": [ { "id": "7b2a8ed4-5889-4c0c-a8cc-299aff1c881b", "status": "pending", "recipient_wallet_id": "64a6f159-0a60-a446-880e-e449a1f62f7c" } ], "seller": { "id": "a13638ab-3e90-4b05-9f69-23abc655775b", "name": "Ramp Provider Company Name", "website": "https://example.com", "phone": "123456789", "mcc": "6051", "address": { "street_line_1": "456 Crypto Ave", "city": "New York", "postcode": "10001", "country_code": "US" } } }, "enforce_challenge": "automatic", "customer": { "id": "db186257-3031-4726-98ea-f2260ea115f0", "email": "example@example.com", "phone": "+44123456789", "full_name": "Example Customer" }, "merchant_order_data": { "url": "https://www.example.com/cryptotransactionnumber-12345", "reference": "example_crypto_reference" } }1ef8:["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"$1f0d"}]}] 1efa:["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"{\n \"id\": \"670920dc-d343-abf8-963a-68ae1bc8ae58\",\n \"token\": \"41aabe45-b444-45e6-8363-f0433452e138\",\n \"type\": \"payment\",\n \"state\": \"pending\",\n \"created_at\": \"2024-10-11T12:58:04.826974Z\",\n \"updated_at\": \"2024-10-11T12:58:04.826974Z\",\n \"amount\": 10000,\n \"currency\": \"EUR\",\n \"outstanding_amount\": 10000,\n \"capture_mode\": \"automatic\",\n \"authorisation_type\": \"final\",\n \"checkout_url\": \"https://checkout.revolut.com/payment-link/41aabe45-b444-45e6-8363-f0433452e138\",\n \"industry_data\": {\n \"type\": \"marketplace\",\n \"seller\": {\n \"id\": \"123-45-67\",\n \"name\": \"Example Seller\",\n \"address\": {\n \"street_line_1\": \"1 Canada Square\",\n \"street_line_2\": \"Revolut LTD, Level 39\",\n \"region\": \"Greater London\",\n \"city\": \"London\",\n \"country_code\": \"GB\",\n \"country_subdivision_code\": \"GB-LND\",\n \"postcode\": \"E14 4HD\"\n },\n \"website\": \"https://example.com/123-45-67\",\n \"phone\": \"+441234567890\"\n }\n },\n \"enforce_challenge\": \"automatic\"\n}"}]}] 1f0e:T603,{ "id": "67bf20c4-59a5-a7a9-81ad-052fda5f80eb", "token": "8737a497-9bae-4647-90bf-1abe2fd9162a", "type": "payment", "state": "pending", "created_at": "2025-02-26T14:10:12.804901Z", "updated_at": "2025-02-26T14:10:12.804901Z", "amount": 100, "currency": "GBP", "outstanding_amount": 100, "capture_mode": "automatic", "authorisation_type": "final", "checkout_url": "https://checkout.revolut.com/payment-link/8737a497-9bae-4647-90bf-1abe2fd9162a", "industry_data": { "type": "event", "booking_id": "example_booking_123", "events": [ { "start_date": "2025-03-04T14:00:00Z", "end_date": "2025-03-04T17:00:00Z", "supplier": "Example Supplier", "supplier_payment_date": "2025-03-03T14:00:15Z", "name": "Example Event", "location": { "street_line_1": "Example Street 123", "street_line_2": "II/123", "region": "London", "city": "London", "country_code": "GB", "postcode": "123456" }, "category": "exhibition", "market": "primary", "tickets": [ { "id": "example_ticket_1", "transferable": false, "refundability": "partially_refundable" }, { "id": "example_ticket_2", "transferable": true, "refundability": "non_refundable" }, { "id": "example_ticket_3" } ] } ] }, "enforce_challenge": "automatic" }1efc:["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"$1f0e"}]}] 1f0f:T4d5,{ "id": "67c70d42-1545-a73d-a4a5-35b7ac49e1da", "token": "9effe2b6-8907-4954-9e9b-696f763f7e08", "type": "payment", "state": "pending", "created_at": "2025-03-04T14:25:06.099782Z", "updated_at": "2025-03-04T14:25:06.099782Z", "amount": 100, "currency": "GBP", "outstanding_amount": 100, "capture_mode": "automatic", "authorisation_type": "final", "checkout_url": "https://checkout.revolut.com/payment-link/9effe2b6-8907-4954-9e9b-696f763f7e08", "industry_data": { "type": "lodging", "booking_id": "example_booking_123", "check_out_date": "2025-05-05T11:00:00Z", "booking_type": "flexible", "refundability": "partially_refundable", "location": { "street_line_1": "Example Street 123", "street_line_2": "II/123", "region": "London", "city": "London", "country_code": "GB", "postcode": "123456" }, "guests": [ { "first_name": "First", "last_name": "Guest" }, { "first_name": "Second", "last_name": "Guest" } ], "check_in_date": "2025-05-01T15:00:00Z", "supplier_payment_date": "2025-05-05T11:00:00Z", "category": "bed_and_breakfast" }, "enforce_challenge": "automatic" }1efe:["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"$1f0f"}]}] 1eb8:["$","div","CodeBlock-0",{"className":"wzy01m0 _18b50nc0","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"
'Authorization: Bearer <yourSecretApiKey>'
"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"'Authorization: Bearer '\n"}]}]]}] 1ebe:["$","div","CodeBlock-0",{"className":"wzy01m0 _18b50nc0","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"
sequence,\ndeparture_airport_code,\narrival_airport_code,\nflight_number,\ntravel_date,\nairline_name,\nairline_code,
"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"sequence,\ndeparture_airport_code,\narrival_airport_code,\nflight_number,\ntravel_date,\nairline_name,\nairline_code,\n"}]}]]}] 1ebf:["$","div","CodeBlock-0",{"className":"wzy01m0 _18b50nc0","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"
tickets_purchase,\njourney_legs,\nbooking_url
"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"tickets_purchase,\njourney_legs,\nbooking_url\n"}]}]]}] 1ec0:["$","div","CodeBlock-0",{"className":"wzy01m0 _18b50nc0","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"
booking_id\ndrop_off_date\nrefundability
"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"booking_id\ndrop_off_date\nrefundability\n"}]}]]}] 1ec1:["$","div","CodeBlock-0",{"className":"wzy01m0 _18b50nc0","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"
transactions[].id\ntransactions[].status\ntransactions[].recipient_wallet_id\nseller.id\nseller.name\nseller.website\nseller.phone\nseller.address\nseller.mcc\ncustomer.full_name\ncustomer.date_of_birth
"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"transactions[].id\ntransactions[].status\ntransactions[].recipient_wallet_id\nseller.id\nseller.name\nseller.website\nseller.phone\nseller.address\nseller.mcc\ncustomer.full_name\ncustomer.date_of_birth\n"}]}]]}] 1ec2:["$","div","CodeBlock-0",{"className":"wzy01m0 _18b50nc0","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"
seller.id\nseller.name\nseller.website\nseller.phone\nseller.address
"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"seller.id\nseller.name\nseller.website\nseller.phone\nseller.address\n"}]}]]}] 1ec3:["$","div","CodeBlock-0",{"className":"wzy01m0 _18b50nc0","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"
booking_id\nevents[].start_date\nevents[].end_date\nevents[].supplier\nevents[].tickets[].id
"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"booking_id\nevents[].start_date\nevents[].end_date\nevents[].supplier\nevents[].tickets[].id\n"}]}]]}] 1ec4:["$","div","CodeBlock-0",{"className":"wzy01m0 _18b50nc0","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"
booking_id\ncheck_in_date\ncheck_out_date\nsupplier_payment_date
"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"booking_id\ncheck_in_date\ncheck_out_date\nsupplier_payment_date\n"}]}]]}] 1ec5:["$","div","CodeBlock-0",{"className":"wzy01m0 _18b50nc0","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"
sequence,\ndeparture_airport_code,\narrival_airport_code,\nflight_number,\ntravel_date,\nairline_name,\nairline_code,
"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"sequence,\ndeparture_airport_code,\narrival_airport_code,\nflight_number,\ntravel_date,\nairline_name,\nairline_code,\n"}]}]]}] 1ec6:["$","div","CodeBlock-0",{"className":"wzy01m0 _18b50nc0","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"
tickets_purchase,\njourney_legs,\nbooking_url
"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"tickets_purchase,\njourney_legs,\nbooking_url\n"}]}]]}] 1ec7:["$","div","CodeBlock-0",{"className":"wzy01m0 _18b50nc0","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"
booking_id\ndrop_off_date\nrefundability
"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"booking_id\ndrop_off_date\nrefundability\n"}]}]]}] 1ec8:["$","div","CodeBlock-0",{"className":"wzy01m0 _18b50nc0","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"
transactions[].id\ntransactions[].status\ntransactions[].recipient_wallet_id\nseller.id\nseller.name\nseller.website\nseller.phone\nseller.address\nseller.mcc\ncustomer.full_name\ncustomer.date_of_birth
"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"transactions[].id\ntransactions[].status\ntransactions[].recipient_wallet_id\nseller.id\nseller.name\nseller.website\nseller.phone\nseller.address\nseller.mcc\ncustomer.full_name\ncustomer.date_of_birth\n"}]}]]}] 1ec9:["$","div","CodeBlock-0",{"className":"wzy01m0 _18b50nc0","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"
seller.id\nseller.name\nseller.website\nseller.phone\nseller.address
"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"seller.id\nseller.name\nseller.website\nseller.phone\nseller.address\n"}]}]]}] 1eca:["$","div","CodeBlock-0",{"className":"wzy01m0 _18b50nc0","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"
booking_id\nevents[].start_date\nevents[].end_date\nevents[].supplier\nevents[].tickets[].id
"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"booking_id\nevents[].start_date\nevents[].end_date\nevents[].supplier\nevents[].tickets[].id\n"}]}]]}] 1ecb:["$","div","CodeBlock-0",{"className":"wzy01m0 _18b50nc0","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"
booking_id\ncheck_in_date\ncheck_out_date\nsupplier_payment_date
"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"booking_id\ncheck_in_date\ncheck_out_date\nsupplier_payment_date\n"}]}]]}] 1ece:["$","div","CodeBlock-0",{"className":"wzy01m0 _18b50nc0","children":[["$undefined",["$","$L78",null,{"className":"_18b50nc3","defaultWrap":false,"children":["$","div",null,{"className":"_18b50nc4","dangerouslySetInnerHTML":{"__html":"
'Authorization: Bearer <yourSecretApiKey>'
"}}]}]],["$","div",null,{"className":"wzy01m1","children":["$","$L79",null,{"code":"'Authorization: Bearer '\n"}]}]]}]