/*! For license information please see main.ccfa74ac.js.LICENSE.txt */ (self.webpackChunkdeveloper_docs=self.webpackChunkdeveloper_docs||[]).push([[38792],{89188:(e,t,r)=>{"use strict";r.d(t,{W:()=>o});var n=r(96540);function o(){return n.createElement("svg",{width:"20",height:"20",className:"DocSearch-Search-Icon",viewBox:"0 0 20 20","aria-hidden":"true"},n.createElement("path",{d:"M14.386 14.386l4.0877 4.0877-4.0877-4.0877c-2.9418 2.9419-7.7115 2.9419-10.6533 0-2.9419-2.9418-2.9419-7.7115 0-10.6533 2.9418-2.9419 7.7115-2.9419 10.6533 0 2.9419 2.9418 2.9419 7.7115 0 10.6533z",stroke:"currentColor",fill:"none",fillRule:"evenodd",strokeLinecap:"round",strokeLinejoin:"round"}))}},35947:(e,t,r)=>{"use strict";r.d(t,{A:()=>u});r(96540);var n=r(53259),o=r.n(n),i=r(84054);const s={"013b08b3":[()=>r.e(70968).then(r.bind(r,82659)),"@site/blog/2023-07-14.mdx",82659],"019e9cc6":[()=>r.e(69635).then(r.bind(r,59394)),"@site/docs/solutions/blueprints/platform-connector.mdx",59394],"01a85c17":[()=>Promise.all([r.e(71869),r.e(8209)]).then(r.bind(r,29140)),"@theme/BlogTagsListPage",29140],"01bb7bc7":[()=>r.e(47223).then(r.bind(r,21450)),"@site/blog/2023-04-21.mdx",21450],"028f387b":[()=>r.e(76941).then(r.bind(r,59732)),"@site/blog/2023-05-18-2.mdx?truncated=true",59732],"02ed6f87":[()=>r.e(27601).then(r.bind(r,8093)),"@site/docs/price-rules/references/frontend-api.mdx",8093],"0359fcc2":[()=>r.e(37108).then(r.t.bind(r,14571,19)),"@generated/docusaurus-plugin-content-docs/default/p/guides-tags-shipper-hq-e5b.json",14571],"03a0fca9":[()=>r.e(28).then(r.bind(r,62811)),"@site/docs/checkout/plugins/index.mdx",62811],"03c9cabe":[()=>r.e(9655).then(r.bind(r,55840)),"@site/blog/2024-01-16.mdx?truncated=true",55840],"046235e5":[()=>r.e(4893).then(r.bind(r,83335)),"@site/blog/2023-10-10.mdx",83335],"05588b06":[()=>r.e(91213).then(r.t.bind(r,62199,19)),"/home/runner/work/developer-docs/developer-docs/.docusaurus/docusaurus-plugin-redoc/plugin-redoc-1/redocApiSpecV1.2-plugin-redoc-1.json",62199],"05834f9b":[()=>r.e(90034).then(r.bind(r,68850)),"@site/docs/checkout/integrations/commercetools.mdx",68850],"05ae2100":[()=>r.e(54239).then(r.t.bind(r,23668,19)),"@generated/docusaurus-plugin-content-docs/default/p/guides-tags-area-384.json",23668],"05d9ef96":[()=>Promise.all([r.e(71869),r.e(71471)]).then(r.bind(r,32968)),"@site/docs/checkout/bold-boosters/set-up-apple-pay.mdx",32968],"061f685f":[()=>Promise.all([r.e(71869),r.e(23063)]).then(r.bind(r,97736)),"@site/docs/platform-integration/adobe-commerce/troubleshooting.mdx",97736],"07d304fa":[()=>r.e(60868).then(r.t.bind(r,62925,19)),"@generated/docusaurus-plugin-content-blog/default/p/changelog-tags-4f2.json",62925],"086ed28a":[()=>r.e(56515).then(r.t.bind(r,68096,19)),"/home/runner/work/developer-docs/developer-docs/.docusaurus/docusaurus-plugin-redoc/plugin-redoc-7/redocApiLayoutV1-plugin-redoc-7.json",68096],"096a8400":[()=>r.e(54489).then(r.bind(r,12179)),"@site/docs/price-rules/index.mdx",12179],"09759d9e":[()=>r.e(52435).then(r.bind(r,22243)),"@site/docs/checkout/plugins/getting-started.mdx",22243],"0bf819ce":[()=>r.e(33397).then(r.t.bind(r,44360,19)),"/home/runner/work/developer-docs/developer-docs/.docusaurus/docusaurus-plugin-redoc/plugin-redoc-6/redocApiLayoutV1-plugin-redoc-6.json",44360],"0c0c8d35":[()=>r.e(55611).then(r.bind(r,14303)),"@site/docs/solutions/bold-built/braintree.mdx",14303],"0c6b229a":[()=>r.e(27458).then(r.bind(r,64415)),"@site/docs/platform-integration/magento-1/concepts.mdx",64415],"0ef60b25":[()=>Promise.all([r.e(71869),r.e(15394),r.e(30895)]).then(r.bind(r,6327)),"@site/docs/checkout/fulfill-order.mdx",6327],"0fcb85a4":[()=>r.e(95064).then(r.t.bind(r,46034,19)),"@generated/docusaurus-plugin-content-docs/default/p/guides-tags-payment-gateway-d1d.json",46034],"0ff48c37":[()=>r.e(91502).then(r.bind(r,40738)),"@site/blog/2023-05-26.mdx",40738],"1096c25f":[()=>r.e(88615).then(r.t.bind(r,36160,19)),"/home/runner/work/developer-docs/developer-docs/.docusaurus/docusaurus-plugin-redoc/plugin-redoc-4/redocApiLayoutV1-plugin-redoc-4.json",36160],"11c34f40":[()=>r.e(17793).then(r.bind(r,54124)),"@site/docs/price-rules/working-with-rulesets/price-adjustments.mdx",54124],"126328f1":[()=>r.e(20850).then(r.t.bind(r,73369,19)),"@generated/docusaurus-plugin-content-docs/default/p/guides-tags-algolia-bf8.json",73369],"129cd899":[()=>r.e(82664).then(r.t.bind(r,94189,19)),"@generated/docusaurus-plugin-content-docs/default/p/guides-tags-pay-pal-complete-payments-f6c.json",94189],"12a02ba9":[()=>r.e(519).then(r.t.bind(r,98048,19)),"/home/runner/work/developer-docs/developer-docs/.docusaurus/docusaurus-plugin-redoc/plugin-redoc-2/redocApiLayoutV1-plugin-redoc-2.json",98048],"12b52f02":[()=>r.e(26891).then(r.bind(r,49484)),"@site/blog/2024-03-25.mdx",49484],"12e87cfc":[()=>r.e(64454).then(r.bind(r,82520)),"@site/docs/platform-integration/magento-1/troubleshooting.mdx",82520],"14bb7233":[()=>r.e(57277).then(r.bind(r,77765)),"@site/blog/2024-03-28.mdx",77765],"152456bb":[()=>r.e(93434).then(r.bind(r,91229)),"@site/blog/2023-07-25.mdx?truncated=true",91229],"15ed5882":[()=>r.e(77071).then(r.bind(r,4894)),"@site/blog/2022-09-23.mdx",4894],"15feefe1":[()=>r.e(48657).then(r.bind(r,97793)),"@site/docs/checkout/resources/error-responses.mdx",97793],"16044b28":[()=>r.e(18758).then(r.bind(r,93517)),"@site/blog/2023-09-27-1.mdx",93517],"1756e9cf":[()=>Promise.all([r.e(71869),r.e(47503)]).then(r.bind(r,95543)),"@site/docs/checkout/bold-boosters/connect-braintree.mdx",95543],17896441:[()=>Promise.all([r.e(71869),r.e(15394),r.e(73019),r.e(3671),r.e(18401)]).then(r.bind(r,47022)),"@theme/DocItem",47022],"17c9e882":[()=>r.e(89258).then(r.bind(r,73435)),"@site/blog/2024-01-02.mdx",73435],"18314aad":[()=>r.e(22770).then(r.t.bind(r,14154,19)),"@generated/docusaurus-plugin-content-docs/default/p/guides-tags-checkout-experience-templates-249.json",14154],"1918bf25":[()=>r.e(77049).then(r.bind(r,49732)),"@site/blog/2024-01-16.mdx",49732],"1a4e3797":[()=>Promise.all([r.e(71869),r.e(62138)]).then(r.bind(r,10673)),"@theme/SearchPage",10673],"1a73a0d3":[()=>r.e(88575).then(r.bind(r,24551)),"@site/blog/2023-08-08.mdx?truncated=true",24551],"1b84d22a":[()=>r.e(75651).then(r.bind(r,30623)),"@site/blog/2023-04-04.mdx?truncated=true",30623],"1baa23ab":[()=>r.e(27624).then(r.bind(r,32428)),"@site/blog/2022-12-02-2.mdx",32428],"1c1b9ca6":[()=>Promise.all([r.e(71869),r.e(92187)]).then(r.bind(r,83056)),"@site/docs/checkout/bold-boosters/install-compatibility-modules.mdx",83056],"1c5b18b6":[()=>r.e(43977).then(r.bind(r,26576)),"@site/blog/2023-12-11.mdx",26576],"1c6bfda8":[()=>Promise.all([r.e(71869),r.e(15394),r.e(58310)]).then(r.bind(r,36413)),"@site/docs/subscriptions-v2/headless/storefront-setup.mdx",36413],"1de9b3cd":[()=>r.e(81778).then(r.t.bind(r,43979,19)),"/home/runner/work/developer-docs/developer-docs/.docusaurus/docusaurus-plugin-redoc/plugin-redoc-2/redocApiSpecV1.2-plugin-redoc-2.json",43979],"1df93b7f":[()=>Promise.all([r.e(71869),r.e(34583)]).then(r.bind(r,92462)),"@site/src/pages/index.tsx",92462],"1e058c00":[()=>r.e(8223).then(r.bind(r,63773)),"@site/docs/solutions/bold-built/shipping.mdx",63773],"1e188057":[()=>r.e(28826).then(r.bind(r,87917)),"@site/docs/solutions/bold-built/commercetools.mdx",87917],"1ebebbee":[()=>r.e(31732).then(r.bind(r,56740)),"@site/blog/2023-11-21.mdx?truncated=true",56740],"1f66b349":[()=>r.e(62230).then(r.bind(r,70292)),"@site/blog/2022-12-14.mdx?truncated=true",70292],"1feb10c6":[()=>r.e(20847).then(r.bind(r,51579)),"@site/docs/checkout/create-order.mdx",51579],"206acd2e":[()=>r.e(28900).then(r.bind(r,60802)),"@site/docs/solutions/blueprints/search-constructor.mdx",60802],"207f8656":[()=>r.e(37953).then(r.bind(r,45487)),"@site/docs/platform-integration/bigcommerce/pre.mdx",45487],"20e47cd0":[()=>r.e(69188).then(r.bind(r,69352)),"@site/blog/2023-04-05.mdx",69352],"216d6b37":[()=>Promise.all([r.e(71869),r.e(15394),r.e(53728)]).then(r.bind(r,25736)),"@site/docs/subscriptions-v2/public-integrations.mdx",25736],"218ea731":[()=>r.e(41121).then(r.bind(r,35362)),"@site/docs/checkout/resources/open-source.mdx",35362],"21b937f7":[()=>r.e(77088).then(r.bind(r,63147)),"@site/blog/2023-03-09.mdx?truncated=true",63147],"22188c71":[()=>r.e(75431).then(r.bind(r,75561)),"@site/docs/checkout/concepts/headless.mdx",75561],"22449fb1":[()=>r.e(31349).then(r.bind(r,33123)),"@site/blog/2023-08-22.mdx?truncated=true",33123],"22cbcfd9":[()=>r.e(32002).then(r.t.bind(r,11129,19)),"@generated/docusaurus-plugin-content-docs/default/p/guides-tags-convert-from-search-95d.json",11129],"2308e035":[()=>r.e(23361).then(r.t.bind(r,34782,19)),"@generated/docusaurus-plugin-content-blog/default/p/changelog-archive-7c0.json",34782],"24e5fb8d":[()=>r.e(44279).then(r.t.bind(r,23541,19)),"@generated/docusaurus-plugin-content-docs/default/p/guides-tags-apple-pay-a7d.json",23541],"250aabba":[()=>r.e(65267).then(r.bind(r,31809)),"@site/blog/2022-12-02-01.mdx",31809],"25da6a08":[()=>Promise.all([r.e(71869),r.e(30642),r.e(17264),r.e(42218)]).then(r.bind(r,93260)),"@site/docs/checkout/bold-boosters/bold-booster-for-paypal-overview.mdx",93260],"26354ec1":[()=>r.e(66022).then(r.t.bind(r,28716,19)),"@generated/docusaurus-plugin-content-docs/default/p/guides-tags-adobe-commerce-4ed.json",28716],"26fdda53":[()=>r.e(58096).then(r.t.bind(r,74071,19)),"/home/runner/work/developer-docs/developer-docs/.docusaurus/docusaurus-plugin-redoc/plugin-redoc-9/redocApiSpecV1.2-plugin-redoc-9.json",74071],"27dd01ec":[()=>r.e(89391).then(r.bind(r,71708)),"@site/blog/2022-09-29.mdx",71708],"2812ebd9":[()=>r.e(89136).then(r.t.bind(r,51269,19)),"@generated/docusaurus-plugin-content-docs/default/p/guides-tags-conversion-e8f.json",51269],"282f6ca7":[()=>Promise.all([r.e(71869),r.e(65280)]).then(r.bind(r,16934)),"@site/docs/checkout/bold-boosters/connect-authorize.mdx",16934],"28e36230":[()=>r.e(8888).then(r.t.bind(r,40394,19)),"@generated/docusaurus-plugin-content-docs/default/p/guides-tags-tax-jar-cd0.json",40394],"2926825b":[()=>r.e(52743).then(r.bind(r,35726)),"@site/blog/2024-06-06.mdx?truncated=true",35726],"29f817bb":[()=>r.e(44498).then(r.t.bind(r,68099,19)),"/home/runner/work/developer-docs/developer-docs/.docusaurus/docusaurus-plugin-redoc/plugin-redoc-6/redocApiSpecV1.2-plugin-redoc-6.json",68099],"2beb3a58":[()=>r.e(38269).then(r.t.bind(r,4668,19)),"@generated/docusaurus-plugin-content-docs/default/p/guides-tags-wink-654.json",4668],"2d3b27e3":[()=>r.e(22599).then(r.bind(r,67268)),"@site/blog/2022-10-18-1.mdx?truncated=true",67268],"2d680932":[()=>r.e(39385).then(r.bind(r,86299)),"@site/blog/2024-01-17.mdx?truncated=true",86299],"2e715987":[()=>r.e(1301).then(r.bind(r,40250)),"@site/docs/solutions/blueprints/klarna.mdx",40250],"2e9f1eb7":[()=>r.e(75042).then(r.bind(r,12036)),"@site/blog/2022-07-21-1.mdx?truncated=true",12036],"2efa2b47":[()=>Promise.all([r.e(71869),r.e(78656)]).then(r.bind(r,85445)),"@site/docs/checkout/bold-boosters/bold-booster-upgrade.mdx",85445],"2f460e85":[()=>r.e(68377).then(r.bind(r,1264)),"@site/blog/2023-05-02.mdx?truncated=true",1264],"2f543d31":[()=>r.e(46005).then(r.bind(r,81062)),"@site/docs/subscriptions-v2/concepts.mdx",81062],"2f6beaf6":[()=>r.e(37273).then(r.t.bind(r,64199,19)),"@generated/docusaurus-plugin-redoc/plugin-redoc-5/__plugin.json",64199],"2f72bd59":[()=>r.e(15832).then(r.t.bind(r,79990,19)),"@generated/docusaurus-plugin-content-blog/default/p/changelog-036.json",79990],"320311d2":[()=>r.e(80903).then(r.t.bind(r,9658,19)),"@generated/docusaurus-plugin-content-docs/default/p/guides-tags-platform-159.json",9658],"32270c83":[()=>r.e(70137).then(r.bind(r,2703)),"@site/blog/2023-05-10.mdx?truncated=true",2703],"327f0203":[()=>r.e(89922).then(r.t.bind(r,79760,19)),"@generated/docusaurus-plugin-redoc/plugin-redoc-11/__plugin.json",79760],"3402c51f":[()=>r.e(53445).then(r.bind(r,84757)),"@site/blog/2023-03-27.mdx",84757],"35a762ac":[()=>r.e(37255).then(r.t.bind(r,36479,19)),"@generated/docusaurus-plugin-content-docs/default/p/guides-tags-buy-now-800.json",36479],"35f98246":[()=>r.e(83992).then(r.bind(r,12668)),"@site/blog/2023-12-11.mdx?truncated=true",12668],36076582:[()=>r.e(17474).then(r.bind(r,25894)),"@site/docs/checkout/concepts/plugins.mdx",25894],"364990a8":[()=>r.e(67745).then(r.bind(r,7909)),"@site/blog/2022-11-10.mdx",7909],"365589ae":[()=>r.e(14841).then(r.bind(r,99083)),"@site/docs/platform-integration/adobe-commerce/dev-store.mdx",99083],"36994c47":[()=>r.e(89858).then(r.t.bind(r,45516,19)),"@generated/docusaurus-plugin-content-blog/default/__plugin.json",45516],"371bd825":[()=>r.e(34351).then(r.t.bind(r,26186,19)),"/home/runner/work/developer-docs/developer-docs/.docusaurus/docusaurus-plugin-redoc/plugin-redoc-12/redocApiLayoutV1-plugin-redoc-12.json",26186],"3720c009":[()=>Promise.all([r.e(71869),r.e(84787)]).then(r.bind(r,12194)),"@theme/DocTagsListPage",12194],"37a49784":[()=>r.e(98562).then(r.bind(r,15976)),"@site/blog/2023-02-07.mdx?truncated=true",15976],"381798e0":[()=>r.e(98374).then(r.bind(r,70212)),"@site/blog/2023-12-15.mdx",70212],"3896737e":[()=>r.e(83929).then(r.t.bind(r,53011,19)),"@generated/docusaurus-plugin-redoc/plugin-redoc-9/__plugin.json",53011],"38fbc61d":[()=>r.e(34690).then(r.bind(r,33638)),"@site/docs/checkout/concepts/index.mdx",33638],"3ac52e9f":[()=>Promise.all([r.e(71869),r.e(38233)]).then(r.bind(r,11770)),"@site/src/pages/solution-library.tsx",11770],"3b06b79c":[()=>Promise.all([r.e(71869),r.e(36415)]).then(r.bind(r,65231)),"@site/docs/archive/index.mdx",65231],"3b0c5da3":[()=>r.e(26688).then(r.t.bind(r,80521,19)),"@generated/docusaurus-plugin-content-docs/default/p/guides-tags-partner-type-831.json",80521],"3b98b72e":[()=>r.e(73517).then(r.bind(r,28927)),"@site/blog/2024-04-23.mdx",28927],"3beaf1fb":[()=>r.e(59473).then(r.bind(r,98770)),"@site/docs/checkout/plugins/installation-flow.mdx",98770],"3c00c6bd":[()=>Promise.all([r.e(71869),r.e(15394),r.e(59468)]).then(r.bind(r,66046)),"@site/docs/subscriptions-v2/resources/api-versioning.mdx",66046],"3c0eb5c2":[()=>Promise.all([r.e(71869),r.e(4672)]).then(r.bind(r,23845)),"@site/docs/checkout/bold-boosters/connect-payment-gateways.mdx",23845],"3d25f1b1":[()=>r.e(5741).then(r.t.bind(r,7949,19)),"@generated/docusaurus-plugin-redoc/plugin-redoc-7/__plugin.json",7949],"3e088593":[()=>r.e(11038).then(r.t.bind(r,75431,19)),"@generated/docusaurus-plugin-content-docs/default/p/guides-5ed.json",75431],"3e4e0c9f":[()=>r.e(17028).then(r.bind(r,36988)),"@site/docs/solutions/bold-built/bigcommerce.mdx",36988],"3e8ea28b":[()=>r.e(18093).then(r.t.bind(r,27083,19)),"@generated/docusaurus-plugin-content-docs/default/p/guides-tags-express-checkout-92c.json",27083],"3e9c5392":[()=>r.e(63010).then(r.bind(r,20478)),"@site/docs/checkout/concepts/spi-integrate.mdx",20478],"3e9f6079":[()=>Promise.all([r.e(71869),r.e(93548)]).then(r.bind(r,28172)),"@site/docs/checkout/bold-boosters/export-request-logs.mdx",28172],"3f285aa8":[()=>r.e(29163).then(r.bind(r,61579)),"@site/blog/2023-06-13.mdx",61579],"3f4cdd6c":[()=>r.e(28870).then(r.bind(r,15081)),"@site/docs/archive/subscriptions_v1_storefront.mdx",15081],"3fc31e27":[()=>r.e(40805).then(r.t.bind(r,37607,19)),"/home/runner/work/developer-docs/developer-docs/.docusaurus/docusaurus-plugin-redoc/plugin-redoc-5/redocApiSpecV1.2-plugin-redoc-5.json",37607],"407941e5":[()=>Promise.all([r.e(71869),r.e(3632)]).then(r.bind(r,79677)),"@site/docs/archive/installation_m1.mdx",79677],"40fa253f":[()=>r.e(31476).then(r.bind(r,22380)),"@site/blog/2023-04-21-1.mdx?truncated=true",22380],41051053:[()=>r.e(52288).then(r.t.bind(r,16768,19)),"/home/runner/work/developer-docs/developer-docs/.docusaurus/docusaurus-plugin-redoc/plugin-redoc-1/redocApiLayoutV1-plugin-redoc-1.json",16768],"4176d444":[()=>r.e(78861).then(r.bind(r,28870)),"@site/blog/2023-09-22.mdx?truncated=true",28870],"4179f89d":[()=>r.e(22807).then(r.bind(r,39863)),"@site/blog/2023-04-04-1.mdx",39863],"417badab":[()=>r.e(16271).then(r.bind(r,46005)),"@site/docs/checkout/concepts/payment-information.mdx",46005],"419031ba":[()=>r.e(12702).then(r.bind(r,11645)),"@site/blog/2023-07-14-1.mdx",11645],"42143f48":[()=>r.e(40877).then(r.bind(r,46986)),"@site/blog/2022-07-29.mdx",46986],"42eed18b":[()=>r.e(44632).then(r.bind(r,39330)),"@site/blog/2022-09-23.mdx?truncated=true",39330],"437d2981":[()=>Promise.all([r.e(71869),r.e(15394),r.e(71915)]).then(r.bind(r,6897)),"@site/docs/checkout/pmmc.mdx",6897],44887076:[()=>r.e(69641).then(r.bind(r,12685)),"@site/docs/checkout/validate-discounts.mdx",12685],"452a9096":[()=>r.e(41015).then(r.bind(r,67880)),"@site/blog/2023-05-18-2.mdx",67880],"45aea981":[()=>r.e(66439).then(r.bind(r,63981)),"@site/blog/2024-01-02.mdx?truncated=true",63981],"46125cb5":[()=>Promise.all([r.e(71869),r.e(33047)]).then(r.bind(r,13271)),"@site/docs/checkout/bold-boosters/bold-booster-troubleshooting.mdx",13271],"464a882e":[()=>r.e(10795).then(r.bind(r,77934)),"@site/blog/2023-08-29.mdx",77934],"4754be42":[()=>r.e(96294).then(r.bind(r,93281)),"@site/docs/price-rules/references/actions.mdx",93281],"476a3022":[()=>Promise.all([r.e(71869),r.e(15394),r.e(58454)]).then(r.bind(r,17058)),"@site/docs/checkout/webhooks.mdx",17058],"48029edc":[()=>r.e(29852).then(r.bind(r,12532)),"@site/docs/subscriptions-v2/adjust-subscription-orders.mdx",12532],"481eaf8f":[()=>r.e(96626).then(r.t.bind(r,38129,19)),"@generated/docusaurus-plugin-content-docs/default/p/guides-tags-unsupported-platform-b8b.json",38129],"48ed49ac":[()=>r.e(27881).then(r.bind(r,60586)),"@site/blog/2025-11-18.mdx?truncated=true",60586],"4a590fd9":[()=>r.e(23491).then(r.bind(r,28357)),"@site/docs/solutions/bold-built/taxjar.mdx",28357],"4a76b343":[()=>Promise.all([r.e(71869),r.e(15394),r.e(86851)]).then(r.bind(r,84006)),"@site/docs/checkout/checkout-epg-guide.mdx",84006],"4a9b8eb6":[()=>r.e(59602).then(r.t.bind(r,85126,19)),"@generated/docusaurus-plugin-content-blog/default/p/changelog-tags-checkout-2ee.json",85126],"4ad8da9e":[()=>r.e(73989).then(r.bind(r,30246)),"@site/docs/checkout/resources/glossary.mdx",30246],"4b395a8f":[()=>r.e(81797).then(r.bind(r,50038)),"@site/blog/2023-05-26.mdx?truncated=true",50038],"4b73ab1c":[()=>r.e(43258).then(r.t.bind(r,90013,19)),"@generated/docusaurus-plugin-content-blog/default/p/changelog-tags-shops-505.json",90013],"4bb7ca0f":[()=>r.e(44922).then(r.bind(r,23493)),"@site/docs/checkout/references/checkout-epg-api.mdx",23493],"4cd9658a":[()=>r.e(18815).then(r.t.bind(r,40728,19)),"/home/runner/work/developer-docs/developer-docs/.docusaurus/docusaurus-plugin-redoc/plugin-redoc-3/redocApiLayoutV1-plugin-redoc-3.json",40728],"4d743b46":[()=>r.e(75031).then(r.bind(r,84981)),"@site/docs/solutions/bold-built/template.mdx",84981],"4db3f03b":[()=>r.e(49935).then(r.bind(r,97302)),"@site/docs/solutions/blueprints/upsell.mdx",97302],"4e24f880":[()=>r.e(23390).then(r.bind(r,37274)),"@site/blog/2022-09-16.mdx?truncated=true",37274],"4e5af80a":[()=>r.e(69231).then(r.bind(r,21400)),"@site/docs/checkout/plugins/overrides.mdx",21400],"4ee21c5c":[()=>r.e(68755).then(r.t.bind(r,31542,19)),"@generated/docusaurus-plugin-content-docs/default/p/guides-tags-magento-1-b87.json",31542],"4f5c5749":[()=>Promise.all([r.e(71869),r.e(15394),r.e(79052)]).then(r.bind(r,13139)),"@site/docs/checkout/css.mdx",13139],"4fabaee9":[()=>Promise.all([r.e(71869),r.e(75924)]).then(r.bind(r,53890)),"@site/docs/platform-connector/rsa/requirements.mdx",53890],"4fbfcdd8":[()=>Promise.all([r.e(71869),r.e(31872)]).then(r.bind(r,68924)),"@site/docs/checkout/bold-boosters/integrate-forter.mdx",68924],"4fcc2d16":[()=>r.e(51488).then(r.bind(r,9365)),"@site/blog/2023-07-14.mdx?truncated=true",9365],"4ffac51d":[()=>r.e(76873).then(r.t.bind(r,31566,19)),"@generated/docusaurus-plugin-content-docs/default/p/guides-tags-payments-cb2.json",31566],"506d5ca1":[()=>r.e(81928).then(r.bind(r,52771)),"@site/docs/price-rules/customer-targeted-pricing.mdx",52771],"51c99a15":[()=>Promise.all([r.e(71869),r.e(15394),r.e(15697)]).then(r.bind(r,56305)),"@site/docs/checkout/plugins/app-hooks.mdx",56305],"5243b79c":[()=>r.e(23736).then(r.bind(r,88751)),"@site/blog/2023-03-07.mdx",88751],"533be5a4":[()=>Promise.all([r.e(71869),r.e(68901)]).then(r.bind(r,80915)),"@site/docs/checkout/references/country-province-requirements.mdx",80915],"5371f5c8":[()=>r.e(98569).then(r.bind(r,60127)),"@site/blog/2022-09-13.mdx",60127],"54fca6b7":[()=>r.e(23029).then(r.bind(r,76588)),"@site/blog/2023-02-07.mdx",76588],"55275f57":[()=>r.e(61925).then(r.bind(r,55993)),"@site/docs/checkout/concepts/cart-parameters.mdx",55993],"55974cf6":[()=>r.e(61574).then(r.bind(r,57674)),"@site/docs/platform-integration/magento-1/extensions.mdx",57674],"559a686d":[()=>r.e(46183).then(r.bind(r,298)),"@site/docs/solutions/bold-built/magento-1.mdx",298],"55c436a7":[()=>r.e(62011).then(r.bind(r,98317)),"@site/docs/archive/subscriptions_v1_msp.mdx",98317],"57566eda":[()=>r.e(70188).then(r.bind(r,26471)),"@site/blog/2024-02-01.mdx?truncated=true",26471],"576397fa":[()=>r.e(10553).then(r.bind(r,59681)),"@site/blog/2023-03-07.mdx?truncated=true",59681],"57edebfb":[()=>r.e(83469).then(r.bind(r,60510)),"@site/docs/platform-integration/magento-1/overview.mdx",60510],"57efee46":[()=>r.e(62362).then(r.bind(r,16080)),"@site/docs/checkout/references/plugin-actions.mdx",16080],"57f42c93":[()=>Promise.all([r.e(71869),r.e(69268)]).then(r.bind(r,42459)),"@site/docs/platform-integration/adobe-commerce/versions.mdx",42459],58226553:[()=>r.e(18943).then(r.bind(r,47783)),"@site/blog/2023-04-21-2.mdx",47783],"58986d4a":[()=>Promise.all([r.e(71869),r.e(96916)]).then(r.bind(r,6539)),"@site/docs/platform-integration/magento-1/versions.mdx",6539],"58f76ef5":[()=>Promise.all([r.e(71869),r.e(32753)]).then(r.bind(r,6778)),"@site/docs/checkout/bold-boosters/connect-nuvei.mdx",6778],"59a98010":[()=>r.e(30892).then(r.bind(r,50914)),"@site/blog/2024-07-16.mdx?truncated=true",50914],"59d8b887":[()=>r.e(91912).then(r.t.bind(r,97706,19)),"@generated/docusaurus-plugin-content-docs/default/p/guides-tags-email-fa9.json",97706],"5a170c02":[()=>r.e(86456).then(r.bind(r,73050)),"@site/blog/2022-09-27.mdx",73050],"5a2491ea":[()=>r.e(20871).then(r.t.bind(r,89664,19)),"@generated/docusaurus-plugin-redoc/plugin-redoc-2/__plugin.json",89664],"5ba19106":[()=>r.e(15544).then(r.bind(r,9056)),"@site/blog/2023-04-21-1.mdx",9056],"5be7ecee":[()=>r.e(5896).then(r.bind(r,84826)),"@site/docs/subscriptions-v2/resources/error-responses.mdx",84826],"5bf88447":[()=>r.e(94231).then(r.t.bind(r,37792,19)),"/home/runner/work/developer-docs/developer-docs/.docusaurus/docusaurus-plugin-redoc/plugin-redoc-11/redocApiLayoutV1-plugin-redoc-11.json",37792],"5c996eb8":[()=>r.e(95460).then(r.t.bind(r,63673,19)),"@generated/docusaurus-plugin-content-docs/default/p/guides-tags-shipping-6f9.json",63673],"5d2ff655":[()=>r.e(47818).then(r.bind(r,49830)),"@site/docs/solutions/bold-built/adobe.mdx",49830],"5d31ee35":[()=>r.e(21686).then(r.bind(r,35879)),"@site/blog/2022-11-10.mdx?truncated=true",35879],"5dc71d8d":[()=>r.e(95461).then(r.t.bind(r,78239,19)),"/home/runner/work/developer-docs/developer-docs/.docusaurus/docusaurus-plugin-redoc/plugin-redoc-8/redocApiSpecV1.2-plugin-redoc-8.json",78239],"5e17b9a1":[()=>r.e(36664).then(r.t.bind(r,55260,19)),"@generated/docusaurus-plugin-content-docs/default/p/guides-tags-oracle-commerce-cloud-413.json",55260],"5e3de0db":[()=>r.e(96897).then(r.bind(r,19154)),"@site/docs/price-rules/working-with-rulesets/prioritization-and-stacking.mdx",19154],"5e95c892":[()=>r.e(9647).then(r.bind(r,7121)),"@theme/DocsRoot",7121],"5e9f5e1a":[()=>Promise.resolve().then(r.bind(r,4784)),"@generated/docusaurus.config",4784],"5f2ba928":[()=>r.e(62682).then(r.bind(r,48194)),"@site/blog/2023-01-17.mdx",48194],"5f8ff37c":[()=>r.e(78783).then(r.t.bind(r,33986,19)),"@generated/docusaurus-plugin-content-docs/default/p/guides-tags-orium-d4f.json",33986],"600ea7f1":[()=>r.e(95323).then(r.t.bind(r,7286,19)),"@generated/docusaurus-plugin-content-docs/default/p/guides-tags-google-pay-190.json",7286],"6082c324":[()=>r.e(58731).then(r.bind(r,27007)),"@site/blog/2023-11-22.mdx",27007],"614beea8":[()=>Promise.all([r.e(71869),r.e(15394),r.e(63635)]).then(r.bind(r,81592)),"@site/docs/checkout/gift-cards.mdx",81592],"61f3d2fb":[()=>r.e(39931).then(r.bind(r,42370)),"@site/docs/price-rules/promotion-message.mdx",42370],"6238fb38":[()=>r.e(57555).then(r.bind(r,61656)),"@site/blog/2022-10-18-1.mdx",61656],"62618a35":[()=>r.e(70561).then(r.bind(r,30887)),"@site/blog/2022-07-11.mdx",30887],"6299583b":[()=>r.e(72925).then(r.bind(r,95735)),"@site/docs/solutions/blueprints/template.mdx",95735],"62ca7c03":[()=>r.e(82718).then(r.t.bind(r,69659,19)),"@generated/docusaurus-plugin-content-docs/default/p/guides-tags-platform-connector-fff.json",69659],"62d96ace":[()=>r.e(3249).then(r.bind(r,92801)),"@site/docs/subscriptions-v2/resources/open-source.mdx",92801],"63031fe5":[()=>r.e(54994).then(r.bind(r,82426)),"@site/blog/2022-08-02.mdx?truncated=true",82426],"648652f2":[()=>r.e(99702).then(r.bind(r,67916)),"@site/blog/2023-01-20.mdx?truncated=true",67916],"6705d7cc":[()=>r.e(73714).then(r.bind(r,91288)),"@site/blog/2022-07-14-1.mdx?truncated=true",91288],"6736d42e":[()=>r.e(83610).then(r.bind(r,90447)),"@site/blog/2023-12-07.mdx?truncated=true",90447],"676ffe1d":[()=>r.e(4046).then(r.t.bind(r,70387,19)),"@generated/docusaurus-plugin-content-blog/default/p/changelog-tags-checkout-backend-5ab.json",70387],"6875c492":[()=>Promise.all([r.e(71869),r.e(15394),r.e(73019),r.e(3671),r.e(84813)]).then(r.bind(r,33069)),"@theme/BlogTagsPostsPage",33069],"6981facc":[()=>r.e(9856).then(r.bind(r,22526)),"@site/blog/2023-11-30.mdx",22526],"6a372ef7":[()=>r.e(54524).then(r.bind(r,34194)),"@site/docs/solutions/blueprints/buy-now.mdx",34194],"6a8a2734":[()=>r.e(62705).then(r.bind(r,73387)),"@site/blog/2024-08-29.mdx?truncated=true",73387],"6a90a775":[()=>r.e(22499).then(r.t.bind(r,13605,19)),"@generated/docusaurus-plugin-content-docs/default/p/guides-tags-external-payment-gateway-connector-5c4.json",13605],"6aa951d6":[()=>Promise.all([r.e(71869),r.e(15394),r.e(46194)]).then(r.bind(r,45711)),"@site/docs/checkout/public-integrations.mdx",45711],"6b423876":[()=>r.e(42191).then(r.bind(r,5073)),"@site/blog/2023-10-27.mdx",5073],"6b556ce2":[()=>r.e(25345).then(r.t.bind(r,45494,19)),"@generated/docusaurus-plugin-redoc/plugin-redoc-4/__plugin.json",45494],"6b8719b3":[()=>r.e(75819).then(r.bind(r,60953)),"@site/blog/2022-07-11.mdx?truncated=true",60953],"6ba57622":[()=>r.e(19130).then(r.t.bind(r,21258,19)),"@generated/docusaurus-plugin-redoc/plugin-redoc-0/__plugin.json",21258],"6c0634db":[()=>r.e(22319).then(r.bind(r,34031)),"@site/blog/2022-10-31.mdx?truncated=true",34031],"6d6f958f":[()=>Promise.all([r.e(71869),r.e(15394),r.e(96169)]).then(r.bind(r,56923)),"@site/docs/platform-integration/magento-1/dev-store.mdx",56923],"6dcfd2ad":[()=>r.e(17635).then(r.bind(r,62610)),"@site/blog/2023-02-01.mdx",62610],"6e78600a":[()=>r.e(61446).then(r.bind(r,6346)),"@site/blog/2023-03-02.mdx?truncated=true",6346],"6fb8def7":[()=>r.e(74929).then(r.bind(r,19053)),"@site/docs/checkout/plugins/event-action-loop.mdx",19053],"713f479c":[()=>r.e(51751).then(r.t.bind(r,44556,19)),"@generated/docusaurus-plugin-content-docs/default/p/guides-tags-big-commerce-8ea.json",44556],"719ac0f6":[()=>r.e(11912).then(r.bind(r,444)),"@site/blog/2024-06-17.mdx?truncated=true",444],72234647:[()=>r.e(79976).then(r.bind(r,56393)),"@site/blog/2023-03-09.mdx",56393],"726335e8":[()=>r.e(59250).then(r.t.bind(r,74632,19)),"/home/runner/work/developer-docs/developer-docs/.docusaurus/docusaurus-plugin-redoc/plugin-redoc-0/redocApiLayoutV1-plugin-redoc-0.json",74632],"726b6d9c":[()=>Promise.all([r.e(71869),r.e(15394),r.e(16574)]).then(r.bind(r,88963)),"@site/docs/subscriptions-v2/webhooks.mdx",88963],"727c2919":[()=>Promise.all([r.e(71869),r.e(15394),r.e(69627)]).then(r.bind(r,11377)),"@site/docs/subscriptions-v2/getting-started.mdx",11377],"728e3184":[()=>r.e(40213).then(r.bind(r,89549)),"@site/docs/checkout/concepts/overrides.mdx",89549],"734da6f2":[()=>r.e(61812).then(r.bind(r,79742)),"@site/blog/2022-07-29.mdx?truncated=true",79742],"74e304d9":[()=>Promise.all([r.e(71869),r.e(40427)]).then(r.bind(r,72785)),"@site/docs/platform-connector/getting-started.mdx",72785],"7709a2ee":[()=>r.e(83279).then(r.bind(r,75497)),"@site/docs/subscriptions-v2/create-line-items.mdx",75497],"77143d78":[()=>r.e(50426).then(r.bind(r,55578)),"@site/blog/2024-06-06.mdx",55578],"7745d529":[()=>r.e(79362).then(r.bind(r,65710)),"@site/docs/price-rules/concepts/rulesets-and-rules.mdx",65710],"77b34fc8":[()=>r.e(18567).then(r.t.bind(r,66799,19)),"/home/runner/work/developer-docs/developer-docs/.docusaurus/docusaurus-plugin-redoc/plugin-redoc-0/redocApiSpecV1.2-plugin-redoc-0.json",66799],"7874c012":[()=>r.e(22043).then(r.t.bind(r,63664,19)),"/home/runner/work/developer-docs/developer-docs/.docusaurus/docusaurus-plugin-redoc/plugin-redoc-9/redocApiLayoutV1-plugin-redoc-9.json",63664],"78b0ba9f":[()=>r.e(36458).then(r.bind(r,15441)),"@site/blog/2022-10-19.mdx?truncated=true",15441],"78f5ef23":[()=>r.e(70641).then(r.bind(r,46565)),"@site/blog/2023-05-18.mdx",46565],"7972200e":[()=>r.e(49631).then(r.t.bind(r,76369,19)),"@generated/docusaurus-plugin-redoc/plugin-redoc-3/__plugin.json",76369],"79fd24fe":[()=>Promise.all([r.e(71869),r.e(15394),r.e(9144)]).then(r.bind(r,38011)),"@site/docs/price-rules/getting-started.mdx",38011],"7a0cbc90":[()=>r.e(82222).then(r.bind(r,74664)),"@site/blog/2022-12-02-2.mdx?truncated=true",74664],"7acfde56":[()=>r.e(14608).then(r.bind(r,10870)),"@site/blog/2022-09-16.mdx",10870],"7b30e072":[()=>r.e(26309).then(r.t.bind(r,13499,19)),"@generated/docusaurus-plugin-content-blog/default/p/changelog-tags-integrations-5d7.json",13499],"7c357204":[()=>r.e(54762).then(r.bind(r,69232)),"@site/blog/2024-06-17.mdx",69232],"7caefe66":[()=>r.e(26984).then(r.t.bind(r,76633,19)),"@generated/docusaurus-plugin-content-blog/default/p/changelog-tags-external-payment-gateway-connector-824.json",76633],"7cb1c17c":[()=>Promise.all([r.e(71869),r.e(55872)]).then(r.bind(r,96980)),"@site/docs/checkout/bold-boosters/connect-stripe.mdx",96980],"7d21ca31":[()=>r.e(37109).then(r.bind(r,11742)),"@site/blog/2023-04-21.mdx?truncated=true",11742],"7d2954f8":[()=>r.e(94320).then(r.bind(r,40141)),"@site/blog/2023-05-10.mdx",40141],"7d919bfe":[()=>Promise.all([r.e(71869),r.e(15394),r.e(60638)]).then(r.bind(r,30677)),"@site/docs/price-rules/quick-start.mdx",30677],"7de514a4":[()=>r.e(44884).then(r.bind(r,86604)),"@site/docs/subscriptions-v2/line-items.mdx",86604],"7e29e168":[()=>r.e(37924).then(r.bind(r,94061)),"@site/blog/2022-10-31.mdx",94061],"7e3e040f":[()=>r.e(16929).then(r.bind(r,49412)),"@site/docs/price-rules/working-with-rulesets/location-based-pricing.mdx",49412],"7f1b9386":[()=>r.e(13955).then(r.bind(r,60221)),"@site/blog/2023-04-04.mdx",60221],"7f33f3aa":[()=>r.e(80121).then(r.bind(r,93349)),"@site/blog/2022-10-13.mdx",93349],"7fec1bec":[()=>r.e(58381).then(r.t.bind(r,42314,19)),"@generated/docusaurus-plugin-content-docs/default/p/guides-tags-order-management-system-3b7.json",42314],"7ff5fa3f":[()=>Promise.all([r.e(71869),r.e(30642),r.e(76031)]).then(r.bind(r,87842)),"@site/docs/archive/installation.mdx",87842],"803dc12b":[()=>r.e(2174).then(r.bind(r,23345)),"@site/blog/2022-09-13.mdx?truncated=true",23345],"814f3328":[()=>r.e(67472).then(r.t.bind(r,55513,19)),"~blog/default/blog-post-list-prop-default.json",55513],"81df1f68":[()=>r.e(97215).then(r.bind(r,5107)),"@site/docs/price-rules/resources/open-source.mdx",5107],"8245391c":[()=>r.e(9588).then(r.t.bind(r,113,19)),"@generated/docusaurus-plugin-content-docs/default/p/guides-tags-express-pay-30c.json",113],"8279e022":[()=>Promise.all([r.e(71869),r.e(49614)]).then(r.bind(r,7667)),"@site/src/pages/api-specifications.tsx",7667],"82ac0f52":[()=>Promise.all([r.e(71869),r.e(15394),r.e(87010)]).then(r.bind(r,53072)),"@site/docs/subscriptions-v2/view-future-orders.mdx",53072],"82b8a81c":[()=>r.e(58524).then(r.bind(r,91516)),"@site/docs/checkout/extend.mdx",91516],"83aabe50":[()=>r.e(81790).then(r.bind(r,59886)),"@site/blog/2022-09-27.mdx?truncated=true",59886],"83e03a90":[()=>r.e(34356).then(r.t.bind(r,81702,19)),"/home/runner/work/developer-docs/developer-docs/.docusaurus/docusaurus-plugin-redoc/plugin-redoc-10/redocApiLayoutV1-plugin-redoc-10.json",81702],"841cd3c7":[()=>r.e(84290).then(r.bind(r,15056)),"@site/docs/subscriptions-v2/resources/supported-platforms-gateways.mdx",15056],"85a32b6a":[()=>r.e(68169).then(r.bind(r,3778)),"@site/blog/2023-11-30.mdx?truncated=true",3778],"8653eec3":[()=>r.e(45321).then(r.bind(r,42575)),"@site/blog/2023-09-27-1.mdx?truncated=true",42575],"867c094e":[()=>r.e(84151).then(r.bind(r,56469)),"@site/docs/checkout/resources/supported-platforms-gateways.mdx",56469],"8731bd3f":[()=>r.e(84201).then(r.bind(r,22310)),"@site/blog/2022-12-23.mdx?truncated=true",22310],"87685dec":[()=>Promise.all([r.e(71869),r.e(97336),r.e(16405)]).then(r.bind(r,73341)),"@site/docs/checkout/bold-boosters/m1-bold-booster-for-paypal.mdx",73341],"88f3445c":[()=>r.e(26890).then(r.t.bind(r,58853,19)),"@generated/docusaurus-plugin-content-docs/default/p/guides-tags-biometrics-129.json",58853],"89c10cb2":[()=>r.e(10833).then(r.t.bind(r,84941,19)),"@generated/docusaurus-plugin-content-docs/default/p/guides-tags-blog-595.json",84941],"8a1cc97c":[()=>r.e(45588).then(r.bind(r,69078)),"@site/blog/2022-08-02.mdx",69078],"8a7f04b4":[()=>r.e(37947).then(r.bind(r,9042)),"@site/blog/2022-12-23.mdx",9042],"8b3ba059":[()=>Promise.all([r.e(71869),r.e(53659)]).then(r.bind(r,17867)),"@site/docs/checkout/meta.mdx",17867],"8b65dfae":[()=>r.e(2826).then(r.t.bind(r,40879,19)),"/home/runner/work/developer-docs/developer-docs/.docusaurus/docusaurus-plugin-redoc/plugin-redoc-4/redocApiSpecV1.2-plugin-redoc-4.json",40879],"8b6ba284":[()=>r.e(6128).then(r.bind(r,54982)),"@site/blog/2022-10-25.mdx",54982],"8c1de4d0":[()=>r.e(65356).then(r.bind(r,54437)),"@site/blog/2024-02-01.mdx",54437],"8c40df0e":[()=>r.e(17295).then(r.bind(r,89977)),"@site/docs/price-rules/resources/access-scopes.mdx",89977],"8c6a0c8d":[()=>Promise.all([r.e(71869),r.e(15394),r.e(95832)]).then(r.bind(r,73131)),"@site/docs/checkout/resources/query-pagination.mdx",73131],"8cb9ae10":[()=>r.e(16818).then(r.t.bind(r,69515,19)),"@generated/docusaurus-plugin-content-docs/default/p/guides-tags-klarna-e10.json",69515],"8cbb51ac":[()=>r.e(1578).then(r.bind(r,23312)),"@site/docs/solutions/bold-built/paypal-checkout-flow.mdx",23312],"8d5df195":[()=>r.e(58829).then(r.bind(r,86918)),"@site/docs/solutions/example-projects/custom-flow.mdx",86918],"8d71f2ef":[()=>r.e(52406).then(r.bind(r,948)),"@site/blog/2023-05-02.mdx",948],"8dad17cc":[()=>r.e(25234).then(r.bind(r,87710)),"@site/docs/price-rules/resources/supported-platforms-gateways.mdx",87710],"8ef70909":[()=>r.e(16775).then(r.bind(r,88208)),"@site/docs/price-rules/working-with-rulesets/scheduling.mdx",88208],"8f1f4a7a":[()=>r.e(98441).then(r.t.bind(r,8781,19)),"@generated/docusaurus-plugin-content-docs/default/p/guides-tags-checkout-flow-8b2.json",8781],"8f6fd828":[()=>r.e(52711).then(r.t.bind(r,54485,19)),"@generated/docusaurus-plugin-content-docs/default/p/guides-tags-partner-name-140.json",54485],"8fc53d35":[()=>r.e(76).then(r.t.bind(r,70504,19)),"/home/runner/work/developer-docs/developer-docs/.docusaurus/docusaurus-plugin-redoc/plugin-redoc-8/redocApiLayoutV1-plugin-redoc-8.json",70504],"8fff7dee":[()=>r.e(77546).then(r.t.bind(r,81948,19)),"@generated/docusaurus-plugin-content-docs/default/p/guides-tags-authentication-71d.json",81948],90480410:[()=>r.e(42031).then(r.bind(r,58323)),"@site/blog/2023-09-27.mdx",58323],"912427ea":[()=>r.e(77540).then(r.bind(r,42028)),"@site/docs/price-rules/resources/error-responses.mdx",42028],"91caa64a":[()=>Promise.all([r.e(71869),r.e(15394),r.e(85689)]).then(r.bind(r,71211)),"@site/docs/platform-integration/commercetools/headless-checkout.mdx",71211],"9248066f":[()=>r.e(7984).then(r.bind(r,77006)),"@site/blog/2026-01-05.mdx?truncated=true",77006],92663509:[()=>r.e(54323).then(r.bind(r,77379)),"@site/blog/2023-05-09.mdx",77379],"9276bcf2":[()=>r.e(56024).then(r.t.bind(r,85084,19)),"@generated/docusaurus-plugin-content-docs/default/p/guides-tags-tax-c9e.json",85084],"92bfea30":[()=>r.e(33749).then(r.bind(r,15680)),"@site/docs/price-rules/working-with-rulesets/order-condition.mdx",15680],93056085:[()=>r.e(57533).then(r.t.bind(r,67575,19)),"@generated/docusaurus-plugin-content-docs/default/p/guides-tags-klaviyo-37d.json",67575],"9324e391":[()=>r.e(68903).then(r.t.bind(r,33348,19)),"@generated/docusaurus-plugin-content-docs/default/p/guides-tags-pay-pal-116.json",33348],"93bb5d32":[()=>r.e(40087).then(r.bind(r,50343)),"@site/blog/2022-10-13.mdx?truncated=true",50343],"946ddae3":[()=>Promise.all([r.e(71869),r.e(15394),r.e(13295)]).then(r.bind(r,2750)),"@site/docs/subscriptions-v2/resources/query-pagination.mdx",2750],"965511c6":[()=>Promise.all([r.e(71869),r.e(27669)]).then(r.bind(r,38261)),"@site/docs/platform-integration/adobe-commerce/flows/paypal-checkout-flow.mdx",38261],"9669cf71":[()=>r.e(96486).then(r.bind(r,87872)),"@site/blog/2023-12-15.mdx?truncated=true",87872],"971ee163":[()=>r.e(74378).then(r.bind(r,40282)),"@site/docs/subscriptions-v2/update-subscription.mdx",40282],97430077:[()=>r.e(33590).then(r.t.bind(r,85206,19)),"@generated/docusaurus-plugin-content-blog/default/p/changelog-tags-price-rules-api-d1c.json",85206],"9745ec07":[()=>r.e(80773).then(r.bind(r,7832)),"@site/blog/2022-09-29.mdx?truncated=true",7832],"97bd5d1a":[()=>r.e(67516).then(r.bind(r,10824)),"@site/docs/checkout/concepts/sdk-integrate.mdx",10824],"9844258f":[()=>r.e(3409).then(r.bind(r,64277)),"@site/blog/2023-05-09.mdx?truncated=true",64277],"98d8c4fc":[()=>r.e(19880).then(r.bind(r,82626)),"@site/blog/2022-09-01.mdx",82626],99019399:[()=>r.e(89790).then(r.t.bind(r,93941,19)),"@generated/docusaurus-plugin-content-blog/default/p/changelog-tags-checkout-admin-ea9.json",93941],"997dc84c":[()=>Promise.all([r.e(71869),r.e(15394),r.e(72786)]).then(r.bind(r,38028)),"@site/docs/price-rules/working-with-rulesets/managing-price-rules.mdx",38028],"99d61fc7":[()=>Promise.all([r.e(71869),r.e(15394),r.e(28904)]).then(r.bind(r,88284)),"@site/docs/checkout/batch-processing.mdx",88284],"9a28d03e":[()=>r.e(24091).then(r.bind(r,29845)),"@site/docs/checkout/concepts/flows.mdx",29845],"9a98efac":[()=>r.e(45831).then(r.bind(r,96813)),"@site/blog/2023-05-01.mdx?truncated=true",96813],"9b8c43fb":[()=>r.e(49674).then(r.bind(r,86446)),"@site/blog/2023-06-12.mdx",86446],"9b99c256":[()=>r.e(10578).then(r.t.bind(r,88059,19)),"@generated/docusaurus-plugin-content-blog/default/p/changelog-tags-platform-event-notifications-976.json",88059],"9bb130ae":[()=>r.e(36854).then(r.t.bind(r,52673,19)),"@generated/docusaurus-plugin-content-docs/default/p/guides-tags-pay-pal-express-574.json",52673],"9c4defe2":[()=>r.e(42015).then(r.bind(r,15993)),"@site/blog/2023-10-10.mdx?truncated=true",15993],"9ccb8bf4":[()=>r.e(54380).then(r.bind(r,64998)),"@site/blog/2023-09-08.mdx?truncated=true",64998],"9cd69b2b":[()=>r.e(83268).then(r.bind(r,13619)),"@site/docs/checkout/checkout-getting-started.mdx",13619],"9cff32b0":[()=>r.e(50286).then(r.bind(r,39847)),"@site/blog/2025-06-11.mdx",39847],"9d41d13e":[()=>r.e(38084).then(r.bind(r,81987)),"@site/blog/2022-12-02.mdx?truncated=true",81987],"9d53b12b":[()=>r.e(82363).then(r.bind(r,6540)),"@site/docs/price-rules/working-with-rulesets/customer-targeted-pricing.mdx",6540],"9d5b7f91":[()=>r.e(84448).then(r.t.bind(r,64779,19)),"/home/runner/work/developer-docs/developer-docs/.docusaurus/docusaurus-plugin-redoc/plugin-redoc-10/redocApiSpecV1.2-plugin-redoc-10.json",64779],"9d9aa55d":[()=>r.e(9707).then(r.t.bind(r,84279,19)),"@generated/docusaurus-plugin-content-blog/default/p/changelog-tags-customers-293.json",84279],"9e4087bc":[()=>r.e(75092).then(r.bind(r,89331)),"@theme/BlogArchivePage",89331],"9e563b2a":[()=>r.e(77647).then(r.bind(r,70913)),"@site/blog/2023-05-18-1.mdx?truncated=true",70913],"9e76ce62":[()=>r.e(86850).then(r.bind(r,83617)),"@site/blog/2022-09-01-2.mdx?truncated=true",83617],"9e7f3f1d":[()=>r.e(37570).then(r.t.bind(r,23093,19)),"@generated/docusaurus-plugin-content-docs/default/p/guides-tags-coalition-technologies-857.json",23093],"9e9a0d2d":[()=>r.e(58141).then(r.bind(r,27643)),"@site/blog/2023-06-26.mdx",27643],"9ee40315":[()=>r.e(54775).then(r.t.bind(r,20563,19)),"/home/runner/work/developer-docs/developer-docs/.docusaurus/docusaurus-plugin-redoc/plugin-redoc-7/redocApiSpecV1.2-plugin-redoc-7.json",20563],"9f231082":[()=>r.e(56846).then(r.bind(r,76404)),"@site/blog/2023-04-05.mdx?truncated=true",76404],"9f2638d4":[()=>r.e(10951).then(r.bind(r,90332)),"@site/blog/2022-07-14-1.mdx",90332],"9f2b4f61":[()=>r.e(32351).then(r.bind(r,75509)),"@site/blog/2023-09-14.mdx",75509],a0788bec:[()=>r.e(99919).then(r.bind(r,30367)),"@site/docs/platform-connector/concepts/example-implementations.mdx",30367],a0d56754:[()=>r.e(39791).then(r.bind(r,92215)),"@site/blog/2023-03-27.mdx?truncated=true",92215],a0d7558c:[()=>r.e(76614).then(r.bind(r,23841)),"@site/blog/2023-07-10.mdx?truncated=true",23841],a0f19131:[()=>r.e(57389).then(r.t.bind(r,39368,19)),"@generated/docusaurus-plugin-content-blog/default/p/changelog-tags-platform-connector-203.json",39368],a14855e6:[()=>r.e(57478).then(r.t.bind(r,16717,19)),"@generated/docusaurus-plugin-content-docs/default/p/guides-tags-abandoned-cart-3a0.json",16717],a192c05c:[()=>r.e(29657).then(r.t.bind(r,45346,19)),"@generated/docusaurus-plugin-content-docs/default/p/guides-tags-partner-flow-2fe.json",45346],a197274c:[()=>Promise.all([r.e(71869),r.e(24719)]).then(r.bind(r,56271)),"@site/docs/checkout/bold-boosters/bold-booster-security.mdx",56271],a25eaad8:[()=>Promise.all([r.e(71869),r.e(89366)]).then(r.bind(r,70165)),"@site/docs/checkout/bold-boosters/set-up-google-pay.mdx",70165],a27205d3:[()=>r.e(81999).then(r.bind(r,28119)),"@site/blog/2023-08-17.mdx?truncated=true",28119],a2bcb783:[()=>r.e(15757).then(r.t.bind(r,12210,19)),"@generated/docusaurus-plugin-content-blog/default/p/changelog-tags-breaking-e9a.json",12210],a2be571e:[()=>r.e(99035).then(r.t.bind(r,27366,19)),"@generated/docusaurus-plugin-content-docs/default/p/guides-tags-search-edc.json",27366],a2eb7c70:[()=>Promise.all([r.e(71869),r.e(97336),r.e(30642),r.e(19088)]).then(r.bind(r,38040)),"@site/docs/checkout/bold-boosters/adobe-commerce-bold-booster-for-paypal.mdx",38040],a303337a:[()=>r.e(62918).then(r.bind(r,12856)),"@site/blog/2022-07-21-1.mdx",12856],a3daa7b0:[()=>r.e(87204).then(r.bind(r,75110)),"@site/blog/2024-01-18.mdx?truncated=true",75110],a3dddd39:[()=>r.e(90539).then(r.bind(r,50697)),"@site/docs/solutions/example-projects/express-pay.mdx",50697],a528a3cc:[()=>r.e(52333).then(r.bind(r,53979)),"@site/docs/price-rules/working-with-rulesets/multi-currency.mdx",53979],a63248c6:[()=>Promise.all([r.e(71869),r.e(15394),r.e(8670)]).then(r.bind(r,68838)),"@site/docs/platform-connector/rsa/create-checkout-rsa.mdx",68838],a6705120:[()=>r.e(27271).then(r.bind(r,4790)),"@site/docs/checkout/concepts/external-payment-gateways.mdx",4790],a6aa9e1f:[()=>Promise.all([r.e(71869),r.e(15394),r.e(73019),r.e(3671),r.e(37643)]).then(r.bind(r,38695)),"@theme/BlogListPage",38695],a7456010:[()=>r.e(61235).then(r.t.bind(r,88552,19)),"@generated/docusaurus-plugin-content-pages/default/__plugin.json",88552],a78c8291:[()=>r.e(3532).then(r.bind(r,93311)),"@site/blog/2022-10-19.mdx",93311],a7a2b072:[()=>r.e(52835).then(r.bind(r,47186)),"@site/blog/2024-01-18.mdx",47186],a7bd4aaa:[()=>r.e(67098).then(r.bind(r,74532)),"@theme/DocVersionRoot",74532],a83018f9:[()=>r.e(94985).then(r.bind(r,81379)),"@site/blog/2024-09-17.mdx?truncated=true",81379],a86d2051:[()=>r.e(62442).then(r.bind(r,28979)),"@site/blog/2023-10-27.mdx?truncated=true",28979],a8a331c2:[()=>r.e(59007).then(r.bind(r,9225)),"@site/blog/2024-08-29.mdx",9225],a94703ab:[()=>Promise.all([r.e(71869),r.e(79048)]).then(r.bind(r,16403)),"@theme/DocRoot",16403],a9ce9108:[()=>r.e(15799).then(r.bind(r,52790)),"@site/docs/price-rules/errors.mdx",52790],aa48e5f4:[()=>Promise.all([r.e(71869),r.e(15394),r.e(17589)]).then(r.bind(r,92312)),"@site/docs/price-rules/resources/api-versioning.mdx",92312],aab1e628:[()=>r.e(34345).then(r.bind(r,83161)),"@site/blog/2022-11-14.mdx",83161],ab91e59b:[()=>r.e(30743).then(r.bind(r,74949)),"@site/blog/2023-08-08.mdx",74949],aba21aa0:[()=>r.e(35742).then(r.t.bind(r,27093,19)),"@generated/docusaurus-plugin-content-docs/default/__plugin.json",27093],acecf23e:[()=>r.e(81903).then(r.t.bind(r,1912,19)),"~blog/default/blogMetadata-default.json",1912],ad678fe2:[()=>r.e(33326).then(r.bind(r,63855)),"@site/blog/2023-05-18-1.mdx",63855],ad7bbdbe:[()=>r.e(19454).then(r.t.bind(r,4715,19)),"@generated/docusaurus-plugin-content-docs/default/p/guides-tags-epg-478.json",4715],ad939425:[()=>r.e(75416).then(r.bind(r,1099)),"@site/docs/archive/subscriptions_v1_integration.mdx",1099],ade24b0f:[()=>r.e(75621).then(r.bind(r,183)),"@site/docs/subscriptions-v2/resources/glossary.mdx",183],aea16c7b:[()=>r.e(44777).then(r.bind(r,41320)),"@site/docs/price-rules/attributes.mdx",41320],af2f28d9:[()=>r.e(49561).then(r.t.bind(r,27119,19)),"@generated/docusaurus-plugin-content-docs/default/p/guides-tags-technology-partner-de1.json",27119],b05b71ff:[()=>r.e(4444).then(r.bind(r,35759)),"@site/blog/2022-09-01-2.mdx",35759],b0a78326:[()=>r.e(83598).then(r.bind(r,87727)),"@site/blog/2023-07-10.mdx",87727],b124425c:[()=>r.e(1812).then(r.bind(r,84098)),"@site/docs/price-rules/working-with-rulesets/cart-level-promotions.mdx",84098],b173a2ed:[()=>r.e(82916).then(r.bind(r,61921)),"@site/blog/2024-09-17.mdx",61921],b199e59c:[()=>r.e(48296).then(r.bind(r,9207)),"@site/docs/subscriptions-v2/resources/access-scopes.mdx",9207],b22514be:[()=>r.e(30288).then(r.bind(r,51953)),"@site/docs/checkout/metrics.mdx",51953],b2f8de63:[()=>r.e(31337).then(r.bind(r,43031)),"@site/blog/2023-09-14.mdx?truncated=true",43031],b3ce1b9a:[()=>r.e(98513).then(r.bind(r,71357)),"@site/docs/solutions/blueprints/blog.mdx",71357],b3cefefd:[()=>r.e(90459).then(r.t.bind(r,443,19)),"/home/runner/work/developer-docs/developer-docs/.docusaurus/docusaurus-plugin-redoc/plugin-redoc-3/redocApiSpecV1.2-plugin-redoc-3.json",443],b3ece874:[()=>r.e(52772).then(r.bind(r,22131)),"@site/docs/subscriptions-v2/create-subscription.mdx",22131],b446a5cd:[()=>r.e(16984).then(r.bind(r,74599)),"@site/docs/archive/cashier.mdx",74599],b48837db:[()=>Promise.all([r.e(71869),r.e(15394),r.e(9745)]).then(r.bind(r,9e4)),"@site/docs/price-rules/resources/query-pagination.mdx",9e4],b4b562b3:[()=>r.e(26339).then(r.bind(r,82056)),"@site/docs/price-rules/working-with-rulesets/quantity-pricing.mdx",82056],b5a1fff4:[()=>r.e(50024).then(r.bind(r,86737)),"@site/blog/2023-09-18.mdx",86737],b5ae6c76:[()=>r.e(17272).then(r.t.bind(r,7596,19)),"@generated/docusaurus-plugin-redoc/plugin-redoc-6/__plugin.json",7596],b5cf0462:[()=>r.e(66167).then(r.bind(r,69382)),"@site/blog/2025-11-18.mdx",69382],b604ae7d:[()=>r.e(93288).then(r.bind(r,62948)),"@site/docs/solutions/example-projects/template.mdx",62948],b6a4bacf:[()=>r.e(74504).then(r.bind(r,50287)),"@site/docs/platform-integration/adobe-commerce/concepts.mdx",50287],b7a80d23:[()=>r.e(23760).then(r.bind(r,89959)),"@site/blog/2024-03-28.mdx?truncated=true",89959],b7ca5550:[()=>r.e(31359).then(r.bind(r,51418)),"@site/blog/2023-10-11.mdx",51418],b81f1e7f:[()=>r.e(80522).then(r.bind(r,11959)),"@site/blog/2023-06-20.mdx?truncated=true",11959],b8285721:[()=>r.e(97060).then(r.bind(r,94654)),"@site/docs/solutions/bold-built/ppcp.mdx",94654],b8669604:[()=>r.e(71008).then(r.bind(r,25307)),"@site/blog/2022-10-17.mdx?truncated=true",25307],b869ded7:[()=>r.e(41400).then(r.bind(r,51685)),"@site/blog/2023-09-27.mdx?truncated=true",51685],b86cec8a:[()=>r.e(24541).then(r.bind(r,11048)),"@site/docs/price-rules/references/conditions.mdx",11048],b884ce28:[()=>r.e(56143).then(r.bind(r,16415)),"@site/blog/2023-07-14-1.mdx?truncated=true",16415],b888eae5:[()=>r.e(95301).then(r.t.bind(r,93402,19)),"@generated/docusaurus-plugin-content-docs/default/p/guides-tags-861.json",93402],b8e1ab90:[()=>r.e(24321).then(r.bind(r,89036)),"@site/docs/solutions/blueprints/biometric-auth.mdx",89036],b8f2801a:[()=>r.e(66351).then(r.bind(r,85501)),"@site/blog/2023-06-13.mdx?truncated=true",85501],b98e68af:[()=>r.e(4138).then(r.bind(r,28462)),"@site/blog/2023-10-11.mdx?truncated=true",28462],b99e9454:[()=>r.e(47278).then(r.t.bind(r,27826,19)),"@generated/docusaurus-plugin-content-docs/default/p/guides-tags-magento-open-source-385.json",27826],ba2bc9d2:[()=>r.e(82470).then(r.bind(r,63931)),"@site/blog/2023-05-01.mdx",63931],ba74812c:[()=>r.e(21457).then(r.bind(r,13280)),"@site/docs/checkout/resources/access-scopes.mdx",13280],bb59d0d3:[()=>r.e(7066).then(r.bind(r,62531)),"@site/docs/platform-connector/concepts/components.mdx",62531],bbef2544:[()=>r.e(36173).then(r.bind(r,90388)),"@site/docs/price-rules/additional-resources.mdx",90388],bc062e45:[()=>r.e(53986).then(r.bind(r,61201)),"@site/blog/2024-04-23.mdx?truncated=true",61201],bd3a9dee:[()=>r.e(932).then(r.t.bind(r,52448,19)),"@generated/docusaurus-plugin-content-blog/default/p/changelog-tags-subscriptions-80f.json",52448],bd414280:[()=>r.e(3714).then(r.bind(r,11622)),"@site/blog/2023-03-02.mdx",11622],bd465c5a:[()=>r.e(22233).then(r.t.bind(r,15729,19)),"@generated/docusaurus-plugin-content-docs/default/p/guides-tags-braintree-504.json",15729],be7ad25d:[()=>r.e(20221).then(r.t.bind(r,72359,19)),"@generated/docusaurus-plugin-content-docs/default/p/guides-tags-m-1-27c.json",72359],bee00323:[()=>r.e(89889).then(r.bind(r,89896)),"@site/blog/2022-12-14.mdx",89896],bf2c76ca:[()=>r.e(13645).then(r.bind(r,66856)),"@site/docs/price-rules/debug-tools.mdx",66856],bf3692be:[()=>r.e(56454).then(r.t.bind(r,29683,19)),"@generated/docusaurus-plugin-content-blog/default/p/changelog-tags-non-breaking-9cb.json",29683],c02a1c6d:[()=>r.e(73475).then(r.bind(r,20185)),"@site/blog/2024-01-17.mdx",20185],c07e63c6:[()=>r.e(89836).then(r.bind(r,61718)),"@site/docs/platform-connector/event-notifications.mdx",61718],c0b19e3f:[()=>r.e(95564).then(r.bind(r,35262)),"@site/blog/2024-07-16.mdx",35262],c141421f:[()=>r.e(80957).then(r.t.bind(r,40936,19)),"@generated/docusaurus-theme-search-algolia/default/__plugin.json",40936],c2030439:[()=>r.e(70251).then(r.bind(r,54512)),"@site/blog/2022-12-02-01.mdx?truncated=true",54512],c2e3b439:[()=>r.e(99850).then(r.t.bind(r,10711,19)),"/home/runner/work/developer-docs/developer-docs/.docusaurus/docusaurus-plugin-redoc/plugin-redoc-12/redocApiSpecV1.2-plugin-redoc-12.json",10711],c3fed1b4:[()=>r.e(32673).then(r.t.bind(r,29647,19)),"@generated/docusaurus-plugin-content-docs/default/p/guides-tags-harry-rosen-995.json",29647],c44b1e9c:[()=>r.e(16866).then(r.bind(r,64737)),"@site/docs/subscriptions-v2/index.mdx",64737],c45bc5c9:[()=>r.e(72755).then(r.t.bind(r,30411,19)),"@generated/docusaurus-plugin-content-docs/default/p/guides-tags-authenticated-checkout-443.json",30411],c4aab958:[()=>r.e(54856).then(r.bind(r,39725)),"@site/blog/2023-12-07.mdx",39725],c4babf09:[()=>r.e(90660).then(r.bind(r,90849)),"@site/blog/2022-12-02.mdx",90849],c6439732:[()=>r.e(1944).then(r.bind(r,89394)),"@site/blog/2023-09-22.mdx",89394],c6b52414:[()=>r.e(22474).then(r.bind(r,1655)),"@site/blog/2023-01-09.mdx",1655],c7b47c12:[()=>r.e(47068).then(r.bind(r,31158)),"@site/blog/2023-01-17.mdx?truncated=true",31158],c9b891a5:[()=>r.e(11177).then(r.bind(r,11791)),"@site/docs/platform-integration/adobe-commerce/generate-module-list.mdx",11791],ca303fc0:[()=>Promise.all([r.e(71869),r.e(15394),r.e(76220)]).then(r.bind(r,10383)),"@site/docs/checkout/resources/api-versioning.mdx",10383],ca705e0e:[()=>r.e(1145).then(r.bind(r,90793)),"@site/blog/2023-04-04-1.mdx?truncated=true",90793],ca8f2d2f:[()=>r.e(28655).then(r.bind(r,70354)),"@site/blog/2023-09-08.mdx",70354],cae1db01:[()=>r.e(14218).then(r.bind(r,77077)),"@site/blog/2023-05-23.mdx?truncated=true",77077],cbb13b52:[()=>r.e(45410).then(r.t.bind(r,50599,19)),"@generated/docusaurus-plugin-content-docs/default/p/guides-tags-customer-management-system-e33.json",50599],cc10feb9:[()=>r.e(6146).then(r.bind(r,23283)),"@site/blog/2023-09-18.mdx?truncated=true",23283],cc6ce636:[()=>r.e(66514).then(r.bind(r,13146)),"@site/blog/2026-01-05.mdx",13146],ccc49370:[()=>Promise.all([r.e(71869),r.e(15394),r.e(73019),r.e(3671),r.e(83249)]).then(r.bind(r,96654)),"@theme/BlogPostPage",96654],ccd7d0a7:[()=>Promise.all([r.e(71869),r.e(15394),r.e(50942)]).then(r.bind(r,2634)),"@site/docs/checkout/api-overrides.mdx",2634],cd41bd37:[()=>r.e(35243).then(r.t.bind(r,14997,19)),"@generated/docusaurus-plugin-content-docs/default/p/guides-tags-wallet-pay-a9c.json",14997],cd94f1bf:[()=>Promise.all([r.e(71869),r.e(97336),r.e(74210)]).then(r.bind(r,37110)),"@site/docs/checkout/bold-boosters/adobe-commerce-bold-booster-for-intuit.mdx",37110],ce0e948e:[()=>r.e(57828).then(r.t.bind(r,38534,19)),"@generated/docusaurus-plugin-content-docs/default/p/guides-tags-constructor-5f3.json",38534],ce3e7135:[()=>r.e(78159).then(r.bind(r,41059)),"@site/docs/subscriptions-v2/resources/rate-limiting.mdx",41059],cea66e72:[()=>r.e(34882).then(r.bind(r,49667)),"@site/docs/platform-connector/rsa/concepts.mdx",49667],d1823e81:[()=>Promise.all([r.e(71869),r.e(15394),r.e(98133)]).then(r.bind(r,84754)),"@site/docs/checkout/life.mdx",84754],d1f32d91:[()=>Promise.all([r.e(71869),r.e(97336),r.e(30642),r.e(95211)]).then(r.bind(r,63893)),"@site/docs/checkout/bold-boosters/opencart-bold-booster-for-paypal.mdx",63893],d20844df:[()=>r.e(85611).then(r.bind(r,23883)),"@site/blog/2023-07-25.mdx",23883],d29d1d7a:[()=>r.e(58125).then(r.bind(r,36663)),"@site/docs/solutions/blueprints/search-algolia.mdx",36663],d32cb31c:[()=>r.e(17748).then(r.t.bind(r,43980,19)),"@generated/docusaurus-plugin-content-docs/default/p/guides-tags-taxes-2e4.json",43980],d419bba6:[()=>Promise.all([r.e(71869),r.e(15394),r.e(16668)]).then(r.bind(r,76486)),"@site/docs/subscriptions-v2/customer-portals/index.mdx",76486],d4a571fe:[()=>r.e(61934).then(r.bind(r,28557)),"@site/blog/2023-06-26.mdx?truncated=true",28557],d4ad433e:[()=>Promise.all([r.e(71869),r.e(15394),r.e(97951)]).then(r.bind(r,12561)),"@site/docs/platform-connector/create-server.mdx",12561],d5928064:[()=>r.e(95105).then(r.bind(r,17601)),"@site/docs/price-rules/resources/glossary.mdx",17601],d717ef1e:[()=>r.e(76019).then(r.bind(r,87573)),"@site/blog/2023-08-17.mdx",87573],d71ba929:[()=>r.e(59544).then(r.bind(r,16579)),"@site/docs/archive/gravity-forms-upgrade.mdx",16579],d84edb4a:[()=>r.e(75289).then(r.bind(r,31289)),"@site/blog/2023-04-21-2.mdx?truncated=true",31289],d8f72ea6:[()=>r.e(21448).then(r.t.bind(r,64971,19)),"@generated/docusaurus-plugin-redoc/plugin-redoc-1/__plugin.json",64971],d8ffd1c8:[()=>r.e(76995).then(r.t.bind(r,36171,19)),"@generated/docusaurus-plugin-content-blog/default/p/changelog-tags-remote-state-authority-82c.json",36171],d9d97ff6:[()=>r.e(69652).then(r.bind(r,47889)),"@site/docs/price-rules/resources/rate-limiting.mdx",47889],da39a912:[()=>r.e(54905).then(r.bind(r,44711)),"@site/blog/2023-05-18.mdx?truncated=true",44711],db81c444:[()=>r.e(69813).then(r.t.bind(r,50669,19)),"@generated/docusaurus-plugin-content-docs/default/p/guides-tags-magento-2-245.json",50669],dc8a0d0a:[()=>r.e(26044).then(r.bind(r,37479)),"@site/docs/checkout/self-hosted-flow.mdx",37479],dd1548e1:[()=>Promise.all([r.e(71869),r.e(79943)]).then(r.bind(r,38438)),"@site/docs/checkout/bold-boosters/connect-ppcp.mdx",38438],dd8d5f79:[()=>Promise.all([r.e(71869),r.e(15394),r.e(48362)]).then(r.bind(r,67172)),"@site/docs/checkout/quick-start.mdx",67172],ddcc9d85:[()=>Promise.all([r.e(71869),r.e(15394),r.e(77599)]).then(r.bind(r,73358)),"@site/docs/checkout/index.mdx",73358],de4eb00a:[()=>r.e(79516).then(r.bind(r,43265)),"@site/docs/platform-connector/index.mdx",43265],df203c0f:[()=>Promise.all([r.e(71869),r.e(24279)]).then(r.bind(r,45921)),"@theme/DocTagDocListPage",45921],df7b49fc:[()=>Promise.all([r.e(71869),r.e(55866)]).then(r.bind(r,23404)),"@site/docs/checkout/bold-boosters/connect-intuit.mdx",23404],df856fe9:[()=>r.e(47506).then(r.bind(r,72373)),"@site/blog/2023-06-20.mdx",72373],dfab1666:[()=>r.e(68461).then(r.t.bind(r,67960,19)),"@generated/docusaurus-plugin-content-docs/default/p/guides-tags-commercetools-7fa.json",67960],e0696fb7:[()=>r.e(66902).then(r.bind(r,95168)),"@site/blog/2023-01-20.mdx",95168],e1b4cc2a:[()=>r.e(45666).then(r.bind(r,68497)),"@site/blog/2023-11-22.mdx?truncated=true",68497],e234bc08:[()=>r.e(97298).then(r.bind(r,19206)),"@site/blog/2023-02-01.mdx?truncated=true",19206],e23639f1:[()=>r.e(31886).then(r.t.bind(r,56570,19)),"@generated/docusaurus-plugin-content-docs/default/p/guides-tags-product-information-system-2b0.json",56570],e289a6a6:[()=>r.e(3759).then(r.bind(r,79608)),"@site/docs/price-rules/references/product-selection.mdx",79608],e2f77e55:[()=>r.e(36953).then(r.t.bind(r,6041,19)),"@generated/docusaurus-plugin-content-docs/default/p/guides-tags-self-hosted-704.json",6041],e345cd47:[()=>r.e(48152).then(r.bind(r,56899)),"@site/docs/price-rules/discount-codes.mdx",56899],e346b4e3:[()=>r.e(77723).then(r.t.bind(r,45673,19)),"@generated/docusaurus-plugin-content-docs/default/p/guides-tags-stripe-105.json",45673],e3728c6a:[()=>r.e(59116).then(r.bind(r,35228)),"@site/docs/solutions/bold-built/stripe.mdx",35228],e3c82674:[()=>Promise.all([r.e(71869),r.e(45987)]).then(r.bind(r,54614)),"@site/docs/platform-connector/requirements.mdx",54614],e3e6ed5f:[()=>r.e(29360).then(r.bind(r,40970)),"@site/blog/2022-10-25.mdx?truncated=true",40970],e405f8b6:[()=>r.e(52123).then(r.bind(r,45481)),"@site/blog/2023-01-09.mdx?truncated=true",45481],e477976f:[()=>r.e(55466).then(r.bind(r,67555)),"@site/blog/2023-05-23.mdx",67555],e521f622:[()=>r.e(71814).then(r.bind(r,62906)),"@site/docs/solutions/blueprints/abandoned-cart.mdx",62906],e66966b6:[()=>r.e(30785).then(r.t.bind(r,16283,19)),"@generated/docusaurus-plugin-content-docs/default/p/guides-tags-pre-purchase-upsell-ec6.json",16283],e683eb15:[()=>r.e(24658).then(r.bind(r,54349)),"@site/docs/checkout/references/checkout-spi-api.mdx",54349],e7a0a125:[()=>r.e(3541).then(r.t.bind(r,91668,19)),"@generated/docusaurus-plugin-content-docs/default/p/guides-tags-oracle-b00.json",91668],e7c38046:[()=>r.e(49739).then(r.bind(r,50481)),"@site/docs/checkout/references/epg-actions-events.mdx",50481],e8d9fb00:[()=>r.e(83057).then(r.t.bind(r,93358,19)),"@generated/docusaurus-plugin-content-blog/default/p/changelog-tags-checkout-frontend-0d3.json",93358],e9134af7:[()=>r.e(46357).then(r.bind(r,96630)),"@site/blog/2022-09-01.mdx?truncated=true",96630],e9851743:[()=>r.e(15567).then(r.bind(r,37542)),"@site/docs/price-rules/working-with-rulesets/discount-codes.mdx",37542],e9e355a7:[()=>r.e(97675).then(r.bind(r,79192)),"@site/blog/2023-11-21.mdx",79192],ea654927:[()=>r.e(49538).then(r.t.bind(r,82710,19)),"@generated/docusaurus-plugin-content-docs/default/p/guides-tags-checkout-flows-6c5.json",82710],eab034cd:[()=>r.e(74107).then(r.bind(r,15771)),"@site/blog/2022-11-14.mdx?truncated=true",15771],ec838b08:[()=>Promise.all([r.e(71869),r.e(15394),r.e(15986)]).then(r.bind(r,17901)),"@site/docs/checkout/populate-order.mdx",17901],ee3c4f27:[()=>Promise.all([r.e(71869),r.e(98384)]).then(r.bind(r,47265)),"@site/docs/platform-integration/adobe-commerce/overview.mdx",47265],efb12385:[()=>r.e(85461).then(r.bind(r,10681)),"@site/blog/2022-10-17.mdx",10681],efedbf87:[()=>r.e(10690).then(r.bind(r,17582)),"@site/docs/platform-connector/verify.mdx",17582],f04f4b9f:[()=>r.e(20332).then(r.bind(r,77025)),"@site/blog/2023-08-22.mdx",77025],f0ad3fbb:[()=>Promise.all([r.e(71869),r.e(73019),r.e(96923),r.e(42969)]).then(r.bind(r,53452)),"@theme/ApiDoc",53452],f0fd16fd:[()=>r.e(576).then(r.bind(r,77010)),"@site/docs/price-rules/references/ruleset-properties.mdx",77010],f10edb4a:[()=>r.e(69358).then(r.bind(r,23699)),"@site/docs/platform-connector/concepts/index.mdx",23699],f15bd786:[()=>r.e(15288).then(r.t.bind(r,59986,19)),"@generated/docusaurus-plugin-redoc/plugin-redoc-8/__plugin.json",59986],f1727f22:[()=>r.e(10124).then(r.bind(r,56426)),"@site/docs/subscriptions-v2/widgets.mdx",56426],f2001abc:[()=>r.e(712).then(r.bind(r,98405)),"@site/docs/price-rules/headless-storefront-setup.mdx",98405],f2679230:[()=>r.e(55354).then(r.bind(r,53977)),"@site/blog/2025-06-11.mdx?truncated=true",53977],f30c5500:[()=>r.e(91887).then(r.bind(r,24214)),"@site/docs/platform-integration/shopify/pre.mdx",24214],f33863cd:[()=>r.e(40067).then(r.bind(r,49798)),"@site/docs/checkout/references/plugin-events.mdx",49798],f37d7194:[()=>Promise.all([r.e(71869),r.e(15394),r.e(6056)]).then(r.bind(r,18583)),"@site/docs/price-rules/promotion-info.mdx",18583],f6208f34:[()=>r.e(78530).then(r.bind(r,60818)),"@site/blog/2023-08-29.mdx?truncated=true",60818],f6ec2898:[()=>r.e(44134).then(r.t.bind(r,7937,19)),"@generated/docusaurus-plugin-redoc/plugin-redoc-10/__plugin.json",7937],f8b42268:[()=>r.e(96185).then(r.t.bind(r,11031,19)),"@generated/docusaurus-plugin-content-docs/default/p/guides-tags-purchase-from-blog-781.json",11031],f94f984b:[()=>r.e(52259).then(r.t.bind(r,14008,19)),"/home/runner/work/developer-docs/developer-docs/.docusaurus/docusaurus-plugin-redoc/plugin-redoc-5/redocApiLayoutV1-plugin-redoc-5.json",14008],f970d283:[()=>r.e(26336).then(r.t.bind(r,82513,19)),"/home/runner/work/developer-docs/developer-docs/.docusaurus/docusaurus-plugin-redoc/plugin-redoc-11/redocApiSpecV1.2-plugin-redoc-11.json",82513],f97cd861:[()=>r.e(85729).then(r.bind(r,31944)),"@site/docs/checkout/resources/rate-limiting.mdx",31944],fac0a29f:[()=>r.e(97153).then(r.t.bind(r,38356,19)),"@generated/docusaurus-plugin-content-docs/default/p/guides-tags-ecommerce-platform-cc6.json",38356],fba0f0eb:[()=>r.e(86963).then(r.bind(r,48750)),"@site/blog/2023-07-24.mdx",48750],fc339e87:[()=>r.e(36813).then(r.bind(r,22312)),"@site/blog/2024-03-25.mdx?truncated=true",22312],fcb14d23:[()=>Promise.all([r.e(71869),r.e(15394),r.e(4564)]).then(r.bind(r,29863)),"@site/docs/subscriptions-v2/quick-start.mdx",29863],fd2cf4d0:[()=>Promise.all([r.e(71869),r.e(15394),r.e(21766)]).then(r.bind(r,11422)),"@site/docs/price-rules/public-integrations.mdx",11422],fda6331f:[()=>r.e(95).then(r.bind(r,95570)),"@site/blog/2023-06-12.mdx?truncated=true",95570],fdba9f39:[()=>Promise.all([r.e(71869),r.e(97336),r.e(49163)]).then(r.bind(r,97601)),"@site/docs/checkout/bold-boosters/gravity-forms-bold-booster-for-paypal.mdx",97601],fe0fceb1:[()=>r.e(51253).then(r.bind(r,82218)),"@site/docs/solutions/bold-built/payment-booster.mdx",82218],fe4b5782:[()=>r.e(62884).then(r.bind(r,1298)),"@site/blog/2023-07-24.mdx?truncated=true",1298],ff5a0d38:[()=>r.e(28588).then(r.t.bind(r,56987,19)),"@generated/docusaurus-plugin-redoc/plugin-redoc-12/__plugin.json",56987]};var a=r(74848);function c(e){let{error:t,retry:r,pastDelay:n}=e;return t?(0,a.jsxs)("div",{style:{textAlign:"center",color:"#fff",backgroundColor:"#fa383e",borderColor:"#fa383e",borderStyle:"solid",borderRadius:"0.25rem",borderWidth:"1px",boxSizing:"border-box",display:"block",padding:"1rem",flex:"0 0 50%",marginLeft:"25%",marginRight:"25%",marginTop:"5rem",maxWidth:"50%",width:"100%"},children:[(0,a.jsx)("p",{children:String(t)}),(0,a.jsx)("div",{children:(0,a.jsx)("button",{type:"button",onClick:r,children:"Retry"})})]}):n?(0,a.jsx)("div",{style:{display:"flex",justifyContent:"center",alignItems:"center",height:"100vh"},children:(0,a.jsx)("svg",{id:"loader",style:{width:128,height:110,position:"absolute",top:"calc(100vh - 64%)"},viewBox:"0 0 45 45",xmlns:"http://www.w3.org/2000/svg",stroke:"#61dafb",children:(0,a.jsxs)("g",{fill:"none",fillRule:"evenodd",transform:"translate(1 1)",strokeWidth:"2",children:[(0,a.jsxs)("circle",{cx:"22",cy:"22",r:"6",strokeOpacity:"0",children:[(0,a.jsx)("animate",{attributeName:"r",begin:"1.5s",dur:"3s",values:"6;22",calcMode:"linear",repeatCount:"indefinite"}),(0,a.jsx)("animate",{attributeName:"stroke-opacity",begin:"1.5s",dur:"3s",values:"1;0",calcMode:"linear",repeatCount:"indefinite"}),(0,a.jsx)("animate",{attributeName:"stroke-width",begin:"1.5s",dur:"3s",values:"2;0",calcMode:"linear",repeatCount:"indefinite"})]}),(0,a.jsxs)("circle",{cx:"22",cy:"22",r:"6",strokeOpacity:"0",children:[(0,a.jsx)("animate",{attributeName:"r",begin:"3s",dur:"3s",values:"6;22",calcMode:"linear",repeatCount:"indefinite"}),(0,a.jsx)("animate",{attributeName:"stroke-opacity",begin:"3s",dur:"3s",values:"1;0",calcMode:"linear",repeatCount:"indefinite"}),(0,a.jsx)("animate",{attributeName:"stroke-width",begin:"3s",dur:"3s",values:"2;0",calcMode:"linear",repeatCount:"indefinite"})]}),(0,a.jsx)("circle",{cx:"22",cy:"22",r:"8",children:(0,a.jsx)("animate",{attributeName:"r",begin:"0s",dur:"1.5s",values:"6;1;2;3;4;5;6",calcMode:"linear",repeatCount:"indefinite"})})]})})}):null}var p=r(86921),d=r(53102);function l(e,t){if("*"===e)return o()({loading:c,loader:()=>r.e(82237).then(r.bind(r,82237)),modules:["@theme/NotFound"],webpack:()=>[82237],render(e,t){const r=e.default;return(0,a.jsx)(d.W,{value:{plugin:{name:"native",id:"default"}},children:(0,a.jsx)(r,{...t})})}});const n=i[`${e}-${t}`],l={},u=[],m=[],h=(0,p.A)(n);return Object.entries(h).forEach((e=>{let[t,r]=e;const n=s[r];n&&(l[t]=n[0],u.push(n[1]),m.push(n[2]))})),o().Map({loading:c,loader:l,modules:u,webpack:()=>m,render(t,r){const o=JSON.parse(JSON.stringify(n));Object.entries(t).forEach((t=>{let[r,n]=t;const i=n.default;if(!i)throw new Error(`The page component at ${e} doesn't have a default export. This makes it impossible to render anything. Consider default-exporting a React component.`);"object"!=typeof i&&"function"!=typeof i||Object.keys(n).filter((e=>"default"!==e)).forEach((e=>{i[e]=n[e]}));let s=o;const a=r.split(".");a.slice(0,-1).forEach((e=>{s=s[e]})),s[a[a.length-1]]=i}));const i=o.__comp;delete o.__comp;const s=o.__context;delete o.__context;const c=o.__props;return delete o.__props,(0,a.jsx)(d.W,{value:s,children:(0,a.jsx)(i,{...o,...c,...r})})}})}const u=[{path:"/api-specifications",component:l("/api-specifications","90c"),exact:!0},{path:"/api/checkout",component:l("/api/checkout","a9c"),exact:!0},{path:"/api/checkout-admin",component:l("/api/checkout-admin","62b"),exact:!0},{path:"/api/checkout-flows",component:l("/api/checkout-flows","fba"),exact:!0},{path:"/api/checkout-rsa",component:l("/api/checkout-rsa","536"),exact:!0},{path:"/api/customers",component:l("/api/customers","484"),exact:!0},{path:"/api/orders",component:l("/api/orders","8ca"),exact:!0},{path:"/api/platform-connector",component:l("/api/platform-connector","ead"),exact:!0},{path:"/api/platform-connector-destinations",component:l("/api/platform-connector-destinations","6dc"),exact:!0},{path:"/api/platform-event-notifications",component:l("/api/platform-event-notifications","483"),exact:!0},{path:"/api/price-rules",component:l("/api/price-rules","f65"),exact:!0},{path:"/api/products",component:l("/api/products","27f"),exact:!0},{path:"/api/shops",component:l("/api/shops","6c5"),exact:!0},{path:"/api/subscriptions",component:l("/api/subscriptions","7a6"),exact:!0},{path:"/changelog",component:l("/changelog","162"),exact:!0},{path:"/changelog/2022/07/11",component:l("/changelog/2022/07/11","ea9"),exact:!0},{path:"/changelog/2022/07/14/1",component:l("/changelog/2022/07/14/1","eaf"),exact:!0},{path:"/changelog/2022/07/21/1",component:l("/changelog/2022/07/21/1","a77"),exact:!0},{path:"/changelog/2022/07/29",component:l("/changelog/2022/07/29","f93"),exact:!0},{path:"/changelog/2022/08/02",component:l("/changelog/2022/08/02","1ee"),exact:!0},{path:"/changelog/2022/09/01",component:l("/changelog/2022/09/01","c93"),exact:!0},{path:"/changelog/2022/09/01/2",component:l("/changelog/2022/09/01/2","116"),exact:!0},{path:"/changelog/2022/09/13",component:l("/changelog/2022/09/13","dee"),exact:!0},{path:"/changelog/2022/09/16",component:l("/changelog/2022/09/16","183"),exact:!0},{path:"/changelog/2022/09/23",component:l("/changelog/2022/09/23","b43"),exact:!0},{path:"/changelog/2022/09/27",component:l("/changelog/2022/09/27","02a"),exact:!0},{path:"/changelog/2022/09/29",component:l("/changelog/2022/09/29","d54"),exact:!0},{path:"/changelog/2022/10/13",component:l("/changelog/2022/10/13","141"),exact:!0},{path:"/changelog/2022/10/17",component:l("/changelog/2022/10/17","f91"),exact:!0},{path:"/changelog/2022/10/18/1",component:l("/changelog/2022/10/18/1","ed1"),exact:!0},{path:"/changelog/2022/10/19",component:l("/changelog/2022/10/19","d09"),exact:!0},{path:"/changelog/2022/10/25",component:l("/changelog/2022/10/25","a58"),exact:!0},{path:"/changelog/2022/10/31",component:l("/changelog/2022/10/31","ffd"),exact:!0},{path:"/changelog/2022/11/10",component:l("/changelog/2022/11/10","953"),exact:!0},{path:"/changelog/2022/11/14",component:l("/changelog/2022/11/14","7bf"),exact:!0},{path:"/changelog/2022/12/02",component:l("/changelog/2022/12/02","f53"),exact:!0},{path:"/changelog/2022/12/02/01",component:l("/changelog/2022/12/02/01","434"),exact:!0},{path:"/changelog/2022/12/02/2",component:l("/changelog/2022/12/02/2","d37"),exact:!0},{path:"/changelog/2022/12/14",component:l("/changelog/2022/12/14","4cf"),exact:!0},{path:"/changelog/2022/12/23",component:l("/changelog/2022/12/23","4a5"),exact:!0},{path:"/changelog/2023/01/09",component:l("/changelog/2023/01/09","15e"),exact:!0},{path:"/changelog/2023/01/17",component:l("/changelog/2023/01/17","054"),exact:!0},{path:"/changelog/2023/01/20",component:l("/changelog/2023/01/20","49b"),exact:!0},{path:"/changelog/2023/02/01",component:l("/changelog/2023/02/01","a68"),exact:!0},{path:"/changelog/2023/02/07",component:l("/changelog/2023/02/07","832"),exact:!0},{path:"/changelog/2023/03/02",component:l("/changelog/2023/03/02","fa4"),exact:!0},{path:"/changelog/2023/03/07",component:l("/changelog/2023/03/07","1d9"),exact:!0},{path:"/changelog/2023/03/09",component:l("/changelog/2023/03/09","000"),exact:!0},{path:"/changelog/2023/03/27",component:l("/changelog/2023/03/27","9d0"),exact:!0},{path:"/changelog/2023/04/04",component:l("/changelog/2023/04/04","83c"),exact:!0},{path:"/changelog/2023/04/04/1",component:l("/changelog/2023/04/04/1","7fd"),exact:!0},{path:"/changelog/2023/04/05",component:l("/changelog/2023/04/05","c84"),exact:!0},{path:"/changelog/2023/04/21",component:l("/changelog/2023/04/21","05a"),exact:!0},{path:"/changelog/2023/04/21/1",component:l("/changelog/2023/04/21/1","040"),exact:!0},{path:"/changelog/2023/04/21/2",component:l("/changelog/2023/04/21/2","254"),exact:!0},{path:"/changelog/2023/05/01",component:l("/changelog/2023/05/01","1ea"),exact:!0},{path:"/changelog/2023/05/02",component:l("/changelog/2023/05/02","265"),exact:!0},{path:"/changelog/2023/05/09",component:l("/changelog/2023/05/09","da5"),exact:!0},{path:"/changelog/2023/05/10",component:l("/changelog/2023/05/10","53a"),exact:!0},{path:"/changelog/2023/05/18",component:l("/changelog/2023/05/18","cfe"),exact:!0},{path:"/changelog/2023/05/18/1",component:l("/changelog/2023/05/18/1","386"),exact:!0},{path:"/changelog/2023/05/18/2",component:l("/changelog/2023/05/18/2","6b6"),exact:!0},{path:"/changelog/2023/05/23",component:l("/changelog/2023/05/23","5ba"),exact:!0},{path:"/changelog/2023/05/26",component:l("/changelog/2023/05/26","55a"),exact:!0},{path:"/changelog/2023/06/12",component:l("/changelog/2023/06/12","a48"),exact:!0},{path:"/changelog/2023/06/13",component:l("/changelog/2023/06/13","243"),exact:!0},{path:"/changelog/2023/06/20",component:l("/changelog/2023/06/20","9ba"),exact:!0},{path:"/changelog/2023/06/26",component:l("/changelog/2023/06/26","f01"),exact:!0},{path:"/changelog/2023/07/10",component:l("/changelog/2023/07/10","8db"),exact:!0},{path:"/changelog/2023/07/14",component:l("/changelog/2023/07/14","a8f"),exact:!0},{path:"/changelog/2023/07/14/1",component:l("/changelog/2023/07/14/1","b23"),exact:!0},{path:"/changelog/2023/07/24",component:l("/changelog/2023/07/24","f19"),exact:!0},{path:"/changelog/2023/07/25",component:l("/changelog/2023/07/25","be7"),exact:!0},{path:"/changelog/2023/08/08",component:l("/changelog/2023/08/08","1ad"),exact:!0},{path:"/changelog/2023/08/17",component:l("/changelog/2023/08/17","428"),exact:!0},{path:"/changelog/2023/08/22",component:l("/changelog/2023/08/22","ab7"),exact:!0},{path:"/changelog/2023/08/29",component:l("/changelog/2023/08/29","b35"),exact:!0},{path:"/changelog/2023/09/08",component:l("/changelog/2023/09/08","b07"),exact:!0},{path:"/changelog/2023/09/14",component:l("/changelog/2023/09/14","ddb"),exact:!0},{path:"/changelog/2023/09/18",component:l("/changelog/2023/09/18","d4a"),exact:!0},{path:"/changelog/2023/09/22",component:l("/changelog/2023/09/22","f35"),exact:!0},{path:"/changelog/2023/09/27",component:l("/changelog/2023/09/27","850"),exact:!0},{path:"/changelog/2023/09/27/1",component:l("/changelog/2023/09/27/1","d42"),exact:!0},{path:"/changelog/2023/10/10",component:l("/changelog/2023/10/10","293"),exact:!0},{path:"/changelog/2023/10/11",component:l("/changelog/2023/10/11","f03"),exact:!0},{path:"/changelog/2023/10/27",component:l("/changelog/2023/10/27","ee9"),exact:!0},{path:"/changelog/2023/11/21",component:l("/changelog/2023/11/21","c2c"),exact:!0},{path:"/changelog/2023/11/22",component:l("/changelog/2023/11/22","72b"),exact:!0},{path:"/changelog/2023/11/30",component:l("/changelog/2023/11/30","ac0"),exact:!0},{path:"/changelog/2023/12/07",component:l("/changelog/2023/12/07","386"),exact:!0},{path:"/changelog/2023/12/11",component:l("/changelog/2023/12/11","694"),exact:!0},{path:"/changelog/2023/12/15",component:l("/changelog/2023/12/15","9d4"),exact:!0},{path:"/changelog/2024/01/02",component:l("/changelog/2024/01/02","c2e"),exact:!0},{path:"/changelog/2024/01/16",component:l("/changelog/2024/01/16","44e"),exact:!0},{path:"/changelog/2024/01/17",component:l("/changelog/2024/01/17","e0c"),exact:!0},{path:"/changelog/2024/01/18",component:l("/changelog/2024/01/18","47f"),exact:!0},{path:"/changelog/2024/02/01",component:l("/changelog/2024/02/01","a97"),exact:!0},{path:"/changelog/2024/03/25",component:l("/changelog/2024/03/25","609"),exact:!0},{path:"/changelog/2024/03/28",component:l("/changelog/2024/03/28","ec1"),exact:!0},{path:"/changelog/2024/04/23",component:l("/changelog/2024/04/23","a72"),exact:!0},{path:"/changelog/2024/06/06",component:l("/changelog/2024/06/06","90a"),exact:!0},{path:"/changelog/2024/06/17",component:l("/changelog/2024/06/17","8df"),exact:!0},{path:"/changelog/2024/07/16",component:l("/changelog/2024/07/16","b1c"),exact:!0},{path:"/changelog/2024/08/29",component:l("/changelog/2024/08/29","7a7"),exact:!0},{path:"/changelog/2024/09/17",component:l("/changelog/2024/09/17","108"),exact:!0},{path:"/changelog/2025/06/11",component:l("/changelog/2025/06/11","2ef"),exact:!0},{path:"/changelog/2025/11/18",component:l("/changelog/2025/11/18","8e1"),exact:!0},{path:"/changelog/2026/01/05",component:l("/changelog/2026/01/05","5f9"),exact:!0},{path:"/changelog/archive",component:l("/changelog/archive","bc1"),exact:!0},{path:"/changelog/tags",component:l("/changelog/tags","744"),exact:!0},{path:"/changelog/tags/breaking",component:l("/changelog/tags/breaking","5d9"),exact:!0},{path:"/changelog/tags/checkout",component:l("/changelog/tags/checkout","07e"),exact:!0},{path:"/changelog/tags/checkout-admin",component:l("/changelog/tags/checkout-admin","ad3"),exact:!0},{path:"/changelog/tags/checkout-backend",component:l("/changelog/tags/checkout-backend","cda"),exact:!0},{path:"/changelog/tags/checkout-frontend",component:l("/changelog/tags/checkout-frontend","b46"),exact:!0},{path:"/changelog/tags/customers",component:l("/changelog/tags/customers","ca5"),exact:!0},{path:"/changelog/tags/external-payment-gateway-connector",component:l("/changelog/tags/external-payment-gateway-connector","dce"),exact:!0},{path:"/changelog/tags/integrations",component:l("/changelog/tags/integrations","08a"),exact:!0},{path:"/changelog/tags/non-breaking",component:l("/changelog/tags/non-breaking","ce2"),exact:!0},{path:"/changelog/tags/platform-connector",component:l("/changelog/tags/platform-connector","fda"),exact:!0},{path:"/changelog/tags/platform-event-notifications",component:l("/changelog/tags/platform-event-notifications","308"),exact:!0},{path:"/changelog/tags/price-rules-api",component:l("/changelog/tags/price-rules-api","108"),exact:!0},{path:"/changelog/tags/remote-state-authority",component:l("/changelog/tags/remote-state-authority","299"),exact:!0},{path:"/changelog/tags/shops",component:l("/changelog/tags/shops","184"),exact:!0},{path:"/changelog/tags/subscriptions",component:l("/changelog/tags/subscriptions","8db"),exact:!0},{path:"/search",component:l("/search","5de"),exact:!0},{path:"/solution-library",component:l("/solution-library","b19"),exact:!0},{path:"/guides",component:l("/guides","946"),routes:[{path:"/guides",component:l("/guides","004"),routes:[{path:"/guides/tags",component:l("/guides/tags","cfe"),exact:!0},{path:"/guides/tags/abandoned-cart",component:l("/guides/tags/abandoned-cart","e87"),exact:!0},{path:"/guides/tags/adobe-commerce",component:l("/guides/tags/adobe-commerce","5c7"),exact:!0},{path:"/guides/tags/algolia",component:l("/guides/tags/algolia","2c6"),exact:!0},{path:"/guides/tags/apple-pay",component:l("/guides/tags/apple-pay","b42"),exact:!0},{path:"/guides/tags/area",component:l("/guides/tags/area","789"),exact:!0},{path:"/guides/tags/authenticated-checkout",component:l("/guides/tags/authenticated-checkout","1f6"),exact:!0},{path:"/guides/tags/authentication",component:l("/guides/tags/authentication","f06"),exact:!0},{path:"/guides/tags/big-commerce",component:l("/guides/tags/big-commerce","998"),exact:!0},{path:"/guides/tags/biometrics",component:l("/guides/tags/biometrics","c30"),exact:!0},{path:"/guides/tags/blog",component:l("/guides/tags/blog","b80"),exact:!0},{path:"/guides/tags/braintree",component:l("/guides/tags/braintree","a98"),exact:!0},{path:"/guides/tags/buy-now",component:l("/guides/tags/buy-now","da9"),exact:!0},{path:"/guides/tags/checkout-experience-templates",component:l("/guides/tags/checkout-experience-templates","7b7"),exact:!0},{path:"/guides/tags/checkout-flow",component:l("/guides/tags/checkout-flow","407"),exact:!0},{path:"/guides/tags/checkout-flows",component:l("/guides/tags/checkout-flows","fcd"),exact:!0},{path:"/guides/tags/coalition-technologies",component:l("/guides/tags/coalition-technologies","1b3"),exact:!0},{path:"/guides/tags/commercetools",component:l("/guides/tags/commercetools","6bb"),exact:!0},{path:"/guides/tags/constructor",component:l("/guides/tags/constructor","33a"),exact:!0},{path:"/guides/tags/conversion",component:l("/guides/tags/conversion","601"),exact:!0},{path:"/guides/tags/convert-from-search",component:l("/guides/tags/convert-from-search","771"),exact:!0},{path:"/guides/tags/customer-management-system",component:l("/guides/tags/customer-management-system","183"),exact:!0},{path:"/guides/tags/ecommerce-platform",component:l("/guides/tags/ecommerce-platform","83a"),exact:!0},{path:"/guides/tags/email",component:l("/guides/tags/email","725"),exact:!0},{path:"/guides/tags/epg",component:l("/guides/tags/epg","229"),exact:!0},{path:"/guides/tags/express-checkout",component:l("/guides/tags/express-checkout","45b"),exact:!0},{path:"/guides/tags/express-pay",component:l("/guides/tags/express-pay","425"),exact:!0},{path:"/guides/tags/external-payment-gateway-connector",component:l("/guides/tags/external-payment-gateway-connector","dc4"),exact:!0},{path:"/guides/tags/google-pay",component:l("/guides/tags/google-pay","a70"),exact:!0},{path:"/guides/tags/harry-rosen",component:l("/guides/tags/harry-rosen","0c5"),exact:!0},{path:"/guides/tags/klarna",component:l("/guides/tags/klarna","db1"),exact:!0},{path:"/guides/tags/klaviyo",component:l("/guides/tags/klaviyo","2d5"),exact:!0},{path:"/guides/tags/m-1",component:l("/guides/tags/m-1","66e"),exact:!0},{path:"/guides/tags/magento-1",component:l("/guides/tags/magento-1","750"),exact:!0},{path:"/guides/tags/magento-2",component:l("/guides/tags/magento-2","1e5"),exact:!0},{path:"/guides/tags/magento-open-source",component:l("/guides/tags/magento-open-source","458"),exact:!0},{path:"/guides/tags/oracle",component:l("/guides/tags/oracle","16b"),exact:!0},{path:"/guides/tags/oracle-commerce-cloud",component:l("/guides/tags/oracle-commerce-cloud","582"),exact:!0},{path:"/guides/tags/order-management-system",component:l("/guides/tags/order-management-system","565"),exact:!0},{path:"/guides/tags/orium",component:l("/guides/tags/orium","150"),exact:!0},{path:"/guides/tags/partner-flow",component:l("/guides/tags/partner-flow","43f"),exact:!0},{path:"/guides/tags/partner-name",component:l("/guides/tags/partner-name","512"),exact:!0},{path:"/guides/tags/partner-type",component:l("/guides/tags/partner-type","65f"),exact:!0},{path:"/guides/tags/pay-pal",component:l("/guides/tags/pay-pal","651"),exact:!0},{path:"/guides/tags/pay-pal-complete-payments",component:l("/guides/tags/pay-pal-complete-payments","0fa"),exact:!0},{path:"/guides/tags/pay-pal-express",component:l("/guides/tags/pay-pal-express","3eb"),exact:!0},{path:"/guides/tags/payment-gateway",component:l("/guides/tags/payment-gateway","688"),exact:!0},{path:"/guides/tags/payments",component:l("/guides/tags/payments","b3c"),exact:!0},{path:"/guides/tags/platform",component:l("/guides/tags/platform","50a"),exact:!0},{path:"/guides/tags/platform-connector",component:l("/guides/tags/platform-connector","d68"),exact:!0},{path:"/guides/tags/pre-purchase-upsell",component:l("/guides/tags/pre-purchase-upsell","05f"),exact:!0},{path:"/guides/tags/product-information-system",component:l("/guides/tags/product-information-system","25d"),exact:!0},{path:"/guides/tags/purchase-from-blog",component:l("/guides/tags/purchase-from-blog","5c1"),exact:!0},{path:"/guides/tags/search",component:l("/guides/tags/search","80e"),exact:!0},{path:"/guides/tags/self-hosted",component:l("/guides/tags/self-hosted","db9"),exact:!0},{path:"/guides/tags/shipper-hq",component:l("/guides/tags/shipper-hq","ff9"),exact:!0},{path:"/guides/tags/shipping",component:l("/guides/tags/shipping","728"),exact:!0},{path:"/guides/tags/stripe",component:l("/guides/tags/stripe","ce5"),exact:!0},{path:"/guides/tags/tax",component:l("/guides/tags/tax","0fd"),exact:!0},{path:"/guides/tags/tax-jar",component:l("/guides/tags/tax-jar","75a"),exact:!0},{path:"/guides/tags/taxes",component:l("/guides/tags/taxes","b7b"),exact:!0},{path:"/guides/tags/technology-partner",component:l("/guides/tags/technology-partner","689"),exact:!0},{path:"/guides/tags/unsupported-platform",component:l("/guides/tags/unsupported-platform","c04"),exact:!0},{path:"/guides/tags/wallet-pay",component:l("/guides/tags/wallet-pay","263"),exact:!0},{path:"/guides/tags/wink",component:l("/guides/tags/wink","a3e"),exact:!0},{path:"/guides",component:l("/guides","28d"),routes:[{path:"/guides/archive",component:l("/guides/archive","a60"),exact:!0,sidebar:"otherApisSidebar"},{path:"/guides/archive/cashier",component:l("/guides/archive/cashier","dc4"),exact:!0,sidebar:"otherApisSidebar"},{path:"/guides/archive/gravity-forms-upgrade",component:l("/guides/archive/gravity-forms-upgrade","cb8"),exact:!0},{path:"/guides/archive/installation",component:l("/guides/archive/installation","f9f"),exact:!0},{path:"/guides/archive/installation_m1",component:l("/guides/archive/installation_m1","171"),exact:!0},{path:"/guides/archive/subscriptions_v1_integration",component:l("/guides/archive/subscriptions_v1_integration","559"),exact:!0,sidebar:"otherApisSidebar"},{path:"/guides/archive/subscriptions_v1_msp",component:l("/guides/archive/subscriptions_v1_msp","a36"),exact:!0,sidebar:"otherApisSidebar"},{path:"/guides/archive/subscriptions_v1_storefront",component:l("/guides/archive/subscriptions_v1_storefront","be0"),exact:!0,sidebar:"otherApisSidebar"},{path:"/guides/checkout",component:l("/guides/checkout","38b"),exact:!0},{path:"/guides/checkout/api-overrides",component:l("/guides/checkout/api-overrides","b50"),exact:!0},{path:"/guides/checkout/batch-processing",component:l("/guides/checkout/batch-processing","08a"),exact:!0},{path:"/guides/checkout/bold-boosters/adobe-commerce-bold-booster-for-intuit",component:l("/guides/checkout/bold-boosters/adobe-commerce-bold-booster-for-intuit","f5c"),exact:!0,sidebar:"checkoutSidebar"},{path:"/guides/checkout/bold-boosters/adobe-commerce-bold-booster-for-paypal",component:l("/guides/checkout/bold-boosters/adobe-commerce-bold-booster-for-paypal","e67"),exact:!0,sidebar:"checkoutSidebar"},{path:"/guides/checkout/bold-boosters/bold-booster-for-paypal-overview",component:l("/guides/checkout/bold-boosters/bold-booster-for-paypal-overview","773"),exact:!0,sidebar:"checkoutSidebar"},{path:"/guides/checkout/bold-boosters/bold-booster-security",component:l("/guides/checkout/bold-boosters/bold-booster-security","601"),exact:!0,sidebar:"checkoutSidebar"},{path:"/guides/checkout/bold-boosters/bold-booster-troubleshooting",component:l("/guides/checkout/bold-boosters/bold-booster-troubleshooting","129"),exact:!0,sidebar:"checkoutSidebar"},{path:"/guides/checkout/bold-boosters/bold-booster-upgrade",component:l("/guides/checkout/bold-boosters/bold-booster-upgrade","6cb"),exact:!0,sidebar:"checkoutSidebar"},{path:"/guides/checkout/bold-boosters/connect-authorize",component:l("/guides/checkout/bold-boosters/connect-authorize","43c"),exact:!0,sidebar:"checkoutSidebar"},{path:"/guides/checkout/bold-boosters/connect-braintree",component:l("/guides/checkout/bold-boosters/connect-braintree","c2e"),exact:!0,sidebar:"checkoutSidebar"},{path:"/guides/checkout/bold-boosters/connect-intuit",component:l("/guides/checkout/bold-boosters/connect-intuit","999"),exact:!0,sidebar:"checkoutSidebar"},{path:"/guides/checkout/bold-boosters/connect-nuvei",component:l("/guides/checkout/bold-boosters/connect-nuvei","5ff"),exact:!0,sidebar:"checkoutSidebar"},{path:"/guides/checkout/bold-boosters/connect-payment-gateways",component:l("/guides/checkout/bold-boosters/connect-payment-gateways","1a4"),exact:!0,sidebar:"checkoutSidebar"},{path:"/guides/checkout/bold-boosters/connect-ppcp",component:l("/guides/checkout/bold-boosters/connect-ppcp","00c"),exact:!0,sidebar:"checkoutSidebar"},{path:"/guides/checkout/bold-boosters/connect-stripe",component:l("/guides/checkout/bold-boosters/connect-stripe","db0"),exact:!0,sidebar:"checkoutSidebar"},{path:"/guides/checkout/bold-boosters/export-request-logs",component:l("/guides/checkout/bold-boosters/export-request-logs","233"),exact:!0,sidebar:"checkoutSidebar"},{path:"/guides/checkout/bold-boosters/gravity-forms-bold-booster-for-paypal",component:l("/guides/checkout/bold-boosters/gravity-forms-bold-booster-for-paypal","eb1"),exact:!0,sidebar:"checkoutSidebar"},{path:"/guides/checkout/bold-boosters/install-compatibility-modules",component:l("/guides/checkout/bold-boosters/install-compatibility-modules","bf3"),exact:!0,sidebar:"checkoutSidebar"},{path:"/guides/checkout/bold-boosters/integrate-forter",component:l("/guides/checkout/bold-boosters/integrate-forter","905"),exact:!0},{path:"/guides/checkout/bold-boosters/m1-bold-booster-for-paypal",component:l("/guides/checkout/bold-boosters/m1-bold-booster-for-paypal","285"),exact:!0,sidebar:"checkoutSidebar"},{path:"/guides/checkout/bold-boosters/opencart-bold-booster-for-paypal",component:l("/guides/checkout/bold-boosters/opencart-bold-booster-for-paypal","3d4"),exact:!0,sidebar:"checkoutSidebar"},{path:"/guides/checkout/bold-boosters/set-up-apple-pay",component:l("/guides/checkout/bold-boosters/set-up-apple-pay","22a"),exact:!0,sidebar:"checkoutSidebar"},{path:"/guides/checkout/bold-boosters/set-up-google-pay",component:l("/guides/checkout/bold-boosters/set-up-google-pay","ebc"),exact:!0,sidebar:"checkoutSidebar"},{path:"/guides/checkout/checkout-epg-guide",component:l("/guides/checkout/checkout-epg-guide","236"),exact:!0},{path:"/guides/checkout/checkout-getting-started",component:l("/guides/checkout/checkout-getting-started","59d"),exact:!0},{path:"/guides/checkout/concepts",component:l("/guides/checkout/concepts","cf6"),exact:!0},{path:"/guides/checkout/concepts/cart-parameters",component:l("/guides/checkout/concepts/cart-parameters","03c"),exact:!0},{path:"/guides/checkout/concepts/external-payment-gateways",component:l("/guides/checkout/concepts/external-payment-gateways","5b2"),exact:!0},{path:"/guides/checkout/concepts/flows",component:l("/guides/checkout/concepts/flows","eab"),exact:!0},{path:"/guides/checkout/concepts/headless",component:l("/guides/checkout/concepts/headless","8f5"),exact:!0},{path:"/guides/checkout/concepts/overrides",component:l("/guides/checkout/concepts/overrides","171"),exact:!0},{path:"/guides/checkout/concepts/payment-information",component:l("/guides/checkout/concepts/payment-information","ad7"),exact:!0,sidebar:"checkoutSidebar"},{path:"/guides/checkout/concepts/plugins",component:l("/guides/checkout/concepts/plugins","0c4"),exact:!0},{path:"/guides/checkout/concepts/sdk-integrate",component:l("/guides/checkout/concepts/sdk-integrate","65d"),exact:!0},{path:"/guides/checkout/concepts/spi-integrate",component:l("/guides/checkout/concepts/spi-integrate","094"),exact:!0},{path:"/guides/checkout/create-order",component:l("/guides/checkout/create-order","769"),exact:!0},{path:"/guides/checkout/css",component:l("/guides/checkout/css","643"),exact:!0},{path:"/guides/checkout/extend",component:l("/guides/checkout/extend","d90"),exact:!0},{path:"/guides/checkout/fulfill-order",component:l("/guides/checkout/fulfill-order","2af"),exact:!0},{path:"/guides/checkout/gift-cards",component:l("/guides/checkout/gift-cards","61b"),exact:!0},{path:"/guides/checkout/integrations/commercetools",component:l("/guides/checkout/integrations/commercetools","7aa"),exact:!0},{path:"/guides/checkout/life",component:l("/guides/checkout/life","da9"),exact:!0},{path:"/guides/checkout/meta",component:l("/guides/checkout/meta","a7a"),exact:!0},{path:"/guides/checkout/metrics",component:l("/guides/checkout/metrics","c20"),exact:!0},{path:"/guides/checkout/plugins",component:l("/guides/checkout/plugins","e68"),exact:!0},{path:"/guides/checkout/plugins/app-hooks",component:l("/guides/checkout/plugins/app-hooks","e51"),exact:!0},{path:"/guides/checkout/plugins/event-action-loop",component:l("/guides/checkout/plugins/event-action-loop","4c6"),exact:!0},{path:"/guides/checkout/plugins/getting-started",component:l("/guides/checkout/plugins/getting-started","a0d"),exact:!0},{path:"/guides/checkout/plugins/installation-flow",component:l("/guides/checkout/plugins/installation-flow","1f9"),exact:!0},{path:"/guides/checkout/plugins/overrides",component:l("/guides/checkout/plugins/overrides","7b8"),exact:!0},{path:"/guides/checkout/pmmc",component:l("/guides/checkout/pmmc","cf4"),exact:!0},{path:"/guides/checkout/populate-order",component:l("/guides/checkout/populate-order","2be"),exact:!0},{path:"/guides/checkout/public-integrations",component:l("/guides/checkout/public-integrations","98d"),exact:!0},{path:"/guides/checkout/quick-start",component:l("/guides/checkout/quick-start","741"),exact:!0},{path:"/guides/checkout/references/checkout-epg-api",component:l("/guides/checkout/references/checkout-epg-api","27f"),exact:!0},{path:"/guides/checkout/references/checkout-spi-api",component:l("/guides/checkout/references/checkout-spi-api","be9"),exact:!0},{path:"/guides/checkout/references/country-province-requirements",component:l("/guides/checkout/references/country-province-requirements","774"),exact:!0},{path:"/guides/checkout/references/epg-actions-events",component:l("/guides/checkout/references/epg-actions-events","bcb"),exact:!0},{path:"/guides/checkout/references/plugin-actions",component:l("/guides/checkout/references/plugin-actions","cc0"),exact:!0},{path:"/guides/checkout/references/plugin-events",component:l("/guides/checkout/references/plugin-events","bb3"),exact:!0},{path:"/guides/checkout/resources/access-scopes",component:l("/guides/checkout/resources/access-scopes","370"),exact:!0},{path:"/guides/checkout/resources/api-versioning",component:l("/guides/checkout/resources/api-versioning","a7f"),exact:!0},{path:"/guides/checkout/resources/error-responses",component:l("/guides/checkout/resources/error-responses","2a0"),exact:!0},{path:"/guides/checkout/resources/glossary",component:l("/guides/checkout/resources/glossary","668"),exact:!0},{path:"/guides/checkout/resources/open-source",component:l("/guides/checkout/resources/open-source","63e"),exact:!0},{path:"/guides/checkout/resources/query-pagination",component:l("/guides/checkout/resources/query-pagination","b00"),exact:!0},{path:"/guides/checkout/resources/rate-limiting",component:l("/guides/checkout/resources/rate-limiting","5c5"),exact:!0},{path:"/guides/checkout/resources/supported-platforms-gateways",component:l("/guides/checkout/resources/supported-platforms-gateways","c30"),exact:!0},{path:"/guides/checkout/self-hosted-flow",component:l("/guides/checkout/self-hosted-flow","63c"),exact:!0},{path:"/guides/checkout/validate-discounts",component:l("/guides/checkout/validate-discounts","891"),exact:!0},{path:"/guides/checkout/webhooks",component:l("/guides/checkout/webhooks","b8b"),exact:!0},{path:"/guides/platform-connector",component:l("/guides/platform-connector","b88"),exact:!0},{path:"/guides/platform-connector/concepts",component:l("/guides/platform-connector/concepts","949"),exact:!0},{path:"/guides/platform-connector/concepts/components",component:l("/guides/platform-connector/concepts/components","272"),exact:!0},{path:"/guides/platform-connector/concepts/example-implementations",component:l("/guides/platform-connector/concepts/example-implementations","284"),exact:!0},{path:"/guides/platform-connector/create-server",component:l("/guides/platform-connector/create-server","e9a"),exact:!0},{path:"/guides/platform-connector/event-notifications",component:l("/guides/platform-connector/event-notifications","b97"),exact:!0},{path:"/guides/platform-connector/getting-started",component:l("/guides/platform-connector/getting-started","b24"),exact:!0},{path:"/guides/platform-connector/requirements",component:l("/guides/platform-connector/requirements","2c1"),exact:!0},{path:"/guides/platform-connector/rsa/concepts",component:l("/guides/platform-connector/rsa/concepts","a06"),exact:!0},{path:"/guides/platform-connector/rsa/create-checkout-rsa",component:l("/guides/platform-connector/rsa/create-checkout-rsa","aac"),exact:!0},{path:"/guides/platform-connector/rsa/requirements",component:l("/guides/platform-connector/rsa/requirements","a38"),exact:!0},{path:"/guides/platform-connector/verify",component:l("/guides/platform-connector/verify","6a6"),exact:!0},{path:"/guides/platform-integration/adobe-commerce/concepts",component:l("/guides/platform-integration/adobe-commerce/concepts","469"),exact:!0},{path:"/guides/platform-integration/adobe-commerce/dev-store",component:l("/guides/platform-integration/adobe-commerce/dev-store","23e"),exact:!0},{path:"/guides/platform-integration/adobe-commerce/flows/paypal-checkout-flow",component:l("/guides/platform-integration/adobe-commerce/flows/paypal-checkout-flow","809"),exact:!0},{path:"/guides/platform-integration/adobe-commerce/generate-module-list",component:l("/guides/platform-integration/adobe-commerce/generate-module-list","869"),exact:!0},{path:"/guides/platform-integration/adobe-commerce/overview",component:l("/guides/platform-integration/adobe-commerce/overview","517"),exact:!0},{path:"/guides/platform-integration/adobe-commerce/troubleshooting",component:l("/guides/platform-integration/adobe-commerce/troubleshooting","a20"),exact:!0},{path:"/guides/platform-integration/adobe-commerce/versions",component:l("/guides/platform-integration/adobe-commerce/versions","a6c"),exact:!0},{path:"/guides/platform-integration/bigcommerce/pre",component:l("/guides/platform-integration/bigcommerce/pre","c0e"),exact:!0,sidebar:"preSidebar"},{path:"/guides/platform-integration/commercetools/headless-checkout",component:l("/guides/platform-integration/commercetools/headless-checkout","103"),exact:!0},{path:"/guides/platform-integration/magento-1/concepts",component:l("/guides/platform-integration/magento-1/concepts","aaf"),exact:!0},{path:"/guides/platform-integration/magento-1/dev-store",component:l("/guides/platform-integration/magento-1/dev-store","019"),exact:!0},{path:"/guides/platform-integration/magento-1/extensions",component:l("/guides/platform-integration/magento-1/extensions","68e"),exact:!0},{path:"/guides/platform-integration/magento-1/overview",component:l("/guides/platform-integration/magento-1/overview","36b"),exact:!0},{path:"/guides/platform-integration/magento-1/troubleshooting",component:l("/guides/platform-integration/magento-1/troubleshooting","cc6"),exact:!0},{path:"/guides/platform-integration/magento-1/versions",component:l("/guides/platform-integration/magento-1/versions","ba2"),exact:!0},{path:"/guides/platform-integration/shopify/pre",component:l("/guides/platform-integration/shopify/pre","707"),exact:!0,sidebar:"preSidebar"},{path:"/guides/price-rules",component:l("/guides/price-rules","62f"),exact:!0,sidebar:"preSidebar"},{path:"/guides/price-rules/additional-resources",component:l("/guides/price-rules/additional-resources","8e7"),exact:!0},{path:"/guides/price-rules/attributes",component:l("/guides/price-rules/attributes","61e"),exact:!0,sidebar:"preSidebar"},{path:"/guides/price-rules/concepts/rulesets-and-rules",component:l("/guides/price-rules/concepts/rulesets-and-rules","1e5"),exact:!0,sidebar:"preSidebar"},{path:"/guides/price-rules/customer-targeted-pricing",component:l("/guides/price-rules/customer-targeted-pricing","3f7"),exact:!0},{path:"/guides/price-rules/debug-tools",component:l("/guides/price-rules/debug-tools","9d0"),exact:!0,sidebar:"preSidebar"},{path:"/guides/price-rules/discount-codes",component:l("/guides/price-rules/discount-codes","c2b"),exact:!0},{path:"/guides/price-rules/errors",component:l("/guides/price-rules/errors","bb7"),exact:!0,sidebar:"preSidebar"},{path:"/guides/price-rules/getting-started",component:l("/guides/price-rules/getting-started","8b5"),exact:!0,sidebar:"preSidebar"},{path:"/guides/price-rules/headless-storefront-setup",component:l("/guides/price-rules/headless-storefront-setup","460"),exact:!0,sidebar:"preSidebar"},{path:"/guides/price-rules/promotion-info",component:l("/guides/price-rules/promotion-info","60f"),exact:!0},{path:"/guides/price-rules/promotion-message",component:l("/guides/price-rules/promotion-message","644"),exact:!0,sidebar:"preSidebar"},{path:"/guides/price-rules/public-integrations",component:l("/guides/price-rules/public-integrations","dec"),exact:!0,sidebar:"preSidebar"},{path:"/guides/price-rules/quick-start",component:l("/guides/price-rules/quick-start","08b"),exact:!0,sidebar:"preSidebar"},{path:"/guides/price-rules/references/actions",component:l("/guides/price-rules/references/actions","39f"),exact:!0,sidebar:"preSidebar"},{path:"/guides/price-rules/references/conditions",component:l("/guides/price-rules/references/conditions","8f0"),exact:!0,sidebar:"preSidebar"},{path:"/guides/price-rules/references/frontend-api",component:l("/guides/price-rules/references/frontend-api","32c"),exact:!0,sidebar:"preSidebar"},{path:"/guides/price-rules/references/product-selection",component:l("/guides/price-rules/references/product-selection","ec8"),exact:!0,sidebar:"preSidebar"},{path:"/guides/price-rules/references/ruleset-properties",component:l("/guides/price-rules/references/ruleset-properties","a26"),exact:!0,sidebar:"preSidebar"},{path:"/guides/price-rules/resources/access-scopes",component:l("/guides/price-rules/resources/access-scopes","9d6"),exact:!0,sidebar:"preSidebar"},{path:"/guides/price-rules/resources/api-versioning",component:l("/guides/price-rules/resources/api-versioning","539"),exact:!0,sidebar:"preSidebar"},{path:"/guides/price-rules/resources/error-responses",component:l("/guides/price-rules/resources/error-responses","e4b"),exact:!0,sidebar:"preSidebar"},{path:"/guides/price-rules/resources/glossary",component:l("/guides/price-rules/resources/glossary","577"),exact:!0,sidebar:"preSidebar"},{path:"/guides/price-rules/resources/open-source",component:l("/guides/price-rules/resources/open-source","214"),exact:!0,sidebar:"preSidebar"},{path:"/guides/price-rules/resources/query-pagination",component:l("/guides/price-rules/resources/query-pagination","80d"),exact:!0,sidebar:"preSidebar"},{path:"/guides/price-rules/resources/rate-limiting",component:l("/guides/price-rules/resources/rate-limiting","8dd"),exact:!0,sidebar:"preSidebar"},{path:"/guides/price-rules/resources/supported-platforms-gateways",component:l("/guides/price-rules/resources/supported-platforms-gateways","0c9"),exact:!0,sidebar:"preSidebar"},{path:"/guides/price-rules/working-with-rulesets/cart-level-promotions",component:l("/guides/price-rules/working-with-rulesets/cart-level-promotions","07c"),exact:!0,sidebar:"preSidebar"},{path:"/guides/price-rules/working-with-rulesets/customer-targeted-pricing",component:l("/guides/price-rules/working-with-rulesets/customer-targeted-pricing","c1d"),exact:!0,sidebar:"preSidebar"},{path:"/guides/price-rules/working-with-rulesets/discount-codes",component:l("/guides/price-rules/working-with-rulesets/discount-codes","6d1"),exact:!0,sidebar:"preSidebar"},{path:"/guides/price-rules/working-with-rulesets/location-based-pricing",component:l("/guides/price-rules/working-with-rulesets/location-based-pricing","d48"),exact:!0,sidebar:"preSidebar"},{path:"/guides/price-rules/working-with-rulesets/managing-price-rules",component:l("/guides/price-rules/working-with-rulesets/managing-price-rules","f87"),exact:!0,sidebar:"preSidebar"},{path:"/guides/price-rules/working-with-rulesets/multi-currency",component:l("/guides/price-rules/working-with-rulesets/multi-currency","9f2"),exact:!0,sidebar:"preSidebar"},{path:"/guides/price-rules/working-with-rulesets/order-condition",component:l("/guides/price-rules/working-with-rulesets/order-condition","4d8"),exact:!0,sidebar:"preSidebar"},{path:"/guides/price-rules/working-with-rulesets/price-adjustments",component:l("/guides/price-rules/working-with-rulesets/price-adjustments","5f4"),exact:!0,sidebar:"preSidebar"},{path:"/guides/price-rules/working-with-rulesets/prioritization-and-stacking",component:l("/guides/price-rules/working-with-rulesets/prioritization-and-stacking","fe0"),exact:!0,sidebar:"preSidebar"},{path:"/guides/price-rules/working-with-rulesets/quantity-pricing",component:l("/guides/price-rules/working-with-rulesets/quantity-pricing","5e1"),exact:!0,sidebar:"preSidebar"},{path:"/guides/price-rules/working-with-rulesets/scheduling",component:l("/guides/price-rules/working-with-rulesets/scheduling","f4c"),exact:!0,sidebar:"preSidebar"},{path:"/guides/solutions/blueprints/abandoned-cart",component:l("/guides/solutions/blueprints/abandoned-cart","ac9"),exact:!0},{path:"/guides/solutions/blueprints/biometric-auth",component:l("/guides/solutions/blueprints/biometric-auth","f97"),exact:!0},{path:"/guides/solutions/blueprints/blog",component:l("/guides/solutions/blueprints/blog","4d0"),exact:!0},{path:"/guides/solutions/blueprints/buy-now",component:l("/guides/solutions/blueprints/buy-now","413"),exact:!0},{path:"/guides/solutions/blueprints/klarna",component:l("/guides/solutions/blueprints/klarna","490"),exact:!0},{path:"/guides/solutions/blueprints/platform-connector",component:l("/guides/solutions/blueprints/platform-connector","913"),exact:!0},{path:"/guides/solutions/blueprints/search-algolia",component:l("/guides/solutions/blueprints/search-algolia","1ab"),exact:!0},{path:"/guides/solutions/blueprints/search-constructor",component:l("/guides/solutions/blueprints/search-constructor","36b"),exact:!0},{path:"/guides/solutions/blueprints/template",component:l("/guides/solutions/blueprints/template","eec"),exact:!0},{path:"/guides/solutions/blueprints/upsell",component:l("/guides/solutions/blueprints/upsell","8f3"),exact:!0},{path:"/guides/solutions/bold-built/adobe",component:l("/guides/solutions/bold-built/adobe","92c"),exact:!0},{path:"/guides/solutions/bold-built/bigcommerce",component:l("/guides/solutions/bold-built/bigcommerce","59d"),exact:!0},{path:"/guides/solutions/bold-built/braintree",component:l("/guides/solutions/bold-built/braintree","6ff"),exact:!0},{path:"/guides/solutions/bold-built/commercetools",component:l("/guides/solutions/bold-built/commercetools","5e6"),exact:!0},{path:"/guides/solutions/bold-built/magento-1",component:l("/guides/solutions/bold-built/magento-1","5fa"),exact:!0},{path:"/guides/solutions/bold-built/payment-booster",component:l("/guides/solutions/bold-built/payment-booster","f1d"),exact:!0},{path:"/guides/solutions/bold-built/paypal-checkout-flow",component:l("/guides/solutions/bold-built/paypal-checkout-flow","2c2"),exact:!0},{path:"/guides/solutions/bold-built/ppcp",component:l("/guides/solutions/bold-built/ppcp","1e7"),exact:!0},{path:"/guides/solutions/bold-built/shipping",component:l("/guides/solutions/bold-built/shipping","91b"),exact:!0},{path:"/guides/solutions/bold-built/stripe",component:l("/guides/solutions/bold-built/stripe","591"),exact:!0},{path:"/guides/solutions/bold-built/taxjar",component:l("/guides/solutions/bold-built/taxjar","ea5"),exact:!0},{path:"/guides/solutions/bold-built/template",component:l("/guides/solutions/bold-built/template","a0a"),exact:!0},{path:"/guides/solutions/example-projects/custom-flow",component:l("/guides/solutions/example-projects/custom-flow","25c"),exact:!0},{path:"/guides/solutions/example-projects/express-pay",component:l("/guides/solutions/example-projects/express-pay","16d"),exact:!0},{path:"/guides/solutions/example-projects/template",component:l("/guides/solutions/example-projects/template","adc"),exact:!0},{path:"/guides/subscriptions-v2",component:l("/guides/subscriptions-v2","66a"),exact:!0,sidebar:"subscriptionsSidebar"},{path:"/guides/subscriptions-v2/adjust-subscription-orders",component:l("/guides/subscriptions-v2/adjust-subscription-orders","0bb"),exact:!0,sidebar:"subscriptionsSidebar"},{path:"/guides/subscriptions-v2/concepts",component:l("/guides/subscriptions-v2/concepts","581"),exact:!0,sidebar:"subscriptionsSidebar"},{path:"/guides/subscriptions-v2/create-line-items",component:l("/guides/subscriptions-v2/create-line-items","566"),exact:!0,sidebar:"subscriptionsSidebar"},{path:"/guides/subscriptions-v2/create-subscription",component:l("/guides/subscriptions-v2/create-subscription","b69"),exact:!0,sidebar:"subscriptionsSidebar"},{path:"/guides/subscriptions-v2/customer-portals",component:l("/guides/subscriptions-v2/customer-portals","403"),exact:!0,sidebar:"subscriptionsSidebar"},{path:"/guides/subscriptions-v2/getting-started",component:l("/guides/subscriptions-v2/getting-started","de4"),exact:!0,sidebar:"subscriptionsSidebar"},{path:"/guides/subscriptions-v2/headless/storefront-setup",component:l("/guides/subscriptions-v2/headless/storefront-setup","28e"),exact:!0,sidebar:"subscriptionsSidebar"},{path:"/guides/subscriptions-v2/line-items",component:l("/guides/subscriptions-v2/line-items","f6b"),exact:!0,sidebar:"subscriptionsSidebar"},{path:"/guides/subscriptions-v2/public-integrations",component:l("/guides/subscriptions-v2/public-integrations","122"),exact:!0,sidebar:"subscriptionsSidebar"},{path:"/guides/subscriptions-v2/quick-start",component:l("/guides/subscriptions-v2/quick-start","1d9"),exact:!0,sidebar:"subscriptionsSidebar"},{path:"/guides/subscriptions-v2/resources/access-scopes",component:l("/guides/subscriptions-v2/resources/access-scopes","579"),exact:!0,sidebar:"subscriptionsSidebar"},{path:"/guides/subscriptions-v2/resources/api-versioning",component:l("/guides/subscriptions-v2/resources/api-versioning","4b9"),exact:!0,sidebar:"subscriptionsSidebar"},{path:"/guides/subscriptions-v2/resources/error-responses",component:l("/guides/subscriptions-v2/resources/error-responses","3e6"),exact:!0,sidebar:"subscriptionsSidebar"},{path:"/guides/subscriptions-v2/resources/glossary",component:l("/guides/subscriptions-v2/resources/glossary","af6"),exact:!0,sidebar:"subscriptionsSidebar"},{path:"/guides/subscriptions-v2/resources/open-source",component:l("/guides/subscriptions-v2/resources/open-source","4ce"),exact:!0,sidebar:"subscriptionsSidebar"},{path:"/guides/subscriptions-v2/resources/query-pagination",component:l("/guides/subscriptions-v2/resources/query-pagination","4e2"),exact:!0,sidebar:"subscriptionsSidebar"},{path:"/guides/subscriptions-v2/resources/rate-limiting",component:l("/guides/subscriptions-v2/resources/rate-limiting","411"),exact:!0,sidebar:"subscriptionsSidebar"},{path:"/guides/subscriptions-v2/resources/supported-platforms-gateways",component:l("/guides/subscriptions-v2/resources/supported-platforms-gateways","66f"),exact:!0,sidebar:"subscriptionsSidebar"},{path:"/guides/subscriptions-v2/update-subscription",component:l("/guides/subscriptions-v2/update-subscription","5ba"),exact:!0,sidebar:"subscriptionsSidebar"},{path:"/guides/subscriptions-v2/view-future-orders",component:l("/guides/subscriptions-v2/view-future-orders","90c"),exact:!0,sidebar:"subscriptionsSidebar"},{path:"/guides/subscriptions-v2/webhooks",component:l("/guides/subscriptions-v2/webhooks","e47"),exact:!0,sidebar:"subscriptionsSidebar"},{path:"/guides/subscriptions-v2/widgets",component:l("/guides/subscriptions-v2/widgets","2a6"),exact:!0,sidebar:"subscriptionsSidebar"}]}]}]},{path:"/",component:l("/","e5f"),exact:!0},{path:"*",component:l("*")}]},6125:(e,t,r)=>{"use strict";r.d(t,{o:()=>i,x:()=>s});var n=r(96540),o=r(74848);const i=n.createContext(!1);function s(e){let{children:t}=e;const[r,s]=(0,n.useState)(!1);return(0,n.useEffect)((()=>{s(!0)}),[]),(0,o.jsx)(i.Provider,{value:r,children:t})}},38536:(e,t,r)=>{"use strict";var n=r(96540),o=r(5338),i=r(80545),s=r(54625),a=r(4784),c=r(38193);const p=[r(10119),r(26134),r(76294),r(89888),r(7767),r(23390)];var d=r(35947),l=r(56347),u=r(22831),m=r(74848);function h(e){let{children:t}=e;return(0,m.jsx)(m.Fragment,{children:t})}var f=r(5260),g=r(44586),y=r(86025),b=r(6342),_=r(45500),v=r(32131),x=r(14090),w=r(2967),k=r(70440),S=r(41463);function T(){const{i18n:{currentLocale:e,defaultLocale:t,localeConfigs:r}}=(0,g.A)(),n=(0,v.o)(),o=r[e].htmlLang,i=e=>e.replace("-","_");return(0,m.jsxs)(f.A,{children:[Object.entries(r).map((e=>{let[t,{htmlLang:r}]=e;return(0,m.jsx)("link",{rel:"alternate",href:n.createUrl({locale:t,fullyQualified:!0}),hrefLang:r},t)})),(0,m.jsx)("link",{rel:"alternate",href:n.createUrl({locale:t,fullyQualified:!0}),hrefLang:"x-default"}),(0,m.jsx)("meta",{property:"og:locale",content:i(o)}),Object.values(r).filter((e=>o!==e.htmlLang)).map((e=>(0,m.jsx)("meta",{property:"og:locale:alternate",content:i(e.htmlLang)},`meta-og-${e.htmlLang}`)))]})}function C(e){let{permalink:t}=e;const{siteConfig:{url:r}}=(0,g.A)(),n=function(){const{siteConfig:{url:e,baseUrl:t,trailingSlash:r}}=(0,g.A)(),{pathname:n}=(0,l.zy)();return e+(0,k.applyTrailingSlash)((0,y.Ay)(n),{trailingSlash:r,baseUrl:t})}(),o=t?`${r}${t}`:n;return(0,m.jsxs)(f.A,{children:[(0,m.jsx)("meta",{property:"og:url",content:o}),(0,m.jsx)("link",{rel:"canonical",href:o})]})}function A(){const{i18n:{currentLocale:e}}=(0,g.A)(),{metadata:t,image:r}=(0,b.p)();return(0,m.jsxs)(m.Fragment,{children:[(0,m.jsxs)(f.A,{children:[(0,m.jsx)("meta",{name:"twitter:card",content:"summary_large_image"}),(0,m.jsx)("body",{className:x.w})]}),r&&(0,m.jsx)(_.be,{image:r}),(0,m.jsx)(C,{}),(0,m.jsx)(T,{}),(0,m.jsx)(S.A,{tag:w.Cy,locale:e}),(0,m.jsx)(f.A,{children:t.map(((e,t)=>(0,m.jsx)("meta",{...e},t)))})]})}const I=new Map;var j=r(6125),E=r(26988),P=r(205);function R(e){for(var t=arguments.length,r=new Array(t>1?t-1:0),n=1;n{const n=t.default?.[e]??t[e];return n?.(...r)}));return()=>o.forEach((e=>e?.()))}const O=function(e){let{children:t,location:r,previousLocation:n}=e;return(0,P.A)((()=>{n!==r&&(!function(e){let{location:t,previousLocation:r}=e;if(!r)return;const n=t.pathname===r.pathname,o=t.hash===r.hash,i=t.search===r.search;if(n&&o&&!i)return;const{hash:s}=t;if(s){const e=decodeURIComponent(s.substring(1)),t=document.getElementById(e);t?.scrollIntoView()}else window.scrollTo(0,0)}({location:r,previousLocation:n}),R("onRouteDidUpdate",{previousLocation:n,location:r}))}),[n,r]),t};function q(e){const t=Array.from(new Set([e,decodeURI(e)])).map((e=>(0,u.u)(d.A,e))).flat();return Promise.all(t.map((e=>e.route.component.preload?.())))}class $ extends n.Component{previousLocation;routeUpdateCleanupCb;constructor(e){super(e),this.previousLocation=null,this.routeUpdateCleanupCb=c.default.canUseDOM?R("onRouteUpdate",{previousLocation:null,location:this.props.location}):()=>{},this.state={nextRouteHasLoaded:!0}}shouldComponentUpdate(e,t){if(e.location===this.props.location)return t.nextRouteHasLoaded;const r=e.location;return this.previousLocation=this.props.location,this.setState({nextRouteHasLoaded:!1}),this.routeUpdateCleanupCb=R("onRouteUpdate",{previousLocation:this.previousLocation,location:r}),q(r.pathname).then((()=>{this.routeUpdateCleanupCb(),this.setState({nextRouteHasLoaded:!0})})).catch((e=>{console.warn(e),window.location.reload()})),!1}render(){const{children:e,location:t}=this.props;return(0,m.jsx)(O,{previousLocation:this.previousLocation,location:t,children:(0,m.jsx)(l.qh,{location:t,render:()=>e})})}}const D=$,B="__docusaurus-base-url-issue-banner-container",L="__docusaurus-base-url-issue-banner",U="__docusaurus-base-url-issue-banner-suggestion-container";function N(e){return`\ndocument.addEventListener('DOMContentLoaded', function maybeInsertBanner() {\n var shouldInsert = typeof window['docusaurus'] === 'undefined';\n shouldInsert && insertBanner();\n});\n\nfunction insertBanner() {\n var bannerContainer = document.createElement('div');\n bannerContainer.id = '${B}';\n var bannerHtml = ${JSON.stringify(function(e){return`\n
\n

Your Docusaurus site did not load properly.

\n

A very common reason is a wrong site baseUrl configuration.

\n

Current configured baseUrl = ${e} ${"/"===e?" (default value)":""}

\n

We suggest trying baseUrl =

\n
\n`}(e)).replace(/{let{route:t}=e;return!0===t.exact})))return I.set(e.pathname,e.pathname),e;const t=e.pathname.trim().replace(/(?:\/index)?\.html$/,"")||"/";return I.set(e.pathname,t),{...e,pathname:t}}((0,l.zy)());return(0,m.jsx)(D,{location:e,children:Z})}function K(){return(0,m.jsx)(z.A,{children:(0,m.jsx)(E.l,{children:(0,m.jsxs)(j.x,{children:[(0,m.jsxs)(h,{children:[(0,m.jsx)(G,{}),(0,m.jsx)(A,{}),(0,m.jsx)(M,{}),(0,m.jsx)(V,{})]}),(0,m.jsx)(H,{})]})})})}var Y=r(84054);const J=function(e){try{return document.createElement("link").relList.supports(e)}catch{return!1}}("prefetch")?function(e){return new Promise(((t,r)=>{if("undefined"==typeof document)return void r();const n=document.createElement("link");n.setAttribute("rel","prefetch"),n.setAttribute("href",e),n.onload=()=>t(),n.onerror=()=>r();const o=document.getElementsByTagName("head")[0]??document.getElementsByName("script")[0]?.parentNode;o?.appendChild(n)}))}:function(e){return new Promise(((t,r)=>{const n=new XMLHttpRequest;n.open("GET",e,!0),n.withCredentials=!0,n.onload=()=>{200===n.status?t():r()},n.send(null)}))};var X=r(86921);const Q=new Set,ee=new Set,te=()=>navigator.connection?.effectiveType.includes("2g")||navigator.connection?.saveData,re={prefetch:e=>{if(!(e=>!te()&&!ee.has(e)&&!Q.has(e))(e))return!1;Q.add(e);const t=(0,u.u)(d.A,e).flatMap((e=>{return t=e.route.path,Object.entries(Y).filter((e=>{let[r]=e;return r.replace(/-[^-]+$/,"")===t})).flatMap((e=>{let[,t]=e;return Object.values((0,X.A)(t))}));var t}));return Promise.all(t.map((e=>{const t=r.gca(e);return t&&!t.includes("undefined")?J(t).catch((()=>{})):Promise.resolve()})))},preload:e=>!!(e=>!te()&&!ee.has(e))(e)&&(ee.add(e),q(e))},ne=Object.freeze(re);function oe(e){let{children:t}=e;return"hash"===a.default.future.experimental_router?(0,m.jsx)(s.I9,{children:t}):(0,m.jsx)(s.Kd,{children:t})}const ie=Boolean(!0);if(c.default.canUseDOM){window.docusaurus=ne;const e=document.getElementById("__docusaurus"),t=(0,m.jsx)(i.vd,{children:(0,m.jsx)(oe,{children:(0,m.jsx)(K,{})})}),r=(e,t)=>{console.error("Docusaurus React Root onRecoverableError:",e,t)},s=()=>{if(window.docusaurusRoot)window.docusaurusRoot.render(t);else if(ie)window.docusaurusRoot=o.hydrateRoot(e,t,{onRecoverableError:r});else{const n=o.createRoot(e,{onRecoverableError:r});n.render(t),window.docusaurusRoot=n}};q(window.location.pathname).then((()=>{(0,n.startTransition)(s)}))}},26988:(e,t,r)=>{"use strict";r.d(t,{o:()=>l,l:()=>u});var n=r(96540),o=r(4784);const i=JSON.parse('{"docusaurus-plugin-content-docs":{"default":{"path":"/guides","versions":[{"name":"current","label":"Next","isLast":true,"path":"/guides","mainDocId":"checkout/bold-boosters/bold-booster-for-paypal-overview","docs":[{"id":"archive/cashier","path":"/guides/archive/cashier","sidebar":"otherApisSidebar"},{"id":"archive/gravity-forms-upgrade","path":"/guides/archive/gravity-forms-upgrade","unlisted":true},{"id":"archive/index","path":"/guides/archive/","sidebar":"otherApisSidebar"},{"id":"archive/installation","path":"/guides/archive/installation","unlisted":true},{"id":"archive/installation_m1","path":"/guides/archive/installation_m1","unlisted":true},{"id":"archive/subscriptions_v1_integration","path":"/guides/archive/subscriptions_v1_integration","sidebar":"otherApisSidebar"},{"id":"archive/subscriptions_v1_msp","path":"/guides/archive/subscriptions_v1_msp","sidebar":"otherApisSidebar"},{"id":"archive/subscriptions_v1_storefront","path":"/guides/archive/subscriptions_v1_storefront","sidebar":"otherApisSidebar"},{"id":"checkout/api-overrides","path":"/guides/checkout/api-overrides"},{"id":"checkout/batch-processing","path":"/guides/checkout/batch-processing"},{"id":"checkout/bold-boosters/adobe-commerce-bold-booster-for-intuit","path":"/guides/checkout/bold-boosters/adobe-commerce-bold-booster-for-intuit","sidebar":"checkoutSidebar"},{"id":"checkout/bold-boosters/adobe-commerce-bold-booster-for-paypal","path":"/guides/checkout/bold-boosters/adobe-commerce-bold-booster-for-paypal","sidebar":"checkoutSidebar"},{"id":"checkout/bold-boosters/bold-booster-for-paypal-overview","path":"/guides/checkout/bold-boosters/bold-booster-for-paypal-overview","sidebar":"checkoutSidebar"},{"id":"checkout/bold-boosters/bold-booster-security","path":"/guides/checkout/bold-boosters/bold-booster-security","sidebar":"checkoutSidebar"},{"id":"checkout/bold-boosters/bold-booster-troubleshooting","path":"/guides/checkout/bold-boosters/bold-booster-troubleshooting","sidebar":"checkoutSidebar"},{"id":"checkout/bold-boosters/bold-booster-upgrade","path":"/guides/checkout/bold-boosters/bold-booster-upgrade","sidebar":"checkoutSidebar"},{"id":"checkout/bold-boosters/connect-authorize","path":"/guides/checkout/bold-boosters/connect-authorize","sidebar":"checkoutSidebar"},{"id":"checkout/bold-boosters/connect-braintree","path":"/guides/checkout/bold-boosters/connect-braintree","sidebar":"checkoutSidebar"},{"id":"checkout/bold-boosters/connect-intuit","path":"/guides/checkout/bold-boosters/connect-intuit","sidebar":"checkoutSidebar"},{"id":"checkout/bold-boosters/connect-nuvei","path":"/guides/checkout/bold-boosters/connect-nuvei","sidebar":"checkoutSidebar"},{"id":"checkout/bold-boosters/connect-payment-gateways","path":"/guides/checkout/bold-boosters/connect-payment-gateways","sidebar":"checkoutSidebar"},{"id":"checkout/bold-boosters/connect-ppcp","path":"/guides/checkout/bold-boosters/connect-ppcp","sidebar":"checkoutSidebar"},{"id":"checkout/bold-boosters/connect-stripe","path":"/guides/checkout/bold-boosters/connect-stripe","sidebar":"checkoutSidebar"},{"id":"checkout/bold-boosters/export-request-logs","path":"/guides/checkout/bold-boosters/export-request-logs","sidebar":"checkoutSidebar"},{"id":"checkout/bold-boosters/gravity-forms-bold-booster-for-paypal","path":"/guides/checkout/bold-boosters/gravity-forms-bold-booster-for-paypal","sidebar":"checkoutSidebar"},{"id":"checkout/bold-boosters/install-compatibility-modules","path":"/guides/checkout/bold-boosters/install-compatibility-modules","sidebar":"checkoutSidebar"},{"id":"checkout/bold-boosters/integrate-forter","path":"/guides/checkout/bold-boosters/integrate-forter"},{"id":"checkout/bold-boosters/m1-bold-booster-for-paypal","path":"/guides/checkout/bold-boosters/m1-bold-booster-for-paypal","sidebar":"checkoutSidebar"},{"id":"checkout/bold-boosters/opencart-bold-booster-for-paypal","path":"/guides/checkout/bold-boosters/opencart-bold-booster-for-paypal","sidebar":"checkoutSidebar"},{"id":"checkout/bold-boosters/set-up-apple-pay","path":"/guides/checkout/bold-boosters/set-up-apple-pay","sidebar":"checkoutSidebar"},{"id":"checkout/bold-boosters/set-up-google-pay","path":"/guides/checkout/bold-boosters/set-up-google-pay","sidebar":"checkoutSidebar"},{"id":"checkout/checkout-epg-guide","path":"/guides/checkout/checkout-epg-guide"},{"id":"checkout/checkout-getting-started","path":"/guides/checkout/checkout-getting-started","unlisted":true},{"id":"checkout/concepts/cart-parameters","path":"/guides/checkout/concepts/cart-parameters"},{"id":"checkout/concepts/external-payment-gateways","path":"/guides/checkout/concepts/external-payment-gateways"},{"id":"checkout/concepts/flows","path":"/guides/checkout/concepts/flows","unlisted":true},{"id":"checkout/concepts/headless","path":"/guides/checkout/concepts/headless","unlisted":true},{"id":"checkout/concepts/index","path":"/guides/checkout/concepts/"},{"id":"checkout/concepts/overrides","path":"/guides/checkout/concepts/overrides"},{"id":"checkout/concepts/payment-information","path":"/guides/checkout/concepts/payment-information","sidebar":"checkoutSidebar"},{"id":"checkout/concepts/plugins","path":"/guides/checkout/concepts/plugins"},{"id":"checkout/concepts/sdk-integrate","path":"/guides/checkout/concepts/sdk-integrate","unlisted":true},{"id":"checkout/concepts/spi-integrate","path":"/guides/checkout/concepts/spi-integrate","unlisted":true},{"id":"checkout/create-order","path":"/guides/checkout/create-order","unlisted":true},{"id":"checkout/css","path":"/guides/checkout/css"},{"id":"checkout/extend","path":"/guides/checkout/extend"},{"id":"checkout/fulfill-order","path":"/guides/checkout/fulfill-order"},{"id":"checkout/gift-cards","path":"/guides/checkout/gift-cards"},{"id":"checkout/index","path":"/guides/checkout/"},{"id":"checkout/integrations/commercetools","path":"/guides/checkout/integrations/commercetools"},{"id":"checkout/life","path":"/guides/checkout/life"},{"id":"checkout/meta","path":"/guides/checkout/meta","unlisted":true},{"id":"checkout/metrics","path":"/guides/checkout/metrics"},{"id":"checkout/plugins/app-hooks","path":"/guides/checkout/plugins/app-hooks"},{"id":"checkout/plugins/event-action-loop","path":"/guides/checkout/plugins/event-action-loop","unlisted":true},{"id":"checkout/plugins/getting-started","path":"/guides/checkout/plugins/getting-started","unlisted":true},{"id":"checkout/plugins/index","path":"/guides/checkout/plugins/"},{"id":"checkout/plugins/installation-flow","path":"/guides/checkout/plugins/installation-flow","unlisted":true},{"id":"checkout/plugins/overrides","path":"/guides/checkout/plugins/overrides"},{"id":"checkout/pmmc","path":"/guides/checkout/pmmc"},{"id":"checkout/populate-order","path":"/guides/checkout/populate-order","unlisted":true},{"id":"checkout/public-integrations","path":"/guides/checkout/public-integrations"},{"id":"checkout/quick-start","path":"/guides/checkout/quick-start"},{"id":"checkout/references/checkout-epg-api","path":"/guides/checkout/references/checkout-epg-api","unlisted":true},{"id":"checkout/references/checkout-spi-api","path":"/guides/checkout/references/checkout-spi-api","unlisted":true},{"id":"checkout/references/country-province-requirements","path":"/guides/checkout/references/country-province-requirements","unlisted":true},{"id":"checkout/references/epg-actions-events","path":"/guides/checkout/references/epg-actions-events","unlisted":true},{"id":"checkout/references/plugin-actions","path":"/guides/checkout/references/plugin-actions","unlisted":true},{"id":"checkout/references/plugin-events","path":"/guides/checkout/references/plugin-events","unlisted":true},{"id":"checkout/resources/access-scopes","path":"/guides/checkout/resources/access-scopes"},{"id":"checkout/resources/api-versioning","path":"/guides/checkout/resources/api-versioning"},{"id":"checkout/resources/error-responses","path":"/guides/checkout/resources/error-responses"},{"id":"checkout/resources/glossary","path":"/guides/checkout/resources/glossary"},{"id":"checkout/resources/open-source","path":"/guides/checkout/resources/open-source"},{"id":"checkout/resources/query-pagination","path":"/guides/checkout/resources/query-pagination"},{"id":"checkout/resources/rate-limiting","path":"/guides/checkout/resources/rate-limiting"},{"id":"checkout/resources/supported-platforms-gateways","path":"/guides/checkout/resources/supported-platforms-gateways"},{"id":"checkout/self-hosted-flow","path":"/guides/checkout/self-hosted-flow","unlisted":true},{"id":"checkout/validate-discounts","path":"/guides/checkout/validate-discounts"},{"id":"checkout/webhooks","path":"/guides/checkout/webhooks"},{"id":"platform-connector/concepts/components","path":"/guides/platform-connector/concepts/components"},{"id":"platform-connector/concepts/example-implementations","path":"/guides/platform-connector/concepts/example-implementations"},{"id":"platform-connector/concepts/index","path":"/guides/platform-connector/concepts/"},{"id":"platform-connector/create-server","path":"/guides/platform-connector/create-server"},{"id":"platform-connector/event-notifications","path":"/guides/platform-connector/event-notifications"},{"id":"platform-connector/getting-started","path":"/guides/platform-connector/getting-started"},{"id":"platform-connector/index","path":"/guides/platform-connector/"},{"id":"platform-connector/requirements","path":"/guides/platform-connector/requirements"},{"id":"platform-connector/rsa/concepts","path":"/guides/platform-connector/rsa/concepts"},{"id":"platform-connector/rsa/create-checkout-rsa","path":"/guides/platform-connector/rsa/create-checkout-rsa"},{"id":"platform-connector/rsa/requirements","path":"/guides/platform-connector/rsa/requirements"},{"id":"platform-connector/verify","path":"/guides/platform-connector/verify"},{"id":"platform-integration/adobe-commerce/concepts","path":"/guides/platform-integration/adobe-commerce/concepts"},{"id":"platform-integration/adobe-commerce/dev-store","path":"/guides/platform-integration/adobe-commerce/dev-store"},{"id":"platform-integration/adobe-commerce/flows/paypal-checkout-flow","path":"/guides/platform-integration/adobe-commerce/flows/paypal-checkout-flow"},{"id":"platform-integration/adobe-commerce/generate-module-list","path":"/guides/platform-integration/adobe-commerce/generate-module-list"},{"id":"platform-integration/adobe-commerce/overview","path":"/guides/platform-integration/adobe-commerce/overview"},{"id":"platform-integration/adobe-commerce/troubleshooting","path":"/guides/platform-integration/adobe-commerce/troubleshooting"},{"id":"platform-integration/adobe-commerce/versions","path":"/guides/platform-integration/adobe-commerce/versions"},{"id":"platform-integration/bigcommerce/pre","path":"/guides/platform-integration/bigcommerce/pre","sidebar":"preSidebar"},{"id":"platform-integration/commercetools/headless-checkout","path":"/guides/platform-integration/commercetools/headless-checkout"},{"id":"platform-integration/magento-1/concepts","path":"/guides/platform-integration/magento-1/concepts"},{"id":"platform-integration/magento-1/dev-store","path":"/guides/platform-integration/magento-1/dev-store"},{"id":"platform-integration/magento-1/extensions","path":"/guides/platform-integration/magento-1/extensions"},{"id":"platform-integration/magento-1/overview","path":"/guides/platform-integration/magento-1/overview"},{"id":"platform-integration/magento-1/troubleshooting","path":"/guides/platform-integration/magento-1/troubleshooting"},{"id":"platform-integration/magento-1/versions","path":"/guides/platform-integration/magento-1/versions"},{"id":"platform-integration/shopify/pre","path":"/guides/platform-integration/shopify/pre","sidebar":"preSidebar"},{"id":"price-rules/additional-resources","path":"/guides/price-rules/additional-resources"},{"id":"price-rules/attributes","path":"/guides/price-rules/attributes","sidebar":"preSidebar"},{"id":"price-rules/concepts/rulesets-and-rules","path":"/guides/price-rules/concepts/rulesets-and-rules","sidebar":"preSidebar"},{"id":"price-rules/customer-targeted-pricing","path":"/guides/price-rules/customer-targeted-pricing"},{"id":"price-rules/debug-tools","path":"/guides/price-rules/debug-tools","sidebar":"preSidebar"},{"id":"price-rules/discount-codes","path":"/guides/price-rules/discount-codes"},{"id":"price-rules/errors","path":"/guides/price-rules/errors","sidebar":"preSidebar"},{"id":"price-rules/getting-started","path":"/guides/price-rules/getting-started","sidebar":"preSidebar"},{"id":"price-rules/headless-storefront-setup","path":"/guides/price-rules/headless-storefront-setup","sidebar":"preSidebar"},{"id":"price-rules/index","path":"/guides/price-rules/","sidebar":"preSidebar"},{"id":"price-rules/promotion-info","path":"/guides/price-rules/promotion-info"},{"id":"price-rules/promotion-message","path":"/guides/price-rules/promotion-message","sidebar":"preSidebar"},{"id":"price-rules/public-integrations","path":"/guides/price-rules/public-integrations","sidebar":"preSidebar"},{"id":"price-rules/quick-start","path":"/guides/price-rules/quick-start","sidebar":"preSidebar"},{"id":"price-rules/references/actions","path":"/guides/price-rules/references/actions","sidebar":"preSidebar"},{"id":"price-rules/references/conditions","path":"/guides/price-rules/references/conditions","sidebar":"preSidebar"},{"id":"price-rules/references/frontend-api","path":"/guides/price-rules/references/frontend-api","sidebar":"preSidebar"},{"id":"price-rules/references/product-selection","path":"/guides/price-rules/references/product-selection","sidebar":"preSidebar"},{"id":"price-rules/references/ruleset-properties","path":"/guides/price-rules/references/ruleset-properties","sidebar":"preSidebar"},{"id":"price-rules/resources/access-scopes","path":"/guides/price-rules/resources/access-scopes","sidebar":"preSidebar"},{"id":"price-rules/resources/api-versioning","path":"/guides/price-rules/resources/api-versioning","sidebar":"preSidebar"},{"id":"price-rules/resources/error-responses","path":"/guides/price-rules/resources/error-responses","sidebar":"preSidebar"},{"id":"price-rules/resources/glossary","path":"/guides/price-rules/resources/glossary","sidebar":"preSidebar"},{"id":"price-rules/resources/open-source","path":"/guides/price-rules/resources/open-source","sidebar":"preSidebar"},{"id":"price-rules/resources/query-pagination","path":"/guides/price-rules/resources/query-pagination","sidebar":"preSidebar"},{"id":"price-rules/resources/rate-limiting","path":"/guides/price-rules/resources/rate-limiting","sidebar":"preSidebar"},{"id":"price-rules/resources/supported-platforms-gateways","path":"/guides/price-rules/resources/supported-platforms-gateways","sidebar":"preSidebar"},{"id":"price-rules/working-with-rulesets/cart-level-promotions","path":"/guides/price-rules/working-with-rulesets/cart-level-promotions","sidebar":"preSidebar"},{"id":"price-rules/working-with-rulesets/customer-targeted-pricing","path":"/guides/price-rules/working-with-rulesets/customer-targeted-pricing","sidebar":"preSidebar"},{"id":"price-rules/working-with-rulesets/discount-codes","path":"/guides/price-rules/working-with-rulesets/discount-codes","sidebar":"preSidebar"},{"id":"price-rules/working-with-rulesets/location-based-pricing","path":"/guides/price-rules/working-with-rulesets/location-based-pricing","sidebar":"preSidebar"},{"id":"price-rules/working-with-rulesets/managing-price-rules","path":"/guides/price-rules/working-with-rulesets/managing-price-rules","sidebar":"preSidebar"},{"id":"price-rules/working-with-rulesets/multi-currency","path":"/guides/price-rules/working-with-rulesets/multi-currency","sidebar":"preSidebar"},{"id":"price-rules/working-with-rulesets/order-condition","path":"/guides/price-rules/working-with-rulesets/order-condition","sidebar":"preSidebar"},{"id":"price-rules/working-with-rulesets/price-adjustments","path":"/guides/price-rules/working-with-rulesets/price-adjustments","sidebar":"preSidebar"},{"id":"price-rules/working-with-rulesets/prioritization-and-stacking","path":"/guides/price-rules/working-with-rulesets/prioritization-and-stacking","sidebar":"preSidebar"},{"id":"price-rules/working-with-rulesets/quantity-pricing","path":"/guides/price-rules/working-with-rulesets/quantity-pricing","sidebar":"preSidebar"},{"id":"price-rules/working-with-rulesets/scheduling","path":"/guides/price-rules/working-with-rulesets/scheduling","sidebar":"preSidebar"},{"id":"solutions/blueprints/abandoned-cart","path":"/guides/solutions/blueprints/abandoned-cart"},{"id":"solutions/blueprints/biometric-auth","path":"/guides/solutions/blueprints/biometric-auth"},{"id":"solutions/blueprints/blog","path":"/guides/solutions/blueprints/blog"},{"id":"solutions/blueprints/buy-now","path":"/guides/solutions/blueprints/buy-now"},{"id":"solutions/blueprints/klarna","path":"/guides/solutions/blueprints/klarna"},{"id":"solutions/blueprints/platform-connector","path":"/guides/solutions/blueprints/platform-connector"},{"id":"solutions/blueprints/search-algolia","path":"/guides/solutions/blueprints/search-algolia"},{"id":"solutions/blueprints/search-constructor","path":"/guides/solutions/blueprints/search-constructor"},{"id":"solutions/blueprints/template","path":"/guides/solutions/blueprints/template","unlisted":true},{"id":"solutions/blueprints/upsell","path":"/guides/solutions/blueprints/upsell"},{"id":"solutions/bold-built/adobe","path":"/guides/solutions/bold-built/adobe"},{"id":"solutions/bold-built/bigcommerce","path":"/guides/solutions/bold-built/bigcommerce"},{"id":"solutions/bold-built/braintree","path":"/guides/solutions/bold-built/braintree"},{"id":"solutions/bold-built/commercetools","path":"/guides/solutions/bold-built/commercetools"},{"id":"solutions/bold-built/magento-1","path":"/guides/solutions/bold-built/magento-1"},{"id":"solutions/bold-built/payment-booster","path":"/guides/solutions/bold-built/payment-booster"},{"id":"solutions/bold-built/paypal-checkout-flow","path":"/guides/solutions/bold-built/paypal-checkout-flow"},{"id":"solutions/bold-built/ppcp","path":"/guides/solutions/bold-built/ppcp"},{"id":"solutions/bold-built/shipping","path":"/guides/solutions/bold-built/shipping"},{"id":"solutions/bold-built/stripe","path":"/guides/solutions/bold-built/stripe"},{"id":"solutions/bold-built/taxjar","path":"/guides/solutions/bold-built/taxjar"},{"id":"solutions/bold-built/template","path":"/guides/solutions/bold-built/template","unlisted":true},{"id":"solutions/example-projects/custom-flow","path":"/guides/solutions/example-projects/custom-flow"},{"id":"solutions/example-projects/express-pay","path":"/guides/solutions/example-projects/express-pay"},{"id":"solutions/example-projects/template","path":"/guides/solutions/example-projects/template","unlisted":true},{"id":"subscriptions-v2/adjust-subscription-orders","path":"/guides/subscriptions-v2/adjust-subscription-orders","sidebar":"subscriptionsSidebar"},{"id":"subscriptions-v2/concepts","path":"/guides/subscriptions-v2/concepts","sidebar":"subscriptionsSidebar"},{"id":"subscriptions-v2/create-line-items","path":"/guides/subscriptions-v2/create-line-items","sidebar":"subscriptionsSidebar"},{"id":"subscriptions-v2/create-subscription","path":"/guides/subscriptions-v2/create-subscription","sidebar":"subscriptionsSidebar"},{"id":"subscriptions-v2/customer-portals/index","path":"/guides/subscriptions-v2/customer-portals/","sidebar":"subscriptionsSidebar"},{"id":"subscriptions-v2/getting-started","path":"/guides/subscriptions-v2/getting-started","sidebar":"subscriptionsSidebar"},{"id":"subscriptions-v2/headless/storefront-setup","path":"/guides/subscriptions-v2/headless/storefront-setup","sidebar":"subscriptionsSidebar"},{"id":"subscriptions-v2/index","path":"/guides/subscriptions-v2/","sidebar":"subscriptionsSidebar"},{"id":"subscriptions-v2/line-items","path":"/guides/subscriptions-v2/line-items","sidebar":"subscriptionsSidebar"},{"id":"subscriptions-v2/public-integrations","path":"/guides/subscriptions-v2/public-integrations","sidebar":"subscriptionsSidebar"},{"id":"subscriptions-v2/quick-start","path":"/guides/subscriptions-v2/quick-start","sidebar":"subscriptionsSidebar"},{"id":"subscriptions-v2/resources/access-scopes","path":"/guides/subscriptions-v2/resources/access-scopes","sidebar":"subscriptionsSidebar"},{"id":"subscriptions-v2/resources/api-versioning","path":"/guides/subscriptions-v2/resources/api-versioning","sidebar":"subscriptionsSidebar"},{"id":"subscriptions-v2/resources/error-responses","path":"/guides/subscriptions-v2/resources/error-responses","sidebar":"subscriptionsSidebar"},{"id":"subscriptions-v2/resources/glossary","path":"/guides/subscriptions-v2/resources/glossary","sidebar":"subscriptionsSidebar"},{"id":"subscriptions-v2/resources/open-source","path":"/guides/subscriptions-v2/resources/open-source","sidebar":"subscriptionsSidebar"},{"id":"subscriptions-v2/resources/query-pagination","path":"/guides/subscriptions-v2/resources/query-pagination","sidebar":"subscriptionsSidebar"},{"id":"subscriptions-v2/resources/rate-limiting","path":"/guides/subscriptions-v2/resources/rate-limiting","sidebar":"subscriptionsSidebar"},{"id":"subscriptions-v2/resources/supported-platforms-gateways","path":"/guides/subscriptions-v2/resources/supported-platforms-gateways","sidebar":"subscriptionsSidebar"},{"id":"subscriptions-v2/update-subscription","path":"/guides/subscriptions-v2/update-subscription","sidebar":"subscriptionsSidebar"},{"id":"subscriptions-v2/view-future-orders","path":"/guides/subscriptions-v2/view-future-orders","sidebar":"subscriptionsSidebar"},{"id":"subscriptions-v2/webhooks","path":"/guides/subscriptions-v2/webhooks","sidebar":"subscriptionsSidebar"},{"id":"subscriptions-v2/widgets","path":"/guides/subscriptions-v2/widgets","sidebar":"subscriptionsSidebar"}],"draftIds":[],"sidebars":{"checkoutSidebar":{"link":{"path":"/guides/checkout/bold-boosters/bold-booster-for-paypal-overview","label":"Overview"}},"subscriptionsSidebar":{"link":{"path":"/guides/subscriptions-v2/","label":"subscriptions-v2/index"}},"preSidebar":{"link":{"path":"/guides/price-rules/","label":"price-rules/index"}},"otherApisSidebar":{"link":{"path":"/guides/archive/","label":"Other APIs"}}}}],"breadcrumbs":true}},"docusaurus-plugin-google-tag-manager":{"default":{"containerId":"GTM-NFVCMDW","id":"default"}},"docusaurus-plugin-redoc":{"plugin-redoc-0":{"url":"/api/checkout-frontend.openapi.yaml","themeId":"theme-redoc","isSpecFile":true,"spec":{"openapi":"3.0.0","info":{"title":"Checkout Frontend","version":"2.0","description":"The Checkout Frontend API is used to interact with an order. This includes the ability to get and manipulate order details from a browser.\\n\\nRefer to the changelog for the latest updates to this API.","termsOfService":"https://boldcommerce.com/terms-of-service","contact":{"name":"Contact Us","url":"https://developer-dashboard.boldcommerce.com/default/contactus"}},"servers":[{"url":"https://api.boldcommerce.com"}],"security":[{"JWT":[]}],"tags":[{"name":"Addresses","description":"A child of the Order resource. Contains information about shipping and billing addresses. Use these endpoints to add shipping and billing addresses to an order."},{"name":"Batch Process","description":"Enables batch processing of certain Checkout Frontend endpoints."},{"name":"Customers","description":"A child of the Order resource. Contains information about guest customers on your store, including name and email. Use these endpoints to add or remove a guest customer to an order."},{"name":"Discounts","description":"Contains information about discount codes that have been applied to an order. Use these endpoints to manipulate discount codes on an order."},{"name":"Line Items","description":"A child of the Order resource. Contains information about the product and the taxes, fees, and discounts associated with it. Use these endpoints to manipulate line items on an order."},{"name":"Metadata","description":"A child of the Order resource. Contains metadata about the order, including cart parameters, note attributes, nots, and tags. Use these endpoints to manipulate the metadata on an order."},{"name":"Orders","description":"Contains information about a single order, including the full application state of the order. Use these endpoints to retrieve the application state, manipulate order metadata, process the order, and complete other order-related functions."},{"name":"Payments","description":"A child of the Order resource. Contains information about the payments on an order. Use these endpoints to manipulate the payments on an order."},{"name":"Payment Iframes","description":"Contains information about the [Secure Payments Interface (SPI)](/guides/checkout/resources/glossary#secure-payments-interface-spi). Use these endpoints to manipulate the SPI iFrame."},{"name":"Shipping Lines","description":"A child of the Order resource. Contains information about the order\'s shipping line, which is created via the [Bold Checkout admin](https://apps.boldapps.net/accounts/app/4). Use these endpoints to manipulate the shipping lines set on an order."},{"name":"Taxes","description":"A child of the Order resource. Contains information about order-level taxes. Use these endpoints to generate order-level taxes."},{"name":"Wallet Pay","description":"Contains information about wallet payments. Use these endpoints to create, update, and capture wallet pay orders. These endpoints currently support PayPal only."}],"externalDocs":{"description":"For more information about Checkout, refer to the Overview.","url":"https://developer.boldcommerce.com/guides/checkout"},"paths":{"/checkout/storefront/{shop_identifier}/{public_order_id}/addresses/shipping":{"parameters":[{"$ref":"#/components/parameters/shop_identifier"},{"$ref":"#/components/parameters/public_order_id"}],"post":{"summary":"Set Shipping Address","operationId":"SetShippingAddress","tags":["Addresses"],"description":"Sets the shipping address on the order.\\n\\nEach order can have only one shipping address. If you call this endpoint and a shipping address already exists, the existing address is overwritten.\\n\\nSet Shipping Address calls [Validate Address](checkout#operation/ValidateAddress) before setting the shipping address.\\n\\n> **Note:** Checkout admin settings can override schema requirements for `phone_number` and `business_name`. If `phone_number` or `business_name` are set to `required` in the [Bold Checkout admin](https://apps.boldapps.net/accounts/app/4), they are also `required` in this endpoint.","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Address"}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"address":{"$ref":"#/components/schemas/Address"},"application_state":{"$ref":"#/components/schemas/ApplicationState"}}}}}}}},"401":{"$ref":"#/components/responses/Unauthorized-JWT"},"422":{"description":"Unprocessable Entity","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnprocessableEntity"},"example":{"errors":[{"message":"The country field is required.","type":"order","field":"country","severity":"validation","sub_type":"shipping_address"},{"message":"The country code field is required.","type":"order","field":"country_code","severity":"validation","sub_type":"shipping_address"}]}}}}}},"get":{"summary":"Get Shipping Address","operationId":"GetShippingAddress","tags":["Addresses"],"description":"Gets the shipping address on the order.","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"address":{"$ref":"#/components/schemas/Address"},"application_state":{"$ref":"#/components/schemas/ApplicationState"}}}}}}}},"401":{"$ref":"#/components/responses/Unauthorized-JWT"},"403":{"description":"Forbidden"}}},"put":{"summary":"Update Shipping Address","operationId":"UpdateShippingAddress","tags":["Addresses"],"description":"Updates the shipping address on the order.\\n\\nThis endpoint updates all fields of the shipping address. Any value left blank in the request body will be made blank in the updated address. The fields `country`, `country_code`, `province`, and `province_code` cannot be left blank.\\n\\n> **Note:** Checkout admin settings can override schema requirements for `phone_number` and `business_name`. If `phone_number` or `business_name` are set to `required` in the [Bold Checkout admin](https://apps.boldapps.net/accounts/app/4), they are also `required` in this endpoint.\\n\\n> **Note:** If taxes were previously calculated, changes to the shipping address may affect those calculations. Taxes are not recalculated automatically, so you must call the [Generate Taxes](checkout#operation/GenerateTaxes) endpoint to recalculate taxes for the order.","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Address"}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"address":{"$ref":"#/components/schemas/Address"},"application_state":{"$ref":"#/components/schemas/ApplicationState"}}}}}}}},"401":{"$ref":"#/components/responses/Unauthorized-JWT"},"422":{"description":"Unprocessable Entity","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnprocessableEntity"},"example":{"errors":[{"message":"The country field is required.","type":"order","field":"country","severity":"validation","sub_type":"shipping_address"},{"message":"The country code field is required.","type":"order","field":"country_code","severity":"validation","sub_type":"shipping_address"}]}}}}}},"delete":{"summary":"Delete Shipping Address","operationId":"DeleteShippingAddress","tags":["Addresses"],"description":"Clears the shipping address from the order.\\n\\n> **Note:** If taxes were previously calculated, changes to the shipping address may affect those calculations. Taxes are not recalculated automatically, so you must call the [Generate Taxes](checkout#operation/GenerateTaxes) endpoint to recalculate taxes for the order.","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"application_state":{"$ref":"#/components/schemas/ApplicationState"}}}}},"examples":{"DeletedShippingAddress":{"$ref":"#/components/examples/DeletedShippingAddress"}}}}},"401":{"$ref":"#/components/responses/Unauthorized-JWT"}}}},"/checkout/storefront/{shop_identifier}/{public_order_id}/addresses/billing":{"parameters":[{"$ref":"#/components/parameters/shop_identifier"},{"$ref":"#/components/parameters/public_order_id"}],"post":{"summary":"Set Billing Address","operationId":"SetBillingAddress","tags":["Addresses"],"description":"Sets the billing address on the order.\\n\\nEach order can have only one billing address. If you call this endpoint and a billing address already exists, the existing address will be overwritten.\\n\\nSet Billing Address calls [Validate Address](checkout#operation/ValidateAddress) before setting the billing address.\\n\\n> **Note:** Checkout admin settings can override schema requirements for `phone_number` and `business_name`. If `phone_number` or `business_name` are set to `required` in the [Bold Checkout admin](https://apps.boldapps.net/accounts/app/4), they are also `required` in this endpoint.","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Address"}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"address":{"$ref":"#/components/schemas/Address"},"application_state":{"$ref":"#/components/schemas/ApplicationState"}}}}}}}},"401":{"$ref":"#/components/responses/Unauthorized-JWT"},"422":{"description":"Unprocessable Entity","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnprocessableEntity"},"example":{"errors":[{"message":"The country field is required.","type":"order","field":"country","severity":"validation","sub_type":"billing_address"},{"message":"The country code field is required.","type":"order","field":"country_code","severity":"validation","sub_type":"billing_address"}]}}}}}},"get":{"summary":"Get Billing Address","operationId":"GetBillingAddress","tags":["Addresses"],"description":"Get the billing address on the order.","responses":{"200":{"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"address":{"$ref":"#/components/schemas/Address"},"application_state":{"$ref":"#/components/schemas/ApplicationState"}}}}}}},"description":""},"201":{"description":"Created"},"401":{"$ref":"#/components/responses/Unauthorized-JWT"}}},"put":{"summary":"Update Billing Address","operationId":"UpdateBillingAddress","tags":["Addresses"],"description":"Updates the billing address on the order.\\n\\nThis endpoint updates all fields of the billing address associated with the order, and any value left blank in this request body will be made blank in the updated address. The fields `country`, `country_code`, `province`, and `province_code` cannot be left blank.\\n\\n> **Note:** Checkout admin settings can override schema requirements for `phone_number` and `business_name`. If `phone_number` or `business_name` are set to `required` in the [Bold Checkout admin](https://apps.boldapps.net/accounts/app/4), they are also `required` in this endpoint.","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Address"}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"address":{"$ref":"#/components/schemas/Address"},"application_state":{"$ref":"#/components/schemas/ApplicationState"}}}}}}}},"401":{"$ref":"#/components/responses/Unauthorized-JWT"},"422":{"description":"Unprocessable Entity","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnprocessableEntity"},"example":{"errors":[{"message":"The country field is required.","type":"order","field":"country","severity":"validation","sub_type":"billing_address"},{"message":"The country code field is required.","type":"order","field":"country_code","severity":"validation","sub_type":"billing_address"}]}}}}}},"delete":{"summary":"Delete Billing Address","operationId":"DeleteBillingAddress","tags":["Addresses"],"description":"Clears the billing address from the order.","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"application_state":{"$ref":"#/components/schemas/ApplicationState"}}}}},"examples":{"DeletedBillingAddress":{"$ref":"#/components/examples/DeletedBillingAddress"}}}}},"401":{"$ref":"#/components/responses/Unauthorized-JWT"}}}},"/checkout/storefront/{shop_identifier}/{public_order_id}/validate_address":{"parameters":[{"$ref":"#/components/parameters/shop_identifier"},{"$ref":"#/components/parameters/public_order_id"}],"get":{"summary":"Validate Address","operationId":"ValidateAddress","tags":["Addresses"],"description":"Validates if the given postal code matches up with postal codes from Canada, US, Ireland, Great Britain, France or Singapore. This endpoint also validates the state/province provided, if required by country. Countries that require a state/province in their address are listed in the [Country and Province/State Requirements reference](/guides/checkout/references/country-province-requirements).\\n\\nCalls to the [Set Shipping Address](checkout#operation/SetShippingAddress), [Set Billing Address](checkout#operation/SetBillingAddress), [Update Shipping Address](checkout#operation/UpdateShippingAddress), or [Update Billing Address](checkout#operation/UpdateBillingAddress) endpoints apply the same validations applied by this endpoint.\\n\\nCalling this endpoint does not change the application state or apply the address. While not required, it can be helpful to call this endpoint before setting or updating an address on an order, especially if you want to implement custom error handling in more complicated address scenarios.\\n\\n> **Note:** Checkout admin settings can override schema requirements for `phone_number` and `business_name`. If `phone_number` or `business_name` are set to `required` in the [Bold Checkout admin](https://apps.boldapps.net/accounts/app/4), they are also `required` in this endpoint.\\n","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Address"}}}},"responses":{"200":{"description":"Address is valid","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","minItems":0,"maxItems":0,"items":{"type":"string"}}}}}}},"401":{"$ref":"#/components/responses/Unauthorized-JWT"},"422":{"description":"Unprocessable Entity","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnprocessableEntity"},"examples":{"example-1":{"value":{"errors":[{"message":"The country code field is required.","type":"address","field":"country_code","severity":"validation","sub_type":""},{"message":"The postal code field is required.","type":"address","field":"postal_code","severity":"validation","sub_type":""},{"message":"The province field is required.","type":"address","field":"province","severity":"validation","sub_type":""}]}}}}}}}}},"/checkout/storefront/{shop_identifier}/{public_order_id}/customer/guest":{"parameters":[{"$ref":"#/components/parameters/shop_identifier"},{"$ref":"#/components/parameters/public_order_id"}],"post":{"summary":"Create Guest Customer","operationId":"CreateGuestCustomer","tags":["Customers"],"description":"Creates a new guest customer and associates it with the order.\\n\\nYou cannot create a new guest customer when there is already one on the order.\\n\\nTo add a new guest customer to an order or add an authenticated customer, you must first delete the existing customer using the [Delete Customer](checkout#operation/DeleteCustomer) endpoint.","requestBody":{"$ref":"#/components/requestBodies/CustomerBody"},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"customer":{"$ref":"#/components/schemas/Customer"},"application_state":{"$ref":"#/components/schemas/ApplicationState"}}}}},"examples":{"GuestCustomer":{"$ref":"#/components/examples/GuestCustomer"}}}}},"401":{"$ref":"#/components/responses/Unauthorized-JWT"},"422":{"description":"Unprocessable Entity","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnprocessableEntity"},"example":{"errors":[{"message":"The country field is required.","type":"order","field":"country","severity":"validation","sub_type":"billing_address"}]}}}}}},"put":{"summary":"Update Guest Customer","operationId":"UpdateGuestCustomer","tags":["Customers"],"deprecated":true,"description":"> **Note:** This endpoint is deprecated. Instead, use the [Update Customer](checkout#operation/UpdateCustomer) endpoint to make edits to the customer on the order.\\n\\nUpdates the guest customer on the order.\\n\\nCannot update customer data that was provided from the [Initialize Order](orders#operation/InitializeOrder) endpoint.","requestBody":{"$ref":"#/components/requestBodies/CustomerBody"},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"customer":{"$ref":"#/components/schemas/Customer"},"application_state":{"$ref":"#/components/schemas/ApplicationState"}}}}},"examples":{"GuestCustomer":{"$ref":"#/components/examples/GuestCustomer"}}}}},"401":{"$ref":"#/components/responses/Unauthorized-JWT"},"422":{"description":"Unprocessable Entity","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnprocessableEntity"},"example":{"errors":[{"message":"The email address field is required.","type":"order","field":"email_address","severity":"validation","sub_type":"customer"}]}}}}}}},"/checkout/storefront/{shop_identifier}/{public_order_id}/customer":{"parameters":[{"$ref":"#/components/parameters/shop_identifier"},{"$ref":"#/components/parameters/public_order_id"}],"put":{"summary":"Update Customer","operationId":"UpdateCustomer","description":"Updates the customer on the order.\\nThis endpoint does not update the `platform_id`, `public_id`, or `saved_addresses` fields.\\nYou can add customers to the order via the [Initialize Order](orders#operation/InitializeOrder), the [Create Authenticated Customer](orders#operation/CreateAuthenticatedCustomer) and the [Create Guest Customer](checkout#operation/CreateGuestCustomer) endpoints.","requestBody":{"$ref":"#/components/requestBodies/CustomerBody"},"tags":["Customers"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"customer":{"$ref":"#/components/schemas/Customer"},"application_state":{"$ref":"#/components/schemas/ApplicationState"}}}}},"examples":{"GuestCustomer":{"$ref":"#/components/examples/GuestCustomer"}}}}},"401":{"$ref":"#/components/responses/Unauthorized-JWT"},"422":{"description":"Unprocessable Entity","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnprocessableEntity"},"example":{"errors":[{"message":"The email address field is required.","type":"order","field":"email_address","severity":"validation","sub_type":"customer"}]}}}}}},"get":{"summary":"Get Customer","operationId":"GetCustomer","tags":["Customers"],"description":"Retrieves information about the customer on the order.","responses":{"200":{"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"customer":{"$ref":"#/components/schemas/Customer"},"application_state":{"$ref":"#/components/schemas/ApplicationState"}}}}}}},"description":""},"401":{"$ref":"#/components/responses/Unauthorized-JWT"}}},"delete":{"summary":"Delete Customer","operationId":"DeleteCustomer","tags":["Customers"],"description":"Deletes the customer from the order.","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"application_state":{"$ref":"#/components/schemas/ApplicationState"}}}}},"examples":{"DeletedCustomer":{"$ref":"#/components/examples/NoCustomer"}}}}},"401":{"$ref":"#/components/responses/Unauthorized-JWT"}}}},"/checkout/storefront/{shop_identifier}/{public_order_id}/validate_email_address":{"parameters":[{"$ref":"#/components/parameters/shop_identifier"},{"$ref":"#/components/parameters/public_order_id"}],"get":{"summary":"Validate Email Address","operationId":"ValidateEmailAddress","tags":["Customers"],"description":"Validates the email address and performs an MX check to make sure the domain can accept email.\\n\\nNote that this endpoint does _not_ validate that the the email address exists on the domain.","parameters":[{"schema":{"type":"string","example":"john.doe@example.com"},"in":"query","name":"email_address","required":true,"description":"The email address to be validated."}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","minItems":0,"maxItems":0,"items":{"type":"string"}}}}}}},"401":{"$ref":"#/components/responses/Unauthorized-JWT"},"422":{"description":"Unprocessable Entity","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnprocessableEntity"},"example":{"errors":[{"message":"Email format is invalid.","type":"validation","field":"email","severity":"validation","sub_type":"email"},{"message":"Email is required.","type":"validation","field":"email","severity":"validation","sub_type":"email"}]}}}}}}},"/checkout/storefront/{shop_identifier}/{public_order_id}/shipping_lines":{"parameters":[{"$ref":"#/components/parameters/shop_identifier"},{"$ref":"#/components/parameters/public_order_id"}],"post":{"summary":"Set Shipping Line","operationId":"SetShippingLine","tags":["Shipping Lines"],"description":"Sets the shipping line to one of the available shipping lines on the order. Shipping lines can only be set by index and cannot be set directly.\\n\\nUse the [Bold Checkout admin](https://apps.boldapps.net/accounts/app/4) to create and configure shipping lines for your store.\\n\\n> **Note:** Checkout admin settings can override schema representation for shipping lines. If \\"Default Shipping Option\\" is set to `Least`/`Most expensive first` in the [Bold Checkout admin](https://apps.boldapps.net/accounts/app/4), the shipping lines returned in this endpoint are ordered according to that setting.","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"index":{"type":"string","description":"The index of a shipping line. Find the desired shipping line index using the [List Shipping Lines](checkout#operation/ListShippingLines) endpoint."}}},"example":{"index":"0"}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"selected_shipping":{"$ref":"#/components/schemas/ShippingLine"},"application_state":{"$ref":"#/components/schemas/ApplicationState"}}}}}}}},"401":{"$ref":"#/components/responses/Unauthorized-JWT"},"422":{"description":"Unprocessable Entity","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnprocessableEntity"},"example":{"errors":[{"message":"The index field is required.","type":"order","field":"index","severity":"validation","sub_type":"index"}]}}}}}},"get":{"summary":"List Shipping Lines","operationId":"ListShippingLines","tags":["Shipping Lines"],"description":"Retrieves the shipping lines configured on the store.\\n\\nUse the [Bold Checkout admin](https://apps.boldapps.net/accounts/app/4) to create and configure shipping lines for your store.\\n\\n> **Note:** Checkout admin settings can override schema representation for shipping lines. If \\"Default Shipping Option\\" is set to `Least`/`Most expensive first` in the [Bold Checkout admin](https://apps.boldapps.net/accounts/app/4), the shipping lines returned in this endpoint are ordered according to that setting.","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"shipping_lines":{"type":"array","items":{"$ref":"#/components/schemas/ShippingLine"}},"application_state":{"$ref":"#/components/schemas/ApplicationState"}}}}}}}},"401":{"$ref":"#/components/responses/Unauthorized-JWT"},"422":{"description":"Unprocessable Entity","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnprocessableEntity"}}}}}}},"/checkout/storefront/{shop_identifier}/{public_order_id}/shipping_lines/estimate":{"parameters":[{"$ref":"#/components/parameters/shop_identifier"},{"$ref":"#/components/parameters/public_order_id"}],"post":{"summary":"Estimate Shipping Line","operationId":"EstimateShippingLine","tags":["Shipping Lines"],"description":"Generates an estimate for the order\'s shipping line and shipping cost based on the shipping address provided.\\n\\nBased on the address provided, this endpoint adds a `shipping_address` and an additional entry in the `available_shipping_lines` array. It does not, however, select that shipping line for the order.\\n\\n> **Note:** This endpoint is only supported on stores that use a [Remote State Authority (RSA)](/guides/platform-connector/rsa/create-checkout-rsa). With RSA set up, this endpoint triggers the `estimate_shipping` event.","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Estimate"}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"shipping_lines":{"$ref":"#/components/schemas/ShippingLine"},"application_state":{"$ref":"#/components/schemas/ApplicationState"}}}}}}}},"401":{"$ref":"#/components/responses/Unauthorized-JWT"},"422":{"description":"Unprocessable Entity","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnprocessableEntity"},"example":{"errors":[{"message":"The index field is required.","type":"order","field":"index","severity":"validation","sub_type":"index"}]}}}}}}},"/checkout/storefront/{shop_identifier}/{public_order_id}/taxes":{"parameters":[{"$ref":"#/components/parameters/shop_identifier"},{"$ref":"#/components/parameters/public_order_id"}],"post":{"summary":"Generate Taxes","operationId":"GenerateTaxes","tags":["Taxes"],"description":"Calculates and applies taxes to the order. Calculated taxes must be present in the `application_state` before you call the [Process Order](checkout#operation/ProcessOrder) endpoint. Otherwise, the API returns an error and does not process the order.\\n\\nBefore calling this endpoint, configure your store\'s tax settings in the [Bold Checkout admin](https://apps.boldapps.net/accounts/app/4), including tax zones, the tax provider, and whether the price of shipping should be taxed.\\n\\nTaxes are calculated for each line item, for the shipping (if applicable), and for the whole order \u2014 the returned `application_state` reflects all of these calculations.\\n\\nTaxes are not automatically recalculated, so you must call this endpoint after you make any changes to the shipping address. Bold recommends calling this endpoint after calling the [Set Shipping Line](checkout#operation/SetShippingLine) endpoint.","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"taxes":{"type":"array","items":{"$ref":"#/components/schemas/Tax"}},"application_state":{"$ref":"#/components/schemas/ApplicationState"}}}}}}}},"401":{"$ref":"#/components/responses/Unauthorized-JWT"},"422":{"description":"Unprocessable Entity","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnprocessableEntity"}}}}}}},"/checkout/storefront/{shop_identifier}/{public_order_id}/taxes/estimate":{"parameters":[{"$ref":"#/components/parameters/shop_identifier"},{"$ref":"#/components/parameters/public_order_id"}],"post":{"summary":"Estimate Taxes","operationId":"EstimateTaxes","tags":["Taxes"],"description":"Generates an estimate for the order\'s taxes. For an accurate calculation, provide the shipping address in the request body.\\n\\nThis endpoint adds the shipping address to the application state but does **NOT** apply the estimated tax calculation to the order.\\n\\n> **Note:** This endpoint is only supported on stores that use a [Remote State Authority (RSA)](/guides/platform-connector/rsa/create-checkout-rsa). With RSA set up, this endpoint triggers the `estimate_tax` event.","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Estimate"}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"taxes":{"type":"array","items":{"$ref":"#/components/schemas/Tax"}},"application_state":{"$ref":"#/components/schemas/ApplicationState"}}}}}}}},"401":{"$ref":"#/components/responses/Unauthorized-JWT"},"422":{"description":"Unprocessable Entity","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnprocessableEntity"}}}}}}},"/checkout/storefront/{shop_identifier}/{public_order_id}/items":{"parameters":[{"$ref":"#/components/parameters/shop_identifier"},{"$ref":"#/components/parameters/public_order_id"}],"post":{"summary":"Add Line Item","operationId":"AddLineItem","tags":["Line Items"],"description":"Adds a new line item to the order.\\n\\nOnly products that have already been synced to Checkout can be added from the frontend. One of either the `sku` or the `platform_id` is required.\\n\\nThis endpoint can also add a gift card to an order.","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CartItem"},"examples":{"CartItem":{"$ref":"#/components/examples/CartItem"},"GiftCardCartItem":{"$ref":"#/components/examples/CartItemGiftCard"}}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"line_items":{"type":"array","items":{"$ref":"#/components/schemas/LineItem"}},"application_state":{"$ref":"#/components/schemas/ApplicationState"}}}}},"examples":{"CartItemResponse":{"$ref":"#/components/examples/CartItemResponse"},"GiftCardResponse":{"$ref":"#/components/examples/GiftCardLineItem"}}}}},"401":{"$ref":"#/components/responses/Unauthorized-JWT"},"422":{"description":"Unprocessable Entity","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnprocessableEntity"},"example":{"errors":[{"message":"The line item key field is required.","type":"item","field":"line_item_key","severity":"validation","sub_type":"customer"}]}}}}}},"get":{"summary":"List Line Items","operationId":"ListLineItems","tags":["Line Items"],"description":"Retrieves a list of all the items on the order. This endpoint returns the `product_data` for each line item on the order.","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"line_items":{"type":"array","items":{"$ref":"#/components/schemas/LineItem"}},"application_state":{"$ref":"#/components/schemas/ApplicationState"}}}}}}}},"401":{"$ref":"#/components/responses/Unauthorized-JWT"}}},"put":{"summary":"Update Line Item Quantity","operationId":"UpdateLineItemQuantity","tags":["Line Items"],"description":"Updates the quantity of the line item on the order. Refer to the line to be updated by `line_item_key`.","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CartItem"}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"line_item":{"$ref":"#/components/schemas/LineItem"},"application_state":{"$ref":"#/components/schemas/ApplicationState"}}}}}}}},"401":{"$ref":"#/components/responses/Unauthorized-JWT"},"422":{"description":"Unprocessable Entity","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnprocessableEntity"},"example":{"errors":[{"message":"The quantity field is required.","type":"item","field":"quantity","severity":"validation","sub_type":"customer"}]}}}}}},"delete":{"summary":"Delete Line Item","operationId":"DeleteLineItem","tags":["Line Items"],"description":"Removes a line item from an order. Refer to the line to remove by `line_item_key`.","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CartItem"}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"line_items":{"type":"array","items":{"$ref":"#/components/schemas/LineItem"}},"application_state":{"$ref":"#/components/schemas/ApplicationState"}}}}},"examples":{"DeletedLineItem":{"$ref":"#/components/examples/DeletedLineItem"}}}}},"401":{"$ref":"#/components/responses/Unauthorized-JWT"},"422":{"description":"Unprocessable Entity","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnprocessableEntity"},"example":{"errors":[{"message":"The line item key field is required.","type":"item","field":"line_item_key","severity":"validation","sub_type":"customer"}]}}}}}}},"/checkout/storefront/{shop_identifier}/{public_order_id}/payments":{"parameters":[{"$ref":"#/components/parameters/shop_identifier"},{"$ref":"#/components/parameters/public_order_id"}],"post":{"summary":"Create Payment","operationId":"CreatePayment","tags":["Payments"],"description":"Adds a new payment to the order.","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"payment":{"$ref":"#/components/schemas/Payment"},"application_state":{"$ref":"#/components/schemas/ApplicationState"}}}}}}}},"401":{"$ref":"#/components/responses/Unauthorized-JWT"},"422":{"description":"Unprocessable Entity","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnprocessableEntity"},"examples":{"example-1":{"value":{"message":"The gateway public id field is required.","type":"order","field":"gateway_public_id","severity":"validation","sub_type":"payment"}}}}}}},"requestBody":{"description":"The payment `gateway_public_id` tells Bold Checkout which payment gateway to use and is therefore required. The `token` key is also required.\\n\\nThe `amount` is optional. If this value is left empty, Bold Checkout sets the payment amount to the order total or to the maximum value that the payment method supports (e.g., for a gift card payment).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Payment"}}}}},"get":{"summary":"List Payments","operationId":"ListPayments","tags":["Payments"],"description":"Lists the payments that have been applied to the order.","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"payments":{"type":"array","items":{"$ref":"#/components/schemas/Payment"}},"application_state":{"$ref":"#/components/schemas/ApplicationState"}}}}}}}},"401":{"$ref":"#/components/responses/Unauthorized-JWT"}}},"put":{"summary":"Update Payment","operationId":"UpdatePayment","tags":["Payments"],"description":"Updates the value of the payment. Only the amount of payment can be changed.","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"payment":{"$ref":"#/components/schemas/Payment"},"application_state":{"$ref":"#/components/schemas/ApplicationState"}}}}}}}},"401":{"$ref":"#/components/responses/Unauthorized-JWT"},"422":{"description":"Unprocessable Entity","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnprocessableEntity"},"examples":{"example-1":{"value":{"message":"The gateway public id field is required.","type":"order","field":"gateway_public_id","severity":"validation","sub_type":"payment"}}}}}}},"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Payment"}}}}},"delete":{"summary":"Remove Payment","operationId":"RemovePayment","tags":["Payments"],"description":"Removes the payment by token.","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"application_state":{"$ref":"#/components/schemas/ApplicationState"}}}}},"examples":{"DeletedPayment":{"$ref":"#/components/examples/DeletedPayment"}}}}},"401":{"$ref":"#/components/responses/Unauthorized-JWT"},"422":{"description":"Unprocessable Entity","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnprocessableEntity"},"examples":{"example-1":{"value":{"message":"The gateway public id field is required.","type":"order","field":"gateway_public_id","severity":"validation","sub_type":"payment"}}}}}}},"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Payment"}}}}}},"/checkout/storefront/{shop_identifier}/{public_order_id}/payments/gift_card":{"parameters":[{"$ref":"#/components/parameters/shop_identifier"},{"$ref":"#/components/parameters/public_order_id"}],"delete":{"summary":"Remove Gift Card Payment","operationId":"RemoveGiftCardPayment","tags":["Payments"],"description":"Removes a gift card payment by ID.","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"application_state":{"$ref":"#/components/schemas/ApplicationState"}}}}}}}},"401":{"$ref":"#/components/responses/Unauthorized-JWT"},"404":{"$ref":"#/components/responses/GiftCardNotFound"},"422":{"description":"Unprocessable Entity","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnprocessableEntity"},"examples":{"example-1":{"value":{"message":"The public order id field is required.","type":"order","field":"public_order_id","severity":"validation","sub_type":"payment"}}}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"$ref":"#/components/schemas/GiftCardPaymentId"}}}}}}}},"/checkout/storefront/{shop_identifier}/{public_order_id}/payments/styles":{"parameters":[{"$ref":"#/components/parameters/shop_identifier"},{"$ref":"#/components/parameters/public_order_id"}],"post":{"summary":"Create CSS Styling for SPI","operationId":"CreateCSSStylingForSPI","tags":["Payment Iframes"],"description":"Use this endpoint to style the [Secure Payments Interface (SPI)](/guides/checkout/resources/glossary#secure-payments-interface-spi) using CSS and media queries _for a single order_.\\n\\nAfter calling this endpoint, you must update the SPI iframe with the new styling. Use the [Update Media Match Action](/guides/checkout/references/checkout-spi-api#update-media-match-action) to send the new styling to your SPI event listener.","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"style_sheet":{"$ref":"#/components/schemas/PaymentStylesheet"}}}}}}}},"401":{"$ref":"#/components/responses/Unauthorized-JWT"}},"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentStylesheet"}}}}}},"/checkout/storefront/{shop_identifier}/{public_order_id}/process_order":{"parameters":[{"$ref":"#/components/parameters/shop_identifier"},{"$ref":"#/components/parameters/public_order_id"}],"post":{"summary":"Process Order","operationId":"ProcessOrder","tags":["Orders"],"description":"Triggers the backend processing of the order.\\n\\nBefore processing the order, Bold completes a series of checks to ensure taxes are calculated and the order contains payments that equal the order total.\\n\\nDuring processing, Bold completes the following steps:\\n - Taxes are calculated and present on order.\\n - Verify that inventory is adequate to fulfill the order (optional, based on platform settings).\\n - Pre-authorize any pending payments.\\n - Finalize and apply discounts.\\n\\nIf these steps complete successfully, this endpoint returns a success message.\\n\\nOnce order processing is complete, Bold asynchronously pushes each order to the platform and charges authorized payments.","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"application_state":{"$ref":"#/components/schemas/ApplicationState"}}}}}}}},"202":{"description":"Order is valid but requires Strong Customer Authentication (SCA) verification before being processed. Once the order is authenticated, re-submit this request.","content":{"application/json":{"schema":{"type":"object"},"examples":{"SCA Required":{"value":{"handleSCA":true}}}}}},"401":{"$ref":"#/components/responses/Unauthorized-JWT"},"422":{"description":"Unprocessable Entity","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnprocessableEntity"},"examples":{"Not Shop Found":{"value":{"message":"No Checkout shop found","type":"order","field":"public_order_id","severity":"critical","sub_type":"public_order_id"}},"No Customer":{"value":{"message":"No customer exists for the order","type":"order","field":"customer","severity":"validation","sub_type":"customer"}},"Empty Cart":{"value":{"message":"The order is empty","type":"order","field":"cart","severity":"validation","sub_type":"cart"}},"Unable to calculate tax":{"value":{"message":"There was an error calculating the taxes","type":"order","field":"tax","severity":"validation","sub_type":"tax"}},"Items out of stock":{"value":{"message":"Insufficient stock","type":"order","field":"inventory","severity":"validation","sub_type":"insufficient_stock"}},"Pre-auth Failed":{"value":{"message":"Payment pre-auth failed","type":"order","field":"payment","severity":"validation","sub_type":"payment"}},"Unknown":{"value":{"message":"Unable to process order for an unknown reason","type":"order","field":"public_order_id","severity":"order","sub_type":"public_order_id"}}}}}}}}},"/checkout/storefront/{shop_identifier}/{public_order_id}/pre_process_order":{"parameters":[{"$ref":"#/components/parameters/shop_identifier"},{"$ref":"#/components/parameters/public_order_id"}],"post":{"summary":"Pre-Process Order","operationId":"PreProcessOrder","tags":["Orders"],"description":"Prompts Bold Checkout to execute all the checks required before processing an order, without actually completing the order processing.\\n\\nThese steps include an inventory check, order validation and payment authorization. For a full list, refer to the [Process Order](checkout#operation/ProcessOrder) description.","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"application_state":{"$ref":"#/components/schemas/ApplicationState"}}}}}}}},"202":{"description":"Order is valid but requires Strong Customer Authentication (SCA) verification before being processed. Once the order is authenticated, re-submit this request.","content":{"application/json":{"schema":{"type":"object"},"examples":{"SCA Required":{"value":{"handleSCA":true}}}}}},"401":{"$ref":"#/components/responses/Unauthorized-JWT"},"422":{"description":"Unprocessable Entity","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnprocessableEntity"},"examples":{"No Shop Found":{"value":{"message":"No Bold Checkout shop found.","type":"order","field":"public_order_id","severity":"critical","sub_type":"public_order_id"}},"No Customer":{"value":{"message":"No customer exists for the order.","type":"order","field":"customer","severity":"validation","sub_type":"customer"}},"Empty Cart":{"value":{"message":"The order is empty.","type":"order","field":"cart","severity":"validation","sub_type":"cart"}},"Unable to calculate tax":{"value":{"message":"There was an error calculating the taxes.","type":"order","field":"tax","severity":"validation","sub_type":"tax"}},"Items out of stock":{"value":{"message":"Insufficient stock.","type":"order","field":"inventory","severity":"validation","sub_type":"insufficient_stock"}},"Pre-auth Failed":{"value":{"message":"Payment pre-auth failed.","type":"order","field":"payment","severity":"validation","sub_type":"payment"}},"Unknown":{"value":{"message":"Unable to pre-process order for an unknown reason.","type":"order","field":"public_order_id","severity":"order","sub_type":"public_order_id"}}}}}}}}},"/checkout/storefront/{shop_identifier}/{public_order_id}/handle_amendment":{"parameters":[{"$ref":"#/components/parameters/shop_identifier"},{"$ref":"#/components/parameters/public_order_id"}],"post":{"summary":"Handle Amendment","operationId":"HandleAmendment","tags":["Orders"],"description":"Prompts Bold Checkout to handle any amendments that have been made to the order, such as product upsells and other pre-processing order adjustments.\\n\\nBold re-checks the order for an outstanding balance. If one exists, Bold copies the existing payment on the order and creates a separate authorization.\\n\\n> **Note:** If the order value has changed, `handle_amendment` can only add and authorize the required additional payment if:\\n> * There is only one payment method on the order.\\n> * That payment is either a credit card or PayPal payment.\\n> * The gateway used to process that payment is **not** PayPal Complete Payments.","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"application_state":{"$ref":"#/components/schemas/ApplicationState"}}}}}}}},"401":{"$ref":"#/components/responses/Unauthorized-JWT"},"422":{"description":"Unprocessable Entity","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"examples":{"No Shop Found":{"value":{"message":"No Checkout shop found.","type":"order","field":"public_order_id","severity":"critical","sub_type":"public_order_id"}},"Auth Declined":{"value":{"message":"Card declined.","type":"order_amendment_failed.order_authorization_failed","code":"02-22"}},"Multiple Payments":{"value":{"message":"Multiple payment methods found.","type":"order_amendment_failed.payment_method_not_found","code":"02-00"}},"No Payments":{"value":{"message":"No valid payment method found.","type":"order_amendment_failed.payment_method_not_found","code":"02-00"}}}}}}}}},"/checkout/storefront/{shop_identifier}/{public_order_id}/refresh":{"parameters":[{"$ref":"#/components/parameters/shop_identifier"},{"$ref":"#/components/parameters/public_order_id"}],"get":{"summary":"Get Application State","operationId":"GetApplicationState","tags":["Orders"],"description":"Gets a refreshed copy of the application state. Useful if there are other plugins or applications that might be interacting with the order.","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"application_state":{"$ref":"#/components/schemas/ApplicationState"}}}}}}}},"401":{"$ref":"#/components/responses/Unauthorized-JWT"}}}},"/checkout/storefront/{shop_identifier}/{public_order_id}/discounts":{"parameters":[{"$ref":"#/components/parameters/shop_identifier"},{"$ref":"#/components/parameters/public_order_id"}],"post":{"summary":"Add Discount Code","operationId":"AddDiscountCode","tags":["Discounts"],"description":"Applies a discount code to the current order.\\n\\nThis endpoint applies an order-level discount code with a `source` of `coupon`. Each order may have only one `coupon` discount. If you attempt to add more than one, this endpoint returns an error, and the second discount code is not added.\\n\\nTo add a discount code at the line item level, refer to the [discount_line_items](/guides/checkout/references/plugin-actions#discount_line_items) plugin action.\\n\\n> **Note:** This endpoint does not create a new discount code. New discount codes can be created in the [Bold Checkout admin](https://support.boldcommerce.com/hc/en-us/search?utf8=%E2%9C%93&query=discount+codes).","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"The discount code.","example":"FREESHIPPING"}},"required":["code"]}}}},"responses":{"200":{"description":"Discount successfully applied","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"discount":{"$ref":"#/components/schemas/Discount"},"application_state":{"$ref":"#/components/schemas/ApplicationState"}}}}}}}},"401":{"$ref":"#/components/responses/Unauthorized-JWT"},"422":{"description":"Unprocessable Entity","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnprocessableEntity"},"examples":{"CouldNotFind":{"value":{"errors":[{"message":"Could not find Discount: TESTCODE","type":"order","field":"discounts","severity":"validation","sub_type":"discounts"}]}},"MissingRequiredField":{"value":{"errors":[{"message":"The discount code field is required.","type":"authorization","field":"discount_code","severity":"validation","sub_type":""}]}}}}}}}},"get":{"summary":"List Discount Codes","operationId":"ListDiscountCodes","tags":["Discounts"],"description":"Retrieves all discount codes applied to the order, shipping, or individual line items, if applicable. If the order is not discounted, the endpoint returns an empty `discounts` array.","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"discounts":{"type":"array","items":{"anyOf":[{"$ref":"#/components/schemas/LineItemDiscount"},{"$ref":"#/components/schemas/Discount"}]}},"application_state":{"$ref":"#/components/schemas/ApplicationState"}}}}},"examples":{"ListDiscountCodes":{"$ref":"#/components/examples/ListDiscounts"}}}}},"401":{"$ref":"#/components/responses/Unauthorized-JWT"}}},"delete":{"summary":"Delete Discount Code","operationId":"DeleteDiscountCode","tags":["Discounts"],"description":"Removes the discount code and its discounts from the order.","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"The discount code.","example":"FREESHIPPING"}},"required":["code"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"application_state":{"$ref":"#/components/schemas/ApplicationState"}}}}},"examples":{"DeletedDiscountCode":{"$ref":"#/components/examples/DeletedDiscount"}}}}},"401":{"$ref":"#/components/responses/Unauthorized-JWT"},"422":{"description":"Unprocessable Entity","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnprocessableEntity"},"example":{"errors":[{"message":"Discount code is not applied to the order.","type":"order","field":"discounts","severity":"validation","sub_type":"discounts"},{"message":"The code field is required.","type":"authorization","field":"code","severity":"validation","sub_type":""}]}}}}}}},"/checkout/storefront/{shop_identifier}/{public_order_id}/validate_discount_code":{"parameters":[{"$ref":"#/components/parameters/shop_identifier"},{"$ref":"#/components/parameters/public_order_id"}],"get":{"summary":"Validate Discount Code","operationId":"ValidateDiscountCode","tags":["Discounts"],"description":"Validates the given discount code against the current order state and shop settings. Calling this endpoint does _not_ change the application state or apply the discount.\\n\\nIt is not required to call this endpoint before calling the [Add Discount Code](checkout#operation/AddDiscountCode) endpoint, but it can be helpful if you want to implement custom error handling in more complicated discount code scenarios.\\n\\nFor more information about discount validation, refer to [Validate Discount Codes](/guides/checkout/validate-discounts).","parameters":[{"schema":{"type":"string","example":"TESTCODE"},"in":"query","name":"discount_code","description":"The discount code to be validated.","required":true}],"responses":{"200":{"description":"Discount code is valid","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object"}}}}}},"401":{"$ref":"#/components/responses/Unauthorized-JWT"},"422":{"description":"Unprocessable Entity","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnprocessableEntity"},"examples":{"CouldNotFind":{"value":{"errors":[{"message":"Could not find Discount: TESTCODE","type":"order","field":"discounts","severity":"validation","sub_type":"discounts"}]}},"MissingRequiredField":{"value":{"errors":[{"message":"The discount code field is required.","type":"authorization","field":"discount_code","severity":"validation","sub_type":""}]}}}}}}}}},"/checkout/storefront/{shop_identifier}/{public_order_id}/meta_data":{"parameters":[{"$ref":"#/components/parameters/shop_identifier"},{"$ref":"#/components/parameters/public_order_id"}],"patch":{"summary":"Append Order Metadata","operationId":"AppendOrderMetadata","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"order_meta_data":{"$ref":"#/components/schemas/OrderMetaData"},"application_state":{"$ref":"#/components/schemas/ApplicationState"}}}}},"examples":{"200-response":{"value":{"data":{"order_meta_data":{"cart_parameters":{"cp-key1":"A cart param","cp-key2":"Another cart param"},"note_attributes":{"na-key1":"A note attribute","na-key2":"Another note attribute"},"notes":"A different delivery instruction.","tags":["order-1","order-1-other","order-1-alone"]},"application_state":{"customer":{"platform_id":null,"public_id":null,"first_name":"","last_name":"","email_address":"","saved_addresses":[]},"addresses":{"shipping":null,"billing":null},"line_items":[],"fees":[],"taxes":[],"discounts":[],"payments":[],"shipping":{"selected_shipping":null,"available_shipping_lines":[],"taxes":0,"discounts":0},"order_meta_data":{"cart_parameters":{"cp-key1":"A cart param","cp-key2":"Another cart param"},"note_attributes":{"na-key1":"A note attribute","na-key2":"Another note attribute"},"tags":["order-1","order-1-other","order-1-alone"]},"is_processed":false}}}}}}}},"401":{"$ref":"#/components/responses/Unauthorized-JWT"}},"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrderMetaData"},"examples":{"append-all":{"value":{"cart_parameters":{"cp-key2":"Another cart param"},"note_attributes":{"na-key2":"Another note attribute"},"notes":"A different delivery instruction.","tags":["order-1-other"]}},"append-single-metadata":{"value":{"tags":["order-1-alone"]}}}}}},"description":"Append to any of the metadata attached to an order.","tags":["Metadata"]},"delete":{"summary":"Clear Order Metadata","operationId":"ClearOrderMetadata","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/ApplicationState"}}}}}},"401":{"$ref":"#/components/responses/Unauthorized-JWT"}},"description":"Clears the order of all the metadata.","tags":["Metadata"]},"get":{"summary":"List Order Metadata","operationId":"ListOrderMetadata","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"order_meta_data":{"$ref":"#/components/schemas/OrderMetaData"},"application_state":{"$ref":"#/components/schemas/ApplicationState"}}}}},"examples":{"200-response":{"value":{"data":{"order_meta_data":{"cart_parameters":{"cp-key1":"A cart param"},"note_attributes":{"na-key1":"A note attribute"},"notes":"Special delivery instruction.","tags":["order-1"]},"application_state":{"customer":{"platform_id":null,"public_id":null,"first_name":"","last_name":"","email_address":"","accepts_marketing":false,"saved_addresses":[]},"addresses":{"shipping":[],"billing":[]},"line_items":[],"fees":[],"taxes":[],"discounts":[],"payments":[],"shipping":{"selected_shipping":null,"available_shipping_lines":[],"taxes":0,"discounts":0},"order_meta_data":{"cart_parameters":{"cp-key1":"A cart param"},"note_attributes":{"na-key1":"A note attribute"},"tags":["order-1"]},"is_processed":false}}}},"empty-meta-data":{"value":{"data":{"order_meta_data":{"cart_parameters":{},"note_attributes":{},"notes":"","tags":[]},"application_state":{"customer":{"platform_id":null,"public_id":null,"first_name":"","last_name":"","email_address":"","accepts_marketing":false,"saved_addresses":[]},"addresses":{"shipping":[],"billing":[]},"line_items":[],"fees":[],"taxes":[],"discounts":[],"payments":[],"shipping":{"selected_shipping":null,"available_shipping_lines":[],"taxes":0,"discounts":0},"order_meta_data":{"cart_parameters":{},"note_attributes":{},"notes":"","tags":[]},"is_processed":false}}}}}}}},"401":{"$ref":"#/components/responses/Unauthorized-JWT"}},"description":"List All the Metadata Attached to an Order.","tags":["Metadata"]},"post":{"summary":"Overwrite Order Metadata","operationId":"OverwriteOrderMetadata","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"order_meta_data":{"$ref":"#/components/schemas/OrderMetaData"},"application_state":{"$ref":"#/components/schemas/ApplicationState"}}}}}}}},"401":{"$ref":"#/components/responses/Unauthorized-JWT"},"422":{"description":"Unprocessable Entity","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnprocessableEntity"},"examples":{"example-1":{"value":{"message":"validation.required","type":"meta_data","field":"cart_parameters","severity":"validation","sub_type":""}}}}}}},"description":"Add Metadata to an Order. ","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrderMetaData"},"examples":{"add-metadata":{"value":{"cart_parameters":{"cp-key1":"A cart param"},"note_attributes":{"na-key1":"A note attribute"},"notes":"Special delivery instruction.","tags":["order-1"]}}}}},"description":"Any existing metadata will be overwritten by the values provided in this request."},"tags":["Metadata"]}},"/checkout/storefront/{shop_identifier}/{public_order_id}/app_hook":{"parameters":[{"$ref":"#/components/parameters/shop_identifier"},{"$ref":"#/components/parameters/public_order_id"}],"post":{"summary":"Dispatch App Hook Event","operationId":"DispatchAppHookEvent","tags":["Orders"],"description":"Dispatches the `app_hook` plugin event to the plugin with the matching client ID provided in the request (given this plugin is registered for the `app_hook` event). For more information about the `app_hook` event, refer to [Create Custom Events with App Hooks](/guides/checkout/plugins/app-hooks).\\n\\nThe plugin processes the request, and returns a response that indicates the actions to be executed by Checkout. Checkout completes these actions, and this endpoint then returns an up-to-date version of the `application_state`.","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"uuid":{"type":"string","description":"The unique identifier of the plugin that is expected to receive the `app_hook` event. The client ID was sent to the developer upon creation of the plugin."},"hook":{"type":"string","description":"The name of the `app_hook` event to send to the plugin."},"app_hook_data":{"type":"object","description":"Data that will be provided as part of the `app_hook` plugin Event payload."}},"required":["uuid","hook"]},"examples":{"Example request":{"$ref":"#/components/examples/addPaymentAppHook"}}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"application_state":{"$ref":"#/components/schemas/ApplicationState"}}}}}}}},"422":{"description":"Unprocessable Entity","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnprocessableEntity"},"examples":{"Plugin not found":{"value":{"message":"Plugin not found"}},"Missing Required Field":{"value":{"message":"The uuid field is required.","type":"order","field":"uuid","severity":"validation","sub_type":"app_hook"}}}}}}}}},"/checkout/storefront/{shop_identifier}/{public_order_id}/check_inventory":{"parameters":[{"$ref":"#/components/parameters/shop_identifier"},{"$ref":"#/components/parameters/public_order_id"}],"get":{"summary":"Check Order Inventory","operationId":"CheckOrderInventory","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"inventory_check":{"type":"object","description":"Contains the results of the inventory check.","properties":{"result":{"type":"string","enum":["pass","fail","not_enabled"],"description":"Indicates the result of the inventory check."},"failed_items":{"type":"array","items":{"type":"object","properties":{"platform_variant_id":{"type":"string","example":"77","description":"The variant\'s id on the platform."},"available_quantity":{"type":"number","description":"The number of items currently in stock."}}}},"message":{"type":"string","example":"Insufficient inventory for requested items.","description":"A message indicating the reason for a failed inventory check."}}},"application_state":{"$ref":"#/components/schemas/ApplicationState"}}}}}}}},"422":{"description":"Unprocessable Entity","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnprocessableEntity"},"examples":{"example-1":{"value":{"code":"02-50","type":"checkout.api_validation_failed","message":"Error validating request","details":{"invalid_stage":""}}}}}}}},"description":"Triggers an inventory check on the items in the cart. The check can only be performed if the store enabled inventory checks; otherwise, this endpoint returns a `not_enabled` response. Functionally, this means that Checkout may proceed as if the check had passed.\\n\\nIf the inventory check is enabled, Checkout looks for an inventory override present on the order. If one is present, Checkout calls the override endpoint and returns the results yielded by that endpoint. If no override is present, Checkout uses the inventory policy on the store platform to determine whether the items on the order are in stock. For more information about inventory overrides, refer to the [Plugin Actions Reference](/guides/checkout/references/plugin-actions#override_inventory).\\n\\nIf Checkout is able to complete the inventory check, it returns a result of either `pass` or `fail` depending on the result of the check. If the result is `fail`, Checkout also returns a list of the items that failed the check, along with their available quantities.\\n\\nIf Checkout is unable to complete the inventory check for some external reason (for example, due to a network failure), Checkout returns an error response indicating that the check could not be completed.","parameters":[{"schema":{"type":"string","enum":["initial","final"],"default":"initial"},"in":"query","name":"stage","description":"The context in which the inventory check is to be performed. Specify this value only when using an inventory override. The override provider must interpret this value, as it has no impact on Bold Checkout functionality. Allowable values are `initial` or `final`. For most use cases, the value should be `initial` to indicate that the order has not been processed. Checkout automatically performs an inventory check when an order is being processed and uses the value `final` if an inventory override is place at this time.","required":false}],"tags":["Orders"]}},"/checkout/storefront/{shop_identifier}/{public_order_id}/batch":{"parameters":[{"$ref":"#/components/parameters/shop_identifier"},{"$ref":"#/components/parameters/public_order_id"}],"post":{"summary":"Batch Process","operationId":"BatchProcess","tags":["Batch Process"],"description":"Processes a series of API calls in a single request. Sub-requests are evaluated serially. If one of the sub-requests returns an error, processing halts and any requests after the failed request are not processed.\\n\\nNot all endpoints support batch processing. For a full list of supported endpoints and additional information, refer to [Submit a Batch Processing Request](/guides/checkout/batch-processing).","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"sub_requests":{"type":"array","items":{"$ref":"#/components/schemas/SubRequest"}}}},"examples":{"BatchRequest":{"$ref":"#/components/examples/BatchRequest"}}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"application_state":{"$ref":"#/components/schemas/ApplicationState"},"data":{"type":"array","items":{"$ref":"#/components/schemas/SubResponse"}}}},"examples":{"SuccessfulBatchResponse":{"$ref":"#/components/examples/SuccessfulBatchResponse"}}}}},"422":{"description":"Unprocessable Entity","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"$ref":"#/components/schemas/UnprocessableEntity"}},"application_state":{"$ref":"#/components/schemas/ApplicationState"},"data":{"type":"array","items":{"$ref":"#/components/schemas/SubResponse"}}}},"examples":{"FailedBatchResponse":{"$ref":"#/components/examples/FailedBatchResponse"}}}}}}}},"/checkout/storefront/{shop_identifier}/{public_order_id}/wallet_pay/create_order":{"parameters":[{"$ref":"#/components/parameters/shop_identifier"},{"$ref":"#/components/parameters/public_order_id"}],"post":{"summary":"Create Wallet Pay Order","operationId":"CreateWalletPayOrder","tags":["Wallet Pay"],"description":"Triggers the creation of an order in a \\"wallet pay\\" payment gateway. Bold uses the `public_order_id` to retrieve order information, including payment data. Bold then sends the request body and additional order information to the payment gateway. The payment gateway uses the order information to create a new order on its platform, and returns the created order\'s identifier.\\n\\nThe specified payment gateway must already be configured in your Bold admin. To read more about connecting a payment gateway in Bold checkout, refer to the [Help Center](https://support.boldcommerce.com/hc/en-us/search?utf8=%E2%9C%93&query=Connect+a+Payment+Processor+to+Bold+Checkout).\\n\\n> **Note:** This endpoint does not create or update orders within Bold. To do so, use [Initialize Order](/api/orders#tag/Orders/operation/CreateOrder) or [Create Order](/api/orders#tag/Orders/operation/CreateOrder). To add or update a payment on an order, use [Create Payment](/api/checkout#tag/Payments/operation/CreatePayment) or [Update Payment](/api/checkout#tag/Payments/operation/UpdatePayment).","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"payment_data":{"type":"object","description":"The data returned from the payment gateway. The returned data varies between gateways.","oneOf":[{"$ref":"#/components/schemas/PayPalGatewayOrderResponse"}]},"application_state":{"$ref":"#/components/schemas/ApplicationState"}}}}}}}},"401":{"$ref":"#/components/responses/Unauthorized-JWT"},"404":{"$ref":"#/components/responses/OrderNotFound"},"422":{"$ref":"#/components/responses/WalletPayUnprocessableEntity"}},"requestBody":{"description":"The data required for the order sent to the payment gateway.\\n\\nRefer to the schemas below to see the required data for each supported gateway.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentGatewayOrder"}}}}}},"/checkout/storefront/{shop_identifier}/{public_order_id}/wallet_pay/on_shipping":{"parameters":[{"$ref":"#/components/parameters/shop_identifier"},{"$ref":"#/components/parameters/public_order_id"}],"post":{"summary":"Update Shipping Address for Wallet Pay","operationId":"UpdateShippingAddressforWalletPay","tags":["Wallet Pay"],"description":"Handles a shipping address change event for wallet pay orders. Bold uses the provided shipping address from the payment gateway to calculate taxes and get the shipping lines.","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"payment_data":{"type":"object","description":"The data returned from the payment gateway. The returned data varies between gateways.","oneOf":[{}]},"application_state":{"$ref":"#/components/schemas/ApplicationState"}}}}}}}},"401":{"$ref":"#/components/responses/Unauthorized-JWT"},"404":{"$ref":"#/components/responses/OrderNotFound"},"422":{"$ref":"#/components/responses/WalletPayUnprocessableEntity"}},"requestBody":{"description":"The data required for the order sent to the payment gateway.\\n\\nRefer to the schemas below to see the required data for each supported gateway.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WalletPayOnShipping"}}}}}},"/checkout/storefront/{shop_identifier}/{public_order_id}/wallet_pay/on_approve":{"parameters":[{"$ref":"#/components/parameters/shop_identifier"},{"$ref":"#/components/parameters/public_order_id"}],"post":{"summary":"Capture Payment for Wallet Pay","operationId":"CapturePaymentforWalletPay","tags":["Wallet Pay"],"description":"Sends the payment information to the wallet pay for capture when the user authorizes the payment. Bold calls the payment gateway to get the order details and updates the customer information, shipping address, billing address, and taxes of the order.\\n\\n> **Note:** This endpoint does NOT add the payment to the order. To add a payment, use [Add Payment](/api/checkout#tag/Payments/operation/CreatePayment).","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"payment_data":{"type":"object","description":"The data returned from the payment gateway. The returned data varies between gateways.","oneOf":[{}]},"application_state":{"$ref":"#/components/schemas/ApplicationState"}}}}}}}},"401":{"$ref":"#/components/responses/Unauthorized-JWT"},"404":{"$ref":"#/components/responses/OrderNotFound"},"422":{"$ref":"#/components/responses/WalletPayUnprocessableEntity"}},"requestBody":{"description":"The data required for the order sent to the payment gateway.\\n\\nRefer to the schemas below to see the required data for each supported gateway.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WalletPayOnApprove"}}}}}}},"components":{"securitySchemes":{"JWT":{"type":"apiKey","name":"JWT","in":"header","description":"Authenticates the API request. The expected token is a [JSON Web Token (JWT)](https://www.rfc-editor.org/rfc/rfc7519) generated during the initialization of the the order via the [Initialize Order](orders#operation/InitializeOrder) endpoint.\\n\\nOnce the JWT expires (after 60 minutes), you must generate a new JWT using the [Resume Order](orders#operation/ResumeOrder) endpoint."}},"requestBodies":{"CustomerBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"first_name":{"type":"string","description":"The customer\'s first name.","example":"John"},"last_name":{"type":"string","description":"The customer\'s last name.","example":"Doe"},"email_address":{"type":"string","description":"The customer\'s email address.","example":"john.doe@example.com"},"accepts_marketing":{"type":"boolean","description":"If the customer would like to receive any sort of marketing emails. Defaults to `false`.","default":false,"example":false}},"required":["first_name","last_name","email_address"]}}}}},"parameters":{"shop_identifier":{"schema":{"type":"string","example":"zp3oafdor9"},"name":"shop_identifier","in":"path","required":true,"description":"The identifier of the shop. Can be retrieved by making a request to the [Get Info](shops#operation/GetShopInfo) endpoint."},"public_order_id":{"schema":{"type":"string","example":"woiph4vhqss9jjr50lR5am7IWurQ8FdbmtdOj4aaFIOfFiFGcvhY6x1t6eT0GoB"},"name":"public_order_id","in":"path","required":true,"description":"The public order identifier generated when the order is initialized by making a request to the [Initialize Order](orders#operation/InitializeOrder) endpoint."}},"schemas":{"ApplicationState":{"title":"Application State","type":"object","description":"Represents the current state of the order.\\nTaxes and discounts represent the summation of all tax or discount lines that have been applied anywhere through the order. Consulting the line items allows you to get the specific product break down of taxes and discounts.","properties":{"customer":{"description":"The customer that placed the order.","oneOf":[{"$ref":"#/components/schemas/Customer"},{"type":"array","title":"No customer","maxItems":0,"items":{"type":"string"}}]},"addresses":{"type":"object","description":"The billing and shipping addresses on the order.","properties":{"shipping":{"description":"The shipping address on the order.","oneOf":[{"$ref":"#/components/schemas/Address"},{"type":"array","title":"No address","maxItems":0,"items":{"type":"string"}}]},"billing":{"description":"The billing address on the order.","oneOf":[{"$ref":"#/components/schemas/Address"},{"type":"array","title":"No address","maxItems":0,"items":{"type":"string"}}]}}},"line_items":{"type":"array","description":"The list of line items associated with an order. Each line item includes information about the selected product and the taxes, fees, and discounts applied to it.","items":{"type":"object","properties":{"product_data":{"$ref":"#/components/schemas/LineItem"},"taxes":{"type":"array","description":"Any taxes that apply to the line item.","items":{"$ref":"#/components/schemas/Tax"}},"fees":{"type":"array","description":"Any fees that apply to the line item.","items":{"$ref":"#/components/schemas/LineItemFee"}},"discounts":{"type":"array","description":"Any discounts that apply to the line item.","items":{"$ref":"#/components/schemas/LineItemDiscount"}},"fulfilled_quantity":{"type":"integer","description":"The quantity of the line item that has been fulfilled. Fulfill a line item using the [Update Line Item](orders#operation/UpdateLineItem) endpoint.","example":2}}}},"fees":{"type":"array","description":"Any fees that apply to the full order.","items":{"$ref":"#/components/schemas/GeneralFee"}},"taxes":{"type":"array","description":"Any taxes that apply to the full order.","items":{"$ref":"#/components/schemas/Tax"}},"discounts":{"type":"array","description":"Any discounts that apply to the full order. This array contains all discounts that apply to the order, including order-level, shipping, and line item discounts.","items":{"anyOf":[{"$ref":"#/components/schemas/Discount"},{"$ref":"#/components/schemas/LineItemDiscount"}]},"example":[{"value":0,"text":"FREESHIPPING","code":"FREESHIPPING","source":"coupon"},{"value":500,"text":"Cutting board discount","code":"CHOPCHOP","source":"cart"}]},"payments":{"type":"array","description":"The payments applied to the order.","items":{"$ref":"#/components/schemas/Payment"}},"order_total":{"type":"number","description":"The total amount of the order (after tax, shipping, and discounts) using cents/base currency units using [ISO-4217](https://www.iso.org/iso-4217-currency-codes.html) standards.","example":4700},"order_meta_data":{"$ref":"#/components/schemas/OrderMetaData"},"shipping":{"type":"object","description":"The shipping information \u2014 including shipping lines, taxes, and discounts \u2014 associated with an order.","properties":{"selected_shipping":{"$ref":"#/components/schemas/ShippingLine"},"available_shipping_lines":{"type":"array","description":"The shipping lines available for the order.","items":{"type":"object","properties":{"id":{"type":"string"},"line":{"$ref":"#/components/schemas/ShippingLine"}}}},"taxes":{"description":"Any taxes that apply to the shipping rate.","oneOf":[{"type":"array","items":{"$ref":"#/components/schemas/Tax"}},{"type":"number"}]},"discounts":{"description":"Any discount that applies to the shipping rate. Free shipping discounts are created in the [Bold Checkout admin](https://support.boldcommerce.com/hc/en-us/search?utf8=%E2%9C%93&query=discount+codes).","oneOf":[{"type":"array","items":{"$ref":"#/components/schemas/Discount"}},{"type":"number"}]}}},"resumable_link":{"type":"string","nullable":true,"example":"example.com/checkout/resume","description":"A URL that can be used to redirect a customer when resuming their abandoned order."},"flow_id":{"type":"string","nullable":true,"description":"The identifier of the origin checkout flow used to create the order. If left empty, defaults to `null` and is displayed as \\"Unassigned\\" in the Checkout admin.","example":"external-company-one-page-template"},"currency":{"$ref":"#/components/schemas/Currency"},"display_currency":{"$ref":"#/components/schemas/DisplayCurrency"},"display_exchange_rate":{"$ref":"#/components/schemas/DisplayExchangeRate"},"created_via":{"type":"string","description":"The source of the order. Plugin developers can use the [Set Order Created By](/guides/checkout/references/plugin-actions#set_order_created_by) action to set this field and indicate that an order was created by their plugin. If the order was created as normal through Bold Checkout, this value is `\\"checkout\\"`.","example":"My_Order_Creating_Plugin"},"is_processed":{"type":"boolean","description":"Indicates whether the order has been processed.","example":false},"order_id":{"type":"number","description":"Bold Checkout\'s internal order ID.","example":79047599},"platform_order_id":{"type":"string","nullable":true,"description":"A platform-generated identifier for the order.","example":"1389wjfalsdf9y4r"}}},"CartItem":{"title":"Cart Item","type":"object","properties":{"platform_id":{"type":"string","description":"An identifier of the product on the platform.","example":"5423"},"sku":{"type":"string","description":"A merchant-defined stock-keeping unit of the line item.","example":"OAK_GRATER_SM"},"quantity":{"type":"integer","description":"The quantity of the line item to be added to the order.","example":2},"line_item_key":{"$ref":"#/components/schemas/LineItemKey"},"line_item_properties":{"$ref":"#/components/schemas/LineItemProperties"}},"required":["quantity","line_item_key"]},"Discount":{"title":"Discount","type":"object","description":"A discount, which can be applied either to an individual line item, the shipping rate, or the order as a whole.","properties":{"value":{"type":"number","description":"The value of the discount applied, represented in base currency units, using [ISO-4217](https://www.iso.org/iso-4217-currency-codes.html) standards. A free shipping discount has a `value` of `0`.","example":0},"text":{"type":"string","description":"A description of the discount, which is displayed on the platform.","example":"FREESHIPPING"},"code":{"type":"string","description":"The user-facing discount code name.","example":"FREESHIPPING"},"source":{"type":"string","description":"The source of the discount code. Possible values are:\\n - `cart` discount, created from plugin actions [DISCOUNT_CART](/guides/checkout/references/plugin-actions#discount_cart) and/or [DISCOUNT_LINE_ITEMS](/guides/checkout/references/plugin-actions#discount_line_items). There can be multiple \'cart\' discounts on each order.\\n - `coupon` discount, created in the [Bold Checkout admin](https://support.boldcommerce.com/hc/en-us/search?utf8=%E2%9C%93&query=discount+codes) and applied via the [Add Discount Code](checkout#operation/AddDiscountCode) endpoint. There can be only one `coupon` discount per order.","example":"coupon"}}},"Estimate":{"properties":{"first_name":{"type":"string","description":"The first name of the addressee.","example":"John"},"last_name":{"type":"string","description":"The last name of the addressee.","example":"Doe"},"address_line_1":{"type":"string","description":"The street address.","example":"50 Fultz Blvd"},"address_line_2":{"type":"string","description":"Any additional street address details (apt #, suite #, etc).","example":"Suite 200"},"country":{"type":"string","description":"The country name.","example":"Canada"},"city":{"type":"string","description":"The city name.","example":"Winnipeg"},"province":{"type":"string","description":"The province or state name, if applicable.","example":"Manitoba"},"country_code":{"type":"string","description":"The country code, in [ISO 3166](https://www.iso.org/iso-3166-country-codes.html) format.","example":"CA"},"province_code":{"type":"string","description":"The province or state code, in [ISO 3166](https://www.iso.org/iso-3166-country-codes.html) format, if applicable.","example":"MB"},"postal_code":{"type":"string","description":"The postal/zip code. Validated on format only when provided.","example":"R3Y0L6"},"business_name":{"type":"string","description":"The business name, if applicable.","example":"Acme Inc."},"phone_number":{"type":"string","description":"The phone number of the addressee.","example":"8005550101"}}},"LineItemDiscount":{"title":"Line Item Discount","type":"object","description":"A line item discount.","properties":{"value":{"type":"number","description":"The value of the discount applied, represented in base currency units, using [ISO-4217](https://www.iso.org/iso-4217-currency-codes.html) standards.","example":500},"text":{"type":"string","description":"A description of the discount, which is displayed on the platform.","example":"Cutting board discount"},"code":{"type":"string","description":"The user-facing discount code.","example":"CHOPCHOP"},"source":{"type":"string","description":"The source of the discount code. For line items, the `source` is always `cart`. Use the [DISCOUNT_LINE_ITEMS](/guides/checkout/references/plugin-actions#discount_line_items) plugin action to discount line items. There can be multiple \'cart\' discounts on each order. This discount also appears in the order-level `discounts` array.","example":"cart"}}},"GeneralFee":{"title":"GeneralFee","type":"object","properties":{"id":{"type":"string","description":"A unique identifier for this fee, used in the [`remove_fee`](/guides/checkout/references/plugin-actions#remove_fee) plugin action.","example":"123456789"},"line_text":{"type":"string","description":"A user-defined identifier serving to be displayed in any user interfaces.","example":"Custom Fee \u2014 Added by Plugin"},"fee_type":{"type":"string","description":"The type of the fee, \\"fixed\\" or \\"percentage\\".","example":"fixed"},"value":{"type":"integer","description":"The fee amount, represented in base currency units, using [ISO-4217](https://www.iso.org/iso-4217-currency-codes.html) standards.","example":10},"source":{"type":"string","description":"The method in which the fee was added to the order, typically through the `add_fee` plugin action.","example":"PLUGIN"},"plugin_uuid":{"type":"string","description":"The identifier of the plugin which added the fee to the order. This field is omitted if the fee source was not a plugin.","example":"a52589f8-09df-11ed-b30e-f67072e164ee"},"taxable":{"type":"boolean","description":"Indicates whether the fee should be included in the calculation of taxes.","example":true},"show_description":{"type":"boolean","description":"Indicates whether to show the fee description. Always set to `true` for fees added by plugin.","example":true}}},"LineItemFee":{"title":"Fee","type":"object","description":"An additional fee to be added to the line item.","properties":{"amount":{"type":"number","description":"The fee amount, represented in cents/base currency units, using [ISO-4217](https://www.iso.org/iso-4217-currency-codes.html) standards.","example":500},"name":{"type":"string","description":"A description of the fee.","example":"Miscellaneous fee."}}},"LineItemKey":{"title":"LineItemKey","type":"string","description":"A unique identifier, set by the merchant, serving to refer to this line item throughout Bold Checkout. You can retrieve this value using the [Products API](products#tag/Products) and looking for the `id` on each product.","example":"ABC123"},"LineItemProperties":{"title":"Line Item Properties","type":"object","description":"Any arbitrary property that you want to associate with this item. Line Items can also be Gift Cards, which have specific and unique properties.","anyOf":[{"type":"object","title":"Additional Properties","additionalProperties":{"type":"string"},"example":{"colour":"red","size":"small"}},{"$ref":"#/components/schemas/GiftCardProperties"},{"type":"object","title":"No properties","description":"Empty object"}]},"LineItem":{"title":"Line Item","type":"object","properties":{"id":{"type":"string","description":"An internal-only string that Bold uses to identify line items. This is created when the line item is added to the order.","example":"724bca"},"product_title":{"type":"string","description":"The name of the product.","example":"Oak Cheese Grater"},"title":{"type":"string","description":"The name of the product variant.","example":"Small"},"image_url":{"type":"string","description":"The URL at which to find an image.","example":"http://shop.images/oakcheesegrater"},"properties":{"description":"Any additional properties of the line item. Line items can also be gift cards, which have specific and unique properties.","anyOf":[{"type":"object","title":"Additional Properties","additionalProperties":{"type":"string"},"example":{"colour":"red","size":"small"}},{"$ref":"#/components/schemas/GiftCardProperties"},{"type":"array","title":"No properties","maxItems":0,"items":{"type":"string"}}]},"description":{"type":"string","description":"A description of the product.","example":"A handmade oak cheese grater to elevate your cheese-eating experience."},"quantity":{"type":"integer","description":"The quantity of the line item on the order.","example":2},"price":{"type":"number","description":"The price of one unit of the line item, using cents/base currency units, using [ISO-4217](https://www.iso.org/iso-4217-currency-codes.html) standards.","example":2350},"total_price":{"type":"number","description":"The total price of all units of the line item, presented in cents/base currency units, using [ISO-4217](https://www.iso.org/iso-4217-currency-codes.html) standards.","example":4700},"visible":{"type":"integer","description":"Indicates whether the item is visible on the storefront. Hard-coded to `1` to indicate `true`.","example":1},"line_item_key":{"$ref":"#/components/schemas/LineItemKey"},"barcode":{"type":"string","description":"The barcode for the line item.","example":"1234ABC"},"compare_at_price":{"type":"number","description":"An optional price displayed on the product page to indicate the discount taken.","nullable":true,"example":4000},"weight":{"type":"integer","description":"The weight of one unit of the line item, measured in `weight_unit`.","example":1000},"weight_unit":{"type":"string","description":"The unit in which to measure the line item weight.","example":"g"},"product_id":{"type":"string","description":"A platform-defined identifier for the product on this line item.","example":"oak-cheese-grater"},"variant_id":{"type":"string","description":"A platform-defined identifier for the product variant on this line item.","example":"oak-cheese-grater-small"},"requires_shipping":{"type":"boolean","description":"Indicates whether the item must be shipped.","example":true},"sku":{"type":"string","description":"A merchant-defined stock-keeping unit of the line item.","example":"OAK_GRATER_SM"},"taxable":{"type":"boolean","description":"Indicates whether the line item is taxable.","example":true},"tags":{"type":"string","description":"Any tags attached to the line item.","example":"Kitchen, Cheese Board, Oak"},"vendor":{"type":"string","description":"The vendor that supplied the line item.","example":"Cheese Boards Unlimited"},"total_weight":{"type":"integer","description":"The total weight of all units of this line item.","example":2000},"localized_names":{"description":"Any localized names for the product. Languages and localized names are configured in the platform.\\n\\nFor each configured language, the object contains a property with a key equal to the language (in [ISO 369](https://www.iso.org/iso-639-language-codes.html) format) and value equal to the product name in that language.\\n","anyOf":[{"type":"object","title":"Additional Properties","additionalProperties":{"type":"string","properties":{"text":{"type":"string"}}},"example":{"fr":"Gratteur \xe0 fromage en ch\xeane","ge":"K\xe4sereibe aus Eichenholz"}},{"type":"array","title":"No localized_names","maxItems":0,"items":{}}]},"localized_descriptions":{"description":"Any localized descriptions for the product. Languages and localized descriptions are configured in the platform.\\n\\nFor each configured language, the object contains a property with a key equal to the language (in [ISO 369](https://www.iso.org/iso-639-language-codes.html) format) and value equal to the product description in that language.\\n","anyOf":[{"type":"object","title":"Additional Properties","additionalProperties":{"type":"string","properties":{"text":{"type":"string"}}},"example":{"fr":"Un gratteur \xe0 fromage en ch\xeane faite \xe0 la main pour rehausser votre exp\xe9rience de d\xe9gustation de fromage","ge":"Eine handgefertigte K\xe4sereibe aus Eichenholz, um Ihr K\xe4seerlebnis zu verbessern"}},{"type":"array","title":"No localized_descriptions","maxItems":0,"items":{}}]},"localized_variant_names":{"description":"Any localized names for the product variant. Languages and localized names are configured in the platform.\\n\\nFor each configured language, the object contains a property with a key equal to the language (in [ISO 369](https://www.iso.org/iso-639-language-codes.html) format) and value equal to the product variant name in that language.\\n","anyOf":[{"type":"object","title":"Additional Properties","additionalProperties":{"type":"string","properties":{"text":{"type":"string"}}},"example":{"fr":"Gratteur \xe0 fromage en ch\xeane","ge":"K\xe4sereibe aus Eichenholz"}},{"type":"array","title":"No localized_variant_names","maxItems":0,"items":{}}]}}},"Payment":{"title":"Payment","type":"object","properties":{"gateway_public_id":{"type":"string","description":"A public identifier of the payment gateway used with the payment.","example":"i7z2xT0sKrDvhGWzex5SLjf5e6ndlQfrRL4AROkfhf3vNBkVT38JKBy5PSjB63qW"},"amount":{"type":"number","description":"The payment amount, represented in cents/base currency units, using [ISO-4217](https://www.iso.org/iso-4217-currency-codes.html) standards.","example":4700},"currency":{"type":"string","description":"The currency of the payment, using [ISO-4217](https://www.iso.org/iso-4217-currency-codes.html) standards.","example":"CAD"},"type":{"type":"string","description":"The payment gateway that accepted the payment.","example":"spreedly"},"display_string":{"type":"string","description":"A description of the payment to visually display to the customer.","example":"Credit Card Payment"},"id":{"type":"string","readOnly":true,"description":"An identifier of the payment.","example":""},"token":{"type":"string","description":"A token generated by the payment gateway to identify the payment.","example":"7uZAMRAf80KiEwibsrrM5IB41yU"},"wallet_pay_type":{"type":"string","description":"The identifier for a wallet/express payment provider, if applicable for the payment.\\n\\nThe current supported wallet/express payment providers are:\\n- Apple Pay (`applepay`)\\n- Pay with Google (`paywithgoogle`)\\n- PayPal (`paypal`)","enum":["applepay","paywithgoogle","paypal"]},"retain":{"type":"boolean","description":"Indicates whether the payment method will be saved for future orders. Checkout only stores a tokenized version of the payment method.","default":false,"example":false},"payment_parameters":{"type":"object","description":"Additional payment data, if necessary for the payment gateway.\\n\\nIf `payment_parameters` is empty, its value is an empty array (`[]`).\\n","example":{"is_giftcard":true,"customer_segment_id":"ab4329tn23oe315"}}},"required":["gateway_public_id","token"]},"Currency":{"type":"object","description":"The currency that the order was completed in.","properties":{"iso_code":{"type":"string","description":"The currency code, using [ISO-4217](https://www.iso.org/iso-4217-currency-codes.html) standards.","example":"CAD"},"iso_numeric_code":{"type":"integer","description":"The numeric currency code, using [ISO-4217](https://www.iso.org/iso-4217-currency-codes.html) standards.","example":124},"symbol":{"type":"string","description":"The symbol associated with the currency.","example":"$"},"format":{"type":"string","description":"The format of the currency, including the symbol and the amount.","example":"${{amount}}"},"has_decimal":{"type":"boolean","description":"Indicates whether the currency uses a decimal.","example":true},"show_iso_code":{"type":"boolean","description":"Indicates whether to show the ISO code alongside the order total on the storefront.","example":true}}},"DisplayCurrency":{"type":"object","description":"The currency that the order was displayed to the user.","properties":{"iso_code":{"type":"string","description":"The currency code, using [ISO-4217](https://www.iso.org/iso-4217-currency-codes.html) standards.","example":"USD"},"iso_numeric_code":{"type":"integer","description":"The numeric currency code, using [ISO-4217](https://www.iso.org/iso-4217-currency-codes.html) standards.","example":840},"symbol":{"type":"string","description":"The symbol associated with the currency.","example":"$"},"format":{"type":"string","description":"The format of the currency, including the symbol and the amount.","example":"${{amount}}"},"has_decimal":{"type":"boolean","description":"Indicates whether the currency uses a decimal.","example":true},"show_iso_code":{"type":"boolean","description":"Indicates whether to show the ISO code alongside the order total on the storefront.","example":true}}},"DisplayExchangeRate":{"type":"number","description":"The rate of exchange between the currency on the order and the display currency.","example":1.357251},"GiftCardPaymentId":{"title":"Gift Card Payment ID","type":"string","description":"The ID of the gift card payment. Find the ID by reading the application state `payments` array. Refer to [Get Application State](checkout#operation/GetApplicationState).","example":"2"},"PaymentStylesheet":{"type":"object","description":"The CSS media queries to apply to the SPI iframe.","properties":{"css_rules":{"type":"array","description":"A set of CSS rules to be applied to the SPI iframe.","items":{"type":"object","properties":{"cssText":{"type":"string","description":"String of CSS styles, specifying the target elements, to be applied to the SPI iframe.","example":".ToggleField { color:red; }"}}}},"media_rules":{"type":"array","description":"A set of media queries to be applied to the SPI iframe.","items":{"type":"object","properties":{"conditionText":{"type":"string","description":"The media conditional text. Must not include \\"@media\\" in the string.","example":"screen and (max-height: 600px)"},"cssRules":{"type":"array","description":"A set of CSS rules to be applied when the media condition is met.","items":{"type":"object","properties":{"cssText":{"type":"string","description":"The CSS rule.","example":".ToggleField__Text { color:blue; }"}}}}}}}}},"PaymentGatewayOrder":{"type":"object","properties":{"gateway_type":{"type":"string","description":"The payment gateway where the order will be created. Currently supports: `paypal`.","enum":["paypal"],"example":"paypal"},"payment_data":{"type":"object","description":"The properties required for the gateway (specified by `gateway_type`) to create an order. These properties vary between gateways.","oneOf":[{"$ref":"#/components/schemas/PayPalGatewayOrder"}]}}},"PayPalGatewayOrder":{"type":"object","properties":{"locale":{"type":"string","description":"The location associated with your PayPal account, in [BCP-47 format](https://www.w3.org/International/core/langtags/rfc3066bis.html).","example":"en-US"}}},"PayPalGatewayOrderResponse":{"type":"object","properties":{"id":{"type":"string","description":"The identifier for the order created in the PayPal gateway.","example":"123"}}},"WalletPayOnShipping":{"type":"object","properties":{"gateway_type":{"type":"string","description":"The payment gateway where the order is created. Currently supports: `paypal`.","enum":["paypal"],"example":"paypal"},"payment_data":{"type":"object","description":"Properties required for the gateway (specified by `gateway_type`) to handle this request. These properties vary between gateways.","oneOf":[{"$ref":"#/components/schemas/PayPalWalletPayOnShipping"}]}}},"PayPalWalletPayOnShipping":{"type":"object","properties":{"locale":{"type":"string","description":"The location associated with your PayPal account, in [BCP-47 format](https://www.w3.org/International/core/langtags/rfc3066bis.html).","example":"en-US"},"paypal_order_id":{"type":"string","description":"The order identifier created by the [Create Wallet Pay Order](/api/checkout#tag/Wallet-Pay/operation/CreateOrder) endpoint.","example":"123"},"shipping_address":{"type":"object","description":"The shipping address provided by the payment gateway.","properties":{"city":{"description":"The city name.","type":"string","example":"Winnipeg"},"country_code":{"description":"The country code, in [ISO 3166](https://www.iso.org/iso-3166-country-codes.html) format.","type":"string","example":"CA"},"postal_code":{"description":"The postal code.","type":"string","example":"R3Y0L6"},"state":{"description":"The two-character state.","type":"string","example":"MB"}}},"shipping_options":{"type":"object","description":"The shipping options provided by the payment gateway.","properties":{"id":{"description":"The identifier of the shipping option.","type":"string","example":"123"},"label":{"description":"The human-readable label of the shipping option.","type":"string","example":"Canada Post Packet"},"selected":{"description":"Indicates whether this shipping option has been selected.","type":"boolean","example":true},"type":{"description":"The type of shipping option.","type":"string","example":"SHIPPING"},"amount":{"description":"The cost of the shipping option.","type":"object","properties":{"currency_code":{"type":"string","example":"USD"},"value":{"type":"string","example":"23.13"}}}}}}},"WalletPayOnApprove":{"type":"object","properties":{"gateway_type":{"type":"string","description":"The payment gateway where the order is created. Currently supports: `paypal`.","enum":["paypal"],"example":"paypal"},"payment_data":{"type":"object","description":"Any properties required for the gateway (specified by `gateway_type`) to handle this request. These properties vary between gateways.","oneOf":[{"$ref":"#/components/schemas/PayPalWalletPayOnApprove"}]}}},"PayPalWalletPayOnApprove":{"type":"object","properties":{"locale":{"type":"string","description":"The location associated with your PayPal account, in [BCP-47 format](https://www.w3.org/International/core/langtags/rfc3066bis.html).","example":"en-US"},"paypal_order_id":{"type":"string","description":"The order identifier created by the [Create Order](/api/checkout#tag/Wallet-Pay/operation/CreateOrder) endpoint.","example":"123"}}},"ShippingLine":{"title":"Shipping Line","type":"object","nullable":true,"properties":{"id":{"type":"string","description":"Identifier/index of the shipping line.","example":"0"},"description":{"type":"string","description":"Description of the shipping line.","example":"Custom weight-based rate: tier 2"},"amount":{"type":"number","description":"The shipping amount represented in cents/base currency units using [ISO-4217](https://www.iso.org/iso-4217-currency-codes.html) standards.","example":450},"code":{"type":"string","description":"An identifier assigned to the shipping rate by the shipping provider.","example":"EXPID"}}},"SubRequest":{"title":"Sub-Request","type":"object","properties":{"endpoint":{"type":"string","description":"The last sub-route of the endpoint URL for the sub-request. For the full list of supported endpoints, refer to the [Submit a Batch Processing Event](/guides/checkout/batch-processing) guide.","example":"validate_email_address"},"method":{"type":"string","description":"The HTTP method for the sub-request.","example":"GET"},"payload":{"type":"object","description":"The complete payload of the sub-request, formatted identically to a non-batch request, as defined in this specification.","example":{"email_address":"john.doe@example.com"}}}},"SubResponse":{"title":"Batch Processing Endpoint Response","type":"object","oneOf":[{"title":"Successful Sub-Request","type":"object","properties":{"data":{"oneOf":[{"type":"object","description":"The endpoint response as documented in the specification, excluding the application state. Refer to the applicable specification for the structure and content of this response.","example":{"customer":{"platform_id":"","public_id":"pjpTyGh8KzNQ225wPqxgy7LwNuC887h6ecGyp3omwT4XW8SszjVSdHzWHN4NBwqhA","first_name":"John","last_name":"Doe","email_address":"john.doe@example.com","accepts_marketing":true,"saved_addresses":[]}}},{"type":"array","description":"If the endpoint does not return a response body, `data` contains just an empty array.","maxLength":0,"example":[],"items":{}}]},"status_code":{"type":"integer","description":"The status code of the sub-request.","example":200},"method":{"type":"string","description":"The HTTP method for the sub-request.","example":"GET"},"endpoint":{"type":"string","description":"The last sub-route of the endpoint URL for the sub-request. For the full list of supported endpoints, refer to the [Submit a Batch Processing Event](/guides/checkout/batch-processing) guide.","example":"validate_email_address"}}},{"title":"Failed Sub-Request","type":"object","properties":{"errors":{"type":"array","description":"The error that caused the sub-request to fail.","items":{"$ref":"#/components/schemas/UnprocessableEntity"}},"status_code":{"type":"integer","description":"The status code of the sub-request.","example":422},"method":{"type":"string","description":"The HTTP method for the sub-request.","example":"GET"},"endpoint":{"type":"string","description":"The last sub-route of the endpoint URL for the sub-request. For the full list of supported endpoints, refer to the [Submit a Batch Processing Event](/guides/checkout/batch-processing) guide.","example":"validate_email_address"}}}]},"Tax":{"title":"Tax","type":"object","properties":{"value":{"type":"number","description":"The value of the tax applied, represented in cents/base currency units, using [ISO-4217](https://www.iso.org/iso-4217-currency-codes.html) standards.","example":1000},"name":{"type":"string","description":"A descriptor of the tax being applied.","example":"GST"},"is_included":{"type":"boolean","description":"Indicates whether the tax is already included in the price.","example":true}}},"Customer":{"title":"Customer","type":"object","description":"An authenticated or guest customer associated with an order.","properties":{"platform_id":{"type":"string","description":"The platform identifier for an authenticated customer. For guest customers, the value for this property will be null.","nullable":true,"readOnly":true,"example":"50942578465125"},"public_id":{"type":"string","description":"The public identifier generated by Checkout for a customer.","nullable":true,"readOnly":true,"example":"pjpTyGh8KzNQ225wPqxgy7LwNuC887h6ecGyp3omwT4XW8SszjVSdHzWHN4NBwqhA"},"first_name":{"type":"string","description":"The first name of the customer.","example":"John"},"last_name":{"type":"string","description":"The last name of the customer.","example":"Doe"},"email_address":{"type":"string","description":"The email address of the customer.","example":"john.doe@example.com"},"accepts_marketing":{"type":"boolean","description":"If the customer would like to receive any sort of marketing emails.","example":true},"saved_addresses":{"type":"array","description":"The saved addresses of an authenticated customer stored from the platform.","items":{"$ref":"#/components/schemas/Address"}}},"required":["email_address"]},"OrderMetaData":{"title":"Order Metadata","type":"object","description":"Additional information about an order. Metadata can be used as data proxy that Checkout will act upon. It can also be used to include extra information about an order and included when pushed to the platform.","properties":{"cart_parameters":{"description":"Extra information about an order that Checkout can act upon.","oneOf":[{"type":"object","title":"Cart parameters","properties":{"key":{"type":"string","example":"cp-key1"}},"additionalProperties":{"type":"string","example":"A cart param."}},{"type":"array","title":"No cart parameters","maxItems":0,"items":{"type":"string"}}]},"note_attributes":{"description":"Extra information added to the order and pushed to the platform.","oneOf":[{"type":"object","title":"Note attributes","properties":{"key":{"type":"string","example":"na-key1"}},"additionalProperties":{"type":"string","example":"A note attribute."}},{"type":"array","title":"No note attributes","maxItems":0,"items":{"type":"string"}}]},"notes":{"type":"string","description":"Notes that can be attached to the order.","example":"A special delivery note."},"tags":{"type":"array","description":"Tags attached to the order.","items":{"type":"string","example":"order-1"}}}},"AuthorizationError":{"type":"object","description":"An error with the authorization of the JWT.","properties":{"code":{"type":"string","description":"The error code.","example":"00-1"},"type":{"type":"string","description":"The type of error.","example":"authorization.missing_jwt"},"message":{"type":"string","description":"A phrase describing what went wrong.","example":"Missing JWT"}}},"UnprocessableEntity":{"description":"There was a problem with the object provided in the request.","type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"message":{"type":"string","description":"An error message describing what went wrong."},"type":{"type":"string","description":"The type of error that occurred."},"field":{"type":"string","description":"The field of the object that the error was found in."},"severity":{"type":"string","description":"The severity of the error."},"sub_type":{"type":"string","description":"The sub_type of the error."}}}}}},"Error":{"type":"object","description":"There was a problem with the request.","properties":{"message":{"type":"string","description":"A phrase describing what went wrong.","example":"No Checkout shop found"},"type":{"type":"string","description":"The type of error.","example":"order"},"severity":{"type":"string","description":"The severity of the error.","example":"critical"},"subtype":{"type":"string","description":"The subtype of the error.","example":"public_order_id"}}},"Address":{"title":"Address","description":"A shipping or billing address.","type":"object","nullable":true,"properties":{"id":{"type":"string","description":"A unique identifier of the address.","nullable":true,"readOnly":true,"example":"123"},"first_name":{"type":"string","description":"The first name of the addressee.","example":"John"},"last_name":{"type":"string","description":"The last name of the addressee.","example":"Doe"},"address_line_1":{"type":"string","description":"The street address.","example":"50 Fultz Blvd"},"address_line_2":{"type":"string","description":"Any additional street address details (apt #, suite #, etc).","example":"Suite 200"},"country":{"type":"string","description":"The country name.","example":"Canada"},"city":{"type":"string","description":"The city name.","example":"Winnipeg"},"province":{"type":"string","description":"The province or state name, if applicable. If `show_province` is set to `true`, this field is required.","example":"Manitoba"},"country_code":{"type":"string","description":"The country code, in [ISO 3166](https://www.iso.org/iso-3166-country-codes.html) format.","example":"CA"},"province_code":{"type":"string","description":"The province or state code, in [ISO 3166](https://www.iso.org/iso-3166-country-codes.html) format, if applicable. If `show_province` is set to `true`, this field is required.","example":"MB"},"postal_code":{"type":"string","description":"The postal/zip code. Required for most countries, including the United States, Canada, and Mexico. Validated on format only when provided.","example":"R3Y0L6"},"business_name":{"type":"string","description":"If applicable, the business name.","example":"Acme Inc."},"phone_number":{"type":"string","description":"The phone number of the addressee.","example":"8005550101"}},"example":{"id":"123","first_name":"John","last_name":"Doe","address_line_1":"50 Fultz Blvd","address_line_2":"Suite 200","country":"Canada","city":"Winnipeg","province":"Manitoba","country_code":"CA","province_code":"MB","postal_code":"R3Y0L6","business_name":"Acme Inc.","phone_number":"8005550101"},"required":["country","country_code"]},"GiftCardProperties":{"title":"Gift Card Properties","type":"object","properties":{"recipient_name":{"type":"string","description":"Name of the person the gift card is being sent to. If none is provided, defaults to the customer\'s `first_name`.","example":"John Doe"},"recipient_email":{"type":"string","description":"Email address the gift card is being sent to. If none is provided, defaults to the customer\'s `email_address`.","example":"johndoe@boldcommerce.com"},"message":{"type":"string","description":"Personalized message field that the buyer can attach to the gift card. Value is `\\"\\"` if created from an order.","example":"Dear John, Happy Birthday!"},"custom_amount":{"type":"string","description":"If included, the price of this particular line item in the checkout order will be overwritten by this value. It is written in base units, using [ISO-4217](https://www.iso.org/iso-4217-currency-codes.html) standards.","example":"2450"}}}},"examples":{"addPaymentAppHook":{"value":{"uuid":"93225ea4-d701-41f9-a30a-bfe66f5d0479","hook":"age_verified","app_hook_data":{"order":{"tag_name":"over_legal_minimum","tag_value":true}}}},"BatchRequest":{"value":{"sub_requests":[{"method":"GET","endpoint":"/validate_email_address","payload":{"email_address":"john.doe@example.com"}},{"method":"POST","endpoint":"/customer/guest","payload":{"first_name":"John","last_name":"Doe","email_address":"john.doe@example.com","accepts_marketing":true}}]}},"SuccessfulBatchResponse":{"value":{"application_state":{"customer":{"platform_id":"","public_id":"pjpTyGh8KzNQ225wPqxgy7LwNuC887h6ecGyp3omwT4XW8SszjVSdHzWHN4NBwqhA","first_name":"John","last_name":"Doe","email_address":"john.doe@example.com","accepts_marketing":true,"saved_addresses":[]},"addresses":{"shipping":{"id":"123","first_name":"John","last_name":"Doe","address_line_1":"50 Fultz Blvd","address_line_2":"Suite 200","country":"Canada","city":"Winnipeg","province":"Manitoba","country_code":"CA","province_code":"MB","postal_code":"R3Y0L6","business_name":"Acme Inc.","phone_number":"8005550101"},"billing":{"id":"123","first_name":"John","last_name":"Doe","address_line_1":"50 Fultz Blvd","address_line_2":"Suite 200","country":"Canada","city":"Winnipeg","province":"Manitoba","country_code":"CA","province_code":"MB","postal_code":"R3Y0L6","business_name":"Acme Inc.","phone_number":"8005550101"}},"line_items":[{"product_data":{"id":"724bca","product_title":"Oak Cheese Grater","title":"Small","image_url":"http://shop.images/oakcheesegrater","properties":{"colour":"red","size":"small"},"description":"A handmade oak cheese grater to elevate your cheese-eating experience.","quantity":2,"price":2350,"total_price":4700,"visible":1,"line_item_key":"oak_cheese_grater_2643","barcode":"1234ABC","compare_at_price":4000,"weight":1000,"weight_unit":"g","product_id":"oak-cheese-grater","variant_id":"oak-cheese-grater-small","requires_shipping":true,"sku":"OAK_GRATER_SM","taxable":true,"tags":"Kitchen, Cheese Board, Oak","vendor":"Cheese Boards Unlimited","total_weight":2000}},{"taxes":[{"value":1000,"name":"GST","is_included":true}]},{"fees":[{"amount":500,"name":"Miscellaneous fee."}]},{"discounts":[{"value":0,"text":"Cutting board discount","code":"CHOPCHOP","source":"cart"}]},{"fulfilled_quantity":2}],"fees":[{"id":"123456789","line_text":"Custom Fee \u2014 Added by Plugin","fee_type":"fixed","value":10,"source":"PLUGIN","plugin_uuid":"a52589f8-09df-11ed-b30e-f67072e164ee","taxable":true,"show_description":true}],"taxes":[{"value":1000,"name":"GST","is_included":true}],"discounts":[{"value":0,"text":"Cutting board discount","code":"CHOPCHOP","source":"cart"},{"value":0,"text":"FREESHIPPING","code":"FREESHIPPING","source":"coupon"}],"payments":[{"gateway_public_id":"i7z2xT0sKrDvhGWzex5SLjf5e6ndlQfrRL4AROkfhf3vNBkVT38JKBy5PSjB63qW","amount":4700,"currency":"CAD","type":"spreedly","display_string":"Credit Card Payment","id":"","token":"7uZAMRAf80KiEwibsrrM5IB41yU","retain":false,"payment_parameters":[]}],"order_total":4700,"order_meta_data":{"cart_parameters":{"key":"cp-key1,","property1":"A cart param.","property2":"A cart param."},"note_attributes":{"key":"na-key1","property1":"A note attribute.","property2":"A note attribute."},"notes":"A special delivery note.","tags":["order-1"]},"shipping":{"selected_shipping":{"id":"0","description":"Custom weight-based rate: tier 2","amount":450,"code":"EXPID"},"available_shipping_lines":[{"id":"string,","line":{"id":"0","description":"Custom weight-based rate: tier 2","amount":450,"code":"EXPID"}}],"taxes":[{"value":1000,"name":"GST","is_included":true}],"discounts":[{"value":0,"text":"FREESHIPPING","code":"FREESHIPPING","source":"coupon"}]},"resumable_link":"example.com/checkout/resume","flow_id":"external-company-one-page-template","currency":{"iso_code":"CAD","iso_numeric_code":124,"symbol":"$","format":"${{amount}}","has_decimal":true,"show_iso_code":true},"created_via":"My_Order_Creating_Plugin","is_processed":false,"order_id":79047599,"platform_order_id":"1389wjfalsdf9y4r"},"data":[{"data":[],"status_code":"200,","method":"GET","endpoint":"/validate_email_address"},{"data":{"customer":{"platform_id":"","public_id":"pjpTyGh8KzNQ225wPqxgy7LwNuC887h6ecGyp3omwT4XW8SszjVSdHzWHN4NBwqhA","first_name":"John","last_name":"Doe","email_address":"john.doe@example.com","accepts_marketing":true,"saved_addresses":[]}},"status_code":200,"method":"POST","endpoint":"/customer/guest"}]}},"FailedBatchResponse":{"value":{"errors":[{"message":"The country field is required.","type":"order","field":"country","severity":"validation","sub_type":"billing_address"}],"application_state":{"customer":{"platform_id":"","public_id":"pjpTyGh8KzNQ225wPqxgy7LwNuC887h6ecGyp3omwT4XW8SszjVSdHzWHN4NBwqhA","first_name":"John","last_name":"Doe","email_address":"john.doe@example.com","accepts_marketing":true,"saved_addresses":[]},"addresses":{"shipping":{"id":"123","first_name":"John","last_name":"Doe","address_line_1":"50 Fultz Blvd","address_line_2":"Suite 200","country":"Canada","city":"Winnipeg","province":"Manitoba","country_code":"CA","province_code":"MB","postal_code":"R3Y0L6","business_name":"Acme Inc.","phone_number":"8005550101"},"billing":{"id":"123","first_name":"John","last_name":"Doe","address_line_1":"50 Fultz Blvd","address_line_2":"Suite 200","country":"Canada","city":"Winnipeg","province":"Manitoba","country_code":"CA","province_code":"MB","postal_code":"R3Y0L6","business_name":"Acme Inc.","phone_number":"8005550101"}},"line_items":[{"product_data":{"id":"724bca","product_title":"Oak Cheese Grater","title":"Small","image_url":"http://shop.images/oakcheesegrater","properties":{"colour":"red","size":"small"},"description":"A handmade oak cheese grater to elevate your cheese-eating experience.","quantity":2,"price":2350,"total_price":4700,"visible":1,"line_item_key":"oak_cheese_grater_2643","barcode":"1234ABC","compare_at_price":4000,"weight":1000,"weight_unit":"g","product_id":"oak-cheese-grater","variant_id":"oak-cheese-grater-small","requires_shipping":true,"sku":"OAK_GRATER_SM","taxable":true,"tags":"Kitchen, Cheese Board, Oak","vendor":"Cheese Boards Unlimited","total_weight":2000}},{"taxes":[{"value":1000,"name":"GST","is_included":true}]},{"fees":[{"amount":500,"name":"Miscellaneous fee."}]},{"discounts":[{"value":0,"text":"Cutting board discount","code":"CHOPCHOP","source":"cart"}]},{"fulfilled_quantity":2}],"fees":[{"id":"123456789","line_text":"Custom Fee \u2014 Added by Plugin","fee_type":"fixed","value":10,"source":"PLUGIN","plugin_uuid":"a52589f8-09df-11ed-b30e-f67072e164ee","taxable":true,"show_description":true}],"taxes":[{"value":1000,"name":"GST","is_included":true}],"discounts":[{"value":0,"text":"Cutting board discount","code":"CHOPCHOP","source":"cart"},{"value":0,"text":"FREESHIPPING","code":"FREESHIPPING","source":"coupon"}],"payments":[{"gateway_public_id":"i7z2xT0sKrDvhGWzex5SLjf5e6ndlQfrRL4AROkfhf3vNBkVT38JKBy5PSjB63qW","amount":4700,"currency":"CAD","type":"spreedly","display_string":"Credit Card Payment","id":"","token":"7uZAMRAf80KiEwibsrrM5IB41yU","retain":false,"payment_parameters":[]}],"order_total":4700,"order_meta_data":{"cart_parameters":{"key":"cp-key1,","property1":"A cart param.","property2":"A cart param."},"note_attributes":{"key":"na-key1","property1":"A note attribute.","property2":"A note attribute."},"notes":"A special delivery note.","tags":["order-1"]},"shipping":{"selected_shipping":{"id":"0","description":"Custom weight-based rate: tier 2","amount":450,"code":"EXPID"},"available_shipping_lines":[{"id":"string,","line":{"id":"0","description":"Custom weight-based rate: tier 2","amount":450,"code":"EXPID"}}],"taxes":[{"value":1000,"name":"GST","is_included":true}],"discounts":[{"value":0,"text":"FREESHIPPING","code":"FREESHIPPING","source":"coupon"}]},"resumable_link":"example.com/checkout/resume","flow_id":"external-company-one-page-template","currency":{"iso_code":"CAD","iso_numeric_code":124,"symbol":"$","format":"${{amount}}","has_decimal":true,"show_iso_code":true},"created_via":"My_Order_Creating_Plugin","is_processed":false,"order_id":79047599,"platform_order_id":"1389wjfalsdf9y4r"},"data":[{"data":[],"status_code":"200,","method":"GET","endpoint":"validate_email_address"},{"errors":{"message":"The country field is required.","type":"order","field":"country","severity":"validation","sub_type":"billing_address"},"status_code":422,"method":"POST","endpoint":"customer/guest"}]}},"DeletedBillingAddress":{"value":{"data":{"application_state":{"customer":{"platform_id":"50942578465125","public_id":"pjpTyGh8KzNQ225wPqxgy7LwNuC887h6ecGyp3omwT4XW8SszjVSdHzWHN4NBwqhA","first_name":"John","last_name":"Doe","email_address":"john.doe@example.com","accepts_marketing":true,"saved_addresses":[{"id":"123","first_name":"John","last_name":"Doe","address_line_1":"50 Fultz Blvd","address_line_2":"Suite 200","country":"Canada","city":"Winnipeg","province":"Manitoba","country_code":"CA","province_code":"MB","postal_code":"R3Y0L6","business_name":"Acme Inc.","phone_number":"8005550101"}]},"addresses":{"shipping":{"id":"123","first_name":"John","last_name":"Doe","address_line_1":"50 Fultz Blvd","address_line_2":"Suite 200","country":"Canada","city":"Winnipeg","province":"Manitoba","country_code":"CA","province_code":"MB","postal_code":"R3Y0L6","business_name":"Acme Inc.","phone_number":"8005550101"},"billing":[]},"line_items":[{"product_data":{"id":"724bca","product_title":"Oak Cheese Grater","title":"Small","image_url":"http://shop.images/oakcheesegrater","properties":{"colour":"red","size":"small"},"description":"A handmade oak cheese grater to elevate your cheese-eating experience.","quantity":2,"price":2350,"total_price":4700,"visible":1,"line_item_key":"oak_cheese_grater_2643","barcode":"1234ABC","compare_at_price":4000,"weight":1000,"weight_unit":"g","product_id":"oak-cheese-grater","variant_id":"oak-cheese-grater-small","requires_shipping":true,"sku":"OAK_GRATER_SM","taxable":true,"tags":"Kitchen, Cheese Board, Oak","vendor":"Cheese Boards Unlimited","total_weight":2000}},{"taxes":[{"value":1000,"name":"GST","is_included":true}]},{"fees":[{"amount":500,"name":"Miscellaneous fee."}]},{"discounts":[{"value":0,"code":"CHOPCHOP","text":"Cutting board discount","source":"cart"}]},{"fulfilled_quantity":2}],"fees":[{"id":"123456789","line_text":"Custom Fee \u2014 Added by Plugin","fee_type":"fixed","value":10,"source":"PLUGIN","plugin_uuid":"a52589f8-09df-11ed-b30e-f67072e164ee","taxable":true,"show_description":true}],"taxes":[{"value":1000,"name":"GST","is_included":true}],"discounts":[{"value":0,"code":"CHOPCHOP","text":"Cutting board discount","source":"cart"},{"value":0,"code":"FREESHIPPING","text":"FREESHIPPING","source":"coupon"}],"payments":[{"gateway_public_id":"i7z2xT0sKrDvhGWzex5SLjf5e6ndlQfrRL4AROkfhf3vNBkVT38JKBy5PSjB63qW","amount":4700,"currency":"CAD","type":"spreedly","display_string":"Credit Card Payment","id":"","token":"7uZAMRAf80KiEwibsrrM5IB41yU","retain":false,"payment_parameters":[]}],"order_total":4700,"order_meta_data":{"cart_parameters":{"key":"cp-key1,","property1":"A cart param.","property2":"A cart param."},"note_attributes":{"key":"na-key1","property1":"A note attribute.","property2":"A note attribute."},"notes":"A special delivery note.","tags":["order-1"]},"shipping":{"selected_shipping":{"id":"0","description":"Custom weight-based rate: tier 2","amount":450,"code":"EXPID"},"available_shipping_lines":[{"id":"string,","line":{"id":"0","description":"Custom weight-based rate: tier 2","amount":450,"code":"EXPID"}}],"taxes":[{"value":1000,"name":"GST","is_included":true}],"discounts":[{"value":0,"code":"FREESHIPPING","text":"FREESHIPPING","source":"coupon"}]},"resumable_link":"example.com/checkout/resume","flow_id":"external-company-one-page-template","currency":{"iso_code":"CAD","iso_numeric_code":124,"symbol":"$","format":"${{amount}}","has_decimal":true,"show_iso_code":true},"created_via":"My_Order_Creating_Plugin","is_processed":false,"order_id":79047599,"platform_order_id":"1389wjfalsdf9y4r"}}}},"DeletedShippingAddress":{"value":{"data":{"application_state":{"customer":{"platform_id":"50942578465125","public_id":"pjpTyGh8KzNQ225wPqxgy7LwNuC887h6ecGyp3omwT4XW8SszjVSdHzWHN4NBwqhA","first_name":"John","last_name":"Doe","email_address":"john.doe@example.com","accepts_marketing":true,"saved_addresses":[{"id":"123","first_name":"John","last_name":"Doe","address_line_1":"50 Fultz Blvd","address_line_2":"Suite 200","country":"Canada","city":"Winnipeg","province":"Manitoba","country_code":"CA","province_code":"MB","postal_code":"R3Y0L6","business_name":"Acme Inc.","phone_number":"8005550101"}]},"addresses":{"shipping":{"id":"123","first_name":"John","last_name":"Doe","address_line_1":"50 Fultz Blvd","address_line_2":"Suite 200","country":"Canada","city":"Winnipeg","province":"Manitoba","country_code":"CA","province_code":"MB","postal_code":"R3Y0L6","business_name":"Acme Inc.","phone_number":"8005550101"},"billing":[]},"line_items":[{"product_data":{"id":"724bca","product_title":"Oak Cheese Grater","title":"Small","image_url":"http://shop.images/oakcheesegrater","properties":{"colour":"red","size":"small"},"description":"A handmade oak cheese grater to elevate your cheese-eating experience.","quantity":2,"price":2350,"total_price":4700,"visible":1,"line_item_key":"oak_cheese_grater_2643","barcode":"1234ABC","compare_at_price":4000,"weight":1000,"weight_unit":"g","product_id":"oak-cheese-grater","variant_id":"oak-cheese-grater-small","requires_shipping":true,"sku":"OAK_GRATER_SM","taxable":true,"tags":"Kitchen, Cheese Board, Oak","vendor":"Cheese Boards Unlimited","total_weight":2000}},{"taxes":[{"value":1000,"name":"GST","is_included":true}]},{"fees":[{"amount":500,"name":"Miscellaneous fee."}]},{"discounts":[{"value":0,"code":"CHOPCHOP","text":"Cutting board discount","source":"cart"}]},{"fulfilled_quantity":2}],"fees":[{"id":"123456789","line_text":"Custom Fee \u2014 Added by Plugin","fee_type":"fixed","value":10,"source":"PLUGIN","plugin_uuid":"a52589f8-09df-11ed-b30e-f67072e164ee","taxable":true,"show_description":true}],"taxes":[{"value":1000,"name":"GST","is_included":true}],"discounts":[{"value":0,"code":"CHOPCHOP","text":"Cutting board discount","source":"cart"},{"value":0,"code":"FREESHIPPING","text":"FREESHIPPING","source":"coupon"}],"payments":[{"gateway_public_id":"i7z2xT0sKrDvhGWzex5SLjf5e6ndlQfrRL4AROkfhf3vNBkVT38JKBy5PSjB63qW","amount":4700,"currency":"CAD","type":"spreedly","display_string":"Credit Card Payment","id":"","token":"7uZAMRAf80KiEwibsrrM5IB41yU","retain":false,"payment_parameters":[]}],"order_total":4700,"order_meta_data":{"cart_parameters":{"key":"cp-key1,","property1":"A cart param.","property2":"A cart param."},"note_attributes":{"key":"na-key1","property1":"A note attribute.","property2":"A note attribute."},"notes":"A special delivery note.","tags":["order-1"]},"shipping":{"selected_shipping":{"id":"0","description":"Custom weight-based rate: tier 2","amount":450,"code":"EXPID"},"available_shipping_lines":[{"id":"string,","line":{"id":"0","description":"Custom weight-based rate: tier 2","amount":450,"code":"EXPID"}}],"taxes":[{"value":1000,"name":"GST","is_included":true}],"discounts":[{"value":0,"code":"FREESHIPPING","text":"FREESHIPPING","source":"coupon"}]},"resumable_link":"example.com/checkout/resume","flow_id":"external-company-one-page-template","currency":{"iso_code":"CAD","iso_numeric_code":124,"symbol":"$","format":"${{amount}}","has_decimal":true,"show_iso_code":true},"created_via":"My_Order_Creating_Plugin","is_processed":false,"order_id":79047599,"platform_order_id":"1389wjfalsdf9y4r"}}}},"NoCustomer":{"summary":"Deleted Customer","value":{"data":{"application_state":{"customer":[],"addresses":{"shipping":{"id":"123","first_name":"John","last_name":"Doe","address_line_1":"50 Fultz Blvd","address_line_2":"Suite 200","country":"Canada","city":"Winnipeg","province":"Manitoba","country_code":"CA","province_code":"MB","postal_code":"R3Y0L6","business_name":"Acme Inc.","phone_number":"8005550101"},"billing":{"id":"123","first_name":"John","last_name":"Doe","address_line_1":"50 Fultz Blvd","address_line_2":"Suite 200","country":"Canada","city":"Winnipeg","province":"Manitoba","country_code":"CA","province_code":"MB","postal_code":"R3Y0L6","business_name":"Acme Inc.","phone_number":"8005550101"}},"line_items":[{"product_data":{"id":"724bca","product_title":"Oak Cheese Grater","title":"Small","image_url":"http://shop.images/oakcheesegrater","properties":{"colour":"red","size":"small"},"description":"A handmade oak cheese grater to elevate your cheese-eating experience.","quantity":2,"price":2350,"total_price":4700,"visible":1,"line_item_key":"oak_cheese_grater_2643","barcode":"1234ABC","compare_at_price":4000,"weight":1000,"weight_unit":"g","product_id":"oak-cheese-grater","variant_id":"oak-cheese-grater-small","requires_shipping":true,"sku":"OAK_GRATER_SM","taxable":true,"tags":"Kitchen, Cheese Board, Oak","vendor":"Cheese Boards Unlimited","total_weight":2000}},{"taxes":[{"value":1000,"name":"GST","is_included":true}]},{"fees":[{"amount":500,"name":"Miscellaneous fee."}]},{"discounts":[{"value":0,"text":"Cutting board discount","code":"CHOPCHOP","source":"cart"},{"value":0,"text":"FREESHIPPING","code":"FREESHIPPING","source":"coupon"}]},{"fulfilled_quantity":2}],"fees":[{"id":"123456789","line_text":"Custom Fee \u2014 Added by Plugin","fee_type":"fixed","value":10,"source":"PLUGIN","plugin_uuid":"a52589f8-09df-11ed-b30e-f67072e164ee","taxable":true,"show_description":true}],"taxes":[{"value":1000,"name":"GST","is_included":true}],"discounts":[{"code":"FREESHIPPING","text":"FREESHIPPING","value":500,"source":"coupon"}],"payments":[{"gateway_public_id":"i7z2xT0sKrDvhGWzex5SLjf5e6ndlQfrRL4AROkfhf3vNBkVT38JKBy5PSjB63qW","amount":4700,"currency":"CAD","type":"spreedly","display_string":"Credit Card Payment","id":"","token":"7uZAMRAf80KiEwibsrrM5IB41yU","retain":false,"payment_parameters":[]}],"order_total":4700,"order_meta_data":{"cart_parameters":{"key":"cp-key1,","property1":"A cart param.","property2":"A cart param."},"note_attributes":{"key":"na-key1","property1":"A note attribute.","property2":"A note attribute."},"notes":"A special delivery note.","tags":["order-1"]},"shipping":{"selected_shipping":{"id":"0","description":"Custom weight-based rate: tier 2","amount":450,"code":"EXPID"},"available_shipping_lines":[{"id":"string,","line":{"id":"0","description":"Custom weight-based rate: tier 2","amount":450,"code":"EXPID"}}],"taxes":[{"value":1000,"name":"GST","is_included":true}],"discounts":[{"value":500,"text":"FREESHIPPING","code":"FREESHIPPING","source":"coupon"}]},"resumable_link":"example.com/checkout/resume","flow_id":"external-company-one-page-template","currency":{"iso_code":"CAD","iso_numeric_code":124,"symbol":"$","format":"${{amount}}","has_decimal":true,"show_iso_code":true},"created_via":"My_Order_Creating_Plugin","is_processed":false,"order_id":79047599,"platform_order_id":"1389wjfalsdf9y4r"}}}},"GuestCustomer":{"summary":"Guest Customer","value":{"data":{"customer":{"platform_id":"","public_id":"pjpTyGh8KzNQ225wPqxgy7LwNuC887h6ecGyp3omwT4XW8SszjVSdHzWHN4NBwqhA","first_name":"John","last_name":"Doe","email_address":"john.doe@example.com","accepts_marketing":true,"saved_addresses":[]},"application_state":{"customer":{"platform_id":"","public_id":"pjpTyGh8KzNQ225wPqxgy7LwNuC887h6ecGyp3omwT4XW8SszjVSdHzWHN4NBwqhA","first_name":"John","last_name":"Doe","email_address":"john.doe@example.com","accepts_marketing":true,"saved_addresses":[]},"addresses":{"shipping":{"id":"123","first_name":"John","last_name":"Doe","address_line_1":"50 Fultz Blvd","address_line_2":"Suite 200","country":"Canada","city":"Winnipeg","province":"Manitoba","country_code":"CA","province_code":"MB","postal_code":"R3Y0L6","business_name":"Acme Inc.","phone_number":"8005550101"},"billing":{"id":"123","first_name":"John","last_name":"Doe","address_line_1":"50 Fultz Blvd","address_line_2":"Suite 200","country":"Canada","city":"Winnipeg","province":"Manitoba","country_code":"CA","province_code":"MB","postal_code":"R3Y0L6","business_name":"Acme Inc.","phone_number":"8005550101"}},"line_items":[{"product_data":{"id":"724bca","product_title":"Oak Cheese Grater","title":"Small","image_url":"http://shop.images/oakcheesegrater","properties":{"colour":"red","size":"small"},"description":"A handmade oak cheese grater to elevate your cheese-eating experience.","quantity":2,"price":2350,"total_price":4700,"visible":1,"line_item_key":"oak_cheese_grater_2643","barcode":"1234ABC","compare_at_price":4000,"weight":1000,"weight_unit":"g","product_id":"oak-cheese-grater","variant_id":"oak-cheese-grater-small","requires_shipping":true,"sku":"OAK_GRATER_SM","taxable":true,"tags":"Kitchen, Cheese Board, Oak","vendor":"Cheese Boards Unlimited","total_weight":2000}},{"taxes":[{"value":1000,"name":"GST","is_included":true}]},{"fees":[{"amount":500,"name":"Miscellaneous fee."}]},{"discounts":[{"value":0,"text":"Cutting board discount","code":"CHOPCHOP","source":"cart"}]},{"fulfilled_quantity":2}],"fees":[{"id":"123456789","line_text":"Custom Fee \u2014 Added by Plugin","fee_type":"fixed","value":10,"source":"PLUGIN","plugin_uuid":"a52589f8-09df-11ed-b30e-f67072e164ee","taxable":true,"show_description":true}],"taxes":[{"value":1000,"name":"GST","is_included":true}],"discounts":[{"value":0,"text":"Cutting board discount","code":"CHOPCHOP","source":"cart"},{"value":0,"text":"FREESHIPPING","code":"FREESHIPPING","source":"coupon"}],"payments":[{"gateway_public_id":"i7z2xT0sKrDvhGWzex5SLjf5e6ndlQfrRL4AROkfhf3vNBkVT38JKBy5PSjB63qW","amount":4700,"currency":"CAD","type":"spreedly","display_string":"Credit Card Payment","id":"","token":"7uZAMRAf80KiEwibsrrM5IB41yU","retain":false,"payment_parameters":[]}],"order_total":4700,"order_meta_data":{"cart_parameters":{"key":"cp-key1,","property1":"A cart param.","property2":"A cart param."},"note_attributes":{"key":"na-key1","property1":"A note attribute.","property2":"A note attribute."},"notes":"A special delivery note.","tags":["order-1"]},"shipping":{"selected_shipping":{"id":"0","description":"Custom weight-based rate: tier 2","amount":450,"code":"EXPID"},"available_shipping_lines":[{"id":"string,","line":{"id":"0","description":"Custom weight-based rate: tier 2","amount":450,"code":"EXPID"}}],"taxes":[{"value":1000,"name":"GST","is_included":true}],"discounts":[{"value":0,"text":"FREESHIPPING","code":"FREESHIPPING","source":"coupon"}]},"resumable_link":"example.com/checkout/resume","flow_id":"external-company-one-page-template","currency":{"iso_code":"CAD","iso_numeric_code":124,"symbol":"$","format":"${{amount}}","has_decimal":true,"show_iso_code":true},"created_via":"My_Order_Creating_Plugin","is_processed":false,"order_id":79047599,"platform_order_id":"1389wjfalsdf9y4r"}}}},"ListDiscounts":{"summary":"List Discounts","value":{"data":{"discounts":[{"value":0,"text":"Cutting board discount","code":"CHOPCHOP","source":"cart"},{"value":0,"text":"FREESHIPPING","code":"FREESHIPPING","source":"coupon"}],"application_state":{"customer":{"platform_id":"","public_id":"pjpTyGh8KzNQ225wPqxgy7LwNuC887h6ecGyp3omwT4XW8SszjVSdHzWHN4NBwqhA","first_name":"John","last_name":"Doe","email_address":"john.doe@example.com","accepts_marketing":true,"saved_addresses":[]},"addresses":{"shipping":{"id":"123","first_name":"John","last_name":"Doe","address_line_1":"50 Fultz Blvd","address_line_2":"Suite 200","country":"Canada","city":"Winnipeg","province":"Manitoba","country_code":"CA","province_code":"MB","postal_code":"R3Y0L6","business_name":"Acme Inc.","phone_number":"8005550101"},"billing":{"id":"123","first_name":"John","last_name":"Doe","address_line_1":"50 Fultz Blvd","address_line_2":"Suite 200","country":"Canada","city":"Winnipeg","province":"Manitoba","country_code":"CA","province_code":"MB","postal_code":"R3Y0L6","business_name":"Acme Inc.","phone_number":"8005550101"}},"line_items":[{"product_data":{"id":"724bca","product_title":"Oak Cheese Grater","title":"Small","image_url":"http://shop.images/oakcheesegrater","properties":{"colour":"red","size":"small"},"description":"A handmade oak cheese grater to elevate your cheese-eating experience.","quantity":2,"price":2350,"total_price":4700,"visible":1,"line_item_key":"oak_cheese_grater_2643","barcode":"1234ABC","compare_at_price":4000,"weight":1000,"weight_unit":"g","product_id":"oak-cheese-grater","variant_id":"oak-cheese-grater-small","requires_shipping":true,"sku":"OAK_GRATER_SM","taxable":true,"tags":"Kitchen, Cheese Board, Oak","vendor":"Cheese Boards Unlimited","total_weight":2000}},{"taxes":[{"value":1000,"name":"GST","is_included":true}]},{"fees":[{"amount":500,"name":"Miscellaneous fee."}]},{"discounts":[{"value":0,"text":"Cutting board discount","code":"CHOPCHOP","source":"cart"}]},{"fulfilled_quantity":2}],"fees":[{"id":"123456789","line_text":"Custom Fee \u2014 Added by Plugin","fee_type":"fixed","value":10,"source":"PLUGIN","plugin_uuid":"a52589f8-09df-11ed-b30e-f67072e164ee","taxable":true,"show_description":true}],"taxes":[{"value":1000,"name":"GST","is_included":true}],"discounts":[{"value":0,"text":"Cutting board discount","code":"CHOPCHOP","source":"cart"},{"value":0,"text":"FREESHIPPING","code":"FREESHIPPING","source":"coupon"}],"payments":[{"gateway_public_id":"i7z2xT0sKrDvhGWzex5SLjf5e6ndlQfrRL4AROkfhf3vNBkVT38JKBy5PSjB63qW","amount":4700,"currency":"CAD","type":"spreedly","display_string":"Credit Card Payment","id":"","token":"7uZAMRAf80KiEwibsrrM5IB41yU","retain":false,"payment_parameters":[]}],"order_total":4700,"order_meta_data":{"cart_parameters":{"key":"cp-key1,","property1":"A cart param.","property2":"A cart param."},"note_attributes":{"key":"na-key1","property1":"A note attribute.","property2":"A note attribute."},"notes":"A special delivery note.","tags":["order-1"]},"shipping":{"selected_shipping":{"id":"0","description":"Custom weight-based rate: tier 2","amount":450,"code":"EXPID"},"available_shipping_lines":[{"id":"string,","line":{"id":"0","description":"Custom weight-based rate: tier 2","amount":450,"code":"EXPID"}}],"taxes":[{"value":1000,"name":"GST","is_included":true}],"discounts":[{"value":0,"text":"FREESHIPPING","code":"FREESHIPPING","source":"coupon"}]},"resumable_link":"example.com/checkout/resume","flow_id":"external-company-one-page-template","currency":{"iso_code":"CAD","iso_numeric_code":124,"symbol":"$","format":"${{amount}}","has_decimal":true,"show_iso_code":true},"created_via":"My_Order_Creating_Plugin","is_processed":false,"order_id":79047599,"platform_order_id":"1389wjfalsdf9y4r"}}}},"DeletedDiscount":{"summary":"Deleted Discount","value":{"data":{"discounts":[{"value":0,"text":"Cutting board discount","code":"CHOPCHOP","source":"cart"}],"application_state":{"customer":{"platform_id":"","public_id":"pjpTyGh8KzNQ225wPqxgy7LwNuC887h6ecGyp3omwT4XW8SszjVSdHzWHN4NBwqhA","first_name":"John","last_name":"Doe","email_address":"john.doe@example.com","accepts_marketing":true,"saved_addresses":[]},"addresses":{"shipping":{"id":"123","first_name":"John","last_name":"Doe","address_line_1":"50 Fultz Blvd","address_line_2":"Suite 200","country":"Canada","city":"Winnipeg","province":"Manitoba","country_code":"CA","province_code":"MB","postal_code":"R3Y0L6","business_name":"Acme Inc.","phone_number":"8005550101"},"billing":{"id":"123","first_name":"John","last_name":"Doe","address_line_1":"50 Fultz Blvd","address_line_2":"Suite 200","country":"Canada","city":"Winnipeg","province":"Manitoba","country_code":"CA","province_code":"MB","postal_code":"R3Y0L6","business_name":"Acme Inc.","phone_number":"8005550101"}},"line_items":[{"product_data":{"id":"724bca","product_title":"Oak Cheese Grater","title":"Small","image_url":"http://shop.images/oakcheesegrater","properties":{"colour":"red","size":"small"},"description":"A handmade oak cheese grater to elevate your cheese-eating experience.","quantity":2,"price":2350,"total_price":4700,"visible":1,"line_item_key":"oak_cheese_grater_2643","barcode":"1234ABC","compare_at_price":4000,"weight":1000,"weight_unit":"g","product_id":"oak-cheese-grater","variant_id":"oak-cheese-grater-small","requires_shipping":true,"sku":"OAK_GRATER_SM","taxable":true,"tags":"Kitchen, Cheese Board, Oak","vendor":"Cheese Boards Unlimited","total_weight":2000}},{"taxes":[{"value":1000,"name":"GST","is_included":true}]},{"fees":[{"amount":500,"name":"Miscellaneous fee."}]},{"discounts":[{"value":0,"text":"Cutting board discount","code":"CHOPCHOP","source":"cart"}]},{"fulfilled_quantity":2}],"fees":[{"id":"123456789","line_text":"Custom Fee \u2014 Added by Plugin","fee_type":"fixed","value":10,"source":"PLUGIN","plugin_uuid":"a52589f8-09df-11ed-b30e-f67072e164ee","taxable":true,"show_description":true}],"taxes":[{"value":1000,"name":"GST","is_included":true}],"discounts":[{"value":0,"text":"Cutting board discount","code":"CHOPCHOP","source":"cart"}],"payments":[{"gateway_public_id":"i7z2xT0sKrDvhGWzex5SLjf5e6ndlQfrRL4AROkfhf3vNBkVT38JKBy5PSjB63qW","amount":4700,"currency":"CAD","type":"spreedly","display_string":"Credit Card Payment","id":"","token":"7uZAMRAf80KiEwibsrrM5IB41yU","retain":false,"payment_parameters":[]}],"order_total":4700,"order_meta_data":{"cart_parameters":{"key":"cp-key1,","property1":"A cart param.","property2":"A cart param."},"note_attributes":{"key":"na-key1","property1":"A note attribute.","property2":"A note attribute."},"notes":"A special delivery note.","tags":["order-1"]},"shipping":{"selected_shipping":{"id":"0","description":"Custom weight-based rate: tier 2","amount":450,"code":"EXPID"},"available_shipping_lines":[{"id":"string,","line":{"id":"0","description":"Custom weight-based rate: tier 2","amount":450,"code":"EXPID"}}],"taxes":[{"value":1000,"name":"GST","is_included":true}],"discounts":[]},"resumable_link":"example.com/checkout/resume","flow_id":"external-company-one-page-template","currency":{"iso_code":"CAD","iso_numeric_code":124,"symbol":"$","format":"${{amount}}","has_decimal":true,"show_iso_code":true},"created_via":"My_Order_Creating_Plugin","is_processed":false,"order_id":79047599,"platform_order_id":"1389wjfalsdf9y4r"}}}},"DeletedLineItem":{"summary":"Deleted Line item","value":{"data":{"line_items":[],"application_state":{"customer":{"platform_id":"","public_id":"pjpTyGh8KzNQ225wPqxgy7LwNuC887h6ecGyp3omwT4XW8SszjVSdHzWHN4NBwqhA","first_name":"John","last_name":"Doe","email_address":"john.doe@example.com","accepts_marketing":true,"saved_addresses":[]},"addresses":{"shipping":{"id":"123","first_name":"John","last_name":"Doe","address_line_1":"50 Fultz Blvd","address_line_2":"Suite 200","country":"Canada","city":"Winnipeg","province":"Manitoba","country_code":"CA","province_code":"MB","postal_code":"R3Y0L6","business_name":"Acme Inc.","phone_number":"8005550101"},"billing":{"id":"123","first_name":"John","last_name":"Doe","address_line_1":"50 Fultz Blvd","address_line_2":"Suite 200","country":"Canada","city":"Winnipeg","province":"Manitoba","country_code":"CA","province_code":"MB","postal_code":"R3Y0L6","business_name":"Acme Inc.","phone_number":"8005550101"}},"line_items":[],"fees":[{"id":"123456789","line_text":"Custom Fee \u2014 Added by Plugin","fee_type":"fixed","value":10,"source":"PLUGIN","plugin_uuid":"a52589f8-09df-11ed-b30e-f67072e164ee","taxable":true,"show_description":true}],"taxes":[{"value":1000,"name":"GST","is_included":true}],"discounts":[{"value":0,"text":"Cutting board discount","code":"CHOPCHOP","source":"cart"},{"value":0,"text":"FREESHIPPING","code":"FREESHIPPING","source":"coupon"}],"payments":[{"gateway_public_id":"i7z2xT0sKrDvhGWzex5SLjf5e6ndlQfrRL4AROkfhf3vNBkVT38JKBy5PSjB63qW","amount":4700,"currency":"CAD","type":"spreedly","display_string":"Credit Card Payment","id":"","token":"7uZAMRAf80KiEwibsrrM5IB41yU","retain":false,"payment_parameters":[]}],"order_total":4700,"order_meta_data":{"cart_parameters":{"key":"cp-key1,","property1":"A cart param.","property2":"A cart param."},"note_attributes":{"key":"na-key1","property1":"A note attribute.","property2":"A note attribute."},"notes":"A special delivery note.","tags":["order-1"]},"shipping":{"selected_shipping":{"id":"0","description":"Custom weight-based rate: tier 2","amount":450,"code":"EXPID"},"available_shipping_lines":[{"id":"string,","line":{"id":"0","description":"Custom weight-based rate: tier 2","amount":450,"code":"EXPID"}}],"taxes":[{"value":1000,"name":"GST","is_included":true}],"discounts":[{"value":0,"text":"FREESHIPPING","code":"FREESHIPPING","source":"coupon"}]},"resumable_link":"example.com/checkout/resume","flow_id":"external-company-one-page-template","currency":{"iso_code":"CAD","iso_numeric_code":124,"symbol":"$","format":"${{amount}}","has_decimal":true,"show_iso_code":true},"created_via":"My_Order_Creating_Plugin","is_processed":false,"order_id":79047599,"platform_order_id":"1389wjfalsdf9y4r"}}}},"DeletedPayment":{"value":{"data":{"application_state":{"customer":{"platform_id":"50942578465125","public_id":"pjpTyGh8KzNQ225wPqxgy7LwNuC887h6ecGyp3omwT4XW8SszjVSdHzWHN4NBwqhA","first_name":"John","last_name":"Doe","email_address":"john.doe@example.com","accepts_marketing":true,"saved_addresses":[{"id":"123","first_name":"John","last_name":"Doe","address_line_1":"50 Fultz Blvd","address_line_2":"Suite 200","country":"Canada","city":"Winnipeg","province":"Manitoba","country_code":"CA","province_code":"MB","postal_code":"R3Y0L6","business_name":"Acme Inc.","phone_number":"8005550101"}]},"addresses":{"shipping":{"id":"123","first_name":"John","last_name":"Doe","address_line_1":"50 Fultz Blvd","address_line_2":"Suite 200","country":"Canada","city":"Winnipeg","province":"Manitoba","country_code":"CA","province_code":"MB","postal_code":"R3Y0L6","business_name":"Acme Inc.","phone_number":"8005550101"},"billing":{"id":"123","first_name":"John","last_name":"Doe","address_line_1":"50 Fultz Blvd","address_line_2":"Suite 200","country":"Canada","city":"Winnipeg","province":"Manitoba","country_code":"CA","province_code":"MB","postal_code":"R3Y0L6","business_name":"Acme Inc.","phone_number":"8005550101"}},"line_items":[{"product_data":{"id":"724bca","product_title":"Oak Cheese Grater","title":"Small","image_url":"http://shop.images/oakcheesegrater","properties":{"colour":"red","size":"small"},"description":"A handmade oak cheese grater to elevate your cheese-eating experience.","quantity":2,"price":2350,"total_price":4700,"visible":1,"line_item_key":"oak_cheese_grater_2643","barcode":"1234ABC","compare_at_price":4000,"weight":1000,"weight_unit":"g","product_id":"oak-cheese-grater","variant_id":"oak-cheese-grater-small","requires_shipping":true,"sku":"OAK_GRATER_SM","taxable":true,"tags":"Kitchen, Cheese Board, Oak","vendor":"Cheese Boards Unlimited","total_weight":2000}},{"taxes":[{"value":1000,"name":"GST","is_included":true}]},{"fees":[{"amount":500,"name":"Miscellaneous fee."}]},{"discounts":[{"value":0,"text":"Cutting board discount","code":"CHOPCHOP","source":"cart"},{"value":0,"text":"FREESHIPPING","code":"FREESHIPPING","source":"coupon"}]},{"fulfilled_quantity":2}],"fees":[{"id":"123456789","line_text":"Custom Fee \u2014 Added by Plugin","fee_type":"fixed","value":10,"source":"PLUGIN","plugin_uuid":"a52589f8-09df-11ed-b30e-f67072e164ee","taxable":true,"show_description":true}],"taxes":[{"value":1000,"name":"GST","is_included":true}],"discounts":[{"code":"FREESHIPPING","text":"FREESHIPPING","value":500,"source":"coupon"}],"payments":[],"order_total":4700,"order_meta_data":{"cart_parameters":{"key":"cp-key1,","property1":"A cart param.","property2":"A cart param."},"note_attributes":{"key":"na-key1","property1":"A note attribute.","property2":"A note attribute."},"notes":"A special delivery note.","tags":["order-1"]},"shipping":{"selected_shipping":{"id":"0","description":"Custom weight-based rate: tier 2","amount":450,"code":"EXPID"},"available_shipping_lines":[{"id":"string,","line":{"id":"0","description":"Custom weight-based rate: tier 2","amount":450,"code":"EXPID"}}],"taxes":[{"value":1000,"name":"GST","is_included":true}],"discounts":[{"value":500,"text":"FREESHIPPING","code":"FREESHIPPING","source":"coupon"}]},"resumable_link":"example.com/checkout/resume","flow_id":"external-company-one-page-template","currency":{"iso_code":"CAD","iso_numeric_code":124,"symbol":"$","format":"${{amount}}","has_decimal":true,"show_iso_code":true},"created_via":"My_Order_Creating_Plugin","is_processed":false,"order_id":79047599,"platform_order_id":"1389wjfalsdf9y4r"}}}},"CartItemResponse":{"value":{"platform_id":5423,"sku":"OAK_GRATER_SM","quantity":2,"line_item_key":"ABC123","line_item_properties":{"colour":"red","size":"small"}}},"CartItemGiftCard":{"value":{"platform_id":"786dur","sku":"GIFT_CARD_50","quantity":2,"line_item_key":"ABC123","line_item_properties":{"recipient_name":"John Doe","recipient_email":"johndoe@boldcommerce.com","message":"Dear John, Happy Birthday!","custom_amount":"2450"}}},"GiftCardLineItem":{"summary":"Gift Card Line Item Response","value":{"data":{"line_items":[{"id":"786dur","product_title":"Gift Card $50","title":"Gift Card","image_url":"http://shop.images/50GiftCard","properties":{"recipient_name":"John Doe","recipient_email":"johndoe@boldcommerce.com","message":"Dear John, Happy Birthday!","custom_amount":"5000"},"description":"Gifting is fun, here is a Gift Card.","quantity":2,"price":4700,"total_price":9400,"visible":1,"line_item_key":"ABC123","barcode":"1234ABC","product_id":"gift-card","variant_id":"50-gift-card","requires_shipping":false,"sku":"GIFT_CARD_50","taxable":true,"tags":"Gift Card, Present","vendor":"Cheese Boards Unlimited"}],"application_state":{"customer":{"platform_id":"50942578465125","public_id":"pjpTyGh8KzNQ225wPqxgy7LwNuC887h6ecGyp3omwT4XW8SszjVSdHzWHN4NBwqhA","first_name":"John","last_name":"Doe","email_address":"john.doe@example.com","accepts_marketing":true,"saved_addresses":{"id":"123","first_name":"John","last_name":"Doe","address_line_1":"50 Fultz Blvd","address_line_2":"Suite 200","country":"Canada","city":"Winnipeg","province":"Manitoba","country_code":"CA","province_code":"MB","postal_code":"R3Y0L6","business_name":"Acme Inc.","phone_number":"8005550101"}},"addresses":{"shipping":{"id":"123","first_name":"John","last_name":"Doe","address_line_1":"50 Fultz Blvd","address_line_2":"Suite 200","country":"Canada","city":"Winnipeg","province":"Manitoba","country_code":"CA","province_code":"MB","postal_code":"R3Y0L6","business_name":"Acme Inc.","phone_number":"8005550101"},"billing":{"id":"123","first_name":"John","last_name":"Doe","address_line_1":"50 Fultz Blvd","address_line_2":"Suite 200","country":"Canada","city":"Winnipeg","province":"Manitoba","country_code":"CA","province_code":"MB","postal_code":"R3Y0L6","business_name":"Acme Inc.","phone_number":"8005550101"}},"line_items":[{"product_data":{"id":"786dur","product_title":"Gift Card $50","title":"Gift Card","image_url":"http://shop.images/50GiftCard","properties":{"recipient_name":"John Doe","recipient_email":"johndoe@boldcommerce.com","message":"Dear John, Happy Birthday!","custom_amount":"5000"},"description":"Gifting is fun, here is a Gift Card.","quantity":2,"price":4700,"total_price":9400,"visible":1,"line_item_key":"ABC123","barcode":"1234ABC","product_id":"gift-card","variant_id":"50-gift-card","requires_shipping":false,"sku":"GIFT_CARD_50","taxable":true,"tags":"Gift Card, Present","vendor":"Cheese Boards Unlimited"},"taxes":[{"value":1000,"name":"GST","is_included":true}],"fees":[{"amount":500,"name":"Miscellaneous fee."}],"discounts":"","fulfilled_quantity":2}],"fees":{"id":"123456789","line_text":"Custom Fee \u2014 Added by Plugin","fee_type":"fixed","value":10,"source":"PLUGIN","plugin_uuid":"a52589f8-09df-11ed-b30e-f67072e164ee","taxable":true,"show_description":true},"taxes":{"value":1000,"name":"GST","is_included":true},"discounts":[{"value":0,"text":"FREESHIPPING","code":"FREESHIPPING","source":"coupon"},{"value":500,"text":"Cutting board discount","code":"CHOPCHOP","source":"cart"}],"payments":{"gateway_public_id":"i7z2xT0sKrDvhGWzex5SLjf5e6ndlQfrRL4AROkfhf3vNBkVT38JKBy5PSjB63qW","amount":4700,"currency":"CAD","type":"spreedly","display_string":"Credit Card Payment","id":"","token":"7uZAMRAf80KiEwibsrrM5IB41yU","retain":false,"payment_parameters":[]},"order_total":4700,"order_meta_data":{"cart_parameters":{"key":"cp-key1","additionalProperties":"A cart param."},"note_attributes":{"key":"na-key1","additionalProperties":"A note attribute."},"notes":"A special delivery note.","tags":{"items":"order-1"}},"shipping":{"selected_shipping":{"id":"0","description":"Custom weight-based rate: tier 2","amount":450,"code":"EXPID"},"available_shipping_lines":{"id":null,"line":{"id":"0","description":"Custom weight-based rate: tier 2","amount":450,"code":"EXPID"}},"taxes":{"value":1000,"name":"GST","is_included":true},"discounts":{"value":0,"text":"FREESHIPPING","code":"FREESHIPPING","source":"coupon"}},"resumable_link":"example.com/checkout/resume","flow_id":"external-company-one-page-template","currency":{"iso_code":"CAD","iso_numeric_code":124,"symbol":"$","format":"${{amount}}","has_decimal":true,"show_iso_code":true},"created_via":"My_Order_Creating_Plugin","is_processed":false,"order_id":79047599,"platform_order_id":"1389wjfalsdf9y4r"}}}},"CartItem":{"summary":"Cart item Response","value":{"data":{"line_items":[{"id":"724bca","product_title":"Oak Cheese Grater","title":"Small","image_url":"http://shop.images/oakcheesegrater","properties":{"colour":"red","size":"small"},"description":"A handmade oak cheese grater to elevate your cheese-eating experience.","quantity":2,"price":2350,"total_price":4700,"visible":1,"line_item_key":"ABC123","barcode":"1234ABC","compare_at_price":4000,"weight":1000,"weight_unit":"g","product_id":"oak-cheese-grater","variant_id":"oak-cheese-grater-small","requires_shipping":true,"sku":"OAK_GRATER_SM","taxable":true,"tags":"Kitchen, Cheese Board, Oak","vendor":"Cheese Boards Unlimited","total_weight":2000}],"application_state":{"customer":{"platform_id":"50942578465125","public_id":"pjpTyGh8KzNQ225wPqxgy7LwNuC887h6ecGyp3omwT4XW8SszjVSdHzWHN4NBwqhA","first_name":"John","last_name":"Doe","email_address":"john.doe@example.com","accepts_marketing":true,"saved_addresses":{"id":"123","first_name":"John","last_name":"Doe","address_line_1":"50 Fultz Blvd","address_line_2":"Suite 200","country":"Canada","city":"Winnipeg","province":"Manitoba","country_code":"CA","province_code":"MB","postal_code":"R3Y0L6","business_name":"Acme Inc.","phone_number":"8005550101"}},"addresses":{"shipping":{"id":"123","first_name":"John","last_name":"Doe","address_line_1":"50 Fultz Blvd","address_line_2":"Suite 200","country":"Canada","city":"Winnipeg","province":"Manitoba","country_code":"CA","province_code":"MB","postal_code":"R3Y0L6","business_name":"Acme Inc.","phone_number":"8005550101"},"billing":{"id":"123","first_name":"John","last_name":"Doe","address_line_1":"50 Fultz Blvd","address_line_2":"Suite 200","country":"Canada","city":"Winnipeg","province":"Manitoba","country_code":"CA","province_code":"MB","postal_code":"R3Y0L6","business_name":"Acme Inc.","phone_number":"8005550101"}},"line_items":[{"product_data":{"id":"724bca","product_title":"Oak Cheese Grater","title":"Small","image_url":"http://shop.images/oakcheesegrater","properties":{"colour":"red","size":"small"},"description":"A handmade oak cheese grater to elevate your cheese-eating experience.","quantity":2,"price":2350,"total_price":4700,"visible":1,"line_item_key":"oak_cheese_grater_2643","barcode":"1234ABC","compare_at_price":4000,"weight":1000,"weight_unit":"g","product_id":"oak-cheese-grater","variant_id":"oak-cheese-grater-small","requires_shipping":true,"sku":"OAK_GRATER_SM","taxable":true,"tags":"Kitchen, Cheese Board, Oak","vendor":"Cheese Boards Unlimited","total_weight":2000},"taxes":[{"value":1000,"name":"GST","is_included":true}],"fees":[{"amount":500,"name":"Miscellaneous fee."}],"discounts":[{"value":0,"text":"Cutting board discount","code":"CHOPCHOP","source":"cart"},{"value":0,"text":"FREESHIPPING","code":"FREESHIPPING","source":"coupon"}],"fulfilled_quantity":2}],"fees":{"id":"123456789","line_text":"Custom Fee \u2014 Added by Plugin","fee_type":"fixed","value":10,"source":"PLUGIN","plugin_uuid":"a52589f8-09df-11ed-b30e-f67072e164ee","taxable":true,"show_description":true},"taxes":{"value":1000,"name":"GST","is_included":true},"discounts":[{"value":0,"text":"FREESHIPPING","code":"FREESHIPPING","source":"coupon"},{"value":500,"text":"Cutting board discount","code":"CHOPCHOP","source":"cart"}],"payments":{"gateway_public_id":"i7z2xT0sKrDvhGWzex5SLjf5e6ndlQfrRL4AROkfhf3vNBkVT38JKBy5PSjB63qW","amount":4700,"currency":"CAD","type":"spreedly","display_string":"Credit Card Payment","id":"","token":"7uZAMRAf80KiEwibsrrM5IB41yU","retain":false,"payment_parameters":[]},"order_total":4700,"order_meta_data":{"cart_parameters":{"key":"cp-key1","additionalProperties":"A cart param."},"note_attributes":{"key":"na-key1","additionalProperties":"A note attribute."},"notes":"A special delivery note.","tags":{"items":"order-1"}},"shipping":{"selected_shipping":{"id":"0","description":"Custom weight-based rate: tier 2","amount":450,"code":"EXPID"},"available_shipping_lines":{"id":null,"line":{"id":"0","description":"Custom weight-based rate: tier 2","amount":450,"code":"EXPID"}},"taxes":{"value":1000,"name":"GST","is_included":true},"discounts":{"value":0,"text":"FREESHIPPING","code":"FREESHIPPING","source":"coupon"}},"resumable_link":"example.com/checkout/resume","flow_id":"external-company-one-page-template","currency":{"iso_code":"CAD","iso_numeric_code":124,"symbol":"$","format":"${{amount}}","has_decimal":true,"show_iso_code":true},"created_via":"My_Order_Creating_Plugin","is_processed":false,"order_id":79047599,"platform_order_id":"1389wjfalsdf9y4r"}}}}},"responses":{"Unauthorized-JWT":{"description":"Unauthorized error messages may be returned if the JWT is missing or was not provided properly using the Authorization header. An invalid error message may also be returned when the JWT contains invalid data. The JWT expires after 60 minutes, in which case an expired JWT error message will be returned.","x-summary":"Unauthorized JWT","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"$ref":"#/components/schemas/AuthorizationError"}}}},"examples":{"expired-jwt":{"value":{"errors":[{"code":"00-1","type":"authorization.expired_jwt","message":"Expired JWT"}]}},"invalid-jwt":{"value":{"errors":[{"code":"00-1","type":"authorization.invalid_jwt","message":"Invalid JWT"}]}},"missing-jwt":{"value":{"errors":[{"code":"00-1","type":"authorization.missing_jwt","message":"Missing JWT"}]}}}}}},"OrderNotFound":{"description":"The order could not be found by the given ID.","x-summary":"Order not found","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","description":"The error returned when an order can\'t be found.","items":{"type":"object","description":"Properties for the error.","properties":{"code":{"type":"string","description":"The error code.","example":"02-92"},"type":{"type":"string","description":"The type of error.","example":"order_not_found_by_id"},"message":{"type":"string","description":"A description of the error.","example":"No order found by identifier: 123abc"}}}}}}}}},"WalletPayUnprocessableEntity":{"description":"There was a problem with the object provided in the request.","x-summary":"Unprocessable Entity","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","description":"An error message describing what went wrong.","items":{"type":"object","description":"Properties for the error.","properties":{"code":{"type":"string","description":"The error code.","example":"02-92"},"type":{"type":"string","description":"The type of error.","example":"gateway_type_not_found"},"message":{"type":"string","description":"A description of the error.","example":"Invalid gateway type."}}}}}}}}},"GiftCardNotFound":{"description":"The gift card could not be found by the given ID.","x-summary":"Gift Card Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","description":"The error code.","example":"02-90"},"type":{"type":"string","description":"The type of error.","example":"checkout.api_payment_removal_failed"},"message":{"type":"string","description":"A description of the error.","example":"Gift card payment not found."}}}}}}}}}}}}},"plugin-redoc-1":{"url":"/api/customers.openapi.yaml","themeId":"theme-redoc","isSpecFile":true,"spec":{"openapi":"3.0.0","info":{"title":"Internal customers service","description":"This API allows you to find information about your customers.\\n\\nRefer to the changelog for the latest updates to this API.","contact":{"name":"Contact Us","url":"https://developer-dashboard.boldcommerce.com/default/contactus"},"version":"2.0.0"},"servers":[{"url":"http://customer-api.prod.svc.cluster.local:9000"},{"url":"http://customer-api.staging.svc.cluster.local:9000"},{"url":"http://localhost:9106"}],"tags":[{"name":"Customer Event Notifications","description":"Event notifications you send to Bold when a change occurs to customers on the platform."},{"name":"Order Event Notifications","description":"Event notifications you send to Bold when a change occurs to orders on the platform."},{"name":"Product Event Notifications","description":"Event notifications you send to Bold when a change occurs to products on the platform."},{"name":"Customers","description":"Contains information about the customers associated with a given store. Use these endpoints to retrieve information about one or all customers on your store."},{"name":"Addresses","description":"Contains information about the shipping and billing addresses associated with a given store. Use these endpoints to retrieve information about one or all customer addresses on your store."}],"paths":{"/v1/shops/{shop_identifier}/platforms/custom/webhooks/customers/saved":{"parameters":[{"$ref":"#/components/parameters/shopIdentifier"}],"post":{"tags":["Customer Event Notifications"],"summary":"Customer Saved","operationId":"CustomerSavedEventNotification","description":"Trigger this API call when customer data changes on the platform. This includes customer creation, customer updates, and any changes to a customer\'s associated addresses.\\n\\nBold queues the customer for saving. The request must contain the complete customer object and its addresses at the time the change occurred. Bold replaces all fields of the existing customer object with the values provided in the request body. Bold ignores and does not update the fields omitted from the request body.\\n\\nThe `platform_updated_at` field must be accurate to mitigate the risk incurred by out-of-sequence requests.","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/customerSavedRequestBody"}}},"required":true},"responses":{"202":{"description":"Event notification was queued successfully.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"A validation error occurred.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/validationError"},"examples":{"validationError":{"value":{"status_code":400,"errors":["Error at \'/data/customer/addresses/0/platform_id\': property \'platform_id\' is missing","Error at \'/data/customer/platform_id\': property \'platform_id\' is missing"]}}}}}},"500":{"description":"An unexpected error occurred.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/runtimeErrorCustomer"},"examples":{"internalError":{"$ref":"#/components/examples/internalError"}}}}}}}},"/v1/shops/{shop_identifier}/platforms/custom/webhooks/customers/deleted":{"parameters":[{"$ref":"#/components/parameters/shopIdentifier"}],"post":{"tags":["Customer Event Notifications"],"summary":"Customer Deleted","operationId":"CustomerDeletedEventNotification","description":"Trigger this API call when a customer is deleted on the platform.\\n\\nBold queues the customer for deletion. The `platform_deleted_at` field must be accurate to mitigate the risk incurred by out-of-sequence requests.","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/customerDeletedRequestBody"}}},"required":true},"responses":{"202":{"description":"Event notification was queued successfully.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"A validation error occurred.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/validationError"},"examples":{"validationError":{"value":{"status_code":400,"errors":["Error at \'/data/customer/platform_id\': property \'platform_id\' is missing"]}}}}}},"500":{"description":"An unexpected error occurred.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/runtimeErrorCustomer"},"examples":{"internalError":{"$ref":"#/components/examples/internalError"}}}}}}}},"/v2/shops/{shop_identifier}/customers/{id}":{"get":{"tags":["Customers"],"summary":"Get Customer by ID","operationId":"GetCustomerByID","description":"Retrieves a customer by the Bold-generated ID.","parameters":[{"$ref":"#/components/parameters/shop_identifier"},{"name":"id","in":"path","required":true,"description":"A unique identifier for the customer, generated by Bold.","schema":{"type":"integer","format":"int64"},"example":82435920}],"responses":{"200":{"description":"A successful response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/v2CustomerByXIDResponse"}}}},"default":{"description":"An unexpected error response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/runtimeError"}}}}}}},"/v2/shops/{shop_identifier}/customers/pid/{platform_id}":{"get":{"tags":["Customers"],"summary":"Get Customer by Platform ID","description":"Retrieves a customer by the platform-generated customer ID.","operationId":"GetCustomerByPlatformID","parameters":[{"$ref":"#/components/parameters/shop_identifier"},{"$ref":"#/components/parameters/platform_id"}],"responses":{"200":{"description":"A successful response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/v2CustomerByXIDResponse"}}}},"default":{"description":"An unexpected error response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/runtimeError"}}}}}}},"/v2/shops/{shop_identifier}/customers":{"get":{"tags":["Customers"],"summary":"List Customers","operationId":"ListCustomers","description":"Lists the customers that have placed orders on the store. \\n\\nAll query parameters must be URL-encoded. For more information about searching, refer to [Query & Pagination](/guides/checkout/resources/query-pagination).","parameters":[{"$ref":"#/components/parameters/shop_identifier"},{"$ref":"#/components/parameters/since_id"},{"name":"updated_at_min","in":"query","description":"The earliest date (in [RFC3339 format](https://datatracker.ietf.org/doc/html/rfc3339)) that the customer was updated.","schema":{"type":"string","format":"date-time"},"example":"2020-01-01T00:00:00Z"},{"name":"updated_at_max","in":"query","description":"The latest date (in [RFC3339 format](https://datatracker.ietf.org/doc/html/rfc3339)) that the customer was updated.","schema":{"type":"string","format":"date-time"},"example":"2022-01-01T00:00:00Z"},{"name":"search","in":"query","description":"A search term used to perform a fuzzy search across the customer\'s `first_name`, `last_name`, `email`, and `phone`.","schema":{"type":"string"},"example":"%27bob%20dylan%27"},{"name":"ids","in":"query","description":"A comma-separated list of customer IDs.","schema":{"type":"string"},"example":"142329453,23490134,40245842"},{"name":"orderby","in":"query","description":"The method of ordering the returned results. Must be paired with the `orderdirection` query parameter.","schema":{"type":"string"},"example":"first_name"},{"name":"orderdirection","in":"query","description":"The direction of ordering returned results. Must be paired with the `orderby` query parameter. Possible values include `asc` and `desc`.","schema":{"type":"string"},"example":"asc"},{"name":"filter","in":"query","style":"form","explode":true,"description":"The filtering mechanism to apply to the query. For more information, refer to [Query & Pagination](/guides/checkout/resources/query-pagination#filter).","schema":{"type":"array","items":{"type":"string","example":"eq(id:11)"}}},{"name":"label","in":"query","description":"The label assigned to the customer.","schema":{"type":"string"},"example":"loyal_cust"},{"name":"limit","in":"query","description":"The number of results per page.","schema":{"type":"integer","format":"int32"},"example":50},{"name":"page","in":"query","description":"The page of results to return.","schema":{"type":"integer","format":"int32"},"example":2}],"responses":{"200":{"description":"A successful response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/v2CustomerListResponse"}}}},"default":{"description":"An unexpected error response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/runtimeError"}}}}}}},"/v2/shops/{shop_identifier}/customers/pid/{platform_id}/validate":{"get":{"tags":["Customers"],"summary":"Validate Customer JWT","operationId":"ValidateCustomerJWT","description":"Validates a customer JWT issued by the Bold platform. The JWT is used to make calls to the [Checkout Frontend](checkout) API.","parameters":[{"$ref":"#/components/parameters/shop_identifier"},{"$ref":"#/components/parameters/platform_id"},{"$ref":"#/components/parameters/jwt"}],"responses":{"200":{"description":"A successful response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/v2CustomerJWTValidateResponse"}}}},"400":{"description":"An invalid JWT.","content":{"application/json":{"schema":{"type":"object","properties":{"status_code":{"type":"number","description":"The status code.","example":400},"errors":{"type":"array","description":"An array of errors","items":{"type":"string","example":"invalid request"}}}}}}},"default":{"description":"An unexpected error response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/runtimeError"}}}}}}},"/v2/shops/{shop_identifier}/customers/{customer_id}/addresses/{id}":{"get":{"tags":["Addresses"],"summary":"Get Customer Address by ID","operationId":"GetCustomerAddressByID","description":"Retrieves a customer address by the customer ID and the address ID.","parameters":[{"$ref":"#/components/parameters/shop_identifier"},{"$ref":"#/components/parameters/customer_id"},{"name":"id","in":"path","required":true,"schema":{"type":"integer","format":"int64"},"description":"A unique identifier for the address, generated by Bold.","example":90235719}],"responses":{"200":{"description":"A successful response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/v2AddressGetResponse"}}}},"default":{"description":"An unexpected error response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/runtimeError"}}}}}}},"/v2/shops/{shop_identifier}/customers/{customer_id}/addresses":{"get":{"tags":["Addresses"],"summary":"List Customer Addresses","operationId":"ListCustomerAddresses","description":"Lists all customer addresses for your store. For more information about searching, refer to [Query & Pagination](/guides/checkout/resources/query-pagination).","parameters":[{"$ref":"#/components/parameters/shop_identifier"},{"$ref":"#/components/parameters/customer_id"}],"responses":{"200":{"description":"A successful response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/v2AddressListResponse"}}}},"default":{"description":"An unexpected error response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/runtimeError"}}}}}}}},"components":{"parameters":{"shopIdentifier":{"name":"shop_identifier","in":"path","description":"A unique identifier of the store. This can be retrieved by calling the [Get Shop\\nInfo](shops#tag/Shops/operation/GetShopInfo#) endpoint.","required":true,"schema":{"type":"string","example":"zp3oafdor9"}},"shop_identifier":{"name":"shop_identifier","in":"path","required":true,"schema":{"type":"string"},"description":"A unique identifier for the store, generated by Bold. Retrieve this information by calling the [Get Shop Info](shops#tag/Shop/operation/GetShopInfo) endpoint.","example":"zp3oafdor9"},"platform_id":{"name":"platform_id","in":"path","required":true,"description":"A unique identifier for the customer, generated by the platform.","schema":{"type":"string"},"example":"2"},"since_id":{"name":"since_id","in":"query","description":"Specifies results that fall after the given ID.","schema":{"type":"integer","format":"int64"},"example":2459023599},"jwt":{"name":"jwt","in":"query","description":"The JSON Web Token (JWT) generated during the [initialization of the order](orders#tag/Orders/operation/InitializeOrder).","schema":{"type":"string"},"example":"eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJhdXRoX3R5cGUiOiJWMl9BUEkiLCJwYXlsb2FkIjp7InB1YmxpY19vcmRlcl9pZCI6Inlyb0Y2NDNNeUpTZVZRUUpES2R2c2QxYXdXY3BpRVFJbkhOaTJkWlhmWW9PdVI0dmFGVUhpNHBPRG9pRWFpOVQifSwiZXhwIjoxNjMyMzQxMjg3LCJuYmYiOm51bGwsImlhdCI6bnVsbH0.swmYcVBHyK2i86jN-bIOL3WOCzP5VQVLq9Ev-TfIC_c"},"customer_id":{"name":"customer_id","in":"path","required":true,"schema":{"type":"integer","format":"int64"},"example":82435920147,"description":"A unique identifier for the customer, generated by Bold."}},"schemas":{"customerBase":{"type":"object","properties":{"email":{"description":"The email address for the customer.","type":"string","format":"email","example":"john.doe@example.com"},"first_name":{"description":"The first name of the customer.","type":"string","example":"John"},"last_name":{"description":"The last name of the customer.","type":"string","example":"Doe"},"phone":{"description":"A phone number for the customer.","type":"string","format":"phone","example":"555-555-5555"}}},"addressBaseCustomer":{"type":"object","properties":{"address_type":{"description":"The type of the address (i.e., residential, commercial).","type":"string","example":"commercial"},"address_use":{"description":"The usage of the address. Possible values are `\\"billing\\"` or `\\"shipping\\"`.","type":"string","enum":["billing","shipping"],"example":"shipping"},"company":{"description":"The name of the company operating at the specified address, if applicable.","type":"string","example":"Acme Corp."},"city":{"description":"The name of the city associated with the address.","type":"string","example":"Winnipeg"},"country":{"description":"The name of the country associated with the address.","type":"string","example":"Canada"},"country_code":{"description":"The country code (in [ISO 3166-1 alpha-2 format](https://www.iso.org/iso-3166-country-codes.html)) of the address.","type":"string","example":"CA"},"is_default":{"description":"Indicates whether this is the default address for the customer. There can only be one default address for a customer. If this modifies any other resources, ensure the appropriate event notifications are triggered for those affected by this change.","type":"boolean","format":"boolean","example":true},"first_name":{"description":"The first name of the customer with the address.","type":"string","example":"John"},"last_name":{"description":"The last name of the customer with the address.","type":"string","example":"Doe"},"phone":{"description":"The phone number of the addressee.","type":"string","format":"phone","example":"555-555-5555"},"postal_code":{"description":"The postal code or zip code for the address.","type":"string","example":"H0H 0H0"},"province":{"description":"The province or state for the address.","type":"string","example":"Manitoba"},"province_code":{"description":"The province or state abbreviation for the address.","type":"string","example":"MB"},"street_1":{"description":"The primary street information for the address.","type":"string","example":"123 North Road"},"street_2":{"description":"Additional street information for the address.","type":"string","example":"Unit 5"}}},"customerAddress":{"type":"object","allOf":[{"$ref":"#/components/schemas/addressBaseCustomer"}],"properties":{"platform_id":{"description":"A unique identifier for the address. Assigned by the platform.","type":"string","example":"Address_456"}},"required":["platform_id"]},"customer":{"type":"object","allOf":[{"$ref":"#/components/schemas/customerBase"}],"properties":{"addresses":{"description":"A list of customer addresses.","type":"array","items":{"$ref":"#/components/schemas/customerAddress"}},"platform_created_at":{"description":"The date (in [RFC3339 format](https://datatracker.ietf.org/doc/html/rfc3339)) that this customer was created on the platform. Assigned by the platform.","type":"string","format":"date-time","example":"2023-01-09T15:35:57"},"platform_updated_at":{"description":"The date (in [RFC3339 format](https://datatracker.ietf.org/doc/html/rfc3339)) that this customer was last modified on the platform. Assigned by the platform.","type":"string","format":"date-time","example":"2023-01-09T15:35:57"},"platform_id":{"description":"A unique identifier for the customer. Assigned by the platform.","type":"string","example":"Customer_123"}},"required":["platform_updated_at","platform_id"]},"customerSavedRequestData":{"type":"object","properties":{"customer":{"$ref":"#/components/schemas/customer"}},"required":["customer"]},"customerSavedRequestBody":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/customerSavedRequestData"}},"required":["data"]},"validationError":{"type":"object","properties":{"status_code":{"type":"number"},"errors":{"type":"array","items":{"type":"string"}}}},"runtimeErrorCustomer":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","description":"The code used to identify the error."},"message":{"type":"string","description":"A long description of the error."},"type":{"type":"string","description":"A short description of the error."}}}}}},"deletedCustomer":{"type":"object","properties":{"platform_id":{"description":"A unique identifier for the customer. Assigned by the platform.","type":"string","example":"Customer_123"},"platform_deleted_at":{"description":"The date (in [RFC3339 format](https://datatracker.ietf.org/doc/html/rfc3339)) that this customer was deleted on the platform. Assigned by the platform.","type":"string","format":"date-time","example":"2023-04-09T12:33:44"}},"required":["platform_id","platform_deleted_at"]},"customerDeletedRequestData":{"type":"object","properties":{"customer":{"$ref":"#/components/schemas/deletedCustomer"}},"required":["customer"]},"customerDeletedRequestBody":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/customerDeletedRequestData"}},"required":["data"]},"protobufAny":{"type":"object","properties":{"type_url":{"type":"string","description":"A URL/resource name that uniquely identifies the type of the serialized\\nprotocol buffer message. This string must contain at least\\none \\"/\\" character. The last segment of the URL\'s path must represent\\nthe fully qualified name of the type (as in\\n`path/google.protobuf.Duration`). The name should be in a canonical form\\n(e.g., leading \\".\\" is not accepted).\\n\\nIn practice, teams usually precompile into the binary all types that they\\nexpect it to use in the context of Any. However, for URLs which use the\\nscheme `http`, `https`, or no scheme, one can optionally set up a type\\nserver that maps type URLs to message definitions as follows:\\n\\n* If no scheme is provided, `https` is assumed.\\n* An HTTP GET on the URL must yield a [google.protobuf.Type][]\\n value in binary format, or produce an error.\\n* Applications are allowed to cache lookup results based on the\\n URL, or have them precompiled into a binary to avoid any\\n lookup. Therefore, binary compatibility needs to be preserved\\n on changes to types. (Use versioned type names to manage\\n breaking changes.)\\n\\nNote: this functionality is not currently available in the official\\nprotobuf release, and it is not used for type URLs beginning with\\ntype.googleapis.com.\\n\\nSchemes other than `http`, `https` (or the empty scheme) might be\\nused with implementation specific semantics."},"value":{"pattern":"^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$","type":"string","description":"Must be a valid serialized protocol buffer of the above specified type.","format":"byte"}},"description":"`Any` contains an arbitrary serialized protocol buffer message along with a\\nURL that describes the type of the serialized message.\\n\\nProtobuf library provides support to pack/unpack Any values in the form\\nof utility functions or additional generated methods of the Any type.\\n\\nExample 1: Pack and unpack a message in C++.\\n\\n Foo foo = ...;\\n Any any;\\n any.PackFrom(foo);\\n ...\\n if (any.UnpackTo(&foo)) {\\n ...\\n }\\n\\nExample 2: Pack and unpack a message in Java.\\n\\n Foo foo = ...;\\n Any any = Any.pack(foo);\\n ...\\n if (any.is(Foo.class)) {\\n foo = any.unpack(Foo.class);\\n }\\n\\n Example 3: Pack and unpack a message in Python.\\n\\n foo = Foo(...)\\n any = Any()\\n any.Pack(foo)\\n ...\\n if any.Is(Foo.DESCRIPTOR):\\n any.Unpack(foo)\\n ...\\n\\n Example 4: Pack and unpack a message in Go\\n\\n foo := &pb.Foo{...}\\n any, err := ptypes.MarshalAny(foo)\\n ...\\n foo := &pb.Foo{}\\n if err := ptypes.UnmarshalAny(any, foo); err != nil {\\n ...\\n }\\n\\nThe pack methods provided by protobuf library will by default use\\n\'type.googleapis.com/full.type.name\' as the type URL and the unpack\\nmethods only use the fully qualified type name after the last \'/\'\\nin the type URL, for example \\"foo.bar.com/x/y.z\\" will yield type\\nname \\"y.z\\".\\n\\n\\nJSON\\n====\\nThe JSON representation of an `Any` value uses the regular\\nrepresentation of the deserialized, embedded message, with an\\nadditional field `@type` which contains the type URL. Example:\\n\\n package google.profile;\\n message Person {\\n string first_name = 1;\\n string last_name = 2;\\n }\\n\\n {\\n \\"@type\\": \\"type.googleapis.com/google.profile.Person\\",\\n \\"firstName\\": ,\\n \\"lastName\\": \\n }\\n\\nIf the embedded message type is well-known and has a custom JSON\\nrepresentation, that representation will be embedded adding a field\\n`value` which holds the custom JSON in addition to the `@type`\\nfield. Example (for message [google.protobuf.Duration][]):\\n\\n {\\n \\"@type\\": \\"type.googleapis.com/google.protobuf.Duration\\",\\n \\"value\\": \\"1.212s\\"\\n }"},"runtimeError":{"type":"object","properties":{"error":{"type":"string","description":"The error name.","example":"Runtime error."},"code":{"type":"integer","format":"int32","description":"The error code.","example":500},"message":{"type":"string","description":"The error message.","example":"Request failed due to an internal server error"},"details":{"type":"array","description":"Any details associated with the error.","items":{"$ref":"#/components/schemas/protobufAny"}}}},"customersv2Label":{"type":"object","properties":{"id":{"type":"integer","format":"int64","description":"The identifier for the label.","example":1},"customer_id":{"type":"integer","format":"int64","description":"The identifier for the customer that the label applies to.","example":82435920147},"name":{"type":"string","description":"The name of the label.","example":"loyal_cust"},"created_at":{"type":"string","format":"date-time","description":"The date (in [RFC3339 format](https://datatracker.ietf.org/doc/html/rfc3339)) the label was created.","example":"2021-11-04T19:09:55Z"},"updated_at":{"type":"string","format":"date-time","description":"The date (in [RFC3339 format](https://datatracker.ietf.org/doc/html/rfc3339)) the label was updated. If the label was not updated, this value is the same as `created_at`.","nullable":true,"example":"2021-11-04T19:09:55Z"},"deleted_at":{"type":"string","format":"date-time","description":"The date (in [RFC3339 format](https://datatracker.ietf.org/doc/html/rfc3339)) the label was deleted. This value is `null` if the label was never deleted.","nullable":true,"example":null}}},"v2Group":{"type":"object","properties":{"id":{"type":"integer","format":"int64","description":"The identifier for the group.","example":1},"name":{"type":"string","description":"The name of the group.","example":"active_sub"},"description":{"type":"string","description":"The description of the group.","example":"The customer is a subscriber to a product on this store via Bold Subscriptions"},"shop_identifier":{"type":"string","description":"The unique identifier for the store. Retrieve this information by calling the [Get Shop Info](shops#tag/Shop/operation/GetShopInfo) endpoint.","example":"zp3oafdor9"},"platform_id":{"type":"string","description":"The platform-generated identifier for the group.","example":"group_1_plat"},"created_at":{"type":"string","format":"date-time","description":"The date (in [RFC3339 format](https://datatracker.ietf.org/doc/html/rfc3339)) the group was created.","example":"2021-08-01T20:11:31Z"},"updated_at":{"type":"string","format":"date-time","nullable":true,"description":"The date (in [RFC3339 format](https://datatracker.ietf.org/doc/html/rfc3339)) the group was updated. If the group was not updated, this value is the same as `created_at`."},"deleted_at":{"type":"string","format":"date-time","nullable":true,"description":"The date (in [RFC3339 format](https://datatracker.ietf.org/doc/html/rfc3339)) the group was deleted. This value is `null` if the group was not deleted.","example":null}}},"v2Address":{"type":"object","properties":{"city":{"type":"string","description":"The city name.","example":"Winnipeg"},"province":{"type":"string","description":"The province name.","example":"Manitoba"},"province_code":{"type":"string","description":"The province code (in [ISO-3166 format](https://www.iso.org/iso-3166-country-codes.html)).","example":"MB"},"country":{"type":"string","description":"The country name.","example":"Canada"},"created_at":{"type":"string","format":"date-time","description":"The date (in [RFC3339 format](https://datatracker.ietf.org/doc/html/rfc3339)) the address was created.","example":"2021-11-04T19:09:52Z"},"zip":{"type":"string","description":"The zip/postal code of the address.","example":"R3L0L6"},"address_type":{"type":"string","description":"The type of address (i.e., residential, commercial).","example":"residential"},"platform_customer_id":{"type":"string","description":"The platform-defined identifier for the customer.","example":"1"},"deleted_at":{"type":"string","format":"date-time","description":"The date (in [RFC3339 format](https://datatracker.ietf.org/doc/html/rfc3339)) the address was deleted. This value is `null` if the address was not deleted.","nullable":true,"example":null},"address_use":{"type":"string","description":"The type of address.","enum":["shipping","billing"],"example":"shipping"},"company":{"type":"string","description":"The company name (if applicable).","example":"Acme Inc."},"street_2":{"type":"string","description":"Any additional address details (if applicable).","example":"Suite 200"},"platform_id":{"type":"string","description":"A platform-generated identifier for the address.","example":"address1234"},"shop_identifier":{"type":"string","description":"The unique identifier for the store. Retrieve this information by calling the [Get Shop Info](shops#tag/Shop/operation/GetShopInfo) endpoint.","example":"zp3oafdor9"},"platform_type":{"type":"string","description":"The ecommerce platform associated with the store.","example":"bigcommerce"},"first_name":{"type":"string","description":"The customer\'s first name.","example":"John"},"address_source":{"type":"string","description":"The location the address was created.","enum":["platform","bold"],"example":"platform"},"last_name":{"type":"string","description":"The customer\'s last name.","example":"Doe"},"updated_at":{"type":"string","format":"date-time","description":"The date (in [RFC3339 format](https://datatracker.ietf.org/doc/html/rfc3339)) the address was updated. If this value was not updated, it is set to the same value as `created_at`.","example":"2021-11-04T19:09:52Z"},"phone":{"type":"string","description":"The customer\'s phone number.","example":"2041438851"},"is_default":{"type":"boolean","format":"boolean","description":"Indicates whether the address is set as the customer\'s default.","example":true},"bold_customer_id":{"type":"integer","format":"int64","description":"The unique, Bold-generated identifier for the customer.","example":1423294},"country_iso2":{"type":"string","description":"The country code, in [ISO 3166](https://www.iso.org/iso-3166-country-codes.html) format.","example":"CA"},"street_1":{"type":"string","description":"The street address.","example":"50 Fultz Blvd"},"id":{"type":"integer","format":"int64","description":"The unique, Bold-generated identifier for the address.","example":90235719}}},"v2Customer":{"type":"object","properties":{"tags":{"type":"string","description":"A comma-separated list of tags that describe the customer.","example":"member, 2021"},"deleted_at":{"type":"string","format":"date-time","description":"The date (in [RFC3339 format](https://datatracker.ietf.org/doc/html/rfc3339)) the customer was deleted. This value is `null` if the customer was not deleted.","nullable":true,"example":null},"shop_identifier":{"type":"string","description":"The unique identifier for the store. Retrieve this information by calling the [Get Shop Info](shops#tag/Shop/operation/GetShopInfo) endpoint.","example":"zp3oafdor9"},"platform_created_at":{"type":"string","format":"date-time","description":"The date (in [RFC3339 format](https://datatracker.ietf.org/doc/html/rfc3339)) the customer was created on the platform.","example":"2021-11-04T19:09:52Z"},"id":{"type":"integer","format":"int64","description":"The unique, Bold-generated identifier for the customer.","example":142329453},"platform_type":{"type":"string","description":"The ecommerce platform associated with the store.","example":"bigcommerce"},"last_name":{"type":"string","description":"The customer\'s last name.","example":"Doe"},"first_name":{"type":"string","description":"The customer\'s first name.","example":"John"},"labels":{"type":"array","description":"An array of customer labels.","items":{"$ref":"#/components/schemas/customersv2Label"}},"groups":{"type":"array","description":"An array of groups that the customer belongs to. Groups denote relationships between customer data. Supported for BigCommerce and Shopify only.","items":{"$ref":"#/components/schemas/v2Group"}},"updated_at":{"type":"string","format":"date-time","nullable":true,"description":"The date (in [RFC3339 format](https://datatracker.ietf.org/doc/html/rfc3339)) the customer was updated. If the customer was not updated, this value is the same as `platform_created_at`.","example":"2021-11-04T19:09:52Z"},"phone":{"type":"string","description":"The customer\'s phone number.","example":"2041438851"},"platform_id":{"type":"string","description":"The platform-defined identifier for the customer.","example":"1"},"addresses":{"type":"array","description":"The list of addresses associated with the customer, limited to the first 50 found.","items":{"$ref":"#/components/schemas/v2Address"}},"created_at":{"type":"string","format":"date-time","description":"The date (in [RFC3339 format](https://datatracker.ietf.org/doc/html/rfc3339)) the customer was created.","example":"2021-11-04T19:09:52Z"},"email":{"type":"string","description":"The customer\'s email.","example":"john.doe@example.com"},"default_address":{"$ref":"#/components/schemas/v2Address"}}},"v2CustomerByXIDResponse":{"type":"object","properties":{"customer":{"$ref":"#/components/schemas/v2Customer"}}},"v2PaginationResponse":{"type":"object","description":"The details about the pagination of the response.","properties":{"total":{"type":"integer","description":"The total number of results available.","format":"int32","example":143},"count":{"type":"integer","description":"The number of results returned.","format":"int32","example":143},"per_page":{"type":"integer","description":"The maximum number of results per page.","format":"int32","example":50},"current_page":{"type":"integer","description":"The current page index.","format":"int32","example":2},"total_pages":{"type":"integer","description":"The total number of pages available.","format":"int32","example":3},"next_url":{"type":"string","description":"The cursor to fetch next page of results. The cursor must include the full URL necessary to retrieve the next page, including query parameters.","example":"https://api.boldcommerce.com/customers/v2/shops/zp3oafdor9/customers?page=3"},"previous_url":{"type":"string","description":"The URL to fetch previous page of results. The cursor must include the full URL necessary to retrieve the previous page, including query parameters.","example":"https://api.boldcommerce.com/customers/v2/shops/zp3oafdor9/customers?page=1"}}},"v2CustomerListResponse":{"type":"object","properties":{"pagination":{"$ref":"#/components/schemas/v2PaginationResponse"},"customers":{"type":"array","items":{"$ref":"#/components/schemas/v2Customer"}}}},"v2CustomerJWTValidateResponse":{"type":"object"},"v2AddressGetResponse":{"type":"object","properties":{"address":{"$ref":"#/components/schemas/v2Address"}}},"v2AddressListResponse":{"type":"object","properties":{"addresses":{"type":"array","items":{"$ref":"#/components/schemas/v2Address"}}}}},"examples":{"internalError":{"value":{"code":500,"message":"Request failed due to an internal server error.","type":"server.internal_error"}}}}}},"plugin-redoc-2":{"url":"/api/checkout-backend.openapi.yaml","themeId":"theme-redoc","isSpecFile":true,"spec":{"openapi":"3.0.0","info":{"title":"Checkout Backend","version":"2.0","description":"The Checkout Backend API is used to initialize an order through authenticated requests. This includes the ability to create and manipulate orders in Checkout.\\n\\nRefer to the changelog for the latest updates to this API.","termsOfService":"https://boldcommerce.com/terms-of-service","contact":{"name":"Contact Us","url":"https://developer-dashboard.boldcommerce.com/default/contactus"}},"servers":[{"url":"https://api.boldcommerce.com"}],"security":[{"OAuthToken":[]},{"APIAccessToken":[]}],"tags":[{"name":"Customers","description":"A child of the Order resource. Contains information about authenticated customers on your store, including name, email, and saved addresses. Use these endpoints to add or remove an authenticated customer to an order."},{"name":"Line Items","description":"A child of the Order resource. Contains information about the product and the taxes, fees, and discounts associated with it. Use these endpoints to update information about one or multiple line items."},{"name":"Orders","description":"Contains information about a single order, including the JWT, order ID, and application state. Use these endpoints to initialize, refresh, or cancel an order."},{"name":"Payments","description":"A child of the Order resource. Contains information about the payments on an order. Use these endpoints to capture partial or full payments."},{"name":"Refunds","description":"Contains information about any refunds applied to the order. Use these endpoints to apply partial or full refunds."}],"externalDocs":{"description":"For more information about Checkout, refer to the Overview.","url":"https://developer.boldcommerce.com/guides/checkout"},"paths":{"/checkout/orders/{shop_identifier}/init":{"parameters":[{"$ref":"#/components/parameters/shop_identifier"}],"post":{"summary":"Initialize Order","operationId":"InitializeOrder","tags":["Orders"],"description":"Initializes an order and retrieves a JWT. You must use the JWT to authorize all requests to the [Checkout Frontend API](checkout).\\n\\nThe request body of this endpoint is flexible \u2014 you can use dynamic data from the platform to provide information about the cart and customer, or leave it blank and populate the order later.\\n\\n**Note:** You must call this endpoint from your backend application. This endpoint returns information that is not safe to share with the frontend application.","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"cart_id":{"$ref":"#/components/schemas/CartID"},"access_token":{"$ref":"#/components/schemas/AccessToken"},"cart_items":{"description":"An array of items to add to the cart. Note that the \\"Generic Cart Item\\" type is only supported by BigCommerce, commercetools, and Shopify.","type":"array","items":{"anyOf":[{"$ref":"#/components/schemas/GenericCartItem"},{"$ref":"#/components/schemas/SKUCartItem"},{"$ref":"#/components/schemas/VariantIDCartItem"}]}},"customer":{"$ref":"#/components/schemas/Customer"},"order_meta_data":{"$ref":"#/components/schemas/OrderMetaData"},"resumable_link":{"$ref":"#/components/schemas/ResumableLink"},"flow_id":{"$ref":"#/components/schemas/FlowId"},"api_session_id":{"$ref":"#/components/schemas/ApiSessionId"}}},"examples":{"Cart Token":{"$ref":"#/components/examples/cart_token"},"Generic Cart":{"$ref":"#/components/examples/generic_cart"},"Gift Card Cart":{"$ref":"#/components/examples/gift_card_cart"},"SKU Cart":{"$ref":"#/components/examples/sku_cart"},"Variant ID Cart":{"$ref":"#/components/examples/variant_id_cart"},"Authenticated Customer":{"$ref":"#/components/examples/authenticated_customer"}}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"initial_data":{"$ref":"#/components/schemas/InitialData"},"application_state":{"$ref":"#/components/schemas/ApplicationState"},"jwt_token":{"$ref":"#/components/schemas/JWTToken"},"public_order_id":{"$ref":"#/components/schemas/PublicOrderId"},"cart_customer_id":{"type":"string","nullable":true,"description":"The platform ID of an authenticated customer. This value is populated only if you provide a `cart_id` in the Initialize Order request and the customer who created the cart is logged in.\\n\\nNote: This property does not associate the customer with the order. You must still add the customer to the order using the [Create Authenticated Customer](orders#operation/CreateAuthenticatedCustomer) endpoint.","example":"100000009"}}}}}}}}}}},"/checkout/orders/{shop_identifier}/resume":{"parameters":[{"$ref":"#/components/parameters/shop_identifier"}],"post":{"summary":"Resume Order","operationId":"ResumeOrder","tags":["Orders"],"description":"Use this endpoint to resume an existing order, such as one that was previously abandoned.\\n\\nYou can also use this endpoint can also be used to generate a new JWT for an order. Each JWT expires after 60 minutes.","requestBody":{"content":{"application/json":{"schema":{"properties":{"public_order_id":{"$ref":"#/components/schemas/PublicOrderId"}}}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"jwt_token":{"$ref":"#/components/schemas/JWTToken"},"initial_data":{"$ref":"#/components/schemas/InitialData"},"application_state":{"$ref":"#/components/schemas/ApplicationState"},"public_order_id":{"$ref":"#/components/schemas/PublicOrderId"}}}}}}}},"422":{"description":"Unprocessable Entity","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"examples":{"example-1":{"value":{"message":"The public order id field is required.","type":"authorization","field":"public_order_id","severity":"validation","sub_type":""}}}}}}}}},"/checkout/orders/{shop_identifier}/create":{"parameters":[{"$ref":"#/components/parameters/shop_identifier"}],"post":{"summary":"Create Order","operationId":"CreateOrder","tags":["Orders"],"description":"Use this endpoint to create and process a full order without additional API interaction. You can also use this endpoint to create a portion of an order, to be completed at a later time.\\n\\nFor more information about using this endpoint, refer to [Programmatically Create an Order](/guides/checkout/create-order).","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"idempotency_key":{"type":"string","description":"A unique identifier for this transaction. If the API receives multiple requests with the same key, it always picks up where it left off, and no duplicate orders are created."},"cart_id":{"$ref":"#/components/schemas/CartID"},"access_token":{"$ref":"#/components/schemas/AccessToken"},"cart_items":{"description":"Array of items to add to the cart. If using in conjunction with `cart_id`, these items will be added to the existing cart alongside existing items in the cart.","type":"array","items":{"allOf":[{"anyOf":[{"$ref":"#/components/schemas/GenericCartItem"},{"$ref":"#/components/schemas/SKUCartItem"},{"$ref":"#/components/schemas/VariantIDCartItem"}]},{"type":"object","properties":{"fees":{"type":"array","minItems":0,"items":{"type":"object","properties":{"description":{"type":"string","description":"A human-readable description of the fee that can be displayed in a user interface."},"type":{"type":"string","enum":["fixed","percentage"],"description":"The type of the fee applied to the line item."},"value":{"type":"integer","description":"The fee amount to apply to the line item.\\n* For `\\"fixed\\"` fees, represent the value in base currency units, using [ISO-4217](https://www.iso.org/iso-4217-currency-codes.html) standards.\\n* For `\\"percentage\\"` fees, represent the value as a percentage of the line item amount between 0 and 100.\\n"},"taxable":{"type":"boolean","description":"Indicates whether to include the fee should be included in the line item total when calculating taxes."},"taxes":{"type":"array","description":"Pre-calculated taxes to be applied to the line item fee.","minItems":0,"items":{"$ref":"#/components/schemas/Tax"}}},"required":["description","type","value"]}},"taxes":{"type":"array","description":"Pre-calculated taxes to be applied to the line item.","minItems":0,"items":{"$ref":"#/components/schemas/Tax"}}}}]}},"customer":{"$ref":"#/components/schemas/Customer"},"shipping_address":{"$ref":"#/components/schemas/Address"},"billing_address":{"$ref":"#/components/schemas/Address"},"shipping_line":{"type":"object","description":"The order\'s shipping information.","properties":{"rate_name":{"type":"string","description":"A human-readable description of the shipping line that can be displayed in a user interface."},"cost":{"type":"number","minimum":0,"description":"Cost of the shipping line in base currency units, using [ISO-4217](https://www.iso.org/iso-4217-currency-codes.html) standards."},"taxes":{"type":"array","minItems":0,"description":"Pre-calculated taxes to be applied to the shipping cost.","items":{"$ref":"#/components/schemas/Tax"}}},"required":["rate_name","cost"]},"discounts":{"$ref":"#/components/schemas/Discounts"},"fees":{"type":"array","description":"The fees applied to order. Note that order-level fees are only supported by Shopify and custom platforms.","items":{"type":"object","properties":{"id":{"type":"string","description":"A unique identifier to the fee."},"description":{"type":"string","description":"A human-readable description of the fee that can be displayed in a user interface."},"type":{"type":"string","enum":["fixed","percentage"],"description":"The type of the fee applied to the order."},"value":{"type":"integer","description":"The fee amount to apply to the order.\\n* For `\\"fixed\\"` fees, represent the value in base currency units, using [ISO-4217](https://www.iso.org/iso-4217-currency-codes.html) standards.\\n* For `\\"percentage\\"` fees, represent the value as a percentage of the order subtotal between 0 and 100.\\n"}},"required":["id","description","type","value"]}},"payments":{"type":"array","description":"An array of payments to apply to the order. Bold first processes payments with amounts, followed by those without amounts. Within these groups, payments are applied in the order they are received, and Bold stops processing payments when the order total is reached.","items":{"allOf":[{"anyOf":[{"title":"Customer default payment method","type":"object","properties":{"public_customer_id":{"type":"string","description":"Public identifier of the customer. The customer\'s default payment method is used for payment."}},"required":["public_customer_id"]},{"title":"Payment method","type":"object","properties":{"public_payment_method_id":{"type":"string","description":"Public identifier of the payment method."}},"required":["public_payment_method_id"]}]},{"type":"object","properties":{"amount":{"type":"number","description":"Amount to charge on a particular payment, up to the order total, represented in base currency units, using [ISO-4217](https://www.iso.org/iso-4217-currency-codes.html) standards. Defaults to order total."}}}]}},"currency":{"type":"string","description":"Currency code for the order, using [ISO-4217](https://www.iso.org/iso-4217-currency-codes.html) standards. If none is given, the store default will be used."},"order_meta_data":{"$ref":"#/components/schemas/OrderMetaData"},"commands":{"type":"object","description":"A list of commands for Bold Checkout to perform on the created order, with integer keys. Bold executes these commands in sorted order based on keys.","additionalProperties":{"type":"string","enum":["calculate_shipping","calculate_tax_rates","authorize_payments","process_order","send_to_platform","charge_payments"]}},"flow_id":{"$ref":"#/components/schemas/FlowId"},"api_session_id":{"$ref":"#/components/schemas/ApiSessionId"}},"required":["idempotency_key"]},"examples":{"Create and Process Order using Bold Checkout Calculations and Item SKUs":{"value":{"cart_items":[{"sku":"KLS_472945","quantity":2,"line_item_key":"db3b1963-6ddd-4115-9f45-64c7edb3867d","line_item_properties":{"colour":"red","size":"small"}}],"customer":{"first_name":"Robert","last_name":"Walsh","email_address":"rwalsh24@example.com","accepts_marketing":false,"public_id":"6xID7o9hrxQ7bkVIKvCxXPD7Cf3P4BP141wplqPTa3CYYwEqM5X9w7JzKWulQe4p"},"shipping_address":{"first_name":"Robert","last_name":"Walsh","address_line_1":"2652 John Daniel Drive","city":"Dexter","province":"Missouri","province_code":"MO","country":"United States of America","country_code":"US","postal_code":"63841"},"billing_address":{"first_name":"Robert","last_name":"Walsh","address_line_1":"2652 John Daniel Drive","city":"Dexter","province":"Missouri","province_code":"MO","country":"United States of America","country_code":"US","postal_code":"63841"},"discounts":[{"discount_code":"SPRINGSALE2022_Q8RT4"}],"payments":[{"public_payment_method_id":"ftziZRlloXJhR8emShyZePgaZxFTp9TN6Ai0tVWOB223g9qCGQQFA27ccW2fx72U"}],"currency":"USD","idempotency_key":"2b268b6f-b3c0-4efb-9c43-1aa59d535182","commands":{"0":"calculate_shipping","1":"calculate_tax_rates","2":"authorize_payments","3":"process_order","4":"send_to_platform","5":"charge_payments"}}},"Create and Process Order with Precalculated Taxes, Fees, and Shipping":{"value":{"cart_items":[{"id":9563957,"quantity":1,"title":"AAA Batteries, 12-pack","weight":200,"requires_shipping":true,"price":1657,"line_item_key":"eebfc1ec-7736-4180-9d8d-28f4a5fcd841","line_item_properties":{"colour":"red","size":"small"},"fees":[{"description":"Eco-fee","type":"fixed","value":24,"taxes":[{"name":"GST","rate":5},{"name":"PST","rate":7}]}],"taxes":[{"name":"GST","rate":5},{"name":"PST","rate":7}]}],"customer":{"first_name":"Alicia","last_name":"Hobbes","email_address":"alicia.hobbes@example.com","accepts_marketing":false,"public_id":"t8xFvAFG4cAuv3MxsTR66QFKBdOM3dxYJxvDd9EmjVBZJ0opN8Jomg0VEA3zUltc"},"shipping_address":{"first_name":"Alicia","last_name":"Hobbes","address_line_1":"4139 Nelson Street","city":"Ottawa","province":"Ontario","province_code":"ON","country":"Canada","country_code":"CA","postal_code":"K1N7W4"},"billing_address":{"first_name":"Alicia","last_name":"Hobbes","address_line_1":"2070 Bank Street","address_line_2":"PO Box 153","city":"Ottawa","province":"Ontario","province_code":"ON","country":"Canada","country_code":"CA","postal_code":"K2P2N2"},"shipping_line":{"rate_name":"Express Ground","cost":2550,"taxes":[{"name":"GST","rate":5},{"name":"PST","rate":7}]},"discounts":[{"discount_code":"TENPERCENTOFF"}],"fees":[{"id":"VEA3zUltc","description":"Order-fee","type":"fixed","value":24}],"payments":[{"public_payment_method_id":"ftziZRlloXJhR8emShyZePgaZxFTp9TN6Ai0tVWOB223g9qCGQQFA27ccW2fx72U"}],"currency":"CAD","idempotency_key":"36f6c1c1-9e93-4eb9-be06-bcfee5fd7b44","commands":{"0":"authorize_payments","1":"process_order","2":"send_to_platform","3":"charge_payments"}}},"Create draft order with Platform Variant IDs":{"value":{"cart_items":[{"platform_id":993746,"quantity":1,"line_item_key":"10f0be4b-9ffb-4a75-bfe2-6486a0abd793","line_item_properties":{"colour":"red","size":"small"}}],"customer":{"email_address":"shopaholic135@example.com"},"shipping_address":{"first_name":"Charles","last_name":"Barker","address_line_1":"1 Water Street","city":"Redwood Meadows","province":"Alberta","province_code":"AB","country":"Canada","country_code":"CA","postal_code":"T3Z3J2"},"billing_address":{"first_name":"Charles","last_name":"Barker","address_line_1":"1 Water Street","city":"Redwood Meadows","province":"Alberta","province_code":"AB","country":"Canada","country_code":"CA","postal_code":"T3Z3J2"},"idempotency_key":"ef0cd190-c439-4eb7-9e6d-8d5b4090302e"}}}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"application_state":{"$ref":"#/components/schemas/ApplicationState"},"public_order_id":{"type":"string","example":"o10KL4Crlb8Lh4zg4t5kImS6CFvdFI1t5Aybxlor1B52GDGAZvn6X85wy6oDfWZP"}}}}}}}},"422":{"description":"Unprocessable Entity","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","minItems":0,"items":{"$ref":"#/components/schemas/ErrorV2"}}}}}}}}}},"/checkout/orders/{shop_identifier}/{public_order_id}/customer":{"parameters":[{"$ref":"#/components/parameters/shop_identifier"},{"$ref":"#/components/parameters/public_order_id"}],"delete":{"summary":"Delete Customer","operationId":"DeleteCustomer","tags":["Customers"],"description":"Deletes the customer from the order.","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"application_state":{"$ref":"#/components/schemas/ApplicationState"}}}}},"examples":{"Deleted Customer":{"$ref":"#/components/examples/NoCustomer"}}}}},"422":{"description":"Unprocessable Entity","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnprocessableEntity"},"examples":{"example-1":{"value":{"message":"The public_order_id field is required.","type":"order","field":"public_order_id","severity":"validation","sub_type":"customer"}}}}}}}}},"/checkout/orders/{shop_identifier}/{public_order_id}/customer/authenticated":{"parameters":[{"$ref":"#/components/parameters/shop_identifier"},{"$ref":"#/components/parameters/public_order_id"}],"post":{"summary":"Create Authenticated Customer","operationId":"CreateAuthenticatedCustomer","tags":["Customers"],"description":"Creates a new authenticated customer.\\n\\nYou cannot create a customer when a customer already exists on the order.\\n\\nIf you wish to add a new authenticated customer to an order, you must first delete the existing customer using the [Delete Customer](checkout#operation/DeleteCustomer) endpoint.","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AuthenticatedCustomerBody"}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"customer":{"$ref":"#/components/schemas/Customer"},"application_state":{"$ref":"#/components/schemas/ApplicationState"}}}}}}}},"422":{"description":"Unprocessable Entity","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnprocessableEntity"},"examples":{"example-1":{"value":{"message":"The email address field is required.","type":"order","field":"email_address","severity":"validation","sub_type":"customer"}}}}}}}}},"/checkout/orders/{shop_identifier}/{public_order_id}/cancel":{"parameters":[{"$ref":"#/components/parameters/shop_identifier"},{"$ref":"#/components/parameters/public_order_id"}],"post":{"summary":"Cancel Order","operationId":"CancelOrder","tags":["Orders"],"description":"Cancels an order, voiding any held authorizations. This endpoint fails if the order is already fulfilled or any payments were captured.","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"reason":{"description":"An optional order cancellation reason.","type":"string","example":"Duplicate order."}}}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"application_state":{"$ref":"#/components/schemas/ApplicationState"}}}}}}}},"422":{"description":"Unprocessable Entity","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorV2"},"examples":{"Payment already captured":{"value":{"code":"02-92","type":"order.order_in_non_cancellable_state","message":"Cannot cancel order with captured payments."}},"Order already fulfilled":{"value":{"code":"02-92","type":"order.order_in_non_cancellable_state","message":"Cannot cancel order, already fulfilled."}}}}}}}}},"/checkout/orders/{shop_identifier}/{public_order_id}/payments/capture":{"parameters":[{"$ref":"#/components/parameters/shop_identifier"},{"$ref":"#/components/parameters/public_order_id"}],"post":{"summary":"Capture Payment for Arbitrary Amount","operationId":"CapturePaymentForArbitraryAmount","description":"Captures a payment for the amount specified against the order total (shipping, taxes, etc., included).","tags":["Payments"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CapturePaymentResponse"},"example":{"data":{"order_total":1200,"amount_remaining":600,"paid_total":600,"captured_held_total":0,"transactions":[{"gateway":"Stripe Default Name","gateway_id":"bFH0RUdnWPFPRxmWfK6B1yXi61Hh0svIBTrk1vtGoI1zPYVXntIqMX82pqdrSYhi","amount":600,"transaction_id":"ch_1GvDW4JhIKSKpq8w9SoshRef","reference_transaction_id":null,"response_code":"","status":"success"}]}}}}},"202":{"description":"Order has been accepted but payments are held for capture by the payment gateway. Will complete processing order once payment gateway has captured the payment.","x-summary":"Order Accepted, Payment Held By Gateway","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorV2"},"examples":{"HeldForReview":{"value":{"code":"02-21","type":"checkout.order_charge_failed","message":"Payment held for review for order 1444","details":{}}}}}}},"422":{"description":"Unprocessable Entity","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorV2"},"examples":{"NotEnoughFunds":{"value":{"code":"02-50","type":"checkout.api_validation_failed","message":"Not enough funds left to capture requested amount","details":{"order_total":2500,"total_paid":1121,"amount_left_to_capture":1379,"attempted_capture_amount":500000}}},"NoAuthorizeTransaction":{"value":{"code":"02-44","type":"checkout.api_payment_capture_failed","message":"No authorize transaction found to capture","details":{"order_total":2500,"total_paid":2000,"amount_remaining":500}}},"TransactionFailed":{"value":{"code":"02-44","type":"checkout.api_payment_capture_failed","message":"API token mismatch:{\\"code\\":0,\\"error\\":\\"processor_declined\\",\\"field\\":\\"cc_number\\",\\"message\\":\\"API token mismatch\\",\\"service\\":\\"credit_card.moneris\\",\\"severity\\":\\"critical\\",\\"side\\":\\"cashier\\",\\"type\\":\\"payment_gateway\\",\\"details\\":\\"\\"}","details":{"order_total":2500,"total_paid":500,"amount_remaining":2000,"gateway":"Moneris","attempted_capture_amount":500,"reference_transaction_id":""}}}}}}}},"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CapturePartialPaymentRequest"},"examples":{"FullAmountProvided":{"value":{"amount":1200,"reauth":true,"idempotent_key":"2b268b6f-b3c0-4efb-9c43-1aa59d535182","capture_data":{"data":{"external_id":"legacy-id-135798642"}}}},"PartialAmountProvided":{"value":{"amount":600,"reauth":true,"idempotent_key":"2b268b6f-b3c0-4efb-9c43-1aa59d535182","capture_data":{"data":{"external_id":"legacy-id-135798642"}}}}}}}}}},"/checkout/orders/{shop_identifier}/{public_order_id}/payments/sale/{payment_id}":{"parameters":[{"$ref":"#/components/parameters/shop_identifier"},{"$ref":"#/components/parameters/public_order_id"},{"$ref":"#/components/parameters/payment_id"}],"post":{"summary":"Capture Specific Payment","operationId":"CaptureSpecificPayment","description":"Manually authorizes and charges the amount specified to a payment on the order. The payment must have an `awaitingPreAuth` status. The payment is applied against the order total (including shipping, taxes, etc.).\\n\\nThis endpoint enables you to delay the payment capture process. Normally, Bold Checkout adds payments to the order with a `preAuthed` status, indicating they have already been authorized for the given amount. When Bold is set up to only verify the payments, each payment is added to the order with a `awaitingPreAuth` status.\\n\\n>> **Notes:**\\n>> - Reach out to the [Support Team](https://support.boldcommerce.com/hc/en-us/requests/new?ticket_form_id=1900000280347) with a request to enable \\"only verify payments\\" functionality.\\n>> - Supported for Braintree and [External Payment Gateways](/guides/checkout/checkout-epg-guide) only.","tags":["Payments"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CapturePaymentResponse"},"example":{"data":{"order_total":1200,"amount_remaining":600,"paid_total":600,"captured_held_total":0,"transactions":[{"gateway":"Stripe Default Name","gateway_id":"bFH0RUdnWPFPRxmWfK6B1yXi61Hh0svIBTrk1vtGoI1zPYVXntIqMX82pqdrSYhi","amount":600,"transaction_id":"ch_1GvDW4JhIKSKpq8w9SoshRef","reference_transaction_id":null,"response_code":"","status":"success"}]}}}}},"202":{"description":"The order was accepted, but payments are held for capture by the payment gateway. Bold completes processing the order once the payment gateway captures the payment.","x-summary":"Order Accepted, Payment Held By Gateway","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorV2"},"examples":{"HeldForReview":{"value":{"code":"02-21","type":"checkout.order_charge_failed","message":"Payment held for review for order 1444","details":{}}}}}}},"422":{"description":"Unprocessable Entity","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorV2"},"examples":{"NotEnoughFunds":{"value":{"code":"02-50","type":"checkout.api_validation_failed","message":"Not enough funds left to capture requested amount","details":{"order_total":2500,"total_paid":1121,"amount_left_to_capture":1379,"attempted_capture_amount":500000}}},"NoAuthorizeTransaction":{"value":{"code":"02-44","type":"checkout.api_payment_capture_failed","message":"No authorize transaction found to capture","details":{"order_total":2500,"total_paid":2000,"amount_remaining":500}}},"TransactionFailed":{"value":{"code":"02-44","type":"checkout.api_payment_capture_failed","message":"API token mismatch:{\\"code\\":0,\\"error\\":\\"processor_declined\\",\\"field\\":\\"cc_number\\",\\"message\\":\\"API token mismatch\\",\\"service\\":\\"credit_card.moneris\\",\\"severity\\":\\"critical\\",\\"side\\":\\"cashier\\",\\"type\\":\\"payment_gateway\\",\\"details\\":\\"\\"}","details":{"order_total":2500,"total_paid":500,"amount_remaining":2000,"gateway":"Moneris","attempted_capture_amount":500,"reference_transaction_id":""}}}}}}}},"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CapturePartialPaymentRequest"},"examples":{"FullAmountProvided":{"value":{"amount":1200,"reauth":true,"idempotent_key":"2b268b6f-b3c0-4efb-9c43-1aa59d535182","capture_data":{"data":{"external_id":"legacy-id-135798642"}}}},"PartialAmountProvided":{"value":{"amount":600,"reauth":true,"idempotent_key":"2b268b6f-b3c0-4efb-9c43-1aa59d535182","capture_data":{"data":{"external_id":"legacy-id-135798642"}}}}}}}}}},"/checkout/orders/{shop_identifier}/{public_order_id}/payments/capture/full":{"parameters":[{"$ref":"#/components/parameters/shop_identifier"},{"$ref":"#/components/parameters/public_order_id"}],"post":{"summary":"Capture Payment for Full Order Amount","operationId":"CapturePaymentForFullOrderAmount","tags":["Payments"],"description":"Captures a payment for the full order total amount (including shipping, taxes, etc).","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CapturePaymentResponse"},"example":{"data":{"order_total":1200,"amount_remaining":600,"paid_total":600,"captured_held_total":0,"transactions":[{"gateway":"Stripe Default Name","gateway_id":"bFH0RUdnWPFPRxmWfK6B1yXi61Hh0svIBTrk1vtGoI1zPYVXntIqMX82pqdrSYhi","amount":600,"transaction_id":"ch_1GvDW4JhIKSKpq8w9SoshRef","reference_transaction_id":null,"response_code":"","status":"success"}]}}}}},"202":{"description":"The Order has been accepted, but the payment gateway is holding the payments for capture. The request will complete when the payment gateway captures the payments.","x-summary":"Order Accepted, Payment Held By Gateway","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorV2"},"examples":{"HeldForReview":{"value":{"code":"02-21","type":"checkout.order_charge_failed","message":"Payment held for review for order 1444","details":{}}}}}}},"422":{"description":"Unprocessable Entity","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorV2"},"examples":{"NotEnoughFunds":{"value":{"code":"02-50","type":"checkout.api_validation_failed","message":"No funds left to capture on this order","details":{"order_total":2500,"total_paid":2500,"amount_left_to_capture":0}}},"NoAuthorizeTransaction":{"value":{"code":"02-44","type":"checkout.api_payment_capture_failed","message":"No authorize transaction found to capture","details":{"order_total":2500,"total_paid":0,"amount_remaining":2500}}},"TransactionFailed":{"value":{"code":"02-44","type":"checkout.api_payment_capture_failed","message":"API token mismatch:{\\"code\\":0,\\"error\\":\\"processor_declined\\",\\"field\\":\\"cc_number\\",\\"message\\":\\"API token mismatch\\",\\"service\\":\\"credit_card.moneris\\",\\"severity\\":\\"critical\\",\\"side\\":\\"cashier\\",\\"type\\":\\"payment_gateway\\",\\"details\\":\\"\\"}","details":{"order_total":2500,"total_paid":0,"amount_remaining":2500,"gateway":"Moneris","attempted_capture_amount":2500,"reference_transaction_id":""}}}}}}}},"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CapturePaymentRequest"},"examples":{"AmountProvided":{"value":{"reauth":true,"idempotent_key":"2b268b6f-b3c0-4efb-9c43-1aa59d535182","capture_data":{"data":{"external_id":"legacy-id-135798642"}}}}}}}}}},"/checkout/orders/{shop_identifier}/{public_order_id}/payments/auth/full":{"parameters":[{"$ref":"#/components/parameters/shop_identifier"},{"$ref":"#/components/parameters/public_order_id"}],"post":{"summary":"Authorize Payments","operationId":"AuthorizePayments","tags":["Payments"],"description":"Authorizes all payments on the order. Payments must be present on the order before calling this endpoint. When this endpoint is called, Bold Checkout calls the appropriate payment gateways to authorize all payments on the order.\\n\\nIf one payment fails authorization, Bold refunds or voids all payments on the order.","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"total":{"description":"The total amount authorized, represented in base currency units, using [ISO-4217](https://www.iso.org/iso-4217-currency-codes.html) standards.","type":"number","example":1000},"transactions":{"type":"array","items":{"$ref":"#/components/schemas/AuthTransaction"}}}}}}}}},"422":{"description":"Unprocessable Entity","content":{"application/json":{"schema":{"oneOf":[{"$ref":"#/components/schemas/ErrorV2"},{"$ref":"#/components/schemas/AuthorizationFailure"}]},"examples":{"NotEnoughFunds":{"value":{"code":"02-43","type":"payments.insufficient_payments_for_order_balance","message":"There are insufficient payments on the order to cover the order total","details":{}}},"AuthorizationFailure":{"value":{"code":"02-43","type":"payments.payment_authorization_failure","message":"payments.payment_authorization_failure","transactions":[{"gateway":"Stripe Default Name","payment_id":123,"amount":600,"transaction_id":"ch_1GvDW4JhIKSKpq8w9SoshRef","currency":"USD","step":"FAILED","status":"failed","tender_type":"credit_card","tender_details":{"brand":"Visa","last_four":"1881","bin":"401288","expiration":"12/2025"},"gateway_response_data":[]}]}}}}}}}}},"/checkout/orders/{shop_identifier}/{public_order_id}/refunds":{"parameters":[{"$ref":"#/components/parameters/shop_identifier"},{"$ref":"#/components/parameters/public_order_id"}],"post":{"summary":"Issue Refund for Arbitrary Amount","operationId":"IssueRefundForArbitraryAmount","tags":["Refunds"],"description":"Issues a refund for the amount specified against any captured transactions on the order. Notifies the connected stock inventory service to restock the returned line items, if applicable.\\n\\nThis endpoint does not perform any currency conversions.","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RefundComboResponse"},"examples":{"ExamplePartialRefund":{"value":{"data":{"amount_refunded":6055,"transaction_details":[{"success":true,"amount":6055,"transaction_number":"ch_1GvDW4JhIKSKpq8w9SoshRef","created_at":"2021-01-15 01:01:01"}]}}}}}}},"207":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RefundComboResponse"},"examples":{"ExamplePartialRefund":{"value":{"data":{"refund":{"refunded_amount":3580,"transaction_details":{"success":true,"transaction_number":"87760f48","amount":35.8,"created_at":"2024-10-30 17:54:19"}}},"errors":{"code":"02-41","type":"checkout.api_sending_order_to_platform_failed","message":"Full refund was successful but couldn\'t push to platform.","details":{"exception":"Refund failed for an unknown reason"}}}}}}}},"422":{"description":"Unprocessable Entity","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorV2"},"examples":{"FailedPaymentGatewayAttempts":{"value":{"code":"02-28","type":"checkout.order_refund_failed","message":"Attempted to refund 2 transactions on payment gateway but none succeeded.","details":{}}},"FailedToPushToPlatform":{"value":{"code":"02-41","type":"checkout.api_sending_order_to_platform_failed","message":"Full refund was successful but couldn\'t push to platform.","details":{}}}}},"application/xml":{"schema":{"type":"object","properties":{}}}}}},"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RefundRequest"},"examples":{"BrokenProduct":{"value":{"amount":6055,"reason":"Product arrived broken.","email_notification":true,"refund_meta_data":{"data":{"external_id":"legacy-id-135798642"}}}}}}}}}},"/checkout/orders/{shop_identifier}/{public_order_id}/refunds/{payment_id}":{"parameters":[{"$ref":"#/components/parameters/shop_identifier"},{"$ref":"#/components/parameters/public_order_id"},{"$ref":"#/components/parameters/payment_id"}],"post":{"summary":"Refund a Specific Payment for an Arbitrary Amount","operationId":"IssuePaymentRefundForArbitraryAmount","tags":["Refunds"],"description":"Issues a refund for the amount specified against a specific transaction on the order, identified by the `payment_id`. Notifies the connected stock inventory service to restock the returned line items, if applicable.\\n\\nThis endpoint does not perform any currency conversions.","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RefundResponse"},"examples":{"ExamplePartialRefund":{"value":{"data":{"amount_refunded":6055,"transaction_details":[{"success":true,"amount":6055,"transaction_number":"ch_1GvDW4JhIKSKpq8w9SoshRef","created_at":"2021-01-15 01:01:01"}]}}}}}}},"207":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RefundComboResponse"},"examples":{"ExamplePartialRefund":{"value":{"data":{"refund":{"refunded_amount":3580,"transaction_details":{"success":true,"transaction_number":"87760f48","amount":35.8,"created_at":"2024-10-30 17:54:19"}}},"errors":{"code":"02-41","type":"checkout.api_sending_order_to_platform_failed","message":"Full refund was successful but couldn\'t push to platform.","details":{"exception":"Refund failed for an unknown reason."}}}}}}}},"422":{"description":"Unprocessable Entity","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorV2"},"examples":{"FailedPaymentGatewayAttempts":{"value":{"code":"02-28","type":"checkout.order_refund_failed","message":"Attempted to refund 2 transactions on payment gateway but none succeeded.","details":{}}},"FailedToPushToPlatform":{"value":{"code":"02-41","type":"checkout.api_sending_order_to_platform_failed","message":"Full refund was successful but couldn\'t push to platform.","details":{}}}}},"application/xml":{"schema":{"type":"object","properties":{}}}}}},"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RefundRequest"},"examples":{"BrokenProduct":{"value":{"amount":6055,"reason":"Product arrived broken.","email_notification":true,"refund_meta_data":{"data":{"external_id":"legacy-id-135798642"}}}}}}}}}},"/checkout/orders/{shop_identifier}/{public_order_id}/refunds/full":{"parameters":[{"$ref":"#/components/parameters/shop_identifier"},{"$ref":"#/components/parameters/public_order_id"}],"post":{"summary":"Issue Refund for Full Order Amount","operationId":"IssueRefundForFullOrderAmount","tags":["Refunds"],"description":"Issues a refund for the entire order, including shipping and taxes. Notifies the connected stock inventory service to restock the returned line items, if applicable.\\n\\nThis endpoint does not perform any currency conversions.","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RefundResponse"},"examples":{"ExampleFullRefund":{"value":{"data":{"amount_refunded":6055,"transaction_details":[{"success":true,"amount":6055,"transaction_number":"ch_1GvDW4JhIKSKpq8w9SoshRef","created_at":"2021-01-15 01:01:01"}]}}}}}}},"207":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RefundComboResponse"},"examples":{"ExamplePartialRefund":{"value":{"data":{"refund":{"refunded_amount":3580,"transaction_details":{"success":true,"transaction_number":"87760f48","amount":35.8,"created_at":"2024-10-30 17:54:19"}}},"errors":{"code":"02-41","type":"checkout.api_sending_order_to_platform_failed","message":"Full refund was successful but couldn\'t push to platform.","details":{"exception":"Refund failed for an unknown reason."}}}}}}}},"422":{"description":"Unprocessable Entity","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorV2"},"examples":{"FailedPaymentGatewayAttempts":{"value":{"code":"02-28","type":"order_refund_failed","message":"Attempted to refund 2 transactions on payment gateway but none succeeded.","details":{}}},"FailedToPushToPlatform":{"value":{"code":"02-41","type":"api_sending_order_to_platform_failed","message":"Full refund was successful but couldn\'t push to platform.","details":{}}}}}}}},"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RefundRequestFull"},"examples":{"BrokenProduct":{"value":{"reason":"Product arrived broken.","email_notification":true,"refund_meta_data":{"data":{"external_id":"legacy-id-135798642"}}}}}}}}}},"/checkout/orders/{shop_identifier}/{public_order_id}/line_items/{line_item_key}":{"parameters":[{"$ref":"#/components/parameters/shop_identifier"},{"$ref":"#/components/parameters/public_order_id"},{"schema":{"$ref":"#/components/schemas/LineItemKey"},"name":"line_item_key","in":"path","required":true}],"patch":{"summary":"Update Line Item","operationId":"UpdateLineItem","tags":["Line Items"],"description":"Updates the `fulfilled_quantity` property of a single line item.\\n\\nFor more information, refer to the [Fulfill an Order guide](/guides/checkout/fulfill-order).","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"line_item":{"$ref":"#/components/schemas/LineItem"},"application_state":{"$ref":"#/components/schemas/ApplicationState"}}}}}}}},"422":{"description":"Unprocessable Entity","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorV2"},"examples":{"LineItemKeyMissing":{"value":{"code":"11-13","type":"line_items","message":"The line item key field is required.","details":null}}}}}}},"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PatchLineItem"}}}}}},"/checkout/orders/{shop_identifier}/{public_order_id}/line_items":{"parameters":[{"$ref":"#/components/parameters/shop_identifier"},{"$ref":"#/components/parameters/public_order_id"}],"patch":{"summary":"Update Line Items","operationId":"UpdateLineItems","tags":["Line Items"],"description":"Updates the `fulfilled_quantity` property of multiple line items.\\n\\nFor more information, refer to the [Fulfill an Order guide](/guides/checkout/fulfill-order).","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"line_items":{"type":"array","items":{"$ref":"#/components/schemas/LineItem"}},"application_state":{"$ref":"#/components/schemas/ApplicationState"}}}}}}}},"422":{"description":"Unprocessable Entity","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorV2"},"examples":{"LineItemKeyMissing":{"value":{"code":"11-13","type":"line_items","message":"The line item key field is required.","details":null}}}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"line_items":{"type":"array","items":{"allOf":[{"type":"object","properties":{"line_item_key":{"$ref":"#/components/schemas/LineItemKey"}},"required":["line_item_key"]},{"$ref":"#/components/schemas/PatchLineItem"}]}}}},"examples":{"Set fulfilled quantity of multiple items":{"value":{"line_items":[{"fulfilled_quantity":1,"line_item_key":"oak_cheese_grater_2643"},{"fulfilled_quantity":3,"line_item_key":"oak_cheese_grater_3000"}]}}}}}}}}},"components":{"securitySchemes":{"OAuthToken":{"type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"https://apps.boldapps.net/accounts/dashboard/authorize","tokenUrl":"https://api.boldcommerce.com/auth/oauth2/token","scopes":{}}},"description":"Authenticates an API request from a [public integration](/guides/checkout/resources/glossary#public-integration). Generate this token in the [Developer Dashboard](https://developer-dashboard.boldcommerce.com/default/dashboard). Refer to [Build Public Integrations](/default/guides/checkout/public-integrations) for more information."},"APIAccessToken":{"type":"apiKey","name":"API Access Token","in":"header","description":"Authenticates an API request from a [private integration](/guides/checkout/resources/glossary#private-integration). Generate this token in the [Bold Account Center](https://account.boldcommerce.com/). Refer to [Making API Calls](/guides/checkout/quick-start) for more information."}},"parameters":{"shop_identifier":{"schema":{"type":"string","example":"zp3oafdor9"},"name":"shop_identifier","in":"path","required":true,"description":"The identifier of the shop, which can be retrieved by making a request to the [Get Info](shops#operation/GetShopInfo) endpoint."},"public_order_id":{"schema":{"type":"string","example":"woiph4vhqss9jjr50lR5am7IWurQ8FdbmtdOj4aaFIOfFiFGcvhY6x1t6eT0GoB"},"name":"public_order_id","in":"path","required":true,"description":"The public order id generated when the order is initialized by making a request to the [Initialize Order](orders#operation/InitializeOrder) endpoint."},"payment_id":{"schema":{"type":"string","example":"woiph4vhqss9jjr50lR5am7IWurQ8FdbmtdOj4aaFIOfFiFGcvhY6x1t6eT0GoB"},"name":"payment_id","in":"path","required":true,"description":"The identifier assigned to each unique payment."}},"schemas":{"AuthenticatedCustomerBody":{"title":"Authenticated Customer Body","type":"object","description":"The request payload to create a new authenticated customer.","properties":{"platform_id":{"type":"string","description":"The platform identifier for an authenticated customer. For guest customers, the value for this property will be null.","nullable":true,"example":"50942578465125"},"public_id":{"type":"string","description":"The public identifier generated by Checkout for a customer.","nullable":true,"example":"pjpTyGh8KzNQ225wPqxgy7LwNuC887h6ecGyp3omwT4XW8SszjVSdHzWHN4NBwqhA"},"first_name":{"type":"string","description":"The customer\'s first name.","example":"John"},"last_name":{"type":"string","description":"The customer\'s last name.","example":"Doe"},"email_address":{"type":"string","description":"The customer\'s email address.","example":"john.doe@example.com"},"accepts_marketing":{"type":"boolean","description":"If the customer would like to receive any sort of marketing emails. Defaults to `false`.","default":false,"example":false}},"required":["email_address","platform_id"]},"SKUCartItem":{"title":"SKU Cart Item","type":"object","description":"Cart item based of the product SKU. Product data must be synced with Bold Checkout to work.","properties":{"sku":{"type":"string"},"quantity":{"type":"integer"},"line_item_key":{"$ref":"#/components/schemas/LineItemKey"},"line_item_properties":{"$ref":"#/components/schemas/LineItemProperty"}},"required":["sku","quantity","line_item_key"]},"VariantIDCartItem":{"title":"Variant ID Cart Item","type":"object","description":"A cart item based off a platform product model. The identifier is unique to the particular platform. For Shopify, it is a variant ID.","properties":{"platform_id":{"description":"The ID of a product variant.","type":"string","example":"1235235"},"quantity":{"type":"integer","description":"The quantity of the item in the cart.","example":2},"line_item_key":{"$ref":"#/components/schemas/LineItemKey"},"line_item_properties":{"$ref":"#/components/schemas/LineItemProperty"}},"required":["platform_id","quantity","line_item_key"]},"AccessToken":{"type":"string","description":"An optional string token that you can pass to the platform. For example, use this field if your platform requires an authentication token to retrieve cart information (commercetools).","example":"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c"},"CartID":{"type":"string","description":"Identifier of an existing cart to load from the platform. This field is unsupported when using a custom platform.","example":"1snVSJAWYWWYhfLWq9ABcXMwx8mcvh2U"},"GenericCartItem":{"title":"Generic Cart Item","type":"object","description":"An array of items to add to the cart. Generic cart items are items that are not created in the platform, and the product data is added to the order by Bold. Generic cart items are supported on BigCommerce, commercetools, and Shopify stores only.","properties":{"quantity":{"type":"integer","description":"The quantity of the cart item.","example":1},"title":{"type":"string","description":"The item title to display.","example":"Oak Cheese Grater"},"weight":{"type":"integer","description":"Weight of the item in grams.","example":1000},"taxable":{"type":"boolean","description":"Indicates whether the item is taxable.","example":true},"image":{"type":"string","description":"Link to the image to display during checkout.","example":"http://shop.images/oakcheesegrater"},"requires_shipping":{"type":"boolean","description":"Indicates whether the item requires shipping.","example":true},"price":{"description":"The item price, represented in base currency units, using [ISO-4217](https://www.iso.org/iso-4217-currency-codes.html) standards.","type":"number","example":2350},"line_item_key":{"$ref":"#/components/schemas/LineItemKey"},"line_item_properties":{"$ref":"#/components/schemas/LineItemProperty"}},"required":["quantity","title","weight","requires_shipping","price","line_item_key"]},"LineItemKey":{"title":"LineItemKey","type":"string","description":"A merchant-defined, unique identifier serving to refer to this line throughout Bold Checkout.","example":"oak_cheese_grater_2643"},"LineItemProperty":{"title":"Line Item Property","type":"object","description":"Any arbitrary property that you want to associate with this item. Line items can also be gift cards, which have specific and unique properties. See the \\"Gift card properties\\" example in `line_items` arrays.","anyOf":[{"type":"object","title":"Additional Properties","additionalProperties":{"type":"string"},"example":{"colour":"red","size":"small"}},{"$ref":"#/components/schemas/GiftCardProperties"},{"type":"object","title":"No properties","description":"Empty object"}]},"GiftCardProperties":{"title":"Gift Card Properties","type":"object","properties":{"recipient_name":{"type":"string","description":"Name of the person the gift card is being sent to.","example":"John Doe"},"recipient_email":{"type":"string","description":"Email address the gift card is being sent to.","example":"johndoe@boldcommerce.com"},"message":{"type":"string","description":"Personalized message field the buyer can attach to the gift card. Value is `\\"\\"` if created from an order.","example":"Dear John, Happy Birthday!"},"custom_amount":{"type":"string","description":"If included, the price of this particular line item in the checkout order will be overwritten by this value. It is written in base units, using [ISO-4217](https://www.iso.org/iso-4217-currency-codes.html) standards.","example":"2450"}}},"LineItem":{"title":"Line Item","type":"object","properties":{"id":{"type":"string","description":"An internal-only string that Bold uses to identify line items.","example":"724bca"},"product_title":{"type":"string","description":"The name of the product.","example":"Oak Cheese Grater"},"title":{"type":"string","description":"The name of the product variant.","example":"Small"},"image_url":{"type":"string","description":"The URL for the image of the variant that is displayed on the storefront.","example":"http://shop.images/oakcheesegrater"},"properties":{"description":"Any additional properties of the line item. Line Items can also be Gift Cards, which have specific and unique properties. See the \\"Gift card properties\\" example in `line_items` arrays.","anyOf":[{"type":"object","title":"Additional Properties","additionalProperties":{"type":"string"}},{"$ref":"#/components/schemas/GiftCardProperties"},{"type":"array","title":"No properties","maxItems":0,"items":{}}]},"description":{"type":"string","description":"A description of the product.","example":"A handmade oak cheese grater to elevate your cheese-eating experience."},"quantity":{"type":"integer","description":"The quantity of the line item on the order.","example":2},"price":{"type":"number","description":"The price of one unit of the line item, using cents/base currency units, using [ISO-4217](https://www.iso.org/iso-4217-currency-codes.html) standards.","example":2350},"total_price":{"type":"number","description":"The total price of all units of the line item, presented in cents/base currency units, using [ISO-4217](https://www.iso.org/iso-4217-currency-codes.html) standards.","example":4700},"visible":{"type":"integer","description":"Indicates whether the item is visible on the storefront. Hard-coded to `1` to indicate `true`.","example":1},"line_item_key":{"$ref":"#/components/schemas/LineItemKey"},"barcode":{"type":"string","description":"The barcode for the line item.","example":"1234ABC"},"compare_at_price":{"type":"number","description":"An optional price displayed on the product page to indicate the discount taken.","nullable":true,"example":4000},"weight":{"type":"integer","description":"The weight of one unit of the line item, measured in `weight_unit`.","example":1000},"weight_unit":{"type":"string","description":"The unit in which to measure the line item weight.","example":"g"},"product_id":{"type":"string","description":"A platform-defined identifier for the product on this line item.","example":"oak-cheese-grater"},"variant_id":{"oneOf":[{"type":"string"},{"type":"number"}],"description":"A platform-defined identifier for the product variant on this line item.","example":"oak-cheese-grater-small"},"requires_shipping":{"type":"boolean","description":"Indicates whether the item must be shipped.","example":true},"sku":{"type":"string","description":"A merchant-defined stock-keeping unit of the line item.","example":"OAK_GRATER_SM"},"taxable":{"type":"boolean","description":"Indicates whether the line item is taxable.","example":true},"tags":{"type":"string","description":"Any tags attached to the line item.","example":"Kitchen, Cheese Board, Oak"},"vendor":{"type":"string","description":"The vendor that supplied the line item.","example":"Cheese Boards Unlimited"},"total_weight":{"type":"integer","description":"The total weight of all units of this line item.","example":2000},"localized_names":{"description":"Any localized names for the product. Languages and localized names are configured in the platform.\\n\\nFor each configured language, the object contains a property with a key equal to the language (in [ISO 369](https://www.iso.org/iso-639-language-codes.html) format) and value equal to the product name in that language.\\n","anyOf":[{"type":"object","title":"Additional Properties","additionalProperties":{"type":"string","properties":{"text":{"type":"string"}}},"example":{"fr":"Gratteur \xe0 fromage en ch\xeane","ge":"K\xe4sereibe aus Eichenholz"}},{"type":"array","title":"No localized_names","maxItems":0,"items":{}}]},"localized_descriptions":{"description":"Any localized descriptions for the product. Languages and localized descriptions are configured in the platform.\\n\\nFor each configured language, the object contains a property with a key equal to the language (in [ISO 369](https://www.iso.org/iso-639-language-codes.html) format) and value equal to the product description in that language.\\n","anyOf":[{"type":"object","title":"Additional Properties","additionalProperties":{"type":"string","properties":{"text":{"type":"string"}}},"example":{"fr":"Un gratteur \xe0 fromage en ch\xeane faite \xe0 la main pour rehausser votre exp\xe9rience de d\xe9gustation de fromage","ge":"Eine handgefertigte K\xe4sereibe aus Eichenholz, um Ihr K\xe4seerlebnis zu verbessern"}},{"type":"array","title":"No localized_descriptions","maxItems":0,"items":{}}]},"localized_variant_names":{"description":"Any localized names for the product variant. Languages and localized names are configured in the platform.\\n\\nFor each configured language, the object contains a property with a key equal to the language (in [ISO 369](https://www.iso.org/iso-639-language-codes.html) format) and value equal to the product variant name in that language.\\n","anyOf":[{"type":"object","title":"Additional Properties","additionalProperties":{"type":"string","properties":{"text":{"type":"string"}}},"example":{"fr":"Gratteur \xe0 fromage en ch\xeane","ge":"K\xe4sereibe aus Eichenholz"}},{"type":"array","title":"No localized_variant_names","maxItems":0,"items":{}}]}}},"Discount":{"title":"Discount","type":"object","description":"A discount, which can be applied either to an individual line item or the order as a whole.","properties":{"code":{"type":"string","description":"The user-facing discount code name.","example":"SUMMER5"},"text":{"type":"string","description":"A description of the discount, which is displayed on the platform.","example":"Summer discount code"},"value":{"type":"number","example":500,"description":"The value of the discount applied, represented in base currency units, using [ISO-4217](https://www.iso.org/iso-4217-currency-codes.html) standards."},"source":{"type":"string","description":"The source of the discount code. Possible values are:\\n - `\\"cart\\"` discount created from plugin actions [DISCOUNT_CART](/guides/checkout/references/plugin-actions#discount_cart) and/or [DISCOUNT_LINE_ITEMS](/guides/checkout/references/plugin-actions#discount_line_items)\\n - `\\"coupon\\"` discount created in the [Bold Checkout admin](https://apps.boldapps.net/accounts/app/4).","example":"coupon"}}},"Discounts":{"type":"array","minItems":0,"description":"The order\'s discount information.","items":{"oneOf":[{"type":"object","title":"Existing Discount Code","properties":{"discount_code":{"type":"string","description":"Existing discount code to be applied to order."}},"required":["discount_code"]},{"type":"object","title":"New Discount","properties":{"type":{"type":"string","enum":["fixed","percent","shipping_fixed","shipping_percent","free_shipping"],"description":"Type of discount:\\n* `\\"fixed\\"` - Fixed amount to discount from the order total, in base currency units, using [ISO-4217](https://www.iso.org/iso-4217-currency-codes.html) standards. * `\\"percent\\"` - Percent to discount from the order total. * `\\"shipping_fixed\\"` - Fixed amount to discount from the shipping total in base currency units, using [ISO-4217](https://www.iso.org/iso-4217-currency-codes.html) standards. * `\\"shipping_percent\\"` - Percent to discount from the shipping total. * `\\"free_shipping\\"` - Discounts the full amount of the shipping total.\\n"},"value":{"type":"number","minimum":0,"description":"Discount value, described in one of the following ways:\\n* For `\\"fixed\\"` and `\\"shipping_fixed\\"` type, provide the amount in base currency units, using [ISO-4217](https://www.iso.org/iso-4217-currency-codes.html) standards. * For `\\"percent\\"` and `\\"shipping_percent\\"` type, provide the amount as a percentage, between 0 and 100. * For `\\"free_shipping\\"` type, leave the value blank.\\n"},"line_text":{"type":"string","description":"A human-readable description of the discount that can be displayed in a user interface."}},"required":["type","value","line_text"]}]}},"OrderMetaData":{"title":"Order Metadata","type":"object","description":"Additional information about an order. Metadata can be used as data proxy that Checkout will act upon. It can also be used to include extra information about an order and included when pushed to the platform.","properties":{"cart_parameters":{"description":"Extra information about an order that Checkout can act upon.","oneOf":[{"type":"object","title":"Cart parameters","properties":{"key":{"type":"string","example":"cp-key1"}},"additionalProperties":{"type":"string","example":"A cart param."}},{"type":"array","title":"No cart parameters","maxItems":0,"items":{}}]},"note_attributes":{"description":"Extra information added to the order and pushed to the platform.","oneOf":[{"type":"object","title":"Note attributes","properties":{"key":{"type":"string","example":"na-key1"}},"additionalProperties":{"type":"string","example":"A note attribute."}},{"type":"array","title":"No note attributes","maxItems":0,"items":{}}]},"notes":{"type":"string","description":"Notes that can be attached to the order.","example":"A special delivery note."},"tags":{"type":"array","description":"Tags attached to the order.","items":{"type":"string","example":"order-1"}}}},"LineItemFee":{"title":"Fee","type":"object","description":"An additional fee to be added to the line item.","properties":{"amount":{"type":"number","description":"The fee amount, represented in cents/base currency units, using [ISO-4217](https://www.iso.org/iso-4217-currency-codes.html) standards.","example":500},"name":{"type":"string","description":"A description of the fee.","example":"Miscellaneous fee."}}},"GeneralFee":{"title":"GeneralFee","type":"object","properties":{"id":{"type":"string","description":"A unique identifier for this fee, used in the [`remove_fee`](/guides/checkout/references/plugin-actions#remove_fee) plugin action.","example":"123456789"},"line_text":{"type":"string","description":"A user-defined identifier serving to be displayed in any user interfaces.","example":"Custom Fee \u2014 Added by Plugin"},"fee_type":{"type":"string","description":"The type of the fee, \\"fixed\\" or \\"percentage\\".","example":"fixed"},"value":{"type":"integer","description":"The fee amount, represented in base currency units, using [ISO-4217](https://www.iso.org/iso-4217-currency-codes.html) standards.","example":10},"source":{"type":"string","description":"The method in which the fee was added to the order, typically through the `add_fee` plugin action.","example":"PLUGIN"},"plugin_uuid":{"type":"string","description":"The identifier of the plugin which added the fee to the order. This field is omitted if the fee source was not a plugin.","example":"a52589f8-09df-11ed-b30e-f67072e164ee"},"taxable":{"type":"boolean","description":"Indicates whether the fee should be included in the calculation of taxes.","example":true},"show_description":{"type":"boolean","description":"Indicates whether to show the fee description. Always set to `true` for fees added by plugin.","example":true}}},"Currency":{"type":"object","description":"The currency that the order was completed in.","properties":{"iso_code":{"type":"string","description":"The currency code, using [ISO-4217](https://www.iso.org/iso-4217-currency-codes.html) standards.","example":"CAD"},"iso_numeric_code":{"type":"integer","description":"The numeric currency code, using [ISO-4217](https://www.iso.org/iso-4217-currency-codes.html) standards.","example":124},"symbol":{"type":"string","description":"The symbol associated with the currency.","example":"$"},"format":{"type":"string","description":"The format of the currency, including the symbol and the amount.","example":"${{amount}}"},"has_decimal":{"type":"boolean","description":"Indicates whether the currency uses a decimal.","example":true},"show_iso_code":{"type":"boolean","description":"Indicates whether to show the ISO code alongside the order total on the storefront.","example":true}}},"DisplayCurrency":{"type":"object","description":"The currency that the order was displayed to the user.","properties":{"iso_code":{"type":"string","description":"The currency code, using [ISO-4217](https://www.iso.org/iso-4217-currency-codes.html) standards.","example":"USD"},"iso_numeric_code":{"type":"integer","description":"The numeric currency code, using [ISO-4217](https://www.iso.org/iso-4217-currency-codes.html) standards.","example":840},"symbol":{"type":"string","description":"The symbol associated with the currency.","example":"$"},"format":{"type":"string","description":"The format of the currency, including the symbol and the amount.","example":"${{amount}}"},"has_decimal":{"type":"boolean","description":"Indicates whether the currency uses a decimal.","example":true},"show_iso_code":{"type":"boolean","description":"Indicates whether to show the ISO code alongside the order total on the storefront.","example":true}}},"DisplayExchangeRate":{"type":"number","description":"The rate of exchange between the currency on the order and the display currency.","example":1.357251},"PatchLineItem":{"title":"Line Item Patch","type":"object","x-tags":["app_state"],"properties":{"fulfilled_quantity":{"type":"integer","description":"The fulfilled quantity of a line item in an order.","example":2}}},"InitialData":{"title":"Initial Data","type":"object","properties":{"shop_name":{"type":"string","description":"The URL of the store.","example":"examplestore.com"},"country_information":{"type":"array","description":"Information about the countries supported by the store.","items":{"$ref":"#/components/schemas/Country"}},"supported_languages":{"type":"array","description":"Information about the languages supported by the store.","items":{"$ref":"#/components/schemas/SupportedLanguage"}},"general_settings":{"$ref":"#/components/schemas/GeneralSettings"},"alternative_payment_methods":{"type":"array","description":"Any additional payment methods that are configured on the store and are not the default payment method (set in the [Bold Checkout admin](https://apps.boldapps.net/accounts/app/4)). Objects in this array may have differing formats based on the payment gateway they are associated with.","items":{}},"flow_settings":{"type":"object","description":"Any important information about the checkout flow that was used for this order. The content of this object varies based on the flow you are using."},"external_payment_gateways":{"type":"array","description":"A list of the [external payment gateways](/guides/checkout/concepts/external-payment-gateways) applied to the checkout experience. Manage external payment gateways using the [Checkout Admin API](/api/checkout-admin#tag/External-Payment-Gateways).","items":{"$ref":"#/components/schemas/ExternalPaymentGateway"}},"life_elements":{"type":"array","description":"A list of [LiFE elements](/guides/checkout/life) applied to the checkout experience. Manage LiFE elements using the [Checkout Admin API](/api/checkout-admin#tag/Lightweight-Frontend-Experience-(LiFE)-Elements).","items":{"$ref":"#/components/schemas/LiFE_element"}},"requires_shipping":{"type":"boolean","example":true,"description":"Indicates whether any of the items in the order require shipping. If set to `false`, the order includes only digital items, and the `shipping_address` and `shipping_line` are empty."}}},"Province":{"title":"Province","type":"object","properties":{"iso_code":{"type":"string","description":"The province code, using [ISO-3166](https://www.iso.org/iso-3166-country-codes.html) format.","example":"MB"},"name":{"type":"string","description":"The human-readable name of the province.","example":"Manitoba"},"valid_for_shipping":{"type":"boolean","description":"Indicates whether this province can be shipped to.","example":true},"valid_for_billing":{"type":"boolean","description":"Indicates whether this province can be used for billing addresses.","example":true}}},"Country":{"title":"Country","type":"object","properties":{"iso_code":{"type":"string","description":"The country code, using [ISO-3166](https://www.iso.org/iso-3166-country-codes.html) format.","example":"CA"},"name":{"type":"string","description":"The human-readable name of the country.","example":"Canada"},"show_province":{"type":"boolean","description":"Indicates whether this country should display the province field when the customer is entering address information.","example":true},"province_label":{"type":"string","description":"A label used to describe the region, such as State, Province, or Region.","example":"Province"},"show_postal_code":{"type":"boolean","description":"Indicates whether the country requires postal codes in addresses.","example":true},"provinces":{"type":"array","description":"List of provinces is applicable.","items":{"$ref":"#/components/schemas/Province"}},"valid_for_shipping":{"type":"boolean","description":"Indicates whether this country can be shipped to.","example":true},"valid_for_billing":{"type":"boolean","description":"Indicates whether this country can be used for billing addresses.","example":true}}},"Transaction":{"title":"Transaction","type":"object","description":"","properties":{"gateway":{"type":"string","description":"Name of the payment gateway this transaction was processed on.\\n"},"gateway_id":{"type":"string","description":"Identifier for the payment gateway this transaction was processed on."},"amount":{"description":"The amount, represented in base currency units, using [ISO-4217](https://www.iso.org/iso-4217-currency-codes.html) standards.","type":"number"},"transaction_id":{"type":"string","description":"Payment gateway transaction ID."},"response_code":{"type":"string","description":"Additional payment gateway response code."},"gateway_error":{"type":"string","description":"The error message returned by the payment gateway."},"status":{"description":"Status of the transaction. Possible values: failed, success.","type":"string"},"gateway_meta_data":{"type":"object"},"payment_id":{"type":"string"},"gateway_response":{"type":"object"}}},"AuthTransaction":{"type":"object","description":"A transaction associated with the authorized payment.","properties":{"gateway":{"type":"string","description":"The name of the payment gateway this transaction was processed on.","example":"Stripe Default Name"},"payment_id":{"type":"string","description":"The Bold-generated identifier for payment.","example":"xBxKWi4YX4t1VURWlO3wKdt7aFeefHvR6LFRmVs1krgepEeZNodDwYfXvmfcVesE"},"amount":{"description":"The amount, represented in base currency units, using [ISO-4217](https://www.iso.org/iso-4217-currency-codes.html) standards.","type":"number","example":1000},"transaction_id":{"type":"string","description":"The gateway-generated transaction ID.","example":"ch_1GvDW4JhIKSKpq8w9SoshRef"},"currency":{"type":"string","description":"The currency code.","example":"USD"},"step":{"type":"string","description":"The current step in the payment lifecycle.","example":"preAuthed","enum":["awaitingPreAuth","preAuthed","refund","finalized","FAILED","SKIP_NO_VALUE","authVoided","reattempted","pendingPreAuthActions","authHeld","tokenizationHeld","captureHeld","sale"]},"status":{"description":"The status of the transaction.","type":"string","enum":["failed","success"]},"tender_type":{"type":"string","description":"The type of payment.","example":"credit_card"},"tender_details":{"type":"object","description":"Information about the payment method. The contents of this object depend on what is provided by the payment gateway.","oneOf":[{"$ref":"#/components/schemas/CreditCardTender"}]},"gateway_response_data":{"type":"array","description":"Information from the payment gateway. The contents of this object depend on your payment gateway and configuration settings.","items":{}}}},"CreditCardTender":{"type":"object","description":"The tender details for a credit card.","properties":{"brand":{"description":"The credit card brand.","type":"string","example":"Visa"},"last_four":{"type":"string","description":"The last four digits of the credit card.","example":"7890"},"bin":{"type":"string","description":"The credit card Bank Identification Number (BIN).","example":"40466534"},"expiration":{"type":"string","description":"The credit card expiration date, in \\"MM/YY\\" format.","example":"01/29"}}},"JWTToken":{"type":"string","title":"JWT Token","description":"The JSON Web Token (JWT) generated during the initialization of the order. Use the JWT to authenticate future calls to the [Checkout Frontend API](checkout).","example":"eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJhdXRoX3R5cGUiOiJWMl9BUEkiLCJwYXlsb2FkIjp7InB1YmxpY19vcmRlcl9pZCI6Inlyb0Y2NDNNeUpTZVZRUUpES2R2c2QxYXdXY3BpRVFJbkhOaTJkWlhmWW9PdVI0dmFGVUhpNHBPRG9pRWFpOVQifSwiZXhwIjoxNjMyMzQxMjg3LCJuYmYiOm51bGwsImlhdCI6bnVsbH0.swmYcVBHyK2i86jN-bIOL3WOCzP5VQVLq9Ev-TfIC_c"},"PublicOrderId":{"title":"Public Order ID","type":"string","description":"The public order identifier generated when the order is initialized by making a request to the [Initialize Order](orders#operation/InitializeOrder) endpoint.","example":"nPTPIlIahDoEgZFabZNNvg7uxahLkGb1x4UINz3eqYV3eHewsjq7kubZc5BLAUqC"},"ApplicationState":{"title":"Application State","type":"object","description":"Represents the current state of the order.\\nTaxes and discounts represent the summation of all tax or discount lines that have been applied anywhere through the order. Consulting the line items allows you to get the specific product break down of taxes and discounts.","properties":{"customer":{"description":"The customer that placed the order.","oneOf":[{"$ref":"#/components/schemas/Customer"},{"type":"array","title":"No customer","maxItems":0,"items":{}}]},"addresses":{"type":"object","description":"The billing and shipping addresses on the order.","properties":{"shipping":{"description":"The shipping address on the order.","oneOf":[{"$ref":"#/components/schemas/Address"},{"type":"array","title":"No address","maxItems":0,"items":{}}]},"billing":{"description":"The billing address on the order.","oneOf":[{"$ref":"#/components/schemas/Address"},{"type":"array","title":"No address","maxItems":0,"items":{}}]}}},"line_items":{"type":"array","description":"The list of line items associated with an order. Each line item includes information about the selected product and the taxes, fees, and discounts applied to it.","items":{"type":"object","properties":{"product_data":{"$ref":"#/components/schemas/LineItem"},"taxes":{"type":"array","description":"Any taxes that apply to the line item.","items":{"$ref":"#/components/schemas/Tax"}},"fees":{"type":"array","description":"Any fees that apply to the line item.","items":{"$ref":"#/components/schemas/LineItemFee"}},"discounts":{"type":"array","description":"Any discounts that apply to the line item.","items":{"$ref":"#/components/schemas/Discount"}},"fulfilled_quantity":{"type":"integer","description":"The quantity of the line item that has been fulfilled. Fulfill a line item using the [Update Line Item](orders#operation/UpdateLineItem) endpoint.","example":2}}}},"fees":{"type":"array","description":"Any fees that apply to the full order.","items":{"$ref":"#/components/schemas/GeneralFee"}},"taxes":{"type":"array","description":"Any taxes that apply to the full order.","items":{"$ref":"#/components/schemas/Tax"}},"discounts":{"type":"array","description":"Any discounts that apply to the full order.","items":{"$ref":"#/components/schemas/Discount"}},"payments":{"type":"array","description":"The payments applied to the order.","items":{"$ref":"#/components/schemas/Payment"}},"order_total":{"type":"number","description":"The total amount of the order (after tax, shipping, and discounts) using cents/base currency units using [ISO-4217](https://www.iso.org/iso-4217-currency-codes.html) standards.","example":4700},"order_meta_data":{"$ref":"#/components/schemas/OrderMetaData"},"shipping":{"type":"object","description":"The shipping information \u2014 including shipping lines, taxes, and discounts \u2014 associated with an order.","properties":{"selected_shipping":{"$ref":"#/components/schemas/ShippingLine"},"available_shipping_lines":{"type":"array","description":"The shipping lines available for the order.","items":{"type":"object","properties":{"id":{"type":"string"},"line":{"$ref":"#/components/schemas/ShippingLine"}}}},"taxes":{"description":"Any taxes that apply to the shipping rate.","oneOf":[{"type":"array","items":{"$ref":"#/components/schemas/Tax"}},{"type":"number"}]},"discounts":{"description":"Any discounts that apply to the shipping rate.","oneOf":[{"type":"array","items":{"$ref":"#/components/schemas/Discount"}},{"type":"number"}]}}},"resumable_link":{"$ref":"#/components/schemas/ResumableLink"},"flow_id":{"type":"string","nullable":true,"description":"The identifier of the origin checkout flow used to create the order. If left empty, defaults to `null` and is displayed as \\"Unassigned\\" in the Checkout admin.","example":"external-company-one-page-template"},"currency":{"$ref":"#/components/schemas/Currency"},"display_currency":{"$ref":"#/components/schemas/DisplayCurrency"},"display_exchange_rate":{"$ref":"#/components/schemas/DisplayExchangeRate"},"created_via":{"type":"string","description":"The source of the order. Plugin developers can use the [Set Order Created By](/guides/checkout/references/plugin-actions#set_order_created_by) action to set this field and indicate that an order was created by their plugin. If the order was created as normal through Bold Checkout, this value is `\\"checkout\\"`.","example":"My_Order_Creating_Plugin"},"is_processed":{"type":"boolean","description":"Indicates whether the order has been processed.","example":false},"order_id":{"type":"number","description":"Bold Checkout\'s internal order ID.","example":79047599},"platform_order_id":{"type":"string","nullable":true,"description":"A platform-generated identifier for the order.","example":"1389wjfalsdf9y4r"}}},"Customer":{"title":"Customer","type":"object","description":"An authenticated or guest customer associated with an order.","properties":{"platform_id":{"type":"string","description":"The platform identifier for an authenticated customer. For guest customers, the value for this property will be null.","nullable":true,"example":"50942578465125"},"public_id":{"type":"string","description":"The public identifier generated by Checkout for a customer.","nullable":true,"readOnly":true,"example":"pjpTyGh8KzNQ225wPqxgy7LwNuC887h6ecGyp3omwT4XW8SszjVSdHzWHN4NBwqhA"},"first_name":{"type":"string","description":"The first name of the customer.","example":"John"},"last_name":{"type":"string","description":"The last name of the customer.","example":"Doe"},"email_address":{"type":"string","description":"The email address of the customer.","example":"john.doe@example.com"},"accepts_marketing":{"type":"boolean","description":"If the customer would like to receive any sort of marketing emails. Defaults to `false`.","example":true},"saved_addresses":{"type":"array","description":"The saved addresses of an authenticated customer stored from the platform.","items":{"$ref":"#/components/schemas/Address"}}},"required":["email_address"]},"SupportedLanguage":{"title":"Supported Language","type":"object","description":"","properties":{"id":{"type":"integer","description":"Identifier of the language record.","readOnly":true,"example":32856},"shop_id":{"type":"integer","description":"The identifier of the shop associated to the language record.","example":1091521},"iso_language":{"type":"string","description":"A two character language code, using [ISO 639-1](https://www.iso.org/iso-639-language-codes.html).","example":"en"},"language_name":{"type":"string","description":"A human-readable name of the language.","example":"English"},"language_blob":{"type":"string","description":"The shop language details returned as stringified JSON.","example":"{\\"language_name\\":\\"English\\",\\"terms\\":{\\"customer_information\\":{\\"already_have_an_account\\":\\"Already have an account with us?\\",\\"customer_info\\":\\"Customer information\\",\\"email\\":\\"Email\\",\\"email_address\\":\\"Email address\\",\\"email_address_placeholder\\":\\"Email address\\",\\"enter_new_address\\":\\"Enter a new address\\",\\"log_in\\":\\"Log in\\",\\"not_you\\":\\"Not you?\\",\\"return_to_cart\\":\\"Return to cart\\",\\"return_to_store\\":\\"Return to store\\",\\"accepts_marketing\\":\\"Subscribe to our newsletter\\"},\\"shipping_address\\":{\\"address2_field\\":\\"Apt, suite, etc.\\",\\"address2_field_optional\\":\\"Apt, suite, etc. (optional)\\",\\"address_field\\":\\"Address\\",\\"city_field\\":\\"City\\",\\"company_field\\":\\"Company\\",\\"company_field_optional\\":\\"Company (optional)\\",\\"cont_to_shipping\\":\\"Continue to shipping method\\",\\"country_field\\":\\"Country\\",\\"country_field_placeholder\\":\\"Choose a country\\",\\"first_name_field\\":\\"First name\\",\\"last_name_field\\":\\"Last name\\",\\"optional\\":\\" (optional)\\",\\"phone_field\\":\\"Phone\\",\\"phone_field_optional\\":\\"Phone (optional)\\",\\"postal_code_field\\":\\"Postal code\\",\\"province\\":\\"Province\\",\\"province_field\\":\\"Province\\",\\"province_field_placeholder\\":\\"Choose a province\\",\\"select_address\\":\\"Select an address\\",\\"select_exist_address\\":\\"Select an existing address\\",\\"shipping\\":\\"Shipping\\",\\"shipping_address\\":\\"Shipping address\\",\\"state\\":\\"State\\"}}}"},"is_default":{"type":"boolean","description":"Indicates whether the given language is the shop default.","example":true},"out_of_date":{"type":"integer","minimum":0,"maximum":1,"description":"An integer (0 or 1) representing whether the given language blob is out of date, where 1 is out of date.","example":0},"enabled":{"type":"integer","minimum":0,"maximum":1,"description":"An integer (0 or 1) representing whether the given language blob is enabled on the shop, where 1 is enabled.","example":1},"source":{"type":"string","nullable":true,"enum":["yappn",null],"description":"The source of where the language is managed, where `null` implies a language managed within Checkout Admin.","example":null},"created_at":{"type":"string","format":"date-time","description":"The date and time when the language record was created.","example":"2021-08-12T14:30:54.000000Z"},"updated_at":{"type":"string","format":"date-time","description":"The date and time when the language record was last updated.","example":"2022-10-20T19:54:08.000000Z"},"deleted_at":{"type":"string","format":"date-time","nullable":true,"description":"The date and time when the language record was deleted, where `null` implies an active record.","example":null},"name":{"type":"string","description":"A human-readable name of the language.","example":"English"},"shop_language_id":{"type":"integer","description":"The identifier of the language record.","readOnly":true,"example":32856}}},"Address":{"title":"Address","description":"A shipping or billing address.","type":"object","nullable":true,"properties":{"id":{"type":"string","description":"A unique identifier of the address.","nullable":true,"readOnly":true,"example":"123"},"first_name":{"type":"string","description":"The first name of the addressee.","example":"John"},"last_name":{"type":"string","description":"The last name of the addressee.","example":"Doe"},"address_line_1":{"type":"string","description":"The street address.","example":"50 Fultz Blvd"},"address_line_2":{"type":"string","description":"Any additional street address details (apt #, suite #, etc).","example":"Suite 200"},"country":{"type":"string","description":"The country name.","example":"Canada"},"city":{"type":"string","description":"The city name.","example":"Winnipeg"},"province":{"type":"string","description":"The province or state name, if applicable.","example":"Manitoba"},"country_code":{"type":"string","description":"The country code, in [ISO 3166](https://www.iso.org/iso-3166-country-codes.html) format.","example":"CA"},"province_code":{"type":"string","description":"The province or state code, in [ISO 3166](https://www.iso.org/iso-3166-country-codes.html) format, if applicable.","example":"MB"},"postal_code":{"type":"string","description":"The postal/zip code. Required for most countries, including the United States, Canada, and Mexico. Validated on format only when provided.","example":"R3Y0L6"},"business_name":{"type":"string","description":"If applicable, the business name.","example":"Acme Inc."},"phone_number":{"type":"string","description":"The phone number of the addressee.","example":"8005550101"}},"required":["country","country_code"]},"ShippingLine":{"title":"Shipping Line","type":"object","nullable":true,"properties":{"id":{"type":"string","description":"The index of the shipping line.","example":"0"},"description":{"type":"string","description":"A description of the shipping line.","example":"Custom weight-based rate: tier 2"},"amount":{"type":"number","description":"The shipping amount represented in cents/base currency units using [ISO-4217](https://www.iso.org/iso-4217-currency-codes.html) standards.","example":450},"code":{"type":"string","description":"An identifier assigned to the shipping rate by the shipping provider.","example":"EXPID"}}},"Payment":{"title":"Payment","type":"object","properties":{"gateway_public_id":{"type":"string","description":"A public identifier of the payment gateway used with the payment.","example":"i7z2xT0sKrDvhGWzex5SLjf5e6ndlQfrRL4AROkfhf3vNBkVT38JKBy5PSjB63qW"},"amount":{"type":"number","description":"The payment amount, represented in cents/base currency units, using [ISO-4217](https://www.iso.org/iso-4217-currency-codes.html) standards.","example":4700},"currency":{"type":"string","description":"The currency of the payment, using [ISO-4217](https://www.iso.org/iso-4217-currency-codes.html) standards.","example":"CAD"},"type":{"type":"string","description":"The payment gateway that accepted the payment.","example":"spreedly"},"display_string":{"type":"string","description":"A description of the payment to visually display to the customer.","example":"Credit Card Payment"},"id":{"type":"string","readOnly":true,"description":"An identifier of the payment.","example":""},"token":{"type":"string","description":"A token generated by the payment gateway to identify the payment.","example":"7uZAMRAf80KiEwibsrrM5IB41yU"},"retain":{"type":"boolean","description":"Indicates whether the payment method will be saved for future orders. Checkout only stores a tokenized version of the payment method.","default":false,"example":false}},"required":["gateway_public_id","token"]},"Error":{"title":"error","type":"object","properties":{"message":{"type":"string","description":"The message for the error.","example":"The first name field is required."},"type":{"type":"string","description":"The type of error that occurred.","example":"customer"},"field":{"type":"string","description":"The field of the object that the error was found in.","example":"first_name"},"severity":{"type":"string","description":"The severity of the error.","example":"validation"},"sub_type":{"type":"string","description":"The sub_type of the error.","example":"order"}}},"ErrorV2":{"title":"Error","type":"object","properties":{"code":{"type":"string","description":"The code for the error.","example":"11-13"},"type":{"type":"string","description":"The type of error.","example":"integration_config.shop_could_not_be_determined"},"message":{"type":"string","description":"The message for the error.","example":"shop could not be determined"},"details":{"type":"object","description":"Additional details for the error.","example":{}}}},"AuthorizationFailure":{"title":"Authorization Failure","type":"object","properties":{"code":{"type":"string","description":"The code for the error.","example":"02-43"},"type":{"type":"string","description":"The type of error.","example":"payments.payment_authorization_failure"},"message":{"type":"string","description":"The message for the error.","example":"payments failed authorization"},"transactions":{"type":"array","description":"The payments that Bold attempted to authorize. If one payment was approved and a later payment failed, then the previously approved payment is voided.","items":{"$ref":"#/components/schemas/AuthTransaction"}}}},"UnprocessableEntity":{"description":"There was a problem with the object provided in the request.","type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"message":{"type":"string","description":"An error message describing what went wrong.","example":"The first name field is required."},"type":{"type":"string","description":"The type of error that occurred.","example":"customer"},"field":{"type":"string","description":"The field of the object that the error was found in.","example":"first_name"},"severity":{"type":"string","description":"The severity of the error.","example":"validation"},"sub_type":{"type":"string","description":"The sub_type of the error.","example":"order"}}}}}},"ResumableLink":{"type":"string","nullable":true,"description":"A URL used to resume an order. If provided, the default resumable link generated by Checkout will be overwritten with this URL. This resumable link will be provided in the email and webhook for an abandoned checkout.","example":"https://mycheckout.com/resume"},"GeneralSettings":{"title":"General Settings","description":"General Checkout settings, which can be configured in the [Bold Checkout admin](https://apps.boldapps.net/accounts/app/4).","type":"object","properties":{"checkout_process":{"type":"object","description":"General settings relevant to the checkout process","properties":{"company_name_option":{"type":"string","description":"Indicates whether company name is required on an order.","enum":["optional","required","hidden"],"example":"hidden"},"phone_number_required":{"type":"boolean","description":"Indicates whether phone number is required on an order.","example":false},"accepts_marketing_checkbox_option":{"type":"string","description":"Indicates initial display of email marketing options.","enum":["checked","unchecked","hidden"],"example":"unchecked"}}},"address_autocomplete":{"type":"object","description":"The configuration for address autocomplete functionality, if enabled for the particular shop.","properties":{"provider":{"type":"string","nullable":true,"description":"The data provider for address autocomplete.","enum":["google","loqate"],"example":"google"},"api_key":{"type":"string","nullable":true,"description":"A public API key for querying the address autocomplete provider.","example":"awefa9304q9wfqf43jfaw904kfwkaslserfa94"}}}},"required":["checkout_process"]},"Tax":{"title":"Tax","type":"object","properties":{"value":{"type":"number","description":"The value of the tax applied, represented in cents/base currency units, using [ISO-4217](https://www.iso.org/iso-4217-currency-codes.html) standards.","example":1000},"name":{"type":"string","description":"A descriptor of the tax being applied.","example":"GST"},"is_included":{"type":"boolean","description":"Indicates whether the tax is already included in the price.","example":true}}},"FlowId":{"type":"string","nullable":true,"maxLength":255,"description":"An identifier for the origin checkout flow that created the order. The field is optional for custom checkout flows and other clients, but provides a convenience for determining the order\'s origin.\\n\\nBold-hosted templates provide this field and are identified by the first 4 letters `\\"bold\\"`, which are reserved. The value `\\"unassigned\\"` is reserved for when the field is not provided.\\n\\nFor more information, refer to [Checkout Flows](/guides/checkout/concepts/flows)","example":"external-company-one-page-template"},"ApiSessionId":{"type":"string","maxLength":255,"description":"An optional alphanumeric identifier used to group orders for the purpose of tracking order completion rates. If this value is not provided, Bold generates one randomly and assumes that the order is not grouped with any others.\\n\\nFor more information, refer to [Configure Checkout Flow Metrics](/guides/checkout/metrics).","example":"abc123"},"RefundRequestFull":{"title":"Refund Request","description":"Request body for full refunds.","type":"object","properties":{"reason":{"type":"string","description":"The note attached to the refund.","example":"Product arrived broken."},"email_notification":{"type":"boolean","description":"Whether or not Checkout will send an email notification. If true, an email will be sent.","example":true},"refund_meta_data":{"type":"object","description":"(optional) Additional refund transaction data for specific payment gateway integrations.","example":{"data":{"external_id":"legacy-id-135798642"}}}}},"RefundRequest":{"title":"Refund Request","description":"Request body for partial refunds.","type":"object","allOf":[{"$ref":"#/components/schemas/RefundRequestFull"},{"type":"object","properties":{"amount":{"type":"integer","description":"Total amount requested for refund, represented in base currency units, using [ISO-4217](https://www.iso.org/iso-4217-currency-codes.html) standards.","example":6055}}}]},"RefundResponse":{"title":"Refund Response","description":"Response body for refunds.","type":"object","properties":{"amount_refunded":{"type":"integer","description":"The refund amount issued, represented in base currency units, using [ISO-4217](https://www.iso.org/iso-4217-currency-codes.html) standards.","example":6055},"transaction_details":{"type":"array","description":"Details for the refund transaction.","items":{"$ref":"#/components/schemas/RefundTransaction"}}}},"RefundComboResponse":{"title":"Refund Response with potential error information","description":"A refund response that combines refund information and error information.","type":"object","properties":{"refund":{"type":"array","items":{"type":"object","properties":{"refunded_amount":{"type":"integer","description":"The refund amount issued, represented in base currency units, using [ISO-4217](https://www.iso.org/iso-4217-currency-codes.html) standards."},"transaction_details":{"type":"array","description":"Details for the refund transaction.","items":{"$ref":"#/components/schemas/RefundTransactionWithoutErrorInfo"}}}}},"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","description":"The code for the error.","example":"11-13"},"type":{"type":"string","description":"The type of error.","example":"integration_config.shop_could_not_be_determined"},"message":{"type":"string","description":"The message for the error.","example":"shop could not be determined"},"details":{"type":"object","description":"Additional details for the error."}}}}}},"RefundTransaction":{"title":"RefundTransaction","type":"object","properties":{"success":{"type":"boolean","description":"If the transaction was successful.","example":true},"transaction_number":{"type":"string","description":"The transaction number.","example":"ch_1GvDW4JhIKSKpq8w9SoshRef"},"amount":{"type":"integer","description":"The amount refunded in the transaction, represented in base currency units, using [ISO-4217](https://www.iso.org/iso-4217-currency-codes.html) standards.","example":6055},"created_at":{"type":"string","description":"The datetime the transaction was created.","example":"2021-01-15 01:01:01"},"errors":{"type":"array","description":"The errors associated with the transaction.","items":{}}}},"RefundTransactionWithoutErrorInfo":{"title":"Refund Transaction without Error Information Included","type":"object","properties":{"success":{"type":"boolean","description":"If the transaction was successful.","example":true},"transaction_number":{"type":"string","description":"The transaction number.","example":"ch_1GvDW4JhIKSKpq8w9SoshRef"},"amount":{"type":"integer","description":"The amount refunded in the transaction, represented in base currency units, using [ISO-4217](https://www.iso.org/iso-4217-currency-codes.html) standards.","example":6055},"created_at":{"type":"string","description":"The datetime the transaction was created.","example":"2021-01-15 01:01:01"}}},"CapturePaymentRequest":{"title":"Capture Payment Request","type":"object","properties":{"reauth":{"type":"boolean","description":"Whether or not Checkout should attempt to re-authorize payment if the authorize transaction has been used or expired.","default":true,"example":true},"idempotent_key":{"type":"string","description":"A unique idempotency key generated by the client which the server uses to recognize subsequent retries of the same requests.","example":"2b268b6f-b3c0-4efb-9c43-1aa59d535182"},"capture_data":{"type":"object","description":"Any data associated with the payment capture request.","example":{"data":{"external_id":"legacy-id-135798642"}}}},"required":["reauth"]},"CapturePartialPaymentRequest":{"title":"Capture Partial Payment Request","type":"object","allOf":[{"$ref":"#/components/schemas/CapturePaymentRequest"},{"type":"object","properties":{"amount":{"type":"number","description":"Amount to capture, represented in base currency units, using [ISO-4217](https://www.iso.org/iso-4217-currency-codes.html) standards.","example":120}},"required":["amount"]}]},"CapturePaymentResponse":{"title":"Capture Payment Response","type":"object","properties":{"order_total":{"type":"number","description":"The total of the order, represented in base currency units, using [ISO-4217](https://www.iso.org/iso-4217-currency-codes.html) standards.","example":120},"amount_remaining":{"type":"number","description":"The amount remaining after a payment has been captured, represented in base currency units, using [ISO-4217](https://www.iso.org/iso-4217-currency-codes.html) standards.","example":60},"paid_total":{"type":"number","description":"The total payment captured, represented in base currency units, using [ISO-4217](https://www.iso.org/iso-4217-currency-codes.html) standards.","example":60},"capture_held_total":{"type":"number","description":"The total amount held for capture by the payment gateway, represented in base currency units, using [ISO-4217](https://www.iso.org/iso-4217-currency-codes.html) standards.","example":0},"transactions":{"type":"array","description":"The transactions created for the payment capture.","items":{"$ref":"#/components/schemas/Transaction"},"example":[{"gateway":"Stripe Default Name","gateway_id":"bFH0RUdnWPFPRxmWfK6B1yXi61Hh0svIBTrk1vtGoI1zPYVXntIqMX82pqdrSYhi","amount":60,"transaction_id":"ch_1GvDW4JhIKSKpq8w9SoshRef","reference_transaction_id":null,"response_code":"","status":"success","payment_id":"abc123"}]}}},"LiFE_element":{"title":"LiFE Element","description":"A configurable, custom element in the checkout experience.","properties":{"public_id":{"type":"string","description":"The Bold-generated identifier of the LiFE element.","example":"VfYRxzOjRkwG6B2xWbxhPQ","readOnly":true},"location":{"type":"string","description":"The location where the LiFE element will be rendered. For more information about possible element locations, refer to the [Checkout LiFE guide](/guides/checkout/life).","example":"customer_info","enum":["customer_info","shipping","billing_address_after","shipping_lines","below_actions","summary_above_header","payment_gateway","thank_you_message","order_confirmation","order_details","main_content_beginning","main_content_end","payment_method_above","paypal_additional_information"]},"input_type":{"type":"string","description":"The input type of the LiFE element.","example":"text","enum":["text","checkbox","html","textarea","dropdown","datepicker"]},"input_default":{"type":"string","description":"The default input. The behavior of this field depends on the `input_type`:\\n - `text` or `textarea`: Set this value to your chosen string. The shopper deletes the `input_default` and adds their own value.\\n - `checkbox`: Set this value to `\\"true\\"` to make the checkbox automatically selected.\\n - `html`: Set this value to the HTML you would like the element to display.\\n - `dropdown`: Set the value to a comma-separated string of the options you would like the element to display.\\n - `datepicker`: Set the value to a date string with the format of `YYYY/MM/DD`. If the `input_default` is not set, the date picker defaults to the current date.","example":"initial value","nullable":true},"input_label":{"type":"string","description":"If the element requires shopper input, this is the label for the input.","example":"Shipping notes","nullable":true},"input_placeholder":{"type":"string","description":"The input placeholder value of the LiFE element. The behavior of this field depends on the `input_type`:\\n - `text` or `textarea`: This value appears in the input field and disappears when the shopper begins typing.\\n - `checkbox`: This value appears below the `input_label`.\\n - `dropdown`: This value appears in the drop-down box before it is expanded.\\n - `datepicker`: This value appears in the input field and disappears when the shopper selects a date.","example":"Shipping notes here","nullable":true},"input_required":{"type":"boolean","description":"Indicates whether input from the shopper is required.","example":true,"nullable":true},"input_regex":{"type":"string","description":"The regular expression that validates the input for `text` and `textarea` elements.","example":"[0-9]{4}","nullable":true},"meta_data_field":{"type":"string","description":"The metadata key from the order\'s `application_state` that will be used to store the user\'s entered value.","example":"shipping_notes"},"order_asc":{"type":"integer","description":"The index of the element. If multiple elements appear in one location, this value indicates the order in which they appear.","example":1}},"required":["location","meta_data_field","input_type","input_required","order_asc"]},"ExternalPaymentGateway":{"title":"External Payment Gateway","description":"A configurable, external payment gateway for accepting payments through Bold checkout.","type":"object","properties":{"is_test":{"type":"boolean","description":"Indicates whether the external payment gateway is in test mode.","example":true},"iframe_url":{"type":"string","description":"The URL to be embedded into the payment iframe.","example":"www.example.com/gateway","nullable":true},"base_url":{"type":"string","description":"The base URL that Checkout calls when performing payment operations.","example":"www.example.com/payments"},"public_id":{"type":"string","description":"The Identifier of the external payment gateway resource.","example":"VfYRxzOjRkwG6B2xWbxhPQ","readOnly":true},"location":{"type":"string","description":"The location during checkout that the payment `iframe` will be rendered.","example":"payment_method_below","nullable":false},"currency":{"type":"string","description":"The currency supported by the external payment gateway, in [ISO-4217](https://www.iso.org/iso-4217-currency-codes.html) format.","example":"CAD","minLength":3,"maxLength":3}}}},"examples":{"cart_token":{"value":{"cart_id":"1snVSJAWYWWYhfLWq9ABcXMwx8mcvh2U","access_token":"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c"}},"generic_cart":{"value":{"cart_items":[{"quantity":2,"title":"Some Product","weight":50,"taxable":true,"image":"https://example.com/thing.jpg","requires_shipping":true,"price":2000,"line_item_key":"ABC123","line_item_properties":{"colour":"red","size":"small"}}],"customer":{"email_address":"john.doe@example.com","first_name":"John","last_name":"Doe","platform_id":"12345","saved_addresses":[{"id":"12","first_name":"John","last_name":"Doe","address_line_1":"50 Fultz Blvd","address_line_2":"","province":"Manitoba","city":"Winnipeg","country_code":"CA","country":"Canada","province_code":"MB","postal_code":"R3Y0L6","business_name":"","phone_number":"8005550101"}]},"order_meta_data":{"cart_parameters":{"cp-key1":"A cart param"},"note_attributes":{"na-key1":"A note attribute"},"notes":"Special delivery message.","tags":["order-1"]}}},"gift_card_cart":{"value":{"cart_items":[{"id":"786dur","quantity":1,"title":"Gift Card","variant_title":"Gift Card $50","taxable":true,"image":"https://example.com/thing.jpg","requires_shipping":false,"price":4700,"line_item_key":"ABC123","line_item_properties":{"recipient_name":"John Doe","recipient_email":"johndoe@boldcommerce.com","message":"Dear John, Happy Birthday!","custom_amount":"5000"}}],"customer":{"email_address":"john.doe@example.com","first_name":"John","last_name":"Doe","platform_id":"12345","saved_addresses":[{"id":"12","first_name":"John","last_name":"Doe","address_line_1":"50 Fultz Blvd","address_line_2":"","province":"Manitoba","city":"Winnipeg","country_code":"CA","country":"Canada","province_code":"MB","postal_code":"R3Y0L6","business_name":"","phone_number":"8005550101"}]},"order_meta_data":{"cart_parameters":{"cp-key1":"A cart param"},"note_attributes":{"na-key1":"A note attribute"},"notes":"Special delivery message.","tags":["order-1"]}}},"sku_cart":{"value":{"cart_items":[{"sku":"123AB","quantity":3,"line_item_key":"ABC123","line_item_properties":{"colour":"red","size":"small"}}]}},"variant_id_cart":{"value":{"cart_items":[{"platform_id":"12345","quantity":3,"line_item_key":"ABC123","line_item_properties":{"colour":"red","size":"small"}}]}},"authenticated_customer":{"value":{"customer":{"platform_id":"50942578465125","email_address":"john.doe@example.com"}}},"NoCustomer":{"summary":"Deleted Customer","value":{"data":{"application_state":{"customer":[],"addresses":{"shipping":{"id":"123","first_name":"John","last_name":"Doe","address_line_1":"50 Fultz Blvd","address_line_2":"Suite 200","country":"Canada","city":"Winnipeg","province":"Manitoba","country_code":"CA","province_code":"MB","postal_code":"R3Y0L6","business_name":"Acme Inc.","phone_number":"8005550101"},"billing":{"id":"123","first_name":"John","last_name":"Doe","address_line_1":"50 Fultz Blvd","address_line_2":"Suite 200","country":"Canada","city":"Winnipeg","province":"Manitoba","country_code":"CA","province_code":"MB","postal_code":"R3Y0L6","business_name":"Acme Inc.","phone_number":"8005550101"}},"line_items":[{"product_data":{"id":"724bca","product_title":"Oak Cheese Grater","title":"Small","image_url":"http://shop.images/oakcheesegrater","properties":{"colour":"red","size":"small"},"description":"A handmade oak cheese grater to elevate your cheese-eating experience.","quantity":2,"price":2350,"total_price":4700,"visible":1,"line_item_key":"oak_cheese_grater_2643","barcode":"1234ABC","compare_at_price":4000,"weight":1000,"weight_unit":"g","product_id":"oak-cheese-grater","variant_id":"oak-cheese-grater-small","requires_shipping":true,"sku":"OAK_GRATER_SM","taxable":true,"tags":"Kitchen, Cheese Board, Oak","vendor":"Cheese Boards Unlimited","total_weight":2000}},{"taxes":[{"value":1000,"name":"GST","is_included":true}]},{"fees":[{"amount":500,"name":"Miscellaneous fee."}]},{"discounts":[{"code":"SUMMER5","text":"Summer discount code","value":500,"source":"coupon"}]},{"fulfilled_quantity":2}],"fees":[{"id":"123456789","line_text":"Custom Fee \u2014 Added by Plugin","fee_type":"fixed","value":10,"source":"PLUGIN","plugin_uuid":"a52589f8-09df-11ed-b30e-f67072e164ee","taxable":true,"show_description":true}],"taxes":[{"value":1000,"name":"GST","is_included":true}],"discounts":[{"code":"SUMMER5","text":"Summer discount code","value":500,"source":"coupon"}],"payments":[{"gateway_public_id":"i7z2xT0sKrDvhGWzex5SLjf5e6ndlQfrRL4AROkfhf3vNBkVT38JKBy5PSjB63qW","amount":4700,"currency":"CAD","type":"spreedly","display_string":"Credit Card Payment","id":"","token":"7uZAMRAf80KiEwibsrrM5IB41yU","retain":false}],"order_total":4700,"order_meta_data":{"cart_parameters":{"key":"cp-key1,","property1":"A cart param.","property2":"A cart param."},"note_attributes":{"key":"na-key1","property1":"A note attribute.","property2":"A note attribute."},"notes":"A special delivery note.","tags":["order-1"]},"shipping":{"selected_shipping":{"id":"0","description":"Custom weight-based rate: tier 2","amount":450,"code":"EXPID"},"available_shipping_lines":[{"id":"string,","line":{"id":"0","description":"Custom weight-based rate: tier 2","amount":450,"code":"EXPID"}}],"taxes":[{"value":1000,"name":"GST","is_included":true}],"discounts":[{"code":"SUMMER5","text":"Summer discount code","value":500,"source":"coupon"}]},"resumable_link":"string","flow_id":"external-company-one-page-template","currency":{"iso_code":"CAD","iso_numeric_code":124,"symbol":"$","format":"${{amount}}","has_decimal":true,"show_iso_code":true},"created_via":"My_Order_Creating_Plugin","is_processed":false,"order_id":79047599,"platform_order_id":"1389wjfalsdf9y4r"}}}}}}}},"plugin-redoc-3":{"url":"/api/platform-connector.openapi.yaml","themeId":"theme-redoc","isSpecFile":true,"spec":{"openapi":"3.0.0","info":{"title":"Platform Connector API Specification","description":"The Platform Connector API allows Bold to interact with your platform\'s customers, orders, and products.\\n\\nThis specification file defines the expected server behavior of the Platform Connector Server. Bold applications require the endpoints listed here to be implemented in order to function properly.\\n\\nRefer to the changelog for the latest updates to this API.\\n\\n> **Note:** This specification is only for use with a [Bold Platform Connector](/guides/platform-connector).","termsOfService":"https://boldcommerce.com/terms-of-service","contact":{"name":"Contact Us","url":"https://developer-dashboard.boldcommerce.com/default/contactus"},"version":"1.0.0"},"servers":[{"url":"https://your-platform-connector.example"}],"security":[{"HMAC":[]}],"tags":[{"name":"Verification","description":"Use these endpoints to verify your platform connector destination."},{"name":"Customers","description":"Contains information about a customer, including name, contact info, and addresses. Bold calls these endpoints to manage customers on your platform."},{"name":"Addresses","description":"A child of the Customer resource. Contains information about a billing or shipping address associated with a given customer. Bold calls these endpoints to manage addresses on your platform."},{"name":"Orders","description":"Contains information about an order, including addresses, line items, payments, and additional order details. Bold calls these endpoints to manage orders on your platform."},{"name":"Products","description":"Contains information about a product, including names, descriptions, applicable options and variants, and other details. Bold calls these endpoints to retrieve information about the products on your platform."},{"name":"Categories","description":"Contains information about product categories, including names, image, and platform information. Bold calls these endpoints to retrieve information about the categories on your platform."}],"externalDocs":{"description":"For more information about Platform Connectors, refer to the Overview.","url":"https://developer.boldcommerce.com/guides/platform-connector"},"paths":{"/v1/shops/{shop_identifier}/verification":{"parameters":[{"$ref":"#/components/parameters/shopIdentifier"},{"$ref":"#/components/parameters/timestamp"},{"$ref":"#/components/parameters/userAgent"}],"get":{"tags":["Verification"],"summary":"Verify Platform Connector Destination","operationId":"VerifyPlatformConnectorDestination","description":"Confirms that you own a given Platform Connector destination. Bold calls this endpoint on your Platform Connector when you attempt to [Create](/api/platform-connector-destinations#operation/CreateDestination) or [Update](/api/platform-connector-destinations#operation/UpdateDestination) a destination.\\n\\nResponds with a calculated X-HMAC header containing the content of the sent X-HMAC-Timestamp header encoded with the shared secret.","responses":{"200":{"description":"Response indicating successful calculation of the included X-HMAC header.","headers":{"X-HMAC":{"schema":{"type":"string"},"description":"An HMAC signature calculated from the current shared secret (created in the Bold Account Center) and the value of the X-HMAC-Timestamp header. Bold verifies this signature before registering your platform connector destinations.\\nFor more information about verifying this signature, refer to [Implement Platform Connector APIs](/guides/platform-connector/create-server#verify-the-signature)."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/verifyPlatformConnectorDestinationBody"}}}}}}},"/v1/shops/{shop_identifier}/customers":{"parameters":[{"$ref":"#/components/parameters/shopIdentifier"},{"$ref":"#/components/parameters/timestamp"},{"$ref":"#/components/parameters/userAgent"}],"post":{"tags":["Customers"],"summary":"Create Customer","operationId":"CreateCustomer","description":"Create a customer in your platform.\\n\\nThe request body contains a complete customer entity, you must persistently store on your platform.\\n\\nA successful response contains the same customer, with its associated `platform_id` and timestamps populated. The `platform_id` is unique, because Bold applications use it to identify the customer and its fields. The returned `platform_id` can be used in requests to other endpoints in this API.","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/createCustomerRequestBody"}}},"required":true},"responses":{"201":{"description":"Returned upon successful creation of the customer.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/customerResponseBody"}}}},"500":{"description":"An unexpected error occurred.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/runtimeErrorCustomer"},"examples":{"internalError":{"$ref":"#/components/examples/internalError"}}}}}}},"get":{"tags":["Customers"],"summary":"List Customers","operationId":"ListCustomers","description":"List customers that have made a purchase from your store. Include the `email` parameter to retrieve a certain customer.\\n\\nReturns a page of customers for your store, with `limit` as the maximum number of results and paginated by `cursor`. Return customers in ascending order of `platform_id`. If the request does not supply a limit (or supplies an invalid one), then use the default limit (250). \\n\\nEach `cursor` points to a location in the dataset. Cursors can be supplied to subsequent calls for additional data in the dataset. If no `cursor` is applied, return the first page of results.","parameters":[{"$ref":"#/components/parameters/limit"},{"$ref":"#/components/parameters/cursor"},{"name":"email","in":"query","description":"An email used to filter the results.","schema":{"type":"string"},"example":"john.doe@example.com"}],"responses":{"200":{"description":"Response containing a list of customers when a successful request is made.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/listCustomersResponseBody"}}}},"500":{"description":"An unexpected error occurred.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/runtimeErrorCustomer"},"examples":{"internalError":{"$ref":"#/components/examples/internalError"}}}}}}}},"/v1/shops/{shop_identifier}/customers/{platform_id}":{"parameters":[{"$ref":"#/components/parameters/shopIdentifier"},{"$ref":"#/components/parameters/customerId"},{"$ref":"#/components/parameters/timestamp"},{"$ref":"#/components/parameters/userAgent"}],"patch":{"tags":["Customers"],"summary":"Update Customer","operationId":"UpdateCustomer","description":"Update a customer specified by `platform_id`.\\n\\nReplace all fields of the customer object with the values provided in the request body. Ignore and do not update any fields omitted from the request body.","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/updateCustomerRequestBody"}}},"required":true},"responses":{"200":{"description":"A successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/customerResponseBody"}}}},"404":{"description":"The customer specified by `platform_id` was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/runtimeErrorCustomer"},"examples":{"customerNotFound":{"$ref":"#/components/examples/customerNotFound"}}}}},"500":{"description":"An unexpected error occurred.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/runtimeErrorCustomer"},"examples":{"internalError":{"$ref":"#/components/examples/internalError"}}}}}}},"delete":{"tags":["Customers"],"summary":"Delete Customer","operationId":"DeleteCustomer","description":"Delete a customer specified by `platform_id`. Mark the customer as deleted within the platform.","responses":{"204":{"description":"Returned upon successful deletion of the customer.","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"The customer specified by `platform_id` was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/runtimeErrorCustomer"},"examples":{"customerNotFound":{"$ref":"#/components/examples/customerNotFound"}}}}},"500":{"description":"An unexpected error occurred.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/runtimeErrorCustomer"},"examples":{"internalError":{"$ref":"#/components/examples/internalError"}}}}}}}},"/v1/shops/{shop_identifier}/customers/{platform_id}/validate":{"parameters":[{"$ref":"#/components/parameters/shopIdentifier"},{"$ref":"#/components/parameters/customerId"},{"$ref":"#/components/parameters/timestamp"},{"$ref":"#/components/parameters/userAgent"}],"post":{"tags":["Customers"],"summary":"Validate Customer JWT","operationId":"ValidateCustomerJWT","description":"Validate the JWT to determine if it is a valid token and corresponds to the provided customer. The JWT is used to authorize the frontend code to perform various actions on behalf of the customer. For more information, refer to the [Initialize Order](orders#tag/Orders/operation/InitializeOrder) endpoint.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/customerValidateRequestBody"}}}},"responses":{"200":{"description":"Token information.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/customerValidateResponseBody"}}}},"404":{"description":"The customer specified by `platform_id` was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/runtimeErrorCustomer"},"examples":{"customerNotFound":{"$ref":"#/components/examples/customerNotFound"}}}}},"500":{"description":"An unexpected error occurred.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/runtimeErrorCustomer"},"examples":{"internalError":{"$ref":"#/components/examples/internalError"}}}}}}}},"/v1/shops/{shop_identifier}/customers/{platform_customer_id}/addresses":{"parameters":[{"$ref":"#/components/parameters/shopIdentifier"},{"$ref":"#/components/parameters/platformCustomerId"},{"$ref":"#/components/parameters/timestamp"},{"$ref":"#/components/parameters/userAgent"}],"post":{"tags":["Addresses"],"summary":"Create Address","operationId":"CreateAddress","description":"Create an address for a customer, specified by `platform_customer_id`.\\n\\nThe request body contains a complete address entity, which you must persistently store on the platform. A successful response contains the same address, including its associated `platform_id` and `platform_customer_id`. These IDs must be unique among addresses, because Bold applications use them to identify the address for the customer. Bold can use the returned `platform_id` to make requests to other address endpoints in this API.","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/createAddressRequestBody"}}},"required":true},"responses":{"201":{"description":"Returned upon successful creation of the address.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/addressResponseBody"}}}},"404":{"description":"The customer specified by `platform_customer_id` was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/runtimeErrorCustomer"},"examples":{"customerNotFound":{"$ref":"#/components/examples/customerNotFound"}}}}},"500":{"description":"An unexpected error occurred.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/runtimeErrorCustomer"},"examples":{"internalError":{"$ref":"#/components/examples/internalError"}}}}}}},"patch":{"tags":["Addresses"],"summary":"Update Address","operationId":"UpdateAddress","description":"Update an address. Bold indicates the address by the `platform_id` and the customer by the `platform_customer_id`.\\n\\nReplace all fields of an address object with the values provided in the request body. Ignore and do not change any fields omitted from the request body.","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/updateAddressRequestBody"}}},"required":true},"responses":{"200":{"description":"A successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/addressResponseBody"}}}},"404":{"description":"The customer specified by `platform_customer_id` or the address specified by `platform_id` was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/runtimeErrorCustomer"},"examples":{"customerNotFound":{"$ref":"#/components/examples/customerNotFound"},"addressNotFound":{"$ref":"#/components/examples/addressNotFound"}}}}},"500":{"description":"An unexpected error occurred.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/runtimeErrorCustomer"},"examples":{"internalError":{"$ref":"#/components/examples/internalError"}}}}}}}},"/v1/shops/{shop_identifier}/customers/{platform_customer_id}/addresses/{platform_id}":{"parameters":[{"$ref":"#/components/parameters/shopIdentifier"},{"$ref":"#/components/parameters/platformCustomerId"},{"$ref":"#/components/parameters/addressId"},{"$ref":"#/components/parameters/timestamp"},{"$ref":"#/components/parameters/userAgent"}],"delete":{"tags":["Addresses"],"summary":"Delete Address","operationId":"DeleteAddress","description":"Delete an address. Bold indicates the address by the `platform_id` and the customer by the `platform_customer_id`. Mark the address as deleted on the platform.","responses":{"204":{"description":"Returned upon successful deletion of the address.","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"The customer specified by `platform_customer_id` or the address specified by `platform_id` was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/runtimeErrorCustomer"},"examples":{"customerNotFound":{"$ref":"#/components/examples/customerNotFound"},"addressNotFound":{"$ref":"#/components/examples/addressNotFound"}}}}},"500":{"description":"An unexpected error occurred.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/runtimeErrorCustomer"},"examples":{"internalError":{"$ref":"#/components/examples/internalError"}}}}}}}},"/v1/shops/{shop_identifier}/orders":{"parameters":[{"$ref":"#/components/parameters/shopIdentifier"},{"$ref":"#/components/parameters/timestamp"},{"$ref":"#/components/parameters/userAgent"}],"post":{"tags":["Orders"],"summary":"Create Order","operationId":"CreateOrder","description":"Create an order on the platform.\\n\\nThe request body contains a complete order entity, which you must persistently store on your platform.\\n\\nA successful response contains the same order, with its associated `platform_id` and timestamps populated. The `platform_id` is unique, because Bold applications use it to identify the order and its fields. Bold uses the returned `platform_id` to make requests to other endpoints in this API.","parameters":[{"$ref":"#/components/parameters/idempotencyKey"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/createOrderRequestBody"}}},"required":true},"responses":{"201":{"description":"Returned upon successful creation of the order.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/orderResponseBody"}}}},"500":{"description":"An unexpected error occurred.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/runtimeErrorOrder"},"examples":{"internalError":{"$ref":"#/components/examples/internalError"}}}}}}},"get":{"tags":["Orders"],"summary":"List Orders","operationId":"ListOrders","description":"List all orders made on a store.\\n\\nReturn a page of orders from your store, with `limit` as the maximum number of results and paginated by `cursor`. Return orders in ascending order of `platform_id`. If the request does not supply a limit (or supplies an invalid one), then use the default limit (250). \\n\\nEach `cursor` points to a location in the dataset. Cursors can be supplied to subsequent calls for additional data in the dataset. If no `cursor` is supplied, return the first page of results.","parameters":[{"$ref":"#/components/parameters/limit"},{"$ref":"#/components/parameters/cursor"}],"responses":{"200":{"description":"A successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/listOrdersResponseBody"}}}},"500":{"description":"An unexpected error occurred.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/runtimeErrorOrder"},"examples":{"internalError":{"$ref":"#/components/examples/internalError"}}}}}}}},"/v1/shops/{shop_identifier}/orders/{platform_id}":{"parameters":[{"$ref":"#/components/parameters/shopIdentifier"},{"$ref":"#/components/parameters/orderId"},{"$ref":"#/components/parameters/timestamp"},{"$ref":"#/components/parameters/userAgent"}],"get":{"tags":["Orders"],"summary":"Get Order","operationId":"GetOrder","description":"Retrieve an order placed on your store by the specified `platform_id`.","responses":{"200":{"description":"Response containing the specified order.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/orderResponseBody"}}}},"404":{"description":"The order specified by `platform_id` was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/runtimeErrorOrder"},"examples":{"orderNotFound":{"$ref":"#/components/examples/orderNotFound"}}}}},"500":{"description":"An unexpected error occurred.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/runtimeErrorOrder"},"examples":{"internalError":{"$ref":"#/components/examples/internalError"}}}}}}},"patch":{"tags":["Orders"],"summary":"Update Order","operationId":"UpdateOrder","description":"Update an order specified by `platform_id`.\\n\\nReplace all fields of the order object with the values provided in the request body. Ignore and do not update any fields omitted from the request body.","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/updateOrderRequestBody"}}},"required":true},"responses":{"200":{"description":"A successful response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/orderResponseBody"}}}},"404":{"description":"The order specified by `platform_id` was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/runtimeErrorOrder"},"examples":{"orderNotFound":{"$ref":"#/components/examples/orderNotFound"}}}}},"500":{"description":"An unexpected error occurred.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/runtimeErrorOrder"},"examples":{"internalError":{"$ref":"#/components/examples/internalError"}}}}}}}},"/v1/shops/{shop_identifier}/orders/{platform_id}/payments":{"parameters":[{"$ref":"#/components/parameters/shopIdentifier"},{"$ref":"#/components/parameters/orderId"},{"$ref":"#/components/parameters/timestamp"},{"$ref":"#/components/parameters/userAgent"}],"post":{"tags":["Orders"],"summary":"Create Payment","operationId":"CreatePayment","description":"Create a payment associated with a given order.\\n\\nThe request body contains a complete order entity, which you must persistently store on your platform.\\n\\nA successful response contains the same payment, with its associated `platform_id` and timestamps populated. The `platform_id` must be unique, because Bold applications use it to identify the payment and its fields. The returned `platform_id` can be used in requests to other endpoints in this API.","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/createPaymentRequestBody"}}},"required":true},"responses":{"201":{"description":"Returned upon successful creation of the payment.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/paymentResponseBody"}}}},"404":{"description":"The order specified by `platform_id` was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/runtimeErrorOrder"},"examples":{"orderNotFound":{"$ref":"#/components/examples/orderNotFound"}}}}},"500":{"description":"An unexpected error occurred.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/runtimeErrorOrder"},"examples":{"internalError":{"$ref":"#/components/examples/internalError"}}}}}}}},"/v1/shops/{shop_identifier}/orders/{order_platform_id}/payments/{platform_id}":{"parameters":[{"$ref":"#/components/parameters/shopIdentifier"},{"$ref":"#/components/parameters/orderPlatformId"},{"$ref":"#/components/parameters/paymentId"},{"$ref":"#/components/parameters/timestamp"},{"$ref":"#/components/parameters/userAgent"}],"patch":{"tags":["Orders"],"summary":"Update Payment","operationId":"UpdatePayment","description":"Update a payment associated with a specific order. Specify the payment by `platform_id` and the order by `order_platform_id`.\\n\\nReplace all fields of the payment object with the values provided in the request body. Ignore and do not update any fields omitted from the request body.","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/updatePaymentRequestBody"}}},"required":true},"responses":{"200":{"description":"Returned upon successful updating of the payment.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/paymentResponseBody"}}}},"404":{"description":"The payment specified by `platform_id` was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/runtimeErrorOrder"},"examples":{"orderNotFound":{"$ref":"#/components/examples/orderNotFound"},"paymentNotFound":{"$ref":"#/components/examples/paymentNotFound"}}}}},"500":{"description":"An unexpected error occurred.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/runtimeErrorOrder"},"examples":{"internalError":{"$ref":"#/components/examples/internalError"}}}}}}}},"/v1/shops/{shop_identifier}/products":{"parameters":[{"$ref":"#/components/parameters/shopIdentifier"},{"$ref":"#/components/parameters/userAgent"},{"$ref":"#/components/parameters/timestamp"},{"$ref":"#/components/parameters/limit"},{"$ref":"#/components/parameters/cursor"}],"get":{"tags":["Products"],"summary":"List Products","operationId":"ListProducts","description":"List all products that exist in your store.\\n\\nReturn a page of products for your store, with `limit` as the maximum number of results and paginated by `cursor`. Return products in ascending order of `platform_id`. If the request does not supply a limit (or supplies an invalid one), use the default limit (250).\\n\\nEach `cursor` points to a location in the dataset. Cursors can be supplied to subsequent calls for additional data in the dataset. If no `cursor` is supplied, return the first page of results.","responses":{"200":{"description":"Response containing a list of products when a successful request is made.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/listProductsResponseBody"}}}},"500":{"description":"An unexpected error occurred.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/runtimeErrorProduct"}}}}}}},"/v1/shops/{shop_identifier}/categories":{"parameters":[{"$ref":"#/components/parameters/shopIdentifier"},{"$ref":"#/components/parameters/userAgent"},{"$ref":"#/components/parameters/timestamp"},{"$ref":"#/components/parameters/limit"},{"$ref":"#/components/parameters/cursor"}],"get":{"tags":["Categories"],"summary":"List Categories","operationId":"ListCategories","description":"Lists all product categories in a given store.\\n\\nReturn a page of product categories for your store, with `limit` as the maximum number of results and paginated by `cursor`. Return categories in ascending order of `platform_id`. If the request does not supply a limit (or supplies an invalid one), use the default limit (250).\\n\\nEach cursor points to a location in the dataset. Cursors can be supplied to subsequent calls for additional data in the dataset. If no `cursor` is supplied, return the first page of results.","responses":{"200":{"description":"Response containing a list of categories when a successful request is made.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/listCategoriesResponseBody"}}}},"500":{"description":"An unexpected error occurred.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/runtimeErrorProduct"}}}}}}}},"components":{"securitySchemes":{"HMAC":{"type":"apiKey","name":"X-HMAC","in":"header","description":"An HMAC signature calculated from the current shared secret (created in Bold Account Center) and the value of the X-HMAC-Timestamp header.\\n\\nFor more information about verifying this signature, refer to [Implement Platform Connector APIs](/guides/platform-connector/create-server#verify-the-signature)."}},"schemas":{"verifyPlatformConnectorDestinationBody":{"type":"object"},"customer":{"type":"object","allOf":[{"$ref":"#/components/schemas/customerBase"}],"properties":{"addresses":{"description":"A list of customer addresses.","type":"array","items":{"$ref":"#/components/schemas/customerAddress"}},"platform_created_at":{"description":"The date (in [RFC 3339 format](https://datatracker.ietf.org/doc/html/rfc3339)) that this customer was created on the platform. Assigned by the platform.","type":"string","format":"date-time","example":"2021-03-11T17:16:51Z"},"platform_updated_at":{"description":"The date this customer was last modified on the platform, (in [RFC 3339 format](https://datatracker.ietf.org/doc/html/rfc3339)). Assigned by the platform.","type":"string","format":"date-time","example":"2021-03-11T17:16:51Z"},"platform_id":{"description":"A unique identifier for the customer. Assigned by the platform.","type":"string","example":"customer-123456"}}},"customerBase":{"type":"object","properties":{"email":{"description":"The email address for the customer.","type":"string","format":"email","example":"john.doe@example.com"},"first_name":{"description":"The first name of the customer.","type":"string","example":"John"},"last_name":{"description":"The last name of the customer.","type":"string","example":"Doe"},"phone":{"description":"The phone number for the customer.","type":"string","format":"phone","example":"555-555-5555"}}},"customerNew":{"type":"object","allOf":[{"$ref":"#/components/schemas/customerBase"},{"required":["email"],"properties":{"addresses":{"description":"A list of customer addresses.","type":"array","items":{"$ref":"#/components/schemas/addressNew"}}}}]},"customerUpdate":{"type":"object","allOf":[{"$ref":"#/components/schemas/customerBase"}],"properties":{"addresses":{"description":"A list of customer addresses.","type":"array","items":{"$ref":"#/components/schemas/addressNew"}}}},"address":{"type":"object","allOf":[{"$ref":"#/components/schemas/addressBaseOrder"}],"properties":{"platform_id":{"description":"Unique identifier for the address. Assigned by the platform.","type":"string","example":"address-123456"},"platform_customer_id":{"description":"Unique identifier for the customer. Assigned by the platform.","type":"string","example":"customer-123456"}}},"addressBaseCustomer":{"type":"object","properties":{"address_type":{"description":"The type of the address (i.e., residential, commercial).","type":"string","example":"commercial"},"address_use":{"description":"The usage of the address. Possible values are `\\"billing\\"` or `\\"shipping\\"`.","type":"string","enum":["billing","shipping"],"example":"billing"},"company":{"description":"The name of the company operating at the specified address, if applicable.","type":"string","example":"Acme Corp."},"city":{"description":"The name of the city associated with the address.","type":"string","example":"Winnipeg"},"country":{"description":"The name of the country associated with the address.","type":"string","example":"Canada"},"country_code":{"description":"The country code (in [ISO 3166-1 alpha-2 format](https://www.iso.org/iso-3166-country-codes.html)) of the address.","type":"string","example":"CA"},"is_default":{"description":"Indicates whether this is the default address for the customer. There can only be one default address for a customer. If this modifies any other resources, ensure the [appropriate event notifications](platform-event-notifications#tag/Customer-Event-Notifications/operation/CustomerSavedEventNotification) are triggered for those affected by this change.","type":"boolean","format":"boolean","example":true},"first_name":{"description":"The first name of the customer with the address.","type":"string","example":"John"},"last_name":{"description":"The last name of the customer with the address.","type":"string","example":"Doe"},"phone":{"description":"The phone number of the address.","type":"string","format":"phone","example":"555-555-5555"},"postal_code":{"description":"The postal code or zip code for the address.","type":"string","example":"H0H 0H0"},"province":{"description":"The province or state for the address.","type":"string","example":"Manitoba"},"province_code":{"description":"The province or state abbreviation for the address.","type":"string","example":"MB"},"street_1":{"description":"The primary street information for the address.","type":"string","example":"123 North Road"},"street_2":{"description":"Any additional street information for the address.","type":"string","example":""}}},"addressNew":{"type":"object","allOf":[{"$ref":"#/components/schemas/addressBaseCustomer"}]},"customerAddress":{"type":"object","allOf":[{"$ref":"#/components/schemas/addressBaseCustomer"}],"properties":{"platform_id":{"description":"A unique identifier for the address. Assigned by the platform.","type":"string","example":"address-123456"}}},"createCustomerRequestBody":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/createCustomerRequestData"}}},"createCustomerRequestData":{"type":"object","properties":{"customer":{"$ref":"#/components/schemas/customerNew"}}},"updateCustomerRequestBody":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/updateCustomerRequestData"}}},"updateCustomerRequestData":{"type":"object","properties":{"customer":{"$ref":"#/components/schemas/customerUpdate"}}},"customerResponseBody":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/customerResponseData"}}},"customerResponseData":{"type":"object","properties":{"customer":{"$ref":"#/components/schemas/customer"}}},"createAddressRequestBody":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/createAddressRequestData"}}},"createAddressRequestData":{"type":"object","properties":{"address":{"$ref":"#/components/schemas/addressNew"}}},"updateAddressRequestBody":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/updateAddressRequestData"}}},"updateAddressRequestData":{"type":"object","properties":{"address":{"$ref":"#/components/schemas/addressNew"}}},"addressResponseBody":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/addressResponseData"}}},"addressResponseData":{"type":"object","properties":{"address":{"$ref":"#/components/schemas/address"}}},"runtimeErrorCustomer":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","description":"A code used to identify the error."},"message":{"type":"string","description":"A long description of the error."},"type":{"type":"string","description":"A short description of the error."}}}}}},"customerValidateRequestBody":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/customerValidateRequestData"}}},"customerValidateRequestData":{"type":"object","properties":{"token_info":{"$ref":"#/components/schemas/tokenInfo"}}},"tokenInfo":{"type":"object","required":["token"],"properties":{"token":{"type":"string","description":"The token to inspect.","example":"98qf34jwe0rwfhjqop4wa98af"}}},"customerValidateResponseBody":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/customerValidateResponseData"}}},"customerValidateResponseData":{"type":"object","properties":{"token_status":{"$ref":"#/components/schemas/tokenStatus"}}},"listCustomersResponseBody":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/listCustomersResponseData"},"pagination":{"$ref":"#/components/schemas/paginationResponse"}}},"listCustomersResponseData":{"type":"object","properties":{"customers":{"type":"array","items":{"$ref":"#/components/schemas/customer"}}}},"tokenStatus":{"type":"object","required":["active"],"properties":{"active":{"type":"boolean","description":"Indicates whether the presented token is active and belongs to the provided `customer_platform_id`."}}},"createOrderRequestBody":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/createOrderRequestData"}}},"createOrderRequestData":{"type":"object","properties":{"order":{"$ref":"#/components/schemas/orderRequest"}}},"updateOrderRequestBody":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/updateOrderRequestData"}}},"updateOrderRequestData":{"type":"object","properties":{"order":{"$ref":"#/components/schemas/orderUpdateRequest"}}},"createPaymentRequestBody":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/createPaymentRequestData"}}},"createPaymentRequestData":{"type":"object","properties":{"payment":{"$ref":"#/components/schemas/paymentRequest"}}},"updatePaymentRequestBody":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/updatePaymentRequestData"}}},"updatePaymentRequestData":{"type":"object","properties":{"payment":{"$ref":"#/components/schemas/updatePaymentRequest"}}},"orderResponseBody":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/orderResponseData"}}},"orderResponseData":{"type":"object","properties":{"order":{"$ref":"#/components/schemas/order"}}},"listOrdersResponseBody":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/listOrdersResponseData"},"pagination":{"$ref":"#/components/schemas/paginationResponse"}}},"listOrdersResponseData":{"type":"object","properties":{"orders":{"type":"array","items":{"$ref":"#/components/schemas/order"}}}},"paymentResponseBody":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/paymentResponseData"}}},"paymentResponseData":{"type":"object","properties":{"payment":{"$ref":"#/components/schemas/payment"}}},"orderRequest":{"type":"object","allOf":[{"$ref":"#/components/schemas/orderBase"}],"properties":{"shipping_addresses":{"description":"A list of shipping addresses for the order.","type":"array","items":{"$ref":"#/components/schemas/addressRequest"}},"billing_address":{"description":"The billing address for the order.","allOf":[{"$ref":"#/components/schemas/addressRequest"}]},"line_items":{"description":"A list of line items for the order.","type":"array","items":{"$ref":"#/components/schemas/lineItemRequest"}},"payments":{"description":"A list of payments for this order.","type":"array","items":{"$ref":"#/components/schemas/paymentRequest"}}}},"orderUpdateRequest":{"type":"object","properties":{"fulfillment_status":{"description":"The fulfillment status of each line item on the order.","type":"string","enum":["pending","partial","delivered","fulfilled"],"example":"partial"},"financial_status":{"description":"The status of payments associated with the order. This field can only be set when the order is created and cannot be changed if the order is updated.","type":"string","enum":["held_for_review","disputed","cancelled","pending","preauthed","refunded","partially_paid","partially_refunded","paid"],"example":"pending"},"refunded_amount":{"description":"The total refunded amount, if any, applied to the order. Measured in units of the order currency.","type":"string","format":"double","example":"0"},"notes":{"description":"Any internal notes about the order.","type":"string","example":"Handle with care."},"custom_attributes":{"description":"A series of key-value pairs of additional metadata relevant to the order.","type":"object","additionalProperties":{"$ref":"#/components/schemas/customAttribute"}},"shipping_addresses":{"description":"List of shipping addresses for the order.","type":"array","items":{"$ref":"#/components/schemas/addressRequest"}},"subtotal":{"description":"The subtotal of the line items on the order, in the order\'s given currency.\\n\\n**Note:** Calculate the subtotal before taxes and discounts (if those values are not included in the line item prices).\\n","type":"string","format":"double"},"subtotal_tax":{"description":"The tax to be charged on all line items, in the order\'s given currency.","type":"string","format":"double","example":"0.7"}}},"order":{"type":"object","allOf":[{"$ref":"#/components/schemas/orderBase"}],"properties":{"platform_id":{"description":"A unique identifier for the order. Assigned by the platform.","type":"string","example":"order-123456"},"platform_updated_at":{"description":"The date this order was last modified on the platform, in [RFC 3339 format](https://datatracker.ietf.org/doc/html/rfc3339). Assigned by the platform.","type":"string","format":"date-time","example":"2019-08-24T14:15:22Z"},"shipping_addresses":{"description":"A list of shipping addresses for the order.","type":"array","items":{"$ref":"#/components/schemas/addressOrder"}},"billing_address":{"description":"The billing address for the order.","allOf":[{"$ref":"#/components/schemas/addressOrder"}]},"line_items":{"description":"A list of line items included in the order.","type":"array","items":{"$ref":"#/components/schemas/lineItem"}},"payments":{"description":"A list of payments for the order.","type":"array","items":{"$ref":"#/components/schemas/payment"}},"placed_at":{"description":"The date this order was placed on the platform, in [RFC 3339 format](https://datatracker.ietf.org/doc/html/rfc3339). Assigned by the platform.","type":"string","format":"date-time","example":"2019-08-24T14:15:22Z"}},"required":["total","total_tax","subtotal","subtotal_tax","shipping_subtotal","shipping_tax"]},"orderBase":{"type":"object","properties":{"order_number":{"description":"A human-readable identifier for the order.","type":"string","example":"ORDER_XXYY1122"},"platform_customer_id":{"description":"A unique identifier for the customer associated to this order. Assigned by the platform.","type":"string","example":"customer-123456"},"platform_friendly_id":{"description":"A unique identifier for the order on the platform. This field is used to identify the order on the platform and is used by the Bold Checkout Admin to link the order to the platform.","type":"string","example":"PT-0065"},"shipping_method":{"description":"The shipping method for the order.","type":"string","example":"freight"},"shipping_code":{"description":"The shipping method code for the order. Each store defines its own shipping codes.","type":"string","example":"S001"},"browser_ip":{"description":"The browser IP under which the order was placed by the customer.","type":"string","example":"127.0.0.1"},"source":{"description":"A label noting the mechanism which placed this order.","type":"string","example":"POS"},"created_via":{"description":"A label noting which app created the order (if applicable).","type":"string","example":"Bold Checkout"},"locale":{"description":"The locale code of the order (either in [ISO-639 language code format](https://www.iso.org/iso-639-language-codes.html) or in [ISO/IEC-15897 regional language format](https://www.iso.org/standard/50707.html)).","type":"string","example":"en_US"},"test":{"description":"Indicates whether this is a test order.","type":"boolean","example":false},"notes":{"description":"Any internal notes about the order.","type":"string","example":"High priority"},"public_notes":{"description":"Any customer-facing notes about the order.","type":"string","example":"Handle with care."},"custom_attributes":{"description":"Any key-value pairs of metadata relevant to the order.","type":"object","additionalProperties":{"$ref":"#/components/schemas/customAttribute"}},"shipping_subtotal":{"description":"The shipping cost for the ordered items, in the order\'s given currency. Calculated before taxes.","type":"string","format":"double","example":"5.00"},"shipping_tax":{"description":"The sum of all shipping taxes for the ordered items, in the order\'s given currency.","type":"string","format":"double","example":"1.00"},"shipping_taxes":{"description":"A list of individual shipping taxes for each line item on the order.","type":"array","items":{"$ref":"#/components/schemas/tax"}},"discount":{"description":"The total amount discounted from the order, in the order\'s given currency. If there is no discount, set this field to `\\"0\\"`.\\n\\n**Note:** If `discount` is included in the payload, the `total` and `total_tax` values are required.","type":"string","format":"double","example":"0"},"discounts":{"description":"The list of discounts applied to the order.","type":"object","additionalProperties":{"$ref":"#/components/schemas/orderDiscount"}},"subtotal":{"description":"The subtotal of the line items on the order, in the order\'s given currency.\\n\\n**Note:** Calculate the subtotal before taxes and discounts (if those values are not included in the line item prices).","type":"string","format":"double","example":"10.00"},"subtotal_tax":{"description":"The tax to be charged on all line items, in the order\'s given currency.","type":"string","format":"double","example":"0.7"},"total_tax":{"description":"The total tax on the full order, in the order\'s given currency, including: `subtotal_tax`, `shipping_tax`, and any other special taxes pending for the order.","type":"string","format":"double","example":"0.7"},"total":{"description":"The total order cost, in the order\'s given currency.\\n\\n**Note:** This number includes taxes and is reduced by the discount.","type":"string","format":"double","example":"16.07"},"refunded_amount":{"description":"The refunded amount of the order, if any, in the order\'s given currency.","type":"string","format":"double","example":"0"},"currency":{"description":"The base currency used for the order (in [ISO-4217 currency code format](https://www.iso.org/iso-4217-currency-codes.html)).","type":"string","example":"CAD"},"order_status":{"description":"The current status of the order. Indicates whether the order is `active` or has been `cancelled`.","type":"string","enum":["active","cancelled"],"example":"active"},"fulfillment_status":{"description":"The fulfillment status of the order.","type":"string","enum":["pending","partial","delivered","fulfilled"],"example":"fulfilled"},"financial_status":{"description":"The status of payments associated with the order. This field can only be set when the order is created and cannot be changed if the order is updated.","type":"string","enum":["held_for_review","disputed","cancelled","pending","preauthed","refunded","partially_paid","partially_refunded","paid"],"example":"pending"}}},"lineItem":{"type":"object","allOf":[{"$ref":"#/components/schemas/lineItemBase"}],"properties":{"platform_id":{"description":"Unique identifier for the line item. Assigned by the platform.","type":"string","example":"line-item-123456"}}},"lineItemRequest":{"type":"object","allOf":[{"$ref":"#/components/schemas/lineItemBase"}]},"lineItemBase":{"type":"object","properties":{"platform_product_id":{"description":"Unique identifier for the product referenced in this line item. Assigned by the platform.","type":"string","example":"product-123456"},"platform_variant_id":{"description":"Unique identifier for the variant referenced in this line item. Assigned by the platform.","type":"string","example":"variant-123456"},"cart_line_item_platform_id":{"description":"Unique identifier for the cart line item. Assigned by the platform.","type":"string","example":"cart-line-item-123456"},"custom_attributes":{"description":"Key-value pairs of metadata relevant to the line item.","type":"object","additionalProperties":{"$ref":"#/components/schemas/customAttribute"}},"title":{"description":"Title of the line item.","type":"string","example":"Shoes (long-laced classic)"},"sku":{"description":"SKU of the line item.","type":"string"},"url":{"description":"Link to the line item in the store.","type":"string"},"image":{"description":"Image of the line item.","type":"string"},"quantity":{"description":"Quantity ordered for this line item.","type":"integer","format":"int64"},"grams":{"description":"Weight in grams of the line item.","type":"number","format":"double"},"weight":{"description":"Weight of the line item (measured in terms of `weight_unit`).","type":"number","format":"double"},"weight_unit":{"description":"Unit which weight is measured in.","type":"string"},"taxable":{"description":"Indicator of whether the line item is taxable.","type":"boolean"},"taxes":{"description":"List of taxes for the line item.","type":"array","items":{"$ref":"#/components/schemas/tax"}},"requires_shipping":{"description":"Indicator of whether the line item requires shipping.","type":"boolean"},"price_per_item":{"description":"Price per unit of the line item, in the order\'s given currency.\\n\\n**Note**: This price should be calculated before taxes and discounts (if taxes are not included in price).\\n","type":"string","format":"double"},"discount_per_item":{"description":"Discount of the line item, in the order\'s given currency.","type":"string","format":"double"},"total":{"description":"Grand total price of the line item, in the order\'s given currency.\\n\\n**Note**: This price includes taxes and discounts.\\n","type":"string","format":"double"},"subtotal":{"description":"Total price of the line item, measured in the order\'s currency.\\n\\n**Note**: This value is calculated using price multiplied by quantity, excluding tax.\\n","type":"string","format":"double"},"total_tax":{"description":"Total tax of the line item, in the order\'s given currency.","type":"string","format":"double","example":"0.7"},"discounted_subtotal":{"description":"Discounted total price of the line item, in the order\'s given currency.\\n\\n**Note**: This value is calculated using discounted price multiplied by quantity, excluding tax.\\n","type":"string","format":"double"}}},"tax":{"type":"object","properties":{"amount":{"description":"Total tax amount pending, measured in the order\'s given currency.","type":"string","format":"double","example":"0.7"},"name":{"description":"Human-readable name for this tax.","type":"string","example":"Provincial Sales Tax"},"rate":{"description":"Percent tax (value between 0 to 1)","type":"string","example":"0.07"},"tag":{"description":"Reference tag for the tax","type":"string","example":"PST"}}},"orderDiscount":{"type":"object","properties":{"platform_id":{"type":"string","description":"A unique identifier for the discount. Defined by the platform.","example":"discount-123456"},"amount":{"description":"The discounted amount applied to the order, measured in the order\'s given currency.","type":"string","format":"double","example":"5.00"},"discount_code":{"type":"string","description":"The code used to apply the discount.","example":"20OFF"}}},"paymentRequest":{"type":"object","allOf":[{"$ref":"#/components/schemas/paymentBase"}],"properties":{"transactions":{"description":"A list of transactions for the payment. Multiple transactions can be associated with a single payment","type":"array","items":{"$ref":"#/components/schemas/transactionRequest"}},"description":{"description":"A human-readable description of the payment.","type":"string","example":"credit_card"},"provider":{"description":"A label indicating the organization handling the payment and transactions.","type":"string","example":"stripe"},"payment_method":{"description":"The payment method used.","type":"string","example":"credit card"},"currency":{"description":"The currency used for the payment, in [ISO-4217 currency code format](https://www.iso.org/iso-4217-currency-codes.html).","type":"string","example":"CAD"},"amount_planned":{"description":"The amount that the payment provider plans to charge for the payment, in the payment\'s given currency. If the payment has been completed, this amount reflects the amount charged. This value typically matches the order `total`.","type":"string","format":"double","example":"16.07"},"custom_attributes":{"description":"A series of key-value pairs of metadata relevant to the payment.","type":"object","additionalProperties":{"$ref":"#/components/schemas/customAttribute"}}}},"updatePaymentRequest":{"type":"object","allOf":[{"$ref":"#/components/schemas/paymentBase"}],"properties":{"transactions":{"description":"A list of transactions for the payment.","type":"array","items":{"$ref":"#/components/schemas/transactionRequest"}}}},"payment":{"type":"object","allOf":[{"$ref":"#/components/schemas/paymentBase"}],"properties":{"platform_id":{"description":"A unique identifier for the payment. Assigned by the platform.","type":"string","example":"payment-123456"},"transactions":{"description":"A list of transactions for the payment.","type":"array","items":{"$ref":"#/components/schemas/transaction"}},"description":{"description":"A human-readable description of the payment.","type":"string","example":"Credit card payment"},"provider":{"description":"The organization handling the payment and transactions.","type":"string","example":"stripe"},"payment_method":{"description":"The payment method used.","type":"string","example":"credit card"},"currency":{"description":"The currency used for the payment, in [ISO-4217 currency code format](https://www.iso.org/iso-4217-currency-codes.html).","type":"string","example":"CAD"},"amount_planned":{"description":"The amount that the payment provider plans to charge for the payment, in the payment\'s given currency. If the payment has been completed, this amount reflects the amount charged. This value typically matches the order `total`.","type":"string","format":"double","example":"16.07"},"custom_attributes":{"description":"A series of key-value pairs of metadata relevant to the payment.","type":"object","additionalProperties":{"$ref":"#/components/schemas/customAttribute"}}}},"paymentBase":{"type":"object","properties":{"status":{"description":"The status of the payment. Values are dependent on the payment provider used and should be passed through as-is.","type":"string","example":"paid"}}},"transaction":{"type":"object","allOf":[{"$ref":"#/components/schemas/transactionBase"}],"properties":{"platform_id":{"description":"A unique identifier for the transaction. Assigned by the platform.","type":"string","example":"transaction-123456"}}},"transactionRequest":{"type":"object","allOf":[{"$ref":"#/components/schemas/transactionBase"}],"properties":{"platform_id":{"description":"A unique identifier for the transaction. Assigned by the platform.","type":"string","example":"transaction-123456"}}},"transactionBase":{"type":"object","properties":{"provider_transaction_id":{"description":"A unique identifier for the transaction. Assigned by the payment provider.","type":"string","example":"provider-transaction-123456"},"amount":{"description":"The amount captured in this transaction, in the transaction\'s given currency.\\n\\n**Note:** If the transaction is a refund, this amount is negative.","type":"string"},"currency":{"description":"The currency used for the transaction (in [ISO-4217 currency code format](https://www.iso.org/iso-4217-currency-codes.html)).","type":"string","example":"CAD"},"status":{"description":"The status of the transaction.","type":"string","enum":["initial","pending","failure","success"],"example":"pending"},"type":{"description":"The type of transaction.","type":"string","enum":["authorization","charge","refund"],"example":"charge"}}},"customAttribute":{"type":"object","properties":{"description":{"description":"The description of the attribute.","type":"string","example":"key-1"},"value":{"description":"The value of the attribute.","type":"string","example":"value-1"}}},"addressOrder":{"type":"object","allOf":[{"$ref":"#/components/schemas/addressBaseOrder"}],"properties":{"platform_id":{"description":"A unique identifier for the address. Assigned by the platform.","type":"string","example":"address-123456"}}},"addressRequest":{"type":"object","allOf":[{"$ref":"#/components/schemas/addressBaseOrder"}]},"addressBaseOrder":{"type":"object","properties":{"address_type":{"description":"The usage of the address. Possible values are `\\"billing\\"` or `\\"shipping\\"`.","type":"string","enum":["billing","shipping"],"example":"billing"},"first_name":{"description":"The addressee\'s first name.","type":"string","example":"John"},"last_name":{"description":"The addressee\'s last name.","type":"string","example":"Doe"},"street_1":{"description":"The primary street information.","type":"string","example":"123 North Road"},"street_2":{"description":"Any additional street information.","type":"string","example":"Suite 200"},"city":{"description":"The city name.","type":"string","example":"Winnipeg"},"province":{"description":"The name of the province or state.","type":"string","example":"Manitoba"},"country":{"description":"The country name.","type":"string","example":"Canada"},"country_code":{"description":"The country code of the address, in [ISO 3166-1 alpha-2 format](https://www.iso.org/iso-3166-country-codes.html).","type":"string","example":"CA"},"phone":{"description":"The phone number.","type":"string","example":"555-555-5555"},"postal_code":{"description":"The postal code or zip code.","type":"string","example":"H0H 0H0"},"email":{"description":"An email address.","type":"string","format":"email","example":"john.doe@example.com"},"province_code":{"description":"The province or state abbreviation.","type":"string","example":"MB"},"company":{"description":"The name of the company operating at the specified address, if applicable.","type":"string","example":"Acme Corp."}}},"runtimeErrorOrder":{"type":"object","properties":{"errors":{"type":"array","items":{"required":["code"],"type":"object","properties":{"code":{"type":"string","description":"The error code.","example":"09-1"},"message":{"type":"string","description":"A message describing the error.","example":"The order with the provided platform_id does not exist"},"type":{"type":"string","description":"The type of error.","example":"orders.does_not_exist"}}}}}},"product":{"type":"object","allOf":[{"$ref":"#/components/schemas/productBase"}],"properties":{"platform_id":{"type":"string","description":"A unique identifier for the product. Defined by the platform.","example":"product-123456"},"platform_updated_at":{"description":"The date the product was last updated on the platform.","type":"string","format":"date-time","example":"2021-03-11T17:16:51Z"},"categories":{"type":"array","description":"An array of product categories.","items":{"$ref":"#/components/schemas/category"}},"variants":{"type":"array","description":"An array of `variant` objects. At least one variant is required. If the product has no variants, the variant can reuse the product information.","items":{"$ref":"#/components/schemas/deepVariant"}},"options":{"type":"array","description":"An array of `option` objects. A more granular level of customization for variants. These are not required, but can be used to provide more options for your same variant.","items":{"$ref":"#/components/schemas/deepOption"}},"images":{"type":"array","description":"An array of images associated with the products.","items":{"$ref":"#/components/schemas/deepImage"}}}},"productBase":{"type":"object","properties":{"description":{"type":"string","description":"A description for the product.","example":"A hat for the beach"},"handle":{"type":"string","description":"A unique, human-readable string for the product.","example":"beach-hat"},"inventory_quantity":{"type":"integer","description":"The current inventory level of the product.","format":"int64","example":4},"inventory_tracking_entity":{"type":"string","description":"The entity on which inventory is tracked.","enum":["variant","product","none"],"example":"product"},"inventory_tracking_service":{"type":"string","description":"The service that tracks inventory.","example":"platform"},"localized_descriptions":{"type":"object","description":"A map of localized descriptions for the product. The field is the [ISO-639](https://www.iso.org/iso-639-language-codes.html) two character language code. The value is the product description in the given language.","additionalProperties":{"type":"string"},"example":{"en":"A hat for the beach","fr":"Un chapeau pour la plage"}},"localized_names":{"type":"object","description":"A map of localized names for the product. The field is the [ISO-639](https://www.iso.org/iso-639-language-codes.html) two character language code. The value is the product name in the given language.","additionalProperties":{"type":"string"},"example":{"en":"Beach Hat","fr":"Chapeau de Plage"}},"name":{"type":"string","description":"The name of the product.","example":"Beach hat"},"published":{"type":"boolean","format":"boolean","description":"Indicates whether the product is published on the storefront.","example":true},"tags":{"type":"string","description":"A string with comma separated values that describe the product.","example":"clothing, unisex, pants"},"tax_code":{"type":"string","description":"The tax code for the product.","example":"non-taxable"},"type":{"type":"string","description":"The product type. Used for searching.","example":"physical"},"url":{"type":"string","description":"The URL to the product on the storefront.","example":"/hats/beach-hat"},"vendor":{"type":"string","description":"The product vendor.","example":"OFS"}}},"listProductsResponseBody":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/listProductsResponseData"},"pagination":{"$ref":"#/components/schemas/paginationResponse"}}},"listProductsResponseData":{"type":"object","properties":{"products":{"type":"array","items":{"$ref":"#/components/schemas/product"}}}},"paginationResponse":{"type":"object","properties":{"next":{"type":"string","description":"A cursor to fetch the next page of results. Cursors have no requirements on how they are encoded, since they are opaque to the consumer.","example":"dGVzdGluZ3Rlc3Rpbmd0ZXN0aW5n"},"prev":{"type":"string","description":"A cursor to fetch the previous page of results. Cursors have no requirements on how they are encoded, since they are opaque to the consumer. Leave empty if there is no following dataset.","example":"dW50ZXN0dW50ZXN0dW50ZXN0"}}},"runtimeErrorProduct":{"type":"object","properties":{"errors":{"type":"array","items":{"required":["code"],"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"type":{"type":"string"}},"example":{"code":"07-1","message":"Request failed due to an internal server error.","type":"server.internal_error"}}}}},"deepVariant":{"type":"object","allOf":[{"$ref":"#/components/schemas/variantBase"}],"properties":{"platform_id":{"type":"string","description":"A unique identifier for the variant. Defined by the platform.","example":"variant-123456"},"option_values":{"type":"array","items":{"$ref":"#/components/schemas/variantOptionValue"}}}},"variantBase":{"type":"object","description":"An array of `variant` objects. At least one variant is required. If the product has no variants, the variant can reuse the product information.","properties":{"allow_backorder":{"description":"If backorders of the variant are allowed.","type":"boolean","format":"boolean","example":true},"compare_at_price":{"description":"The original price of the item before an adjustment or a sale.","type":"string","example":"30.00"},"cost":{"description":"The cost of the product variant.","type":"string","example":"30.00"},"grams":{"description":"The weight of the product variant in grams.","type":"integer","format":"int64"},"image_url":{"description":"URL of the image.","type":"string","example":"your_platform_connector.com/files/products/hats/purple-beach-hat.jpg"},"inventory_quantity":{"description":"Current inventory level of the product.","type":"integer","format":"int64"},"inventory_tracking_entity":{"type":"string","description":"Entity on which inventory is tracked.","enum":["variant","product","none"]},"inventory_tracking_service":{"type":"string","description":"Service that tracks inventory.","example":"platform"},"localized_names":{"type":"object","additionalProperties":{"type":"string"},"description":"Map of localized names for the variant. The field is the https://www.iso.org/iso-639-language-codes.html two character language code. The value is the product name in the given language.","example":{"en":"Purple","fr":"Violette"}},"name":{"description":"The name of the variant. If there is only one variant, the `name` must be \\"Default Title\\" in order to avoid displaying the same `name` twice.","type":"string","example":"Default Title"},"price":{"description":"The price of the variant","type":"string","example":"30.00"},"require_shipping":{"description":"True if the item needs to be shipped, false otherwise.","type":"boolean","format":"boolean"},"sku":{"description":"Variant SKU.","type":"string","example":"BEACH-HAT-PURPLE"},"tax_code":{"description":"Tax code for the variant.","type":"string","example":"non-taxable"},"tax_exempt":{"description":"Indicates whether the variant is tax-exempt. If `true`, the variant is tax-exempt.","type":"boolean","format":"boolean","nullable":true},"weight":{"type":"string","description":"The weight of the product variant, calculated with weight unit specified.","example":"1.0"},"weight_unit":{"type":"string","description":"The unit of measurement that applies to the product variant\'s weight.","example":"kg"}}},"variantOptionValue":{"type":"object","description":"A more granular level of customization for variants. These are not required, but can be used to provide more options for your same variant.","properties":{"platform_id":{"type":"string","description":"A unique identifier for the variant option value. Defined by the platform.","example":"variant-option-value-123456"},"platform_product_option_id":{"type":"string","description":"A unique identifier for the product option this value belongs to. Defined by the platform.","example":"product-option-123456"},"label":{"type":"string","description":"Label of the option value.","example":"small"},"name":{"type":"string","description":"Name of the option.","example":"Small"}}},"category":{"type":"object","allOf":[{"$ref":"#/components/schemas/categoryBase"}],"properties":{"platform_id":{"type":"string","description":"A unique identifier for the category. Defined by the platform.","example":"category-123456"},"platform_updated_at":{"description":"The date the category was last updated on the platform.","type":"string","format":"date-time","example":"2021-03-11T17:16:51Z"}}},"categoryBase":{"type":"object","properties":{"image_url":{"description":"Specifies the URL location of the category image.","type":"string","example":"your_platform_connector.com/files/categories/hats.jpg"},"name":{"description":"The name of the category.","type":"string","example":"Hats"}}},"listCategoriesResponseBody":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/listCategoriesResponseData"},"pagination":{"$ref":"#/components/schemas/paginationResponse"}}},"listCategoriesResponseData":{"type":"object","properties":{"categories":{"type":"array","items":{"$ref":"#/components/schemas/category"}}}},"deepImage":{"type":"object","allOf":[{"$ref":"#/components/schemas/imageBase"}],"properties":{"platform_id":{"type":"string","description":"A unique identifier for the image. Defined by the platform.","example":"image-123456"}}},"imageBase":{"type":"object","properties":{"name":{"description":"The image name.","type":"string","example":"Beach hat"},"src":{"description":"The image URL.","type":"string","example":"your_platform_connector.com/files/images/beach-hat.jpg"},"position":{"description":"The position on the list.","type":"integer","format":"int64","example":2}}},"deepOption":{"type":"object","allOf":[{"$ref":"#/components/schemas/optionBase"}],"properties":{"platform_id":{"type":"string","description":"A unique identifier for the product option. Defined by the platform.","example":"product-option-123456"},"option_values":{"type":"array","items":{"$ref":"#/components/schemas/deepOptionValue"}}}},"optionBase":{"type":"object","properties":{"name":{"description":"The option name.","type":"string","example":"Small"},"position":{"description":"The position on the list.","type":"integer","format":"int64","example":2}}},"deepOptionValue":{"type":"object","allOf":[{"$ref":"#/components/schemas/optionValueBase"}],"properties":{"platform_id":{"type":"string","description":"A unique identifier for the option value. Defined by the platform.","example":"option-value-123456"}}},"optionValueBase":{"type":"object","properties":{"is_default":{"type":"boolean","description":"Indicates whether this is the default option.","format":"boolean","example":true},"label":{"description":"The label of the option value.","type":"string","example":"Small"},"position":{"description":"The position on the list.","type":"integer","format":"int64","example":1}}}},"parameters":{"timestamp":{"name":"X-HMAC-Timestamp","in":"header","schema":{"type":"string","format":"date-time"},"required":true,"description":"The UTC server time (in [RFC 3339 format](https://datatracker.ietf.org/doc/html/rfc3339)) at the moment the request was sent, signed as a part of calculating X-HMAC and X-Compatible-HMAC values.","example":"2021-03-11T17:16:51Z"},"userAgent":{"name":"User-Agent","in":"header","schema":{"type":"string"},"required":true,"description":"A value to help filter traffic from Bold through any firewall system. Bold sends requests to your Platform Connector with the value `Bold-API`. You can adjust your firewall system to allow calls with this value to reach your Platform Connector.","example":"Bold-API"},"shopIdentifier":{"name":"shop_identifier","in":"path","description":"A unique identifier of the store. This can be retrieved by calling the [Get Shop Info](/api/shops#tag/Shops/operation/GetShopInfo) endpoint.","required":true,"schema":{"type":"string"},"example":"zp3oafdor9"},"customerId":{"name":"platform_id","in":"path","description":"A unique identifier for the customer. Assigned by the platform.","required":true,"schema":{"type":"string"},"example":"customer-123456"},"platformCustomerId":{"name":"platform_customer_id","in":"path","description":"Unique identifier for the customer. Assigned by the platform.","required":true,"schema":{"type":"string"},"example":"customer-123456"},"addressId":{"name":"platform_id","in":"path","description":"Unique identifier for the address. Assigned by the platform.","required":true,"schema":{"type":"string"},"example":"address-123456"},"orderId":{"name":"platform_id","in":"path","description":"Unique identifier for the order. Assigned by the platform.","required":true,"schema":{"type":"string"},"example":"order-123456"},"orderPlatformId":{"name":"order_platform_id","in":"path","description":"Unique identifier for the order. Assigned by the platform.","required":true,"schema":{"type":"string"},"example":"order-123456"},"paymentId":{"name":"platform_id","in":"path","description":"Unique identifier for the payment. Assigned by the platform.","required":true,"schema":{"type":"string"},"example":"payment-123456"},"idempotencyKey":{"name":"Idempotency-Key","in":"header","schema":{"type":"string"},"required":false,"description":"Use the HTTP idempotency request header field to carry an idempotency key in order to make non-idempotent HTTP methods, such as POST or PATCH, fault-tolerant.","example":"qaasc934qfj9aerf"},"limit":{"name":"limit","in":"query","description":"The maximum number of results to return per page.","schema":{"type":"integer","format":"int32","minimum":1,"maximum":250,"default":250},"example":100},"cursor":{"name":"cursor","in":"query","description":"A cursor to obtain the next page of results. Bold takes the value of the cursor directly from the `next` value in the response without any modifications.","schema":{"type":"string"},"example":"dW50ZXN0dW50ZXN0dW50ZXN0"}},"examples":{"customerNotFound":{"value":{"code":"404-1","message":"Customer not found.","type":"customer.not_found"}},"addressNotFound":{"value":{"code":"404-2","message":"Address not found.","type":"address.not_found"}},"internalError":{"value":{"code":500,"message":"Request failed due to an internal server error.","type":"server.internal_error"}},"orderNotFound":{"value":{"code":"404-1","message":"Order not found.","type":"order.not_found"}},"paymentNotFound":{"value":{"code":"404-2","message":"Payment not found.","type":"payment.not_found"}}}}}},"plugin-redoc-4":{"url":"/api/platform-event-notifications.openapi.yaml","themeId":"theme-redoc","isSpecFile":true,"spec":{"openapi":"3.0.0","info":{"title":"Platform Connector: Event Notifications","description":"This API allows platform connectors to push events to Bold when there are changes to a customer, order, or product resource. These events must trigger any time data changes on the platform (and Bold did not make this change). This ensures Bold applications are in sync with the platform and have access to the complete data set.\\n\\nAll successful responses from Bold contain an empty response body and return an HTTP 202 response code.\\n\\nRefer to the changelog for the latest updates to this API.\\n> **Note:** This specification is only for use with a [Bold Platform Connector](/guides/platform-connector).\\n","termsOfService":"https://boldcommerce.com/terms-of-service","contact":{"name":"Contact Us","url":"https://developer-dashboard.boldcommerce.com/default/contactus"},"version":"1.0.0"},"servers":[{"url":"https://api.boldcommerce.com"}],"security":[{"OAuthToken":[]},{"APIAccessToken":[]}],"tags":[{"name":"Customer Event Notifications","description":"Event notifications you send to Bold when a change occurs to customers on the platform."},{"name":"Order Event Notifications","description":"Event notifications you send to Bold when a change occurs to orders on the platform."},{"name":"Product Event Notifications","description":"Event notifications you send to Bold when a change occurs to products on the platform."}],"externalDocs":{"description":"For more information about Platform Connectors, refer to the Overview.","url":"https://developer.boldcommerce.com/guides/platform-connector"},"paths":{"/customers/v1/shops/{shop_identifier}/platforms/custom/webhooks/customers/saved":{"parameters":[{"$ref":"#/components/parameters/shopIdentifier"}],"post":{"tags":["Customer Event Notifications"],"summary":"Customer Saved","operationId":"CustomerSavedEventNotification","description":"Trigger this API call when customer data changes on the platform. This includes customer creation, customer updates, and any changes to a customer\'s associated addresses.\\n\\nBold queues the customer for saving. The request must contain the complete customer object and its addresses at the time the change occurred. Bold replaces all fields of the existing customer object with the values provided in the request body. Bold ignores and does not update the fields omitted from the request body.\\n\\nThe `platform_updated_at` field must be accurate to mitigate the risk incurred by out-of-sequence requests.","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/customerSavedRequestBody"}}},"required":true},"responses":{"202":{"description":"Event notification was queued successfully.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"A validation error occurred.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/validationError"},"examples":{"validationError":{"value":{"status_code":400,"errors":["Error at \'/data/customer/addresses/0/platform_id\': property \'platform_id\' is missing","Error at \'/data/customer/platform_id\': property \'platform_id\' is missing"]}}}}}},"500":{"description":"An unexpected error occurred.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/runtimeErrorCustomer"},"examples":{"internalError":{"$ref":"#/components/examples/internalError"}}}}}}}},"/customers/v1/shops/{shop_identifier}/platforms/custom/webhooks/customers/deleted":{"parameters":[{"$ref":"#/components/parameters/shopIdentifier"}],"post":{"tags":["Customer Event Notifications"],"summary":"Customer Deleted","operationId":"CustomerDeletedEventNotification","description":"Trigger this API call when a customer is deleted on the platform.\\n\\nBold queues the customer for deletion. The `platform_deleted_at` field must be accurate to mitigate the risk incurred by out-of-sequence requests.","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/customerDeletedRequestBody"}}},"required":true},"responses":{"202":{"description":"Event notification was queued successfully.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"A validation error occurred.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/validationError"},"examples":{"validationError":{"value":{"status_code":400,"errors":["Error at \'/data/customer/platform_id\': property \'platform_id\' is missing"]}}}}}},"500":{"description":"An unexpected error occurred.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/runtimeErrorCustomer"},"examples":{"internalError":{"$ref":"#/components/examples/internalError"}}}}}}}},"/orders/v1/shops/{shop_identifier}/platforms/custom/webhooks/orders/saved":{"parameters":[{"$ref":"#/components/parameters/shopIdentifier"}],"post":{"tags":["Order Event Notifications"],"summary":"Order Saved","operationId":"OrderSavedEventNotification","description":"Trigger this API call when order data changes on the platform, including order creation and updates.\\n\\nBold queues the order for saving. The request must contain the complete order object at the time the change occurred. Bold replaces all fields of the existing order object with the values provided in the request body. Bold ignores and does not update fields omitted from the request body.\\n\\nThe `platform_updated_at` field must be accurate to mitigate the risk incurred by out-of-sequence requests.","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/orderSavedRequestBody"}}},"required":true},"responses":{"202":{"description":"Event notification was queued successfully.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"A validation error occurred.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/validationError"},"examples":{"validationError":{"value":{"status_code":400,"errors":["Error at \'/data/order/payments/0/transactions/0/platform_id\': property \'platform_id\' is missing","Error at \'/data/order/platform_id\': property \'platform_id\' is missing"]}}}}}},"500":{"description":"An unexpected error occurred.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/runtimeErrorOrder"},"examples":{"internalError":{"$ref":"#/components/examples/internalError"}}}}}}}},"/orders/v1/shops/{shop_identifier}/platforms/custom/webhooks/orders/deleted":{"parameters":[{"$ref":"#/components/parameters/shopIdentifier"}],"post":{"tags":["Order Event Notifications"],"summary":"Order Deleted","operationId":"OrderDeletedEventNotification","description":"Trigger this API call when an order is deleted on the platform.\\n\\nBold queues the order for deletion. The `platform_deleted_at` field must be accurate to mitigate the risk incurred by out-of-sequence requests.","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/orderDeletedRequestBody"}}},"required":true},"responses":{"202":{"description":"Event notification was queued successfully.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"A validation error occurred.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/validationError"},"examples":{"validationError":{"value":{"status_code":400,"errors":["Error at \'/data/order/platform_id\': property \'platform_id\' is missing"]}}}}}},"500":{"description":"An unexpected error occurred.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/runtimeErrorOrder"},"examples":{"internalError":{"$ref":"#/components/examples/internalError"}}}}}}}},"/products/v1/shops/{shop_identifier}/platforms/custom/webhooks/products/saved":{"parameters":[{"$ref":"#/components/parameters/shopIdentifier"}],"post":{"tags":["Product Event Notifications"],"summary":"Product Saved","operationId":"ProductSavedEventNotification","description":"Trigger this API call when product data changes, including product creation and updates.\\n\\nBold queues the product for saving. The request must contain the complete product object at the time the change occurred. Bold replaces all fields of the existing product object with the values provided in the request body. Bold ignores and does not update fields omitted from the request body. \\n\\nThe `platform_updated_at` field must be accurate to mitigate the risk incurred by out-of-sequence requests.","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/productSavedRequestBody"}}},"required":true},"responses":{"202":{"description":"Event notification was queued successfully.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"A validation error occurred.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/validationError"},"examples":{"validationError":{"value":{"status_code":400,"errors":["Error at \'/data/product/platform_id\': property \'platform_id\' is missing.","Error at \'/data/product/variants/0/platform_id\': property \'platform_id\' is missing."]}}}}}},"500":{"description":"An unexpected error occurred.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/runtimeErrorProduct"}}}}}}},"/products/v1/shops/{shop_identifier}/platforms/custom/webhooks/products/deleted":{"parameters":[{"$ref":"#/components/parameters/shopIdentifier"}],"post":{"tags":["Product Event Notifications"],"summary":"Product Deleted","operationId":"ProductDeletedEventNotification","description":"Trigger this API call when a product is deleted on the platform.\\n\\nBold queues the product for deletion. The `platform_deleted_at` field must be accurate to mitigate the risk incurred by out-of-sequence requests.","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/productDeletedRequestBody"}}},"required":true},"responses":{"202":{"description":"Event notification was queued successfully.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"A validation error occurred.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/validationError"},"examples":{"validationError":{"value":{"status_code":400,"errors":["Error at \'/data/product/platform_id\': property \'platform_id\' is missing."]}}}}}},"500":{"description":"An unexpected error response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/runtimeErrorProduct"}}}}}}},"/products/v1/shops/{shop_identifier}/platforms/custom/webhooks/categories/saved":{"parameters":[{"$ref":"#/components/parameters/shopIdentifier"}],"post":{"tags":["Product Event Notifications"],"summary":"Product Category Saved","operationId":"CategorySavedEventNotification","description":"Trigger this API call when a product category is saved on the platform.\\n\\nBold queues the product category for saving. The request contains the complete product category object at the time the change occurred. Bold replaces all fields of the existing product category object with the values provided in the request\\nbody. Fields omitted from the request body are ignored in the `category` object.\\n\\nThe `platform_updated_at` field must be accurate to mitigate the risk incurred by out-of-sequence requests.","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/categorySavedRequestBody"}}},"required":true},"responses":{"202":{"description":"Notification queued successfully","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"A validation error occurred.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/validationError"},"examples":{"validationError":{"value":{"status_code":400,"errors":["Error at \'/data/category/platform_id\': property \'platform_id\' is missing."]}}}}}},"500":{"description":"An unexpected error response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/runtimeErrorProduct"}}}}}}},"/products/v1/shops/{shop_identifier}/platforms/custom/webhooks/categories/deleted":{"parameters":[{"$ref":"#/components/parameters/shopIdentifier"}],"post":{"tags":["Product Event Notifications"],"summary":"Product Category Deleted","operationId":"CategoryDeletedEventNotification","description":"Trigger this API call when a product category is deleted on the platform.\\n\\nBold queues the product category for deletion. The `platform_deleted_at` field must be accurate to mitigate the risk incurred by out-of-sequence requests.","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/categoryDeletedRequestBody"}}},"required":true},"responses":{"202":{"description":"Notification queued successfully","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"A validation error occurred.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/validationError"},"examples":{"validationError":{"value":{"status_code":400,"errors":["Error at \'/data/category/platform_id\': property \'platform_id\' is missing."]}}}}}},"500":{"description":"An unexpected error response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/runtimeErrorProduct"}}}}}}}},"components":{"securitySchemes":{"OAuthToken":{"type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"https://apps.boldapps.net/accounts/dashboard/authorize","tokenUrl":"https://api.boldcommerce.com/auth/oauth2/token","scopes":{}}},"description":"Authenticates an API request from a [public integration](/guides/checkout/resources/glossary#public-integration). Generate this token in the [Developer Dashboard](https://developer-dashboard.boldcommerce.com/default/dashboard). Refer to [Build Public Integrations](/guides/checkout/public-integrations) for more information."},"APIAccessToken":{"type":"apiKey","name":"API Access Token","in":"header","description":"Authenticates an API request from a [private integration](/default/guides/checkout/resources/glossary#private-integration).\\n\\nGenerate this token in the [Bold Account Center](https://account.boldcommerce.com/). Refer to the [Quickstart guide](/default/guides/checkout/quick-start) for more information."}},"parameters":{"shopIdentifier":{"name":"shop_identifier","in":"path","description":"A unique identifier of the store. This can be retrieved by calling the [Get Shop\\nInfo](shops#tag/Shops/operation/GetShopInfo#) endpoint.","required":true,"schema":{"type":"string","example":"zp3oafdor9"}}},"schemas":{"customerBase":{"type":"object","properties":{"email":{"description":"The email address for the customer.","type":"string","format":"email","example":"john.doe@example.com"},"first_name":{"description":"The first name of the customer.","type":"string","example":"John"},"last_name":{"description":"The last name of the customer.","type":"string","example":"Doe"},"phone":{"description":"A phone number for the customer.","type":"string","format":"phone","example":"555-555-5555"}}},"addressBaseCustomer":{"type":"object","properties":{"address_type":{"description":"The type of the address (i.e., residential, commercial).","type":"string","example":"commercial"},"address_use":{"description":"The usage of the address. Possible values are `\\"billing\\"` or `\\"shipping\\"`.","type":"string","enum":["billing","shipping"],"example":"shipping"},"company":{"description":"The name of the company operating at the specified address, if applicable.","type":"string","example":"Acme Corp."},"city":{"description":"The name of the city associated with the address.","type":"string","example":"Winnipeg"},"country":{"description":"The name of the country associated with the address.","type":"string","example":"Canada"},"country_code":{"description":"The country code (in [ISO 3166-1 alpha-2 format](https://www.iso.org/iso-3166-country-codes.html)) of the address.","type":"string","example":"CA"},"is_default":{"description":"Indicates whether this is the default address for the customer. There can only be one default address for a customer. If this modifies any other resources, ensure the appropriate event notifications are triggered for those affected by this change.","type":"boolean","format":"boolean","example":true},"first_name":{"description":"The first name of the customer with the address.","type":"string","example":"John"},"last_name":{"description":"The last name of the customer with the address.","type":"string","example":"Doe"},"phone":{"description":"The phone number of the addressee.","type":"string","format":"phone","example":"555-555-5555"},"postal_code":{"description":"The postal code or zip code for the address.","type":"string","example":"H0H 0H0"},"province":{"description":"The province or state for the address.","type":"string","example":"Manitoba"},"province_code":{"description":"The province or state abbreviation for the address.","type":"string","example":"MB"},"street_1":{"description":"The primary street information for the address.","type":"string","example":"123 North Road"},"street_2":{"description":"Additional street information for the address.","type":"string","example":"Unit 5"}}},"customerAddress":{"type":"object","allOf":[{"$ref":"#/components/schemas/addressBaseCustomer"}],"properties":{"platform_id":{"description":"A unique identifier for the address. Assigned by the platform.","type":"string","example":"Address_456"}},"required":["platform_id"]},"customer":{"type":"object","allOf":[{"$ref":"#/components/schemas/customerBase"}],"properties":{"addresses":{"description":"A list of customer addresses.","type":"array","items":{"$ref":"#/components/schemas/customerAddress"}},"platform_created_at":{"description":"The date (in [RFC3339 format](https://datatracker.ietf.org/doc/html/rfc3339)) that this customer was created on the platform. Assigned by the platform.","type":"string","format":"date-time","example":"2023-01-09T15:35:57"},"platform_updated_at":{"description":"The date (in [RFC3339 format](https://datatracker.ietf.org/doc/html/rfc3339)) that this customer was last modified on the platform. Assigned by the platform.","type":"string","format":"date-time","example":"2023-01-09T15:35:57"},"platform_id":{"description":"A unique identifier for the customer. Assigned by the platform.","type":"string","example":"Customer_123"}},"required":["platform_updated_at","platform_id"]},"customerSavedRequestData":{"type":"object","properties":{"customer":{"$ref":"#/components/schemas/customer"}},"required":["customer"]},"customerSavedRequestBody":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/customerSavedRequestData"}},"required":["data"]},"validationError":{"type":"object","properties":{"status_code":{"type":"number"},"errors":{"type":"array","items":{"type":"string"}}}},"runtimeErrorCustomer":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","description":"The code used to identify the error."},"message":{"type":"string","description":"A long description of the error."},"type":{"type":"string","description":"A short description of the error."}}}}}},"deletedCustomer":{"type":"object","properties":{"platform_id":{"description":"A unique identifier for the customer. Assigned by the platform.","type":"string","example":"Customer_123"},"platform_deleted_at":{"description":"The date (in [RFC3339 format](https://datatracker.ietf.org/doc/html/rfc3339)) that this customer was deleted on the platform. Assigned by the platform.","type":"string","format":"date-time","example":"2023-04-09T12:33:44"}},"required":["platform_id","platform_deleted_at"]},"customerDeletedRequestData":{"type":"object","properties":{"customer":{"$ref":"#/components/schemas/deletedCustomer"}},"required":["customer"]},"customerDeletedRequestBody":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/customerDeletedRequestData"}},"required":["data"]},"customAttribute":{"type":"object","properties":{"description":{"description":"A description of the attribute.","type":"string","example":"field-1"},"value":{"description":"The value of the attribute.","type":"string","example":"value-1"}}},"tax":{"type":"object","properties":{"amount":{"description":"The total tax amount pending, measured in the order\'s given currency.","type":"string","format":"double","example":"5.00"},"name":{"description":"A human-readable name for this tax.","type":"string","example":"Provincial Sales Tax"},"rate":{"description":"The tax percentage (a value between 0 to 1).","type":"string","example":"0.07"},"tag":{"description":"The reference tag for the tax.","type":"string","example":"tag-1"}}},"orderDiscount":{"type":"object","properties":{"platform_id":{"type":"string","description":"A unique identifier for the discount. Defined by the platform.","example":"discount-123456"},"amount":{"description":"The discounted amount applied to the order, measured in the order\'s given currency.","type":"string","format":"double","example":"5.00"},"discount_code":{"type":"string","description":"The code used to apply the discount.","example":"20OFF"}}},"orderBase":{"type":"object","properties":{"order_number":{"description":"A human-readable identifier for the order.","type":"string","example":"ORDER_XXYY1122"},"platform_customer_id":{"description":"A unique identifier for the customer associated to this order. Assigned by the platform.","type":"string","example":"customer-123456"},"platform_friendly_id":{"description":"A unique identifier for the order on the platform. This field is used to identify the order on the platform and is used by the Bold Checkout Admin to link the order to the platform.","type":"string","example":"PT-0065"},"shipping_method":{"description":"The shipping method for the order.","type":"string","example":"freight"},"shipping_code":{"description":"The code for the shipping method for the order. Each store defines its own shipping codes.","type":"string","example":"S001"},"browser_ip":{"description":"The browser IP under which the customer placed the order.","type":"string","example":"127.0.0.1"},"source":{"description":"A label identifying the mechanism which placed the order.","type":"string","example":"POS"},"created_via":{"description":"A label identifying the app that created the order (if applicable).","type":"string","example":"Bold Checkout"},"locale":{"description":"The locale code of the order (either in [ISO-639 language code format](https://www.iso.org/iso-639-language-codes.html) or in [ISO/IEC-15897 regional language format](https://www.iso.org/standard/50707.html)).","type":"string","example":"en_US"},"test":{"description":"Indicates whether the order is a test order.","type":"boolean","example":false},"notes":{"description":"Any internal notes about the order.","type":"string","example":"Handle with care."},"public_notes":{"description":"Any customer-facing notes about the order.","type":"string","example":"Order contains fragile items."},"custom_attributes":{"description":"A series of key-value pairs of metadata relevant to the order.","type":"object","additionalProperties":{"$ref":"#/components/schemas/customAttribute"}},"shipping_subtotal":{"description":"The cost of shipping the order, in the order\'s given currency.","type":"string","format":"double","example":"5.00"},"shipping_tax":{"description":"The sum of shipping taxes for the ordered items, in the order\'s given currency.","type":"string","format":"double","example":"1.00"},"shipping_taxes":{"description":"A list of the individual shipping taxes for the line items on the order.","type":"array","items":{"$ref":"#/components/schemas/tax"}},"discount":{"description":"The total amount discounted from the order, in the order\'s given currency. If there is no discount, set this field to `\\"0\\"`.\\n\\n**Note:** If `discount` is included in the payload, the `total` and `total_tax` values are required.","type":"string","format":"double","example":"0"},"discounts":{"description":"The list of discounts applied to the order.","type":"object","additionalProperties":{"$ref":"#/components/schemas/orderDiscount"}},"subtotal":{"description":"The subtotal of the line items on the order, in the order\'s given currency.\\n\\n**Note:** Calculate the subtotal before taxes and discounts (if those values are not included in the line item prices).","type":"string","format":"double","example":"10.00"},"subtotal_tax":{"description":"The tax to be charged on all line items, in the order\'s given currency.","type":"string","format":"double","example":"5.00"},"total_tax":{"description":"The total tax on the full order, in the order\'s given currency, including: `subtotal_tax`, `shipping_tax`, and any other special taxes pending for the order.","type":"string","format":"double","example":"5.00"},"total":{"description":"The total of order cost, in the order\'s given currency.\\n\\n**Note**: This number includes taxes and is reduced by the discount.\\n","type":"string","format":"double","example":"20.00"},"refunded_amount":{"description":"The refunded amount of the order, if any, in the order\'s given currency.","type":"string","format":"double","example":"0"},"currency":{"description":"The base currency used for the order (in [ISO-4217 currency code format](https://www.iso.org/iso-4217-currency-codes.html)).","type":"string","example":"CAD"},"order_status":{"description":"The current status of the order. The status indicates whether the order is `active` or `cancelled`.","type":"string","enum":["active","cancelled"],"example":"active"},"fulfillment_status":{"description":"The fulfillment status of the order.","type":"string","enum":["pending","partial","delivered","fulfilled"],"example":"partial"},"financial_status":{"description":"The status of payments associated with the order. This field can only be set when the order is created and cannot be changed if the order is updated.","type":"string","enum":["held_for_review","disputed","cancelled","pending","preauthed","refunded","partially_paid","partially_refunded","paid"],"example":"pending"},"placed_at":{"description":"The date the order was placed on the platform, (in [RFC3339 format](https://datatracker.ietf.org/doc/html/rfc3339)). Assigned by the platform.","type":"string","format":"date-time","example":"2019-08-24T14:15:22Z"}}},"addressBaseOrder":{"type":"object","properties":{"address_type":{"description":"The type of the address (i.e., residential, commercial).","type":"string","example":"commercial"},"first_name":{"description":"The addressee\'s first name.","type":"string","example":"John"},"last_name":{"description":"The addressee\'s last name.","type":"string","example":"Doe"},"street_1":{"description":"The primary street information.","type":"string","example":"123 North Road"},"street_2":{"description":"The additional street information, if any.","type":"string","example":"Suite 200"},"city":{"description":"The city name.","type":"string","example":"Winnipeg"},"province":{"description":"The province or state name.","type":"string","example":"Manitoba"},"country":{"description":"The country name.","type":"string","example":"Canada"},"country_code":{"description":"The country code of the address (in [ISO 3166-1 alpha-2 format](https://www.iso.org/iso-3166-country-codes.html)).","type":"string","example":"CA"},"phone":{"description":"The phone number.","type":"string","format":"phone","example":"555-555-5555"},"postal_code":{"description":"The postal code or zip code.","type":"string","example":"H0H 0H0"},"email":{"description":"An email address.","type":"string","format":"email","example":"john.doe@example.com"},"province_code":{"description":"The province or state abbreviation (in [ISO 3166 format](https://www.iso.org/iso-3166-country-codes.html)).","type":"string","example":"MB"},"company":{"description":"The name of the company operating at the specified address, if applicable.","type":"string","example":"Acme Corp."}}},"address":{"type":"object","allOf":[{"$ref":"#/components/schemas/addressBaseOrder"}],"properties":{"platform_id":{"description":"A unique identifier for the address. Assigned by the platform.","type":"string","example":"address-123456"}},"required":["platform_id"]},"lineItemBase":{"type":"object","properties":{"platform_product_id":{"description":"A unique identifier for the product referenced in this line item. Assigned by the platform.","type":"string","example":"product-123456"},"platform_variant_id":{"description":"A unique identifier for the variant referenced in this line item. Assigned by the platform.","type":"string","example":"variant-123456"},"cart_line_item_platform_id":{"description":"A unique identifier for the cart line item. Assigned by the platform.","type":"string","example":"cart-line-item-123456"},"custom_attributes":{"description":"Any key-value pairs of metadata relevant to the line item.","type":"object","additionalProperties":{"$ref":"#/components/schemas/customAttribute"}},"title":{"description":"The title of the line item.","type":"string","example":"Shoes (long-laced classic)"},"sku":{"description":"The SKU of the line item.","type":"string","example":"TSH-FF0000-L"},"url":{"description":"A link to the line item in the store.","type":"string","example":"https://example.com/shoes"},"image":{"description":"A link to an image of the line item.","type":"string","example":"http://shop.images/shoes"},"quantity":{"description":"The quantity ordered for this line item.","type":"integer","format":"int64","example":1},"grams":{"description":"The weight (in grams) of the line item.","type":"number","format":"double","example":10},"weight":{"description":"The weight of the line item (measured in terms of `weight_unit`).","type":"number","format":"double","example":10},"weight_unit":{"description":"The unit weight is measured in for the line item.","type":"string","example":"grams"},"taxable":{"description":"Indicates whether the line item is taxable.","type":"boolean","example":true},"taxes":{"description":"A list of taxes for the line item.","type":"array","items":{"$ref":"#/components/schemas/tax"}},"requires_shipping":{"description":"Indicates whether the line item requires shipping.","type":"boolean","example":true},"price_per_item":{"description":"The price per unit of the line item, in the order\'s given currency.\\n\\n**Note:** This value is the line item price before taxes and discounts (if taxes are not included in price).","type":"string","format":"double","example":"10.00"},"discount_per_item":{"description":"The discount of the line item, in the order\'s given currency.","type":"string","format":"double","example":"0"},"total":{"description":"The total price of the line item, in the order\'s given currency.\\n\\n**Note:** This value includes taxes and discounts.","type":"string","format":"double","example":"15.00"},"subtotal":{"description":"The subtotal of the line item, measured in the order\'s currency.\\n\\n**Note:** This value is the line item price multiplied by quantity, excluding tax.","type":"string","format":"double","example":"10.00"},"total_tax":{"description":"The total tax of the line item, in the order\'s given currency.","type":"string","format":"double","example":"5.00"},"discounted_subtotal":{"description":"The discounted total price of the line item, in the order\'s given currency.\\n\\n**Note:** This value is the discounted line item price multiplied by\\nquantity, excluding tax.","type":"string","format":"double","example":"10.00"}}},"lineItem":{"type":"object","allOf":[{"$ref":"#/components/schemas/lineItemBase"}],"properties":{"platform_id":{"description":"A unique identifier for the line item. Assigned by the platform.","type":"string","example":"line-item-123456"}},"required":["platform_id"]},"paymentBase":{"type":"object","properties":{"status":{"description":"The status of the payment. Values are dependent on the payment provider used and should be passed through as-is.","type":"string","example":"paid"}}},"transactionBase":{"type":"object","properties":{"provider_transaction_id":{"description":"A unique identifier for the transaction. Assigned by the payment provider.","type":"string","example":"provider-transaction-123456"},"amount":{"description":"The amount captured in this transaction, in the transaction\'s given currency.\\n\\n**Note:** If the transaction is a refund, this amount is negative.","type":"string","format":"double","example":"15.00"},"currency":{"description":"The currency used for the transaction (in [ISO-4217 currency code format](https://www.iso.org/iso-4217-currency-codes.html)).","type":"string","example":"CAD"},"status":{"description":"The status of the transaction.","type":"string","enum":["initial","pending","failure","success"],"example":"success"},"type":{"description":"The type of transaction.","type":"string","enum":["authorization","charge","refund"],"example":"charge"}}},"transaction":{"type":"object","allOf":[{"$ref":"#/components/schemas/transactionBase"}],"properties":{"platform_id":{"description":"A unique identifier for the transaction. Assigned by the platform.","type":"string","example":"transaction-123456"}},"required":["platform_id","amount"]},"payment":{"type":"object","allOf":[{"$ref":"#/components/schemas/paymentBase"}],"properties":{"platform_id":{"description":"A unique identifier for the payment. Assigned by the platform.","type":"string","example":"payment-123456"},"transactions":{"description":"A list of transactions for the payment.","type":"array","items":{"$ref":"#/components/schemas/transaction"}},"description":{"description":"A human-readable description of the payment.","type":"string","example":"Credit card payment"},"provider":{"description":"A label indicating the organization handling the payment and transactions.","type":"string","example":"stripe"},"payment_method":{"description":"The payment method used.","type":"string","example":"credit card"},"currency":{"type":"string","description":"The currency used for the payment (in [ISO-4217 currency code format](https://www.iso.org/iso-4217-currency-codes.html)).","example":"CAD"},"amount_planned":{"description":"The amount that the payment provider plans to charge for the payment, in the payment\'s given currency. If the payment has been completed, this amount reflects the amount charged.","type":"string","format":"double","example":"15.00"},"custom_attributes":{"description":"Any key-value pairs of metadata relevant to the payment.","type":"object","additionalProperties":{"$ref":"#/components/schemas/customAttribute"}}},"required":["platform_id","amount_planned"]},"order":{"type":"object","allOf":[{"$ref":"#/components/schemas/orderBase"}],"properties":{"platform_id":{"description":"A unique identifier for the order. Assigned by the platform.","type":"string","example":"order-123456"},"platform_updated_at":{"description":"The date the order was last modified on the platform, (in [RFC3339 format](https://datatracker.ietf.org/doc/html/rfc3339)). Assigned by the platform.","type":"string","format":"date-time","example":"2019-08-24T14:15:22Z"},"shipping_addresses":{"description":"A list of shipping addresses for the order.","type":"array","items":{"$ref":"#/components/schemas/address"}},"billing_address":{"description":"The billing address for the order.","allOf":[{"$ref":"#/components/schemas/address"}]},"line_items":{"description":"A list of line items included in the order.","type":"array","items":{"$ref":"#/components/schemas/lineItem"}},"payments":{"description":"A list of payments for the order.","type":"array","items":{"$ref":"#/components/schemas/payment"}}},"required":["total","total_tax","subtotal","subtotal_tax","shipping_subtotal","shipping_tax","platform_id","platform_updated_at"]},"orderSavedRequestData":{"type":"object","properties":{"order":{"description":"The order object.","$ref":"#/components/schemas/order"}},"required":["order"]},"orderSavedRequestBody":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/orderSavedRequestData"}},"required":["data"]},"runtimeErrorOrder":{"type":"object","properties":{"errors":{"type":"array","items":{"required":["code"],"type":"object","properties":{"code":{"type":"string","description":"The code used to identify the error.","example":"09-1"},"message":{"type":"string","description":"A long description of the error.","example":"The order with the provided platform_id does not exist"},"type":{"type":"string","description":"A short description of the error.","example":"orders.does_not_exist"}}}}}},"deletedOrder":{"type":"object","properties":{"platform_id":{"description":"A unique identifier for the order. Assigned by the platform.","type":"string","example":"order-123456"},"platform_deleted_at":{"description":"The date the order was deleted on the platform, (in [RFC3339 format](https://datatracker.ietf.org/doc/html/rfc3339)). Assigned by the platform.","type":"string","format":"date-time","example":"2020-08-24T14:15:22Z"}},"required":["platform_id","platform_deleted_at"]},"orderDeletedRequestData":{"type":"object","properties":{"order":{"$ref":"#/components/schemas/deletedOrder"}},"required":["order"]},"orderDeletedRequestBody":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/orderDeletedRequestData"}},"required":["data"]},"productBase":{"type":"object","properties":{"description":{"type":"string","description":"The description for the product.","example":"A hat for the beach"},"handle":{"type":"string","description":"A unique, human-readable string for the product.","example":"beach-hat"},"inventory_quantity":{"type":"integer","description":"The current inventory amount of the product.","format":"int64","example":2},"inventory_tracking_entity":{"type":"string","description":"The entity on which inventory is tracked.","enum":["variant","product","none"],"example":"product"},"inventory_tracking_service":{"type":"string","description":"The service that tracks inventory.","example":"platform"},"localized_descriptions":{"type":"object","description":"A map of localized descriptions for the product. The key is the [ISO-639](https://www.iso.org/iso-639-language-codes.html) two character language code. The value is the product description in the given language.","additionalProperties":{"type":"string"},"example":{"en":"A hat for the beach","fr":"Un chapeau pour la plage"}},"localized_names":{"type":"object","description":"A map of localized names for the product. The key is the [ISO-639](https://www.iso.org/iso-639-language-codes.html) two character language code. The value is the product name in the given language.","additionalProperties":{"type":"string"},"example":{"en":"Beach Hat","fr":"Chapeau de Plage"}},"name":{"type":"string","description":"The product name.","example":"Beach hat"},"published":{"type":"boolean","description":"Indicates if the product is published on the storefront.","example":true},"tags":{"type":"string","description":"A string with comma separated values describing the product.","example":"clothing, unisex, headwear"},"tax_code":{"type":"string","description":"The tax code for the product.","example":"non-taxable"},"type":{"type":"string","description":"A representation of platform-specific product data. The role of this field depends on the platform:\\n\\n- BigCommerce: The product type, either `physical` or `digital`.\\n- commercetools: A merchant or partner-defined data set, valid as per options set in the platform.\\n- Shopify: A product categorization, used for filtering and searching products.\\n- Custom: Defined by the platform.","example":"physical"},"url":{"type":"string","description":"A URL to the product on the storefront.","example":"/hats/beach-hat"},"vendor":{"type":"string","description":"The product vendor.","example":"OFS"}}},"categoryBase":{"type":"object","properties":{"image_url":{"description":"The URL location of the category image.","type":"string","example":"your_platform_connector.com/files/categories/hats.jpg"},"name":{"description":"The name of the category.","type":"string","example":"Hats"}}},"category":{"type":"object","allOf":[{"$ref":"#/components/schemas/categoryBase"}],"properties":{"platform_id":{"type":"string","description":"A unique identifier for the category. Defined by the platform.","example":"category-123456"},"platform_updated_at":{"type":"string","format":"date-time","description":"The date and time the category was last updated on the platform, in [RFC 3339, section 5.6 format](https://datatracker.ietf.org/doc/html/rfc3339#section-5.6). If never updated, defaults to the `platform_created_at` value.","example":"2019-08-24T14:15:22Z"}},"required":["platform_id","platform_updated_at"]},"variantBase":{"type":"object","description":"An array of `variant` objects. At least one variant is required. If the product has no variants, the variant can reuse the product information.","properties":{"allow_backorder":{"description":"If backorders of the variant is allowed.","type":"boolean","format":"boolean"},"compare_at_price":{"description":"The original price of the item before an adjustment or a sale.","type":"string","example":"30.00"},"cost":{"description":"The cost of the product variant.","type":"string","example":"30.00"},"grams":{"description":"The weight of the product variant in grams.","type":"integer","format":"int64"},"image_url":{"description":"URL of the image.","type":"string","example":"your_platform_connector.com/files/products/hats/purple-beach-hat.jpg"},"inventory_quantity":{"description":"Current inventory level of the product.","type":"integer","format":"int64"},"inventory_tracking_entity":{"type":"string","description":"Entity on which inventory is tracked.","enum":["variant","product","none"]},"inventory_tracking_service":{"type":"string","description":"Service that tracks inventory.","example":"platform"},"localized_names":{"type":"object","additionalProperties":{"type":"string"},"description":"Map of localized names for the variant. The field is the [ISO-639](https://www.iso.org/iso-639-language-codes.html) two character language code. The value is the product name in the given language.","example":{"en":"Purple","fr":"Violette"}},"name":{"description":"The name of the variant. If there is only one variant, the `name` must be \\"Default Title\\" in order to avoid displaying the same `name` twice.","type":"string","example":"Default Title"},"price":{"description":"The price of the variant","type":"string","example":"30.00"},"require_shipping":{"description":"True if the item needs to be shipped, false otherwise.","type":"boolean","format":"boolean"},"sku":{"description":"Variant SKU.","type":"string","example":"BEACH-HAT-PURPLE"},"tax_code":{"description":"Tax code for the variant.","type":"string","example":"non-taxable"},"tax_exempt":{"description":"Indicates whether the variant is tax-exempt. If `true`, the variant is tax-exempt.","type":"boolean","format":"boolean","nullable":true},"weight":{"type":"string","description":"The weight of the product variant, calculated with weight unit specified.","example":"1.0"},"weight_unit":{"type":"string","description":"The unit of measurement that applies to the product variant\'s weight.","example":"kg"}}},"variantOptionValue":{"type":"object","description":"A more granular level of customization for variants. These are not required, but can be used to provide more options for your same variant.","properties":{"platform_id":{"type":"string","description":"A unique identifier for the variant option value. Defined by the platform.","example":"abc123456"},"platform_product_option_id":{"type":"string","description":"The unique identifier for the product option this value belongs to. Defined by the platform.","example":"VAR-10001-SM"},"label":{"type":"string","description":"The label of the option value.","example":"small"},"name":{"type":"string","description":"The name of the option.","example":"Small"}}},"deepVariant":{"type":"object","allOf":[{"$ref":"#/components/schemas/variantBase"}],"properties":{"platform_id":{"type":"string","description":"A unique identifier for the variant. Defined by the platform.","example":"variant-123456"},"option_values":{"type":"array","items":{"$ref":"#/components/schemas/variantOptionValue"}}},"required":["platform_id","allow_backorder","price","weight"]},"optionBase":{"type":"object","properties":{"name":{"description":"The option name.","type":"string","example":"Small"},"position":{"description":"The position in the `options` array.","type":"integer","format":"int64","example":1}}},"optionValueBase":{"type":"object","properties":{"is_default":{"type":"boolean","description":"Indicates whether this is the default option.","format":"boolean"},"label":{"description":"The label of the option value.","type":"string","example":"Small"},"position":{"description":"The position in the `option_values` array.","type":"integer","format":"int64","example":1}}},"deepOptionValue":{"type":"object","allOf":[{"$ref":"#/components/schemas/optionValueBase"}],"properties":{"platform_id":{"type":"string","description":"A unique identifier for the option value. Defined by the platform.","example":"option-value-123456"}}},"deepOption":{"type":"object","allOf":[{"$ref":"#/components/schemas/optionBase"}],"properties":{"platform_id":{"type":"string","description":"A unique identifier for the product option. Defined by the platform.","example":"product-option-123456"},"option_values":{"type":"array","items":{"$ref":"#/components/schemas/deepOptionValue"}}}},"imageBase":{"type":"object","properties":{"name":{"description":"The image name.","type":"string","example":"Beach hat"},"src":{"description":"The image URL.","type":"string","example":"https://example.com/images/beach-hat.jpg"},"position":{"description":"The position in the `images` array.","type":"integer","format":"int64","example":1}}},"deepImage":{"type":"object","allOf":[{"$ref":"#/components/schemas/imageBase"}],"properties":{"platform_id":{"type":"string","description":"A unique identifier for the image. Defined by the platform.","example":"image-123456"}}},"product":{"type":"object","allOf":[{"$ref":"#/components/schemas/productBase"}],"properties":{"platform_id":{"type":"string","description":"A unique identifier for the product. Defined by the platform.","example":"product-123456"},"platform_updated_at":{"description":"The date the product was last updated on the platform.","type":"string","format":"date-time","example":"2019-08-24T14:15:22Z"},"categories":{"type":"array","items":{"$ref":"#/components/schemas/category"}},"variants":{"type":"array","description":"An array of `variant` objects. At least one variant is required. If the product has no variants, the variant can reuse the product information.","items":{"$ref":"#/components/schemas/deepVariant"}},"options":{"type":"array","description":"An array of product options.","items":{"$ref":"#/components/schemas/deepOption"}},"images":{"type":"array","description":"An array of images depicting the product.","items":{"$ref":"#/components/schemas/deepImage"}}},"required":["platform_id","platform_updated_at","variants"]},"productSavedRequestData":{"type":"object","properties":{"product":{"description":"The product object.","$ref":"#/components/schemas/product"}},"required":["product"]},"productSavedRequestBody":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/productSavedRequestData"}},"required":["data"]},"runtimeErrorProduct":{"type":"object","properties":{"errors":{"type":"array","items":{"required":["code"],"type":"object","properties":{"code":{"type":"string","description":"The error code.","example":"07-1"},"message":{"type":"string","description":"The error message.","example":"Request failed due to an internal server error."},"type":{"type":"string","description":"The type of error.","example":"server.internal_error"}}}}}},"deletedProduct":{"type":"object","properties":{"platform_id":{"description":"The platform ID of the product to be deleted.","type":"string","example":"product-123456"},"platform_deleted_at":{"description":"The date the order was deleted on the platform, (in [RFC3339 format](https://datatracker.ietf.org/doc/html/rfc3339)). Assigned by the platform.","type":"string","format":"date-time","example":"2020-08-24T14:15:22Z"}},"required":["platform_id","platform_deleted_at"]},"productDeletedRequestData":{"type":"object","properties":{"product":{"$ref":"#/components/schemas/deletedProduct"}},"required":["product"]},"productDeletedRequestBody":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/productDeletedRequestData"}},"required":["data"]},"categorySavedRequestData":{"type":"object","properties":{"category":{"$ref":"#/components/schemas/category"}},"required":["category"]},"categorySavedRequestBody":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/categorySavedRequestData"}},"required":["data"]},"deletedCategory":{"type":"object","properties":{"platform_id":{"description":"The platform ID of the category to be deleted.","type":"string","example":"category-123456"},"platform_deleted_at":{"type":"string","format":"date-time","description":"The date and time this category was deleted on the platform, in [RFC 3339, section 5.6 format](https://datatracker.ietf.org/doc/html/rfc3339#section-5.6).","example":"2019-09-24T14:15:22Z"}},"required":["platform_id","platform_deleted_at"]},"categoryDeletedRequestData":{"type":"object","properties":{"category":{"$ref":"#/components/schemas/deletedCategory"}},"required":["category"]},"categoryDeletedRequestBody":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/categoryDeletedRequestData"}},"required":["data"]}},"examples":{"internalError":{"value":{"code":500,"message":"Request failed due to an internal server error.","type":"server.internal_error"}}}}}},"plugin-redoc-5":{"url":"/api/platform-connector-destinations.openapi.yaml","themeId":"theme-redoc","isSpecFile":true,"spec":{"openapi":"3.0.0","info":{"title":"Platform Connector: Integration Configurations","description":"This API allows authors of platform connectors to configure the integration between their platform connector and Bold services.\\n\\nRefer to the changelog for the latest updates to this API.\\n\\n> **Note:** This specification is only for use with a [Bold Platform Connector](/guides/platform-connector).\\n","version":"1.0.0","termsOfService":"https://boldcommerce.com/terms-of-service","contact":{"name":"Contact Us","url":"https://developer-dashboard.boldcommerce.com/default/contactus"}},"servers":[{"url":"https://api.boldcommerce.com"}],"security":[{"OAuthToken":[]},{"APIAccessToken":[]}],"tags":[{"name":"Platform Connector Destinations","description":"Contains information about where Bold should direct platform connector requests. Use these endpoints to integrate a platform connector with Bold by providing your server\'s destinations."},{"name":"Platform Connector Sync","description":"Use these endpoints to sync your platform\'s customer, order, and product data with Bold."}],"externalDocs":{"description":"For more information about platform connectors, refer to the Overview.","url":"https://developer.boldcommerce.com/guides/platform-connector"},"paths":{"/integrations/v1/shops/{shop_identifier}/platform_connector_destinations":{"parameters":[{"$ref":"#/components/parameters/shopIdentifier"}],"post":{"tags":["Platform Connector Destinations"],"summary":"Create Destination","operationId":"CreateDestination","description":"Informs Bold of your platform connector destination for the specified `shop_identifier`. This destination is the location of your platform connector server.\\n\\nAny time the specified `topic` resource changes, Bold makes a call to your platform connector\'s `destination` URL at the relevant path. For more information about implementing these paths, refer to [Implement Platform Connector APIs](/guides/platform-connector/create-server).\\n\\nEach topic may only have one destination on the platform connector, and each destination corresponds to only one topic. You must make separate calls to register each destination.\\n\\nAny request to this endpoint triggers a synchronous request to the [Verify Platform Connector Destination](platform-connector#operation/VerifyPlatformConnectorDestination) endpoint on your platform connector. If the verification endpoint does not succeed, the Create Destination call also fails.","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/createDestinationRequestBody"}}},"required":true},"responses":{"200":{"description":"Platform Connector Destination was created successfully.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/createDestinationResponseBody"}}}},"400":{"description":"Specified destination failed verification, or destination is unreachable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/runtimeError"},"examples":{"destinationValidationError":{"$ref":"#/components/examples/destinationValidationError"},"destinationTimeExceeded":{"$ref":"#/components/examples/destinationTimeExceeded"}}}}},"500":{"description":"An unexpected error occurred.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/runtimeError"},"examples":{"internalError":{"$ref":"#/components/examples/internalError"},"destinationInternalError":{"$ref":"#/components/examples/destinationInternalError"}}}}}}},"get":{"tags":["Platform Connector Destinations"],"summary":"List Destinations","operationId":"ListDestinations","description":"Lists all connections between Bold and your platform connector for the specified `shop_identifier`.\\n\\nAny time the referenced `topic` resources are changed, Bold calls your platform connector on the specified `destination` base URL at the relevant path, as per the [Platform Connector Specifications](platform-connector).","responses":{"200":{"description":"Response containing a list of Platform Connector `destination` objects.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/listDestinationsResponseBody"},"examples":{"DestinationUpdated":{"$ref":"#/components/examples/DestinationUpdated"}}}}},"500":{"description":"An unexpected error occurred.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/runtimeError"},"examples":{"internalError":{"$ref":"#/components/examples/internalError"}}}}}}}},"/integrations/v1/shops/{shop_identifier}/platform_connector_destinations/{id}":{"parameters":[{"$ref":"#/components/parameters/shopIdentifier"},{"$ref":"#/components/parameters/destinationId"}],"get":{"tags":["Platform Connector Destinations"],"summary":"Get Destination by ID","operationId":"GetDestinationByID","description":"Retrieves a specific connection between Bold and your platform connector for the specified `shop_identifier` by its unique `id`.\\n\\nAny time the referenced `topic` resources are changed, Bold calls your platform connector on the specified `destination` base URL at the relevant path, as per the [Platform Connector Specifications](platform-connector).","responses":{"200":{"description":"Response containing a successfully found Platform Connector `destination` object","content":{"application/json":{"schema":{"$ref":"#/components/schemas/retrieveDestinationResponseBody"}}}},"404":{"description":"The destination specified by `id` was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/runtimeError"},"examples":{"destinationNotFound":{"$ref":"#/components/examples/destinationNotFound"}}}}},"500":{"description":"An unexpected error occurred.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/runtimeError"},"examples":{"internalError":{"$ref":"#/components/examples/internalError"}}}}}}},"put":{"tags":["Platform Connector Destinations"],"summary":"Update Destination","operationId":"UpdateDestination","description":"Updates the base URL `destination` of your platform connector for the specified `shop_identifier`.\\n\\nAll fields of a `destination` object are replaced with the values provided in the request body. Fields omitted from the request body are ignored and not updated in the `destination` object.\\n\\nAny time the specified `topic` resource changes, Bold makes a call to your platform connector\'s `destination` URL at the relevant path. For more information about implementing these paths, refer to [Implement Platform Connector APIs](/guides/platform-connector/create-server).\\n\\nEach topic may only have one destination on the platform connector, and each destination corresponds to only one topic. You must make separate calls to update each destination.\\n\\nAny request to this endpoint triggers a synchronous request to the [Verify Platform Connector Destination](platform-connector#operation/VerifyPlatformConnectorDestination) endpoint on your platform connector. If the verification endpoint does not succeed, the Update Destination call also fails.","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/updateDestinationRequestBody"}}},"required":true},"responses":{"200":{"description":"Platform Connector Destination was updated successfully.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/updateDestinationResponseBody"},"examples":{"UpdatedDestination":{"$ref":"#/components/examples/DestinationUpdated"}}}}},"400":{"description":"Specified destination failed verification, or destination is unreachable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/runtimeError"},"examples":{"destinationValidationError":{"$ref":"#/components/examples/destinationValidationError"},"destinationTimeExceeded":{"$ref":"#/components/examples/destinationTimeExceeded"}}}}},"404":{"description":"The destination specified by `id` was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/runtimeError"},"examples":{"destinationNotFound":{"$ref":"#/components/examples/destinationNotFound"}}}}},"500":{"description":"An unexpected error occurred.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/runtimeError"},"examples":{"internalError":{"$ref":"#/components/examples/internalError"},"destinationInternalError":{"$ref":"#/components/examples/destinationInternalError"}}}}}}},"delete":{"tags":["Platform Connector Destinations"],"summary":"Delete Destination","operationId":"DeleteDestination","description":"Deletes a specific connection between Bold and your platform connector for the specified `shop_identifier` by the unique `id` of the destination.\\n\\nAfter this call, `topic` changes which would normally trigger calls from Bold to a platform connector no longer do so for the deleted `topic`.","responses":{"204":{"description":"Returned upon successful deletion of the destination.","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"The destination specified by `platform_id` was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/runtimeError"},"examples":{"customerNotFound":{"$ref":"#/components/examples/destinationNotFound"}}}}},"500":{"description":"An unexpected error occurred.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/runtimeError"},"examples":{"internalError":{"$ref":"#/components/examples/internalError"}}}}}}}},"/orders/v2/shops/{shop_identifier}/sync":{"post":{"tags":["Platform Connector Sync"],"summary":"Trigger Order Sync","operationId":"SyncOrders","description":"Syncs the orders on a platform with Bold.","parameters":[{"$ref":"#/components/parameters/syncShopIdentifier"}],"responses":{"200":{"description":"Operation successful","content":{"application/json":{"schema":{"type":"object"}}}},"409":{"description":"A sync is currently in progress.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"},"example":{"status_code":409,"errors":["API Error encountered: \'cannot initiate sync, syncing already in progress\'"]}}}},"501":{"description":"An internal service has not been implemented.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"},"examples":{"destinationNotConfiguredError":{"value":{"status_code":501,"errors":["API Error encountered: \'platform connector destination not configured for topic\'"]}},"platformNotSupportedError":{"value":{"status_code":501,"errors":["API Error encountered: \'unsupported platform\'"]}}}}}}}}},"/customers/v2/shops/{shop_identifier}/sync":{"post":{"tags":["Platform Connector Sync"],"summary":"Trigger Customer Sync","operationId":"SyncCustomers","description":"Syncs the customers on a platform with Bold.","parameters":[{"$ref":"#/components/parameters/syncShopIdentifier"}],"responses":{"200":{"description":"Operation successful","content":{"application/json":{"schema":{"type":"object"}}}},"409":{"description":"A sync is currently in progress.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"},"example":{"status_code":409,"errors":["API Error encountered: \'cannot initiate sync, syncing already in progress\'"]}}}},"501":{"description":"An internal service has not been implemented.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"},"examples":{"destinationNotConfiguredError":{"value":{"status_code":501,"errors":["API Error encountered: \'platform connector destination not configured for topic\'"]}},"platformNotSupportedError":{"value":{"status_code":501,"errors":["API Error encountered: \'unsupported platform\'"]}}}}}}}}},"/products/v2/shops/{shop_identifier}/sync":{"post":{"tags":["Platform Connector Sync"],"summary":"Trigger Product Sync","operationId":"SyncProducts","description":"Syncs the products on a platform with Bold.","parameters":[{"$ref":"#/components/parameters/syncShopIdentifier"}],"responses":{"200":{"description":"Operation successful","content":{"application/json":{"schema":{"type":"object"}}}},"409":{"description":"A sync is currently in progress.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"},"example":{"status_code":409,"errors":["API Error encountered: \'cannot initiate sync, syncing already in progress\'"]}}}},"501":{"description":"An internal service has not been implemented.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"},"examples":{"destinationNotConfiguredError":{"value":{"status_code":501,"errors":["API Error encountered: \'platform connector destination not configured for topic\'"]}},"platformNotSupportedError":{"value":{"status_code":501,"errors":["API Error encountered: \'unsupported platform\'"]}}}}}}}}}},"components":{"securitySchemes":{"OAuthToken":{"type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"https://apps.boldapps.net/accounts/dashboard/authorize","tokenUrl":"https://api.boldcommerce.com/auth/oauth2/token","scopes":{}}},"description":"Authenticates an API request from a [public integration](/guides/checkout/resources/glossary#public-integration). Generate this token in the [Developer Dashboard](https://developer-dashboard.boldcommerce.com/default/dashboard). Refer to [Build Public Integrations](/guides/checkout/public-integrations) for more information."},"APIAccessToken":{"type":"apiKey","name":"API Access Token","in":"header","description":"Authenticates an API request from a [private integration](/guides/checkout/resources/glossary#private-integration). Generate this token in the [Bold Account Center](https://account.boldcommerce.com/). Refer to [Making API Calls](/guides/checkout/quick-start) for more information."}},"schemas":{"createDestinationRequestBody":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/createDestinationRequestData"}}},"createDestinationRequestData":{"type":"object","properties":{"destination":{"$ref":"#/components/schemas/destinationNew"}}},"destinationNew":{"type":"object","allOf":[{"$ref":"#/components/schemas/destinationBase"},{"required":["shop_identifier","topic","destination","version","timeout_ms"]}]},"createDestinationResponseBody":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/createDestinationResponseData"}}},"createDestinationResponseData":{"type":"object","properties":{"destination":{"$ref":"#/components/schemas/destination"}}},"updateDestinationRequestBody":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/updateDestinationRequestData"}}},"updateDestinationRequestData":{"type":"object","properties":{"destination":{"$ref":"#/components/schemas/destinationUpdate"}}},"destinationUpdate":{"type":"object","allOf":[{"$ref":"#/components/schemas/destinationBase"}],"properties":{"id":{"description":"The unique identifier for this destination.","type":"integer","example":100}}},"updateDestinationResponseBody":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/updateDestinationResponseData"}}},"updateDestinationResponseData":{"type":"object","properties":{"destination":{"$ref":"#/components/schemas/destination"}}},"listDestinationsResponseBody":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/listDestinationsResponseData"}}},"listDestinationsResponseData":{"type":"object","properties":{"destinations":{"type":"array","items":{"$ref":"#/components/schemas/destination"}}}},"retrieveDestinationResponseBody":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/retrieveDestinationResponseData"}}},"retrieveDestinationResponseData":{"type":"object","properties":{"destination":{"$ref":"#/components/schemas/destination"}}},"destination":{"type":"object","allOf":[{"$ref":"#/components/schemas/destinationBase"}],"properties":{"id":{"description":"The unique identifier for this destination.","type":"integer","example":100},"created_at":{"description":"The date (in [RFC3339 format](https://datatracker.ietf.org/doc/html/rfc3339)) that this destination was created.","type":"string","format":"date-time","example":"2019-08-24T14:15:22Z"},"updated_at":{"description":"The date (in [RFC3339 format](https://datatracker.ietf.org/doc/html/rfc3339)) that this destination was updated. This value is `null` if the destination was not updated.","type":"string","format":"date-time","nullable":true,"example":"2019-08-24T14:15:22Z"},"deleted_at":{"description":"The date (in [RFC3339 format](https://datatracker.ietf.org/doc/html/rfc3339)) that this destination was deleted. This value is `null` if the destination was not deleted.","type":"string","format":"date-time","nullable":true,"example":null}}},"destinationBase":{"type":"object","properties":{"shop_identifier":{"description":"A unique identifier of the store. Retrieve this information by calling the [Get Shop Info](shops#tag/Shop/operation/GetShopInfo) endpoint.","type":"string","example":"zp3oafdor9"},"topic":{"description":"The resource/entity in Bold\'s domain model that caused a call to a platform connector.\\n\\nThis value must be unique among all of the `destination` objects for a given `shop_identifier`.","type":"string","enum":["customers","orders","products"]},"destination":{"description":"The base URL that Bold will call when the related `topic` is created, updated, or deleted.\\n\\nEach topic may only have a single destination on the platform connector, and each destination corresponds to only one topic. You must make separate calls to register each destination.","type":"string","format":"URL","example":"https://www.my_platform_connector.com"},"version":{"description":"The semantic version to be substituted into the path of the call made to a platform connector, as per the [Platform Connector Specifications](platform-connector).","type":"string","example":"v1"},"timeout_ms":{"description":"The time (in milliseconds) that Bold will wait before terminating outbound calls to a platform connector. The recommended value is 10000 milliseconds. This value cannot exceed 20000 milliseconds.","type":"number","example":10000,"maximum":20000}}},"runtimeError":{"type":"object","properties":{"status_code":{"type":"integer","format":"int32"},"errors":{"type":"array","items":{"type":"string"}}}},"error":{"type":"object","properties":{"status_code":{"type":"number"},"errors":{"type":"array","items":{"type":"string"}}}}},"parameters":{"shopIdentifier":{"name":"shop_identifier","in":"path","description":"A unique identifier of the store. Retrieve this information by calling the [Get Shop Info](shops#tag/Shop/operation/GetShopInfo) endpoint.","required":true,"schema":{"type":"string"},"example":"zp3oafdor9"},"destinationId":{"name":"id","in":"path","description":"A unique identifier of the destination.","required":true,"schema":{"type":"string"},"example":"100"},"syncShopIdentifier":{"name":"shop_identifier","in":"path","required":true,"schema":{"type":"string","example":"zp3oafdor9"},"description":"The identifier of the shop you would like to sync. Retrieve the `shop_identifier` by calling the [Get Shop Info](shops#tag/Shops/operation/GetShopInfo) endpoint."}},"examples":{"destinationNotFound":{"value":{"status_code":404,"errors":["Destination not found."]}},"destinationTimeExceeded":{"value":{"status_code":400,"errors":["Specified connector destination has timeout_ms exceeding 20 seconds"]}},"destinationValidationError":{"value":{"status_code":400,"errors":["Specified destination failed verification, or destination is unreachable"]}},"destinationInternalError":{"value":{"status_code":500,"errors":["Failed to create Custom Platform Destinations"]}},"internalError":{"value":{"status_code":500,"errors":["Request failed due to an internal server error"]}},"DestinationUpdated":{"value":{"data":{"destination":{"id":100,"created_at":"2019-08-24T14:15:22Z","updated_at":"2019-08-25T13:49:39Z","deleted_at":null,"shop_identifier":"zp3oafdor9","topic":"customers","destination":"https://www.my_platform_connector.com","version":"v1","timeout_ms":10000}}}}}}}},"plugin-redoc-6":{"url":"/api/price-rules.openapi.yaml","themeId":"theme-redoc","isSpecFile":true,"spec":{"openapi":"3.0.0","info":{"title":"Price Rules","version":"2.0","description":"The Price Rules API enables you to manage price rulesets.\\n\\nRefer to the changelog for the latest updates to this API.","termsOfService":"https://boldcommerce.com/terms-of-service","contact":{"name":"Contact Us","url":"https://developer-dashboard.boldcommerce.com/default/contactus"}},"servers":[{"url":"https://api.boldcommerce.com"}],"security":[{"OAuthToken":[]},{"APIAccessToken":[]}],"tags":[{"name":"Rulesets","description":"Contains information about a [ruleset](/guides/price-rules/concepts/rulesets-and-rules#rulesets), including a rules list, actions, conditions, product selection, and start and end dates. Use these endpoints to manage rulesets on a store."},{"name":"Rules","description":"A child of the Ruleset resource. Contains information about a [rule](/guides/price-rules/concepts/rulesets-and-rules#rules), including the type, conditions, and actions of the rule. Use these endpoints to manage the rules in a ruleset."},{"name":"Order Conditions","description":"Child of the Ruleset resource. Contains information about the criteria for triggering actions in a ruleset. [Conditions](/guides/price-rules/references/conditions) are usually a `type:value` pair. Use these endpoints to manage the conditions in a ruleset."},{"name":"Discount Codes","description":"Contains information about a discount on your store and the products that are eligible for it. Use these endpoints to manipulate the discount codes available on your store."},{"name":"Storefronts","description":"Use these endpoints to get the final price for a product or cart after all rules have been applied."},{"name":"Simple Communication Test"}],"externalDocs":{"description":"For more information about Price Rules, refer to the Overview.","url":"https://developer.boldcommerce.com/guides/price-rules"},"paths":{"/price_rules/rules/v2/shops/{shop_identifier}/rulesets":{"get":{"summary":"List Rulesets","operationId":"ListRulesets","tags":["Rulesets"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"data":{"type":"object","required":["rulesets"],"properties":{"rulesets":{"type":"array","description":"Each set of rules that is related to the shop.","items":{"$ref":"#/components/schemas/Ruleset"}}}},"pagination":{"$ref":"#/components/schemas/Pagination"}},"required":["message","data"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"examples":{"401-error-example":{"value":{"message":"This request failed to be authenticated.","code":"00-1","type":"authentication.failed"}}}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"examples":{"403-error-example":{"value":{"message":"This request does not contain the necessary permissions to access the target endpoint.","code":"00-2","type":"authorization.invalid_scopes"}}}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"examples":{"500-error-example":{"value":{"message":"Error with fetching a ruleset","code":"04-0","type":"unexpected"}}}}}}},"description":"List all rulesets available for the specified shop. This requires read_price_rulesets scope/permission. For more information about querying for certain rulesets, refer to the [Query and Pagination](/guides/price-rules/resources/query-pagination) guide.","parameters":[{"schema":{"type":"string"},"in":"query","name":"external_ids","description":"A list of ruleset external IDs that can be used as a filter in the search."},{"schema":{"type":"string"},"in":"query","name":"fields","description":"List of the ruleset fields to be returned; if this parameter is empty, all the available fields will be included in the response."},{"schema":{"type":"string"},"in":"query","name":"page","description":"Page number, considering that the results could span for several pages. Default is 1."},{"schema":{"type":"string"},"in":"query","name":"limit","description":"Page size, considering that the results could span for several pages. Default is 50."},{"schema":{"type":"boolean"},"in":"query","name":"include_all_apps","description":"The standard behaviour for this endpoint is to return just the rulesets that were created using the same auth token. To see all rulesets instead, this parameter should be set to true."}]},"parameters":[{"schema":{"type":"string"},"name":"shop_identifier","in":"path","required":true,"description":"Bold platform identifier for the shop. Find this identifier using the [Get Shop Info](shops#operation/GetShopInfo) endpoint."}],"post":{"summary":"Create Ruleset","operationId":"CreateRuleset","responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"data":{"type":"object","required":["ruleset"],"properties":{"ruleset":{"type":"object","items":{"$ref":"#/components/schemas/BasicRuleset"}}}}},"required":["message","data"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"examples":{"400-error-example":{"value":{"message":"Required field missing or empty: product_selection","code":"04-6","type":"price_rules.required_field_missing"}}}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"examples":{"401-error-example":{"value":{"message":"This request failed to be authenticated.","code":"00-1","type":"authentication.failed"}}}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"examples":{"403-error-example":{"value":{"message":"This request does not contain the necessary permissions to access the target endpoint.","code":"00-2","type":"authorization.invalid_scopes"}}}}}},"409":{"description":"Conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Unprocessable Entity (WebDAV)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"examples":{"422-error-example":{"value":{"message":"Invalid ruleset in payload","code":"04-3","type":"price_rules.invalid_payload"}}}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"description":"Create a new ruleset for the specified shop. This requires write_price_rulesets scope/permission.","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"ruleset":{"$ref":"#/components/schemas/BasicRuleset"}}},"examples":{"create-ruleset-example":{"value":{"ruleset":{"external_id":"CreatedByAPI_1","internal_name":"This ruleset was created by the API","product_selection":{"type":"SHOPIFY_PRODUCT_SEARCH","product_ids":["1234567890123","1234567890987"]},"rules":[{"type":"DISCOUNT","conditions":[{"type":"CUSTOMER_GROUP","value":"gold"},{"type":"QTY_BY_PRODUCT","operator":">=","value":3}],"actions":[{"type":"PRICE_ADJUST_PERCENT","value":-10},{"type":"CHARM_PRICE","value":99}]}]}}}}}}},"tags":["Rulesets"]}},"/price_rules/rules/v2/shops/{shop_identifier}/rulesets/search":{"get":{"summary":"List Rulesets for Shop","operationId":"ListRulesetsForShop","tags":["Rulesets"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"data":{"type":"object","required":["rulesets"],"properties":{"rulesets":{"type":"array","description":"Each set of rules that is related to the shop.","items":{"$ref":"#/components/schemas/Ruleset"}}}},"pagination":{"$ref":"#/components/schemas/Pagination"}},"required":["message","data"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"examples":{"401-error-example":{"value":{"message":"This request failed to be authenticated.","code":"00-1","type":"authentication.failed"}}}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"examples":{"403-error-example":{"value":{"message":"This request does not contain the necessary permissions to access the target endpoint.","code":"00-2","type":"authorization.invalid_scopes"}}}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"examples":{"500-error-example":{"value":{"message":"Error with fetching a ruleset","code":"04-0","type":"unexpected"}}}}}}},"description":"List all rulesets available for the specified shop. This requires read_price_rulesets scope/permission.","externalDocs":{"description":"For more information on search filter options, please check our guides.","url":"https://developer.boldcommerce.com/guides/price-rules/resources/query-pagination"},"parameters":[{"schema":{"type":"string"},"in":"query","name":"external_ids","description":"A list of ruleset external IDs that can be used as a query filter."},{"schema":{"type":"string"},"in":"query","name":"product_ids","description":"A list of product IDs that can be used as a query filter."},{"schema":{"type":"string"},"in":"query","name":"variant_ids","description":"A list of product IDs or Variant IDs can be used combined as a query filter."},{"schema":{"type":"string"},"in":"query","name":"skus","description":"A list of product SKUs can be used as a query filter."},{"schema":{"type":"string"},"in":"query","name":"fields","description":"List of the ruleset fields to be returned; if this parameter is empty, all the available fields will be included in the response."},{"schema":{"type":"string"},"in":"query","name":"page","description":"Page number, considering that the results could span for several pages. Default is 1."},{"schema":{"type":"string"},"in":"query","name":"limit","description":"Page size, considering that the results could span for several pages. Default is 50."},{"schema":{"type":"boolean"},"in":"query","name":"include_all_apps","description":"The standard behaviour for this endpoint is to return just the rulesets that were created using the same auth token. To see all rulesets instead, this parameter should be set to true."},{"schema":{"type":"string"},"in":"query","name":"filter_expression","description":"This endpoint supports extra query columns to filter the rulesets. To use this parameter you should use like this: filter_expression:operation(column:value)."}]},"parameters":[{"schema":{"type":"string"},"name":"shop_identifier","in":"path","required":true,"description":"Bold platform identifier for the shop. Find this identifier using the [Get Shop Info](shops#operation/GetShopInfo) endpoint."}]},"/price_rules/rules/v2/shops/{shop_identifier}/rulesets/{ruleset_id}":{"get":{"summary":"Get Ruleset by ID","operationId":"GetRulesetByID","tags":["Rulesets"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"data":{"type":"object","required":["ruleset"],"properties":{"ruleset":{"$ref":"#/components/schemas/Ruleset"}}}},"required":["message","data"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"examples":{"401-error-example":{"value":{"message":"This request failed to be authenticated.","code":"00-1","type":"authentication.failed"}}}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"examples":{"403-error-example":{"value":{"message":"This request does not contain the necessary permissions to access the target endpoint.","code":"00-2","type":"authorization.invalid_scopes"}}}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"examples":{"404-error-example":{"value":{"message":"No rulesets found for provided parameters.","code":"04-9","type":"price_rules.ruleset_not_found"}}}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"description":"Return data for a specific ruleset, selected by the ruleset database ID. This requires read_price_rulesets scope/permission."},"parameters":[{"schema":{"type":"string"},"name":"shop_identifier","in":"path","required":true,"description":"Bold platform identifier for the shop. Find this identifier using the [Get Shop Info](shops#operation/GetShopInfo) endpoint."},{"schema":{"type":"string"},"name":"ruleset_id","in":"path","required":true,"description":"Ruleset database ID."}],"put":{"summary":"Update Ruleset by ID","operationId":"UpdateRulesetByID","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"data":{"type":"object","properties":{"ruleset":{"$ref":"#/components/schemas/Ruleset"}}}}},"examples":{"200-response-example":{"value":{"message":"Successfully updated ruleset","data":{"ruleset":{"id":84,"external_id":"CreatedByAPI_1","active":true,"internal_name":"This ruleset was created by the API and now it is being changed","public_name":"","start_date":null,"expiry_date":null,"sync_percent":0,"priority":0,"created_at":"2020-05-08T14:42:56Z","updated_at":"2020-05-08T14:43:14Z","rules":[{"type":"DISCOUNT","conditions":[{"type":"CUSTOMER_GROUP","value":"silver"},{"type":"QTY_BY_PRODUCT","operator":">=","value":3}],"actions":[{"type":"PRICE_ADJUST_PERCENT","value":-8},{"type":"CHARM_PRICE","value":99}]}],"product_selection":{"product_ids":["1234567890123","1234567890987"],"type":"SHOPIFY_PRODUCT_SEARCH"}}}}}}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"examples":{"401-error-example":{"value":{"message":"This request failed to be authenticated.","code":"00-1","type":"authentication.failed"}}}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"examples":{"403-error-example":{"value":{"message":"This request does not contain the necessary permissions to access the target endpoint.","code":"00-2","type":"authorization.invalid_scopes"}}}}}}},"description":"Change attributes for an existent ruleset, selected by the ruleset database ID. This requires write_price_rulesets scope/permission.","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"ruleset":{"$ref":"#/components/schemas/BasicRuleset"}}},"examples":{"update-ruleset-example":{"value":{"ruleset":{"external_id":"CreatedByAPI_1","internal_name":"This ruleset was created by the API and now it is being changed","product_selection":{"type":"SHOPIFY_PRODUCT_SEARCH","product_ids":["1234567890123","1234567890987"]},"rules":[{"type":"DISCOUNT","conditions":[{"type":"CUSTOMER_GROUP","value":"silver"},{"type":"QTY_BY_PRODUCT","operator":">=","value":3}],"actions":[{"type":"PRICE_ADJUST_PERCENT","value":-8},{"type":"CHARM_PRICE","value":99}]}]}}}}}}},"tags":["Rulesets"]},"delete":{"summary":"Delete Ruleset by ID","operationId":"DeleteRulesetByID","responses":{"204":{"description":"No Content"},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"examples":{"401-error-example":{"value":{"message":"This request failed to be authenticated.","code":"00-1","type":"authentication.failed"}}}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"examples":{"403-error-example":{"value":{"message":"This request does not contain the necessary permissions to access the target endpoint.","code":"00-2","type":"authorization.invalid_scopes"}}}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"description":"Delete a ruleset, selected by the ruleset database ID. This requires write_price_rulesets scope/permission.","tags":["Rulesets"]},"patch":{"summary":"Patch Ruleset by ID","operationId":"PatchRulesetByID","responses":{"204":{"description":"Successfully updated ruleset"},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"examples":{"401-error-example":{"value":{"message":"This request failed to be authenticated.","code":"00-1","type":"authentication.failed"}}}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"examples":{"403-error-example":{"value":{"message":"This request does not contain the necessary permissions to access the target endpoint.","code":"00-2","type":"authorization.invalid_scopes"}}}}}}},"description":"Change ruleset attributes including specified rules for an existing ruleset with the specified ruleset database ID without replacing unaffected rules. This requires write_price_rulesets scope/permission.","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BasicPatchRuleset"},"examples":{"patch-ruleset-example":{"value":{"ruleset":{"start_date":"2020-11-01T00:00:00Z","expiry_date":"2020-11-17T23:59:59Z","rules":[{"external_id":"CreatedByAPI_1","type":"DISCOUNT","conditions":[{"type":"CUSTOMER_GROUP","value":"silver"},{"type":"QTY_BY_PRODUCT","operator":">=","value":3}],"actions":[{"type":"PRICE_ADJUST_PERCENT","value":-8}]}]}}}}}},"description":""},"tags":["Rulesets"]}},"/price_rules/rules/v2/shops/{shop_identifier}/rulesets/eid/{external_id}":{"get":{"summary":"Get Ruleset by External ID","operationId":"GetRulesetByExternalID","tags":["Rulesets"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"data":{"type":"object","properties":{"ruleset":{"$ref":"#/components/schemas/Ruleset"}}}}}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"examples":{"401-error-example":{"value":{"message":"This request failed to be authenticated.","code":"00-1","type":"authentication.failed"}}}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"examples":{"403-error-example":{"value":{"message":"This request does not contain the necessary permissions to access the target endpoint.","code":"00-2","type":"authorization.invalid_scopes"}}}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"description":"Return data for a specific ruleset, selected by the ruleset external ID. This requires read_price_rulesets scope/permission."},"parameters":[{"schema":{"type":"string"},"name":"shop_identifier","in":"path","required":true,"description":"Bold platform identifier for the shop. Find this identifier using the [Get Shop Info](shops#operation/GetShopInfo) endpoint."},{"schema":{"type":"string"},"name":"external_id","in":"path","required":true,"description":"Ruleset external_id."},{"schema":{"type":"boolean"},"name":"include_all_apps","in":"query","description":"Indicates whether to include rulesets created by other apps. Without this flag (`?include_all_apps=true`), only rulesets created via the Price Rules API are returned."}],"post":{"summary":"Create Ruleset by External ID","operationId":"CreateRulesetByExternalID","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"data":{"type":"object","properties":{"ruleset":{"$ref":"#/components/schemas/Ruleset"}}}}},"examples":{"200-response-example":{"value":{"message":"Successfully updated ruleset","data":{"ruleset":{"id":83,"external_id":"CreatedByAPI_12","active":true,"internal_name":"This was created by the API using the CreatedByAPI_12 ID","public_name":"","start_date":null,"expiry_date":null,"sync_percent":0,"priority":0,"created_at":"2020-05-07T11:05:23Z","updated_at":"2020-05-07T11:05:23Z","rules":[{"type":"DISCOUNT","conditions":[{"type":"CUSTOMER_GROUP","value":"wholesale"}],"actions":[{"type":"PRICE_ADJUST_PERCENT","value":1250}]}],"product_selection":{"product_ids":["1234567890123","1234567890987"],"type":"SHOPIFY_PRODUCT_SEARCH"}}}}}}}}},"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"data":{"type":"object","properties":{"ruleset":{"$ref":"#/components/schemas/Ruleset"}}}}},"examples":{"201-response-example":{"value":{"message":"Successfully created ruleset","data":{"ruleset":{"id":83,"external_id":"CreatedByAPI_12","active":true,"internal_name":"This was created by the API using the CreatedByAPI_12 ID","public_name":"","start_date":null,"expiry_date":null,"sync_percent":0,"priority":0,"created_at":"2020-05-07T11:05:23Z","updated_at":"2020-05-07T11:05:23Z","rules":[{"type":"DISCOUNT","conditions":[{"type":"CUSTOMER_GROUP","value":"gold"}],"actions":[{"type":"PRICE_ADJUST_ABSOLUTE","value":1500}]}],"product_selection":{"product_ids":["1234567890123","1234567890987"],"type":"SHOPIFY_PRODUCT_SEARCH"}}}}}}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"examples":{"401-error-example":{"value":{"message":"This request failed to be authenticated.","code":"00-1","type":"authentication.failed"}}}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"examples":{"403-error-example":{"value":{"message":"This request does not contain the necessary permissions to access the target endpoint.","code":"00-2","type":"authorization.invalid_scopes"}}}}}},"422":{"description":"Unprocessable Entity (WebDAV)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"examples":{"422-error-response":{"value":{"message":"Invalid ruleset in payload","code":"04-3","type":"price_rules.invalid_payload"}}}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"examples":{"500-error-example":{"value":{"message":"Error writing ruleset by external_id","code":"04-0","type":"unexpected"}}}}}}},"description":"This operation has two purposes. If the given ruleset external ID already exists in the database, the ruleset will be updated using the request body information. Otherwise, a new ruleset will be created with the same data. This requires write_price_rulesets scope/permission.","tags":["Rulesets"],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"ruleset":{"$ref":"#/components/schemas/BasicRuleset"}}},"examples":{"write-ruleset-eid-example":{"value":{"ruleset":{"external_id":"CreatedByAPI_3","internal_name":"This ruleset will be created if it still does not exist","product_selection":{"type":"SHOPIFY_PRODUCT_SEARCH","product_ids":["1234567890123","1234567890987"]},"rules":[{"type":"DISCOUNT","conditions":[{"type":"QTY_BY_PRODUCT","operator":">=","value":3}],"actions":[{"type":"PRICE_ADJUST_PERCENT","value":-20},{"type":"CHARM_PRICE","value":99}]}]}}}}}}}},"delete":{"summary":"Delete Ruleset by External ID","operationId":"DeleteRulesetByExternalID","responses":{"204":{"description":"No Content"},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"examples":{"401-error-example":{"value":{"message":"This request failed to be authenticated.","code":"00-1","type":"authentication.failed"}}}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"examples":{"403-error-example":{"value":{"message":"This request does not contain the necessary permissions to access the target endpoint.","code":"00-2","type":"authorization.invalid_scopes"}}}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"examples":{"500-error-example":{"value":{"message":"Error with deleting a ruleset with external_id","code":"04-0","type":"unexpected"}}}}}}},"tags":["Rulesets"],"description":"Removes a specific ruleset, selected by the ruleset external ID. This requires write_price_rulesets scope/permission."},"patch":{"summary":"Patch Ruleset by External ID","operationId":"PatchRulesetByExternalID","responses":{"204":{"description":"Successfully updated ruleset"},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"examples":{"401-error-example":{"value":{"message":"This request failed to be authenticated.","code":"00-1","type":"authentication.failed"}}}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"examples":{"403-error-example":{"value":{"message":"This request does not contain the necessary permissions to access the target endpoint.","code":"00-2","type":"authorization.invalid_scopes"}}}}}}},"description":"Change ruleset attributes including specified rules for an existing ruleset with the specified ruleset external ID without replacing unaffected rules. This requires write_price_rulesets scope/permission.","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BasicPatchRuleset"},"examples":{"patch-ruleset-example":{"value":{"ruleset":{"start_date":"2020-11-01T00:00:00Z","expiry_date":"2020-11-17T23:59:59Z","rules":[{"external_id":"CreatedByAPI_1","type":"DISCOUNT","conditions":[{"type":"CUSTOMER_GROUP","value":"silver"},{"type":"QTY_BY_PRODUCT","operator":">=","value":3}],"actions":[{"type":"PRICE_ADJUST_PERCENT","value":-8}]}]}}}}}}},"tags":["Rulesets"]}},"/price_rules/rules/v2/shops/{shop_identifier}/rulesets/bulk/activate":{"parameters":[{"schema":{"type":"string"},"name":"shop_identifier","in":"path","required":true,"description":"Bold platform identifier for the shop. Find this identifier using the [Get Shop Info](shops#operation/GetShopInfo) endpoint."}],"post":{"summary":"Activate All Rulesets","operationId":"ActivateAllRulesets","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"data":{"type":"array","items":{}}}},"examples":{"200-response-example":{"value":{"message":"Successfully activated 22 rulesets","data":[]}}}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"examples":{"401-error-example":{"value":{"message":"This request failed to be authenticated.","code":"00-1","type":"authentication.failed"}}}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"examples":{"403-error-example":{"value":{"message":"This request does not contain the necessary permissions to access the target endpoint.","code":"00-2","type":"authorization.invalid_scopes"}}}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"examples":{"500-error-example":{"value":{"message":"Error while activating rulesets","code":"04-0","type":"unexpected"}}}}}}},"description":"Set the status of all rulesets to active in the specified shop. This requires write_price_rulesets scope/permission.","tags":["Rulesets"]}},"/price_rules/rules/v2/shops/{shop_identifier}/rulesets/bulk/deactivate":{"parameters":[{"schema":{"type":"string"},"name":"shop_identifier","in":"path","required":true,"description":"Bold platform identifier for the shop. Find this identifier using the [Get Shop Info](shops#operation/GetShopInfo) endpoint."}],"post":{"summary":"Deactivate All Rulesets","operationId":"DeactivateAllRulesets","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"data":{"type":"array","items":{}}}},"examples":{"200-response-example":{"value":{"message":"Successfully deactivated 18 rulesets","data":[]}}}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"examples":{"401-error-example":{"value":{"message":"This request failed to be authenticated.","code":"00-1","type":"authentication.failed"}}}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"examples":{"403-error-example":{"value":{"message":"This request does not contain the necessary permissions to access the target endpoint.","code":"00-2","type":"authorization.invalid_scopes"}}}}}}},"description":"Set the status of all rulesets to inactive in the specified shop. This requires write_price_rulesets scope/permission.","tags":["Rulesets"]}},"/price_rules/storefront/v2/shops/{shop_identifier}/rulesets":{"parameters":[{"schema":{"type":"string"},"name":"shop_identifier","in":"path","required":true,"description":"Bold platform identifier for the shop. Find this identifier using the [Get Shop Info](shops#operation/GetShopInfo) endpoint."}],"get":{"summary":"List Rulesets by Product ID","operationId":"ListRulesetsByProductID","tags":["Rulesets"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"data":{"type":"object","properties":{"rulesets":{"type":"array","description":"Each set of rules that is related to the shop and the given products.","items":{"$ref":"#/components/schemas/Ruleset"}},"shop_options":{"$ref":"#/components/schemas/ShopOptions"},"base_prices":{"type":"array","items":{"$ref":"#/components/schemas/BasePrice"}}}}}},"examples":{"200-response-example":{"value":{"message":"Successfully fetched rulesets","data":{"rulesets":[{"id":56,"app_slug":"my-cool-app","public_name":"","internal_name":"","external_id":"","active":true,"sync_percent":100,"priority":100,"expiry_date":null,"rules":[{"type":"DISCOUNT","conditions":[{"type":"CUSTOMER_GROUP","value":"wholesale"}],"actions":[{"type":"PRICE_ADJUST_RELATIVE","value":-5000}]},{"type":"DISCOUNT","conditions":[{"type":"CUSTOMER_GROUP","value":"gold"}],"actions":[{"type":"PRICE_ADJUST_RELATIVE","value":-2500}]},{"type":"DISCOUNT","conditions":[{"type":"CUSTOMER_GROUP","value":"silver"}],"actions":[{"type":"PRICE_ADJUST_RELATIVE","value":-1250}]},{"type":"DISCOUNT","conditions":[{"type":"CUSTOMER_GROUP","value":"bronze"}],"actions":[{"type":"PRICE_ADJUST_RELATIVE","value":-620}]}],"product_selection":{"type":"SHOPIFY_PRODUCT_SEARCH","products":[{"product_id":"1234567890123"}]}}],"shop_options":{"compare_at_price_as_original":true,"verbose_logs":true,"include_base_prices":true},"base_prices":[{"id":98765432101234,"price":10000},{"id":98765432109876,"price":12000}]}}}}}}}},"description":"List all rulesets available for the specified shop and product IDs. This requires no special permissions.","parameters":[{"schema":{"type":"string"},"in":"query","name":"products","description":"A comma separated list of all product IDs; Example: ?products=123","required":true},{"schema":{"type":"string"},"in":"query","name":"filter[]","description":"Rule condition filter. Example: &filter[]=eq(CUSTOMER_GROUP%3Agold)&filter[]=like(CURRENCY%3ACAD)"}]}},"/price_rules/rules/v2/hello-api":{"get":{"summary":"Simple Communication Test","operationId":"SimpleCommunicationTest","tags":["Simple Communication Test"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","description":"The success message."},"data":{"type":"object","properties":{"hello":{"type":"string","description":"A simple Hello World."}}}}},"examples":{"test-response-example":{"value":{"message":"Successfully reached Price Rules API","data":{"hello":"world!"}}}}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"description":"Test endpoint to ensure that the request contains a valid token and that it is successfully reaching Price Rules API. This requires no special permissions."}},"/price_rules/rules/v2/shops/{shop_identifier}/order_condition":{"parameters":[{"schema":{"type":"string"},"name":"shop_identifier","in":"path","required":true,"description":"Bold platform identifier for the shop. Find this identifier using the [Get Shop Info](shops#operation/GetShopInfo) endpoint."}],"get":{"summary":"List Order Conditions","operationId":"ListOrderConditions","tags":["Order Conditions"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"data":{"type":"object","properties":{"order_conditions":{"type":"array","items":{"$ref":"#/components/schemas/OrderCondition"}}}},"pagination":{"$ref":"#/components/schemas/Pagination"}}},"examples":{"200-response-example":{"value":{"message":"Successfully fetched order conditions","data":{"order_conditions":[{"name":"ZONE","value":"north-america-04","operator":"ONE_OF","type":"FIELD_SET","field_sets":[{"field_set_id":27,"customer.shipping.country":"Canada","customer.shipping.postal_code":"R3Y0L6"},{"field_set_id":28,"customer.shipping.country":"Canada","customer.shipping.postal_code":"R3T5Y3"},{"field_set_id":66,"customer.shipping.country":"Canada","customer.shipping.postal_code":"R3T345"}]},{"name":"ZONE","value":"north-america-05","operator":"ONE_OF","type":"FIELD_SET","field_sets":[{"field_set_id":71,"customer.shipping.country":"United States of America","customer.shipping.postal_code":"R3Y0L6"},{"field_set_id":72,"customer.shipping.country":"United States of America","customer.shipping.postal_code":"R3T5Y3"}]}]},"pagination":{"total":2,"count":2,"per_page":50,"current_page":1,"total_pages":1}}}}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"schema":{"type":"string"},"in":"query","name":"deep","description":"If this flag is true, all the details of the Order Condition will be included in the response. Otherwise, only basic information (name, value, etc.) will be returned."},{"schema":{"type":"integer"},"in":"query","name":"page","description":"The desired page number for the paginated result (default is 1)."},{"schema":{"type":"integer"},"in":"query","name":"limit","description":"Size of the page to be used for the paginated result (default is 50)."}],"description":"List all Order Conditions available for the specified shop. Requires the read_price_order_conditions scope/permission."},"post":{"summary":"Create Order Condition","operationId":"CreateOrderCondition","tags":["Order Conditions"],"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"data":{"type":"object","required":["order_condition"],"properties":{"order_condition":{"type":"object","items":{"$ref":"#/components/schemas/OrderCondition"}}}}},"required":["message","data"]}}}},"400":{"description":"Bad Request"},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"409":{"description":"Conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Request Entity Too Large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Unprocessable Entity (WebDAV)"},"500":{"description":"Internal Server Error"}},"description":"Creates an Order Condition. Requires the write_price_order_conditions scope/permission.","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrderCondition"},"examples":{"create-order-condition-example":{"value":{"name":"zone","value":"north-america-05","operator":"ONE_OF","type":"FIELD_SET","field_sets":[{"customer.shipping.postal_code":"90210","customer.shipping.country_code":"US"},{"customer.shipping.postal_code":"55555","customer.shipping.country_code":"US"}]}}}}}}}},"/price_rules/rules/v2/shops/{shop_identifier}/order_condition/condition_name/{condition_name}/condition_value/{condition_value}":{"parameters":[{"schema":{"type":"string"},"name":"shop_identifier","in":"path","required":true,"description":"Bold platform identifier for the shop. Find this identifier using the [Get Shop Info](shops#operation/GetShopInfo) endpoint."},{"schema":{"type":"string"},"name":"condition_name","in":"path","required":true,"description":"Name of the condition. This can be used to group similar options that depend on the same piece of data. For example, it is possible to have several Order Conditions with the same name (DELIVERY_ZONE) and different values (NorthAmerica, Europe) that evaluate the same fields (country, city and postal code)."},{"schema":{"type":"string"},"name":"condition_value","in":"path","required":true,"description":"Value of the condition. This describes an option available for a collection of conditions that share the same name. Discounts will be applied based on the presence of a specific \\"name:value\\" pair. It is possible to have several Order Conditions with identical names (DELIVERY_ZONE) and different values/options (NorthAmerica, Europe) as long as they evaluate the same fields (country, city and postal code)."}],"get":{"summary":"Get Order Condition","operationId":"GetOrderCondition","tags":["Order Conditions"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"data":{"type":"object","properties":{"order_condition":{"$ref":"#/components/schemas/OrderCondition"}}}}},"examples":{"200-response-example":{"value":{"message":"Successfully fetched order condition","data":{"order_condition":{"name":"ZONE","value":"Prairies","operator":"ONE_OF","type":"FIELD_SET","field_sets":[{"field_set_id":71,"customer.shipping.country":"Canada","customer.shipping.postal_code":"R3Y0L6"},{"field_set_id":72,"customer.shipping.country":"Canada","customer.shipping.postal_code":"R3T5Y3"}]}}}}}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"description":"Gets an Order Condition by its name and value. Requires the read_price_order_conditions scope/permission."},"delete":{"summary":"Delete Order Condition by Name and Value","operationId":"DeleteOrderConditionByNameAndValue","tags":["Order Conditions"],"responses":{"204":{"description":"No Content"},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"description":"Delete an Order Condition by condition_name and condition_value. Requires the write_price_order_conditions scope/permission."},"put":{"summary":"Update Order Condition","operationId":"UpdateOrderCondition","tags":["Order Conditions"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"data":{"type":"object","properties":{"order_condition":{"$ref":"#/components/schemas/OrderCondition"}}}}},"examples":{"200-response-example":{"value":{"message":"Successfully updated order condition","data":{"order_condition":{"name":"ZONE","value":"north-america-01","operator":"ONE_OF","type":"FIELD_SET","field_sets":[{"field_set_id":82,"customer.shipping.country":"United States of America","customer.shipping.postal_code":"91210"},{"field_set_id":83,"customer.shipping.country":"United States of America","customer.shipping.postal_code":"99999"}]}}}}}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Request Entity Too Large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Unprocessable Entity (WebDAV)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"description":"Updates an Order Condition. Requires the write_price_order_conditions scope/permission.","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrderCondition"},"examples":{"update-order-condition-example":{"value":{"name":"ZONE","value":"north-america-01","operator":"ONE_OF","type":"FIELD_SET","field_sets":[{"field_set_id":3,"customer.shipping.country":"United States of America","customer.shipping.postal_code":"91210"},{"customer.shipping.country":"United States of America","customer.shipping.postal_code":"99999"}]}}}}}}}},"/price_rules/rules/v2/shops/{shop_identifier}/order_condition/valid_fields":{"parameters":[{"schema":{"type":"string"},"name":"shop_identifier","in":"path","required":true,"description":"Bold platform identifier for the shop. Find this identifier using the [Get Shop Info](shops#operation/GetShopInfo) endpoint."}],"get":{"summary":"List Valid Fields for Order Condition","operationId":"ListValidFieldsForOrderCondition","tags":["Order Conditions"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"data":{"type":"object","properties":{"field_names":{"type":"array","items":{"type":"string"}}}}}},"examples":{"200-response-example":{"value":{"message":"Successfully fetched valid field names","data":{"field_names":["customer.shipping.country","customer.shipping.country_code","customer.shipping.postal_code","customer.shipping.province","customer.shipping.province_code"]}}}}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"description":"Gets a list of all the shop/customer fields that can be evaluated in an Order Condition. Requires the read_price_order_conditions scope/permission."}},"/price_rules/rules/v2/shops/{shop_identifier}/order_condition/condition_name/{condition_name}":{"parameters":[{"schema":{"type":"string"},"name":"shop_identifier","in":"path","required":true,"description":"Bold platform identifier for the shop. Find this identifier using the [Get Shop Info](shops#operation/GetShopInfo) endpoint."},{"schema":{"type":"string"},"name":"condition_name","in":"path","required":true,"description":"The name and value of an Order Condition are a combination that uniquely identifies that condition."}],"delete":{"summary":"Delete Order Condition by Name","operationId":"DeleteOrderConditionByName","tags":["Order Conditions"],"responses":{"204":{"description":"No Content"},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"description":"Delete a collection of Order Conditions that share the same name, for example all the DELIVERY_ZONE Order Conditions regardless of their values (NorthAmerica, Europe, etc.). Requires the write_price_order_conditions scope/permission.","parameters":[{"schema":{"type":"string"},"in":"query","name":"condition_name","description":"Name of the condition.","required":true}]}},"/price_rules/rules/v2/shops/{shop_identifier}/order_condition/condition_name/{condition_name}/field_name/{field_name}":{"parameters":[{"schema":{"type":"string"},"name":"shop_identifier","in":"path","required":true,"description":"Bold platform identifier for the shop. Find this identifier using the [Get Shop Info](shops#operation/GetShopInfo) endpoint."},{"schema":{"type":"string"},"name":"condition_name","in":"path","required":true,"description":"The name and value of an Order Condition are a combination that uniquely identifies that condition."},{"schema":{"type":"string"},"name":"field_name","in":"path","required":true,"description":"Field that should be deleted, for example \\"customer.shipping.province\\"."}],"delete":{"summary":"Delete Order Condition Field by Name","operationId":"DeleteOrderConditionFieldByName","tags":["Order Conditions"],"responses":{"204":{"description":"No Content"},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"description":"Delete a field from all the Order Conditions that share the same name. For example, if a list of DELIVERY_ZONE conditions were evaluating both city and postal code before, and now they should check the postal code only, then the irrelevant field (city) can be erased by this operation. Requires the write_price_order_conditions scope/permission."}},"/price_rules/rules/v2/shops/{shop_identifier}/order_condition/field_sets/add":{"parameters":[{"schema":{"type":"string"},"name":"shop_identifier","in":"path","required":true,"description":"Bold platform identifier for the shop. Find this identifier using the [Get Shop Info](shops#operation/GetShopInfo) endpoint."}],"patch":{"summary":"Add Field Sets to Order Condition","operationId":"AddFieldSetsToOrderCondition","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"data":{"type":"object","properties":{"order_condition":{"$ref":"#/components/schemas/OrderCondition"},"field_sets_added":{"type":"array","description":"This operation returns only the Field Sets that were added, not the complete list.","items":{"$ref":"#/components/schemas/FieldSet"}}}}}},"examples":{"200-response-example":{"value":{"message":"Successfully added field set(s) to order condition","data":{"order_condition":{"name":"ZONE","value":"Prairies","operator":"ONE_OF","type":"FIELD_SET"},"field_sets_added":[{"field_set_id":76,"customer.shipping.country":"United States of America","customer.shipping.postal_code":"98765"},{"field_set_id":77,"customer.shipping.country":"United States of America","customer.shipping.postal_code":"43210"},{"field_set_id":78,"customer.shipping.country":"United States of America","customer.shipping.postal_code":"88888"}]}}}}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"description":"Adds one or more new Field Sets to a specific Order Condition. Requires the write_price_order_conditions scope/permission.","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","description":"The name and value of an Order Condition are a combination that uniquely identifies that condition."},"value":{"type":"string","description":"The name and value of an Order Condition are a combination that uniquely identifies that condition."},"field_sets":{"type":"array","description":"Field sets to be added.","items":{"$ref":"#/components/schemas/FieldSet"}}}},"examples":{"add-fieldsets-example":{"value":{"name":"ZONE","value":"north-america-05","field_sets":[{"customer.shipping.country":"United States of America","customer.shipping.postal_code":"98765"},{"customer.shipping.country":"United States of America","customer.shipping.postal_code":"43210"},{"customer.shipping.country":"United States of America","customer.shipping.postal_code":"88888"}]}}}}}},"tags":["Order Conditions"]}},"/price_rules/rules/v2/shops/{shop_identifier}/order_condition/field_sets/remove":{"parameters":[{"schema":{"type":"string"},"name":"shop_identifier","in":"path","required":true,"description":"Bold platform identifier for the shop. Find this identifier using the [Get Shop Info](shops#operation/GetShopInfo) endpoint."}],"patch":{"summary":"Delete Field Sets from Order Condition","operationId":"DeleteFieldSetsFromOrderCondition","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"data":{"type":"object","properties":{"order_condition":{"type":"object","properties":{"name":{"type":"string","description":"The name and value of an Order Condition are a combination that uniquely identifies that condition."},"value":{"type":"string","description":"The name and value of an Order Condition are a combination that uniquely identifies that condition."},"":{"type":"string"}}}}}}},"examples":{"200-response-example":{"value":{"message":"Successfully removed 3 field set(s) from order condition","data":{"order_condition":{"name":"ZONE","value":"north-america-05"}}}}}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"description":"Remove one or more existent Field Sets from a specific Order Condition. Requires the write_price_order_conditions scope/permission.","tags":["Order Conditions"],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","description":"The name and value of an Order Condition are a combination that uniquely identifies that condition."},"value":{"type":"string","description":"The name and value of an Order Condition are a combination that uniquely identifies that condition."},"field_set_ids":{"type":"array","description":"List containing the ids of each Field Set that should be removed.","items":{}}}},"examples":{"remove-field-sets-example":{"value":{"name":"ZONE","value":"north-america-05","field_set_ids":[69,70,73]}}}}}}}},"/price_rules/rules/v2/shops/{shop_identifier}/order_condition/condition_name/{condition_name}/condition_value/{condition_value}/field_sets":{"parameters":[{"schema":{"type":"string"},"name":"shop_identifier","in":"path","required":true,"description":"Bold platform identifier for the shop. Find this identifier using the [Get Shop Info](shops#operation/GetShopInfo) endpoint."},{"schema":{"type":"string"},"name":"condition_name","in":"path","required":true,"description":"Name of the condition. This can be used to group similar options that depend on the same piece of data. For example, it is possible to have several Order Conditions with the same name (DELIVERY_ZONE) and different values (NorthAmerica, Europe) that evaluate the same fields (country, city and postal code)."},{"schema":{"type":"string"},"name":"condition_value","in":"path","required":true,"description":"Value of the condition. This describes an option available for a collection of conditions that share the same name. Discounts will be applied based on the presence of a specific \\"name:value\\" pair. It is possible to have several Order Conditions with the identical names (DELIVERY_ZONE) and different values/options (NorthAmerica, Europe) as long as they evaluate the same fields (country, city and postal code)."}],"get":{"summary":"List Matching Field Sets for Order Condition","operationId":"ListMatchingFieldSetsForOrderCondition","tags":["Order Conditions"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"data":{"type":"object","properties":{"field_sets":{"type":"array","items":{"$ref":"#/components/schemas/FieldSet"}}}},"pagination":{"$ref":"#/components/schemas/Pagination"}}},"examples":{"200-response-example":{"value":{"message":"Successfully fetched matched field sets for order condition","data":{"field_sets":[{"field_set_id":71,"customer.shipping.country":"United States of America","customer.shipping.postal_code":"R3Y0L6"},{"field_set_id":72,"customer.shipping.country":"United States of America","customer.shipping.postal_code":"R3T5Y3"}]},"pagination":{"total":2,"count":2,"per_page":50,"current_page":1,"total_pages":1}}}}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"description":"Gets all the sets of fields that are valid/that comply with an Order Condition. An Order Condition can be matched by different sets of data, for example \'DELIVERY_ZONE: NorthAmerica\' could include a lot of possible country + postal code combinations. Requires the read_price_order_conditions scope/permission.","parameters":[{"schema":{"type":"string"},"in":"query","name":"page","description":"The desired page number for the paginated result (default is 1)."},{"schema":{"type":"string"},"in":"query","name":"limit","description":"Size of the page to be used for the paginated result (default is 50)."}]}},"/price_rules/rules/v2/shops/{shop_identifier}/order_condition/condition_name/{condition_name}/validate":{"parameters":[{"schema":{"type":"string"},"name":"shop_identifier","in":"path","required":true,"description":"Bold platform identifier for the shop. Find this identifier using the [Get Shop Info](shops#operation/GetShopInfo) endpoint."},{"schema":{"type":"string"},"name":"condition_name","in":"path","required":true,"description":"Name of the condition. This can be used to group similar options that depend on the same piece of data. For example, it is possible to have several Order Conditions with the same name (DELIVERY_ZONE) and different values (NorthAmerica, Europe) that evaluate the same fields (country, city and postal code)."}],"get":{"summary":"Validate Order Condition Group","operationId":"ValidateOrderConditionGroup","tags":["Order Conditions"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","description":"The message contains the result of the Order Condition group analysis"},"data":{"type":"array","description":"Data for this operation will be always empty","items":{"type":"object"}}}},"examples":{"200-response-example":{"value":{"message":"Order condition \'ZONE: North-America-05\' has one or more field sets that are missing field(s). Order condition \'ZONE: North-America-10\' has one or more field sets that contain unexpected fields. Order condition \'ZONE: Europe-07\' has one or more field sets that are missing field(s). Expected fields for the \'ZONE\' group are: [customer.shipping.country, customer.shipping.postal_code]","data":[]}}}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"description":"This endpoint can be used to check internal inconsistencies between an Order Condition group (a set of conditions that share the same condition_name). All Order Conditions that share a name should evaluate the same fields.\\n\\nFor example: If a shop has a condition \\"name: zone, value: north-america-05\\" that contains several combinations of country and postal code on its field sets, when a new condition \\"name: zone, value: europe-01\\" is created on the same shop it should also use country and postal code to define its field sets.\\n\\nRequires the read_price_order_conditions scope/permission."}},"/price_rules/rules/v2/shops/{shop_identifier}/process":{"parameters":[{"schema":{"type":"string"},"name":"shop_identifier","in":"path","required":true,"description":"Bold platform identifier for the shop. Find this identifier using the [Get Shop Info](shops#operation/GetShopInfo) endpoint."}],"post":{"summary":"Get Adjusted Cart","operationId":"GetAdjustedCart","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"pre_checkout_id":{"type":"string"},"actions":{"type":"array","items":{"$ref":"#/components/schemas/CartAction"}}}},"examples":{"example adjusted cart response":{"value":{"pre_checkout_id":"POS_123","actions":[{"key":"uniquekey1","price":10,"matchValue":"123","quantity":2,"rule":[{"id":1,"rule_set_id":1,"rule_set_eid":"ruleset_eid"}]},{"key":"uniquekey2","price":12,"matchValue":"223","quantity":1,"rule":[{"id":1,"rule_set_id":1,"rule_set_eid":"ruleset_eid"}]}]}}}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"examples":{"401-error-example":{"value":{"message":"This request failed to be authenticated.","code":"00-1","type":"authentication.failed"}}}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"examples":{"403-error-example":{"value":{"message":"This request does not contain the necessary permissions to access the target endpoint.","code":"00-2","type":"authorization.invalid_scopes"}}}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"examples":{"500-error-example":{"value":{"message":"Error with fetching a ruleset","code":"04-0","type":"unexpected"}}}}}}},"description":"Return final price for lineItem in a cart. This requires read_price_rulesets scope/permission.","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"lineItems":{"type":"array","items":{"$ref":"#/components/schemas/ProcessLineItem"}},"matchLineItemProperty":{"type":"string","enum":["sku"]},"customer":{"$ref":"#/components/schemas/Customer"}},"required":["lineItems","matchLineItemProperty"]},"examples":{"example cart payload":{"value":{"lineItems":[{"key":"uniquekey1","price":12,"matchValue":"123","quantity":2},{"key":"uniquekey2","price":15,"matchValue":"223","quantity":1}],"matchLineItemProperty":"sku","customer":{"shipping":{"postal_code":"R3Y0X5"}}}}}}}},"tags":["Rulesets"]}},"/price_rules/storefront/v2/shops/{shop_identifier}/price":{"parameters":[{"schema":{"type":"string"},"name":"shop_identifier","in":"path","required":true,"description":"Bold platform identifier for the shop. Find this identifier using the [Get Shop Info](shops#operation/GetShopInfo) endpoint."}],"post":{"summary":"Get Final Price for Product","operationId":"GetFinalPriceForProduct","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"pre_best_price_log_id":{"type":"string"},"actions":{"type":"array","items":{"$ref":"#/components/schemas/BestProductPriceAction"}}}}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"description":"Return the final price for item. This requires no special permissions.","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/BestProductPriceItem"}},"cart_params":{"type":"object","description":"Supply optional parameters, such as orderData and source"},"lineItemIdType":{"type":"string","enum":["sku"]},"customer":{"$ref":"#/components/schemas/TaggedCustomer"}},"required":["items","lineItemIdType"]},"examples":{"example-1":{"value":{"lineItemIdType":"sku","items":[{"price":0,"id":"number","quantity":0}],"cart_params":{},"customer":{"tags":"string","shipping":{"postal_code":"string","country":"string","country_code":"string","province":"string","province_code":"string"}}}}}}},"description":""},"tags":["Storefronts"]}},"/price_rules/storefront/v2/currency/{currency_name}":{"parameters":[{"schema":{"type":"string"},"name":"currency_name","in":"path","required":true,"description":"Currency Code (ie. USD, CAD, GDP). Can be optained through: https://www.iban.com/currency-codes"}],"get":{"summary":"Get Currency Symbol for Currency Code","operationId":"GetCurrencySymbolForCurrencyCode","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"description":"","type":"object","properties":{"id":{"type":"number"},"currency_iso_name":{"type":"string","minLength":1},"friendly_name":{"type":"string","minLength":1},"currency_symbol":{"type":"string","minLength":1},"money_format":{"type":"string","minLength":1},"money_with_currency_format":{"type":"string","minLength":1}},"required":["id","currency_iso_name","friendly_name","currency_symbol","money_format","money_with_currency_format"]},"examples":{"200-response-example":{"value":{"id":181,"currency_iso_name":"CAD","friendly_name":"Canadian Dollar","currency_symbol":"$","money_format":"${{amount}}","money_with_currency_format":"${{amount}} CAD"}}}}}}},"description":"Get Currency information from a currency code (ie. USD, CAD, GDP). Can be obtained through: https://www.iban.com/currency-codes","tags":["Storefronts"],"parameters":[]}},"/price_rules/storefront/v2/shops/{shop_identifier}/cart":{"parameters":[{"schema":{"type":"string"},"name":"shop_identifier","in":"path","required":true,"description":"Bold platform identifier for the shop. Find this identifier using the [Get Shop Info](shops#operation/GetShopInfo) endpoint."}],"post":{"summary":"Get Best Price for Cart","operationId":"GetBestPriceForCart","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"pre_checkout_id":{"type":"string"},"actions":{"type":"array","items":{"$ref":"#/components/schemas/CartAction"}}}},"examples":{"example adjusted cart response":{"value":{"pre_checkout_id":"POS_123","actions":[{"line_item_key":"uniquekey1","value":10,"sku":"123","variant_id":49702426812601,"rule":[{"id":1593607,"eid":"rule_id","rule_set_id":101480,"rule_set_eid":"ruleset_eid","rule_set_public_message":"","type":"DISCOUNT"}]},{"line_item_key":"uniquekey2","value":12,"sku":"223","variant_id":29702426812602,"rule":[{"id":5593607,"eid":"rule_id_2","rule_set_id":601480,"rule_set_eid":"ruleset_eid_2","rule_set_public_message":"A public message","type":"DISCOUNT"}]}]}}}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"examples":{"500-error-example":{"value":{"message":"Error with fetching a ruleset","code":"04-0","type":"unexpected"}}}}}}},"description":"Return final price for lineItem in a cart. This requires no special permissions.","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"lineItems":{"type":"array","items":{"$ref":"#/components/schemas/LineItem"}},"lineItemIdType":{"type":"string","enum":["sku"]},"customer":{"$ref":"#/components/schemas/TaggedCustomer"}},"required":["lineItems","lineItemIdType"]},"examples":{"example cart payload":{"value":{"lineItems":[{"key":"uniquekey1","price":12,"id":"123","quantity":2},{"key":"uniquekey2","price":15,"id":"223","quantity":1}],"lineItemIdType":"sku","customer":{"email":"user@example.com"}}}}}}},"tags":["Storefronts"]}},"/price_rules/rules/v2/shops/{shop_identifier}/rulesets/eid/{external_id}/rules/remove":{"parameters":[{"schema":{"type":"string"},"name":"shop_identifier","in":"path","required":true,"description":"Bold platform identifier for the shop. Find this identifier using the [Get Shop Info](shops#operation/GetShopInfo) endpoint."},{"schema":{"type":"string"},"name":"external_id","in":"path","required":true}],"patch":{"summary":"Bulk Delete Rules by Ruleset EID","operationId":"BulkDeleteRulesByRulesetEID","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}}},"examples":{"sample response":{"value":{"message":"Successfully removed 2 rules from ruleset with rulesetId:1"}}}}}}},"description":"Remove one or more existent rules from a specific Ruleset. Requires the write_price_rulesets scope/permission.","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"rule_ids":{"type":"array","items":{"type":"integer"}}},"required":["rule_ids"]},"examples":{"Payload example":{"value":{"rule_ids":[1,2]}}}}},"description":""},"parameters":[],"tags":["Rules"]}},"/price_rules/rules/v2/shops/{shop_identifier}/rulesets/{ruleset_id}/rules/remove":{"parameters":[{"schema":{"type":"string"},"name":"shop_identifier","in":"path","required":true,"description":"Bold platform identifier for the shop. Find this identifier using the [Get Shop Info](shops#operation/GetShopInfo) endpoint."},{"schema":{"type":"string"},"name":"ruleset_id","in":"path","required":true}],"patch":{"summary":"Bulk Delete Rules by Ruleset ID","operationId":"BulkDeleteRulesByRulesetID","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}}},"examples":{"sample response":{"value":{"message":"Successfully removed 2 rules from ruleset with rulesetId:1"}}}}}}},"description":"Remove one or more existent rules from a specific Ruleset. Requires the write_price_rulesets scope/permission.","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"rule_ids":{"type":"array","items":{"type":"integer"}}},"required":["rule_ids"]},"examples":{"Payload example":{"value":{"rule_ids":[1,2]}}}}},"description":""},"tags":["Rules"]}},"/price_rules/rules/v2/shops/{shop_identifier}/discount_codes":{"parameters":[{"schema":{"type":"string"},"name":"shop_identifier","in":"path","required":true,"description":"Bold platform identifier for the shop. Find this identifier using the [Get Shop Info](shops#operation/GetShopInfo) endpoint."}],"post":{"summary":"Create Discount Code","operationId":"CreateDiscountCode","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","description":"The message contains the result of this operation."},"data":{"type":"object","properties":{"discount_codes":{"type":"array","items":{"$ref":"#/components/schemas/DiscountCode"}}}}}},"examples":{"200-response-example":{"value":{"message":"Discount code(s) created successfully!","data":{"discount_codes":[{"code":"BACK_TO_SCHOOL","updated_at":"2020-09-16T20:39:57.000000Z","created_at":"2020-09-16T20:39:57.000000Z","id":8,"ruleset":{"id":"20","external_id":"RELATED_TO_DISCOUNT_CODE_BACK_TO_SCHOOL","active":true,"internal_name":"RELATED_TO_DISCOUNT_CODE_BACK_TO_SCHOOL","created_at":"2020-09-16T15:39:56Z","updated_at":"2020-09-16T15:39:56Z","rules":[{"type":"DISCOUNT_CODE","conditions":[{"type":"DISCOUNT_CODE","value":"BACK_TO_SCHOOL"}],"actions":[{"type":"PRICE_ADJUST_PERCENT","value":-10}]}],"product_selection":{"product_ids":["1234567890123","1234567890456"],"type":"PRODUCT_SEARCH"}}},{"code":"BLACKFRIDAY","updated_at":"2020-09-16T20:39:57.000000Z","created_at":"2020-09-16T20:39:57.000000Z","id":9,"ruleset":{"id":"21","external_id":"RELATED_TO_DISCOUNT_CODE_BLACKFRIDAY","active":true,"internal_name":"RELATED_TO_DISCOUNT_CODE_BLACKFRIDAY","created_at":"2020-09-16T15:39:57Z","updated_at":"2020-09-16T15:39:57Z","rules":[{"type":"DISCOUNT_CODE","conditions":[{"type":"DISCOUNT_CODE","value":"BLACKFRIDAY"}],"actions":[{"type":"PRICE_ADJUST_PERCENT","value":-10}]}],"product_selection":{"product_ids":["1234567890123","1234567890456"],"type":"PRODUCT_SEARCH"}}}]}}}}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Unprocessable Entity (WebDAV)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"description":"Create one or more discount codes for the specified shop. This requires write_discount_codes scope/permission. Bold automatically assigns a `DISCOUNT_CODE` rule condition type to every discount code created.","tags":["Discount Codes"],"requestBody":{"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"discount_code":{"$ref":"#/components/schemas/CreateDiscountCode"}},"required":["discount_code"]},"examples":{"body-example":{"value":{"discount_code":{"codes":["BACK_TO_SCHOOL","BLACKFRIDAY"],"limits":[{"limit_type":"per_shop","limit_amount":1000}],"product_selection":{"type":"PRODUCT_SEARCH","product_ids":["1234567890123","1234567890456"]},"conditions":[{"type":"CART_SUBTOTAL_MIN","value":5000}],"action":{"type":"PRICE_ADJUST_PERCENT","value":-10}}}}}}},"description":"Initial data needed to configure the new discount code(s)."}},"get":{"summary":"List Discount Codes","operationId":"ListDiscountCodes","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","description":"The message contains the result of this operation."},"data":{"type":"object","properties":{"discount_codes":{"type":"array","items":{"$ref":"#/components/schemas/DiscountCode"}}}}}},"examples":{"200-response-example":{"value":{"message":"Successfully fetched discount codes","data":{"discount_codes":[{"id":18,"code":"BLACKFRIDAY","created_at":"2020-09-24T13:51:23.000000Z","updated_at":"2020-09-28T15:47:43.000000Z","ruleset":{"id":"51","external_id":"RELATED_TO_DISCOUNT_CODE_BLACKFRIDAY","active":true,"internal_name":"RELATED_TO_DISCOUNT_CODE_BLACKFRIDAY","created_at":"2020-09-28T10:47:43Z","updated_at":"2020-09-28T15:47:44Z","rules":[{"type":"DISCOUNT_CODE","conditions":[{"type":"DISCOUNT_CODE","value":"BLACKFRIDAY"}],"actions":[{"type":"PRICE_ADJUST_PERCENT","value":-10}]}],"product_selection":{"product_ids":["9876543210123","9876543210987"],"type":"PRODUCT_SEARCH"}}},{"id":20,"code":"SUPER_SALE_2020","created_at":"2020-09-28T21:21:37.000000Z","updated_at":"2020-09-28T21:21:37.000000Z","ruleset":{"id":"52","external_id":"RELATED_TO_DISCOUNT_CODE_SUPER_SALE_2020","active":true,"internal_name":"RELATED_TO_DISCOUNT_CODE_SUPER_SALE_2020","created_at":"2020-09-28T16:21:37Z","updated_at":"2020-09-28T21:21:38Z","rules":[{"type":"DISCOUNT_CODE","conditions":[{"type":"DISCOUNT_CODE","value":"SUPER_SALE_2020"}],"actions":[{"type":"PRICE_ADJUST_PERCENT","value":-15}]}],"product_selection":{"product_ids":["1234567890123","1234567890987"],"type":"PRODUCT_SEARCH"}}},{"id":21,"code":"1STORDERBONUS","created_at":"2020-09-28T21:21:37.000000Z","updated_at":"2020-09-28T21:21:37.000000Z","ruleset":{"id":"53","external_id":"RELATED_TO_DISCOUNT_CODE_1STORDERBONUS","active":true,"internal_name":"RELATED_TO_DISCOUNT_CODE_1STORDERBONUS","created_at":"2020-09-28T16:21:37Z","updated_at":"2020-09-28T21:21:38Z","rules":[{"type":"DISCOUNT_CODE","conditions":[{"type":"DISCOUNT_CODE","value":"1STORDERBONUS"}],"actions":[{"type":"PRICE_ADJUST_RELATIVE","value":-599}]}],"product_selection":{"product_ids":["9876543210123","9876543210987"],"type":"PRODUCT_SEARCH"}}}]},"pagination":{"total":3,"count":3,"per_page":50,"current_page":1,"total_pages":1}}}}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Unprocessable Entity (WebDAV)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"description":"List all discount codes available for the specified shop. Requires the read_discount_codes scope/permission. Bold automatically assigns a `DISCOUNT_CODE` rule condition type to every discount code created.","tags":["Discount Codes"],"parameters":[{"schema":{"type":"integer"},"in":"query","name":"page","description":"The desired page number for the paginated result (default is 1)."},{"schema":{"type":"integer"},"in":"query","name":"limit","description":"Size of the page to be used for the paginated result (default is 50)."},{"schema":{"type":"string","enum":["ACTIVE","SCHEDULED","EXPIRED"]},"in":"query","name":"status","description":"Filter the results based on status"},{"schema":{"type":"string"},"in":"query","name":"name","description":"The name of the discount code"}]}},"/price_rules/rules/v2/shops/{shop_identifier}/discount_codes/{discount_code_id}":{"parameters":[{"schema":{"type":"string"},"name":"shop_identifier","in":"path","required":true,"description":"Bold platform identifier for the shop. Find this identifier using the [Get Shop Info](shops#operation/GetShopInfo) endpoint."},{"schema":{"type":"integer"},"name":"discount_code_id","in":"path","required":true,"description":"The discount code unique identifier in the database"}],"put":{"summary":"Update Discount Code","operationId":"UpdateDiscountCode","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","description":"The message contains the result of this operation."},"data":{"type":"object","properties":{"discount_code":{"$ref":"#/components/schemas/DiscountCode"}}}}},"examples":{"200-response-example":{"value":{"message":"Discount code updated successfully!","data":{"discount_code":{"id":15,"code":"SOME_EXISTENT_DISCOUNT_CODE","created_at":"2020-09-22T20:39:39.000000Z","updated_at":"2020-09-23T18:54:46.000000Z","ruleset":{"id":"34","external_id":"RELATED_TO_DISCOUNT_CODE_SOME_EXISTENT_DISCOUNT_CODE","active":true,"internal_name":"RELATED_TO_DISCOUNT_CODE_SOME_EXISTENT_DISCOUNT_CODE","created_at":"2020-09-23T13:54:46Z","updated_at":"2020-09-23T13:54:46Z","rules":[{"type":"DISCOUNT_CODE","conditions":[{"type":"DISCOUNT_CODE","value":"SOME_EXISTENT_DISCOUNT_CODE"}],"actions":[{"type":"PRICE_ADJUST_RELATIVE","value":-15}]}],"product_selection":{"product_ids":["4567890123456","4567890987654"],"type":"PRODUCT_SEARCH"}}}}}}}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Unprocessable Entity (WebDAV)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"description":"Update an existing discount code available for the specified shop. This requires write_discount_codes scope/permission.","requestBody":{"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"discount_code":{"$ref":"#/components/schemas/UpdateDiscountCode"}},"required":["discount_code"]},"examples":{"body-example":{"value":{"discount_code":{"code":"SOME_EXISTENT_DISCOUNT_CODE","limit":{"limit_type":"per_customer","limit_amount":5},"product_selection":{"type":"PRODUCT_SEARCH","product_ids":["4567890123456","4567890987654"]},"action":{"type":"PRICE_ADJUST_RELATIVE","value":-15}}}}}}},"description":"Target values for the discount code after update; all fields should be passed, fields that are not intended to change should contain their current values."},"tags":["Discount Codes"]},"get":{"summary":"Get Discount Code by ID","operationId":"GetDiscountCodeByID","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","description":"The message contains the result of this operation."},"data":{"type":"object","properties":{"discount_code":{"$ref":"#/components/schemas/DiscountCode"}}}}},"examples":{"200-response-example":{"value":{"message":"Successfully fetched discount code by id","data":{"discount_code":{"id":18,"code":"BLACKFRIDAY","created_at":"2020-09-24T13:51:23.000000Z","updated_at":"2020-09-25T21:27:14.000000Z","ruleset":{"id":"50","external_id":"RELATED_TO_DISCOUNT_CODE_BLACKFRIDAY","active":true,"internal_name":"RELATED_TO_DISCOUNT_CODE_BLACKFRIDAY","created_at":"2020-09-25T16:27:13Z","updated_at":"2020-09-25T16:27:13Z","rules":[{"type":"DISCOUNT_CODE","conditions":[{"type":"DISCOUNT_CODE","value":"BLACKFRIDAY"}],"actions":[{"type":"PRICE_ADJUST_PERCENT","value":-10}]}],"product_selection":{"product_ids":["1234567890123","1234567890987"],"type":"PRODUCT_SEARCH"}}}}}}}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Unprocessable Entity (WebDAV)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"description":"Return data for a specific discount code, selected by the discount code ID. This requires read_discount_codes scope/permission.","tags":["Discount Codes"]},"delete":{"summary":"Delete Discount Code","operationId":"DeleteDiscountCode","responses":{"204":{"description":"No Content"},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"tags":["Discount Codes"],"description":"Remove an existing discount code available for the specified shop. This requires write_discount_codes scope/permission."}},"/price_rules/rules/v2/shops/{shop_identifier}/rulesets/{ruleset_id}/discount_codes":{"parameters":[{"schema":{"type":"string"},"name":"shop_identifier","in":"path","required":true,"description":"Bold platform identifier for the shop. Find this identifier using the [Get Shop Info](shops#operation/GetShopInfo) endpoint."},{"schema":{"type":"string"},"name":"ruleset_id","in":"path","required":true,"description":"The database ID for the ruleset that describes the discount code behaviour."}],"get":{"summary":"Get Discount Code by Ruleset ID","operationId":"GetDiscountCodeByRulesetID","tags":["Discount Codes"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","description":"The message contains the result of this operation."},"data":{"type":"object","properties":{"discount_code":{"$ref":"#/components/schemas/DiscountCode"}}}}},"examples":{"200-response-example":{"value":{"message":"Successfully fetched discount code for ruleset","data":{"discount_code":{"id":29,"code":"TOP_CLEARANCE_10%","created_at":"2020-09-29T20:28:31.000000Z","updated_at":"2020-09-29T20:34:26.000000Z","ruleset":{"id":"63","external_id":"RELATED_TO_DISCOUNT_CODE_TOP_CLEARANCE_10%","active":true,"internal_name":"RELATED_TO_DISCOUNT_CODE_TOP_CLEARANCE_10%","created_at":"2020-09-29T15:34:26Z","updated_at":"2020-09-29T20:34:27Z","rules":[{"type":"DISCOUNT_CODE","conditions":[{"type":"DISCOUNT_CODE","value":"TOP_CLEARANCE_10%"}],"actions":[{"type":"PRICE_ADJUST_PERCENT","value":-10}]}],"product_selection":{"product_ids":["9998887770123","9998887770456","9998887770789"],"type":"PRODUCT_SEARCH"}}}}}}}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Unprocessable Entity (WebDAV)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"description":"Return data for a specific discount code, selected by the related ruleset ID. This requires read_discount_codes scope/permission."}},"/price_rules/rules/v2/shops/{shop_identifier}/rulesets/eid/{external_id}/rules/eid/{rule_external_id}":{"parameters":[{"schema":{"type":"string"},"name":"shop_identifier","in":"path","required":true,"description":"Bold platform identifier for the shop. Find this identifier using the [Get Shop Info](shops#operation/GetShopInfo) endpoint."},{"schema":{"type":"string"},"name":"external_id","in":"path","required":true},{"schema":{"type":"string"},"name":"rule_external_id","in":"path","required":true}],"put":{"summary":"Update Rule by Ruleset EID and Rule EID","operationId":"UpdateRuleByRulesetEIDRuleEID","tags":["Rules"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"data":{"$ref":"#/components/schemas/RuleResponse"}}}}}},"400":{"description":"Bad Request"},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"404":{"description":"Not Found"},"409":{"description":"Conflict"},"500":{"description":"Internal Server Error"}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"rule":{"$ref":"#/components/schemas/Rule"}},"required":["rule"]}}}},"description":"Update a Rule by using the Ruleset external_id and Rule external_id.\\n\\nRequires the check_write_rulesets_permission scope/permission."}},"/price_rules/rules/v2/shops/{shop_identifier}/rulesets/eid/{external_id}/rules/add":{"parameters":[{"schema":{"type":"string"},"name":"external_id","in":"path","required":true},{"schema":{"type":"string"},"name":"shop_identifier","in":"path","required":true,"description":"Bold platform identifier for the shop. Find this identifier using the [Get Shop Info](shops#operation/GetShopInfo) endpoint."}],"patch":{"summary":"Bulk Add Rules by Ruleset EID","operationId":"BulkAddRulesByRulesetEID","tags":["Rules"],"responses":{"200":{"description":"OK"},"400":{"description":"Bad Request"},"403":{"description":"Forbidden"},"404":{"description":"Not Found"},"409":{"description":"Conflict"},"422":{"description":"Unprocessable Entity (WebDAV)"},"500":{"description":"Internal Server Error"}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"rules":{"type":"array","items":{"$ref":"#/components/schemas/Rule"}}},"required":["rules"]}}},"description":""},"description":"Bulk add Rules to a Ruleset."}},"/price_rules/rules/v2/shops/{shop_identifier}/rulesets/{ruleset_id}/rules/{rule_id}":{"parameters":[{"schema":{"type":"string"},"name":"shop_identifier","in":"path","required":true,"description":"Bold platform identifier for the shop. Find this identifier using the [Get Shop Info](shops#operation/GetShopInfo) endpoint."},{"schema":{"type":"string"},"name":"ruleset_id","in":"path","required":true},{"schema":{"type":"string"},"name":"rule_id","in":"path","required":true}],"put":{"summary":"Update Rule by Ruleset ID and Rule ID","operationId":"UpdateRuleByRulesetIDRuleID","tags":["Rules"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"data":{"$ref":"#/components/schemas/RuleResponse"}}}}}},"400":{"description":"Bad Request"},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"404":{"description":"Not Found"},"409":{"description":"Conflict"},"500":{"description":"Internal Server Error"}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"rule":{"$ref":"#/components/schemas/Rule"}},"required":["rule"]}}}},"description":"Update a Rule by using the Ruleset id and Rule id.\\n\\nRequires the check_write_rulesets_permission scope/permission."},"delete":{"summary":"Remove Rule by Ruleset ID and Rule ID","operationId":"RemoveRuleByRulesetIDRuleID","responses":{"204":{"description":"No Content"},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"examples":{"401-error-example":{"value":{"code":"string","message":"string","type":"string"}}}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"examples":{"403-error-example":{"value":{"code":"string","message":"string","type":"string"}}}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"examples":{"404-error-example":{"value":{"code":"string","message":"string","type":"string"}}}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"description":"Remove one rule from a specific Ruleset. Requires the write_price_rulesets scope/permission.","tags":["Rules"]}},"/price_rules/rules/v2/shops/{shop_identifier}/rulesets/eid/{external_id}/rules/{rule_id}":{"parameters":[{"schema":{"type":"string"},"name":"shop_identifier","in":"path","required":true,"description":"Bold platform identifier for the shop. Find this identifier using the [Get Shop Info](shops#operation/GetShopInfo) endpoint."},{"schema":{"type":"string"},"name":"external_id","in":"path","required":true},{"schema":{"type":"string"},"name":"rule_id","in":"path","required":true}],"put":{"summary":"Update Rule by Ruleset EID and Rule ID","operationId":"UpdateRuleByRulesetEIDRuleID","tags":["Rules"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"data":{"$ref":"#/components/schemas/RuleResponse"}}}}}},"400":{"description":"Bad Request"},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"404":{"description":"Not Found"},"409":{"description":"Conflict"},"500":{"description":"Internal Server Error"}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"rule":{"$ref":"#/components/schemas/Rule"}},"required":["rule"]}}}},"description":"Update a Rule by using the Ruleset external_id and Rule id.\\n\\nRequires the check_write_rulesets_permission scope/permission."},"delete":{"summary":"Delete Rule from Ruleset by Ruleset EID and Rule ID","operationId":"DeleteRuleFromRulesetByRulesetEIDRuleID","responses":{"204":{"description":"No Content"},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"examples":{"example-1":{"value":{"code":"string","message":"string","type":"string"}}}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"description":"Remove one rule from a specific Ruleset. Requires the write_price_rulesets scope/permission.","tags":["Rules"]}},"/price_rules/rules/v2/shops/{shop_identifier}/rulesets/{ruleset_id}/rules/eid/{rule_external_id}":{"parameters":[{"schema":{"type":"string"},"name":"shop_identifier","in":"path","required":true,"description":"Bold platform identifier for the shop. Find this identifier using the [Get Shop Info](shops#operation/GetShopInfo) endpoint."},{"schema":{"type":"string"},"name":"ruleset_id","in":"path","required":true},{"schema":{"type":"string"},"name":"rule_external_id","in":"path","required":true}],"put":{"summary":"Update Rule by Ruleset ID and Rule EID","operationId":"UpdateRuleByRulesetIDRuleEID","tags":["Rules"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"data":{"$ref":"#/components/schemas/RuleResponse"}}}}}},"400":{"description":"Bad Request"},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"404":{"description":"Not Found"},"409":{"description":"Conflict"},"500":{"description":"Internal Server Error"}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"rule":{"$ref":"#/components/schemas/Rule"}},"required":["rule"]}}}},"description":"Update a Rule by using the Ruleset id and Rule external_id.\\n\\nRequires the check_write_rulesets_permission scope/permission."}},"/price_rules/rules/v2/shops/{shop_identifier}/rulesets/{ruleset_id}/rules/add":{"parameters":[{"schema":{"type":"string"},"name":"shop_identifier","in":"path","required":true,"description":"Bold platform identifier for the shop. Find this identifier using the [Get Shop Info](shops#operation/GetShopInfo) endpoint."},{"schema":{"type":"string"},"name":"ruleset_id","in":"path","required":true}],"patch":{"summary":"Bulk Add Rules by Ruleset ID","operationId":"BulkAddRulesByRulesetID","tags":["Rules"],"responses":{"200":{"description":"OK"},"400":{"description":"Bad Request"},"403":{"description":"Forbidden"},"404":{"description":"Not Found"},"409":{"description":"Conflict"},"422":{"description":"Unprocessable Entity (WebDAV)"},"500":{"description":"Internal Server Error"}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"rules":{"type":"array","minItems":1,"items":{"$ref":"#/components/schemas/Rule"}}},"required":["rules"]}}},"description":""},"description":"Bulk add Rules to a Ruleset."}},"/price_rules/rules/v2/shops/{shop_identifier}/rulesets/{ruleset_id}/rules":{"parameters":[{"schema":{"type":"string"},"name":"shop_identifier","in":"path","required":true,"description":"Bold platform identifier for the shop. Find this identifier using the [Get Shop Info](shops#operation/GetShopInfo) endpoint."},{"schema":{"type":"string"},"name":"ruleset_id","in":"path","required":true}],"get":{"summary":"List Rules by Ruleset ID","operationId":"ListRulesByRulesetID","tags":["Rules"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"data":{"type":"object","items":{"$ref":"#/components/schemas/RuleResponse"}},"pagination":{"$ref":"#/components/schemas/Pagination"}}},"examples":{"200-response-example":{"value":{"message":"Successfully fetched rules","data":[{"id":"number","external_id":"string","conditions":[{"value":5,"type":"QTY_BY_LINE","operator":"=","requiresPrepare":true}],"actions":[{"value":99,"type":"PRICE_ADJUST_ABSOLUTE"}]}],"pagination":{"total":2,"count":2,"per_page":50,"current_page":1,"total_pages":1}}}}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"examples":{"404-error-example":{"value":{"code":"string","message":"Error with fetching rules with ruleset with id: 1234567","type":"string"}}}}}}},"description":"Returns all rules in a ruleset in a paginated format.","parameters":[{"schema":{"type":"string"},"in":"query","name":"page","description":"Page number, considering that the results could span for several pages. Default is 1."},{"schema":{"type":"string"},"in":"query","name":"limit","description":"Page size, considering that the results could span for several pages. Default is 50."}]}},"/price_rules/rules/v2/shops/{shop_identifier}/rulesets/eid/{external_id}/rules":{"parameters":[{"schema":{"type":"string"},"name":"shop_identifier","in":"path","required":true,"description":"Bold platform identifier for the shop. Find this identifier using the [Get Shop Info](shops#operation/GetShopInfo) endpoint."},{"schema":{"type":"string"},"name":"external_id","in":"path","required":true}],"get":{"summary":"List Rules by Ruleset External ID","operationId":"ListRulesByRulesetExternalID","tags":["Rules"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"data":{"type":"object","items":{"$ref":"#/components/schemas/RuleResponse"}},"pagination":{"$ref":"#/components/schemas/Pagination"}}}}}}},"description":"Returns all rules in a ruleset in a paginated format.","parameters":[{"schema":{"type":"string"},"in":"query","name":"page","description":"Page number, considering that the results could span for several pages. Default is 1."},{"schema":{"type":"string"},"in":"query","name":"limit","description":"Page size, considering that the results could span for several pages. Default is 50."}]}},"/price_rules/rules/v2/shops/{shop_identifier}/discount_codes/{discount_code_id}/activate":{"parameters":[{"schema":{"type":"string"},"name":"shop_identifier","in":"path","required":true,"description":"Bold platform identifier for the shop. Find this identifier using the [Get Shop Info](shops#operation/GetShopInfo) endpoint."},{"schema":{"type":"string"},"name":"discount_code_id","in":"path","required":true}],"patch":{"summary":"Activate Discount Code","operationId":"ActivateDiscountCode","tags":["Discount Codes"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","description":"The message contains the result of this operation."},"data":{"type":"object","properties":{"discount_code":{"$ref":"#/components/schemas/DiscountCode"}}}}},"examples":{"200-response-example":{"value":{"message":"Successfully activated discount code","data":{"discount_code":{"id":197,"code":"efijo","created_at":"2021-02-03T16:11:07.000000Z","updated_at":"2021-02-05T16:32:46.000000Z","ruleset":{"id":"272","external_id":"RELATED_TO_DISCOUNT_CODE_efijo","shop_id":9,"app_slug":"pdc-shopify","active":true,"internal_name":"RELATED_TO_DISCOUNT_CODE_efijo","public_name":"","rule_set_data":"{\\"rules\\":[{\\"type\\":\\"DISCOUNT_CODE\\",\\"conditions\\":[{\\"type\\":\\"DISCOUNT_CODE\\",\\"value\\":\\"efijo\\"}],\\"actions\\":[{\\"type\\":\\"PRICE_ADJUST_PERCENT\\",\\"value\\":50}]}]}","start_date":"2021-02-03T16:11:07.000000Z","expiry_date":"2021-02-03T16:11:07.000000Z","sync_percent":100,"priority":0,"selection_type":1,"selection_data":"{\\"product_ids\\":[\\"5809048617123\\",\\"5809050615971\\"]}","created_at":"2021-02-03T16:11:07.000000Z","updated_at":"2021-02-03T16:11:07.000000Z"},"limits":[]}}}}}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Unprocessable Entity (WebDAV)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"description":"Updates the `start_date` to be `now()`, and will update the `expiry_date` if it is in the past. Returns the data for the updated discount code. This requires write_discount_codes scope/permission."}},"/price_rules/rules/v2/shops/{shop_identifier}/discount_codes/{discount_code_id}/deactivate":{"parameters":[{"schema":{"type":"string"},"name":"shop_identifier","in":"path","required":true,"description":"Bold platform identifier for the shop. Find this identifier using the [Get Shop Info](shops#operation/GetShopInfo) endpoint."},{"schema":{"type":"string"},"name":"discount_code_id","in":"path","required":true}],"patch":{"summary":"Deactivate Discount Code","operationId":"DeactivateDiscountCode","tags":["Discount Codes"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","description":"The message contains the result of this operation."},"data":{"type":"object","properties":{"discount_code":{"$ref":"#/components/schemas/DiscountCode"}}}}},"examples":{"200-response-example":{"value":{"message":"Successfully deactivated discount code","data":{"discount_code":{"id":197,"code":"efijo","created_at":"2021-02-03T16:11:07.000000Z","updated_at":"2021-02-05T16:32:46.000000Z","ruleset":{"id":"272","external_id":"RELATED_TO_DISCOUNT_CODE_efijo","shop_id":9,"app_slug":"pdc-shopify","active":true,"internal_name":"RELATED_TO_DISCOUNT_CODE_efijo","public_name":"","rule_set_data":"{\\"rules\\":[{\\"type\\":\\"DISCOUNT_CODE\\",\\"conditions\\":[{\\"type\\":\\"DISCOUNT_CODE\\",\\"value\\":\\"efijo\\"}],\\"actions\\":[{\\"type\\":\\"PRICE_ADJUST_PERCENT\\",\\"value\\":50}]}]}","start_date":"2021-02-03T16:11:07.000000Z","expiry_date":"2021-02-03T16:11:07.000000Z","sync_percent":100,"priority":0,"selection_type":1,"selection_data":"{\\"product_ids\\":[\\"5809048617123\\",\\"5809050615971\\"]}","created_at":"2021-02-03T16:11:07.000000Z","updated_at":"2021-02-03T16:11:07.000000Z"},"limits":[]}}}}}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Unprocessable Entity (WebDAV)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"description":"Updates the `expiry_date` to be `now()`. Returns the data for the updated discount code. This requires write_discount_codes scope/permission."}},"/price_rules/storefront/v2/shops/{shop_domain}/order_condition":{"parameters":[{"schema":{"type":"string"},"name":"shop_domain","in":"path","required":true}],"post":{"summary":"List Eligible Order Conditions for Shop","operationId":"ListEligibleOrderConditionsForShop","tags":["Order Conditions"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","enum":["Successfully applied order condition to shop"]},"data":{"type":"object","properties":{"order_condition":{"type":"array","description":"array of order condition key value pair","items":{}}}}}},"examples":{"example-1":{"value":{"message":"Successfully applied order condition to shop","data":{"order_condition":{"location":"Vancouver"}}}}}}}}},"description":"Tests order conditions against shop and customer data, and returns the condition names and values that match. Requires no special permissions/scopes.","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"customer":{"$ref":"#/components/schemas/OrderConditionCustomerSchema"}}},"examples":{"example-1":{"value":{"customer":{"shipping":{"postal_code":"string","country":"string","country_code":"string","province":"string","province_code":"string"}}}}}}}}}}},"components":{"securitySchemes":{"OAuthToken":{"type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"https://apps.boldapps.net/accounts/dashboard/authorize","tokenUrl":"https://api.boldcommerce.com/auth/oauth2/token","scopes":{}}},"description":"Authenticates an API request from a [public integration](/guides/price-rules/resources/glossary#public-integration). Generate this token in the [Developer Dashboard](https://developer-dashboard.boldcommerce.com/default/dashboard). Refer to [Build Public Integrations](/guides/checkout/public-integrations) for more information."},"APIAccessToken":{"type":"apiKey","name":"API Access Token","in":"header","description":"Authenticates an API request from a [private integration](/guides/price-rules/resources/glossary#private-integration). Generate this token in the [Bold Account Center](https://account.boldcommerce.com/). Refer to [Making API Calls](/guides/checkout/quick-start) for more information."}},"schemas":{"Ruleset":{"title":"Ruleset","type":"object","description":"A set of rules that can apply to a defined group of products, depending on the rule conditions being met. This more complete type refers to all the fields that can be obtained when getting one or more rulesets.","properties":{"id":{"description":"Ruleset database ID.","type":"integer"},"product_selection":{"type":"object","description":"IDs, vendors or product titles used to filter where the ruleset applies, along with the specific platform filter type.","properties":{"titles":{"type":"array","description":"List of all product titles that might be affected by the ruleset.","items":{"type":"string"}},"collection_ids":{"type":"array","description":"List of platform collection IDs that might be affected by the ruleset.","items":{"type":"string"}},"variant_ids":{"type":"array","description":"List of platform variant IDs that might be affected by the ruleset.","items":{"type":"string"}},"product_ids":{"type":"array","description":"List of platform product IDs that might be affected by the ruleset.","items":{"type":"string"}},"vendors":{"type":"array","description":"List of all vendors whose products might be affected by the ruleset.","items":{"type":"string"}},"product_types":{"type":"string"},"sku_ids":{"type":"array","description":"List of all SKUs that might be affected by the ruleset.","items":{"type":"string"}},"type":{"type":"string","enum":["SHOPIFY_PRODUCT_SEARCH","SHOPIFY_PRODUCTS_ALL","PRODUCT_SEARCH","PRODUCTS_ALL"]}}},"rules":{"type":"array","description":"Each one of the rules contained in this ruleset.","items":{"$ref":"#/components/schemas/Rule"}},"updated_at":{"type":"string","description":"If the ruleset was altered, this will be the most recent date in which any changes occurred.","format":"date-time","nullable":true},"created_at":{"type":"string","description":"Ruleset creation date.","format":"date-time"},"priority":{"type":"number","description":"Defines the priority of this ruleset above other rulesets that belong to the same app."},"sync_percent":{"type":"integer","minimum":0,"maximum":100,"description":"Described the current percentage of the process that synchronizes this ruleset with the shop. Should be set to zero when the rule is created/altered."},"expiry_date":{"type":"string","description":"Date from which the ruleset will stop being effective.","format":"date-time","nullable":true},"start_date":{"type":"string","description":"Date from which the ruleset should be considered effective.","format":"date-time","nullable":true},"public_name":{"type":"string","description":"A public facing name for the ruleset."},"internal_name":{"type":"string","description":"If the ruleset was created by an external app, this is the app name for the ruleset."},"active":{"type":"boolean","description":"Indicates if this ruleset is currently active."},"external_id":{"type":"string","description":"If the ruleset was created by an external app, the external_id will be set as the app identifier for the ruleset."},"app_slug":{"type":"string","description":"Name or identifier of the app that owns the ruleset. For private operations this is ommited, since the app is implicit (and it is directly related to the auth token)."}},"required":["rules","active"]},"Rule":{"type":"object","title":"Rule","description":"Comprised by one or more actions that can alter the price or the storefront in general, and a set of zero or more conditions that must be met for the rule to be applied. ","additionalProperties":false,"properties":{"type":{"type":"string","enum":["DISCOUNT","DISCOUNT_CODE","DISCOUNTABLE_ADDITION","ADDITION","STACKABLE_DISCOUNT","ROUNDING","DISPLAY","SETTING","BUNDLE","REF_URL","LINE_ITEM_PROPERTY","CUSTOMER_PROVINCE","CUSTOMER_GROUP","QTY_BY_MIX_AND_MATCH","QTY_BY_PRODUCT","QTY_BY_VARIANT","QTY_BY_LINE","SUBSCRIPTION_GROUP","SUBSCRIPTION_INTERVAL"],"description":"The rule type defines how the rule is applied in parallel with other rules, and also how it should behave."},"conditions":{"type":"array","description":"One or more conditions that need to be matched for the rule to apply.","items":{"anyOf":[{"$ref":"#/components/schemas/ConditionBuyXGetYDiscountCode"},{"$ref":"#/components/schemas/ConditionCartSubtotalMin"},{"$ref":"#/components/schemas/ConditionCurrency"},{"$ref":"#/components/schemas/ConditionCustomerCountry"},{"$ref":"#/components/schemas/ConditionCustomerGroup"},{"$ref":"#/components/schemas/ConditionCustomerId"},{"$ref":"#/components/schemas/ConditionCustomerInAnyGroupFromList"},{"$ref":"#/components/schemas/ConditionCustomerProvince"},{"$ref":"#/components/schemas/ConditionLineItemProperty"},{"$ref":"#/components/schemas/ConditionQtyByBundle"},{"$ref":"#/components/schemas/ConditionQtyByLine"},{"$ref":"#/components/schemas/ConditionQtyByMixAndMatch"},{"$ref":"#/components/schemas/ConditionQtyByProduct"},{"$ref":"#/components/schemas/ConditionQtyByVariant"},{"$ref":"#/components/schemas/ConditionQtyOnCart"},{"$ref":"#/components/schemas/ConditionRefUrl"},{"$ref":"#/components/schemas/ConditionShippingRateRange"},{"$ref":"#/components/schemas/ConditionSubscriptionGroup"},{"$ref":"#/components/schemas/ConditionSubscriptionInterval"},{"$ref":"#/components/schemas/ConditionCurrency"},{"$ref":"#/components/schemas/ConditionOrderCondition"},{"$ref":"#/components/schemas/ConditionCartSubtotalMin"}],"discriminator":{"propertyName":"type","mapping":{"BUY_X_GET_Y_DISCOUNT_CODE":"#/components/schemas/ConditionBuyXGetYDiscountCode","CART_SUBTOTAL_MIN":"#/components/schemas/ConditionCartSubtotalMin","CURRENCY":"#/components/schemas/ConditionCurrency","CUSTOMER_COUNTRY":"#/components/schemas/ConditionCustomerCountry","CUSTOMER_GROUP":"#/components/schemas/ConditionCustomerGroup","CUSTOMER_ID":"#/components/schemas/ConditionCustomerId","CUSTOMER_IN_ANY_GROUP_FROM_LIST":"#/components/schemas/ConditionCustomerInAnyGroupFromList","CUSTOMER_PROVINCE":"#/components/schemas/ConditionCustomerProvince","LINE_ITEM_PROPERTY":"#/components/schemas/ConditionLineItemProperty","BUNDLE":"#/components/schemas/ConditionQtyByBundle","QTY_BY_LINE":"#/components/schemas/ConditionQtyByLine","QTY_BY_MIX_AND_MATCH":"#/components/schemas/ConditionQtyByMixAndMatch","QTY_BY_PRODUCT":"#/components/schemas/ConditionQtyByProduct","QTY_BY_VARIANT":"#/components/schemas/ConditionQtyByVariant","QTY_ON_CART":"#/components/schemas/ConditionQtyOnCart","REF_URL":"#/components/schemas/ConditionRefUrl","SHIPPING_RATE_RANGE":"#/components/schemas/ConditionShippingRateRange","SUBSCRIPTION_GROUP":"#/components/schemas/ConditionSubscriptionGroup","SUBSCRIPTION_INTERVAL":"#/components/schemas/ConditionSubscriptionInterval"}}}},"actions":{"type":"array","minItems":1,"items":{"anyOf":[{"$ref":"#/components/schemas/ActionPriceAdjustAbsolute"},{"$ref":"#/components/schemas/ActionPriceAdjustRelative"},{"$ref":"#/components/schemas/ActionPriceAdjustPercent"},{"$ref":"#/components/schemas/ActionPriceAdjustAbsoluteWithLimit"},{"$ref":"#/components/schemas/ActionPriceAdjustRelativeWithLimit"},{"$ref":"#/components/schemas/ActionCharmPrice"},{"$ref":"#/components/schemas/ActionAdjustRate"},{"$ref":"#/components/schemas/ActionAddFee"},{"$ref":"#/components/schemas/ActionDisplayQtyBreak"},{"$ref":"#/components/schemas/ActionCustomerDraftOrderTaxable"},{"$ref":"#/components/schemas/ActionPriceAdjustAbsoluteBasePrice"}],"discriminator":{"propertyName":"type","mapping":{"PRICE_ADJUST_ABSOLUTE":"#/components/schemas/ActionPriceAdjustAbsolute","PRICE_ADJUST_RELATIVE":"#/components/schemas/ActionPriceAdjustRelative","PRICE_ADJUST_PERCENT":"#/components/schemas/ActionPriceAdjustPercent","PRICE_ADJUST_ABSOLUTE_WITH_LIMIT":"#/components/schemas/ActionPriceAdjustAbsoluteWithLimit","PRICE_ADJUST_RELATIVE_WITH_LIMIT":"#/components/schemas/ActionPriceAdjustRelativeWithLimit","PRICE_ADJUST_ABSOLUTE_BASE_PRICE":"#/components/schemas/ActionPriceAdjustAbsoluteBasePrice","CHARM_PRICE":"#/components/schemas/ActionCharmPrice","PRICE_ADJUST_RATE":"#/components/schemas/ActionAdjustRate","ADD_FEE":"#/components/schemas/ActionAddFee","DISPLAY_QTY_BREAK":"#/components/schemas/ActionDisplayQtyBreak","CUSTOMER_DRAFT_ORDER_TAXABLE":"#/components/schemas/ActionCustomerDraftOrderTaxable"}}}},"meta":{"type":"object"},"external_id":{"type":"string"},"priority":{"type":"number","description":"Defines the priority of a Rule, 0 is default and highest"},"stack_order":{"type":"number"},"id":{"type":"number"}},"required":["type"]},"ActionPriceAdjustAbsolute":{"type":"object","additionalProperties":false,"properties":{"value":{"type":"integer","example":99},"type":{"type":"string","enum":["PRICE_ADJUST_ABSOLUTE"]}},"required":["value","type"]},"ActionPriceAdjustRelative":{"type":"object","additionalProperties":false,"properties":{"value":{"type":"integer","example":299},"type":{"type":"string","enum":["PRICE_ADJUST_RELATIVE"]}},"required":["value","type"]},"ActionPriceAdjustPercent":{"type":"object","additionalProperties":false,"properties":{"value":{"type":"number","example":299},"type":{"type":"string","enum":["PRICE_ADJUST_PERCENT"]}},"required":["value","type"]},"ActionPriceAdjustAbsoluteWithLimit":{"type":"object","additionalProperties":false,"properties":{"value":{"type":"integer","example":299},"type":{"type":"string","enum":["PRICE_ADJUST_ABSOLUTE_WITH_LIMIT"]},"limit":{"type":"integer","default":1},"limit_scope":{"type":"string","enum":["product","variant","lineitem"],"default":"variant"}},"required":["value","type"],"title":""},"ActionPriceAdjustRelativeWithLimit":{"type":"object","additionalProperties":false,"properties":{"value":{"type":"integer","example":299},"type":{"type":"string","enum":["PRICE_ADJUST_RELATIVE_WITH_LIMIT"]},"limit":{"type":"integer"},"limit_scope":{"type":"string","enum":["product","variant","lineitem"],"default":"variant"}},"required":["value","type"]},"ActionCharmPrice":{"type":"object","additionalProperties":false,"properties":{"value":{"type":"integer","example":99},"type":{"type":"string","enum":["CHARM_PRICE"]}},"required":["value","type"]},"ActionAddFee":{"type":"object","additionalProperties":false,"properties":{"value":{"type":"integer","example":299},"type":{"type":"string","enum":["ADD_FEE"]},"province":{"type":"string","enum":["NL","PE","NS","NB","QC","QN","MB","SK","AB","BC","YT","NT","NU"],"description":"This functionality is not supported."},"display_inline":{"type":"boolean","description":"This functionality is not supported."},"name":{"type":"string"}},"required":["value","type"]},"BestProductPriceItem":{"title":"BestProductPriceItem","type":"object","properties":{"price":{"type":"integer"},"id":{"type":"string"},"quantity":{"type":"integer"}}},"ActionDisplayQtyBreak":{"type":"object","minProperties":3,"additionalProperties":false,"properties":{"type":{"type":"string","enum":["DISPLAY_QTY_BREAK"]},"qty":{"type":"integer"},"percent":{"type":"integer","minimum":0,"maximum":100,"example":15},"price":{"type":"integer"},"saved":{"type":"integer","default":0,"example":299}},"required":["type"]},"ActionCustomerDraftOrderTaxable":{"type":"object","additionalProperties":false,"properties":{"value":{"type":"boolean","example":true},"type":{"type":"string","enum":["CUSTOMER_DRAFT_ORDER_TAXABLE"]}},"required":["value","type"]},"ConditionOrderCondition":{"type":"object","additionalProperties":false,"properties":{"type":{"type":"string","enum":["ORDER_CONDITION"]},"name":{"type":"string","example":"order_condition_by_country"},"value":{"type":"string","example":"order_condition_canada"}},"required":["type","name","value"]},"ConditionQtyByLine":{"type":"object","additionalProperties":false,"properties":{"value":{"type":"integer","example":5},"type":{"type":"string","enum":["QTY_BY_LINE"]},"operator":{"type":"string","default":"=","enum":["=","!=","<",">","<=",">="],"example":"="},"requiresPrepare":{"type":"boolean","example":true}},"required":["value","type","operator"]},"ConditionQtyByVariant":{"type":"object","additionalProperties":false,"properties":{"value":{"type":"integer","example":5},"type":{"type":"string","enum":["QTY_BY_VARIANT"]},"operator":{"type":"string","default":"=","enum":["=","!=","<",">","<=",">="],"example":"="},"requiresPrepare":{"type":"boolean","example":true}},"required":["value","type","operator"]},"ConditionQtyByProduct":{"type":"object","additionalProperties":false,"properties":{"value":{"type":"integer","example":5},"type":{"type":"string","enum":["QTY_BY_PRODUCT"]},"operator":{"default":"=","type":"string","enum":["=","!=","<",">","<=",">="],"example":"=","description":""},"requiresPrepare":{"type":"boolean","example":true}},"required":["value","type","operator"]},"ConditionQtyByMixAndMatch":{"type":"object","additionalProperties":false,"properties":{"value":{"type":"integer","example":5},"type":{"type":"string","enum":["QTY_BY_MIX_AND_MATCH"]},"operator":{"type":"string","default":"=","enum":["=","!=","<",">","<=",">="],"example":"="},"label":{"type":"string","example":"sample"}},"required":["value","type","operator","label"]},"ConditionCustomerGroup":{"type":"object","additionalProperties":false,"properties":{"value":{"type":"string","example":"wholesale"},"type":{"type":"string","enum":["CUSTOMER_GROUP"]}},"required":["value","type"]},"ConditionSubscriptionGroup":{"type":"object","additionalProperties":false,"properties":{"value":{"type":"number","example":123},"type":{"type":"string","enum":["SUBSCRIPTION_GROUP"]}},"required":["value","type"]},"ConditionSubscriptionInterval":{"type":"object","additionalProperties":false,"properties":{"value":{"type":"number","example":6},"type":{"type":"string","enum":["SUBSCRIPTION_INTERVAL"]}},"required":["value","type"]},"ConditionCustomerProvince":{"type":"object","additionalProperties":false,"properties":{"value":{"type":"string","example":"manitoba"},"type":{"type":"string","enum":["CUSTOMER_PROVINCE"]}},"required":["value","type"]},"ConditionLineItemProperty":{"type":"object","additionalProperties":false,"properties":{"value":{"type":"integer","example":49},"type":{"type":"string","enum":["LINE_ITEM_PROPERTY"]},"name":{"type":"string","example":"price_rules"},"operator":{"type":"string","default":"=","enum":["=","!=","<",">","<=",">="],"example":"="}},"required":["value","type","name","operator"]},"ConditionRefUrl":{"type":"object","additionalProperties":false,"properties":{"value":{"type":"string","example":"https://store.myshopify.com"},"type":{"type":"string","enum":["REF_URL"]}},"required":["value","type"]},"ConditionQtyByBundle":{"type":"object","additionalProperties":false,"properties":{"value":{"type":"object","additionalProperties":{"type":"integer"}},"type":{"type":"string","enum":["BUNDLE"]},"operator":{"type":"string","default":"=","enum":["=","!=","<",">","<=",">="],"example":"="},"name":{"type":"string","example":"price_rules"},"values":{"type":"array","items":{}}},"required":["value","type","operator","name","values"]},"Error":{"title":"Error","type":"object","properties":{"code":{"type":"string","description":"Unique identifier for this error"},"message":{"type":"string","description":"Error details"},"type":{"type":"string","description":"Error category"}},"required":["code","message"],"description":"Extra information that is returned in case of an HTTP error."},"BasicRuleset":{"title":"BasicRuleset","type":"object","description":"A set of rules that can apply to a defined group of products, depending on the rule conditions being met. The basic ruleset type refers to the fields that should be passed when creating or updating a ruleset.","properties":{"external_id":{"type":"string","description":"If the ruleset was created by an external app, the external_id will be set as the app identifier for the ruleset."},"internal_name":{"type":"string","description":"If the ruleset was created by an external app, this is the app name for the ruleset."},"start_date":{"type":"string","description":"Date from which the ruleset should be considered effective.","format":"date-time","nullable":true},"expiry_date":{"type":"string","description":"Date from which the ruleset will stop being effective.","format":"date-time","nullable":true},"priority":{"type":"number","description":"Defines the priority of this ruleset above other rulesets that belong to the same app."},"rules":{"type":"array","description":"Each one of the rules contained in this ruleset.","items":{"$ref":"#/components/schemas/Rule"}},"product_selection":{"type":"object","description":"IDs, vendors or product titles used to filter where the ruleset applies, along with the specific platform filter type.","properties":{"titles":{"type":"array","description":"List of all product titles that might be affected by the ruleset.","items":{"type":"string"}},"collection_ids":{"type":"array","description":"List of platform collection IDs that might be affected by the ruleset.","items":{"type":"string"}},"variant_ids":{"type":"array","description":"List of platform variant IDs that might be affected by the ruleset.","items":{"type":"string"}},"product_ids":{"type":"array","description":"List of platform product IDs that might be affected by the ruleset.","items":{"type":"string"}},"vendors":{"type":"array","description":"List of all vendors whose products might be affected by the ruleset.","items":{"type":"string"}},"product_types":{"type":"string"},"sku_ids":{"type":"string"},"type":{"type":"string","enum":["SHOPIFY_PRODUCT_SEARCH","SHOPIFY_PRODUCTS_ALL","PRODUCT_SEARCH","PRODUCTS_ALL"]}}}}},"Pagination":{"title":"Pagination","type":"object","properties":{"total":{"type":"integer","description":"How many results are available in the database."},"count":{"type":"integer","description":"How many results were brought by this search."},"per_page":{"type":"integer","description":"Amount of results per page."},"current_page":{"type":"integer","description":"If the results span several pages, this contains the current page number."},"total_pages":{"type":"integer","description":"How many pages are needed to present all the results in the database."}},"description":"This object describes basic pagination info, and it is used associated with search results that can span for several pages."},"ShopOptions":{"title":"ShopOptions","type":"object","properties":{"compare_at_price_as_original":{"type":"boolean"},"verbose_logs":{"type":"boolean"},"include_base_prices":{"type":"boolean"}},"description":"Specific configurations related to the shop that can affect how information is presented or how rules are processed."},"BasePrice":{"title":"BasePrice","type":"object","properties":{"id":{"type":"number","description":"The variant ID to which the price applies."},"price":{"type":"number","description":"The original or unaltered price of the variant."}},"description":"Basic price information for variants, before any discounts were applied."},"OrderCondition":{"title":"Order Condition","type":"object","description":"An Order Condition can be used to group shopping experiences under specific categories, and then use those categories to apply price changes. For example, the shipping address used by each customer could place it in a collection of DELIVERY_ZONE conditions, with different possible values that would define different discounts.","properties":{"name":{"type":"string","description":"The name of the Order Condition."},"value":{"type":"string","description":"The value of the Order Condition."},"operator":{"$ref":"#/components/schemas/Operator"},"type":{"type":"string","description":"Specifies the `type` the `operator` must match with for this condition. Eg. \\"operator: \'ONE_OF\'\\", \\"type:\'FIELD_SET`\\" means that this condition applies if one field_set matches."},"field_sets":{"type":"array","description":"All the different combinations of fields and values that match the Order Condition. For example, all the sets of country + city + postal code that are included in the \'DELIVERY_ZONE: NorthAmerica\' condition.","items":{"$ref":"#/components/schemas/FieldSet"}}},"required":["name","value","operator","type"]},"Operator":{"title":"Operator","type":"string","description":"Defines the relationship of the Order Condition. Eg \'ONE_OF\'."},"FieldSet":{"title":"FieldSet","type":"object","description":"A FieldSet is a combination of fields and values that match for a specific Order Condition. For example, a set of values for country + city + postal code that match the \'DELIVERY_ZONE: NorthAmerica\' condition.","x-examples":{"example-1":{"name":"ZONE","value":"Prairies","operator":"ONE_OF","type":"FIELD_SET","field_sets":[{"field_set_id":9,"customer.shipping.country":"Canada","customer.shipping.postal_code":"R3Y0L6"},{"field_set_id":10,"customer.shipping.country":"Canada","customer.shipping.postal_code":"R3T5Y3"}]}},"properties":{"field_set_id":{"type":"number","description":"The ID of the FieldSet."},"customer.shipping.country":{"type":"string","description":"Eg. \\"Canada\\"."},"customer.shipping.country_code":{"type":"string","description":"Eg \\"CA\\"."},"customer.shipping.postal_code":{"type":"string","description":"Eg. \\"R3Y0L6\\"."},"customer.shipping.province":{"type":"string","description":"Eg \\"Manitoba\\"."},"customer.shipping.province_code":{"type":"string","description":"Eg. \\"MB\\"."}}},"CreateDiscountCode":{"title":"CreateDiscountCode","type":"object","additionalProperties":false,"description":"Payload to create one or more discount codes from scratch.","properties":{"codes":{"type":"array","description":"List of discount code names that should be created sharing this same configuration.","items":{"type":"string"}},"conditions":{"type":"array","description":"Extra requirements for the discount code to be considered eligible. This is an optional field.","items":{"anyOf":[{"$ref":"#/components/schemas/ConditionCartSubtotalMin"},{"$ref":"#/components/schemas/ConditionShippingRateRange"},{"$ref":"#/components/schemas/ConditionQtyOnCart"},{"$ref":"#/components/schemas/ConditionCustomerInAnyGroupFromList"},{"$ref":"#/components/schemas/ConditionCustomerCountry"},{"$ref":"#/components/schemas/ConditionBuyXGetYDiscountCode"}]}},"action":{"oneOf":[{"$ref":"#/components/schemas/ActionPriceAdjustRelative"},{"$ref":"#/components/schemas/ActionPriceAdjustPercent"},{"$ref":"#/components/schemas/ActionFreeShipping"},{"$ref":"#/components/schemas/ActionShippingAdjustRelative"},{"$ref":"#/components/schemas/ActionShippingAdjustPercent"},{"$ref":"#/components/schemas/ActionCartAdjustRelative"},{"$ref":"#/components/schemas/ActionCartAdjustPercent"}]},"product_selection":{"oneOf":[{"$ref":"#/components/schemas/DiscountCodeProductSelection"},{"$ref":"#/components/schemas/DiscountCodeVariantSelection"},{"$ref":"#/components/schemas/DiscountCodeAllSelection"},{"$ref":"#/components/schemas/DiscountCodeCollectionSelection"},{"$ref":"#/components/schemas/DiscountCodeSKUSelection"}]},"start_date":{"type":"string","format":"date-time","description":"Date from which the discount code should be considered valid (optional)."},"expiry_date":{"type":"string","format":"date-time","description":"Date from which the discount code should be considered expired/invalid (optional)."},"restrict_by_emails":{"type":"array","maxItems":50,"description":"This optional field can be used to make the discount code valid only for certain customers (defined by their email addresses).","items":{"type":"string"}},"limits":{"type":"array","description":"If a discount code can be used only a limited amount of times (per customer, or in the entire shop) those optional limits can be defined here.","items":{"$ref":"#/components/schemas/UsageLimit"}},"raw_product_selection":{"$ref":"#/components/schemas/DiscountCodeRawProductSelection"},"raw_reward_product_selection":{"$ref":"#/components/schemas/DiscountCodeRawProductSelection"}},"required":["codes","action","product_selection"]},"DiscountCodeProductSelection":{"title":"DiscountCodeProductSelection","type":"object","description":"Expression to filter which products should be eligible for a discount code.","additionalProperties":false,"properties":{"type":{"type":"string","enum":["PRODUCT_SEARCH","PRODUCTS_EXCEPT"],"description":"The type of selection; the discount code can be applicable to specific products/variants or to the entire store."},"product_ids":{"type":"array","description":"List of product ids eligible for the discount code.","items":{"type":"string"}}},"required":["type","product_ids"]},"DiscountCodeVariantSelection":{"title":"DiscountCodeVariantSelection","type":"object","additionalProperties":false,"description":"Expression to filter which variants should be eligible for a discount code.","properties":{"type":{"type":"string","description":"The type of selection; the discount code can be applicable to specific products/variants or to the entire store.","enum":["PRODUCT_SEARCH","PRODUCTS_EXCEPT"]},"variant_ids":{"type":"array","description":"List of variant ids eligible for the discount code.","items":{"type":"string"}}},"required":["type","variant_ids"]},"DiscountCode":{"title":"DiscountCode","type":"object","additionalProperties":false,"description":"A set of fields that describes the behaviour of a discount code, where it applies and how it affects the product prices.","properties":{"id":{"type":"integer"},"code":{"type":"string","description":"The discount code name (to be used during checkout)."},"discount_summary":{"type":"string","description":"The discount code summary."},"is_active":{"type":"string","format":"date-time","description":""},"start_date":{"nullable":true,"type":"string","format":"date-time","description":"Start date when the discount code shall be available for use."},"expiry_date":{"nullable":true,"type":"string","format":"date-time","description":"Date when the discount code expires."},"created_at":{"type":"string","format":"date-time","description":"Date when the discount code was originally created."},"updated_at":{"type":"string","format":"date-time","description":"Date when the discount code was last updated."},"restrict_by_emails":{"type":"array","description":"This optional field informs when the discount code is valid only for certain customers (defined by their email addresses).","items":{"type":"string"}},"ruleset":{"$ref":"#/components/schemas/DiscountCodeRuleset"},"limits":{"type":"array","description":"If the discount code usage limits (for example, it can be used just one time per customer) these limits will be listed in this field.","items":{"$ref":"#/components/schemas/UsageLimit"}},"product_selection":{"$ref":"#/components/schemas/DiscountCodeRawProductSelection"},"reward_product_selection":{"$ref":"#/components/schemas/DiscountCodeRawProductSelection"}}},"UsageLimit":{"title":"UsageLimit","type":"object","description":"If a discount code has usage limits, this object will describe those limits.","properties":{"limit_type":{"type":"string","enum":["per_customer","per_shop"],"description":"When a discount code has a usage limit, the limit can be applied per customer or for the entire shop."},"limit_amount":{"type":"integer","description":"This describes the maximum amount of allowed usages for a limited discount code.","minimum":1}},"required":["limit_type","limit_amount"],"additionalProperties":false},"UpdateDiscountCode":{"title":"UpdateDiscountCode","type":"object","description":"Payload to update an existing discount code.","additionalProperties":false,"properties":{"code":{"type":"string","description":"The discount code name (to be used during checkout). When updating, you don\'t need to provide the code unless you are changing it."},"conditions":{"type":"array","description":"Extra requirements for the discount code to be considered eligible. This is an optional field.","items":{"anyOf":[{"$ref":"#/components/schemas/ConditionCartSubtotalMin"},{"$ref":"#/components/schemas/ConditionShippingRateRange"},{"$ref":"#/components/schemas/ConditionQtyOnCart"},{"$ref":"#/components/schemas/ConditionCustomerInAnyGroupFromList"},{"$ref":"#/components/schemas/ConditionCustomerCountry"},{"$ref":"#/components/schemas/ConditionBuyXGetYDiscountCode"}]}},"action":{"oneOf":[{"$ref":"#/components/schemas/ActionPriceAdjustRelative"},{"$ref":"#/components/schemas/ActionPriceAdjustPercent"},{"$ref":"#/components/schemas/ActionFreeShipping"},{"$ref":"#/components/schemas/ActionShippingAdjustRelative"},{"$ref":"#/components/schemas/ActionShippingAdjustPercent"},{"$ref":"#/components/schemas/ActionCartAdjustRelative"},{"$ref":"#/components/schemas/ActionCartAdjustPercent"}]},"limit":{"$ref":"#/components/schemas/UsageLimit"},"product_selection":{"oneOf":[{"$ref":"#/components/schemas/DiscountCodeProductSelection"},{"$ref":"#/components/schemas/DiscountCodeVariantSelection"},{"$ref":"#/components/schemas/DiscountCodeAllSelection"},{"$ref":"#/components/schemas/DiscountCodeCollectionSelection"},{"$ref":"#/components/schemas/DiscountCodeSKUSelection"}]},"start_date":{"type":"string","format":"date-time","description":"Date from which the discount code should be considered valid (optional)."},"expiry_date":{"type":"string","format":"date-time","description":"Date from which the discount code should be considered expired/invalid (optional)."},"restrict_by_emails":{"type":"array","maxItems":50,"description":"This optional field can be used to make the discount code valid only for certain customers (defined by their email addresses).","items":{"type":"string"}},"limits":{"type":"array","description":"If a discount code can be used only a limited amount of times (per customer, or in the entire shop) those optional limits can be defined here.","items":{"$ref":"#/components/schemas/UsageLimit"}},"raw_product_selection":{"$ref":"#/components/schemas/DiscountCodeRawProductSelection"},"raw_reward_product_selection":{"$ref":"#/components/schemas/DiscountCodeRawProductSelection"}},"required":["action","product_selection"]},"DiscountCodeRuleset":{"title":"DiscountCodeRuleset","type":"object","description":"A set of rules that can apply to a defined group of products, depending on the rule conditions being met. Used to change the price in conjuction with a discount code.","properties":{"id":{"type":"integer","description":"Ruleset database ID."},"external_id":{"type":"string","description":"This is the string identifier for the ruleset, it is auto generated based in the discount code name."},"active":{"type":"boolean","description":"Indicates if this ruleset is currently active."},"internal_name":{"type":"string","description":"This is the name of the ruleset, it is auto generated based in the discount code name."},"created_at":{"type":"string","format":"date-time","description":"Ruleset creation date."},"updated_at":{"type":"string","format":"date-time","description":"If the ruleset was altered, this will be the most recent date in which any changes occurred."},"start_date":{"type":"string","format":"date-time","description":"Date from which the discount code should be considered valid (optional)."},"expiry_date":{"type":"string","format":"date-time","description":"Date from which the discount code should be considered expired/invalid (optional)."},"rules":{"type":"array","description":"Each one of the rules contained in this ruleset.","items":{"$ref":"#/components/schemas/Rule"}},"product_selection":{"oneOf":[{"$ref":"#/components/schemas/DiscountCodeProductSelection"},{"$ref":"#/components/schemas/DiscountCodeVariantSelection"},{"$ref":"#/components/schemas/DiscountCodeAllSelection"},{"$ref":"#/components/schemas/DiscountCodeCollectionSelection"},{"$ref":"#/components/schemas/DiscountCodeSKUSelection"}]}}},"DiscountCodeAllSelection":{"title":"DiscountCodeAllSelection","type":"object","description":"Expression used to determine that all products in the store should be eligible to the discount code.","properties":{"type":{"type":"string","enum":["PRODUCTS_ALL"],"description":"The type of selection; the discount code can be applicable to specific products/variants or to the entire store."}},"required":["type"]},"RuleResponse":{"title":"RuleResponse","type":"object","properties":{"id":{"type":"string","description":"rule_id"},"external_id":{"type":"string","description":"Rule\'s external id if exists"},"conditions":{"type":"array","items":{"oneOf":[{"$ref":"#/components/schemas/ConditionQtyByLine"},{"$ref":"#/components/schemas/ConditionQtyByVariant"},{"$ref":"#/components/schemas/ConditionQtyByProduct"},{"$ref":"#/components/schemas/ConditionQtyByMixAndMatch"},{"$ref":"#/components/schemas/ConditionCustomerGroup"},{"$ref":"#/components/schemas/ConditionCustomerProvince"},{"$ref":"#/components/schemas/ConditionLineItemProperty"},{"$ref":"#/components/schemas/ConditionRefUrl"},{"$ref":"#/components/schemas/ConditionQtyByBundle"},{"$ref":"#/components/schemas/ConditionSubscriptionGroup"},{"$ref":"#/components/schemas/ConditionSubscriptionInterval"},{"$ref":"#/components/schemas/ConditionCurrency"}]}},"actions":{"type":"array","items":{"anyOf":[{"$ref":"#/components/schemas/ActionPriceAdjustAbsolute"},{"$ref":"#/components/schemas/ActionPriceAdjustRelative"},{"$ref":"#/components/schemas/ActionPriceAdjustPercent"},{"$ref":"#/components/schemas/ActionPriceAdjustAbsoluteWithLimit"},{"$ref":"#/components/schemas/ActionPriceAdjustRelativeWithLimit"},{"$ref":"#/components/schemas/ActionCharmPrice"},{"$ref":"#/components/schemas/ActionAdjustRate"},{"$ref":"#/components/schemas/ActionAddFee"},{"$ref":"#/components/schemas/ActionDisplayQtyBreak"},{"$ref":"#/components/schemas/ActionCustomerDraftOrderTaxable"}]}}}},"ActionFreeShipping":{"type":"object","title":"ActionFreeShipping","additionalProperties":false,"properties":{"type":{"type":"string","enum":["FREE_SHIPPING"]}},"required":["type"]},"ActionShippingAdjustRelative":{"type":"object","title":"ActionShippingAdjustRelative","additionalProperties":false,"properties":{"type":{"type":"string","enum":["SHIPPING_ADJUST_RELATIVE"]},"value":{"type":"integer"}},"required":["type","value"],"description":""},"ActionShippingAdjustPercent":{"type":"object","title":"ActionShippingAdjustPercent","additionalProperties":false,"properties":{"type":{"type":"string","enum":["SHIPPING_ADJUST_PERCENT"]},"value":{"type":"integer"}},"required":["type","value"]},"LineItem":{"title":"LineItem","type":"object","x-examples":{"example-1":{"key":"string","price":0,"id":"string","quantity":0}},"properties":{"key":{"type":"string","description":"key of lineItem"},"price":{"type":"integer"},"id":{"type":"string","description":"Example: sku_id/product_id"},"quantity":{"type":"integer"}},"required":["key","price","id","quantity"]},"ProcessLineItem":{"title":"LineItem","type":"object","x-examples":{"example-1":{"key":"string","price":0,"id":"string","quantity":0}},"properties":{"key":{"type":"string","description":"key of lineItem"},"price":{"type":"integer"},"matchValue":{"type":"string","description":"Example: sku_id/product_id"},"quantity":{"type":"integer"}},"required":["key","price","matchValue","quantity"]},"BestProductPriceAction":{"title":"BestProductPriceAction","type":"object","properties":{"type":{"type":"string","description":"","enum":["BEST_ITEM_PRICE"]},"sku":{"type":"string"},"variant_id":{"type":"string"},"value":{"type":"number","description":"Final discounted price of the variant"},"rule":{"type":"array","items":{"$ref":"#/components/schemas/LineItemRule"}}}},"Customer":{"title":"Customer","type":"object","properties":{"email":{"type":"string"},"shipping":{"$ref":"#/components/schemas/CustomerShippingSchema"}},"x-examples":{"example-1":{"value":{"email":"string","shipping":{"postal_code":"string","country":"string","country_code":"string","province":"string","province_code":"string"}}}}},"CartAction":{"title":"CartAction","type":"object","properties":{"type":{"type":"string","enum":["SET_LINE_ITEM_PRICE"]},"line_item_key":{"type":"string"},"value":{"type":"integer"},"rule":{"type":"array","items":{"$ref":"#/components/schemas/LineItemRule"}},"variant_id":{"type":"string"}}},"LineItemRule":{"title":"LineItemRule","type":"object","properties":{"id":{"type":"integer","description":"rule id"},"rule_set_id":{"type":"integer","description":"ruleset id"},"rule_set_eid":{"type":"string","description":"external id of ruleset if exist"},"type":{"type":"string","enum":["DISCOUNT","ADDITION"]},"eid":{"type":"string","description":"external id of rule if exist"},"rule_set_public_message":{"type":"string","description":"public message of ruleset if exist"}}},"ActionCartAdjustRelative":{"type":"object","title":"ActionCartAdjustRelative","additionalProperties":false,"properties":{"type":{"type":"string","enum":["CART_ADJUST_RELATIVE"]},"value":{"type":"number"}},"required":["type","value"],"x-examples":{"example-1":{"type":"CART_ADJUST_RELATIVE","value":0}}},"ConditionCartSubtotalMin":{"type":"object","title":"ConditionCartSubtotalMin","additionalProperties":false,"description":"This condition is used by discount codes, and it defines a minimum cart subtotal amount for the order to be considered eligible to a certain discount code.","properties":{"type":{"type":"string","enum":["CART_SUBTOTAL_MIN"],"description":"Condition type, for this condition it should be always CART_SUBTOTAL_MIN."},"value":{"type":"integer","description":"Value to be used as the minimum cart total required; the amount is always an integer, so values like $8.99 should be given as 899, and full values as $5 should be given as 500."}},"required":["type","value"]},"ActionCartAdjustPercent":{"type":"object","title":"ActionCartAdjustPercent","additionalProperties":false,"properties":{"type":{"type":"string","enum":["CART_ADJUST_PERCENT"]},"value":{"type":"number"}},"required":["type","value"],"x-examples":{"example-1":{"type":"CART_ADJUST_PERCENT","value":0}}},"ConditionShippingRateRange":{"type":"object","title":"ConditionShippingRateRange","additionalProperties":false,"description":"This condition is used by discount codes, and it defines a minimum and a maximum shipping rate value for the order to be considered eligible to a certain discount code.","properties":{"type":{"type":"string","enum":["SHIPPING_RATE_RANGE"],"description":"Condition type, for this condition it should be always SHIPPING_RATE_RANGE."},"min_value":{"type":"integer","description":"Value to be used as the minimum shiping rate accepted; the amount is always an integer, so values like $8.99 should be given as 899, and full values as $5 should be given as 500."},"max_value":{"type":"integer","description":"Value to be used as the maximum shiping rate accepted; the amount is always an integer, so values like $8.99 should be given as 899, and full values as $5 should be given as 500."}},"required":["type"]},"BasicPatchRuleset":{"description":"A set of rules that can apply to a defined group of products, depending on the rule conditions being met. The basic patch ruleset type refers to the fields that should be passed when updating a ruleset.","type":"object","x-examples":{"example-1":{"ruleset":{"start_date":"2020-12-07T15:28:15.000-06:00","expiry_date":"2020-12-08T15:28:15.000-06:00","rules":[{"type":"DISCOUNT","conditions":[{"value":5,"type":"QTY_BY_LINE","operator":"=","requiresPrepare":true}],"actions":[{"value":99,"type":"PRICE_ADJUST_ABSOLUTE"}],"meta":{},"external_id":"realExternalId"}]}}},"properties":{"ruleset":{"type":"object","required":["rules"],"properties":{"start_date":{"type":"string","format":"date-time"},"expiry_date":{"type":"string","format":"date-time"},"rules":{"type":"array","uniqueItems":true,"minItems":1,"items":{"$ref":"#/components/schemas/Rule"}}}}},"required":["ruleset"]},"DiscountCodeCollectionSelection":{"type":"object","title":"DiscountCodeCollectionSelection","additionalProperties":false,"properties":{"type":{"type":"string","enum":["PRODUCT_SEARCH","PRODUCTS_EXCEPT"]},"collection_ids":{"type":"array","items":{"type":"string"}}},"required":["type","collection_ids"],"description":"Expression to filter which collections should be eligible for a discount code."},"ConditionQtyOnCart":{"title":"ConditionQtyOnCart","type":"object","description":"This condition is used by discount codes, and it defines a minimum amount of items in the cart for it to be considered eligible to a certain discount code.","properties":{"type":{"type":"string","enum":["QTY_ON_CART"],"description":"Condition type, for this condition it should be always QTY_ON_CART."},"value":{"type":"integer","description":"The minimum amount of items that must be in the cart for the code to be applicable."}},"required":["type","value"]},"ConditionCustomerId":{"title":"ConditionCustomerId","type":"object","x-examples":{"example-1":{"value":{"type":"CUSTOMER_ID","value":"some_email@gmail.com"}}},"properties":{"type":{"type":"string","description":"CUSTOMER_ID"},"value":{"type":"string","description":"A customer\'s email address"}},"description":"This ruleset condition allows giving specific customers a discount. To enable this condition, please contact our support team."},"ConditionCustomerInAnyGroupFromList":{"title":"ConditionCustomerInAnyGroupFromList","type":"object","description":"This condition is used by discount codes, and it defines a list of groups related to the code. If the customer belongs to any of these groups, they are eligible for the discount code.","properties":{"type":{"type":"string","enum":["CUSTOMER_IN_ANY_GROUP_FROM_LIST"],"description":"Condition type, for this condition it should be always CUSTOMER_IN_ANY_GROUP_FROM_LIST."},"list":{"type":"array","description":"List of groups to check and see if the customer belongs to any of them.","items":{"type":"string"}}},"required":["type","list"]},"ConditionCustomerCountry":{"title":"ConditionCustomerCountry","type":"object","description":"This condition is used by discount codes, and it defines a list of countries in which the discount code should be considered valid.","properties":{"type":{"type":"string","enum":["CUSTOMER_COUNTRY"],"description":"Condition type, for this condition it should be always CUSTOMER_COUNTRY."},"list":{"type":"array","description":"List of countries (alpha 2 codes, defined on ISO 3166-2) to check and see if the customer address belongs to any of them. Examples: US, CA, FR. The the proper code for each country can be obtained here: https://www.iso.org/obp/ui/#search","items":{"type":"string"}}},"required":["type","list"]},"ConditionBuyXGetYDiscountCode":{"type":"object","title":"ConditionBuyXGetYDiscountCode","description":"This condition is used exclusively by discount codes, and it describes a \\"Buy X Get Y\\" situation, in which you need to buy one or more required products to receive a % discount in one or more reward products. Important: this condition is only compatible with the action type PRICE_ADJUST_PERCENT.","additionalProperties":false,"properties":{"type":{"type":"string","enum":["BUY_X_GET_Y_DISCOUNT_CODE"],"description":"Condition type, for this condition it should be always BUY_X_GET_Y_DISCOUNT_CODE."},"buy_quantity":{"type":"integer","minimum":1,"description":"The minimum amount of products that must be bought to qualify the cart for this discount code."},"get_quantity":{"type":"integer","minimum":1,"description":"The maximum amount of products that can be discounted if the cart qualifies for this discount code."},"uses_per_order":{"type":"integer","minimum":1,"description":"In case a cart can qualify more than once for a code (for example, when using a \\"Buy 3 Get 2\\" discount code in a cart that has 9 required products and 6 reward products) this limits how many times the same discount can be applied for that order. If it is not provided, the default is 1."},"requirement_selection":{"oneOf":[{"$ref":"#/components/schemas/RequirementSelectionWithProducts"},{"$ref":"#/components/schemas/RequirementSelectionWithCollections"},{"$ref":"#/components/schemas/RequirementSelectionWithVariants"},{"$ref":"#/components/schemas/RequirementSelectionWithSKUs"}]}},"required":["type","buy_quantity","get_quantity","requirement_selection"]},"RequirementSelectionWithProducts":{"type":"object","title":"RequirementSelectionWithProducts","description":"This is used to list what are the requirements when configuring a \\"Buy X Get Y\\" discount code. Here you can list all the platform product ids that are accepted as qualifying items for a \\"Buy X Get Y\\" discount type.","additionalProperties":false,"properties":{"type":{"type":"string","enum":["PRODUCT_SEARCH"],"description":"Currently, the only type of selection supported is PRODUCT_SEARCH (that works for products, variants and collections)."},"product_ids":{"type":"array","description":"The list of product ids that are accepted as requirements to compose the \\"Buy X Get Y\\" promotion.","items":{"type":"string","minLength":1}}},"required":["type","product_ids"]},"RequirementSelectionWithCollections":{"title":"RequirementSelectionWithCollections","type":"object","description":"This is used to list what are the requirements when configuring a \\"Buy X Get Y\\" discount code. Here you can list all the platform collection ids that are accepted as qualifying items for a \\"Buy X Get Y\\" discount type.","additionalProperties":false,"properties":{"type":{"type":"string","enum":["PRODUCT_SEARCH"],"description":"Currently, the only type of selection supported is PRODUCT_SEARCH (that works for products, variants and collections)."},"collection_ids":{"type":"array","description":"The list of collection ids that are accepted as requirements to compose the \\"Buy X Get Y\\" promotion.","items":{"type":"string","minLength":1}}},"required":["type","collection_ids"]},"RequirementSelectionWithVariants":{"type":"object","title":"RequirementSelectionWithVariants","description":"This is used to list what are the requirements when configuring a \\"Buy X Get Y\\" discount code. Here you can list all the platform variant ids that are accepted as qualifying items for a \\"Buy X Get Y\\" discount type.","additionalProperties":false,"properties":{"type":{"type":"string","enum":["PRODUCT_SEARCH"],"description":"Currently, the only type of selection supported is PRODUCT_SEARCH (that works for products, variants and collections)."},"variant_ids":{"type":"array","description":"The list of variant ids that are accepted as requirements to compose the \\"Buy X Get Y\\" promotion.","items":{"type":"string","minLength":1}}},"required":["type","variant_ids"]},"RequirementSelectionWithSKUs":{"type":"object","title":"RequirementSelectionWithSKUs","description":"This is used to list what are the requirements when configuring a \\"Buy X Get Y\\" discount code. Here you can list all the product SKUs that are accepted as qualifying items for a \\"Buy X Get Y\\" discount type.","additionalProperties":false,"properties":{"type":{"type":"string","enum":["PRODUCT_SEARCH"],"description":"Currently, the only type of selection supported is PRODUCT_SEARCH (that works for products, variants, SKUs and collections)."},"sku_ids":{"type":"array","description":"The list of SKUs that are accepted as requirements to compose the \\"Buy X Get Y\\" promotion.","items":{"type":"string","minLength":1}}},"required":["type","sku_ids"]},"ActionPriceAdjustAbsoluteBasePrice":{"title":"ActionPriceAdjustAbsoluteBasePrice","type":"object","properties":{"value":{"type":"integer","example":299},"type":{"type":"string","enum":["PRICE_ADJUST_ABSOLUTE_BASE_PRICE"]}}},"ConditionCurrency":{"title":"ConditionCurrency","type":"object","properties":{"type":{"type":"string"},"value":{"type":"string","enum":["CURRENCY"]}}},"DiscountCodeRawProductSelection":{"title":"DiscountCodeRawProductSelection","type":"object","properties":{"type":{"type":"string","enum":["PRODUCT","COLLECTION"]},"selections":{"type":"array","items":{}}}},"ActionAdjustRate":{"title":"ActionAdjustRate","type":"object","properties":{"type":{"type":"string","enum":["PRICE_ADJUST_RATE"]},"value":{"type":"number"}},"required":["type","value"]},"TaggedCustomer":{"title":"TaggedCustomer","type":"object","properties":{"tags":{"type":"string","description":"Comma separated string like \\"vip,gold\\n\\""},"email":{"type":"string","description":"Email address"},"shipping":{"$ref":"#/components/schemas/CustomerShippingSchema"}}},"DiscountCodeSKUSelection":{"title":"DiscountCodeSKUSelection","type":"object","description":"Expression to filter which product SKUs should be eligible for a discount code.","additionalProperties":false,"properties":{"type":{"type":"string","enum":["PRODUCT_SEARCH"],"description":"The type of selection; the discount code can be applicable to specific products/variants/SKUs or to the entire store."},"sku_ids":{"type":"array","description":"List of product SKUs eligible for the discount code.","items":{"type":"string"}}},"required":["type","sku_ids"]},"OrderConditionCustomerSchema":{"title":"OrderConditionCustomerSchema","type":"object","properties":{"shipping":{"$ref":"#/components/schemas/CustomerShippingSchema"}}},"CustomerShippingSchema":{"title":"CustomerShippingSchema","type":"object","properties":{"postal_code":{"type":"string"},"country":{"type":"string"},"country_code":{"type":"string"},"province":{"type":"string"},"province_code":{"type":"string"}}}}}}},"plugin-redoc-7":{"url":"/api/products.openapi.yaml","themeId":"theme-redoc","isSpecFile":true,"spec":{"openapi":"3.0.0","info":{"title":"Internal products service","description":"This API allows you to find information about your products, variants and categories.\\n\\nRefer to the changelog for the latest updates to this API.","contact":{"name":"Contact Us","url":"https://developer-dashboard.boldcommerce.com/default/contactus"},"version":"2.0.0"},"servers":[{"url":"http://product-api.prod.svc.cluster.local:9000"},{"url":"http://product-api.staging.svc.cluster.local:9000"},{"url":"http://localhost:9200"}],"tags":[{"name":"Customer Event Notifications","description":"Event notifications you send to Bold when a change occurs to customers on the platform."},{"name":"Order Event Notifications","description":"Event notifications you send to Bold when a change occurs to orders on the platform."},{"name":"Product Event Notifications","description":"Event notifications you send to Bold when a change occurs to products on the platform."},{"name":"Products","description":"Contains information about the products associated with a given store. Use these endpoints to retrieve information about one or all products on a store."},{"name":"Variants","description":"A child of the Product resource. Contains information about the variants of a product, which are derived from different combinations of options. Use these endpoints to retrieve information about a single variant, the variants of a single product, or all variants on a store."},{"name":"Categories","description":"Contains information about the product categories applicable on a given store. Use these endpoints to retrieve information about one or all product categories on a store."},{"name":"Images","description":"Contains information about the product images associated with a given store. Use these endpoints to retrieve information about one or all product images on a store."},{"name":"Options","description":"A child of the Product resource. Contains information about the options associated with a given product, such as colors, sizes, weights, etc. Use these endpoints to retrieve information about one or all product options for a product."}],"paths":{"/v1/shops/{shop_identifier}/platforms/custom/webhooks/products/saved":{"parameters":[{"$ref":"#/components/parameters/shopIdentifier"}],"post":{"tags":["Product Event Notifications"],"summary":"Product Saved","operationId":"ProductSavedEventNotification","description":"Trigger this API call when product data changes, including product creation and updates.\\n\\nBold queues the product for saving. The request must contain the complete product object at the time the change occurred. Bold replaces all fields of the existing product object with the values provided in the request body. Bold ignores and does not update fields omitted from the request body. \\n\\nThe `platform_updated_at` field must be accurate to mitigate the risk incurred by out-of-sequence requests.","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/productSavedRequestBody"}}},"required":true},"responses":{"202":{"description":"Event notification was queued successfully.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"A validation error occurred.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/validationError"},"examples":{"validationError":{"value":{"status_code":400,"errors":["Error at \'/data/product/platform_id\': property \'platform_id\' is missing.","Error at \'/data/product/variants/0/platform_id\': property \'platform_id\' is missing."]}}}}}},"500":{"description":"An unexpected error occurred.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/runtimeErrorProduct"}}}}}}},"/v1/shops/{shop_identifier}/platforms/custom/webhooks/products/deleted":{"parameters":[{"$ref":"#/components/parameters/shopIdentifier"}],"post":{"tags":["Product Event Notifications"],"summary":"Product Deleted","operationId":"ProductDeletedEventNotification","description":"Trigger this API call when a product is deleted on the platform.\\n\\nBold queues the product for deletion. The `platform_deleted_at` field must be accurate to mitigate the risk incurred by out-of-sequence requests.","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/productDeletedRequestBody"}}},"required":true},"responses":{"202":{"description":"Event notification was queued successfully.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"A validation error occurred.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/validationError"},"examples":{"validationError":{"value":{"status_code":400,"errors":["Error at \'/data/product/platform_id\': property \'platform_id\' is missing."]}}}}}},"500":{"description":"An unexpected error response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/runtimeErrorProduct"}}}}}}},"/v1/shops/{shop_identifier}/platforms/custom/webhooks/categories/saved":{"parameters":[{"$ref":"#/components/parameters/shopIdentifier"}],"post":{"tags":["Product Event Notifications"],"summary":"Product Category Saved","operationId":"CategorySavedEventNotification","description":"Trigger this API call when a product category is saved on the platform.\\n\\nBold queues the product category for saving. The request contains the complete product category object at the time the change occurred. Bold replaces all fields of the existing product category object with the values provided in the request\\nbody. Fields omitted from the request body are ignored in the `category` object.\\n\\nThe `platform_updated_at` field must be accurate to mitigate the risk incurred by out-of-sequence requests.","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/categorySavedRequestBody"}}},"required":true},"responses":{"202":{"description":"Notification queued successfully","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"A validation error occurred.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/validationError"},"examples":{"validationError":{"value":{"status_code":400,"errors":["Error at \'/data/category/platform_id\': property \'platform_id\' is missing."]}}}}}},"500":{"description":"An unexpected error response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/runtimeErrorProduct"}}}}}}},"/v1/shops/{shop_identifier}/platforms/custom/webhooks/categories/deleted":{"parameters":[{"$ref":"#/components/parameters/shopIdentifier"}],"post":{"tags":["Product Event Notifications"],"summary":"Product Category Deleted","operationId":"CategoryDeletedEventNotification","description":"Trigger this API call when a product category is deleted on the platform.\\n\\nBold queues the product category for deletion. The `platform_deleted_at` field must be accurate to mitigate the risk incurred by out-of-sequence requests.","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/categoryDeletedRequestBody"}}},"required":true},"responses":{"202":{"description":"Notification queued successfully","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"A validation error occurred.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/validationError"},"examples":{"validationError":{"value":{"status_code":400,"errors":["Error at \'/data/category/platform_id\': property \'platform_id\' is missing."]}}}}}},"500":{"description":"An unexpected error response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/runtimeErrorProduct"}}}}}}},"/v2/shops/{shop_identifier}/categories":{"get":{"tags":["Categories"],"summary":"List Categories","operationId":"ListCategories","description":"Lists product categories for the shop.\\n\\nFor more information on result pagination, refer to the [Query & Pagination](/guides/checkout/resources/query-pagination) page.","parameters":[{"$ref":"#/components/parameters/shopIdentifierParam"},{"$ref":"#/components/parameters/limit"},{"$ref":"#/components/parameters/page"},{"name":"ids","in":"query","schema":{"type":"string","description":"A comma-separated list of category identifiers, defining which categories to return.","example":"123,456,789"}}],"responses":{"200":{"description":"A successful response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/v2CategoryListResponse"}}}},"default":{"description":"An unexpected error response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/runtimeError"}}}}}}},"/v2/shops/{shop_identifier}/categories/pid/{pid}":{"get":{"tags":["Categories"],"summary":"Get Category by Platform ID","operationId":"GetCategoryByPlatformID","description":"Retrieves a product category by its platform-assigned identifier.","parameters":[{"$ref":"#/components/parameters/shopIdentifierParam"},{"name":"pid","in":"path","required":true,"schema":{"type":"string"},"description":"The unique identifier for the category. Assigned by the shop platform.","example":"110"}],"responses":{"200":{"description":"A successful response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/v2CategoryByXIDResponse"}}}},"default":{"description":"An unexpected error response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/runtimeError"}}}}}}},"/v2/shops/{shop_identifier}/categories/{id}":{"get":{"tags":["Categories"],"summary":"Get Category by ID","operationId":"GetCategoryByID","description":"Retrieves a product category by its Bold-assigned identifier.","parameters":[{"$ref":"#/components/parameters/shopIdentifierParam"},{"name":"id","in":"path","required":true,"schema":{"type":"integer","format":"int64"},"description":"The unique identifier for this category. Assigned by Bold.","example":100}],"responses":{"200":{"description":"A successful response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/v2CategoryByXIDResponse"}}}},"default":{"description":"An unexpected error response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/runtimeError"}}}}}}},"/v2/shops/{shop_identifier}/products":{"get":{"tags":["Products"],"summary":"List Products","operationId":"ListProducts","description":"Lists all products in the shop.\\n\\nFor more information on result pagination, refer to the [Query & Pagination](/guides/checkout/resources/query-pagination) page.","parameters":[{"$ref":"#/components/parameters/shopIdentifierParam"},{"$ref":"#/components/parameters/deep"},{"$ref":"#/components/parameters/limit"},{"$ref":"#/components/parameters/page"},{"$ref":"#/components/parameters/filter"},{"name":"categoryid","in":"query","description":"The category identifier to search within. Assigned by Bold.","schema":{"type":"integer","format":"int64"},"example":100},{"name":"filtercolumn","in":"query","description":"The column name by which to perform a fuzzy search with the `filtervalue`.","schema":{"type":"string"},"example":"type"},{"name":"filtervalue","in":"query","description":"A search term used to perform a fuzzy search on the `filtercolumn`.","schema":{"type":"string"},"example":"%27hat%27"},{"name":"ordercolumn","in":"query","description":"The method of ordering the returned results. Must be paired with the `orderdirection` query parameter.","schema":{"type":"string"},"example":"type"},{"name":"orderdirection","in":"query","description":"The direction of ordering returned results. Must be paired with the `ordercolumn` query parameter. Possible values include `asc` and `desc`.","schema":{"type":"string"},"example":"asc"},{"name":"updated_at_min","in":"query","description":"The earliest date (in [RFC3339 format](https://datatracker.ietf.org/doc/html/rfc3339)) the customer was updated.","schema":{"type":"string","format":"date-time"},"example":"2020-01-01T00:00:00Z"},{"name":"updated_at_max","in":"query","description":"The latest date (in [RFC3339 format](https://datatracker.ietf.org/doc/html/rfc3339)) the product was updated.","schema":{"type":"string","format":"date-time"},"example":"2020-01-02T00:00:00Z"},{"name":"include_deleted","in":"query","description":"Indicates whether to include deleted products in search results.","schema":{"type":"boolean","format":"boolean"},"example":true},{"name":"es_optimize","in":"query","description":"Indicates whether to optimize the results for Elasticsearch.","schema":{"type":"boolean","format":"boolean"},"example":true}],"responses":{"200":{"description":"A successful response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/v2ProductListResponse"}}}},"default":{"description":"An unexpected error response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/runtimeError"}}}}}}},"/v2/shops/{shop_identifier}/products/categories":{"get":{"tags":["Categories"],"summary":"List Product Categories","operationId":"ListProductCategories","description":"Lists product categories for the shop.\\n\\nFor more information on result pagination, refer to the [Query & Pagination](/guides/checkout/resources/query-pagination) page.","parameters":[{"$ref":"#/components/parameters/shopIdentifierParam"},{"$ref":"#/components/parameters/limit"},{"$ref":"#/components/parameters/page"},{"$ref":"#/components/parameters/filter"}],"responses":{"200":{"description":"A successful response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/v2ProductCategoryListResponse"}}}},"default":{"description":"An unexpected error response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/runtimeError"}}}}}}},"/v2/shops/{shop_identifier}/products/pid/{pid}":{"get":{"tags":["Products"],"summary":"Get Product by Platform ID","operationId":"GetProductByPlatformID","description":"Retrieves a product by its platform-specific identifier.","parameters":[{"$ref":"#/components/parameters/shopIdentifierParam"},{"$ref":"#/components/parameters/deep"},{"name":"pid","in":"path","required":true,"schema":{"type":"string"},"description":"The unique identifier for this category. Assigned by the shop platform.","example":"110"}],"responses":{"200":{"description":"A successful response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/v2ProductByXIDResponse"}}}},"default":{"description":"An unexpected error response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/runtimeError"}}}}}}},"/v2/shops/{shop_identifier}/products/{bold_product_id}/images":{"get":{"tags":["Images"],"summary":"List Product Images","operationId":"ListProductImages","description":"Lists images for a product by its Bold-specific identifier.\\n\\nFor more information on result pagination, refer to the [Query & Pagination](/guides/checkout/resources/query-pagination) page.","parameters":[{"$ref":"#/components/parameters/shopIdentifierParam"},{"$ref":"#/components/parameters/boldProductId"},{"$ref":"#/components/parameters/limit"},{"$ref":"#/components/parameters/page"}],"responses":{"200":{"description":"A successful response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/v2ImageListResponse"}}}},"default":{"description":"An unexpected error response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/runtimeError"}}}}}}},"/v2/shops/{shop_identifier}/products/{bold_product_id}/images/pid/{pid}":{"get":{"tags":["Images"],"summary":"Get Product Image by Platform ID","operationId":"GetProductImageByPlatformID","description":"Retrieves a product image by its platform-assigned identifier.","parameters":[{"$ref":"#/components/parameters/shopIdentifierParam"},{"$ref":"#/components/parameters/boldProductId"},{"name":"pid","in":"path","required":true,"schema":{"type":"string"},"description":"A unique identifier for the product. Assigned by the shop platform.","example":"456"}],"responses":{"200":{"description":"A successful response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/v2ImageByXIDResponse"}}}},"default":{"description":"An unexpected error response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/runtimeError"}}}}}}},"/v2/shops/{shop_identifier}/products/{bold_product_id}/images/{id}":{"get":{"tags":["Images"],"summary":"Get Product Image by ID","operationId":"GetProductImageByID","description":"Retrieves a product image by its Bold-assigned identifier.","parameters":[{"$ref":"#/components/parameters/shopIdentifierParam"},{"$ref":"#/components/parameters/boldProductId"},{"name":"id","in":"path","required":true,"schema":{"type":"integer","format":"int64"},"description":"A unique identifier for the product image. Assigned by Bold.","example":456}],"responses":{"200":{"description":"A successful response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/v2ImageByXIDResponse"}}}},"default":{"description":"An unexpected error response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/runtimeError"}}}}}}},"/v2/shops/{shop_identifier}/products/{bold_product_id}/options":{"get":{"tags":["Options"],"summary":"List Product Options","operationId":"ListProductOptions","description":"Lists the options for a product by its Bold-specific identifier.\\n\\nFor more information on result pagination, refer to the [Query & Pagination](/guides/checkout/resources/query-pagination) page.","parameters":[{"$ref":"#/components/parameters/shopIdentifierParam"},{"$ref":"#/components/parameters/boldProductId"},{"$ref":"#/components/parameters/limit"},{"$ref":"#/components/parameters/page"}],"responses":{"200":{"description":"A successful response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/v2OptionListResponse"}}}},"default":{"description":"An unexpected error response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/runtimeError"}}}}}}},"/v2/shops/{shop_identifier}/products/{bold_product_id}/options/pid/{pid}":{"get":{"tags":["Options"],"summary":"Get Product Option by Platform ID","operationId":"GetProductOptionByPlatformID","description":"Retrieves a product option by the platform-specific option identifier.","parameters":[{"$ref":"#/components/parameters/shopIdentifierParam"},{"$ref":"#/components/parameters/boldProductId"},{"name":"pid","in":"path","required":true,"schema":{"type":"string"},"description":"A unique identifier for this product option. Assigned by the shop platform.","example":"110"}],"responses":{"200":{"description":"A successful response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/v2OptionByXIDResponse"}}}},"default":{"description":"An unexpected error response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/runtimeError"}}}}}}},"/v2/shops/{shop_identifier}/products/{bold_product_id}/options/{id}":{"get":{"tags":["Options"],"summary":"Get Product Option by ID","operationId":"GetProductOptionByID","description":"Retrieves a product option by the Bold-specific option identifier.","parameters":[{"$ref":"#/components/parameters/shopIdentifierParam"},{"$ref":"#/components/parameters/boldProductId"},{"name":"id","in":"path","required":true,"schema":{"type":"integer","format":"int64"},"description":"The unique identifier for the product option. Assigned by Bold.","example":100}],"responses":{"200":{"description":"A successful response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/v2OptionByXIDResponse"}}}},"default":{"description":"An unexpected error response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/runtimeError"}}}}}}},"/v2/shops/{shop_identifier}/products/{bold_product_id}/variants":{"get":{"tags":["Variants"],"summary":"List Product Variants","operationId":"ListProductVariants","description":"Lists the variants for a product by its Bold-specific product identifier.\\n\\nFor more information on result pagination, refer to the [Query & Pagination](/guides/checkout/resources/query-pagination) page.","parameters":[{"$ref":"#/components/parameters/shopIdentifierParam"},{"$ref":"#/components/parameters/boldProductId"},{"$ref":"#/components/parameters/limit"},{"$ref":"#/components/parameters/page"}],"responses":{"200":{"description":"A successful response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/v2VariantListResponse"}}}},"default":{"description":"An unexpected error response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/runtimeError"}}}}}}},"/v2/shops/{shop_identifier}/products/{bold_product_id}/variants/pid/{pid}":{"get":{"tags":["Variants"],"summary":"Get Product Variant by Platform ID","operationId":"GetProductVariantByPlatformID","description":"Retrieves a product variant by its platform-specific identifier.","parameters":[{"$ref":"#/components/parameters/shopIdentifierParam"},{"$ref":"#/components/parameters/boldProductId"},{"name":"pid","in":"path","required":true,"schema":{"type":"string"},"description":"The unique identifier for this product variant. Assigned by the shop platform.","example":"110"}],"responses":{"200":{"description":"A successful response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/v2VariantByXIDResponse"}}}},"default":{"description":"An unexpected error response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/runtimeError"}}}}}}},"/v2/shops/{shop_identifier}/products/{bold_product_id}/variants/{id}":{"get":{"tags":["Variants"],"summary":"Get Product Variant by ID","operationId":"GetProductVariantByID","description":"Retrieves a product variant by its Bold-specific identifier.","parameters":[{"$ref":"#/components/parameters/shopIdentifierParam"},{"$ref":"#/components/parameters/boldProductId"},{"name":"id","in":"path","required":true,"schema":{"type":"integer","format":"int64"},"description":"The unique identifier for this product variant. Assigned by Bold.","example":100}],"responses":{"200":{"description":"A successful response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/v2VariantByXIDResponse"}}}},"default":{"description":"An unexpected error response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/runtimeError"}}}}}}},"/v2/shops/{shop_identifier}/products/{id}":{"get":{"tags":["Products"],"summary":"Get Product by ID","operationId":"GetProductByID","description":"Retrieves a product by its Bold-specific identifier.","parameters":[{"$ref":"#/components/parameters/shopIdentifierParam"},{"$ref":"#/components/parameters/deep"},{"name":"id","in":"path","required":true,"schema":{"type":"integer","format":"int64"},"description":"The unique identifier for this product. Assigned by Bold.","example":100}],"responses":{"200":{"description":"A successful response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/v2ProductByXIDResponse"}}}},"default":{"description":"An unexpected error response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/runtimeError"}}}}}}},"/v2/shops/{shop_identifier}/types":{"get":{"tags":["Products"],"summary":"List Product Types","operationId":"ListProductTypes","description":"Lists the product types for all products in the shop.\\n\\nFor more information on result pagination, refer to the [Query & Pagination](/guides/checkout/resources/query-pagination) page.","parameters":[{"$ref":"#/components/parameters/shopIdentifierParam"}],"responses":{"200":{"description":"A successful response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/v2ProductTypeListResponse"}}}},"default":{"description":"An unexpected error response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/runtimeError"}}}}}}},"/v2/shops/{shop_identifier}/variants":{"get":{"tags":["Variants"],"summary":"List Variants for Shop","operationId":"ListVariantsForShop","description":"Lists all product variants in the shop.\\n\\nFor more information on result pagination, refer to the [Query & Pagination](/guides/checkout/resources/query-pagination) page.","parameters":[{"$ref":"#/components/parameters/shopIdentifierParam"},{"$ref":"#/components/parameters/filter"},{"$ref":"#/components/parameters/limit"},{"$ref":"#/components/parameters/page"}],"responses":{"200":{"description":"A successful response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/v2AllVariantsListResponse"}}}},"default":{"description":"An unexpected error response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/runtimeError"}}}}}}},"/v2/shops/{shop_identifier}/vendors":{"get":{"tags":["Products"],"summary":"List Product Vendors","operationId":"ListProductVendors","description":"Lists the vendors for all products in the shop.\\n\\nFor more information on result pagination, refer to the [Query & Pagination](/guides/checkout/resources/query-pagination) page.","parameters":[{"$ref":"#/components/parameters/shopIdentifierParam"}],"responses":{"200":{"description":"A successful response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/v2VendorListResponse"}}}},"default":{"description":"An unexpected error response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/runtimeError"}}}}}}}},"components":{"parameters":{"shopIdentifier":{"name":"shop_identifier","in":"path","description":"A unique identifier of the store. This can be retrieved by calling the [Get Shop\\nInfo](shops#tag/Shops/operation/GetShopInfo#) endpoint.","required":true,"schema":{"type":"string","example":"zp3oafdor9"}},"shopIdentifierParam":{"name":"shop_identifier","in":"path","required":true,"schema":{"type":"string"},"description":"A unique identifier of the store. Retrieve this information by calling the [Get Shop Info](shops#tag/Shop/operation/GetShopInfo) endpoint.","example":"zp3oafdor9"},"limit":{"name":"limit","in":"query","schema":{"type":"integer","format":"int32"},"description":"The maximum number of results to return per page.","example":50},"page":{"name":"page","in":"query","schema":{"type":"integer","format":"int32"},"description":"The desired page number for the paginated results.","example":1},"deep":{"name":"deep","in":"query","description":"Indicates whether to perform a deep search. When set to `true`, this endpoint fetches and populates related child entities for the product in the response payload, including: \\n* `options`\\n* `variants` and their `option_values`\\n* `images`\\n* `categories`\\n* `localized_names`\\n* `localized_descriptions`","schema":{"type":"boolean","format":"boolean"},"example":true},"filter":{"name":"filter","in":"query","style":"form","explode":true,"schema":{"type":"array","items":{"type":"string"}},"description":"A filter for returned results.\\n\\nAccepts filtering options as described in the [Query & Pagination](/guides/checkout/resources/query-pagination#filter) page.","example":["eq(target:order)"]},"boldProductId":{"name":"bold_product_id","in":"path","required":true,"schema":{"type":"integer","format":"int64"},"description":"A unique identifier for the product. Assigned by Bold.","example":123}},"schemas":{"productBase":{"type":"object","properties":{"description":{"type":"string","description":"The description for the product.","example":"A hat for the beach"},"handle":{"type":"string","description":"A unique, human-readable string for the product.","example":"beach-hat"},"inventory_quantity":{"type":"integer","description":"The current inventory amount of the product.","format":"int64","example":2},"inventory_tracking_entity":{"type":"string","description":"The entity on which inventory is tracked.","enum":["variant","product","none"],"example":"product"},"inventory_tracking_service":{"type":"string","description":"The service that tracks inventory.","example":"platform"},"localized_descriptions":{"type":"object","description":"A map of localized descriptions for the product. The key is the [ISO-639](https://www.iso.org/iso-639-language-codes.html) two character language code. The value is the product description in the given language.","additionalProperties":{"type":"string"},"example":{"en":"A hat for the beach","fr":"Un chapeau pour la plage"}},"localized_names":{"type":"object","description":"A map of localized names for the product. The key is the [ISO-639](https://www.iso.org/iso-639-language-codes.html) two character language code. The value is the product name in the given language.","additionalProperties":{"type":"string"},"example":{"en":"Beach Hat","fr":"Chapeau de Plage"}},"name":{"type":"string","description":"The product name.","example":"Beach hat"},"published":{"type":"boolean","description":"Indicates if the product is published on the storefront.","example":true},"tags":{"type":"string","description":"A string with comma separated values describing the product.","example":"clothing, unisex, headwear"},"tax_code":{"type":"string","description":"The tax code for the product.","example":"non-taxable"},"type":{"type":"string","description":"A representation of platform-specific product data. The role of this field depends on the platform:\\n\\n- BigCommerce: The product type, either `physical` or `digital`.\\n- commercetools: A merchant or partner-defined data set, valid as per options set in the platform.\\n- Shopify: A product categorization, used for filtering and searching products.\\n- Custom: Defined by the platform.","example":"physical"},"url":{"type":"string","description":"A URL to the product on the storefront.","example":"/hats/beach-hat"},"vendor":{"type":"string","description":"The product vendor.","example":"OFS"}}},"categoryBase":{"type":"object","properties":{"image_url":{"description":"The URL location of the category image.","type":"string","example":"your_platform_connector.com/files/categories/hats.jpg"},"name":{"description":"The name of the category.","type":"string","example":"Hats"}}},"category":{"type":"object","allOf":[{"$ref":"#/components/schemas/categoryBase"}],"properties":{"platform_id":{"type":"string","description":"A unique identifier for the category. Defined by the platform.","example":"category-123456"},"platform_updated_at":{"type":"string","format":"date-time","description":"The date and time the category was last updated on the platform, in [RFC 3339, section 5.6 format](https://datatracker.ietf.org/doc/html/rfc3339#section-5.6). If never updated, defaults to the `platform_created_at` value.","example":"2019-08-24T14:15:22Z"}},"required":["platform_id","platform_updated_at"]},"variantBase":{"type":"object","description":"An array of `variant` objects. At least one variant is required. If the product has no variants, the variant can reuse the product information.","properties":{"allow_backorder":{"description":"If backorders of the variant is allowed.","type":"boolean","format":"boolean"},"compare_at_price":{"description":"The original price of the item before an adjustment or a sale.","type":"string","example":"30.00"},"cost":{"description":"The cost of the product variant.","type":"string","example":"30.00"},"grams":{"description":"The weight of the product variant in grams.","type":"integer","format":"int64"},"image_url":{"description":"URL of the image.","type":"string","example":"your_platform_connector.com/files/products/hats/purple-beach-hat.jpg"},"inventory_quantity":{"description":"Current inventory level of the product.","type":"integer","format":"int64"},"inventory_tracking_entity":{"type":"string","description":"Entity on which inventory is tracked.","enum":["variant","product","none"]},"inventory_tracking_service":{"type":"string","description":"Service that tracks inventory.","example":"platform"},"localized_names":{"type":"object","additionalProperties":{"type":"string"},"description":"Map of localized names for the variant. The field is the [ISO-639](https://www.iso.org/iso-639-language-codes.html) two character language code. The value is the product name in the given language.","example":{"en":"Purple","fr":"Violette"}},"name":{"description":"The name of the variant. If there is only one variant, the `name` must be \\"Default Title\\" in order to avoid displaying the same `name` twice.","type":"string","example":"Default Title"},"price":{"description":"The price of the variant","type":"string","example":"30.00"},"require_shipping":{"description":"True if the item needs to be shipped, false otherwise.","type":"boolean","format":"boolean"},"sku":{"description":"Variant SKU.","type":"string","example":"BEACH-HAT-PURPLE"},"tax_code":{"description":"Tax code for the variant.","type":"string","example":"non-taxable"},"tax_exempt":{"description":"Indicates whether the variant is tax-exempt. If `true`, the variant is tax-exempt.","type":"boolean","format":"boolean","nullable":true},"weight":{"type":"string","description":"The weight of the product variant, calculated with weight unit specified.","example":"1.0"},"weight_unit":{"type":"string","description":"The unit of measurement that applies to the product variant\'s weight.","example":"kg"}}},"variantOptionValue":{"type":"object","description":"A more granular level of customization for variants. These are not required, but can be used to provide more options for your same variant.","properties":{"platform_id":{"type":"string","description":"A unique identifier for the variant option value. Defined by the platform.","example":"abc123456"},"platform_product_option_id":{"type":"string","description":"The unique identifier for the product option this value belongs to. Defined by the platform.","example":"VAR-10001-SM"},"label":{"type":"string","description":"The label of the option value.","example":"small"},"name":{"type":"string","description":"The name of the option.","example":"Small"}}},"deepVariant":{"type":"object","allOf":[{"$ref":"#/components/schemas/variantBase"}],"properties":{"platform_id":{"type":"string","description":"A unique identifier for the variant. Defined by the platform.","example":"variant-123456"},"option_values":{"type":"array","items":{"$ref":"#/components/schemas/variantOptionValue"}}},"required":["platform_id","allow_backorder","price","weight"]},"optionBase":{"type":"object","properties":{"name":{"description":"The option name.","type":"string","example":"Small"},"position":{"description":"The position in the `options` array.","type":"integer","format":"int64","example":1}}},"optionValueBase":{"type":"object","properties":{"is_default":{"type":"boolean","description":"Indicates whether this is the default option.","format":"boolean"},"label":{"description":"The label of the option value.","type":"string","example":"Small"},"position":{"description":"The position in the `option_values` array.","type":"integer","format":"int64","example":1}}},"deepOptionValue":{"type":"object","allOf":[{"$ref":"#/components/schemas/optionValueBase"}],"properties":{"platform_id":{"type":"string","description":"A unique identifier for the option value. Defined by the platform.","example":"option-value-123456"}}},"deepOption":{"type":"object","allOf":[{"$ref":"#/components/schemas/optionBase"}],"properties":{"platform_id":{"type":"string","description":"A unique identifier for the product option. Defined by the platform.","example":"product-option-123456"},"option_values":{"type":"array","items":{"$ref":"#/components/schemas/deepOptionValue"}}}},"imageBase":{"type":"object","properties":{"name":{"description":"The image name.","type":"string","example":"Beach hat"},"src":{"description":"The image URL.","type":"string","example":"https://example.com/images/beach-hat.jpg"},"position":{"description":"The position in the `images` array.","type":"integer","format":"int64","example":1}}},"deepImage":{"type":"object","allOf":[{"$ref":"#/components/schemas/imageBase"}],"properties":{"platform_id":{"type":"string","description":"A unique identifier for the image. Defined by the platform.","example":"image-123456"}}},"product":{"type":"object","allOf":[{"$ref":"#/components/schemas/productBase"}],"properties":{"platform_id":{"type":"string","description":"A unique identifier for the product. Defined by the platform.","example":"product-123456"},"platform_updated_at":{"description":"The date the product was last updated on the platform.","type":"string","format":"date-time","example":"2019-08-24T14:15:22Z"},"categories":{"type":"array","items":{"$ref":"#/components/schemas/category"}},"variants":{"type":"array","description":"An array of `variant` objects. At least one variant is required. If the product has no variants, the variant can reuse the product information.","items":{"$ref":"#/components/schemas/deepVariant"}},"options":{"type":"array","description":"An array of product options.","items":{"$ref":"#/components/schemas/deepOption"}},"images":{"type":"array","description":"An array of images depicting the product.","items":{"$ref":"#/components/schemas/deepImage"}}},"required":["platform_id","platform_updated_at","variants"]},"productSavedRequestData":{"type":"object","properties":{"product":{"description":"The product object.","$ref":"#/components/schemas/product"}},"required":["product"]},"productSavedRequestBody":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/productSavedRequestData"}},"required":["data"]},"validationError":{"type":"object","properties":{"status_code":{"type":"number"},"errors":{"type":"array","items":{"type":"string"}}}},"runtimeErrorProduct":{"type":"object","properties":{"errors":{"type":"array","items":{"required":["code"],"type":"object","properties":{"code":{"type":"string","description":"The error code.","example":"07-1"},"message":{"type":"string","description":"The error message.","example":"Request failed due to an internal server error."},"type":{"type":"string","description":"The type of error.","example":"server.internal_error"}}}}}},"deletedProduct":{"type":"object","properties":{"platform_id":{"description":"The platform ID of the product to be deleted.","type":"string","example":"product-123456"},"platform_deleted_at":{"description":"The date the order was deleted on the platform, (in [RFC3339 format](https://datatracker.ietf.org/doc/html/rfc3339)). Assigned by the platform.","type":"string","format":"date-time","example":"2020-08-24T14:15:22Z"}},"required":["platform_id","platform_deleted_at"]},"productDeletedRequestData":{"type":"object","properties":{"product":{"$ref":"#/components/schemas/deletedProduct"}},"required":["product"]},"productDeletedRequestBody":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/productDeletedRequestData"}},"required":["data"]},"categorySavedRequestData":{"type":"object","properties":{"category":{"$ref":"#/components/schemas/category"}},"required":["category"]},"categorySavedRequestBody":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/categorySavedRequestData"}},"required":["data"]},"deletedCategory":{"type":"object","properties":{"platform_id":{"description":"The platform ID of the category to be deleted.","type":"string","example":"category-123456"},"platform_deleted_at":{"type":"string","format":"date-time","description":"The date and time this category was deleted on the platform, in [RFC 3339, section 5.6 format](https://datatracker.ietf.org/doc/html/rfc3339#section-5.6).","example":"2019-09-24T14:15:22Z"}},"required":["platform_id","platform_deleted_at"]},"categoryDeletedRequestData":{"type":"object","properties":{"category":{"$ref":"#/components/schemas/deletedCategory"}},"required":["category"]},"categoryDeletedRequestBody":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/categoryDeletedRequestData"}},"required":["data"]},"protobufAny":{"type":"object","properties":{"type_url":{"type":"string","description":"A URL/resource name that uniquely identifies the type of the serialized\\nprotocol buffer message. This string must contain at least\\none \\"/\\" character. The last segment of the URL\'s path must represent\\nthe fully qualified name of the type (as in\\n`path/google.protobuf.Duration`). The name should be in a canonical form\\n(e.g., leading \\".\\" is not accepted).\\n\\nIn practice, teams usually precompile into the binary all types that they\\nexpect it to use in the context of Any. However, for URLs which use the\\nscheme `http`, `https`, or no scheme, one can optionally set up a type\\nserver that maps type URLs to message definitions as follows:\\n\\n* If no scheme is provided, `https` is assumed.\\n* An HTTP GET on the URL must yield a [google.protobuf.Type][]\\n value in binary format, or produce an error.\\n* Applications are allowed to cache lookup results based on the\\n URL, or have them precompiled into a binary to avoid any\\n lookup. Therefore, binary compatibility needs to be preserved\\n on changes to types. (Use versioned type names to manage\\n breaking changes.)\\n\\nNote: this functionality is not currently available in the official\\nprotobuf release, and it is not used for type URLs beginning with\\ntype.googleapis.com.\\n\\nSchemes other than `http`, `https` (or the empty scheme) might be\\nused with implementation specific semantics."},"value":{"pattern":"^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$","type":"string","description":"Must be a valid serialized protocol buffer of the above specified type.","format":"byte"}},"description":"`Any` contains an arbitrary serialized protocol buffer message along with a\\nURL that describes the type of the serialized message.\\n\\nProtobuf library provides support to pack/unpack Any values in the form\\nof utility functions or additional generated methods of the Any type.\\n\\nExample 1: Pack and unpack a message in C++.\\n\\n Foo foo = ...;\\n Any any;\\n any.PackFrom(foo);\\n ...\\n if (any.UnpackTo(&foo)) {\\n ...\\n }\\n\\nExample 2: Pack and unpack a message in Java.\\n\\n Foo foo = ...;\\n Any any = Any.pack(foo);\\n ...\\n if (any.is(Foo.class)) {\\n foo = any.unpack(Foo.class);\\n }\\n\\n Example 3: Pack and unpack a message in Python.\\n\\n foo = Foo(...)\\n any = Any()\\n any.Pack(foo)\\n ...\\n if any.Is(Foo.DESCRIPTOR):\\n any.Unpack(foo)\\n ...\\n\\n Example 4: Pack and unpack a message in Go\\n\\n foo := &pb.Foo{...}\\n any, err := ptypes.MarshalAny(foo)\\n ...\\n foo := &pb.Foo{}\\n if err := ptypes.UnmarshalAny(any, foo); err != nil {\\n ...\\n }\\n\\nThe pack methods provided by protobuf library will by default use\\n\'type.googleapis.com/full.type.name\' as the type URL and the unpack\\nmethods only use the fully qualified type name after the last \'/\'\\nin the type URL, for example \\"foo.bar.com/x/y.z\\" will yield type\\nname \\"y.z\\".\\n\\n\\nJSON\\n====\\nThe JSON representation of an `Any` value uses the regular\\nrepresentation of the deserialized, embedded message, with an\\nadditional field `@type` which contains the type URL. Example:\\n\\n package google.profile;\\n message Person {\\n string first_name = 1;\\n string last_name = 2;\\n }\\n\\n {\\n \\"@type\\": \\"type.googleapis.com/google.profile.Person\\",\\n \\"firstName\\": ,\\n \\"lastName\\": \\n }\\n\\nIf the embedded message type is well-known and has a custom JSON\\nrepresentation, that representation will be embedded adding a field\\n`value` which holds the custom JSON in addition to the `@type`\\nfield. Example (for message [google.protobuf.Duration][]):\\n\\n {\\n \\"@type\\": \\"type.googleapis.com/google.protobuf.Duration\\",\\n \\"value\\": \\"1.212s\\"\\n }"},"runtimeError":{"type":"object","properties":{"error":{"type":"string","description":"The error name.","example":"Runtime error."},"code":{"type":"integer","format":"int32","description":"The error code.","example":500},"message":{"type":"string","description":"The error message.","example":"Request failed due to an internal server error"},"details":{"type":"array","description":"Any details associated with the error.","items":{"$ref":"#/components/schemas/protobufAny"}}}},"v2PaginationResponse":{"type":"object","description":"The details about the pagination of the response.","properties":{"total":{"type":"integer","description":"The total number of results available.","format":"int32","example":143},"count":{"type":"integer","description":"The number of results returned.","format":"int32","example":143},"per_page":{"type":"integer","description":"The maximum number of results per page.","format":"int32","example":50},"current_page":{"type":"integer","description":"The current page index.","format":"int32","example":2},"total_pages":{"type":"integer","description":"The total number of pages available.","format":"int32","example":3},"next_url":{"type":"string","description":"The URL to fetch next page of results.","example":"https://api.boldcommerce.com/customers/v2/shops/zp3oafdor9/products?page=3"},"previous_url":{"type":"string","description":"The URL to fetch previous page of results.","example":"https://api.boldcommerce.com/customers/v2/shops/zp3oafdor9/products?page=1"}}},"shopIdentifierSchema":{"type":"string","description":"A unique identifier of the store. This can be retrieved by calling the [Get Shop Info](shops#tag/Shops/operation/GetShopInfo#) endpoint.","example":"zp3oafdor9"},"v2PlatformID":{"type":"object","properties":{"string_value":{"type":"string","description":"The unique human-readable identifier assigned by the shop platform.","example":"platform-123"},"int64_value":{"type":"integer","format":"int64","description":"The unique numeric identifier assigned by the shop platform.","example":123456}}},"v2Category":{"type":"object","properties":{"id":{"type":"integer","format":"int64","description":"The unique identifier for this category. Assigned by Bold.","example":100},"shop_identifier":{"$ref":"#/components/schemas/shopIdentifierSchema"},"platform_id":{"$ref":"#/components/schemas/v2PlatformID"},"name":{"type":"string","description":"The category name.","example":"Hats"},"created_at":{"type":"string","format":"date-time","description":"The date (in [RFC3339 format](https://datatracker.ietf.org/doc/html/rfc3339)) the category was created.","example":"2021-11-04T19:09:52Z"},"updated_at":{"type":"string","format":"date-time","description":"The date (in [RFC3339 format](https://datatracker.ietf.org/doc/html/rfc3339)) the category was updated. If the category has not been updated, the value is the same as `created_at`.","example":"2021-11-04T19:09:52Z"},"image_url":{"type":"string","description":"The URL location of the category image.","example":"example.store.com/files/categories/hats.jpg"}}},"v2CategoryListResponse":{"type":"object","properties":{"pagination":{"$ref":"#/components/schemas/v2PaginationResponse"},"data":{"type":"array","items":{"$ref":"#/components/schemas/v2Category"}}}},"v2CategoryByXIDResponse":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/v2Category"}}},"v2Product":{"type":"object","properties":{"id":{"type":"integer","format":"int64","description":"The unique identifier for this product. Assigned by Bold.","example":123},"shop_identifier":{"$ref":"#/components/schemas/shopIdentifierSchema"},"platform_id":{"$ref":"#/components/schemas/v2PlatformID"},"name":{"type":"string","description":"The name of the product.","example":"Beach hat"},"handle":{"type":"string","description":"The name of the product reflected in the URL.","example":"beach-hat"},"description":{"type":"string","description":"The product description.","example":"A hat for the beach"},"type":{"type":"string","description":"The product type.","example":"Hat"},"vendor":{"type":"string","description":"The product vendor.","example":"OFS"},"inventory_quantity":{"type":"integer","format":"int64","description":"The current inventory level of the product.","example":5},"inventory_tracking_service":{"type":"string","description":"The service that tracks inventory.","example":"platform"},"inventory_tracking_entity":{"type":"string","description":"The entity on which inventory is tracked.","enum":["variant","product","none"],"example":"product"},"tags":{"type":"string","description":"The product tags.","example":"hat, summer, beach"},"created_at":{"type":"string","format":"date-time","description":"The date (in [RFC3339 format](https://datatracker.ietf.org/doc/html/rfc3339)) the product was created.","example":"2021-11-04T19:09:52Z"},"updated_at":{"type":"string","format":"date-time","description":"The date (in [RFC3339 format](https://datatracker.ietf.org/doc/html/rfc3339)) the product was updated. If the product has not been updated, the value is the same as `created_at`.","example":"2021-11-04T19:09:52Z"},"published":{"type":"boolean","format":"boolean","description":"Indicates whether the product is published on the storefront.","example":true},"url":{"type":"string","description":"The product URL.","example":"example.store.com/files/products/hats/beach-hat.jpg"},"tax_code":{"type":"string","description":"The tax code for the variant.","example":"non-taxable"},"localized_names":{"type":"object","description":"A map of localized names for the variant. The field is the [ISO-639](https://www.iso.org/iso-639-language-codes.html) two character language code. The value is the product name in the given language.","additionalProperties":{"type":"string"},"example":{"en":"Purple","fr":"Violette"}},"localized_descriptions":{"type":"object","description":"A map of localized descriptions for the variant. The field is the [ISO-639](https://www.iso.org/iso-639-language-codes.html) two character language code. The value is the product description in the given language.","additionalProperties":{"type":"string"},"example":{"en":"A hat for the beach","fr":"Un chapeau pour la plage"}}}},"v2Image":{"type":"object","properties":{"id":{"type":"integer","format":"int64","description":"The unique identifier for this image. Assigned by Bold.","example":456},"shop_identifier":{"$ref":"#/components/schemas/shopIdentifierSchema"},"platform_id":{"$ref":"#/components/schemas/v2PlatformID"},"platform_product_id":{"$ref":"#/components/schemas/v2PlatformID"},"src":{"type":"string","description":"The image URL.","example":"https://example.com/images/beach-hat.jpg"},"position":{"description":"The position in the `images` array.","type":"integer","format":"int64","example":1},"created_at":{"type":"string","format":"date-time","description":"The date (in [RFC3339 format](https://datatracker.ietf.org/doc/html/rfc3339)) the image was created.","example":"2021-11-04T19:09:52Z"},"updated_at":{"type":"string","format":"date-time","description":"The date (in [RFC3339 format](https://datatracker.ietf.org/doc/html/rfc3339)) the image was updated. If the image has not been updated, the value is the same as `created_at`.","example":"2021-11-04T19:09:52Z"}}},"v2VariantOptionValue":{"type":"object","properties":{"id":{"type":"integer","format":"int64","description":"The unique identifier for the variant option value. Assigned by Bold.","example":5},"shop_identifier":{"$ref":"#/components/schemas/shopIdentifierSchema"},"platform_id":{"$ref":"#/components/schemas/v2PlatformID"},"platform_option_id":{"$ref":"#/components/schemas/v2PlatformID"},"platform_variant_id":{"$ref":"#/components/schemas/v2PlatformID"},"label":{"type":"string","description":"The label of the option value.","example":"Small"},"created_at":{"type":"string","format":"date-time","description":"The date (in [RFC3339 format](https://datatracker.ietf.org/doc/html/rfc3339)) the variant option value was created.","example":"2021-11-04T19:09:52Z"},"updated_at":{"type":"string","format":"date-time","description":"The date (in [RFC3339 format](https://datatracker.ietf.org/doc/html/rfc3339)) the variant option value was updated. If the variant option has not been updated, the value is the same as `created_at`.","example":"2021-11-04T19:09:52Z"}}},"v2Variant":{"type":"object","properties":{"id":{"type":"integer","format":"int64","description":"The unique identifier for this variant. Assigned by Bold.","example":789},"shop_identifier":{"$ref":"#/components/schemas/shopIdentifierSchema"},"platform_id":{"$ref":"#/components/schemas/v2PlatformID"},"platform_product_id":{"$ref":"#/components/schemas/v2PlatformID"},"name":{"type":"string","description":"The name of the variant. If there is only one variant, the `name` must be \\"Default Title\\" in order to avoid displaying the same `name` twice.","example":"Default Title"},"sku":{"type":"string","description":"The variant SKU.","example":"BEACH-HAT-PURPLE"},"weight_unit":{"type":"string","description":"The unit of measurement that applies to the variant\'s weight.","example":"kg"},"grams":{"type":"integer","format":"int64","description":"The weight of the variant in grams.","example":1000},"image_id":{"type":"integer","format":"int64","description":"The image identifier.","example":321},"image_url":{"type":"string","description":"The URL of the variant image.","example":"example.store.com/files/products/hats/purple-beach-hat.jpg"},"inventory_quantity":{"type":"integer","format":"int64","description":"The current inventory level of the product.","example":5},"allow_backorder":{"type":"boolean","format":"boolean","description":"Indicates whether backorders of the variant is allowed.","example":true},"inventory_tracking_service":{"type":"string","description":"The service that tracks inventory.","example":"platform"},"inventory_tracking_entity":{"type":"string","description":"The entity on which inventory of the variant is tracked.","enum":["variant","product","none"],"example":"product"},"created_at":{"type":"string","format":"date-time","description":"The date (in [RFC3339 format](https://datatracker.ietf.org/doc/html/rfc3339)) the variant was created.","example":"2021-11-04T19:09:52Z"},"updated_at":{"type":"string","format":"date-time","description":"The date (in [RFC3339 format](https://datatracker.ietf.org/doc/html/rfc3339)) the variant was updated. If the variant has not been updated, the value is the same as `created_at`.","example":"2021-11-04T19:09:52Z"},"require_shipping":{"type":"boolean","format":"boolean","description":"Indicates if the variant needs to be shipped.","example":true},"price":{"type":"number","format":"byte","description":"The base price of the variant with no adjustments or sales.","example":30},"cost":{"type":"number","format":"byte","description":"The price of the variant after adjustments or sales.","example":25},"compare_at_price":{"type":"number","format":"byte","description":"The original price of the variant before an adjustment or a sale.","example":30},"tax_code":{"type":"string","description":"The tax code for the variant.","example":"non-taxable"},"weight":{"type":"number","format":"byte","description":"The weight of the variant, calculated with `weight_unit` specified.","example":1},"tax_exempt":{"type":"boolean","format":"boolean","description":"Indicates whether the variant is tax-exempt.","example":true},"option_values":{"type":"array","description":"The list of option values associated with the variant.","items":{"$ref":"#/components/schemas/v2VariantOptionValue"}},"localized_names":{"type":"object","description":"A map of localized names for the variant. The field is the [ISO-639](https://www.iso.org/iso-639-language-codes.html) two character language code. The value is the product name in the given language.","additionalProperties":{"type":"string"},"example":{"en":"Purple","fr":"Violette"}}}},"v2OptionValue":{"type":"object","properties":{"shop_identifier":{"$ref":"#/components/schemas/shopIdentifierSchema"},"label":{"type":"string","description":"The label of the option value.","example":"Small"},"is_default":{"type":"boolean","format":"boolean","description":"Indicates whether this is the default option value.","example":true},"id":{"type":"integer","format":"int64","description":"The unique identifier for this option value. Assigned by Bold.","example":143},"position":{"type":"integer","format":"int64","description":"The position in the `option_values` array.","example":1},"created_at":{"type":"string","format":"date-time","description":"The date (in [RFC3339 format](https://datatracker.ietf.org/doc/html/rfc3339)) the option value was created.","example":"2021-11-04T19:09:52Z"},"updated_at":{"type":"string","format":"date-time","description":"The date (in [RFC3339 format](https://datatracker.ietf.org/doc/html/rfc3339)) the option value was updated. If the option value has not been updated, the value is the same as `created_at`.","example":"2021-11-04T19:09:52Z"},"platform_id":{"$ref":"#/components/schemas/v2PlatformID"},"platform_product_option_id":{"$ref":"#/components/schemas/v2PlatformID"}}},"v2Option":{"type":"object","properties":{"id":{"type":"integer","format":"int64","description":"The unique identifier for this option. Assigned by Bold.","example":900},"shop_identifier":{"$ref":"#/components/schemas/shopIdentifierSchema"},"platform_id":{"$ref":"#/components/schemas/v2PlatformID"},"platform_option_id":{"$ref":"#/components/schemas/v2PlatformID"},"platform_product_id":{"$ref":"#/components/schemas/v2PlatformID"},"name":{"type":"string","description":"The option name.","example":"Small"},"position":{"type":"integer","format":"int64","description":"The position in the `options` array.","example":1},"created_at":{"type":"string","format":"date-time","description":"The date (in [RFC3339 format](https://datatracker.ietf.org/doc/html/rfc3339)) the option was created.","example":"2021-11-04T19:09:52Z"},"updated_at":{"type":"string","format":"date-time","description":"The date (in [RFC3339 format](https://datatracker.ietf.org/doc/html/rfc3339)) the option was updated. If the option has not been updated, the value is the same as `created_at`.","example":"2021-11-04T19:09:52Z"},"values":{"type":"array","items":{"$ref":"#/components/schemas/v2OptionValue"}}}},"v2DeepProduct":{"type":"object","properties":{"product":{"$ref":"#/components/schemas/v2Product"},"images":{"description":"The images associated with the product.\\n\\nIncluded in the response when the query parameter `deep` is set to `true`.","type":"array","items":{"$ref":"#/components/schemas/v2Image"}},"variants":{"description":"The variants associated with the product.\\n\\nIncluded in the response when the query parameter `deep` is set to `true`.","type":"array","items":{"$ref":"#/components/schemas/v2Variant"}},"options":{"description":"The options associated with the product.\\n\\nIncluded in the response when the query parameter `deep` is set to `true`.","type":"array","items":{"$ref":"#/components/schemas/v2Option"}},"categories":{"description":"The categories associated with the product.\\n\\nIncluded in the response when the query parameter `deep` is set to `true`.","type":"array","items":{"$ref":"#/components/schemas/v2Category"}}}},"v2ProductListResponse":{"type":"object","properties":{"pagination":{"$ref":"#/components/schemas/v2PaginationResponse"},"data":{"type":"array","items":{"$ref":"#/components/schemas/v2DeepProduct"}}}},"v2ProductCategory":{"type":"object","properties":{"id":{"type":"integer","format":"int64","description":"The unique identifier for this product category. Assigned by Bold.","example":10},"shop_identifier":{"$ref":"#/components/schemas/shopIdentifierSchema"},"platform_category_id":{"$ref":"#/components/schemas/v2PlatformID"},"platform_product_id":{"$ref":"#/components/schemas/v2PlatformID"},"created_at":{"type":"string","format":"date-time","description":"The date (in [RFC3339 format](https://datatracker.ietf.org/doc/html/rfc3339)) the product category was created.","example":"2021-11-04T19:09:52Z"},"updated_at":{"type":"string","format":"date-time","description":"The date (in [RFC3339 format](https://datatracker.ietf.org/doc/html/rfc3339)) the product category was updated. If the product category has not been updated, the value is the same as `created_at`.","example":"2021-11-04T19:09:52Z"}}},"v2ProductCategoryListResponse":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/v2ProductCategory"}},"pagination":{"$ref":"#/components/schemas/v2PaginationResponse"}}},"v2ProductByXIDResponse":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/v2DeepProduct"}}},"v2ImageListResponse":{"type":"object","properties":{"pagination":{"$ref":"#/components/schemas/v2PaginationResponse"},"data":{"type":"array","items":{"$ref":"#/components/schemas/v2Image"}}}},"v2ImageByXIDResponse":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/v2Image"}}},"v2OptionListResponse":{"type":"object","properties":{"pagination":{"$ref":"#/components/schemas/v2PaginationResponse"},"data":{"type":"array","items":{"$ref":"#/components/schemas/v2Option"}}}},"v2OptionByXIDResponse":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/v2Option"}}},"v2VariantListResponse":{"type":"object","properties":{"pagination":{"$ref":"#/components/schemas/v2PaginationResponse"},"data":{"type":"array","items":{"$ref":"#/components/schemas/v2Variant"}}}},"v2VariantByXIDResponse":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/v2Variant"}}},"v2ProductTypeListResponse":{"type":"object","properties":{"type":{"type":"string","description":"The product type.","example":"Hat"},"data":{"type":"array","items":{"type":"string"}}}},"v2AllVariantsListResponse":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/v2Variant"}},"pagination":{"$ref":"#/components/schemas/v2PaginationResponse"}}},"v2VendorListResponse":{"type":"object","properties":{"type":{"type":"string"},"data":{"type":"array","items":{"type":"string"}}}}}}}},"plugin-redoc-8":{"url":"/api/shops.openapi.yaml","themeId":"theme-redoc","isSpecFile":true,"spec":{"openapi":"3.0.0","info":{"title":"Shops","version":"2.0.0","description":"This API allows you to get information about your shop.\\n\\nRefer to the changelog for the latest updates to this API.","termsOfService":"https://boldcommerce.com/terms-of-service","contact":{"name":"Contact Us","url":"https://developer-dashboard.boldcommerce.com/default/contactus"}},"servers":[{"url":"https://api.boldcommerce.com"}],"security":[{"OAuthToken":["read_shops"]},{"APIAccessToken":[]}],"tags":[{"name":"Integrations","description":"Manages integrations for a given shop."},{"name":"Shops","description":"Contains information about a shop. Use these endpoints to retrieve information about a given shop."}],"paths":{"/integrations/v1/shops/{shop_identifier}/installs/{client_id}":{"parameters":[{"$ref":"#/components/parameters/shopIdentifier"},{"$ref":"#/components/parameters/clientId"}],"delete":{"tags":["Integrations"],"summary":"Uninstall Integration","operationId":"UninstallIntegration","description":"Uninstalls a public integration for a specific shop by the issued `client_id`. For the `client_id`, use your public integration\'s Client ID value, which can be found in the [Developer Dashboard](https://developer-dashboard.boldcommerce.com/default/dashboard). The access token used to authenticate this request must belong to the public integration matching the given `client_id`. For more information, refer to [Build Public Integrations](/guides/checkout/public-integrations#exchange-code-for-an-api-access-token).","security":[{}],"responses":{"200":{"description":"A successful response.","content":{"application/json":{"schema":{"type":"object"}}}},"403":{"description":"The supplied credentials are not allowed to uninstall this integration on this shop, possibly because they were not used for the correlated install.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"examples":{"uninstallForbidden":{"$ref":"#/components/examples/uninstallForbidden"}}}}},"404":{"description":"The integration install specified by `client_id` was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"examples":{"installationNotFound":{"$ref":"#/components/examples/installationNotFound"}}}}},"500":{"description":"An unexpected error occurred.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DefaultError"},"examples":{"internalError":{"$ref":"#/components/examples/internalError"}}}}}}}},"/shops/v1/info":{"get":{"summary":"Get Shop Info","operationId":"GetShopInfo","tags":["Shops"],"description":"Gets information about the current shop.","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ShopInfo"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"examples":{"Missing Access Token":{"value":{"error":"invalid_request","error_description":"The access token is missing"}},"Invalid Or Expired Access Token":{"value":{"error":"invalid_token","error_description":"The access token is invalid or has expired"}}}}}},"404":{"description":"Shop Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DefaultError"},"example":{"status_code":404,"errors":["not found"]}}}},"500":{"description":"Internal Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DefaultError"},"example":{"status_code":500,"errors":["internal error"]}}}}}}}},"components":{"securitySchemes":{"OAuthToken":{"type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"https://apps.boldapps.net/accounts/dashboard/authorize","tokenUrl":"https://api.boldcommerce.com/auth/oauth2/token","scopes":{"read_shops":"Read shop information."}}},"description":"Authenticates an API request from a [public integration](/guides/checkout/resources/glossary#public-integration). Generate this token in the [Developer Dashboard](https://developer-dashboard.boldcommerce.com/default/dashboard). Refer to [Build Public Integrations](/guides/checkout/public-integrations) for more information."},"APIAccessToken":{"type":"apiKey","name":"API Access Token","in":"header","description":"Authenticates an API request from a [private integration](/guides/checkout/resources/glossary#private-integration). Generate this token in the [Bold Account Center](https://account.boldcommerce.com/). Refer to [Making API Calls](/guides/checkout/quick-start) for more information."}},"schemas":{"ShopInfo":{"type":"object","properties":{"id":{"type":"integer","format":"int64","description":"Bold\'s internal-only shop identifier.","example":3654},"shop_identifier":{"type":"string","description":"The platform-specific shop identifier. Use this value in all API calls to identify your store.","example":"zp3oafdor9"},"organization_id":{"type":"integer","description":"The shop organization ID. If `organization_id` is `0`, the shop is not connected to a Bold Account Center organization.","example":142},"shop_domain":{"type":"string","description":"The shop domain.","example":"store-zp3oafdor9.mybigcommerce.com"},"custom_domain":{"type":"string","description":"The shop\'s custom domain.","example":"example.bigcommerce.com"},"platform_slug":{"type":"string","description":"The platform name. Possible values are \\"bigcommerce\\", \\"commercetools\\", \\"shopify\\", \\"woocommerce\\", and \\"custom\\".","example":"bigcommerce"},"shop_owner":{"type":"string","description":"The shop owner, taken from the shop platform.","example":"John Doe"},"store_name":{"type":"string","description":"The shop name, taken from the shop platform.","example":"acme-inc"},"admin_email":{"type":"string","description":"The email for the shop administrator, used when creating the shop.","example":"admin@example.com"},"order_email":{"type":"string","description":"The email used to send orders. Only used for BigCommerce.","example":"orders@example.com"},"currency":{"type":"string","description":"The shop\'s selected currency, using [ISO-4217](https://www.iso.org/iso-4217-currency-codes.html) standards.","example":"CAD"},"currency_symbol":{"type":"string","description":"The symbol of the shop currency.","example":"$"},"money_format":{"type":"string","description":"The format for displaying currency.","example":"${{amount}}"},"address":{"type":"string","description":"The shop\'s street address.","example":"50 Fultz Blvd"},"address_2":{"type":"string","description":"Any additional street address details (apt #, suite #, etc) for the shop.","example":"Suite 200"},"city":{"type":"string","description":"The name of the shop\'s city.","example":"Winnipeg"},"province":{"type":"string","description":"The name of the shop\'s province.","example":"Manitoba"},"country":{"type":"string","description":"The name of the shop\'s country.","example":"Canada"},"country_code":{"type":"string","description":"The shop\'s country code, using [ISO-3166](https://www.iso.org/iso-3166-country-codes.html) format.","example":"CA"},"postal_code":{"type":"string","description":"The shop\'s postal/zip code. Required for most countries, including the United States, Canada, and Mexico.","example":"R3Y0L6"},"timezone":{"type":"string","description":"The shop timezone.","example":"America/New_York"},"phone":{"type":"string","description":"The phone number of the shop.","example":"8005550101"},"locale":{"type":"string","description":"The shop locale, in [ISO-639-1 format](https://www.iso.org/standard/22109.html).","example":"en"},"plan_name":{"type":"string","description":"The name of the shop\'s service plan. For more information on how Bold uses a shop\'s service plan, see the [rate limiting reference page](/guides/checkout/resources/rate-limiting#rate-limits-by-platform).","example":"Sandbox_Store"},"plan_level":{"type":"string","description":"The name of the shop\'s platform partner level. Possible values depend on the shop platform.","example":"affiliate"},"platform_status":{"type":"string","description":"The shop\'s platform status.","example":"active"},"is_price_entered_with_tax":{"type":"boolean","description":"If the price for a cart at checkout is entered with tax included.","example":false},"weight_unit":{"type":"string","description":"The abbreviated unit of measurement for weight of a shop product (e.g. \\"g\\", \\"lb\\", \\"oz\\".) If the shop does not sell physical items, the `weight_unit` is an empty string (`\\"\\"`).","example":""},"created_at":{"type":"string","format":"datetime","description":"The date and time the shop was created, in [RFC 3339, section 5.6 format](https://datatracker.ietf.org/doc/html/rfc3339#section-5.6).","example":"2023-03-01T03:00:48Z"},"updated_at":{"type":"string","format":"datetime","description":"The date and time the shop was updated, in [RFC 3339, section 5.6 format](https://datatracker.ietf.org/doc/html/rfc3339#section-5.6).","example":"2023-03-30T03:00:48Z"},"platform_updated_at":{"type":"string","format":"datetime","description":"The date and time the platform was updated, in [RFC 3339, section 5.6 format](https://datatracker.ietf.org/doc/html/rfc3339#section-5.6).","example":"2022-07-26T15:35:22Z"},"redacted_at":{"type":"string","format":"datetime","nullable":true,"description":"The date and time the shop was redacted, in [RFC 3339, section 5.6 format](https://datatracker.ietf.org/doc/html/rfc3339#section-5.6). This value is `null` if the store is not redacted.","example":null},"sync_status":{"type":"string","description":"The sync status between the shop and Bold."},"setup_required":{"type":"boolean","description":"Indicates whether the shop requires setup.","example":false},"password_enabled":{"type":"boolean","description":"Indicates whether the shop requires a password for customers to access.","example":false},"pre_launch_enabled":{"type":"boolean","description":"Indicates whether pre-launch is enabled for the shop. Shopify only. See more information on the [Shopify pre-launch reference page](https://www.shopify.com/ca/blog/coming-soon-page).","example":false},"has_storefront":{"type":"boolean","description":"If the shop has a physical storefront.","example":true},"base_url":{"type":"string","nullable":true,"description":"The base URL for the shop. `base_url` is `null` if the shop does not have a custom accessible base URL.","example":null},"api_base_url":{"type":"string","nullable":true,"description":"The base API URL for the shop. `api_base_url` is `null` if the shop does not have an accessible API URL.","example":null},"auth_base_url":{"type":"string","nullable":true,"description":"The base authorization URL for the shop. `auth_base_url` is `null` if the shop does not have an accessible base authorization URL.","example":null},"tax_rounding_mode":{"type":"string","nullable":true,"description":"The tax rounding mode for the shop. `tax_rounding_mode` is `null` if no tax rounding mode is set.","example":null},"inventory_control":{"type":"string","nullable":true,"description":"The inventory control method for the shop. `inventory_control` is `null` if no inventory control method is set.","example":null},"currency_precision":{"type":"string","nullable":true,"description":"The currency precision setting for the shop. `currency_precision` is `null` if no currency precision value is set.","example":null},"shop_enabled":{"type":"boolean","description":"Indicates whether the shop is currently receiving traffic. Supported by BigCommerce and Shopify.","example":true},"has_ac_shop_platform_creds":{"type":"boolean","description":"Indicates whether the shop has shop platform credentials in Bold Account Center.","example":true}}},"Error":{"type":"object","properties":{"error":{"type":"string","description":"The error name.","example":"invalid_token"},"error_description":{"type":"string","description":"The error description.","example":"The access token is invalid or has expired"}}},"DefaultError":{"type":"object","properties":{"status_code":{"type":"integer","description":"The status code for the error.","example":404},"errors":{"type":"array","description":"Any messages associated with the error.","items":{"type":"string"},"example":["not found"]}}}},"parameters":{"shopIdentifier":{"name":"shop_identifier","in":"path","description":"Unique identifier of the store. Retrieve this information by calling the [Get Shop Info](shops#tag/Shop/operation/GetShopInfo) endpoint.","required":true,"schema":{"type":"string"},"example":"abc123def456"},"clientId":{"name":"client_id","in":"path","description":"Unique identifier of an integration installed on a store. Available in the response during the initial installation of an integration.","required":true,"schema":{"type":"string"},"example":"SEY7wXUZZHq57gjeKs4DmnHyeMsSO2AF"}},"examples":{"installationNotFound":{"value":{"status_code":404,"errors":["Integration installation not found."]}},"uninstallForbidden":{"value":{"status_code":403,"errors":["Failed to uninstall integration due to insufficient privileges"]}},"internalError":{"value":{"status_code":500,"errors":["Request failed due to an internal server error"]}}}}}},"plugin-redoc-9":{"url":"/api/subscriptions.openapi.yaml","themeId":"theme-redoc","isSpecFile":true,"spec":{"openapi":"3.0.0","info":{"title":"Bold Subscriptions","version":"1.0","description":"Bold Subscriptions customers use our API to interact with subscription data in unique ways. This includes the ability to modify, cancel, and report on subscriptions.\\n\\nRefer to the changelog for the latest updates to this API.","termsOfService":"https://boldcommerce.com/terms-of-service","contact":{"name":"Contact Us","url":"https://developer-dashboard.boldcommerce.com/default/contactus"}},"servers":[{"url":"https://api.boldcommerce.com"}],"security":[{"OAuthToken":[]},{"APIAccessToken":[]}],"tags":[{"name":"Subscriptions","description":"Contains information about subscriptions for your store and data associated with them. Use these endpoints to get, remove, edit, or list subscriptions."},{"name":"Subscription Groups","description":"Contains information about subscription groups for your store, including shop ID and subscription group configuration. Use these endpoints to add, remove, edit, or list subscription groups."},{"name":"Subscription Line Items","description":"A child resource of Subscriptions. Contains information about line items in a subscription, including price, details, and swappable products. Use these endpoints to get, remove, edit, or list line items for subscriptions."},{"name":"Subscription Orders","description":"A child resource of Subscriptions. Contains information about orders in a subscription, including schedules, order histories, and current orders. Use these endpoints to list, get, skip, or unskip orders."},{"name":"Subscription Adjustments","description":"A child resource of Subscriptions. Contains information about future adjustments to a subscription or its orders. Use these endpoints to create, list, or delete adjustments for a subscription."},{"name":"Future Orders","description":"Contains information about future orders for subscriptions. Use these endpoints to list future orders for a shop or individual subscriptions."},{"name":"Convertible Adjustments","description":"Use these endpoints to create, update, or delete convertible adjustment plans, enabling automatic product conversions on subscription line items attached to a created plan."},{"name":"Customers","description":"A child resource of Subscriptions. Contains information about customers for a subscription. Use these endpoints to manage customer data for a specific subscription."},{"name":"Payment Methods","description":"A child resource of Subscriptions. Contains information about payment methods for subscriptions, including public payment IDs, alternate payment methods, and available methods. Use these endpoints to get, remove, edit, and list payment methods associated with a subscription."},{"name":"Shops","description":"Contains information about your store, including store IDs, domains, platform, and admin configuration. Use these endpoints to manage store information and settings."},{"name":"Webhook Events","description":"Contains information about webhook events, including webhook event ID, attempts, and webhook event metadata. Use these endpoints to get webhook event information."},{"name":"Webhook Subscriptions","description":"Contains webhook metadata. Use these endpoints to add, remove, edit, or list webhook subscriptions."},{"name":"Webhook Topics","description":"Contains information about webhook topics. Use these endpoints to list all possible webhook topics."}],"externalDocs":{"description":"For more information about Subscriptions, refer to the Overview.","url":"https://developer.boldcommerce.com/guides/subscriptions-v2"},"paths":{"/subscriptions/v1/shops/{shop_identifier}/customers":{"parameters":[{"$ref":"#/components/parameters/shop_identifier_path_param"}],"get":{"tags":["Customers"],"summary":"List Customers","operationId":"ListCustomers","description":"Retrieve a list of customers.","responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Customers"}}}},"401":{"description":"Unauthenticated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnauthenticatedResponse"}}}}},"parameters":[{"$ref":"#/components/parameters/customerSearch"},{"$ref":"#/components/parameters/customerStatus"},{"$ref":"#/components/parameters/limit"},{"$ref":"#/components/parameters/page"}]}},"/subscriptions/v1/shops/{shop_identifier}/customers/{customer_id}":{"parameters":[{"$ref":"#/components/parameters/shop_identifier_path_param"},{"$ref":"#/components/parameters/customer_id_path_param"}],"get":{"tags":["Customers"],"summary":"Get Customer","operationId":"GetCustomer","description":"Retrieve a customer by their id.","parameters":[{"$ref":"#/components/parameters/shop_identifier_path_param"},{"$ref":"#/components/parameters/customer_id_path_param"}],"responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Customer"}}}},"401":{"description":"Unauthenticated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnauthenticatedResponse"}}}}}},"put":{"tags":["Customers"],"summary":"Update Customer","operationId":"UpdateCustomer","description":"Update a customer by their id.","parameters":[{"$ref":"#/components/parameters/shop_identifier_path_param"},{"$ref":"#/components/parameters/customer_id_path_param"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Customer"}}}},"responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Customer"}}}},"401":{"description":"Unauthenticated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnauthenticatedResponse"}}}}}}},"/subscriptions/v1/shops/{shop_identifier}/customers/{customer_id}/addresses":{"parameters":[{"$ref":"#/components/parameters/shop_identifier_path_param"},{"$ref":"#/components/parameters/customer_id_path_param"}],"get":{"tags":["Customers"],"summary":"List Customer Addresses","operationId":"ListCustomerAddresses","description":"Retrieve a list of addresses for a customer.","parameters":[{"$ref":"#/components/parameters/shop_identifier_path_param"},{"$ref":"#/components/parameters/customer_id_path_param"}],"responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"type":"object","properties":{"customer_addresses":{"type":"array","items":{"$ref":"#/components/schemas/CustomerAddressEntity"}}}}}}},"401":{"description":"Unauthenticated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnauthenticatedResponse"}}}}}},"post":{"tags":["Customers"],"summary":"Create Customer Address","operationId":"CreateCustomerAddress","description":"Create an address for a customer.","parameters":[{"$ref":"#/components/parameters/shop_identifier_path_param"},{"$ref":"#/components/parameters/customer_id_path_param"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"customer_address":{"$ref":"#/components/schemas/UpdateCustomerAddressEntity"}}}}}},"responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"type":"object","properties":{"customer_address":{"$ref":"#/components/schemas/CustomerAddressEntity"}}}}}},"401":{"description":"Unauthenticated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnauthenticatedResponse"}}}}}}},"/subscriptions/v1/shops/{shop_identifier}/customers/{customer_id}/addresses/{address_id}":{"parameters":[{"$ref":"#/components/parameters/shop_identifier_path_param"},{"$ref":"#/components/parameters/customer_id_path_param"},{"$ref":"#/components/parameters/address_id_path_param"}],"put":{"tags":["Customers"],"summary":"Update Customer Address","operationId":"UpdateCustomerAddress","description":"Update an address for a customer.","parameters":[{"$ref":"#/components/parameters/shop_identifier_path_param"},{"$ref":"#/components/parameters/customer_id_path_param"},{"$ref":"#/components/parameters/address_id_path_param"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"customer_address":{"$ref":"#/components/schemas/UpdateCustomerAddressEntity"}}}}}},"responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"type":"object","properties":{"customer_address":{"$ref":"#/components/schemas/CustomerAddressEntity"}}}}}},"401":{"description":"Unauthenticated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnauthenticatedResponse"}}}}}},"delete":{"tags":["Customers"],"summary":"Delete Customer Address","operationId":"DeleteCustomerAddress","description":"Delete an address from a customer.","parameters":[{"$ref":"#/components/parameters/shop_identifier_path_param"},{"$ref":"#/components/parameters/customer_id_path_param"},{"$ref":"#/components/parameters/address_id_path_param"}],"responses":{"200":{"description":"Successful operation"},"401":{"description":"Unauthenticated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnauthenticatedResponse"}}}}}}},"/subscriptions/v1/shops/{shop_identifier}/shop":{"get":{"tags":["Shops"],"summary":"Get Shop Info","description":"Retrieve basic information about a shop.","operationId":"GetShopInfo","responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Shop"}}}},"401":{"description":"Unauthenticated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnauthenticatedResponse"}}}}}},"parameters":[{"$ref":"#/components/parameters/shop_identifier_path_param"}]},"/subscriptions/v1/shops/{shop_identifier}/subscriptions":{"get":{"tags":["Subscriptions"],"summary":"List Subscriptions","operationId":"ListSubscriptions","description":"Retrieve a list of subscriptions.","responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListSubscriptions"}}}},"401":{"description":"Unauthenticated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnauthenticatedResponse"}}}}},"parameters":[{"$ref":"#/components/parameters/shop_identifier_path_param"},{"schema":{"enum":["active","inactive","processing","scheduled","paused"],"example":"active"},"in":"query","name":"subscription_status","description":"Status of the subscriptions returned. Multiple statuses can be passed as an array."},{"schema":{"example":"1"},"in":"query","name":"bold_platform_customer_id","description":"Customer Id of the subscriptions returned. Multiple customer ids can be passed as an array."},{"schema":{"type":"string","example":"customer","enum":["customer"]},"in":"query","name":"expand","description":"Fields to expand on the subscription. Multiple fields can be passed as an array"},{"schema":{"type":"integer","example":5},"in":"query","name":"limit","description":"Maximum number of results to be returned"},{"schema":{"type":"string","example":"?filter=lt(next_order_datetime:2021-11-15T00:00:00Z)+gt(next_order_datetime:2021-10-31T00:00:00Z)"},"in":"query","name":"filter","description":"Accepts filtering options as described on the [Query & Pagination page](/guides/subscriptions-v2/resources/query-pagination). For example, to filter the next order date by a date interval, you could use the following parameter: "},{"schema":{"type":"string","example":"?cursor= P3NpbmNlX2lkPTE1Mjc0Jm9yZGVyX2J5PWlkJm9yZGVyX2RpcmVjdGlvbj1kZXNj"},"in":"query","name":"cursor","description":"Returns the next page of results if supplied the `next` value from the previous pagination results."}]},"post":{"tags":["Subscriptions"],"summary":"Create Subscription","operationId":"CreateSubscription","description":"For more information about this endpoint, refer to [Create Subscriptions](/guides/subscriptions-v2/create-subscription).","parameters":[{"$ref":"#/components/parameters/shop_identifier_path_param"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateSubscriptionEntity"}}}},"responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Subscription"}}}},"401":{"description":"Unauthenticated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnauthenticatedResponse"}}}},"422":{"description":"Unprocessable Entity","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateSubscriptionError422"}}}}}}},"/subscriptions/v1/shops/{shop_identifier}/customers/{customer_id}/subscriptions":{"get":{"tags":["Customers"],"summary":"List Customer Subscriptions","operationId":"ListCustomerSubscriptions","description":"Retrieve a list of subscriptions for a single customer.","parameters":[{"$ref":"#/components/parameters/shop_identifier_path_param"},{"$ref":"#/components/parameters/customer_id_path_param"}],"responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Subscriptions"}}}},"401":{"description":"Unauthenticated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnauthenticatedResponse"}}}}}}},"/subscriptions/v1/shops/{shop_identifier}/subscriptions/{subscription_id}/discount_code":{"put":{"tags":["Subscriptions"],"summary":"Update Discount Code","operationId":"UpdateDiscountCode","description":"Update the discount code applied to a subscription.","parameters":[{"$ref":"#/components/parameters/shop_identifier_path_param"},{"$ref":"#/components/parameters/subscription_id_path_param"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"discount_code":{"type":"string","example":"HOLIDAY10"}},"required":["discount_code"]}}}},"responses":{"200":{"description":"Successful operation"},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"oneOf":[{"type":"object","properties":{"errors":{"type":"array","items":{"type":"string"}}},"example":{"errors":["subscription not found"]}},{"type":"object","properties":{"errors":{"type":"array","items":{"type":"string"}}},"example":{"errors":["Discount code \\"HOLIDAY10\\" rejected with reason: EXPIRED"]}}]}}}}}},"delete":{"tags":["Subscriptions"],"summary":"Remove Discount Code","operationId":"RemoveDiscountCode","description":"Remove the discount code from a subscription.","parameters":[{"$ref":"#/components/parameters/shop_identifier_path_param"},{"$ref":"#/components/parameters/subscription_id_path_param"}],"responses":{"200":{"description":"Successful operation"},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"string"}}},"example":{"errors":["subscription not found"]}}}}}}}},"/subscriptions/v1/shops/{shop_identifier}/subscriptions/{subscription_id}":{"get":{"tags":["Subscriptions"],"summary":"Get Subscription","operationId":"GetSubscription","description":"Retrieve a subscription by its id.","parameters":[{"$ref":"#/components/parameters/shop_identifier_path_param"},{"$ref":"#/components/parameters/subscription_id_path_param"}],"responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Subscription"}}}},"401":{"description":"Unauthenticated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnauthenticatedResponse"}}}}}},"put":{"tags":["Subscriptions"],"summary":"Update Subscription","operationId":"UpdateSubscription","description":"Update a subscription by its id.","parameters":[{"$ref":"#/components/parameters/shop_identifier_path_param"},{"$ref":"#/components/parameters/subscription_id_path_param"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Subscription"}}}},"responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Subscription"}}}},"401":{"description":"Unauthenticated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnauthenticatedResponse"}}}}}},"patch":{"tags":["Subscriptions"],"summary":"Partial Update Subscription","operationId":"PartialUpdateSubscription","description":"Partially update a subscription by its id.","parameters":[{"$ref":"#/components/parameters/shop_identifier_path_param"},{"$ref":"#/components/parameters/subscription_id_path_param"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartialUpdateSubscription"}}}},"responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Subscription"}}}},"401":{"description":"Unauthenticated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnauthenticatedResponse"}}}}}}},"/subscriptions/v1/shops/{shop_identifier}/subscriptions/{subscription_id}/intervals":{"get":{"tags":["Subscriptions"],"summary":"List Subscription Intervals","operationId":"ListSubscriptionIntervals","description":"Retrieve a list of available intervals for a subscription.","parameters":[{"$ref":"#/components/parameters/shop_identifier_path_param"},{"$ref":"#/components/parameters/subscription_id_path_param"}],"responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Intervals"}}}},"401":{"description":"Unauthenticated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnauthenticatedResponse"}}}}}}},"/subscriptions/v1/shops/{shop_identifier}/subscriptions/{subscription_id}/interval/{subscription_interval_id}":{"put":{"tags":["Subscriptions"],"summary":"Update Subscription Interval","operationId":"UpdateSubscriptionInterval","description":"Update the interval of a subscription.","parameters":[{"$ref":"#/components/parameters/shop_identifier_path_param"},{"$ref":"#/components/parameters/subscription_interval_id_path_param"},{"$ref":"#/components/parameters/subscription_id_path_param"}],"responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Subscription"}}}},"401":{"description":"Unauthenticated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnauthenticatedResponse"}}}}}}},"/subscriptions/v1/shops/{shop_identifier}/subscriptions/{subscription_id}/products_swap":{"put":{"tags":["Subscription Line Items"],"summary":"Swap Line Items","operationId":"SwapLineItems","description":"Swap line item products on a subscription.","parameters":[{"$ref":"#/components/parameters/shop_identifier_path_param"},{"$ref":"#/components/parameters/subscription_id_path_param"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SwapProduct"}}}},"responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Subscription"}}}},"401":{"description":"Unauthenticated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnauthenticatedResponse"}}}}}}},"/subscriptions/v1/shops/{shop_identifier}/subscriptions/{subscription_id}/adjustments":{"parameters":[{"$ref":"#/components/parameters/shop_identifier_path_param"},{"$ref":"#/components/parameters/subscription_id_path_param"}],"post":{"summary":"Create Subscription Adjustments","operationId":"CreateSubscriptionAdjustments","tags":["Subscription Adjustments"],"description":"Creates adjustments for a subscription or its orders.\\n\\nFor more information on subscription adjustments, refer to the [Adjust Subscription Orders](/guides/subscriptions-v2/adjust-subscription-orders) guide.","responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SubscriptionAdjustments"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"object","properties":{"message":{"type":"string","description":"The detailed error message.","enum":["only one of fields count, function, and relative count can be provided","invalid adjustment.action.type"]}}}}},"example":{"errors":{"message":"only one of fields count, function, and relative count can be provided"}}}}},"422":{"description":"Unprocessable entity","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","description":"The error summary.","example":"The given data was invalid."},"errors":{"type":"object","additionalProperties":{"type":"array","minItems":1,"items":{"type":"string","description":"The detailed error message.","example":"The adjustments.0.target field is required."}}}}},"example":{"message":"The given data was invalid.","errors":{"adjustments.0.target":["The adjustments.0.target field is required."]}}}}}},"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SubscriptionAdjustments"},"examples":{"Trigger: One-time order adjustment by order count":{"value":{"adjustments":[{"name":"Foundation Brush Cross-Sell","description":"Loving our beauty box? Up your game with the versatile, made-in-house Foundation Brush!","target":"order","trigger":{"type":"order_count","count":3},"action":{"type":"add_line_item","platform_variant_id":"17169270472755","platform_product_id":"1841889509427","quantity":1,"price":1500}}]}},"Trigger: One-time order adjustment by relative order count":{"value":{"adjustments":[{"name":"Dessert Upsell","description":"There\'s always room for dessert! Indulge in this dessert add-on with your next order.","target":"order","trigger":{"type":"order_count","relative_count":1},"action":{"type":"add_line_item","platform_variant_id":"17169270472755","platform_product_id":"1841889509427","quantity":1,"price":700}}]}},"Trigger: Recurring order adjustment by function on order count":{"value":{"adjustments":[{"name":"Loyalty Gift","description":"Enjoy a complementary gift every 5th order for being a loyal customer!","target":"order","trigger":{"type":"order_count","function":{"step_size":5,"offset":0}},"action":{"type":"add_line_item","platform_variant_id":"17169270472755","platform_product_id":"1841889509427","quantity":1,"price":0}}]}},"Trigger: One-time order adjustment by order datetime":{"value":{"adjustments":[{"name":"10th Anniversary Give-Away!","description":"Celebrate 10 years of cleaning the oceans! Spread our message in style with this free t-shirt!","target":"order","trigger":{"type":"order_datetime","datetime":"2024-02-15T06:00:00Z"},"action":{"type":"add_line_item","platform_variant_id":"17169270472755","platform_product_id":"1841889509427","quantity":1,"price":0}}]}},"Trigger: Subscription adjustment by order count":{"value":{"adjustments":[{"name":"Samples Up! (Trial End)","description":"Coffee samples hit the spot!? Time to start receiving the real deal!","target":"subscription","trigger":{"type":"order_count","count":2},"action":{"type":"add_line_item","platform_variant_id":"17169270472755","platform_product_id":"1841889509427","quantity":1,"price":1500}}]}},"Trigger: Subscription adjustment by relative order count":{"value":{"adjustments":[{"name":"Gryffindor Upsell","description":"Are you Slytherin? Are you Gryffindor? Start receiving a second box on your next order and find out!","target":"subscription","trigger":{"type":"order_count","relative_count":1},"action":{"type":"add_line_item","platform_variant_id":"17169270472755","platform_product_id":"1841889509427","quantity":1,"price":700}}]}},"Trigger: Subscription adjustment by order datetime":{"value":{"adjustments":[{"name":"More Family. More Fun!","description":"Expecting? Add a newborn to your baby supply plan in advance!","target":"subscription","trigger":{"type":"order_datetime","datetime":"2024-01-20T06:00:00Z"},"action":{"type":"add_line_item","platform_variant_id":"17169270472755","platform_product_id":"1841889509427","quantity":1,"price":3500}}]}},"Action: Add Product":{"description":"Adds a product to a subscription or its orders.\\n\\n**Supported targets**\\n\\n* `subscription`\\n* `order`","value":{"adjustments":[{"name":"Foundation Brush Cross-Sell","description":"Loving our beauty box? Up your game with the versatile, made-in-house Foundation Brush!","target":"order","trigger":{"type":"order_count","count":3},"action":{"type":"add_line_item","platform_variant_id":"17169270472755","platform_product_id":"1841889509427","quantity":1,"price":1500}}]}},"Action: Update Line Item Quantity":{"description":"Updates the quantity of line item to a subscription or its orders.\\n\\n**Supported targets**\\n\\n* `subscription`\\n* `order`","value":{"adjustments":[{"name":"Coffee Bean Upsell","description":"Coffee is temporary but mornings are forever. Prepare for the future and add another bag of coffee to your order!","target":"order","trigger":{"type":"order_count","count":3},"action":{"type":"update_line_item_quantity","subscription_line_item_id":35236,"quantity":3}}]}}}}}}},"get":{"parameters":[{"$ref":"#/components/parameters/filter_subscription_adjustments_query_param"}],"summary":"List Subscription Adjustments","operationId":"ListSubscriptionAdjustments","tags":["Subscription Adjustments"],"description":"Lists adjustments for a subscription or its orders.","responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SubscriptionAdjustments"}}}}}},"delete":{"parameters":[{"$ref":"#/components/parameters/filter_subscription_adjustments_query_param"}],"summary":"Delete Subscription Adjustments","operationId":"DeleteSubscriptionAdjustments","tags":["Subscription Adjustments"],"description":"Deletes adjustments for a subscription or its orders.","responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"type":"array","minItems":0,"maxItems":0,"items":{}}}}}}}},"/subscriptions/v1/shops/{shop_identifier}/subscriptions/{subscription_id}/adjustments/{adjustment_id}":{"parameters":[{"$ref":"#/components/parameters/shop_identifier_path_param"},{"$ref":"#/components/parameters/subscription_id_path_param"},{"$ref":"#/components/parameters/subscription_adjustment_id_path_param"}],"get":{"summary":"Get Subscription Adjustment by ID","operationId":"GetSubscriptionAdjustmentByID","tags":["Subscription Adjustments"],"description":"Gets an adjustment by its ID.","responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"type":"object","properties":{"adjustment":{"$ref":"#/components/schemas/SubscriptionAdjustment"}}}}}}}},"delete":{"summary":"Delete Subscription Adjustment by ID","operationId":"DeleteSubscriptionAdjustmentByID","tags":["Subscription Adjustments"],"description":"Deletes an adjustment by its ID.","responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"type":"array","minItems":0,"maxItems":0,"items":{}}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"object","properties":{"message":{"type":"string","enum":["not found ()"]}}}}},"example":{"errors":{"message":"not found (subscriptions:1234dde7622ab0.56787371)"}}}}}}}},"/subscriptions/v1/shops/{shop_identifier}/subscriptions/{subscription_id}/orders":{"get":{"tags":["Subscription Orders"],"summary":"List Orders","operationId":"ListOrders","description":"Retrieve a list of subscription orders for a subscription.","parameters":[{"$ref":"#/components/parameters/shop_identifier_path_param"},{"$ref":"#/components/parameters/subscription_id_path_param"},{"schema":{"type":"integer"},"in":"query","name":"page","description":"The desired page number for the paginated result"},{"schema":{"type":"integer"},"in":"query","description":"Maximum number of results to be returned","name":"limit"}],"responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SubscriptionOrders"}}}},"401":{"description":"Unauthenticated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnauthenticatedResponse"}}}}}}},"/subscriptions/v1/shops/{shop_identifier}/subscriptions/{subscription_id}/orders/{order_id}":{"get":{"tags":["Subscription Orders"],"summary":"Get Order","operationId":"GetOrder","description":"Retrieve a subscription order for a subscription by its id.","parameters":[{"$ref":"#/components/parameters/shop_identifier_path_param"},{"$ref":"#/components/parameters/subscription_id_path_param"},{"$ref":"#/components/parameters/order_id_path_param"}],"responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SubscriptionOrder"}}}},"401":{"description":"Unauthenticated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnauthenticatedResponse"}}}}}}},"/subscriptions/v1/shops/{shop_identifier}/future_orders":{"parameters":[{"$ref":"#/components/parameters/shop_identifier_path_param"}],"get":{"summary":"List Future Orders","operationId":"ListFutureOrders","tags":["Future Orders"],"description":"Lists future subscription orders for the shop.\\n\\nFor more information, refer to the [View Future Orders](/guides/subscriptions-v2/view-future-orders#querying-all-active-subscription-orders) guide.","parameters":[{"$ref":"#/components/parameters/limit"},{"$ref":"#/components/parameters/filter_future_orders_query_param"},{"$ref":"#/components/parameters/filter_future_order_subscriptions_query_param"},{"$ref":"#/components/parameters/cursor"}],"responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FutureOrders"}}}},"401":{"description":"Unauthenticated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnauthenticatedResponse"}}}}}}},"/subscriptions/v1/shops/{shop_identifier}/subscriptions/{subscription_id}/future_orders":{"parameters":[{"$ref":"#/components/parameters/shop_identifier_path_param"},{"$ref":"#/components/parameters/subscription_id_path_param"}],"get":{"summary":"List Future Orders by Subscription ID","operationId":"ListFutureOrdersBySubscriptionID","tags":["Future Orders"],"description":"Lists future orders for a subscription.\\n\\nFor more information, refer to the [View Future Orders](/guides/subscriptions-v2/view-future-orders#querying-orders-by-subscription-id) guide.","parameters":[{"$ref":"#/components/parameters/limit"},{"$ref":"#/components/parameters/filter_future_orders_query_param"},{"$ref":"#/components/parameters/cursor"}],"responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FutureOrders"}}}},"401":{"description":"Unauthenticated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnauthenticatedResponse"}}}}}}},"/subscriptions/v1/shops/{shop_identifier}/convertible_adjustment_groups":{"parameters":[{"$ref":"#/components/parameters/shop_identifier_path_param"}],"post":{"tags":["Convertible Adjustments"],"summary":"Create Convertible Adjustment Group","description":"Creates a convertible adjustment group for a store. When created, the adjustment group does not have any products associated with it. Convertible adjustments enable customers to convert their subscription after an initial order.\\n\\nFor example, if the initial subscription order included a coffee maker and coffee grounds, a convertible adjustment allows subsequent orders to contain only coffee grounds.\\n\\nAfter calling this endpoint, call [Create Convertible Adjustment Group Items](/api/subscriptions#tag/Convertible-Adjustments/operation/CreateConvertibleAdjustmentGroupItems) to attach the created convertible adjustment group items to the adjustment group.","operationId":"CreateConvertibleAdjustmentGroup","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"type":"object","required":["convertible_adjustment_group"],"properties":{"convertible_adjustment_group":{"$ref":"#/components/schemas/ConvertibleAdjustmentGroup"}}}}}}}},"responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","required":["convertible_adjustment_group"],"properties":{"convertible_adjustment_group":{"$ref":"#/components/schemas/ConvertibleAdjustmentGroup"}}}}}}}},"401":{"description":"Unauthenticated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnauthenticatedResponse"}}}},"422":{"description":"Unprocessable Entity","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","description":"The error summary.","example":"The selected data.convertible adjustment group.on cycle end is invalid."},"errors":{"type":"object","additionalProperties":{"type":"array","minItems":1,"items":{"type":"string","description":"The detailed error message.","example":"The selected data.convertible adjustment group.on cycle end is invalid."}}}}},"example":{"message":"The selected data.convertible adjustment group.on cycle end is invalid.","errors":{"data.convertible_adjustment.on_cycle_end":["The selected data.convertible adjustment group.on cycle end is invalid."]}}}}}}}},"/subscriptions/v1/shops/{shop_identifier}/convertible_adjustment_groups/{adjustment_id}/items":{"parameters":[{"$ref":"#/components/parameters/shop_identifier_path_param"},{"$ref":"#/components/parameters/convertible_adjustment_group_id_path_param"}],"post":{"tags":["Convertible Adjustments"],"summary":"Create Convertible Adjustment Group Items","description":"Creates convertible adjustment group items used for a selection option. The first item in the `items` array represents the initial product and the second item represents the product it will convert to after the initial order is placed.","operationId":"CreateConvertibleAdjustmentGroupItems","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"type":"object","required":["items"],"properties":{"items":{"type":"array","minItems":2,"uniqueItems":true,"items":{"$ref":"#/components/schemas/ConvertibleAdjustmentGroupItemEntity"}}}}}},"example":{"data":{"items":[{"type":"initial_product","discount_type":"no_discount"},{"type":"product","product":{"platform_product_id":"7873884094619","platform_variant_id":"44147851264155"},"discount_type":"percentage","discount_value":50},{"type":"product","product":{"platform_product_id":"7873885831323","platform_variant_id":"44147858473115"},"discount_type":"percentage","discount_value":50}]}}}}},"responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"items":{"type":"array","minItems":2,"uniqueItems":true,"items":{"$ref":"#/components/schemas/ConvertibleAdjustmentGroupItem"}}}}}},"example":{"data":{"items":[{"id":81,"shop_platform_app_id":1007,"convertible_adjustment_group_id":20,"type":"initial_product","discount_type":"no_discount","discount_value":0,"product":null},{"id":82,"shop_platform_app_id":1007,"convertible_adjustment_group_id":20,"type":"product","discount_type":"percentage","discount_value":50,"product":{"id":82,"convertible_adjustment_group_id_item_id":82,"platform_product_id":"7873884094619","platform_variant_id":"44147851264155","created_at":"2024-03-19T20:42:47Z","updated_at":"2024-03-19T20:42:47Z","deleted_at":null}},{"id":83,"shop_platform_app_id":1007,"convertible_adjustment_group_id":20,"type":"product","discount_type":"percentage","discount_value":50,"product":{"id":83,"convertible_adjustment_group_id_item_id":83,"platform_product_id":"7873885831323","platform_variant_id":"44147858473115","created_at":"2024-03-19T20:42:47Z","updated_at":"2024-03-19T20:42:47Z","deleted_at":null}}]}}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"object","properties":{"message":{"type":"string","description":"The error message.","example":"validating items of type \\"product\\" failed with reason: platform \\"[product]:[variant]\\" data was not found for some items: 123:456"}}}}}}}},"401":{"description":"Unauthenticated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnauthenticatedResponse"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"object","properties":{"message":{"type":"string","enum":["not found ()"]}}}}}}}},"422":{"description":"Unprocessable Entity","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","description":"The error summary.","example":"The selected data.items.0.type is invalid."},"errors":{"type":"object","additionalProperties":{"type":"array","minItems":1,"items":{"type":"string","description":"The detailed error message.","example":"The selected data.items.0.type is invalid."}}}}},"example":{"errors":{"data.items.0.type":["The selected data.items.0.type is invalid."]}}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"object","properties":{"message":{"type":"string","description":"The error message.","example":"validating items of type \\"product\\" failed with reason: failed to fetch variants: variant data missing from response (subscriptions:123.456)"}}}}}}}}}},"delete":{"tags":["Convertible Adjustments"],"summary":"Delete Convertible Adjustment Group Items","description":"Deletes all convertible adjustment group items from a convertible adjustment group.","operationId":"DeleteConvertibleAdjustmentGroupItems","responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"deleted_item_count":{"type":"integer","description":"The number of deleted convertible adjustment group items from the convertible adjustment group.","example":1}}}}}}}},"401":{"description":"Unauthenticated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnauthenticatedResponse"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"object","properties":{"message":{"type":"string","enum":["not found ()"]}}}}}}}}}}},"/subscriptions/v1/shops/{shop_identifier}/convertible_adjustment_groups/{adjustment_id}":{"parameters":[{"$ref":"#/components/parameters/shop_identifier_path_param"},{"$ref":"#/components/parameters/convertible_adjustment_group_id_path_param"}],"delete":{"tags":["Convertible Adjustments"],"summary":"Delete Convertible Adjustment Group","description":"Deletes a convertible adjustment group and its items for a store.","operationId":"DeleteConvertibleAdjustmentGroup","responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"convertible_adjustment_group_id":{"type":"integer","example":2}}}}}}}},"401":{"description":"Unauthenticated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnauthenticatedResponse"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"object","properties":{"message":{"type":"string","enum":["not found ()"]}}}}}}}}}},"put":{"tags":["Convertible Adjustments"],"summary":"Update Convertible Adjustment Group","description":"Updates a convertible adjustment group for a store.","operationId":"UpdateConvertibleAdjustmentGroup","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"type":"object","required":["convertible_adjustment_group"],"properties":{"convertible_adjustment_group":{"$ref":"#/components/schemas/ConvertibleAdjustmentGroup"}}}}}}}},"responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","required":["convertible_adjustment_group"],"properties":{"convertible_adjustment_group":{"$ref":"#/components/schemas/ConvertibleAdjustmentGroup"}}}}}}}},"401":{"description":"Unauthenticated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnauthenticatedResponse"}}}},"422":{"description":"Unprocessable Entity","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","description":"The error summary.","example":"The selected data.convertible adjustment group.on cycle end is invalid."},"errors":{"type":"object","additionalProperties":{"type":"array","minItems":1,"items":{"type":"string","description":"The detailed error message.","example":"The selected data.convertible adjustment group.on cycle end is invalid."}}}}},"example":{"message":"The selected data.convertible adjustment group.on cycle end is invalid.","errors":{"data.convertible_adjustment.on_cycle_end":["The selected data.convertible adjustment group.on cycle end is invalid."]}}}}}}}},"/subscriptions/v1/shops/{shop_identifier}/convertible_adjustment_groups/{adjustment_id}/items/{adjustment_item_id}":{"parameters":[{"$ref":"#/components/parameters/shop_identifier_path_param"},{"$ref":"#/components/parameters/convertible_adjustment_group_id_path_param"},{"$ref":"#/components/parameters/convertible_adjustment_group_item_id_path_param"}],"delete":{"tags":["Convertible Adjustments"],"summary":"Delete Convertible Adjustment Group Item","description":"Deletes a convertible adjustment group item from a convertible adjustment group using the convertible adjustment group item ID","operationId":"DeleteConvertibleAdjustmentGroupItem","responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"item_id":{"type":"integer","description":"The convertible adjustment group item identifier deleted from the convertible adjustment plan.","example":2}}}}}}}},"401":{"description":"Unauthenticated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnauthenticatedResponse"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"object","properties":{"message":{"type":"string","enum":["not found ()"]}}}}}}}}}},"put":{"tags":["Convertible Adjustments"],"summary":"Update Convertible Adjustment Group Item","description":"Updates a convertible adjustment group item from a convertible adjustment group using the convertible adjustment group item ID","operationId":"UpdateConvertibleAdjustmentGroupItem","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"type":"object","required":["item"],"properties":{"item":{"$ref":"#/components/schemas/ConvertibleAdjustmentGroupItemEntity"}}}}},"example":{"data":{"item":{"type":"product","product":{"platform_product_id":"7873884094619","platform_variant_id":"44147851264155"},"discount_type":"percentage","discount_value":50}}}}}},"responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"item":{"$ref":"#/components/schemas/ConvertibleAdjustmentGroupItem"}}}}},"example":{"data":{"item":{"id":82,"shop_platform_app_id":1007,"convertible_adjustment_group_id":20,"type":"product","discount_type":"percentage","discount_value":50,"product":{"id":82,"convertible_adjustment_group_id_item_id":82,"platform_product_id":"7873884094619","platform_variant_id":"44147851264155","created_at":"2024-03-19T20:42:47Z","updated_at":"2024-03-19T20:42:47Z","deleted_at":null}}}}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"object","properties":{"message":{"type":"string","description":"The error message.","example":"validating items of type \\"product\\" failed with reason: platform \\"[product]:[variant]\\" data was not found for some items: 123:456"}}}}}}}},"401":{"description":"Unauthenticated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnauthenticatedResponse"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"object","properties":{"message":{"type":"string","enum":["not found ()"]}}}}}}}},"422":{"description":"Unprocessable Entity","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","description":"The error summary.","example":"The selected data.item.type is invalid."},"errors":{"type":"object","additionalProperties":{"type":"array","minItems":1,"items":{"type":"string","description":"The detailed error message.","example":"The selected data.item.type is invalid."}}}}},"example":{"errors":{"data.item.type":["The selected data.type is invalid."]}}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"object","properties":{"message":{"type":"string","description":"The error message.","example":"validating items of type \\"product\\" failed with reason: failed to fetch variants: variant data missing from response (subscriptions:123.456)"}}}}}}}}}}},"/subscriptions/v1/shops/{shop_identifier}/subscriptions/{subscription_id}/payment_method":{"get":{"tags":["Payment Methods"],"summary":"Get Payment Method","operationId":"GetPaymentMethod","description":"Retrieve the current payment method information of a subscription.","parameters":[{"$ref":"#/components/parameters/shop_identifier_path_param"},{"$ref":"#/components/parameters/subscription_id_path_param"}],"responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentMethod"}}}},"401":{"description":"Unauthenticated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnauthenticatedResponse"}}}}}}},"/subscriptions/v1/shops/{shop_identifier}/subscriptions/{subscription_id}/payment_method_email":{"parameters":[{"$ref":"#/components/parameters/shop_identifier_path_param"},{"$ref":"#/components/parameters/subscription_id_path_param"}],"post":{"tags":["Payment Methods"],"summary":"Trigger Update Payment Method Email","operationId":"TriggerUpdatePaymentMethodEmail","description":"**Note:** Available for Shopify Checkout only.\\n\\nTrigger an email to the customer that allows them to update their payment method for the subscription. This endpoint can only be called if the subscription\'s payment method has an `update_method` of `trigger_email`.\\n\\nYou can change the contents of the email in Shopify\'s \\"Customer payment method update request\\" email settings.","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{}}}}}}}},"/subscriptions/v1/shops/{shop_identifier}/subscriptions/{subscription_id}/payment_methods":{"get":{"tags":["Payment Methods"],"summary":"List Payment Methods","operationId":"ListPaymentMethods","description":"Retrieve a list of available payment methods for a subscription.","parameters":[{"$ref":"#/components/parameters/shop_identifier_path_param"},{"$ref":"#/components/parameters/subscription_id_path_param"}],"responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentMethods"}}}},"401":{"description":"Unauthenticated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnauthenticatedResponse"}}}}}}},"/subscriptions/v1/shops/{shop_identifier}/subscriptions/{subscription_id}/line_items":{"parameters":[{"$ref":"#/components/parameters/shop_identifier_path_param"},{"$ref":"#/components/parameters/subscription_id_path_param"}],"patch":{"tags":["Subscription Line Items"],"summary":"Update Line Items","operationId":"UpdateLineItems","description":"Update the line items of a subscription. Refer to [Manage Subscription Line Items](/guides/subscriptions-v2/line-items) for more information about the use cases of this endpoint.\\n\\nWhen updating the price of the line item, change the `price` field in the request body. This value must be in the `charged_currency` of the subscription, and it must be in the base currency unit (i.e., cents). This price is the final output price of the line item on this order; any applicable subscription group discounts or price changes will not be applied.\\n\\n*Example:\\nIf you include price: 4000 in the request body, the line item price is set to $40.00 CAD for all upcoming orders.*","parameters":[{"$ref":"#/components/parameters/shop_identifier_path_param"},{"$ref":"#/components/parameters/subscription_id_path_param"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateSubscriptionLineItems"}}}},"responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SubscriptionUpdateLineItems"}}}},"401":{"description":"Unauthenticated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnauthenticatedResponse"}}}}}},"post":{"tags":["Subscriptions"],"summary":"Create Line Items","description":"Add one or more line items to a subscription. Refer to [Create Subscription Line Items](/guides/subscriptions-v2/create-line-items) for more information about the use cases of this endpoint.\\n\\n**Note:** Adding line items to multi-currency subscriptions is not supported at this time.","operationId":"CreateLineItems","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateSubscriptionLineItems"}}}},"responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateLineItemsResponse"}}}},"401":{"description":"Unauthenticated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnauthenticatedResponse"}}}},"403":{"description":"Adding line items to multi-currency subscriptions is not supported at this time."},"404":{"description":"Subscription, product variant, or subscription group not found."}}}},"/subscriptions/v1/shops/{shop_identifier}/subscriptions/{subscription_id}/next_order_datetime":{"put":{"tags":["Subscription Orders"],"summary":"Update Next Order Datetime","operationId":"UpdateNextOrderDatetime","description":"Update the datetime of the next subscription order in [RFC 3339 format](https://www.ietf.org/rfc/rfc3339.txt).","parameters":[{"$ref":"#/components/parameters/shop_identifier_path_param"},{"$ref":"#/components/parameters/subscription_id_path_param"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateSubscriptionNextOrderDate"}}}},"responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Subscription"}}}},"401":{"description":"Unauthenticated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnauthenticatedResponse"}}}}}}},"/subscriptions/v1/shops/{shop_identifier}/subscriptions/{subscription_id}/recover":{"put":{"tags":["Subscription Orders"],"summary":"Unskip Previously Skipped Order","operationId":"UnskipPreviouslySkippedOrder","description":"Restore a previously skipped future subscription order. Specify the date of the order to be unskipped.","parameters":[{"$ref":"#/components/parameters/shop_identifier_path_param"},{"$ref":"#/components/parameters/subscription_id_path_param"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnskipSubscriptionOrder"}}}},"responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Subscription"}}}},"401":{"description":"Unauthenticated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnauthenticatedResponse"}}}}}}},"/subscriptions/v1/shops/{shop_identifier}/subscriptions/{subscription_id}/skip":{"put":{"tags":["Subscription Orders"],"summary":"Skip Subscription Order","operationId":"SkipSubscriptionOrder","description":"Skip a subscription\'s upcoming order by date.","parameters":[{"$ref":"#/components/parameters/shop_identifier_path_param"},{"$ref":"#/components/parameters/subscription_id_path_param"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SkipSubscriptionOrder"}}}},"responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Subscription"}}}},"401":{"description":"Unauthenticated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnauthenticatedResponse"}}}}}}},"/subscriptions/v1/shops/{shop_identifier}/subscriptions/{subscription_id}/activate":{"post":{"tags":["Subscriptions"],"summary":"Reactivate Subscription","operationId":"ReactivateSubscription","description":"Reactivate an inactive or cancelled subscription.","parameters":[{"$ref":"#/components/parameters/shop_identifier_path_param"},{"$ref":"#/components/parameters/subscription_id_path_param"}],"responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Subscription"}}}},"401":{"description":"Unauthenticated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnauthenticatedResponse"}}}}}}},"/subscriptions/v1/shops/{shop_identifier}/subscriptions/{subscription_id}/cancel":{"post":{"tags":["Subscriptions"],"summary":"Cancel Subscription","operationId":"CancelSubscription","description":"Cancel a subscription and any future orders. Cancelled subscriptions will appear as \'inactive\'.","parameters":[{"$ref":"#/components/parameters/shop_identifier_path_param"},{"$ref":"#/components/parameters/subscription_id_path_param"}],"responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Subscription"}}}},"401":{"description":"Unauthenticated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnauthenticatedResponse"}}}}}}},"/subscriptions/v1/shops/{shop_identifier}/subscriptions/{subscription_id}/pause":{"post":{"tags":["Subscriptions"],"summary":"Pause Subscription","operationId":"PauseSubscription","description":"Pause a subscription and any future orders. Paused orders will still appear as \'active\'.","parameters":[{"$ref":"#/components/parameters/shop_identifier_path_param"},{"$ref":"#/components/parameters/subscription_id_path_param"}],"responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Subscription"}}}},"401":{"description":"Unauthenticated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnauthenticatedResponse"}}}}}}},"/subscriptions/v1/shops/{shop_identifier}/subscriptions/{subscription_id}/line_items/{line_item_id}":{"delete":{"tags":["Subscription Line Items"],"summary":"Delete Line Item","operationId":"DeleteLineItem","description":"Delete a line item from a subscription.","parameters":[{"$ref":"#/components/parameters/shop_identifier_path_param"},{"$ref":"#/components/parameters/subscription_id_path_param"},{"$ref":"#/components/parameters/line_item_id_path_param"}],"responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Subscription"}}}},"401":{"description":"Unauthenticated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnauthenticatedResponse"}}}}}},"get":{"tags":["Subscription Line Items"],"summary":"Get Line Item","operationId":"GetLineItem","description":"Retrieve the details of a specific line item from a given subscription.","parameters":[{"$ref":"#/components/parameters/shop_identifier_path_param"},{"$ref":"#/components/parameters/subscription_id_path_param"},{"$ref":"#/components/parameters/line_item_id_path_param"}],"responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"type":"object","properties":{"subscription_line_item":{"$ref":"#/components/schemas/LineItemEntity"}}},"examples":{"success-example":{"value":{"subscription_line_item":{"id":1,"subscription_id":1,"platform_id":"ABC123","platform_product_id":"1357908642","platform_variant_id":"2468097531","subscription_group_id":1,"subscription_group_billing_rules_id":1,"title":"Monthly Expansion Pack","product_name":"Monthly Expansion Pack","variant_name":"Default Title","sku":"SKU-113-Red","url":"https://example-store.example.com/monthly-expansion-pack","image":"","quantity":1,"price":3500,"price_charged":3200,"discounted_price":3200,"discounted_price_charged":3200,"full_price":3200,"full_price_charged":3200,"requires_shipping":false,"grams":2200,"weight":2.2,"weight_unit":"kg","taxable":true,"discounts":[{"id":1,"subscription_line_item_id":1,"shop_id":5,"full_price":5,"discount_type":"percentage","percentage_value":10,"fixed_value":0,"fixed_value_charged":0,"description":"Subscription discount (10%) for Monthly Expansion Pack","created_at":"2019-11-20T20:31:55Z","updated_at":"2019-11-20T20:31:55Z","deleted_at":"2019-11-20T20:31:55Z"}],"prepaid_metadata":{"id":1,"line_item_id":2,"prepaid_duration":2,"current_recurrence_count":2,"prepaid_continue":"no_continue"},"line_item_attributes":[{"name":"size_preference","value":"XL","created_at":"2021-01-17T20:30:40Z","updated_at":"2021-01-17T20:30:40Z","subscription_id":1,"line_item_id":1}],"created_at":"2019-11-20T20:31:55Z","updated_at":"2019-11-20T20:31:55Z"}}}}}}},"404":{"description":"Subscription or line item not found"}}}},"/subscriptions/v1/shops/{shop_identifier}/subscriptions/{subscription_id}/line_items/{line_item_id}/products_swap":{"parameters":[{"$ref":"#/components/parameters/shop_identifier_path_param"},{"$ref":"#/components/parameters/subscription_id_path_param"},{"$ref":"#/components/parameters/line_item_id_path_param"}],"get":{"tags":["Subscription Line Items"],"summary":"List Swappable Products by Line Item","operationId":"ListSwappableProductsByLineItem","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SwappableProducts"}}}},"401":{"description":"Unauthenticated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnauthenticatedResponse"}}}}},"description":"Retrieve a list of swappable products for a subscription line item.","parameters":[{"$ref":"#/components/parameters/shop_identifier_path_param"},{"$ref":"#/components/parameters/subscription_id_path_param"},{"$ref":"#/components/parameters/line_item_id_path_param"},{"schema":{"type":"integer"},"in":"query","name":"limit","description":"Maximum number of results to be returned"},{"schema":{"type":"integer"},"in":"query","name":"page","description":"The desired page number for the paginated result"}]}},"/subscriptions/v1/shops/{shop_identifier}/selection_options":{"parameters":[{"$ref":"#/components/parameters/shop_identifier_path_param"}],"get":{"tags":["Subscription Groups"],"summary":"List Selection Options","description":"Retrieves a list of selection options. Selection options are the products available in a subscription group. Use this endpoint to view some or all selection options for the active subscription groups on a given store.","operationId":"ListSelectionOptions","parameters":[{"schema":{"type":"string"},"in":"query","name":"cursor","description":"A base 64 encoded cursor.","example":"?cursor=P2lkPTU1"},{"schema":{"type":"string"},"in":"query","name":"filter","description":"Accepts filtering options as described on the [Query & Pagination page](/guides/subscriptions-v2/resources/query-pagination).","example":"?filter=in(platform_entity_id:1,2,3)"},{"schema":{"type":"string"},"in":"query","name":"expand","description":"Fields to expand on the selection options. Currently accepts `subscription_group` and `products`","example":"?expand=subscription_group&expand=products"},{"schema":{"type":"integer"},"in":"query","name":"limit","description":"Limit the number of returned items.","example":"?limit=3L9"},{"$ref":"#/components/parameters/latest"}],"responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SelectionOptions"}}}},"401":{"description":"Unauthenticated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnauthenticatedResponse"}}}}}}},"/subscriptions/v1/shops/{shop_identifier}/subscription_groups":{"parameters":[{"$ref":"#/components/parameters/shop_identifier_path_param"}],"get":{"tags":["Subscription Groups"],"summary":"List Subscription Groups","operationId":"ListSubscriptionGroups","description":"Retrieve a list of subscription groups.","responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SubscriptionGroups"},"examples":{"example-1":{"value":{"subscription_groups":[{"id":3,"shop_id":1,"internal_name":"Standard Subscription","is_enabled":true,"platform_id":"gid://shopify/SellingPlanGroup/132016692","allow_prepaid":false,"is_prepaid_only":false,"should_continue_prepaid":false,"continue_prepaid_type":"as_prepaid","percent_discount":11,"minimum_order_count_before_cancellable":0,"is_product_swappable":false,"is_subscription_only":false,"selection_type":"products","group_type":"selectable","selectable_daily_allowed":false,"selectable_weekly_allowed":false,"selectable_yearly_allowed":false,"selectable_max_interval_frequency":0,"fixed_interval_type":"monthly","is_fixed_billing":false,"can_add_to_cart":true,"allow_buffer_days":true,"discount_type":"fixed","fixed_discount":10,"created_at":"2019-11-20T20:50:07Z","updated_at":"2019-11-20T20:50:07Z","deleted_at":null,"active_subscribers_count":1,"billing_rules":[{"id":1,"shop_id":1,"subscription_group_id":1,"interval_number":1,"interval_type":"month","interval_name":"Monthly","week_type":"","week_day":0,"month_type":"purchase_day","month_day":"","month_occurrence":"","month_occurrence_day":"","year_type":"","year_month":"","year_occurrence":"","year_occurrence_day":"","billing_rule":"FREQ=MONTHLY","created_at":"2019-11-20T20:50:07Z","updated_at":"2019-11-20T20:50:07Z","deleted_at":null}],"selection_options":[{"id":1,"shop_id":1,"subscription_group_id":1,"platform_entity_id":"1357908642","created_at":"2019-11-20T20:50:07Z","updated_at":"2019-11-20T20:50:07Z","deleted_at":null,"entity_id":1472540}],"prepaid_durations":[{}]}]}}}}}},"401":{"description":"Unauthenticated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnauthenticatedResponse"}}}}}},"post":{"tags":["Subscription Groups"],"summary":"Create Subscription Group","operationId":"CreateSubscriptionGroup","description":"Create a subscription group.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SubscriptionGroup"}}}},"responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SubscriptionGroup"}}}},"401":{"description":"Unauthenticated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnauthenticatedResponse"}}}}}}},"/subscriptions/v1/shops/{shop_identifier}/subscription_groups/{group_id}":{"get":{"tags":["Subscription Groups"],"summary":"Get Subscription Group","operationId":"GetSubscriptionGroup","description":"Retrieve a subscription group by its id.","parameters":[{"$ref":"#/components/parameters/shop_identifier_path_param"},{"$ref":"#/components/parameters/group_id_path_param"}],"responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SubscriptionGroup"}}}},"401":{"description":"Unauthenticated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnauthenticatedResponse"}}}}}},"put":{"tags":["Subscription Groups"],"summary":"Update Subscription Group","operationId":"UpdateSubscriptionGroup","description":"Update a subscription group by its id.","parameters":[{"$ref":"#/components/parameters/shop_identifier_path_param"},{"$ref":"#/components/parameters/group_id_path_param"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SubscriptionGroup"}}}},"responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SubscriptionGroup"}}}},"401":{"description":"Unauthenticated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnauthenticatedResponse"}}}}}},"delete":{"tags":["Subscription Groups"],"summary":"Delete Subscription Group","operationId":"DeleteSubscriptionGroup","description":"Delete a subscription group by its id.","parameters":[{"$ref":"#/components/parameters/shop_identifier_path_param"},{"$ref":"#/components/parameters/group_id_path_param"}],"responses":{"200":{"description":"Successful operation"},"401":{"description":"Unauthenticated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnauthenticatedResponse"}}}}}}},"/subscriptions/v1/shops/{shop_identifier}/webhooks/topics":{"get":{"summary":"List Webhook Topics","operationId":"ListWebhookTopics","tags":["Webhook Topics"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookTopics"},"examples":{"example":{"value":{"webhook_topics":[{"id":1,"topic_name":"subscription_created"},{"id":2,"topic_name":"subscription_updated"},{"id":3,"topic_name":"subscription_order_created"},{"id":4,"topic_name":"customer_created"},{"id":5,"topic_name":"customer_updated"},{"id":6,"topic_name":"subscription_order_transaction_failed"},{"id":7,"topic_name":"subscription_order_max_retries_reached"},{"id":8,"topic_name":"subscription_payment_method_updated"},{"id":9,"topic_name":"subscription_upcoming_order"},{"id":10,"topic_name":"subscription_expiring_payment"},{"id":12,"topic_name":"subscription_cancelled"},{"id":13,"topic_name":"subscription_paused"},{"id":14,"topic_name":"subscription_resumed"},{"id":15,"topic_name":"subscription_reactivated"},{"id":16,"topic_name":"subscription_frequency_updated"},{"id":17,"topic_name":"subscription_quantity_updated"},{"id":18,"topic_name":"subscription_credit_card_updated"},{"id":19,"topic_name":"subscription_shipping_address_updated"},{"id":20,"topic_name":"subscription_payment_failed"},{"id":21,"topic_name":"subscription_skipped"},{"id":22,"topic_name":"subscription_line_items_added"}]}}}}}},"401":{"description":"Unauthenticated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnauthenticatedResponse"}}}}},"description":"Retrieve a list of available webhook topics.","parameters":[{"$ref":"#/components/parameters/shop_identifier_path_param"}]}},"/subscriptions/v1/shops/{shop_identifier}/webhooks/subscriptions":{"parameters":[{"$ref":"#/components/parameters/shop_identifier_path_param"}],"get":{"summary":"List Webhook Subscriptions","operationId":"ListWebhookSubscriptions","tags":["Webhook Subscriptions"],"responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookSubscriptions"},"examples":{"example":{"value":{"webhook_subscriptions":[{"id":1,"shop_id":1,"webhook_topic_id":1,"callback_url":"yourapp.com/v2/sub-created","created_at":"2020-09-17T18:27:03Z","updated_at":"2020-09-17T18:27:03Z","deleted_at":null},{"id":1,"shop_id":1,"webhook_topic_id":2,"callback_url":"yourapp.com/sub-updated","created_at":"2020-08-17T18:27:03Z","updated_at":"2020-08-17T18:27:03Z","deleted_at":null}],"pagination":{"limit":10,"count":2,"total":2,"total_pages":1}}}}}}},"401":{"description":"Unauthenticated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnauthenticatedResponse"}}}}},"description":"Retrieve a list of webhook subscriptions.","parameters":[{"schema":{"type":"integer"},"in":"query","name":"since_id","description":""},{"schema":{"type":"string"},"in":"query","name":"limit","description":"Maximum number of results to be returned"},{"schema":{"type":"array","items":{"type":"string","enum":["webhook_topic_id","callback_url","shared_secret","created_at","updated_at"]}},"in":"query","name":"filters","description":"Filter subscription webhooks. Multiple filters can be passed in the array."}]},"post":{"summary":"Create Webhook Subscription","operationId":"CreateWebhookSubscription","tags":["Webhook Subscriptions"],"responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookSubscription"}}}},"401":{"description":"Unauthenticated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnauthenticatedResponse"}}}}},"description":"Create a webhook subscription. For more information, refer to [Register for Webhooks](/guides/subscriptions-v2/webhooks).\\n\\nThe `subscription_payment_method_updated` webhook is not supported by default for all Shopify shops installed prior to January 15th 2024 (2024-01-15). Please submit a [support request](https://support.boldcommerce.com/hc/en-us/requests/new?ticket_form_id=132106) for access.","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"webhook_subscription":{"type":"object","required":["webhook_topic_id","callback_url","shared_secret"],"properties":{"webhook_topic_id":{"type":"integer","example":10,"minimum":1,"maximum":10},"callback_url":{"type":"string","format":"uri","example":"https://webhooks.shop.com"},"shared_secret":{"type":"string","example":"exMh194qw8JD@A50dA^P"}}}},"required":["webhook_subscription"]}}}},"callbacks":{"Subscription created":{"{$request.body#/webhook_subscription.callback_url}":{"parameters":[{"$ref":"#/components/parameters/event_actor_type_header"},{"$ref":"#/components/parameters/shop_identifier_header"},{"in":"header","name":"Event-Identifier","required":true,"description":"The webhook topic name of the event.","schema":{"type":"string","enum":["subscription_created"]}}],"post":{"summary":"Subscription Created","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SubscriptionEntity"}}}},"responses":{"200":{"description":"Successful operation"}}}}},"Subscription updated":{"{$request.body#/webhook_subscription.callback_url}":{"parameters":[{"$ref":"#/components/parameters/event_actor_type_header"},{"$ref":"#/components/parameters/shop_identifier_header"},{"in":"header","name":"Event-Identifier","required":true,"description":"The webhook topic name of the event.","schema":{"type":"string","enum":["subscription_updated"]}}],"post":{"summary":"Subscription Updated","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SubscriptionEntity"}}}},"responses":{"200":{"description":"Successful operation"}}}}},"Subscription order created":{"{$request.body#/webhook_subscription.callback_url}":{"parameters":[{"$ref":"#/components/parameters/event_actor_type_header"},{"$ref":"#/components/parameters/shop_identifier_header"},{"in":"header","name":"Event-Identifier","required":true,"description":"The webhook topic name of the event.","schema":{"type":"string","enum":["subscription_order_created"]}}],"post":{"summary":"Subscription Order Created","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SubscriptionOrder"}}}},"responses":{"200":{"description":"Successful operation"}}}}},"Customer created":{"{$request.body#/webhook_subscription.callback_url}":{"parameters":[{"$ref":"#/components/parameters/event_actor_type_header"},{"$ref":"#/components/parameters/shop_identifier_header"},{"in":"header","name":"Event-Identifier","required":true,"description":"The webhook topic name of the event.","schema":{"type":"string","enum":["customer_created"]}}],"post":{"summary":"Customer Created","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CustomerEntity"}}}},"responses":{"200":{"description":"Successful operation"}}}}},"Customer updated":{"{$request.body#/webhook_subscription.callback_url}":{"parameters":[{"$ref":"#/components/parameters/event_actor_type_header"},{"$ref":"#/components/parameters/shop_identifier_header"},{"in":"header","name":"Event-Identifier","required":true,"description":"The webhook topic name of the event.","schema":{"type":"string","enum":["customer_updated"]}}],"post":{"summary":"Customer Updated","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Customer"}}}},"responses":{"200":{"description":"Successful operation"}}}}},"Subscription order transaction failed":{"{$request.body#/webhook_subscription.callback_url}":{"parameters":[{"$ref":"#/components/parameters/event_actor_type_header"},{"$ref":"#/components/parameters/shop_identifier_header"},{"in":"header","name":"Event-Identifier","required":true,"description":"The webhook topic name of the event.","schema":{"type":"string","enum":["subscription_order_transaction_failed"]}}],"post":{"summary":"Subscription Order Transaction Failed","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SubscriptionOrderTransactionFailed"}}}},"responses":{"200":{"description":"Successful operation"}}}}},"Subscription order max retries reached":{"{$request.body#/webhook_subscription.callback_url}":{"parameters":[{"$ref":"#/components/parameters/event_actor_type_header"},{"$ref":"#/components/parameters/shop_identifier_header"},{"in":"header","name":"Event-Identifier","required":true,"description":"The webhook topic name of the event.","schema":{"type":"string","enum":["subscription_order_max_retries_reached"]}}],"post":{"summary":"Subscription Order Max Retries Reached","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SubscriptionOrderTransactionFailed"}}}},"responses":{"200":{"description":"Successful operation"}}}}},"Subscription payment method updated":{"{$request.body#/webhook_subscription.callback_url}":{"parameters":[{"$ref":"#/components/parameters/event_actor_type_header"},{"$ref":"#/components/parameters/shop_identifier_header"},{"in":"header","name":"Event-Identifier","required":true,"description":"The webhook topic name of the event.","schema":{"type":"string","enum":["subscription_payment_method_updated"]}}],"post":{"summary":"Subscription Payment Method Updated","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SubscriptionEntity"}}}},"responses":{"200":{"description":"Successful operation"}}}}},"Upcoming order":{"{$request.body#/webhook_subscription.callback_url}":{"parameters":[{"$ref":"#/components/parameters/event_actor_type_header"},{"$ref":"#/components/parameters/shop_identifier_header"},{"in":"header","name":"Event-Identifier","required":true,"description":"The webhook topic name of the event.","schema":{"type":"string","enum":["subscription_upcoming_order"]}}],"post":{"summary":"Upcoming Order","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Subscription"}}}},"responses":{"200":{"description":"Successful operation"}}}}},"Expiring payment method":{"{$request.body#/webhook_subscription.callback_url}":{"parameters":[{"$ref":"#/components/parameters/event_actor_type_header"},{"$ref":"#/components/parameters/shop_identifier_header"},{"in":"header","name":"Event-Identifier","required":true,"description":"The webhook topic name of the event.","schema":{"type":"string","enum":["subscription_expiring_payment"]}}],"post":{"summary":"Expiring Payment Method","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SubscriptionAndPaymentMethod"}}}},"responses":{"200":{"description":"Successful operation"}}}}},"Subscription cancelled":{"{$request.body#/webhook_subscription.callback_url}":{"parameters":[{"$ref":"#/components/parameters/event_actor_type_header"},{"$ref":"#/components/parameters/shop_identifier_header"},{"in":"header","name":"Event-Identifier","required":true,"description":"The webhook topic name of the event.","schema":{"type":"string","enum":["subscription_cancelled"]}}],"post":{"summary":"Subscription Cancelled","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SubscriptionEntity"}}}},"responses":{"200":{"description":"Successful operation"}}}}},"Subscription frequency updated":{"{$request.body#/webhook_subscription.callback_url}":{"parameters":[{"$ref":"#/components/parameters/event_actor_type_header"},{"$ref":"#/components/parameters/shop_identifier_header"},{"in":"header","name":"Event-Identifier","required":true,"description":"The webhook topic name of the event.","schema":{"type":"string","enum":["subscription_frequency_updated"]}}],"post":{"summary":"Subscription Frequency Updated","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SubscriptionEntity"}}}},"responses":{"200":{"description":"Successful operation"}}}}},"Subscription credit card updated":{"{$request.body#/webhook_subscription.callback_url}":{"parameters":[{"$ref":"#/components/parameters/event_actor_type_header"},{"$ref":"#/components/parameters/shop_identifier_header"},{"in":"header","name":"Event-Identifier","required":true,"description":"The webhook topic name of the event.","schema":{"type":"string","enum":["subscription_credit_card_updated"]}}],"post":{"summary":"Subscription Credit Card Updated","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SubscriptionEntity"}}}},"responses":{"200":{"description":"Successful operation"}}}}},"Subscription payment failed":{"{$request.body#/webhook_subscription.callback_url}":{"parameters":[{"$ref":"#/components/parameters/event_actor_type_header"},{"$ref":"#/components/parameters/shop_identifier_header"},{"in":"header","name":"Event-Identifier","required":true,"description":"The webhook topic name of the event.","schema":{"type":"string","enum":["subscription_payment_failed"]}}],"post":{"summary":"Subscription Payment Failed","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SubscriptionEntity"}}}},"responses":{"200":{"description":"Successful operation"}}}}},"Subscription paused":{"{$request.body#/webhook_subscription.callback_url}":{"parameters":[{"$ref":"#/components/parameters/event_actor_type_header"},{"$ref":"#/components/parameters/shop_identifier_header"},{"in":"header","name":"Event-Identifier","required":true,"description":"The webhook topic name of the event.","schema":{"type":"string","enum":["subscription_paused"]}}],"post":{"summary":"Subscription Paused","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SubscriptionEntity"}}}},"responses":{"200":{"description":"Successful operation"}}}}},"Subscription resumed":{"{$request.body#/webhook_subscription.callback_url}":{"parameters":[{"$ref":"#/components/parameters/event_actor_type_header"},{"$ref":"#/components/parameters/shop_identifier_header"},{"in":"header","name":"Event-Identifier","required":true,"description":"The webhook topic name of the event.","schema":{"type":"string","enum":["subscription_resumed"]}}],"post":{"summary":"Subscription Resumed","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SubscriptionEntity"}}}},"responses":{"200":{"description":"Successful operation"}}}}},"Subscription reactivated":{"{$request.body#/webhook_subscription.callback_url}":{"parameters":[{"$ref":"#/components/parameters/event_actor_type_header"},{"$ref":"#/components/parameters/shop_identifier_header"},{"in":"header","name":"Event-Identifier","required":true,"description":"The webhook topic name of the event.","schema":{"type":"string","enum":["subscription_reactivated"]}}],"post":{"summary":"Subscription Reactivated","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SubscriptionEntity"}}}},"responses":{"200":{"description":"Successful operation"}}}}},"Subscription shipping address updated":{"{$request.body#/webhook_subscription.callback_url}":{"parameters":[{"$ref":"#/components/parameters/event_actor_type_header"},{"$ref":"#/components/parameters/shop_identifier_header"},{"in":"header","name":"Event-Identifier","required":true,"description":"The webhook topic name of the event.","schema":{"type":"string","enum":["subscription_shipping_address_updated"]}}],"post":{"summary":"Subscription Shipping Address Updated","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SubscriptionEntity"}}}},"responses":{"200":{"description":"Successful operation"}}}}},"Subscription quantity updated":{"{$request.body#/webhook_subscription.callback_url}":{"parameters":[{"$ref":"#/components/parameters/event_actor_type_header"},{"$ref":"#/components/parameters/shop_identifier_header"},{"in":"header","name":"Event-Identifier","required":true,"description":"The webhook topic name of the event.","schema":{"type":"string","enum":["subscription_quantity_updated"]}}],"post":{"summary":"Subscription Quantity Updated","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SubscriptionEntity"}}}},"responses":{"200":{"description":"Successful operation"}}}}},"Subscription skipped":{"{$request.body#/webhook_subscription.callback_url}":{"parameters":[{"$ref":"#/components/parameters/event_actor_type_header"},{"$ref":"#/components/parameters/shop_identifier_header"},{"in":"header","name":"Event-Identifier","required":true,"description":"The webhook topic name of the event.","schema":{"type":"string","enum":["subscription_skipped"]}}],"post":{"summary":"Subscription Skipped","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SubscriptionEntity"}}}},"responses":{"200":{"description":"Successful operation"}}}}},"Subscription line items added":{"{$request.body#/webhook_subscription.callback_url}":{"parameters":[{"$ref":"#/components/parameters/event_actor_type_header"},{"$ref":"#/components/parameters/shop_identifier_header"},{"in":"header","name":"Event-Identifier","required":true,"description":"The webhook topic name of the event.","schema":{"type":"string","enum":["subscription_line_items_added"]}}],"post":{"summary":"Subscription Line Items Added","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SubscriptionEntity"}}}},"responses":{"200":{"description":"Successful operation"}}}}}}}},"/subscriptions/v1/shops/{shop_identifier}/webhooks/subscriptions/{webhook_subscription_id}":{"parameters":[{"$ref":"#/components/parameters/shop_identifier_path_param"},{"$ref":"#/components/parameters/webhook_subscription_id_path_param"}],"get":{"summary":"Get Webhook Subscription","operationId":"GetWebhookSubscription","tags":["Webhook Subscriptions"],"responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookSubscription"}}}},"401":{"description":"Unauthenticated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnauthenticatedResponse"}}}}},"description":"Retrieve a webhook subscription by its id."},"put":{"summary":"Update Webhook Subscription","operationId":"UpdateWebhookSubscription","tags":["Webhook Subscriptions"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookSubscription"}}}},"responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookSubscription"}}}},"401":{"description":"Unauthenticated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnauthenticatedResponse"}}}}},"description":"Update a webhook subscription by its id."},"delete":{"tags":["Webhook Subscriptions"],"summary":"Delete Webhook Subscription","operationId":"DeleteWebhookSubscription","responses":{"200":{"description":"Successful operation"},"401":{"description":"Unauthenticated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnauthenticatedResponse"}}}}},"description":"Delete a webhook subscription by its id."}},"/subscriptions/v1/shops/{shop_identifier}/webhooks/events":{"get":{"summary":"List Webhook Events","operationId":"ListWebhookEvents","tags":["Webhook Events"],"responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookEvents"},"examples":{"example":{"value":{"webhook_events":[{"id":0,"shop_id":0,"webhook_subscription_id":0,"webhook_topic_id":0,"uuid":"string","attempts":0,"last_response_status_code":"string","delivered_at":"string","created_at":"2019-11-20T20:31:55Z","updated_at":"2019-11-20T20:31:55Z","deleted_at":null}],"pagination":{"limit":10,"count":1,"total":1,"total_pages":1}}}}}}},"401":{"description":"Unauthenticated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnauthenticatedResponse"}}}}},"description":"Retrieve a list of webhook events.","parameters":[{"$ref":"#/components/parameters/shop_identifier_path_param"},{"schema":{"type":"integer"},"in":"query","name":"since_id"},{"schema":{"type":"string"},"in":"query","name":"limit","description":"Maximum number of results to be returned"},{"schema":{"type":"array","items":{"type":"string","enum":["shop_id","webhook_subscription_id","webhook_topic_id","uuid","attempts","last_response_status_code","id","created_at","updated_at","delivered_at"]}},"in":"query","name":"filters","description":"Filter event webhooks. Mulitple filters can be passed in the array."}]}},"/subscriptions/v1/shops/{shop_identifier}/webhooks/events/{webhook_event_id}":{"parameters":[{"$ref":"#/components/parameters/shop_identifier_path_param"},{"$ref":"#/components/parameters/webhook_event_id_path_param"}],"get":{"summary":"Get Webhook Event","operationId":"GetWebhookEvent","description":"Retrieve a webhook event by its id.","tags":["Webhook Events"],"responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookEvent"}}}},"401":{"description":"Unauthenticated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnauthenticatedResponse"}}}}}}},"/subscriptions/v1/shops/{shop_identifier}/subscriptions/{subscription_id}/alternative_payments":{"parameters":[{"$ref":"#/components/parameters/shop_identifier_path_param"},{"$ref":"#/components/parameters/subscription_id_path_param"}],"get":{"summary":"List Alternative Payment Methods","operationId":"ListAlternativePaymentMethods","tags":["Payment Methods"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AlternatePaymentMethod"}}}}},"description":"Retrieve a list of alternative payment methods for a subscription."},"post":{"summary":"Create Alternative Payment Method","operationId":"CreateAlternativePaymentMethods","tags":["Payment Methods"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"description":"","type":"object","properties":{"alternative_payment_methods":{"type":"array","uniqueItems":true,"minItems":1,"items":{"required":["subscription_id","public_payment_token"],"properties":{"subscription_id":{"type":"number"},"public_payment_token":{"type":"string","minLength":1}}}}},"required":["alternative_payment_methods"]},"examples":{"example-1":{"value":{"alternative_payment_methods":[{"subscription_id":0,"public_payment_token":"string"}]}}}}}}},"requestBody":{"content":{"application/json":{"schema":{"description":"","type":"object","properties":{"alternative_payment_methods":{"type":"array","uniqueItems":true,"minItems":1,"maxItems":1,"items":{"type":"object","properties":{"type":{"type":"string","minLength":1},"payment_details":{"type":"object","properties":{"card_number":{"type":"string","minLength":1},"security_key":{"type":"string"}},"required":["card_number","security_key"]}},"required":["type"]}}},"required":["alternative_payment_methods"]},"examples":{"example-1":{"value":{"alternative_payment_methods":[{"type":"gift_card","payment_details":{"card_number":"ABC1234","security_key":"123"}}]}},"example-2":{"value":{"alternative_payment_methods":[{"type":"string","payment_details":{"card_number":"string","security_key":"0"}}]}}}}},"description":""},"description":"Add an alternate payment method to a subscription."}},"/subscriptions/v1/shops/{shop_identifier}/subscriptions/{subscription_id}/alternative_payments/{payment_public_id}":{"parameters":[{"$ref":"#/components/parameters/shop_identifier_path_param"},{"$ref":"#/components/parameters/subscription_id_path_param"},{"schema":{"type":"string"},"name":"payment_public_id","in":"path","required":true}],"delete":{"summary":"Delete Alternative Payment Method","operationId":"DeleteAlternativePaymentMethod","tags":["Payment Methods"],"responses":{"200":{"description":"OK"}},"description":"Remove an alternative payment method from a subscription its paymentPublicID."}},"/subscriptions/v1/shops/{shop_identifier}/subscription_groups/{group_id}/selection_options/{selection_option_id}":{"parameters":[{"$ref":"#/components/parameters/shop_identifier_path_param"},{"$ref":"#/components/parameters/group_id_path_param"},{"schema":{"type":"string"},"name":"selection_option_id","in":"path","required":true,"description":"Selection option ID of the item to be deleted from the group."}],"delete":{"summary":"Delete Selection Option by ID","operationId":"DeleteSelectionOptionByID","responses":{"200":{"description":"Successful operation"},"401":{"description":"Unauthorized"},"404":{"description":"Subscription group or selection option not found"}},"description":"Delete a selection option from inside a subscription group.","tags":["Subscription Groups"]}},"/subscriptions/v1/shops/{shop_identifier}/subscription_groups/{group_id}/selection_options":{"parameters":[{"$ref":"#/components/parameters/shop_identifier_path_param"},{"$ref":"#/components/parameters/group_id_path_param"}],"delete":{"summary":"Delete Selection Option by Filter","operationId":"DeleteSelectionOptionByFilter","responses":{"200":{"description":"Successful operation"},"401":{"description":"Unauthorized"},"404":{"description":"Subscription group or selection option not found"}},"description":"Delete one or more selection options from inside a subscription group.","tags":["Subscription Groups"],"parameters":[{"schema":{"type":"string"},"in":"query","name":"filter","description":"Accepts filtering options as described here: https://developer.boldcommerce.com/guides/subscriptions-v2/resources/query-pagination. Example: to remove the platform product IDs 1, 2 and 3 from a subscription group, the following query param must be added: ?filter=in(platform_entity_id:1,2,3)","required":true}]},"post":{"tags":["Subscription Groups"],"summary":"Add Selection Options by Platform Product ID(s)","operationId":"AddSelectionOptionsByPlatformIDs","description":"Add one or more selection options from inside a subscription group.\\n","requestBody":{"content":{"application/json":{"schema":{"description":"","type":"object","x-examples":{"example-1":{"subscription_group":{"selection_options":{"platform_entity_ids":[]}}}},"properties":{"subscription_group":{"type":"object","required":["selection_options"],"properties":{"selection_options":{"type":"object","required":["platform_entity_ids"],"properties":{"platform_entity_ids":{"type":"array","description":"These are product ids we are look","items":{"type":"integer"}}}}}}},"required":["subscription_group"]},"examples":{"Example Body":{"value":{"subscription_group":{"selection_options":{"platform_entity_ids":[7021943390389,7003068956853,7014441746613]}}}}}}},"description":"Add one or more selection options to a subscription group. Right now the only supported selection option is product. A list of platform product IDs can be passed as platform_entity_ids."},"responses":{"200":{"description":"Successful operation"},"401":{"description":"Unauthorized"},"404":{"description":"Subscription group or selection option not found"}}}},"/subscriptions/v1/shops/{shop_identifier}/subscriptions/{subscription_id}/line_items/{line_item_id}/attributes":{"parameters":[{"$ref":"#/components/parameters/shop_identifier_path_param"},{"$ref":"#/components/parameters/subscription_id_path_param"},{"$ref":"#/components/parameters/line_item_id_path_param"}],"post":{"description":"Add a new set of attributes to a line item.","tags":["Subscription Line Items"],"summary":"Create Line Item Attributes","operationId":"CreateLineItemAttributes","responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"type":"object","properties":{"line_item_attributes":{"type":"array","items":{"$ref":"#/components/schemas/LineItemAttributeEntity"}}}},"examples":{"success-example":{"value":{"line_item_attributes":[{"name":"size_preference","value":"XL","created_at":"2021-01-17T20:30:40Z","updated_at":"2021-01-17T20:30:40Z","subscription_id":1,"line_item_id":1},{"name":"color_preference","value":"green","created_at":"2021-01-17T20:30:40Z","updated_at":"2021-01-17T20:30:40Z","subscription_id":1,"line_item_id":1}]}}}}}},"404":{"description":"Subscription or line item not found"}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"line_item_attributes":{"type":"array","items":{"$ref":"#/components/schemas/LineItemAttributeEntity"}}}},"examples":{"request-body-example":{"value":{"line_item_attributes":[{"name":"size_preference","value":"XL"},{"name":"color_preference","value":"green"}]}}}}}}},"patch":{"tags":["Subscription Line Items"],"summary":"Update Line Item Attributes","operationId":"UpdateLineItemAttributes","description":"Create, remove, or update attributes for a specific line item inside a subscription. Your request payload must contain the full list of attributes for the line item.\\n\\nTo add an attribute to the line item, include a new attribute in the request payload. To update an attribute that already exists on the line item, include the attribute in the payload with the same name and an updated value. To delete one attribute, leave the attribute out of the request payload. To remove all attributes of a line item, use an empty array as the request payload.","responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"type":"object","properties":{"subscription_line_item":{"$ref":"#/components/schemas/LineItemEntity"}}},"examples":{"success-example":{"value":{"subscription_line_item":{"id":1,"subscription_id":1,"platform_id":"ABC123","platform_product_id":"1357908642","platform_variant_id":"2468097531","subscription_group_id":1,"subscription_group_billing_rules_id":1,"title":"Monthly Expansion Pack","product_name":"Monthly Expansion Pack","variant_name":"Default Title","sku":"SKU-113-Red","url":"https://example-store.example.com/monthly-expansion-pack","image":"","quantity":1,"price":3500,"price_charged":3200,"discounted_price":3200,"discounted_price_charged":3200,"full_price":3200,"full_price_charged":3200,"requires_shipping":false,"grams":2200,"weight":2.2,"weight_unit":"kg","taxable":true,"discounts":[{"id":1,"subscription_line_item_id":1,"shop_id":5,"full_price":5,"discount_type":"percentage","percentage_value":10,"fixed_value":0,"fixed_value_charged":0,"description":"Subscription discount (10%) for Monthly Expansion Pack","created_at":"2019-11-20T20:31:55Z","updated_at":"2019-11-20T20:31:55Z","deleted_at":"2019-11-20T20:31:55Z"}],"prepaid_metadata":{"id":1,"line_item_id":2,"prepaid_duration":2,"current_recurrence_count":2,"prepaid_continue":"no_continue"},"line_item_attributes":[{"name":"size_preference","value":"XL","created_at":"2021-01-17T20:30:40Z","updated_at":"2021-01-17T20:30:40Z","subscription_id":1,"line_item_id":1},{"name":"color_preference","value":"green","created_at":"2021-01-17T20:30:40Z","updated_at":"2021-01-17T20:30:40Z","subscription_id":1,"line_item_id":1}],"created_at":"2019-11-20T20:31:55Z","updated_at":"2019-11-20T20:31:55Z"}}}}}}},"404":{"description":"Subscription or line item not found"}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"line_item_attributes":{"type":"array","items":{"$ref":"#/components/schemas/LineItemAttributeEntity"}}}},"examples":{"request-body-example":{"value":{"line_item_attributes":[{"name":"size_preference","value":"XL"},{"name":"color_preference","value":"green"}]}}}}}}}},"/subscriptions/v1/shops/{shop_identifier}/subscriptions/{subscription_id}/line_items/{line_item_id}/prepaid_metadata":{"parameters":[{"$ref":"#/components/parameters/shop_identifier_path_param"},{"$ref":"#/components/parameters/subscription_id_path_param"},{"$ref":"#/components/parameters/line_item_id_path_param"}],"post":{"tags":["Subscription Line Items"],"summary":"Create Line Item Prepaid Metadata","operationId":"CreateLineItemPrepaidMetadata","description":"Add prepaid metadata to a line item to convert a subscription to prepaid. Adding this metadata to one line item converts the whole order to prepaid.\\n\\n**Note:** Converting a subscription to prepaid does not automatically charge the customer for the balance of the prepaid subscription. To charge the customer the prepaid subscription amount on the next recurrence, set `prepaid_duration` to the same value as `prepaid_recurrence_count`, and set `prepaid_continue` to `as_prepaid`. This causes Bold to start a new prepaid subscription on the next recurrence and set the `prepaid_recurrence_count` back to `1`.","responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"type":"object","properties":{"prepaid_metadata":{"$ref":"#/components/schemas/PrepaidMetadataEntity"}}},"examples":{"success-example":{"value":{"prepaid_metadata":{"id":1,"line_item_id":2,"prepaid_duration":2,"current_recurrence_count":2,"prepaid_continue":"no_continue"}}}}}}},"404":{"description":"Subscription or Line Item Not Found"}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"prepaid_metadata":{"$ref":"#/components/schemas/PrepaidMetadataEntity"}}},"examples":{"request-body-example":{"value":{"prepaid_metadata":{"prepaid_continue":"as_prepaid","prepaid_duration":6,"current_recurrence_count":6}}}}}}}},"patch":{"summary":"Update Line Item Prepaid Metadata","operationId":"UpdateLineItemPrepaidMetadata","tags":["Subscription Line Items"],"description":"Update or create new prepaid metadata for a line item.\\n\\n**Note:** Updating the `prepaid_duration` or `current_recurrence_count` does not result in any automatic charges or change in charges to an existing prepaid customer. Adding new prepaid metadata to a subscription converts it to prepaid. For more information on converting a subscription to prepaid, refer to the [Create Line Item Prepaid Metadata](/api/subscriptions#tag/Subscriptions#operation/CreateLineItemPrepaidMetadata) endpoint.","responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"type":"object","properties":{"prepaid_metadata":{"$ref":"#/components/schemas/PrepaidMetadataEntity"}}},"examples":{"success-example":{"value":{"prepaid_metadata":{"id":1,"line_item_id":2,"prepaid_duration":2,"current_recurrence_count":2,"prepaid_continue":"no_continue"}}}}}}},"404":{"description":"Subscription or Line Item Not Found"}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"prepaid_metadata":{"$ref":"#/components/schemas/PrepaidMetadataEntity"}}},"examples":{"request-body-example":{"value":{"prepaid_metadata":{"prepaid_continue":"no_continue","prepaid_duration":6,"current_recurrence_count":6}}}}}}}}}},"components":{"securitySchemes":{"OAuthToken":{"type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"https://apps.boldapps.net/accounts/dashboard/authorize","tokenUrl":"https://api.boldcommerce.com/auth/oauth2/token","scopes":{}}},"description":"Authenticates an API request from a [public integration](/guides/subscriptions-v2/resources/glossary#public-integration). Generate this token in the [Developer Dashboard](https://developer-dashboard.boldcommerce.com/default/dashboard). Refer to [Build Public Integrations](/guides/subscriptions-v2/public-integrations) for more information."},"APIAccessToken":{"type":"apiKey","name":"API Access Token","in":"header","description":"Authenticates an API request from a [private integration](/guides/subscriptions-v2/resources/glossary#private-integration). Generate this token in the [Bold Account Center](https://account.boldcommerce.com/). Refer to [Making API Calls](/guides/subscriptions-v2/quick-start) for more information."}},"schemas":{"BillingRuleEntity":{"type":"object","title":"","properties":{"id":{"type":"integer","example":1,"readOnly":true},"shop_id":{"type":"integer","example":1,"readOnly":true},"subscription_group_id":{"type":"integer","example":1,"readOnly":true},"interval_number":{"type":"integer","example":1},"interval_type":{"type":"string","example":"month","enum":["custom","day","week","month","year"]},"interval_name":{"type":"string","example":"Monthly","maxLength":255},"week_type":{"type":"string","example":"","enum":["purchase_day","each",""]},"week_day":{"type":"integer","example":0,"description":"Sets day of week when paired with week_type=each. Valid values are SU, MO, TU, WE, TH, FR, and SA. Can be comma separated list."},"month_type":{"type":"string","example":"purchase_day","enum":["purchase_day","each","on_the",""]},"month_day":{"type":"string","example":"","description":"Sets the day of the month when combined with month_type=each. Numbers in range 1-31. Can be comma separated list of numbers."},"month_occurrence":{"type":"string","example":"","enum":["first","second","third","fourth","fifth","last",""]},"month_occurrence_day":{"type":"string","example":"MO","description":"Sets day of week when paired with month_occurence=on_the. Valid values are SU, MO, TU, WE, TH, FR, SA, day, business_day, weekend_day. Can be comma separated list."},"year_type":{"type":"string","enum":["purchase_day","on_the",""]},"year_month":{"type":"string","example":"","description":"Sets month of year when combined with year_type=on_the. Valid values between 1-12. Can be comma separated list."},"year_occurrence":{"type":"string","example":"","enum":["first","second","third","fourth","fifth","last",""]},"year_occurrence_day":{"type":"string","example":"","description":"Sets day of week when paired with year_occurence. Valid values are SU, MO, TU, WE, TH, FR, SA, day, business_day, weekend_day. Can be comma separated list."},"billing_rule":{"type":"string","example":"FREQ=MONTHLY"},"created_at":{"type":"string","readOnly":true,"example":"2019-11-20T20:31:55Z","format":"date-time"},"updated_at":{"type":"string","readOnly":true,"example":"2019-11-20T20:31:55Z","format":"date-time"},"deleted_at":{"type":"string","example":null,"readOnly":true,"format":"date-time","nullable":true},"custom_billing_rule":{"type":"string","description":"A custom RRULE for the subscription group"},"buffer_days":{"type":"integer","minimum":0,"maximum":365},"buffer_time":{"type":"string","format":"time","example":"01:00:00","description":"Time is in format HH:mm:ss"}}},"Customers":{"properties":{"customers":{"type":"array","items":{"$ref":"#/components/schemas/CustomerEntity"}}},"type":"object"},"Customer":{"properties":{"customer":{"$ref":"#/components/schemas/CustomerEntity"}},"type":"object"},"CustomerEntity":{"type":"object","required":["id","platform_id","cashier_public_id","first_name","last_name","phone","email","notes","addresses","default_address","subscription_summary","labels","created_at"],"properties":{"id":{"description":"The customer ID.","type":"integer","readOnly":true,"example":2},"platform_id":{"description":"The customer platform ID.","type":"string","readOnly":true,"example":"123456790"},"cashier_public_id":{"type":"string","description":"The public customer ID generated when using Bold Checkout, set to `null` otherwise.","example":null,"nullable":true,"readOnly":true},"first_name":{"type":"string","description":"The customer\'s first name.","example":"Jane"},"last_name":{"type":"string","description":"The customer\'s last name.","example":"Doe"},"email":{"type":"string","description":"The customer\'s email","example":"jane.doe@example.com"},"phone":{"type":"string","description":"The customer\'s phone number. For Shopify checkout users, [you can configure phone number requirements in the admin](/guides/subscriptions-v2/create-subscription#how-do-i-make-phone-numbers-optional-when-using-shopify-checkout).","example":"12045551234"},"notes":{"type":"string","description":"The customer\'s internal notes. This is applied as a note in the **Customer info** section of Bold Subscriptions admin.","example":"Loyal customer"},"addresses":{"type":"array","items":{"$ref":"#/components/schemas/CustomerAddressEntity"},"readOnly":true},"default_address":{"description":"The customer\'s default address.","readOnly":true,"allOf":[{"$ref":"#/components/schemas/CustomerAddressEntity"}]},"subscription_summary":{"readOnly":true,"allOf":[{"$ref":"#/components/schemas/CustomerSubscriptionSummary"}]},"labels":{"type":"array","items":{"$ref":"#/components/schemas/CustomerLabel"},"readOnly":true},"created_at":{"$ref":"#/components/schemas/createdAt"}}},"CustomerSubscriptionSummary":{"type":"object","required":["bold_platform_customer_id","next_order_date","last_order_date","active_subscription_count","inactive_subscription_count","subscription_order_count","lifetime_value_usd"],"description":"Summary of the customer\'s subscriptions.","properties":{"bold_platform_customer_id":{"type":"integer","description":"The customer\'s ID.","example":2,"readOnly":true},"next_order_date":{"type":"string","description":"The cext order date and time for the subscription.","example":"2020-01-20T18:00:00Z","readOnly":true},"last_order_date":{"type":"string","description":"The most recent order date and time for a subscription.","example":"2019-11-20T20:55:27Z","readOnly":true},"active_subscription_count":{"type":"integer","description":"The number of active subscriptions.","example":2,"readOnly":true},"inactive_subscription_count":{"type":"integer","description":"The number of inactive subscriptions.","example":1,"readOnly":true},"subscription_order_count":{"type":"integer","description":"The number of subscription orders for this customer. Initial orders count toward this total.","example":5,"readOnly":true},"lifetime_value_usd":{"type":"number","description":"The total value of the order made by this customer in USD.","example":152.12,"readOnly":true}}},"CustomerAddressEntity":{"type":"object","required":["id","shop_identifier","platform_id","customer_id","platform_type","platform_customer_id","first_name","last_name","company","phone","street1","street2","city","province","province_code","country","country_code","zip","is_default","address_use","address_source","created_at","updated_at","deleted_at"],"properties":{"id":{"type":"integer","description":"The address ID.","readOnly":true,"example":1},"shop_identifier":{"type":"string","description":"The platform shop identifier.","readOnly":true,"example":"12345"},"platform_id":{"type":"string","description":"The platform address identifier.","readOnly":true,"example":"14"},"customer_id":{"type":"integer","description":"The customer ID.","readOnly":true,"example":2},"platform_type":{"type":"string","enum":["bigcommerce","commercetools","custom","shopify","woocommerce"],"description":"The e-commerce platform being used by the shop (might also be \'custom\' for no specific e-commerce platform).","readOnly":true,"example":"shopify"},"platform_customer_id":{"type":"string","readOnly":true,"description":"The ID of the customer on the platform.","example":"35"},"first_name":{"type":"string","description":"The customer\'s first name.","example":"John"},"last_name":{"type":"string","description":"The customer\'s last name(s).","example":"Doe"},"company":{"type":"string","description":"The customer\'s company name.","example":"Example Company"},"phone":{"type":"string","description":"The customer\'s phone number.","example":"123-456-7890"},"street1":{"type":"string","description":"The customer\'s street address (street name and number).","example":"123 example st."},"street2":{"type":"string","description":"The address complement (suite number, unit number, etc.).","example":"101"},"city":{"type":"string","description":"The customer\'s city.","example":"Toronto"},"province":{"type":"string","description":"The customer\'s province or state, as applicable. Can be an empty string in case the address has no state/province.","example":"Ontario"},"province_code":{"type":"string","description":"The customer\'s province or state code (usually 2 characters), as applicable. Can be an empty string in case the address has no state/province.","example":"ON"},"country":{"type":"string","description":"The customer\'s country name.","example":"Canada"},"country_code":{"type":"string","description":"The customer\'s alpha 2 country code, according to ISO 3166-1 (reference: https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2).","example":"CA"},"zip":{"type":"string","description":"The customer\'s postal code.","example":"M5V 3L9"},"is_default":{"type":"boolean","description":"Defines if this address should be considered the default one for the customer.","example":true},"address_use":{"type":"string","nullable":true,"description":"The address usage (billing, shipping). Only set for WooCommerce, `null` otherwise.","example":"billing"},"address_source":{"type":"string","description":"The address source.","enum":["platform","bold"],"readOnly":true,"example":"platform"},"created_at":{"$ref":"#/components/schemas/createdAt"},"updated_at":{"$ref":"#/components/schemas/updatedAt"},"deleted_at":{"$ref":"#/components/schemas/deletedAt"}}},"UpdateCustomerAddressEntity":{"type":"object","required":["first_name","last_name","phone","street1","city","province","province_code","country","country_code","zip"],"properties":{"first_name":{"type":"string","description":"Customer\'s first name.","example":"John"},"last_name":{"type":"string","description":"Customer\'s last name(s).","example":"Doe"},"company":{"type":"string","description":"Customer\'s company name.","example":"Example Company"},"phone":{"type":"string","description":"Customer\'s phone number.","example":"123-456-7890"},"street1":{"type":"string","description":"Customer\'s street address (street name and number).","example":"123 example st."},"street2":{"type":"string","description":"Address complement (suite number, unit number, etc.).","example":"101"},"city":{"type":"string","description":"Customer\'s city.","example":"Toronto"},"province":{"type":"string","description":"Customer\'s province or state, as applicable. Can be an empty string in case the address has no state/province.","example":"Ontario"},"province_code":{"type":"string","description":"Customer\'s province or state code (usually 2 characters), as applicable. If the address has no state/province, leave empty.","example":"ON"},"country":{"type":"string","description":"Customer\'s country name.","example":"Canada"},"country_code":{"type":"string","description":"Customer\'s alpha 2 country code, according to ISO 3166-1 (reference: https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2).","example":"CA"},"zip":{"type":"string","description":"Customer\'s postal code.","example":"M5V 3L9"},"is_default":{"type":"boolean","description":"Indicates whether this address should be considered the default one for the customer.","example":true},"address_use":{"type":"string","description":"Address usage (billing, shipping). Only set for WooCommerce."}}},"CustomerLabel":{"type":"object","description":"The label assigned to a customer.","required":["id","name","created_at","updated_at","deleted_at"],"properties":{"id":{"type":"integer","description":"The customer label ID.","example":12,"readOnly":true},"customer_id":{"type":"integer","description":"The customer ID.","example":21,"readOnly":true},"name":{"type":"string","description":"The content of the label.","example":"bsub_subscription_active"},"created_at":{"$ref":"#/components/schemas/createdAt"},"updated_at":{"$ref":"#/components/schemas/updatedAt"},"deleted_at":{"readOnly":true,"allOf":[{"$ref":"#/components/schemas/deletedAt"}]}}},"FutureOrders":{"properties":{"future_orders":{"type":"array","items":{"$ref":"#/components/schemas/FutureOrderEntity"}},"pagination":{"$ref":"#/components/schemas/FutureOrdersCursorPagination"}},"type":"object"},"UnauthenticatedResponse":{"type":"object","properties":{"error":{"type":"string","description":"The error summary.","example":"invalid_request"},"error_description":{"type":"string","description":"The detailed error message.","example":"The access token is missing"}},"example":{"error":"invalid_request","error_description":"The access token is missing"}},"FutureOrderEntity":{"properties":{"id":{"type":"string","description":"The unique identifier of the future order in the format `{subscription_id}-{order_date}`, where `{order_date}` uses [RFC 3339 format](https://www.ietf.org/rfc/rfc3339.txt).","example":"53236-2024-05-21T08:00:00Z"},"date":{"type":"string","description":"The date and time of the future order, in [RFC 3339 format](https://www.ietf.org/rfc/rfc3339.txt).","example":"2024-05-21T08:00:00Z"},"bold_customer_id":{"type":"integer","description":"The ID for the customer associated with the future order.","example":1697912},"bold_platform_subscription_id":{"type":"integer","description":"The ID of the subscription associated with the future order.","example":4712349},"currency":{"type":"string","description":"The currency used for the future order, in [ISO-4217](https://www.iso.org/iso-4217-currency-codes.html) format.","example":"USD"},"order_count":{"type":"integer","description":"The number (\\"n\\") indicates the future order will be the nth order for the subscription. The value will be `null` if the future order is skipped. Example: `order_count: 6` means the future order is the 6th order for the subscription.","example":6,"nullable":true},"subscription_data":{"type":"object","description":"Details on the subscription associated with the future order.","properties":{"id":{"type":"integer","description":"The ID of the subscription associated with the future order.","example":4712349},"order_count":{"type":"integer","description":"The number of orders currently processed by the subscription associated with the future order.","example":2},"discount_code":{"type":"string","description":"The discount code currently on the subscription. The value is an empty string `\\"\\"` if no discount is applied.","example":"BOXINGDAYSUB"},"order_rrule":{"type":"string","description":"An RRULE describing how frequently orders are processed for the subscription. Learn more about [RRULEs](https://support.boldcommerce.com/hc/en-us/articles/360045174132-Use-RRULES-in-Bold-Subscriptions).","example":"DTSTART:20210521T080000Z\\nRRULE:FREQ=MONTHLY"},"base_currency":{"type":"string","description":"The base currency of the subscription, in [ISO 4217 format](https://www.iso.org/iso-4217-currency-codes.html). This aligns with the store\'s platform configuration for primary currency when the subscription was placed, unless later modified.","example":"CAD"},"charged_currency":{"type":"string","description":"The currency the customer is charged in, in [ISO 4217 format](https://www.iso.org/iso-4217-currency-codes.html).","example":"USD"},"base_to_charged_exchange_rate":{"type":"number","description":"The exchange rate from the subscription\'s base currency to the charged currency.","example":0.79},"placed_at":{"type":"string","description":"The date and time the subscription was placed by the customer, in [RFC 3339 format](https://www.ietf.org/rfc/rfc3339.txt). For programmatically created or migrated subscriptions this value may be `null`.","nullable":true,"example":"2024-02-21T08:00:00Z"}}},"is_skipped":{"type":"boolean","description":"Indicates if the future order is set to be skipped.","example":false},"customer":{"$ref":"#/components/schemas/Customer"},"adjustments":{"type":"array","description":"The list of subscription adjustments with target \\"order\\" to apply to the future order. `adjustments` is `null` if there are no adjustments to return.","nullable":true,"minItems":0,"items":{"$ref":"#/components/schemas/SubscriptionAdjustment"}},"line_items":{"type":"array","minItems":0,"description":"The line items in the future order.","items":{"$ref":"#/components/schemas/FutureOrderLineItemEntity"}},"shipping_lines":{"type":"array","description":"The shipping lines for the future order.\\n\\n**Note:** Shipping lines may differ at time of processing. List available shipping lines with the Checkout Frontend [List Shipping Lines endpoint](https://developer.boldcommerce.com/default/api/checkout#tag/Shipping-Lines/operation/ListShippingLines).","items":{"$ref":"#/components/schemas/ShippingLineEntity"}},"billing_address":{"$ref":"#/components/schemas/CustomerAddressEntity"},"shipping_address":{"type":"object","nullable":true,"allOf":[{"$ref":"#/components/schemas/CustomerAddressEntity"}]}},"type":"object","readOnly":true},"FutureOrderLineItemEntity":{"type":"object","properties":{"future_order_id":{"type":"string","description":"The unique identifier of the future order in the format `{subscription_id}-{order_date}`, where `{order_date}` uses [RFC 3339 format](https://www.ietf.org/rfc/rfc3339.txt).","example":"53236-2024-05-21T08:00:00Z"},"bold_platform_subscription_id":{"type":"integer","description":"The ID of the subscription associated with this line item.","example":4712349},"bold_platform_subscription_line_item_id":{"type":"integer","description":"The ID of the subscription line item. If a line item is created from a future adjustment, `bold_subscription_line_item_id` is set to `null`.","example":643723,"nullable":true},"adjustment_id":{"type":"integer","description":"The ID of the subscription adjustment adding this line item to the order, if applicable.","example":36217,"nullable":true},"platform_id":{"type":"string","description":"When applicable, the unique ID of the line item on the platform subscription.","example":"6434329530","nullable":true},"platform_product_id":{"type":"string","description":"The platform-specific product ID.","example":"478723258026"},"platform_variant_id":{"type":"string","description":"The platform-specific variant ID.","example":"92183258642"},"title":{"type":"string","description":"The title of the line item including both product and variant names.","example":"Roaster\'s Choice - 2lb"},"product_name":{"type":"string","description":"The name of the product.","example":"Roaster\'s Choice"},"variant_name":{"type":"string","description":"The name of the variant.","example":"2lb"},"sku":{"type":"string","description":"The SKU of the product variant.","example":"RC-2LB"},"url":{"type":"string","description":"The URL of the product on the storefront.","example":"/products/roasters-choice"},"image":{"type":"string","description":"The platform image URL for the line item.","example":"https://cdn.shopify.com/s/files/1/6332/09823/products/roasters-choice.png?v=1555362485"},"quantity":{"type":"integer","description":"The quantity of the line item in the future order.","example":3},"price":{"type":"integer","description":"The price of this line item within the subscription, in the base unit (e.g., cents) of the `charged_currency` for this subscription. Example: a value of `1000` in a USD currency corresponds to a $10.00 USD per-unit price on the line item.","example":1000},"requires_shipping":{"type":"boolean","description":"Indicates whether this line item is subject to applicable shipping fees.","example":true},"grams":{"type":"integer","description":"The weight of a single unit of the line item in grams.","example":1043},"weight":{"type":"number","description":"The weight of a single unit of the line item, measured in `weight_unit`.","example":2.3},"weight_unit":{"type":"string","description":"Indicates the unit of measurement reflected by the `weight` field.","example":"lb"},"taxable":{"type":"boolean","description":"Indicates whether the line item is subject to applicable taxes.","example":true},"line_item_attributes":{"type":"array","minItems":0,"items":{"$ref":"#/components/schemas/LineItemAttributeEntity"}},"prepaid_metadata":{"nullable":true,"type":"object","allOf":[{"$ref":"#/components/schemas/FutureOrderLineItemPrepaidMetadataEntity"}]},"subscription_group_id":{"type":"integer","description":"The ID of the subscription group that contains this line item\'s product.","example":36236,"nullable":true},"subscription_group_billing_rules_id":{"type":"integer","description":"The ID of the subscription group billing rule associated with the subscription\'s order frequency.","example":78365,"nullable":true},"discounts":{"type":"array","minItems":0,"items":{"$ref":"#/components/schemas/LineItemDiscountEntity"}}}},"Intervals":{"properties":{"intervals":{"type":"array","items":{"$ref":"#/components/schemas/IntervalEntity"}}},"type":"object"},"IntervalEntity":{"properties":{"interval_number":{"type":"integer","example":1},"interval_type":{"type":"string","enum":["month","week","day","year","custom"],"example":"month"},"week_type":{"type":"string","enum":["","purchase_day","each"],"example":"each"},"week_day":{"type":"string","enum":["","FR","MO","SA","SU","TH","TU","WE"],"example":"MO"},"month_type":{"type":"string","enum":["","purchase_day","each","on_the"],"example":"purchase_day"},"month_day":{"type":"string","example":"15"},"month_occurrence":{"type":"string","enum":["last","second","first","fourth","third",""],"example":"first"},"month_occurrence_day":{"type":"string","enum":["","FR","MO","SA","SU","TH","TU","WE","business_day"],"example":"MO"},"year_type":{"type":"string","enum":["","purchase_day","on_the"],"example":"on_the"},"year_month":{"type":"string","example":"6"},"year_occurrence":{"type":"string","example":"first"},"year_occurrence_day":{"type":"string","enum":["","FR","MO","SA","SU","TH","TU","WE"],"example":"FR"},"interval_name":{"type":"string","example":"Monthly"},"id":{"type":"integer","readOnly":true,"example":1},"billing_rule":{"type":"string","example":"DTSTART:20191120T205526Z\\\\nRRULE:FREQ=MONTHLY"}},"type":"object","readOnly":true},"LineItemEntity":{"type":"object","title":"","properties":{"id":{"type":"integer","example":1,"nullable":true},"subscription_id":{"type":"integer","example":1,"nullable":true},"platform_id":{"type":"string","example":"ABC123","nullable":true},"platform_product_id":{"type":"string","example":"1357908642","nullable":true},"platform_variant_id":{"type":"string","example":"2468097531","nullable":true},"subscription_group_id":{"type":"integer","example":1,"nullable":true},"subscription_group_billing_rules_id":{"type":"integer","example":1,"nullable":true},"title":{"type":"string","example":"Monthly Expansion Pack"},"product_name":{"type":"string","example":"Monthly Expansion Pack","nullable":true},"variant_name":{"type":"string","example":"Default Title","nullable":true},"sku":{"type":"string","example":"SKU-113-Red"},"url":{"type":"string","example":"https://example-store.example.com/monthly-expansion-pack"},"image":{"type":"string","example":"","nullable":true},"quantity":{"type":"integer","example":1},"price":{"type":"integer","example":3500},"price_charged":{"type":"integer","example":3200,"nullable":true},"discounted_price":{"type":"integer","example":3200},"discounted_price_charged":{"type":"integer","example":3200},"full_price":{"type":"integer","example":3200,"nullable":true},"full_price_charged":{"type":"integer","example":3200,"nullable":true},"requires_shipping":{"type":"boolean","example":false},"grams":{"type":"integer","example":2200},"weight":{"type":"number","example":2.2},"weight_unit":{"type":"string","example":"kg"},"taxable":{"type":"boolean","example":true},"discounts":{"type":"array","items":{"$ref":"#/components/schemas/LineItemDiscountEntity"},"readOnly":true},"prepaid_metadata":{"type":"object","required":["id","line_item_id","prepaid_duration","current_recurrence_count","prepaid_continue"],"nullable":true,"properties":{"id":{"type":"integer","example":1,"nullable":true},"line_item_id":{"type":"integer","example":2,"nullable":true},"prepaid_duration":{"type":"integer","example":2},"current_recurrence_count":{"type":"integer","example":2},"prepaid_continue":{"type":"string","enum":["no_continue","as_prepaid","as_standard"]}}},"line_item_attributes":{"type":"array","items":{"$ref":"#/components/schemas/LineItemAttributeEntity"}},"created_at":{"type":"string","example":"2019-11-20T20:31:55Z","format":"date-time","readOnly":true},"updated_at":{"type":"string","example":"2019-11-20T20:31:55Z","format":"date-time","readOnly":true,"nullable":true}},"required":["id","subscription_id","platform_id","platform_product_id","platform_variant_id","subscription_group_id","subscription_group_billing_rules_id","title","product_name","variant_name","sku","url","image","quantity","price","price_charged","discounted_price","discounted_price_charged","full_price","requires_shipping","grams","weight","weight_unit","taxable","discounts","prepaid_metadata","created_at","updated_at"],"readOnly":true},"UpdateLineItemEntity":{"type":"object","title":"","properties":{"id":{"type":"integer","example":1,"nullable":true},"subscription_id":{"type":"integer","example":1,"nullable":true},"platform_id":{"type":"string","example":"ABC123"},"platform_product_id":{"type":"string","example":"1357908642","nullable":true},"platform_variant_id":{"type":"string","example":"2468097531","nullable":true},"subscription_group_id":{"type":"integer","example":1},"subscription_group_billing_rules_id":{"type":"integer","example":1,"nullable":true},"title":{"type":"string","example":"Monthly Expansion Pack"},"product_name":{"example":null,"nullable":true,"description":"Always returns `null`."},"variant_name":{"example":null,"nullable":true,"description":"Always returns `null`."},"sku":{"type":"string","example":"SKU-113-Red"},"url":{"type":"string","example":"https://example-store.example.com/monthly-expansion-pack"},"image":{"type":"string","example":""},"quantity":{"type":"integer","example":1},"price":{"type":"integer","example":3500},"price_charged":{"type":"integer","example":3200,"nullable":true},"discounted_price":{"type":"integer","example":3200},"discounted_price_charged":{"type":"integer","example":3200},"full_price":{"type":"integer","example":3200},"full_price_charged":{"type":"integer","example":3200},"requires_shipping":{"type":"boolean","example":false},"grams":{"type":"integer","example":2200},"weight":{"type":"number","example":2.2},"weight_unit":{"type":"string","example":"kg"},"taxable":{"type":"boolean","example":true},"discounts":{"type":"array","items":{"$ref":"#/components/schemas/LineItemDiscountEntity"},"readOnly":true},"prepaid_metadata":{"type":"object","required":["id","line_item_id","prepaid_duration","current_recurrence_count","prepaid_continue"],"nullable":true,"properties":{"id":{"type":"integer","example":1,"nullable":true},"line_item_id":{"type":"integer","example":2,"nullable":true},"prepaid_duration":{"type":"integer","example":2},"current_recurrence_count":{"type":"integer","example":2},"prepaid_continue":{"type":"string","enum":["no_continue","as_prepaid","as_standard"]}}},"line_item_attributes":{"type":"array","items":{"$ref":"#/components/schemas/LineItemAttributeEntity"}},"created_at":{"type":"string","example":"2019-11-20T20:31:55Z","format":"date-time","readOnly":true},"updated_at":{"type":"string","example":"2019-11-20T20:31:55Z","format":"date-time","readOnly":true}},"required":["id","subscription_id","platform_id","platform_product_id","platform_variant_id","subscription_group_id","subscription_group_billing_rules_id","title","product_name","variant_name","sku","url","image","quantity","price","price_charged","discounted_price","discounted_price_charged","full_price","requires_shipping","grams","weight","weight_unit","taxable","discounts","prepaid_metadata","created_at","updated_at"],"readOnly":true},"LineItemAttributeEntity":{"title":"LineItemAttributeEntity","type":"object","description":"This represents a custom field that can be defined and used to store complementary information about a subscription line item.","properties":{"name":{"type":"string","example":"size_preference","description":"The name of the custom field/attribute, up to 250 characters."},"value":{"type":"string","example":"XL","description":"The content of the custom field/attribute."},"created_at":{"type":"string","format":"date-time","description":"The date (in [RFC3339 format](https://datatracker.ietf.org/doc/html/rfc3339)) that this line item attribute was created.","example":"2021-01-17T20:30:40Z","readOnly":true},"updated_at":{"type":"string","format":"date-time","description":"The date (in [RFC3339 format](https://datatracker.ietf.org/doc/html/rfc3339)) that this line item attribute was last updated. The value is the same as the `created_at` value if the line item attribute has never been updated.","example":"2021-01-17T20:30:40Z","readOnly":true},"subscription_id":{"description":"The ID of the subscription associated to this line item attribute.","type":"integer","readOnly":true,"example":435989},"line_item_id":{"description":"The ID of the subscription line item this line item attribute belongs to.","type":"integer","readOnly":true,"example":45734}}},"PrepaidMetadataEntity":{"type":"object","properties":{"id":{"description":"The ID of the prepaid metadata.","type":"integer","example":1},"line_item_id":{"description":"The ID of the subscription line item this prepaid metadata belongs to.","type":"integer","example":1},"prepaid_continue":{"description":"The behavior of the subscription once the number of recurrences has reached the `prepaid_duration`.\\n * `no_continue`: The subscription will be cancelled.\\n * `as_prepaid` : The customer will be charged for new set of order recurrences on the next recurrence.\\n * `as_standard`: The subscription will be converted to a standard subscription, where the customer is charged for one order at each recurrence.","type":"string","enum":["no_continue","as_prepaid","as_standard"],"example":"as_prepaid"},"prepaid_duration":{"description":"The number of subscription recurrences that have been prepaid.","type":"integer","example":6},"current_recurrence_count":{"description":"The number of subscription recurrences that have occurred.","type":"integer","example":6}},"required":["prepaid_continue","prepaid_duration","current_recurrence_count"]},"FutureOrderLineItemPrepaidMetadataEntity":{"type":"object","properties":{"prepaid_continue":{"description":"The behavior of the subscription once the number of recurrences has reached the `prepaid_duration`.\\n * `no_continue`: The subscription will be cancelled.\\n * `as_prepaid` : The customer will be charged for new set of order recurrences on the next recurrence.\\n * `as_standard`: The subscription will be converted to a standard subscription, where the customer is charged for one order at each recurrence.","type":"string","enum":["no_continue","as_prepaid","as_standard"],"example":"as_prepaid"},"prepaid_duration":{"description":"The number of subscription recurrences that get prepaid for in a cycle.","type":"integer","example":6},"recurrence_count":{"description":"Indicates which recurrence of the prepaid cycle the future order will be.","type":"integer","example":1},"requires_payment":{"description":"Indicates whether the line item and associated subscription will be charged for a full prepaid cycle. When payment is required, the line item price and shipping line prices of the future order will be multiplied by the appropriate prepaid duration. When payment is required and no other standard line items are present then prices will be 0.","type":"boolean","example":true}}},"LineItemDiscountEntity":{"type":"object","properties":{"id":{"type":"integer","description":"The ID of the line item discount.","example":1,"nullable":true},"subscription_line_item_id":{"type":"integer","description":"The ID of the subscription line item the discount belongs to.","example":1,"nullable":true},"shop_id":{"type":"integer","description":"The ID of the shop.","example":5},"full_price":{"type":"integer","description":"The price of the subscription line item without this discount applied.","example":5,"nullable":true},"discount_type":{"type":"string","description":"The type of discount being applied to the subscription line item.","enum":["percentage","fixed","no_discount"],"example":"percentage"},"percentage_value":{"type":"number","description":"The percent discount to apply to the line item price in a range of 0 - 100. Only applied when the value for `discount_type` is `percentage`. For example, a value of `12.5` will discount the line item by 12.5%.","example":10},"fixed_value":{"type":"integer","description":"The discount amount in base currency units (e.g. cents). Only applied when the value for `discount_type` is `fixed`. For example, a value of `575` on a subscription with a base currency of USD will discount the line item by $5.75 USD.","example":0},"fixed_value_charged":{"type":"integer","description":"The discount amount in base currency units (e.g. cents) of the subscription\'s `charged_currency`. Only applied when the value for `discount_type` is `fixed`. This value is derived from the `fixed_value` and the subscription\'s currency properties. For example, with a `fixed_value` of 575, a base currency of USD, a charged currency of CAD, and an exchange rate of 1.5, this value would be 575 * 1.5 = `863`.","example":0},"description":{"type":"string","description":"A description of the discount to show to the customer.","example":"Subscription discount (10%) for Monthly Expansion Pack"},"created_at":{"type":"string","example":"2019-11-20T20:31:55Z","format":"date-time","description":"The date (in [RFC3339 format](https://datatracker.ietf.org/doc/html/rfc3339)) that this discount added to the subscription line item.","nullable":true,"readOnly":true},"updated_at":{"type":"string","example":"2019-11-20T20:31:55Z","format":"date-time","description":"The date (in [RFC3339 format](https://datatracker.ietf.org/doc/html/rfc3339)) that this discount was last updated. The value is the same as the `created_at` value if the discount has never been updated.","nullable":true,"readOnly":true},"deleted_at":{"type":"string","example":"2019-11-20T20:31:55Z","format":"date-time","description":"The date (in [RFC3339 format](https://datatracker.ietf.org/doc/html/rfc3339)) that this discount was removed from the subscription line item. The value is null if the discount has never been deleted.","nullable":true,"readOnly":true}},"required":["id","subscription_line_item_id","shop_id","full_price","discount_type","percentage_value","fixed_value","fixed_value_charged","description","created_at","updated_at","deleted_at"],"readOnly":true},"OrderEntity":{"type":"object","x-examples":{},"title":"","properties":{"id":{"type":"integer","example":185490},"platform_id":{"type":"integer","example":1},"platform_customer_id":{"type":"integer","example":123},"shop_identifier":{"type":"string","example":"zya0kzb8hu"},"line_items":{"type":"array","items":{"$ref":"#/components/schemas/LineItemEntity"}},"billing_address":{"nullable":true,"description":"Orders that were deleted from the platform won\'t have address information available.","type":"object","allOf":[{"$ref":"#/components/schemas/CustomerAddressEntity"}]},"shipping_addresses":{"nullable":true,"description":"Orders that were deleted from the platform won\'t have address information available.","type":"array","items":{"$ref":"#/components/schemas/CustomerAddressEntity"}},"subtotal":{"type":"integer","example":1337},"subtotal_charged":{"type":"integer","example":1337},"subtotal_tax":{"type":"integer","example":144},"subtotal_tax_charged":{"type":"integer","example":144},"shipping_subtotal":{"example":1000,"type":"integer"},"shipping_subtotal_charged":{"type":"integer","example":1000},"shipping_tax":{"example":0,"type":"integer"},"shipping_tax_charged":{"example":0,"type":"integer"},"total":{"example":2204,"type":"integer"},"total_charged":{"example":2204,"type":"integer"},"total_tax":{"example":144,"type":"integer"},"total_tax_charged":{"example":144,"type":"integer"},"fulfillment_status":{"type":"string","example":"pending"},"source":{"type":"string"},"payment_method":{"type":"string","example":"Shopify Payments"},"payment_method_details":{"nullable":true,"type":"object","allOf":[{"$ref":"#/components/schemas/PaymentMethodEntity"}]},"shipping_method":{"type":"string","example":"Subscription shipping"},"shipping_rates":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer","nullable":true},"bold_subscription_id":{"type":"number","nullable":true},"name":{"type":"string"},"code":{"type":"string","nullable":true},"price":{"type":"integer"},"price_charged":{"type":"integer","nullable":true},"value":{"type":"integer"},"value_charged":{"type":"integer","nullable":true},"tag":{"type":"string","nullable":true},"hash":{"type":"string","nullable":true}},"required":["id","bold_subscription_id","name","code","price","price_charged","value","value_charged","tag","hash"]}},"tax_lines":{"type":"array","items":{"type":"object","properties":{"amount":{"type":"integer"},"amount_charged":{"type":"integer"},"name":{"type":"string","nullable":true},"rate":{"type":"number","nullable":true}},"required":["amount","amount_charged","name","rate"]}},"discounts":{"type":"array","items":{"type":"object","properties":{"discount_percentage":{"type":"integer","example":10,"nullable":true},"discount_type":{"type":"string","enum":["percentage","fixed","no_discount"],"example":"percentage","nullable":true},"text":{"type":"string","example":"10PERCENTOFF","nullable":true,"readOnly":true},"value":{"type":"integer"},"value_charged":{"type":"integer"}},"required":["discount_percentage","discount_type","text","value","value_charged"]}},"order_number":{"type":"integer","example":0},"currency":{"type":"string","example":"CAD"},"currency_charged":{"type":"string"},"currency_format":{"type":"string"},"currency_format_charged":{"type":"string"},"exchange_rate":{"type":"number","nullable":true},"test":{"type":"boolean","example":false},"url":{"type":"string","example":"https://example-store.example.com/account.php?action=view_order&order_id=1"},"updated_at":{"type":"string","example":"2019-11-20T20:31:55Z","format":"date-time","readOnly":true},"created_at":{"type":"string","example":"2019-11-20T20:31:55Z","format":"date-time","readOnly":true},"placed_at":{"type":"string","example":"2019-11-20T20:31:55Z","format":"date-time","readOnly":true},"deleted_at":{"type":"string","example":"2021-07-09T18:13:27Z","format":"date-time","nullable":true,"readOnly":true},"subscription_id":{"type":"integer","example":5266}},"required":["id","platform_id","platform_customer_id","shop_identifier","line_items","billing_address","shipping_addresses","subtotal","subtotal_charged","subtotal_tax","subtotal_tax_charged","shipping_subtotal","shipping_subtotal_charged","shipping_tax","shipping_tax_charged","total","total_charged","total_tax","total_tax_charged","fulfillment_status","source","payment_method","payment_method_details","shipping_method","shipping_rates","tax_lines","discounts","order_number","currency","currency_charged","currency_format","currency_format_charged","exchange_rate","test","url","updated_at","created_at","placed_at","deleted_at","subscription_id"],"readOnly":true},"PaymentMethods":{"properties":{"payment_methods":{"type":"array","items":{"$ref":"#/components/schemas/PaymentMethodEntity"}}},"type":"object"},"PaymentMethod":{"properties":{"payment_method":{"$ref":"#/components/schemas/PaymentMethodEntity"}},"type":"object"},"PaymentMethodEntity":{"type":"object","properties":{"type":{"type":"string","example":"credit_card","enum":["credit_card","paypal","shop_pay"]},"name":{"type":"string","example":"John Doe","nullable":true,"description":"Customer\'s name"},"billing_address":{"type":"object","nullable":true,"description":"Customer\'s billing address.","properties":{"street":{"type":"string","example":"123 Main Street","description":"The customer\'s street address.","nullable":true},"city":{"type":"string","example":"Toronto","description":"The customer\'s city.","nullable":true},"province":{"type":"string","example":"Ontario","description":"The customer\'s province or state, as applicable.","nullable":true},"country":{"type":"string","example":"Canada","description":"The customer\'s country name.","nullable":true},"zip":{"type":"string","example":"H0H 0H0","description":"The customer\'s postal code.","nullable":true}}},"public_id":{"type":"string","example":"jik1w6HrCn17CxXPDkWhtgyqvm8wLDd1PelY6k8mabglNmL8XKBnsde9PdgKZqnG","nullable":true},"update_method":{"type":"string","example":"trigger_email","enum":["trigger_email","embedded","url"],"nullable":true},"cc_type":{"type":"string","example":"Visa","nullable":true},"expiration":{"type":"object","required":["date","timezone_type","timezone"],"nullable":true,"properties":{"date":{"type":"string","example":"2020-5","nullable":true},"timezone_type":{"type":"string","nullable":true},"timezone":{"type":"string","example":"UTC","nullable":true}}},"last_four":{"type":"string","example":"1111","nullable":true},"is_default":{"type":"boolean","example":true,"nullable":true},"paypal_email":{"type":"string","example":"customer@example.com","format":"email","nullable":true},"update_url":{"type":"object","required":["url","expiry"],"nullable":true,"properties":{"url":{"type":"string","format":"uri"},"expiry":{"type":"string","format":"date-time"}}},"embed_url":{"type":"object","nullable":true,"properties":{"url":{"type":"string","format":"uri"},"expiry":{"type":"string","format":"date-time","nullable":true}},"required":["url","expiry"]}},"required":["type","public_id","update_method","cc_type","expiration","last_four","is_default","paypal_email","update_url"],"readOnly":true},"SelectionOptionEntity":{"type":"object","description":"","properties":{"id":{"type":"integer","example":1,"readOnly":true},"shop_id":{"type":"integer","example":1,"readOnly":true},"subscription_group_id":{"type":"integer","example":1,"readOnly":true},"platform_entity_id":{"type":"string","example":"1357908642"},"created_at":{"type":"string","readOnly":true,"example":"2019-11-20T20:31:55Z","format":"date-time"},"updated_at":{"type":"string","readOnly":true,"example":"2019-11-20T20:31:55Z","format":"date-time"},"deleted_at":{"type":"string","example":null,"readOnly":true,"format":"date-time","nullable":true},"entity_id":{"type":"integer","example":1472540,"readOnly":true},"bold_platform_entity_id":{"type":"integer","example":1234}}},"ShippingLineEntity":{"type":"object","description":"A shipping line for a subscription.","properties":{"id":{"type":"integer","description":"The ID of the shipping line.","nullable":true,"readOnly":true,"example":36217},"name":{"type":"string","description":"The name of the shipping line.","example":"Standard Shipping","readOnly":true},"code":{"type":"string","description":"The code of the shipping line.","example":"Standard Shipping","readOnly":true},"price":{"type":"integer","description":"The price of the shipping line, in base units (e.g., cents) of the `base_currency` of the associated subscription. For example, a value of `1000` on a subscription with a base currency of USD corresponds to a $10.00 USD shipping line price.","example":1000,"readOnly":true},"value":{"type":"integer","description":"The price of the shipping line, in base units (e.g., cents) of the `base_currency` of the associated subscription. For example, a value of `1000` on a subscription with a base currency of USD corresponds to a $10.00 USD shipping line price.","example":1000,"readOnly":true},"value_charged":{"type":"integer","description":"The price of the shipping line, in base units (e.g., cents) of the `charged_currency` of the associated subscription. For example, a value of `1000` on a subscription with a charged currency of CAD corresponds to a $10.00 CAD shipping line price.","example":1000,"nullable":true,"readOnly":true},"tag":{"type":"string","example":"Shipping","nullable":true,"readOnly":true},"created_at":{"type":"string","format":"date-time","description":"The date (in [RFC3339 format](https://datatracker.ietf.org/doc/html/rfc3339)) that this shipping line was created.","example":"2019-10-20T20:31:55Z","nullable":true,"readOnly":true},"updated_at":{"type":"string","format":"date-time","description":"The date (in [RFC3339 format](https://datatracker.ietf.org/doc/html/rfc3339)) that this shipping line was last updated. The value is the same as the `created_at` value if the shipping line has never been updated.","example":"2019-11-20T20:31:55Z","nullable":true,"readOnly":true},"subscription_id":{"type":"integer","description":"The ID of the subscription the shipping line belongs to.","example":1,"nullable":true,"readOnly":true}},"required":["id","name","code","price","value","value_charged","tag","created_at","updated_at","subscription_id"],"readOnly":true},"Shop":{"properties":{"shop":{"$ref":"#/components/schemas/ShopEntity"}},"type":"object"},"ShopEntity":{"type":"object","title":"","properties":{"id":{"type":"integer","example":1,"readOnly":true},"shop_domain":{"type":"string","example":"store-abc123def456.example.com","readOnly":true},"custom_domain":{"type":"string","example":"example-store.example.com","readOnly":true},"shop_identifer":{"type":"string","example":"zya0kzb8hu7ji","readOnly":true},"platform_type":{"type":"string","example":"bigcommerce","enum":["bigcommerce","shopify","woocommerce","commercetools","custom"],"readOnly":true},"timezone":{"type":"string","example":"Europe/London","readOnly":true},"currency":{"type":"string","example":"CAD","readOnly":true},"currency_format":{"type":"string","example":"${{amount}}","readOnly":true},"shop_owner":{"type":"string","example":"John Doe","readOnly":true},"admin_email":{"type":"string","example":"john.doe@example.com","readOnly":true},"pii_redacted_at":{"type":"string","example":"2019-11-20T20:31:55Z","format":"date-time","nullable":true,"readOnly":true},"created_at":{"type":"string","example":"2019-11-20T20:31:55Z","format":"date-time","readOnly":true},"updated_at":{"type":"string","example":"2019-11-20T20:31:55Z","format":"date-time","readOnly":true},"deleted_at":{"type":"string","example":"2019-11-20T20:31:55Z","format":"date-time","nullable":true,"readOnly":true}},"required":["id","shop_domain","custom_domain","shop_identifer","platform_type","timezone","currency","currency_format","shop_owner","admin_email","pii_redacted_at","created_at","updated_at","deleted_at"]},"StandardPaginationEntity":{"properties":{"total":{"type":"integer","readOnly":true,"example":2},"count":{"type":"integer","readOnly":true,"example":2},"per_page":{"type":"integer","readOnly":true,"example":10},"total_pages":{"type":"integer","readOnly":true,"example":1},"current_page":{"type":"integer","readOnly":true,"example":1}},"type":"object","readOnly":true},"Subscriptions":{"type":"object","properties":{"subscriptions":{"type":"array","items":{"$ref":"#/components/schemas/SubscriptionEntity"}},"pagination":{"$ref":"#/components/schemas/StandardPaginationEntity"}}},"ListSubscriptions":{"type":"object","title":"ListSubscriptions","properties":{"subscriptions":{"type":"array","items":{"$ref":"#/components/schemas/SubscriptionEntity"}},"pagination":{"$ref":"#/components/schemas/CursorPagination"}}},"Subscription":{"type":"object","properties":{"subscription":{"$ref":"#/components/schemas/SubscriptionEntity"}}},"SubscriptionUpdateLineItems":{"type":"object","properties":{"subscription":{"$ref":"#/components/schemas/SubscriptionUpdateLineItemsEntity"}}},"CreateLineItemsResponse":{"type":"object","properties":{"line_items":{"type":"array","items":{"$ref":"#/components/schemas/LineItemEntity"}}}},"CreateSubscriptionError422":{"type":"object","properties":{"errors":{"type":"array","description":"An array of various errors.","items":{"type":"object","properties":{"Message":{"type":"string","example":"The next order datetime must be a string."},"Field":{"type":"string","example":"subscription.next_order_datetime."},"Type":{"type":"string","example":"string"}}}},"idempotency_key":{"type":"string","description":"The idempotency key of this subscription creation request. Learn more about [setting an idempotency key](/guides/subscriptions-v2/create-subscription#choosing-an-idempotency-key).","example":"legacy-id-1234"},"current_subscription_creation_step":{"type":"string","description":"A string indicating the step of subscription creation during which the error occurred.","example":"customer_billing_address_creation"},"subscription_creation_log_id":{"type":"integer","description":"An integer ID representing the subscription creation log tied to the request. This ID persists across requests that have the same idempotency key. If you require further troubleshooting, provide this ID to [Bold Support](https://support.boldcommerce.com/hc/en-us/requests/new?ticket_form_id=1900000280347).","example":82372}}},"SubscriptionEntity":{"allOf":[{"type":"object","x-examples":{},"properties":{"id":{"type":"integer","example":1,"readOnly":true},"external_id":{"type":"string","nullable":true},"customer":{"example":"null"},"shop_id":{"type":"integer","example":1,"readOnly":true},"next_order_datetime":{"type":"string","example":"2020-01-20T18:00:00Z"},"next_payment_datetime":{"type":"string","example":"2020-01-20T18:00:00Z"},"next_processing_datetime":{"type":"string","example":"2020-01-20T18:00:00Z"},"subscription_status":{"type":"string","enum":["active","inactive","paused","scheduled","processing","app_uninstalled","waiting_sca_authorization"],"example":"active"},"status_changed_at":{"type":"string","example":"2019-11-20T20:31:55Z","format":"date-time","readOnly":true},"sca_url":{"type":"string","example":"https://bank.com/pCkWhtgQQVM8W/sca","nullable":true,"readOnly":true},"payment_method_token":{"type":"string","example":"jik1w6HrCn17CxXPcKwHTGqqvm8wLDd1PelY6k8mabglNmL8XKBnsde9PdgKZqnG"},"payment_gateway_public_id":{"type":"string","example":"jik1w6HrCn17CxXPcKwHTGqqvm8wLDd1PelY6k8mabglNmL8XKBnsde9PdgKZqnG","nullable":true},"payment_rrule":{"type":"string","example":"DTSTART:20200120T180000Z\\\\nRRULE:FREQ=MONTHLY\\\\nEXDATE:20200220T180000Z"},"payment_rrule_text":{"type":"string","example":"Monthly","nullable":true},"order_rrule":{"type":"string","example":"DTSTART:20200120T180000Z\\\\nRRULE:FREQ=MONTHLY\\\\nEXDATE:20200220T180000Z"},"order_rrule_text":{"type":"string","example":"Monthly","nullable":true},"last_payment_datetime":{"type":"string","example":"2019-11-20T20:55:26Z","nullable":true},"last_order_datetime":{"type":"string","example":"2019-11-20T20:55:26Z","nullable":true},"last_processed_datetime":{"type":"string","example":"2019-11-20T20:55:26Z","nullable":true},"current_retries":{"type":"integer","example":3},"charged_currency":{"type":"string","example":"CAD"},"base_to_charged_exchange_rate":{"type":"integer","example":1},"base_currency":{"type":"string","example":"CAD"},"line_items":{"type":"array","items":{"$ref":"#/components/schemas/LineItemEntity"},"readOnly":true},"shipping_lines":{"type":"array","nullable":true,"items":{"$ref":"#/components/schemas/ShippingLineEntity"},"readOnly":true},"billing_address":{"$ref":"#/components/schemas/CustomerAddressEntity"},"shipping_address":{"nullable":true,"type":"object","allOf":[{"$ref":"#/components/schemas/CustomerAddressEntity"}]},"idempotency_key":{"type":"string","example":"JwGdN55C4g1z5FXRO8Hp21CMxUxKyo6VcGSf3cUsjCgNyTtoeZcIsGM1We4p7pCe-0"},"placed_at":{"type":"string","example":"2012-11-20T20:31:55Z","format":"data-time","nullable":true},"created_at":{"type":"string","example":"2019-11-20T20:31:55Z","format":"date-time","readOnly":true},"updated_at":{"type":"string","example":"2019-11-20T20:31:55Z","format":"date-time","readOnly":true},"percent_discount":{"type":"number","example":10,"nullable":true,"readOnly":true},"discount_code":{"type":"string","example":"DISCOUNTCODE","readOnly":true},"customer_id":{"type":"integer","example":1697912,"readOnly":true},"billing_address_id":{"type":"integer","example":11697812},"shipping_address_id":{"type":"integer","example":11697812},"orders_processed":{"type":"integer","example":1,"nullable":true},"last_failure_code":{"type":"string","example":"card_expired","description":"This code may help to identify the type of the error.","nullable":true,"enum":["alt_pp_payment_method_required","bigcommerce_error","card_declined","card_expired","credit_card_not_found","discount_code_use_limit","insufficient_funds","invalid_billing_address","invalid_bold_api_token","invalid_card_expiration_month","invalid_card_expiration_year","invalid_card_number","invalid_customer_email","invalid_discount_code","invalid_payment_method","invalid_security_code","invalid_shipping_address","invalid_zip_code","no_payment_provider","payment_method_declined","plugin_event_failed","shopify_error","stripe_support_required","transaction_declined","out_of_stock_product","unaccepted_credit_card","unknown_error","unsupported_card","unsupported_purchase_type","unsupported_shipping_address","woocommerce_error"]},"last_failure_details":{"type":"object","nullable":true,"description":"Default error messages for the last_failure_code field","required":["message"],"properties":{"message":{"type":"string","description":"Error message","example":"The order couldn\'t process because the card was declined.","nullable":false}}},"last_failure_reason":{"type":"string","example":"credit_card","description":"The reason for the failure","nullable":true,"enum":["credit_card","gateway","cashier","platform","inventory","other"]}}},{"$ref":"#/components/schemas/SubscriptionNotesEntity"},{"$ref":"#/components/schemas/SubscriptionOrderCountEntity"}],"required":["id","external_id","customer","shop_id","next_order_datetime","next_payment_datetime","next_processing_datetime","subscription_status","status_changed_at","payment_method_token","payment_gateway_public_id","payment_rrule","payment_rrule_text","order_rrule","order_rrule_text","last_payment_datetime","last_order_datetime","last_processed_datetime","current_retries","charged_currency","base_to_charged_exchange_rate","base_currency","idempotency_key","created_at","updated_at","percent_discount","customer_id","billing_address_id","shipping_address_id","note","order_note"]},"SubscriptionOrderCountEntity":{"properties":{"order_count":{"description":"The number of orders created for the subscription.","type":"integer","example":1}}},"SubscriptionNotesEntity":{"properties":{"note":{"description":"An internal-only note that you can add to a subscription. For a subscription recurrence, this note appears in the Additional Details section of the created order. Applicable for Shopify Checkout only.","type":"string","example":"Staff note","nullable":true},"order_note":{"description":"A customer-facing note that you can add to a subscription. For the first order, this field retains the note added by the customer. For a subscription recurrence, this note appears in the Note section of the created order. Applicable for Shopify Checkout only.","type":"string","example":"Customer note","nullable":true}}},"CreateSubscriptionEntity":{"type":"object","properties":{"customer":{"type":"object","required":["first_name","last_name","email"],"properties":{"first_name":{"type":"string","description":"The customer\'s first name","example":"Jane"},"last_name":{"type":"string","description":"The customer\'s last name","example":"Doe"},"email":{"type":"string","description":"The customer\'s email","example":"jane.doe@example.com"},"phone":{"type":"string","description":"The customer\'s phone number. For Shopify checkout users, [you can configure phone number requirements in the admin](/guides/subscriptions-v2/create-subscription#how-do-i-make-phone-numbers-optional-when-using-shopify-checkout).","example":"12045551234"},"notes":{"type":"string","description":"Internal notes about the customer. This is applied as a note in the Customer info section of Bold Subscriptions admin.","example":"Loyal customer"}}},"subscription":{"allOf":[{"type":"object","required":["idempotency_key","next_order_datetime","subscription_status","order_rrule","charged_currency","base_to_charged_exchange_rate","base_currency","line_items","billing_address","shipping_address","payment_details"],"properties":{"idempotency_key":{"type":"string","description":"The idempotency key of this subscription creation request. Learn more about [setting an idempotency key](/guides/subscriptions-v2/create-subscription#choosing-an-idempotency-key).","example":"legacy-id-21425"},"next_order_datetime":{"type":"string","description":"The date and time of the next order, in [RFC 3339 format](https://www.ietf.org/rfc/rfc3339.txt).","example":"2021-05-21T08:00:00Z"},"last_order_datetime":{"type":"string","description":"If migrating subscriptions from another application, the date and time of the customer\'s last order on the legacy system, in [RFC 3339 format](https://www.ietf.org/rfc/rfc3339.txt).","example":"2021-04-21T08:00:00Z"},"subscription_status":{"type":"string","description":"The status of the subscription.","enum":["active","inactive","paused"]},"order_rrule":{"type":"string","description":"An RRULE describing how frequently to process orders for the subscription. Learn more about [RRULEs](https://support.boldcommerce.com/hc/en-us/articles/360045174132-Use-RRULES-in-Bold-Subscriptions).","example":"DTSTART;TZID=America/New_York:20240425T000000Z\\nRRULE:FREQ=MONTHLY"},"base_currency":{"type":"string","description":"The base currency of your store, in [ISO 4217 format](https://www.iso.org/iso-4217-currency-codes.html). This should align with your store\'s platform configuration.","example":"CAD"},"charged_currency":{"type":"string","description":"The currency to charge the customer with, in [ISO 4217 format](https://www.iso.org/iso-4217-currency-codes.html).","example":"USD"},"base_to_charged_exchange_rate":{"type":"number","description":"The exchange rate from your base currency to the charged currency.","example":0.79},"line_items":{"type":"array","description":"An array of line items to be added to the subscription.","items":{"type":"object","required":["platform_product_id","platform_variant_id","quantity","price","subscription_group_id"],"properties":{"platform_product_id":{"type":"string","description":"The ID of the product on your platform. Learn more about [finding platform product IDs](/guides/subscriptions-v2/create-subscription#how-do-i-find-the-platform_product_id-and-platform_variant_id-for-a-line-item).","example":"1578934692"},"platform_variant_id":{"type":"string","description":"The ID of the product variant on your platform. All products, including those with no variants or a single variant, have a platform variant ID. Learn more about [finding platform variant IDs](/guides/subscriptions-v2/create-subscription#how-do-i-find-the-platform_product_id-and-platform_variant_id-for-a-line-item).","example":"975285185"},"quantity":{"type":"number","description":"The quantity of this line item within the subscription.","example":2},"price":{"type":"number","description":"Price in the base unit (e.g., cents) of the `base_currency` for this subscription. For example, a value of `1000` in a USD currency corresponds to a $10.00 per-unit price on the line item.","example":1000},"subscription_group_id":{"type":"number","description":"The ID of the subscription group that contains this product, found in the Subscriptions 2 admin. Learn more about [finding subscription group IDs](/guides/subscriptions-v2/create-subscription#how-do-i-find-the-subscription_group_id-for-a-line-item).","example":123}}}},"billing_address":{"$ref":"#/components/schemas/CreateAddressEntity"},"shipping_address":{"$ref":"#/components/schemas/CreateAddressEntity"},"external_id":{"type":"string","description":"If applicable, the ID of the subscription on its previous system. Recommended for subscriptions being migrated from legacy subscription apps.","example":"legacy-id-135798642"},"placed_at":{"type":"string","format":"date-time","description":"The date the subscription was originally placed. Recommended for subscriptions being migrated from legacy subscription apps.","example":"2012-05-21T08:00:00Z","nullable":true},"payment_details":{"type":"object","required":["gateway_name","gateway_customer_id"],"description":"The payment details used for processing orders.","properties":{"gateway_name":{"type":"string","description":"A string indicating the payment gateway being used. Learn more about [finding the gateway name](/guides/subscriptions-v2/create-subscription#how-do-i-find-payment-gateway-information-for-the-paymentdetails-object).","example":"Stripe Default Name"},"gateway_customer_id":{"type":"string","description":"A string that is used to associate a customer record with the corresponding customer from the payment gateway. Learn more about [finding the gateway customer ID](/guides/subscriptions-v2/create-subscription#how-do-i-find-payment-gateway-information-for-the-paymentdetails-object).","example":"cus_123456789"},"gateway_payment_id":{"type":"string","description":"For Bold Checkout, this field is unused. For Shopify Checkout, this field is optional. It is used in combination with the `gateway_customer_id` to create a Shopify payment method that references the particular payment method associated with this ID. Learn more about [finding the gateway payment ID](/guides/subscriptions-v2/create-subscription#how-do-i-find-payment-gateway-information-for-the-paymentdetails-object).","example":"card_123456"}}},"discount_code":{"type":"string","description":"Supported for Bold Checkout through the \\"Shopify Discount Connector\\" Marketplace plugin. Supported for Shopify checkout by default.","example":"DISCOUNTCODE","nullable":true}}},{"$ref":"#/components/schemas/SubscriptionNotesEntity"},{"$ref":"#/components/schemas/SubscriptionOrderCountEntity"}]}}},"CreateAddressEntity":{"description":"Address payload for the create endpoint.","type":"object","required":["first_name","last_name","street1","street2","city","country","country_code"],"properties":{"first_name":{"type":"string","description":"The customer\'s first name.","example":"Jane"},"last_name":{"type":"string","description":"The customer\'s last name.","example":"Doe"},"company":{"type":"string","description":"The customer\'s company.","example":"Bold Commerce"},"phone":{"type":"string","description":"The customer\'s phone number. For Shopify checkout users, [you can configure phone number requirements in the admin](/guides/subscriptions-v2/create-subscription#how-do-i-make-phone-numbers-optional-when-using-shopify-checkout).","example":"12045551234"},"street1":{"type":"string","description":"The customer\'s address 1.","example":"123 Alphabet St."},"street2":{"type":"string","description":"The customer\'s address 2.","example":"101"},"city":{"type":"string","description":"The customer\'s city.","example":"Austin"},"province":{"type":"string","description":"The full written name of the province or state (e.g., Ontario). Required only for countries that have provinces if `province_code` is not provided.","example":"Texas"},"province_code":{"type":"string","description":"The short-form code representing the province or state (e.g., ON for Ontario), in [ISO 3166 format](https://www.iso.org/iso-3166-country-codes.html). Required only for countries that have provinces/states, and if `province` is not already provided.","example":"TX"},"country":{"type":"string","description":"The full written name of the country. Required if `\'country_code\'` is not already provided.","example":"United States"},"country_code":{"type":"string","description":"The short-form code representing the country, in [ISO 3166 format](https://www.iso.org/iso-3166-country-codes.html). Required if `country` is not already provided.","example":"US"},"zip":{"type":"string","description":"The zip or postal code for the address given. Required only for countries that use zip/postal.","example":"78701"}}},"PartialUpdateSubscription":{"description":"Update the current retries before the subscription expires.","properties":{"subscription":{"$ref":"#/components/schemas/PartialUpdateSubscriptionEntity"}},"type":"object"},"PartialUpdateSubscriptionEntity":{"allOf":[{"type":"object","properties":{"current_retries":{"type":"integer","example":6}}},{"$ref":"#/components/schemas/SubscriptionNotesEntity"},{"$ref":"#/components/schemas/SubscriptionOrderCountEntity"}]},"UpdateSubscriptionLineItems":{"description":"Update line items on the subscription.","type":"object","title":"","properties":{"subscription":{"type":"object","properties":{"line_items":{"type":"array","items":{"$ref":"#/components/schemas/PatchLineItemEntity"}}}}}},"CreateSubscriptionLineItems":{"description":"Add line items to a subscription.","type":"object","required":["platform_product_id","platform_variant_id","quantity"],"properties":{"line_items":{"type":"array","items":{"properties":{"platform_product_id":{"type":"string","description":"The ID of the product on your platform. Learn more about [finding platform product IDs](/guides/subscriptions-v2/create-subscription#how-do-i-find-the-platform_product_id-and-platform_variant_id-for-a-line-item).","example":"1357908642"},"platform_variant_id":{"type":"string","description":"The ID of the product variant on your platform. All products, including those with no variants or a single variant, have a platform variant ID. Learn more about [finding platform variant IDs](/guides/subscriptions-v2/create-subscription#how-do-i-find-the-platform_product_id-and-platform_variant_id-for-a-line-item).","example":"2468097531"},"quantity":{"type":"integer","description":"The quantity of this line item within the subscription.","example":1},"price":{"type":"integer","description":"The price of this line item within the subscription, in the base unit (e.g., cents) of the `charged_currency` for this subscription. For example, a value of `1000` in a USD currency corresponds to a $10.00 USD per-unit price on the line item.","example":3500},"subscription_group_id":{"type":"integer","description":"The ID of the subscription group that contains the discount you want to add to this line item. Learn more about [finding subscription group IDs](/guides/subscriptions-v2/create-subscription#how-do-i-find-the-subscription_group_id-for-a-line-item).","example":123}}}}}},"UpdateSubscriptionNextOrderDate":{"description":"Update the next order date and time for the subscription.","type":"object","properties":{"nextDate":{"type":"string","example":"2020-01-20T18:00:00Z"},"includeFutureOrders":{"type":"boolean","default":false,"description":"Also adjust the order datetimes of all future orders to match the new next order date with the old interval."}}},"SkipSubscriptionOrder":{"description":"Skip an upcoming order for the subscription.","properties":{"date":{"type":"string","example":"2020-01-20T18:00:00Z"}},"type":"object"},"UnskipSubscriptionOrder":{"description":"Restore a previously skipped future subscription order.","properties":{"date":{"type":"string","description":"The date of the previously skipped order (to be restored/unskipped)","example":"2020-01-20T18:00:00Z"}},"type":"object"},"SelectionOptions":{"properties":{"selection_options":{"type":"array","items":{"$ref":"#/components/schemas/SelectionOptionsEntity"}},"pagination":{"$ref":"#/components/schemas/SubscriptionsCursorPagination"}},"type":"object"},"SelectionOptionsEntity":{"type":"object","title":"","properties":{"id":{"type":"integer","example":1,"description":"Selection Options identifier.","readOnly":true},"shop_id":{"type":"integer","example":10,"readOnly":true,"description":"The shop ID."},"subscription_group_id":{"type":"integer","example":9,"readOnly":true,"description":"The subscription group the selection option belong to."},"platform_entity_id":{"type":"integer","example":8000319815956,"readOnly":true,"description":"The platform identifier to the product in the selection option."},"bold_platform_entity_id":{"type":"integer","example":39,"readOnly":true,"description":"The Bold identifier of the product in the selection option."},"created_at":{"type":"string","example":"2022-11-09 17:50:37","description":"When the selection option was created."},"updated_at":{"type":"string","example":"2022-11-09 17:50:37","description":"When the selection option was updated."},"deleted_at":{"type":"string","nullable":true,"example":null,"description":"When the selection option was deleted."}},"required":["id","shop_id","subscription_group_id","platform_entity_id","bold_platform_entity_id","created_at","updated_at","deleted_at"]},"SubscriptionGroups":{"properties":{"subscription_groups":{"type":"array","items":{"$ref":"#/components/schemas/SubscriptionGroupEntity"}}},"type":"object"},"SubscriptionGroup":{"properties":{"subscription_group":{"$ref":"#/components/schemas/SubscriptionGroupEntity"}},"type":"object"},"SubscriptionGroupEntity":{"type":"object","title":"","properties":{"id":{"type":"integer","example":19364,"readOnly":true},"shop_id":{"type":"integer","example":8846,"readOnly":true},"internal_name":{"type":"string","example":"Standard Subscription"},"is_enabled":{"type":"boolean","example":true},"platform_id":{"type":"string","example":"gid://shopify/SellingPlanGroup/132016692"},"allow_prepaid":{"type":"boolean","example":false},"is_prepaid_only":{"type":"boolean","example":false},"should_continue_prepaid":{"type":"boolean","example":false},"continue_prepaid_type":{"type":"string","example":"as_prepaid","enum":["as_prepaid","as_standard"]},"allow_buffer_days":{"type":"boolean"},"discount_type":{"type":"string","example":"no_discount","enum":["no_discount","percentage","fixed"]},"percent_discount":{"type":"number","example":11},"fixed_discount":{"type":"integer"},"minimum_order_count_before_cancellable":{"type":"integer","example":0},"is_product_swappable":{"type":"boolean","example":false},"is_subscription_only":{"type":"boolean","example":false},"selection_type":{"type":"string","example":"products","enum":["products","collections"]},"group_type":{"type":"string","example":"selectable","enum":["selectable","fixed"]},"selectable_daily_allowed":{"type":"boolean","example":false},"selectable_weekly_allowed":{"type":"boolean","example":false},"selectable_yearly_allowed":{"type":"boolean","example":false},"selectable_max_interval_frequency":{"type":"integer","example":0},"fixed_interval_type":{"type":"string","example":"monthly","enum":["daily","weekly","monthly","yearly"]},"is_fixed_billing":{"type":"boolean","example":false},"can_add_to_cart":{"type":"boolean","example":true},"created_at":{"type":"string","example":"2019-11-20T20:31:55Z","format":"date-time","readOnly":true},"updated_at":{"type":"string","example":"2019-11-20T20:31:55Z","format":"date-time","readOnly":true},"deleted_at":{"type":"string","example":null,"format":"date-time","nullable":true,"readOnly":true},"active_subscribers_count":{"type":"integer","example":1,"readOnly":true},"billing_rules":{"type":"array","items":{"$ref":"#/components/schemas/BillingRuleEntity"}},"selection_options":{"type":"array","items":{"$ref":"#/components/schemas/SelectionOptionEntity"}},"prepaid_durations":{"type":"array","items":{"$ref":"#/components/schemas/PrepaidDuration"}},"dynamic_discounts":{"type":"array","nullable":true,"description":"Dynamic Discounts are applied when the provided number of orders are placed. All order numbers must be unique.\\nExample:\\n Base product price: $10.00\\n Initial discount: $1.00\\n Discounts:\\n {\\"order_number\\": 2, \\"discount_type\\": \\"fixed\\", \\"discount_value\\": 250}\\n {\\"order_number\\": 4, \\"discount_type\\": \\"percentage\\", \\"discount_value\\": 30}\\n Line item prices will be:\\n 1st order: $9.00\\n 2nd order: $9.00\\n 3rd order: $7.50\\n 4th order: $7.50\\n 5th order: $7.00\\n","items":{"$ref":"#/components/schemas/DynamicDiscount"}}},"required":["id","shop_id","internal_name","is_enabled","platform_id","allow_prepaid","is_prepaid_only","should_continue_prepaid","continue_prepaid_type","allow_buffer_days","discount_type","percent_discount","fixed_discount","minimum_order_count_before_cancellable","is_product_swappable","is_subscription_only","selection_type","group_type","selectable_daily_allowed","selectable_weekly_allowed","selectable_yearly_allowed","selectable_max_interval_frequency","fixed_interval_type","is_fixed_billing","can_add_to_cart","created_at","updated_at","deleted_at","active_subscribers_count","billing_rules","selection_options","prepaid_durations"]},"SubscriptionOrders":{"properties":{"subscription_orders":{"type":"array","items":{"$ref":"#/components/schemas/SubscriptionOrderEntity"}}},"type":"object"},"SubscriptionOrder":{"type":"object","properties":{"id":{"type":"integer","example":1008130},"subscription_id":{"type":"integer","example":316561},"shop_id":{"type":"integer","example":6481},"base_to_charged_exchange_rate":{"type":"number","example":1},"base_currency":{"type":"string","example":"CAD"},"order":{"$ref":"#/components/schemas/OrderEntity"},"is_multi_currency":{"type":"boolean"},"created_at":{"type":"string","example":"2021-07-09T18:13:40Z"},"updated_at":{"type":"string","example":"2021-07-09T18:13:40Z","nullable":true}},"required":["id","subscription_id","shop_id","base_to_charged_exchange_rate","base_currency","order","is_multi_currency","created_at","updated_at"],"title":""},"SubscriptionOrderEntity":{"properties":{"id":{"type":"integer","example":151917},"subscription_id":{"type":"integer","example":5266},"shop_id":{"type":"integer","example":29875},"currency":{"type":"string","example":"CAD"},"base_to_charged_exchange_rate":{"type":"integer","example":1},"base_currency":{"type":"string","example":"CAD"},"order":{"$ref":"#/components/schemas/OrderEntity"},"is_multi_currency":{"type":"boolean","example":false},"created_at":{"type":"string","readOnly":true,"example":"2019-11-20T20:31:55Z","format":"date-time"},"updated_at":{"type":"string","readOnly":true,"example":"2019-11-20T20:31:55Z","format":"date-time"}},"type":"object","readOnly":true},"SubscriptionAdjustments":{"properties":{"adjustments":{"type":"array","items":{"$ref":"#/components/schemas/SubscriptionAdjustment"}}}},"SubscriptionAdjustment":{"properties":{"id":{"type":"integer","readOnly":true,"example":74928},"name":{"type":"string","description":"The name of the adjustment.","example":"One-time Upsell (Gift)"},"description":{"type":"string","description":"The description of the adjustment being made to the subscription or its orders.","example":"Enjoy a complementary gift every 5th order for being a loyal customer!"},"target":{"type":"string","description":"The target of the adjustment.","enum":["subscription","order"],"example":"order"},"trigger":{"type":"object","description":"The condition for when and how often the `action` will be made against the `target`.","oneOf":[{"$ref":"#/components/schemas/SubscriptionAdjustmentTriggerOrderCount"},{"$ref":"#/components/schemas/SubscriptionAdjustmentTriggerOrderDatetime"}]},"action":{"type":"object","description":"The action that should be made against the `target` of the adjustment.","oneOf":[{"$ref":"#/components/schemas/SubscriptionAdjustmentActionAddLineItem"},{"$ref":"#/components/schemas/SubscriptionAdjustmentActionUpdateLineItemQuantity"},{"$ref":"#/components/schemas/SubscriptionAdjustmentActionApplyPrice"}]},"invalid_at":{"type":"string","format":"date-time","description":"The date (in [RFC3339 format](https://datatracker.ietf.org/doc/html/rfc3339)) that this adjustment will be applied and become invalid. The value is null for adjustments that are scheduled to be applied one-time in the future.","nullable":true,"readOnly":true,"example":null},"created_at":{"type":"string","format":"date-time","description":"The date (in [RFC3339 format](https://datatracker.ietf.org/doc/html/rfc3339)) that this adjustment was created.","readOnly":true,"example":"2024-10-15T06:00:00Z"},"updated_at":{"type":"string","format":"date-time","description":"The date (in [RFC3339 format](https://datatracker.ietf.org/doc/html/rfc3339)) that this adjustment was last updated. The value is the same as the `created_at` value if the adjustment has never been updated.","readOnly":true,"example":"2024-10-15T06:00:00Z"},"deleted_at":{"type":"string","format":"date-time","description":"The date (in [RFC3339 format](https://datatracker.ietf.org/doc/html/rfc3339)) that this adjustment was deleted. The value is null if the adjustment has never been deleted.","nullable":true,"readOnly":true,"example":null}}},"SubscriptionAdjustmentTriggerOrderCount":{"required":["type"],"properties":{"type":{"type":"string","description":"The type of trigger to use to determine when this adjustment should apply. The value `order_count` is used to match targets based on order count.","enum":["order_count"],"example":"order_count"},"count":{"$ref":"#/components/schemas/SubscriptionAdjustmentMatchConditionCount"},"relative_count":{"$ref":"#/components/schemas/SubscriptionAdjustmentMatchConditionRelativeCount"},"function":{"$ref":"#/components/schemas/SubscriptionAdjustmentMatchConditionFunction"}}},"SubscriptionAdjustmentMatchConditionCount":{"type":"integer","nullable":true,"description":"The order count of the target that the adjustment will apply to.","example":5},"SubscriptionAdjustmentMatchConditionRelativeCount":{"type":"integer","description":"Use the subscription\'s current order count when calculating the final order count.","minimum":1,"example":5},"SubscriptionAdjustmentMatchConditionFunction":{"type":"object","nullable":true,"description":"Use a \\"y = mx + b\\" formula as your match condition for when to apply your adjustment to orders. For example, a \\"step_size\\" of 3 and an \\"offset\\" of 2 to represent \\"Every 3rd order starting on the 2nd order.\\"","properties":{"step_size":{"type":"integer","minimum":1,"example":5},"offset":{"minimum":0,"type":"integer","example":0}}},"SubscriptionAdjustmentTriggerOrderDatetime":{"required":["type"],"properties":{"type":{"type":"string","description":"The type of trigger to use to determine when this adjustment should apply. The value `order_datetime` is used to match targets based on order date and time.","enum":["order_datetime"],"example":"order_datetime"},"datetime":{"type":"string","format":"date-time","description":"The date and time of an order that will trigger this adjustment.","example":"2024-02-15T06:00:00Z"}}},"SubscriptionAdjustmentActionAddLineItem":{"required":["type","platform_product_id","platform_variant_id","quantity"],"properties":{"type":{"type":"string","description":"The action to perform for the adjustment. Adds a line item to the adjustment target.\\n\\nTo add a line item, the `type` value is always \\"add_line_item\\".","enum":["add_line_item"],"example":"add_line_item"},"platform_product_id":{"type":"string","description":"The ID of the product on your platform. Learn more about [finding platform product IDs](/guides/subscriptions-v2/create-subscription#how-do-i-find-the-platform_product_id-and-platform_variant_id-for-a-line-item).","example":"1578934692"},"platform_variant_id":{"type":"string","description":"The ID of the product variant on your platform. All products, including those with no variants or a single variant, have a platform variant ID. Learn more about [finding platform variant IDs](/guides/subscriptions-v2/create-subscription#how-do-i-find-the-platform_product_id-and-platform_variant_id-for-a-line-item).","example":"975285185"},"quantity":{"type":"integer","description":"The quantity of the line item to add.","example":1},"price":{"type":"integer","description":"The price of the line item in the base currency unit (e.g. cents).","example":1500}}},"SubscriptionAdjustmentActionUpdateLineItemQuantity":{"required":["type","subscription_line_item_id","quantity"],"properties":{"type":{"type":"string","description":"The action to perform for the adjustment. Updates a line item quantity for the adjustment target.\\n\\nTo update a line item\'s quantity, the `type` value is always \\"update_line_item_quantity\\".","enum":["update_line_item_quantity"],"example":"update_line_item_quantity"},"subscription_line_item_id":{"type":"number","description":"The ID of the subscription line item to update.","example":35236},"quantity":{"type":"integer","description":"The new quantity of the line item.","example":3}}},"SubscriptionAdjustmentActionApplyPrice":{"required":["type","line_item_id","price"],"properties":{"type":{"type":"string","description":"The action to perform for the adjustment. It updates the price for the adjustment target.\\n\\nTo update a line item\'s price, the `type` value is always \\"apply_price\\".","enum":["apply_price"],"example":"apply_price"},"line_item_id":{"type":"number","description":"The ID of the subscription line item to update.","example":35237},"price":{"type":"integer","description":"The new price of the line item in the base currency unit (e.g. cents).","example":300}}},"SwapProduct":{"type":"object","properties":{"swap_products":{"type":"array","items":{"$ref":"#/components/schemas/SwapProductEntity"}}}},"SwapProductEntity":{"type":"object","properties":{"line_item_id":{"type":"integer","example":1},"platform_product_id":{"type":"string","example":"1357908642"},"platform_variant_id":{"type":"string","example":"2468097531"},"subscription_group_id":{"type":"integer","example":1}}},"SwappableProducts":{"properties":{"swappable_products":{"type":"array","items":{"$ref":"#/components/schemas/SwappableProductEntity"}},"pagination":{"$ref":"#/components/schemas/StandardPaginationEntity"}},"type":"object"},"SwappableProductEntity":{"type":"object","readOnly":true,"properties":{"price":{"type":"integer","readOnly":true,"example":1337},"price_charged":{"type":"integer","readOnly":true,"example":1337},"discounted_price":{"type":"integer","readOnly":true,"example":1337},"discounted_price_charged":{"type":"integer","readOnly":true,"example":1337},"has_discount":{"type":"boolean","readOnly":true,"example":true},"url":{"type":"string","readOnly":true,"example":"https://example-store.example.com/monthly-expansion-pack"},"variants":{"type":"array","readOnly":true,"items":{"$ref":"#/components/schemas/SwappableProductVariantEntity"}},"image":{"type":"string","readOnly":true,"example":"https://example.com/s-sadjid0asd/products/112/images/376/example-store__33773.1574282899.386.513.png?c=1"},"product_image":{"type":"string","readOnly":true,"example":"https://example.com/s-sadjid0asd/products/112/images/376/example-store__33773.1574282899.386.513.png?c=1"},"title":{"type":"string","readOnly":true,"example":"Monthly Expansion Pack"},"product_name":{"type":"string","readOnly":true,"example":"Monthly Expansion Pack"},"platform_product_id":{"type":"string","readOnly":true,"example":"1357908642"},"subscription_group_id":{"type":"integer","readOnly":true,"example":1}}},"ConvertibleAdjustmentGroup":{"type":"object","required":["on_cycle_end","trigger"],"properties":{"id":{"type":"integer","example":1,"readOnly":true},"shop_platform_id":{"type":"integer","example":1234,"readOnly":true},"on_cycle_end":{"type":"string","enum":["repeat_cycle","continue_last_item","remove_from_subscription"],"example":"repeat_cycle"},"trigger":{"type":"object","required":["type","count"],"properties":{"type":{"type":"string","example":"order_count"},"function":{"type":"object","nullable":true,"readOnly":true,"example":null},"count":{"type":"integer","example":1}}},"created_at":{"type":"string","readOnly":true,"example":"2024-03-11T18:56:12Z","format":"date-time"},"updated_at":{"type":"string","readOnly":true,"example":"2024-03-11T18:56:12Z","format":"date-time"},"deleted_at":{"type":"string","example":null,"readOnly":true,"format":"date-time","nullable":true}}},"ConvertibleAdjustmentGroupItemEntity":{"required":["type","discount_type"],"type":"object","properties":{"type":{"type":"string","enum":["product","initial_product"],"example":"product"},"product":{"$ref":"#/components/schemas/ConvertibleAdjustmentGroupItemProduct"},"discount_value":{"type":"integer","example":50},"discount_type":{"type":"string","enum":["percentage","fixed","no_discount"],"example":"percentage"}}},"ConvertibleAdjustmentGroupItem":{"type":"object","properties":{"id":{"type":"integer","description":"The convertible adjustment item identifier.","example":81},"shop_platform_app_id":{"type":"integer","description":"The identifier of the application.","example":1007},"convertible_adjustment_group_id":{"type":"integer","description":"The convertible adjustment group identifier, obtained from calling [Create Convertible Adjustment Group](/api/subscriptions#tag/Convertible-Adjustments/operation/CreateConvertibleAdjustmentGroup).","example":20},"type":{"type":"string","description":"The type of convertible adjustment group item.","enum":["product"],"example":"product"},"discount_value":{"type":"integer","description":"The value given to the discount. For fixed discounts, cents off (e.g. 500 for $5) should be provided. For percent discounts, the percentage off (e.g. 10) should be provided.","example":50},"discount_type":{"type":"string","description":"The type of discount applied to the recurring product","enum":["percentage","fixed","no_discount"],"example":"percentage"},"product":{"type":"object","description":"The product involved in the convertible adjustment.","properties":{"id":{"type":"integer","description":"The product identifier.","example":81},"convertible_adjustment_group_item_id":{"type":"integer","description":"The convertible adjustment group item identifier.","example":81},"platform_product_id":{"type":"string","description":"The identifier of the product on the platform.","example":"7873884881051"},"platform_variant_id":{"type":"string","description":"The identifier of the variant on the platform.","example":"44147854114971"},"product_id":{"type":"string","description":"The identifier of the product","nullable":true,"example":"11"},"variant_id":{"type":"string","description":"The identifier of the variant","nullable":true,"example":"22"},"created_at":{"type":"string","description":"The date and time the product was created.","format":"date-time","example":"2024-03-19T20:42:47Z"},"updated_at":{"type":"string","description":"The date and time the product was updated.","format":"date-time","example":"2024-03-19T20:42:47Z"},"deleted_at":{"type":"string","description":"The date and time the product was deleted.","format":"date-time","nullable":true,"example":null}}},"created_at":{"type":"string","description":"The date and time the convertible adjustment group item was created.","format":"date-time","example":"2024-03-19T20:42:47Z"},"updated_at":{"type":"string","description":"The date and time the convertible adjustment group item was updated.","format":"date-time","example":"2024-03-19T20:42:47Z"},"deleted_at":{"type":"string","description":"The date and time the convertible adjustment group item was deleted.","format":"date-time","nullable":true,"example":null}}},"ConvertibleAdjustmentGroupItemProduct":{"type":"object","nullable":true,"required":["platform_product_id","platform_variant_id"],"properties":{"platform_product_id":{"type":"string","description":"The identifier of the product on the platform.","example":"7873884881051"},"platform_variant_id":{"type":"string","description":"The identifier of the variant on the platform.","example":"44147854114971"}}},"WebhookTopicEntity":{"type":"object","properties":{"id":{"type":"integer"},"topic_name":{"type":"string"}},"x-examples":{"subscription_created":{"id":1,"topic_name":"subscription_created"},"subscription_updated":{"id":2,"topic_name":"subscription_updated"}}},"WebhookEventEntity":{"title":"","type":"object","properties":{"id":{"type":"integer"},"shop_id":{"type":"integer"},"webhook_subscription_id":{"type":"integer"},"webhook_topic_id":{"type":"integer"},"uuid":{"type":"string"},"attempts":{"type":"integer"},"last_response_status_code":{"type":"string"},"delivered_at":{"type":"string"},"created_at":{"type":"string","readOnly":true,"example":"2019-11-20T20:31:55Z","format":"date-time"},"updated_at":{"type":"string","readOnly":true,"example":"2019-11-20T20:31:55Z","format":"date-time"},"deleted_at":{"type":"string","example":null,"readOnly":true,"format":"date-time","nullable":true}},"x-examples":{"Example":{"id":1,"shop_id":1,"webhook_subscription_id":1,"webhook_topic_id":1,"uuid":"18418f32-f1ff-4897-94c9-9daacbaa404b","attempts":1,"last_response_status_code":"200","delivered_at":"2020-08-17T18:27:03Z","created_at":"2020-08-17T18:27:03Z","updated_at":"2020-08-17T18:27:03Z","deleted_at":""}},"description":""},"WebhookSubscriptionEntity":{"type":"object","x-examples":{"Example":{"id":1,"shop_id":1,"webhook_topic_id":1,"callback_url":"yourapp.com/bold-subscription-creation-callback","created_at":"2020-08-13T15:39:01Z","updated_at":"2020-08-13T15:39:01Z","deleted_at":""}},"properties":{"id":{"type":"integer"},"shop_id":{"type":"integer"},"webhook_topic_id":{"type":"integer"},"callback_url":{"type":"string"},"shared_secret":{"type":"string"},"created_at":{"type":"string","readOnly":true,"example":"2019-11-20T20:31:55Z","format":"date-time"},"updated_at":{"type":"string","readOnly":true,"example":"2019-11-20T20:31:55Z","format":"date-time"},"deleted_at":{"type":"string","example":null,"readOnly":true,"format":"date-time","nullable":true}}},"WebhookTopics":{"properties":{"webhook_topics":{"type":"array","items":{"$ref":"#/components/schemas/WebhookTopicEntity"}}},"type":"object"},"WebhookSubscription":{"title":"","type":"object","properties":{"webhook_subscription":{"$ref":"#/components/schemas/WebhookSubscriptionEntity"}}},"WebhookSubscriptions":{"title":"","type":"object","properties":{"webhook_subscriptions":{"type":"array","items":{"$ref":"#/components/schemas/WebhookSubscriptionEntity"}}}},"WebhookEvents":{"properties":{"webhook_events":{"type":"array","items":{"$ref":"#/components/schemas/WebhookEventEntity"}}},"type":"object","description":"","x-examples":{}},"WebhookEvent":{"type":"object","properties":{"webhook_event":{"$ref":"#/components/schemas/WebhookEventEntity"}}},"SwappableProductVariantEntity":{"type":"object","readOnly":true,"x-examples":{},"properties":{"platform_id":{"type":"string","example":"1"},"platform_product_id":{"type":"string","example":"112"},"name":{"type":"string","example":"Size Small"},"sku":{"type":"string","example":"SKU-112-Small"},"price":{"type":"integer","example":1337},"price_charged":{"type":"integer","example":1337},"discounted_price":{"type":"integer","example":1337},"discounted_price_charged":{"type":"integer","example":1337},"discounted_cost":{"type":"integer","example":1337},"discounted_cost_charged":{"type":"integer","example":1337},"cost":{"type":"integer","example":0},"weight":{"type":"number","example":1.5},"weight_unit":{"type":"string","example":"kg"},"grams":{"type":"integer","example":1500},"image_id":{"type":"integer","example":0},"image_url":{"type":"string","example":""},"allow_backorder":{"type":"boolean","example":false},"inventory_quantity":{"type":"integer","example":0},"inventory_tracking_service":{"type":"string","example":"platform"},"inventory_tracking_entity":{"type":"string","example":"product"}},"title":""},"AlternatePaymentMethod":{"description":"","type":"object","properties":{"gift_card":{"type":"array","uniqueItems":true,"minItems":1,"items":{"required":["payment_public_id","card_number","balance"],"properties":{"payment_public_id":{"type":"string","minLength":1},"card_number":{"type":"string","minLength":1},"balance":{"type":"number"}}}}},"required":["gift_card"],"x-examples":{"example-1":{"gift_card":[{"payment_public_id":"Z44qfpucJ1dsQjuZopMpFuQNyKCv7Eui0JLCHq9y1ytE669TlqGChkrl92xxhTXy","card_number":"SADWIUWRFNRVDTCB","balance":1200}]}}},"PrepaidDuration":{"title":"PrepaidDuration","type":"object","properties":{"id":{"type":"integer","readOnly":true},"total_duration":{"type":"integer","minimum":1},"discount_value":{"type":"integer"},"discount_type":{"type":"string","enum":["percentage","fixed","no_discount"]},"created_at":{"type":"string","readOnly":true,"example":"2019-11-20T20:31:55Z","format":"date-time"},"updated_at":{"type":"string","readOnly":true,"example":"2019-11-20T20:31:55Z","format":"date-time"},"deleted_at":{"type":"string","example":null,"readOnly":true,"format":"date-time","nullable":true}}},"DynamicDiscount":{"title":"DynamicDiscount","type":"object","description":"Dynamic Discount is applied when the provided number of orders are placed. The fixed discount value is in the base currency unit (e.g. cents).\\nExample:\\n Base product price: $10.00\\n Discount: {\\"order_number\\": 2, \\"discount_type\\": \\"fixed\\", \\"discount_value\\": 250}\\n The $2.50 discount will be applied after the second order, and the line item price will be changed to $7.50.\\n","properties":{"order_number":{"type":"integer","minimum":1},"discount_type":{"type":"string","example":"fixed","enum":["percentage","fixed"]},"discount_value":{"type":"number","minimum":0,"example":25}}},"SubscriptionAndPaymentMethod":{"title":"SubscriptionAndPaymentMethod","type":"object","properties":{"payment_method":{"$ref":"#/components/schemas/PaymentMethodEntity"},"subscription":{"$ref":"#/components/schemas/SubscriptionEntity"}},"x-examples":{"Example":{"value":{"payment_method":{"public_id":"jik1w6HrCn17CxXPDkWhtgyqvm8wLDd1PelY6k8mabglNmL8XKBnsde9PdgKZqnG","cc_type":"Visa","expiration":{"date":"2020-05","timezone_type":"null","timezone":"null"},"last_four":"1111","is_default":true},"subscription":{"id":1,"shop_id":1,"next_order_datetime":"2020-01-20T18:00:00Z","next_payment_datetime":"2020-01-20T18:00:00Z","subscription_status":"active","payment_method_token":"jik1w6HrCn17CxXPcKwHTGqqvm8wLDd1PelY6k8mabglNmL8XKBnsde9PdgKZqnG","payment_rrule":"DTSTART:20200120T180000Z\\\\nRRULE:FREQ=MONTHLY\\\\nEXDATE:20200220T180000Z","payment_rrule_text":"Monthly","order_rrule":"DTSTART:20200120T180000Z\\\\nRRULE:FREQ=MONTHLY\\\\nEXDATE:20200220T180000Z","order_rrule_text":"Monthly","last_payment_datetime":"2019-11-20T20:55:26Z","last_order_datetime":"2019-11-20T20:55:26Z","last_processed_datetime":"2019-11-20T20:55:26Z","current_retries":3,"charged_currency":"CAD","base_to_charged_exchange_rate":1,"base_currency":"CAD","line_items":[{"id":1,"subscription_id":1,"bold_platform_subscription_id":1,"bold_platform_subscription_line_item_id":1,"platform_product_id":"1357908642","platform_variant_id":"2468097531","subscription_group_id":1,"subscription_group_billing_rules_id":1,"product_name":"Monthly Expansion Pack","variant_name":"Default Title","title":"Monthly Expansion Pack","sku":"SKU-113-Red","url":"https://example-store.example.com/monthly-expansion-pack","image":"","quantity":1,"price":3500,"price_charged":3500,"discounted_price":3200,"discounted_price_charged":3200,"full_price":3200,"full_price_charged":3200,"requires_shipping":false,"grams":2200,"weight":2.2,"weight_unit":"kg","taxable":true,"discounts":[{"id":1,"subscription_line_item_id":1,"shop_id":5,"discount_type":"percentage","percentage_value":10,"fixed_value":0,"description":"Subscription discount (10%) for Monthly Expansion Pack","created_at":"2019-11-20T20:31:55Z","updated_at":"2019-11-20T20:31:55Z"}],"placed_at":"2012-01-20T18:00:00Z","created_at":"2019-11-20T20:31:55Z","updated_at":"2019-11-20T20:31:55Z"}],"customer":{"id":0,"platform_id":0,"cashier_public_id":"string","first_name":"John","last_name":"Doe","phone":"800-555-0102","email":"john.doe@example.com","notes":"Loyal customer.","addresses":[{"id":0,"shop_identifier":"string","platform_id":0,"customer_id":0,"platform_type":"string","platform_customer_id":123456789,"first_name":"John","last_name":"Doe","company":"Example Company","phone":"800-555-0102","street1":"123 example st.","street2":"101","city":"Toronto","province":"Ontario","province_code":"ON","country":"Canada","country_code":"CA","zip":"M5V 3L9","is_default":true,"created_at":"2019-11-20T20:31:55Z","updated_at":"2019-11-20T20:31:55Z"}],"default_address":{"id":0,"shop_identifier":"string","platform_id":0,"customer_id":0,"platform_type":"string","platform_customer_id":123456789,"first_name":"John","last_name":"Doe","company":"Example Company","phone":"800-555-0102","street1":"123 example st.","street2":"101","city":"Toronto","province":"Ontario","province_code":"ON","country":"Canada","country_code":"CA","zip":"M5V 3L9","is_default":true,"created_at":"2019-11-20T20:31:55Z","updated_at":"2019-11-20T20:31:55Z"},"subscription_summary":{"customer_id":0,"next_order_date":"2020-01-20T18:00:00Z","last_order_date":"2019-11-20T20:55:27Z","active_subscription_count":2,"inactive_subscription_count":0,"subscription_order_count":5},"labels":[{"id":0,"customer_id":0,"name":"bsub_subscription_active","created_at":"2019-11-20T20:31:55Z","updated_at":"2019-11-20T20:31:55Z","deleted_at":null}]},"shipping_lines":[{"id":0,"name":"Standard Shipping","code":"Standard Shipping","price":1000,"value":1000,"tag":"Shipping","created_at":"2019-11-20T20:31:55Z","updated_at":"2019-11-20T20:31:55Z","subscription_id":1}],"billing_address":{"id":0,"shop_identifier":"string","platform_id":0,"customer_id":0,"platform_type":"string","platform_customer_id":123456789,"first_name":"John","last_name":"Doe","company":"Example Company","phone":"800-555-0102","street1":"123 example st.","street2":"101","city":"Toronto","province":"Ontario","province_code":"ON","country":"Canada","country_code":"CA","zip":"M5V 3L9","is_default":true,"created_at":"2019-11-20T20:31:55Z","updated_at":"2019-11-20T20:31:55Z","deleted_at":"2019-11-20T20:31:55Z"},"shipping_address":{"id":0,"shop_identifier":"string","platform_id":0,"customer_id":0,"platform_type":"string","platform_customer_id":123456789,"first_name":"John","last_name":"Doe","company":"Example Company","phone":"800-555-0102","street1":"123 example st.","street2":"101","city":"Toronto","province":"Ontario","province_code":"ON","country":"Canada","country_code":"CA","zip":"M5V 3L9","is_default":true,"created_at":"2019-11-20T20:31:55Z","updated_at":"2019-11-20T20:31:55Z","deleted_at":"2019-11-20T20:31:55Z"},"idempotency_key":"JwGdN55C4g1z5FXRO8Hp21CMxUxKyo6VcGSf3cUsjCgNyTtoeZcIsGM1We4p7pCe-0","created_at":"2019-11-20T20:31:55Z","updated_at":"2019-11-20T20:31:55Z","percent_discount":10,"discount_code":"DISCOUNTCODE","customer_id":1697912,"billing_address_id":11697812,"shipping_address_id":11697812,"note":"Staff note","order_note":"Customer note"}}}}},"SubscriptionOrderTransactionFailed":{"title":"SubscriptionOrderTransactionFailed","type":"object","properties":{"id":{"type":"integer","example":123},"bold_platform_subscription_id":{"type":"integer","example":234},"shop_platform_app_id":{"type":"integer","example":345},"failure_reason":{"type":"string","example":"cashier"},"cashier_response":{"type":"string","example":"{\\"success\\":false,\\"errors\\":{\\"code\\":\\"order_creation_failed\\",\\"message\\":\\"\\",\\"service\\":\\"cashier\\",\\"service_type\\":\\"cashier\\"}}"},"current_retries":{"type":"integer","example":3},"max_retries":{"type":"integer","example":3},"created_at":{"type":"string","format":"date-time","example":"2019-11-20T20:31:55Z"},"customer":{"$ref":"#/components/schemas/CustomerEntity"}},"required":["id","bold_platform_subscription_id","shop_platform_app_id","failure_reason","cashier_response","current_retries","max_retries","created_at","shop_identifier"]},"SubscriptionUpdateLineItemsEntity":{"allOf":[{"type":"object","x-examples":{},"properties":{"id":{"type":"integer","example":1,"readOnly":true},"external_id":{"type":"string","nullable":true},"customer":{"example":"null"},"shop_id":{"type":"integer","example":1,"readOnly":true},"next_order_datetime":{"type":"string","example":"2020-01-20T18:00:00Z"},"next_payment_datetime":{"type":"string","example":"2020-01-20T18:00:00Z"},"next_processing_datetime":{"type":"string","example":"2020-01-20T18:00:00Z"},"subscription_status":{"type":"string","enum":["active","inactive","paused","scheduled","processing","app_uninstalled","waiting_sca_authorization"],"example":"active"},"status_changed_at":{"type":"string","example":"2019-11-20T20:31:55Z","format":"date-time","readOnly":true},"sca_url":{"type":"string","example":"https://bank.com/pCkWhtgQQVM8W/sca","nullable":true,"readOnly":true},"payment_method_token":{"type":"string","example":"jik1w6HrCn17CxXPcKwHTGqqvm8wLDd1PelY6k8mabglNmL8XKBnsde9PdgKZqnG"},"payment_gateway_public_id":{"type":"string","example":"jik1w6HrCn17CxXPcKwHTGqqvm8wLDd1PelY6k8mabglNmL8XKBnsde9PdgKZqnG","nullable":true},"payment_rrule":{"type":"string","example":"DTSTART:20200120T180000Z\\\\nRRULE:FREQ=MONTHLY\\\\nEXDATE:20200220T180000Z"},"payment_rrule_text":{"type":"string","example":"Monthly","nullable":true},"order_rrule":{"type":"string","example":"DTSTART:20200120T180000Z\\\\nRRULE:FREQ=MONTHLY\\\\nEXDATE:20200220T180000Z"},"order_rrule_text":{"type":"string","example":"Monthly","nullable":true},"last_payment_datetime":{"type":"string","example":"2019-11-20T20:55:26Z","nullable":true},"last_order_datetime":{"type":"string","example":"2019-11-20T20:55:26Z","nullable":true},"last_processed_datetime":{"type":"string","example":"2019-11-20T20:55:26Z","nullable":true},"current_retries":{"type":"integer","example":3},"charged_currency":{"type":"string","example":"CAD"},"base_to_charged_exchange_rate":{"type":"integer","example":1},"base_currency":{"type":"string","example":"CAD"},"line_items":{"type":"array","items":{"$ref":"#/components/schemas/UpdateLineItemEntity"},"readOnly":true},"shipping_lines":{"type":"array","items":{"$ref":"#/components/schemas/ShippingLineEntity"},"readOnly":true},"billing_address":{"$ref":"#/components/schemas/CustomerAddressEntity"},"shipping_address":{"$ref":"#/components/schemas/CustomerAddressEntity"},"idempotency_key":{"type":"string","example":"JwGdN55C4g1z5FXRO8Hp21CMxUxKyo6VcGSf3cUsjCgNyTtoeZcIsGM1We4p7pCe-0"},"placed_at":{"type":"string","example":"2012-11-20T20:31:55Z","format":"data-time","nullable":true},"created_at":{"type":"string","example":"2019-11-20T20:31:55Z","format":"date-time","readOnly":true},"updated_at":{"type":"string","example":"2019-11-20T20:31:55Z","format":"date-time","readOnly":true},"percent_discount":{"type":"number","example":10,"nullable":true,"readOnly":true},"discount_code":{"type":"string","example":"DISCOUNTCODE","readOnly":true},"customer_id":{"type":"integer","example":1697912,"readOnly":true},"billing_address_id":{"type":"integer","example":11697812},"shipping_address_id":{"type":"integer","example":11697812},"orders_processed":{"type":"integer","example":1,"nullable":true},"last_failure_code":{"type":"string","example":"card_expired","description":"This code may help to identify the type of the error.","nullable":true,"enum":["alt_pp_payment_method_required","bigcommerce_error","card_declined","card_expired","credit_card_not_found","discount_code_use_limit","insufficient_funds","invalid_billing_address","invalid_bold_api_token","invalid_card_expiration_month","invalid_card_expiration_year","invalid_card_number","invalid_customer_email","invalid_discount_code","invalid_payment_method","invalid_security_code","invalid_shipping_address","invalid_zip_code","no_payment_provider","payment_method_declined","shopify_error","stripe_support_required","transaction_declined","out_of_stock_product","unaccepted_credit_card","unknown_error","unsupported_card","unsupported_purchase_type","unsupported_shipping_address","woocommerce_error"]},"last_failure_details":{"type":"object","nullable":true,"description":"Default error messages for the last_failure_code field","required":["message"],"properties":{"message":{"type":"string","description":"Error message","example":"The order couldn\'t process because the card was declined.","nullable":false}}},"last_failure_reason":{"type":"string","example":"credit_card","description":"The reason for the failure","nullable":true,"enum":["credit_card","gateway","cashier","platform","inventory","other"]}}},{"$ref":"#/components/schemas/SubscriptionNotesEntity"}],"required":["id","external_id","customer","shop_id","next_order_datetime","next_payment_datetime","next_processing_datetime","subscription_status","status_changed_at","payment_method_token","payment_gateway_public_id","payment_rrule","payment_rrule_text","order_rrule","order_rrule_text","last_payment_datetime","last_order_datetime","last_processed_datetime","current_retries","charged_currency","base_to_charged_exchange_rate","base_currency","idempotency_key","created_at","updated_at","percent_discount","customer_id","billing_address_id","shipping_address_id","note","order_note"]},"CursorPagination":{"type":"object","title":"CursorPagination","description":"Pagination result for cursor-based paginated endpoints.","properties":{"total":{"type":"integer","example":15,"readOnly":true},"count":{"type":"integer","example":10,"readOnly":true},"per_page":{"type":"integer","example":10,"readOnly":true},"total_pages":{"type":"integer","example":2,"readOnly":true},"next":{"type":"string","example":"P3NpbmNlX2lkPTE1Mjc0Jm9yZGVyX2J5PWlkJm9yZGVyX2RpcmVjdGlvbj1kZXNj","readOnly":true,"nullable":true}},"readOnly":true},"FutureOrdersCursorPagination":{"type":"object","title":"FutureOrdersCursorPagination","description":"Cursor-based pagination result for future orders endpoints.","properties":{"count":{"type":"integer","description":"The count of items on the current response.","example":10},"next":{"type":"string","nullable":true,"description":"A base-64 encoded cursor that can be used on subsequent requests to get the next page. The value is `null` when no pages remain.","example":"P3NpbmNlX2lkPTE1Mjc0Jm9yZGVyX2J5PWlkJm9yZGVyX2RpcmVjdGlvbj1kZXNj"}},"readOnly":true},"SubscriptionsCursorPagination":{"type":"object","title":"CursorPagination","description":"Pagination result for cursor-based paginated endpoints.","properties":{"next":{"type":"string","example":"P3NpbmNlX2lkPTE1Mjc0Jm9yZGVyX2J5PWlkJm9yZGVyX2RpcmVjdGlvbj1kZXNj","readOnly":true},"prev":{"type":"string","example":"P3NpbmNlX2lkPTE1Mjc0Jm9yZGVyX2J5PWlkJm9yZGVyX2RpcmVjdGlvbj1kZXNj","readOnly":true}},"readOnly":true},"PatchLineItemEntity":{"type":"object","title":"","description":"The line item to be updated. Fields marked as **read-only** cannot be updated using this endpoint. Use the property\'s existing value for those fields.","properties":{"id":{"type":"integer","example":1,"nullable":true,"description":"**Read-only.** \\n\\nLine item identifier."},"subscription_id":{"type":"integer","example":1,"nullable":true,"description":"**Read-only.** \\n\\nSubscription identifier."},"platform_id":{"type":"string","example":"ABC123","description":"**Read-only.** \\n\\nIdentifier from the platform."},"platform_product_id":{"type":"string","example":"1357908642","nullable":true,"description":"**Read-only.** \\n\\nProduct identifier from the platform."},"platform_variant_id":{"type":"string","example":"2468097531","nullable":true,"description":"**Read-only.** \\n\\nVariant identifier from the platform."},"subscription_group_id":{"type":"integer","example":1,"description":"Subscription group identifier."},"subscription_group_billing_rules_id":{"type":"integer","example":1,"nullable":true,"description":"Billing rules identifier for the subscription group."},"title":{"type":"string","example":"Monthly Expansion Pack","description":"Line item title."},"product_name":{"type":"string","example":"Monthly Expansion Pack","nullable":true,"description":"**Read-only.** \\n\\nProduct name."},"variant_name":{"type":"string","example":"Default Title","nullable":true,"description":"**Read-only.** \\n\\nVariant name."},"sku":{"type":"string","example":"SKU-113-Red","description":"Product SKU."},"url":{"type":"string","example":"https://example-store.example.com/monthly-expansion-pack","description":"**Read-only.** \\n\\nProduct URL."},"image":{"type":"string","example":"","description":"Product image."},"quantity":{"type":"integer","example":1,"description":"Product quantity."},"price":{"type":"integer","example":3500,"nullable":true,"description":"Product price. If changed, all related `price` fields may be impacted. If omitted, the price will be used from the exising line item when updating or the matching product when adding a new line item."},"price_charged":{"type":"integer","example":3200,"nullable":true,"description":"**Read-only.** \\n\\nInfluenced by changes made to the `price` field."},"discounted_price":{"type":"integer","example":3200,"description":"**Read-only.** \\n\\nInfluenced by changes made to the `price` field."},"discounted_price_charged":{"type":"integer","example":3200,"description":"**Read-only.** \\n\\nInfluenced by changes made to the `price` field."},"full_price":{"type":"integer","example":3200,"description":"**Read-only.** \\n\\nInfluenced by changes made to the `price` field."},"full_price_charged":{"type":"integer","example":3200,"description":"**Read-only.** \\n\\nInfluenced by changes made to the `price` field."},"requires_shipping":{"type":"boolean","example":false,"description":"Whether or not the line item requires shipping."},"grams":{"type":"integer","example":2200,"description":"Product weight in grams."},"weight":{"type":"number","example":2.2,"description":"Product weight in `weight_unit`."},"weight_unit":{"type":"string","example":"kg","description":"Unit used for `weight`."},"taxable":{"type":"boolean","example":true,"description":"Whether or not the line item is taxable."},"discounts":{"type":"array","items":{"$ref":"#/components/schemas/LineItemDiscountEntity"},"description":"**Read-only.** \\n\\nAll discounts associated with the line item."},"prepaid_metadata":{"type":"object","description":"**Read-only.**\\n\\nPrepaid properties, as defined in the [Create Line Item Prepaid Metadata](/api/subscriptions#tag/Subscription-Line-Items/operation/CreateLineItemPrepaidMetadata) and [Update Line Item Prepaid Metadata](/api/subscriptions#tag/Subscription-Line-Items/operation/UpdateLineItemPrepaidMetadata) endpoint. Set to `null` when using the [Update Subscription Line Items](/api/subscriptions#tag/Subscription-Line-Items/operation/UpdateLineItems) endpoint.","nullable":true,"enum":[null],"example":null},"line_item_attributes":{"type":"array","items":{"$ref":"#/components/schemas/LineItemAttributeEntity"},"description":"**Read-only.** \\n\\nAdditional attributes associated with the line item. \\n\\nUse the [Update Line Item Attributes](subscriptions#operation/UpdateLineItemAttributes) endpoint to add, update, or delete line item attributes."},"created_at":{"type":"string","example":"2019-11-20T20:31:55Z","format":"date-time","readOnly":true},"updated_at":{"type":"string","example":"2019-11-20T20:31:55Z","format":"date-time","readOnly":true}},"required":["id","subscription_id","platform_id","platform_product_id","platform_variant_id","subscription_group_id","subscription_group_billing_rules_id","title","product_name","variant_name","sku","url","image","quantity","price_charged","discounted_price","discounted_price_charged","full_price","requires_shipping","grams","weight","weight_unit","taxable","discounts","prepaid_metadata"],"readOnly":true},"createdAt":{"type":"string","description":"The date and time when the object was created.","example":"2022-12-25T00:00:00Z","format":"date-time","readOnly":true},"updatedAt":{"type":"string","description":"The date and time when the object was most recently updated.","example":"2022-12-25T00:00:00Z","format":"date-time","readOnly":true,"nullable":true},"deletedAt":{"type":"string","description":"The date and time when the object was deleted. Set to `null` when the object was not deleted.","example":"2022-12-25T00:00:00Z","format":"date-time","nullable":true}},"parameters":{"shop_identifier_path_param":{"name":"shop_identifier","in":"path","description":"The unique identifier of the shop.","required":true,"schema":{"type":"string","example":"123456"}},"customer_id_path_param":{"name":"customer_id","in":"path","description":"The customer identifier.","required":true,"schema":{"type":"integer","example":12}},"address_id_path_param":{"name":"address_id","in":"path","description":"The address identifier.","required":true,"schema":{"type":"integer"}},"subscription_id_path_param":{"name":"subscription_id","in":"path","description":"The subscription identifier.","required":true,"schema":{"type":"integer"}},"subscription_adjustment_id_path_param":{"name":"adjustment_id","in":"path","description":"The subscription adjustment identifier.","required":true,"schema":{"type":"integer"}},"convertible_adjustment_group_id_path_param":{"name":"adjustment_id","in":"path","description":"The convertible adjustment group identifier, obtained from calling [Create Convertible Adjustment Group](/api/subscriptions#tag/Convertible-Adjustments/operation/CreateConvertibleAdjustmentGroup).","required":true,"schema":{"type":"integer"}},"convertible_adjustment_group_item_id_path_param":{"name":"adjustment_item_id","in":"path","description":"The convertible adjustment group item identifier, obtained from calling [Create Convertible Adjustment Group Items](/api/subscriptions#tag/Convertible-Adjustments/operation/CreateConvertibleAdjustmentGroupItems).","required":true,"schema":{"type":"integer"}},"filter_subscription_adjustments_query_param":{"schema":{"type":"string"},"in":"query","name":"filter","description":"Accepts filtering options as described in [Query & Pagination](/guides/getting-started/query-pagination). For example, to limit the request to all future adjustments to individual orders, the following query param may be added: `?filter=eq(target:order)`"},"order_id_path_param":{"name":"order_id","in":"path","description":"The order identifier.","required":true,"schema":{"type":"integer"}},"subscription_interval_id_path_param":{"name":"subscription_interval_id","in":"path","description":"The subscription interval identifier.","required":true,"schema":{"type":"integer"}},"line_item_id_path_param":{"name":"line_item_id","in":"path","description":"Line item ID to view and manage data for.","required":true,"schema":{"type":"integer"}},"group_id_path_param":{"name":"group_id","in":"path","description":"The subscription group identifier.","required":true,"schema":{"type":"integer"}},"webhook_subscription_id_path_param":{"name":"webhook_subscription_id","in":"path","description":"The webhook subscription identifier.","required":true,"schema":{"type":"integer"}},"webhook_event_id_path_param":{"name":"webhook_event_id","in":"path","description":"The webhook event identifier.","required":true,"schema":{"type":"integer"}},"limit":{"name":"limit","in":"query","required":false,"description":"The maximum number of results to be returned.","schema":{"type":"integer","example":10,"default":50}},"page":{"name":"page","in":"query","required":false,"description":"The page to request.","schema":{"type":"integer","default":1,"example":2}},"cursor":{"name":"cursor","in":"query","required":false,"description":"A Base-64 encoded cursor. Used to get a page of data on a cursor paginated request. Obtained from the response of a previous request.","schema":{"type":"string","example":"P3NpbmNlX2lkPTE1Mjc0Jm9yZGVyX2J5PWlkJm9yZGVyX2RpcmVjdGlvbj1kZXNj"}},"filter_future_orders_query_param":{"schema":{"type":"string","example":"lte(order_datetime:2024-05-10T23:59:59)"},"in":"query","name":"filter","description":"Filter future orders. Accepts filtering options as described in the [Query and Pagination](/guides/subscriptions-v2/resources/query-pagination) reference."},"filter_future_order_subscriptions_query_param":{"schema":{"type":"string","example":"eq(bold_customer_id:3623267)"},"in":"query","name":"subscription_filter","description":"Filter future orders. Accepts filtering options as described in the [Query and Pagination](/guides/subscriptions-v2/resources/query-pagination) reference.\\n\\nTo see available filters, refer to the [Future Orders](/guides/subscriptions-v2/view-future-orders) guide."},"customerStatus":{"name":"status","in":"query","required":false,"description":"Customer status to filter.","schema":{"type":"string","enum":["all","active","inactive"],"default":"all","example":"active"}},"customerSearch":{"name":"search","in":"query","required":false,"description":"Search with a specific target. It\'s possible to search by subscription ID or phone number.","schema":{"type":"string"},"examples":{"bySubscription":{"summary":"By subscription ID","value":"#1234"},"byPhone":{"summary":"By phone","value":"123456"}}},"event_actor_type_header":{"in":"header","name":"Event-Actor-Type","required":true,"description":"The type of actor that triggered the webhook event.","schema":{"type":"string","enum":["store_admin","customer","integration","subscription_app"]}},"shop_identifier_header":{"in":"header","name":"Shop-Identifier","required":true,"description":"The unique identifier of the shop.","schema":{"type":"string","enum":["{$request.path.shop_identifier}"]}},"latest":{"in":"query","name":"latest","required":false,"description":"If set to `true`, returns the most recent selection option for each distinct `platform_entity_id` in the response.\\n\\nThis is useful when using the `expand=subscription_group` query parameter by returning only the most recent subscription group a product was added to.","schema":{"type":"boolean","default":false},"example":true}}}}},"plugin-redoc-10":{"url":"/api/checkout-admin.openapi.yaml","themeId":"theme-redoc","isSpecFile":true,"spec":{"openapi":"3.0.0","info":{"title":"Checkout Admin","version":"2.0","description":"Use the Checkout Admin API to configure store-level settings. This includes the ability to configure overrides.\\n\\nRefer to the changelog for the latest updates to this API.","termsOfService":"https://boldcommerce.com/terms-of-service","contact":{"name":"Contact Us","url":"https://developer-dashboard.boldcommerce.com/default/contactus"}},"servers":[{"url":"https://api.boldcommerce.com"}],"security":[{"OAuthToken":[]},{"APIAccessToken":[]}],"tags":[{"name":"Cross Origin Resource Sharing (CORS)","description":"Contains information about the domains that can access the Bold Checkout APIs. Use these endpoints to manage the approved domains."},{"name":"External Payment Gateways","description":"Contains information about an external payment gateway that can be integrated into a store\'s checkout experience. Use these endpoints to manipulate the external payment gateways for a store."},{"name":"Gift Cards","description":"Contains information about Gift Cards on a given store. Use this endpoint to get all data associated with a Gift Card for a store."},{"name":"Integrations","description":"Contains a shared secret, which is used to configure the webhooks that your integration uses."},{"name":"Lightweight Frontend Experience (LiFE) Elements","description":"Contains information about the Checkout Lightweight Frontend Experience (LiFE) Elements, which enable you to add custom elements into your checkout experience. Use these endpoints to add, edit, and delete elements."},{"name":"Overrides","description":"Contains information about the API overrides on a given store, such as the override type, redirect URL, and shared secret. Use these endpoints to manipulate overrides for a store."},{"name":"Payment CSS","description":"Contains information about the CSS used to style the [Secure Payments Interface (SPI)](/guides/checkout/resources/glossary#secure-payments-interface-spi). Use these endpoints to manipulate the SPI iFrame for all orders on a store."},{"name":"Remote State Authority","description":"Contains information about the Remote State Authority on a given store, such as the URL and shared secret. Use these endpoints to manipulate configuration details for the Remote State Authority for a store. Refer to [Create a Checkout Remote State Authority](/default/guides/platform-connector/rsa/create-checkout-rsa) for more information."},{"name":"Saved Payment Methods","description":"Contains information about customers\' payment methods. Use these endpoints to retrieve or modify saved payment methods."},{"name":"Shops","description":"Contains information about the store\'s checkout configuration, which is set in the [Bold Checkout admin](https://apps.boldapps.net/accounts/app/4)."},{"name":"Tax Zone Settings","description":"Contains information about tax providers for individual tax zones."},{"name":"Warehouses","description":"Contains information about the warehouses for a given store. This information is required to retrieve shipping rates and calculate taxes."},{"name":"Webhooks","description":"Contains information about the webhooks registered on a given store. Use these endpoints to manipulate the webhooks registered on your store."},{"name":"Zones","description":"Contains information about the [zones](/guides/checkout/resources/glossary#zone) for a given store. Use these endpoints to manipulate the [shipping zones](/guides/checkout/resources/glossary#shipping-zone), [tax zones](/guides/checkout/resources/glossary#tax-zone), and [warehouse zones](/guides/checkout/resources/glossary#warehouse-zone) for a store.\\n\\n> **Tip:** Some operations in Checkout require at least one zone to be created. If you have no interest in specific regions, you can use a [default zone](/guides/checkout/resources/glossary#default-zone) instead.\\n"}],"externalDocs":{"description":"For more information about Checkout, refer to the Overview.","url":"https://developer.boldcommerce.com/guides/checkout"},"paths":{"/checkout/shop/{shop_identifier}/cors":{"parameters":[{"$ref":"#/components/parameters/shop_identifier"}],"post":{"summary":"Add Domain to CORS Allowlist","operationId":"AddDomainCORSAllowlist","tags":["Cross Origin Resource Sharing (CORS)"],"description":"Adds a domain to the list of domains with permission to call the Bold Checkout APIs.\\n\\nUse this endpoint if you are self-hosting your checkout. This endpoint is also required to enable self-hosted development stores to call the Bold Checkout APIs.","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"domain":{"$ref":"#/components/schemas/CORSDomain"}}}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/CORSDomainList"}}}},"examples":{"CORSDomains":{"$ref":"#/components/examples/CORSDomainsExample"}}}}},"500":{"$ref":"#/components/responses/UnknownError"}}},"get":{"summary":"Get CORS Allowlist","operationId":"GetCORSAllowlist","tags":["Cross Origin Resource Sharing (CORS)"],"description":"Retrieves the list of domains with permission to call the Bold Checkout APIs.","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"oneOf":[{"type":"object","description":"The list of domains on the CORS allowlist.","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/CORSDomainList"}}}},{"type":"object","description":"An empty object, indicating that there are no domains in the CORS allowlist.","properties":{"data":{"type":"object","maxProperties":0}}}]},"examples":{"CORSDomains":{"$ref":"#/components/examples/CORSDomainsExample"},"NoCORSDomains":{"value":{"data":{}}}}}}},"500":{"$ref":"#/components/responses/UnknownError"}}}},"/checkout/shop/{shop_identifier}/cors/{domain_id}":{"parameters":[{"$ref":"#/components/parameters/shop_identifier"},{"$ref":"#/components/parameters/domain_id"}],"delete":{"summary":"Delete Domain from CORS Allowlist","operationId":"DeleteDomainFromCORSAllowlist","tags":["Cross Origin Resource Sharing (CORS)"],"description":"Deletes a domain from the list of domains with permission to call the Bold Checkout APIs. Specify the domain to be deleted using the `domain_id` in the request route.","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","maxLength":0,"items":{}}}}},"404":{"description":"Domain ID does not exist","content":{"application/json":{"schema":{"type":"array","maxLength":0,"items":{}}}}}}}},"/checkout/shop/{shop_identifier}/life_elements":{"parameters":[{"$ref":"#/components/parameters/shop_identifier"}],"post":{"summary":"Create Element","operationId":"CreateElement","tags":["Lightweight Frontend Experience (LiFE) Elements"],"description":"Adds a LiFE element to the store\'s checkout at a specific location. For more information about the locations and where they are, refer to the [Checkout LiFE guide](/guides/checkout/life).","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LiFE_element"}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"life_elements":{"$ref":"#/components/schemas/LiFE_element"}}}}}}}},"422":{"description":"Unprocessable entity","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Errors"},"examples":{"NameFieldIsRequired":{"value":{"errors":[{"code":"02-94","type":"life_element.invalid_life_element_data","message":"The meta_data_field is required.","details":{}}]}}}}}}}},"get":{"summary":"List Elements","operationId":"ListElements","tags":["Lightweight Frontend Experience (LiFE) Elements"],"description":"Lists the LiFE elements that are associated with a given store\'s checkout.","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"life_elements":{"type":"array","uniqueItems":true,"items":{"$ref":"#/components/schemas/LiFE_element"}}}}}}}}}}}},"/checkout/shop/{shop_identifier}/life_elements/{public_element_id}":{"parameters":[{"$ref":"#/components/parameters/shop_identifier"},{"$ref":"#/components/parameters/public_element_id"}],"patch":{"summary":"Update Element","operationId":"UpdateElement","tags":["Lightweight Frontend Experience (LiFE) Elements"],"description":"Updates a LiFE element that already exists on a store\'s checkout. You can edit any of the element\'s attributes using this endpoint.","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"life_elements":{"$ref":"#/components/schemas/LiFE_element"}}}}}}}},"422":{"description":"Unprocessable request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Errors"},"examples":{"LifeElementNotFound":{"value":{"errors":[{"code":"02-94","type":"life_element.life_element_not_configured","message":"LiFE element with the given `public_id` not found.","details":{}}]}}}}}}},"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LiFE_element"}}}}},"delete":{"summary":"Delete Element","operationId":"DeleteElement","description":"Removes a LiFE element from a store\'s checkout.","tags":["Lightweight Frontend Experience (LiFE) Elements"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object"}}}}}},"422":{"description":"Unprocessable request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Errors"},"examples":{"LifeElementNotFound":{"value":{"errors":[{"code":"02-91","type":"life_element.life_element_not_configured","message":"LiFE element with the given `public_id` not found.","details":{}}]}}}}}}}}},"/checkout/shop/{shop_identifier}/external_payment_gateways":{"parameters":[{"$ref":"#/components/parameters/shop_identifier"}],"post":{"summary":"Create External Payment Gateway","operationId":"CreateExternalPaymentGateway","tags":["External Payment Gateways"],"description":"Adds an external payment gateway to a store.","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"external_payment_gateway":{"$ref":"#/components/schemas/ExternalPaymentGateway"}}}}},"examples":{"example-1":{"value":{"data":{"external_payment_gateway":{"public_id":"VfYRxzOjRkwG6B2xWbxhPQ","name":"External Payment Gateway","base_url":"www.example.com/payments","iframe_url":"www.example.com/gateway","api_token":"XjqnSQWYAZXt","partial_capture":true,"additional_order_details":true,"provider_id":"8ad85ccf-7fd6-4f4b-a1a2-dff42fb3e228","currency":"CAD","location":"payment_method_below"}}}}}}}},"422":{"description":"Unprocessable entity","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Errors"},"examples":{"NameFieldIsRequired":{"value":{"errors":[{"code":"02-91","type":"external_payment_gateway.invalid_external_payment_gateway_data","message":"The name field is required.","details":{}}]}}}}}}},"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExternalPaymentGateway"},"examples":{"example-1":{"value":{"name":"External Payment Gateway","base_url":"www.example.com/payments","iframe_url":"www.example.com/gateway","api_token":"XjqnSQWYAZXt","partial_capture":true,"additional_order_details":true,"provider_id":"8ad85ccf-7fd6-4f4b-a1a2-dff42fb3e228","currency":"CAD","http_headers":[{"key":"foo","value":"bar"}],"location":"payment_method_below"}}}}}}},"get":{"summary":"List External Payment Gateways","operationId":"ListExternalPaymentGateways","tags":["External Payment Gateways"],"description":"Lists external payment gateways for a given store.","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"external_payment_gateways":{"type":"array","uniqueItems":true,"items":{"$ref":"#/components/schemas/ExternalPaymentGateway"}}}}}},"examples":{"example-1":{"value":{"data":{"external_payment_gateways":[{"public_id":"SqCAft3jGmwDVK8aQbhi2R","name":"First External Payment Gateway","base_url":"www.example-1.com/payments","iframe_url":"www.example-1.com/gateway","api_token":"XjqnSQWYAZXt","partial_capture":true,"additional_order_details":true,"provider_id":"5dgg27kce-2jd7-1h8v-j2f5-xsgn2di9s764","currency":"CAD","location":"payment_method_below","http_headers":[{"key":"foo","value":"bar"}]},{"public_id":"VfYRxzOjRkwG6B2xWbxhPQ","name":"Second External Payment Gateway","base_url":"www.example-2.com/payments","iframe_url":"www.example-2.com/gateway","api_token":"PjqnSQWYAZXz","partial_capture":true,"additional_order_details":true,"provider_id":"8ad85ccf-7fd6-4f4b-a1a2-dff42fb3e228","currency":"CAD","location":"payment_method_below","http_headers":null}]}}}}}}}}}},"/checkout/shop/{shop_identifier}/external_payment_gateways/{public_gateway_id}":{"parameters":[{"$ref":"#/components/parameters/shop_identifier"},{"$ref":"#/components/parameters/public_gateway_id"}],"patch":{"summary":"Update External Payment Gateway","operationId":"UpdateExternalPaymentGateway","tags":["External Payment Gateways"],"description":"Updates an external payment gateway on a store.","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"external_payment_gateway":{"$ref":"#/components/schemas/ExternalPaymentGateway"}}}}},"examples":{"example-1":{"value":{"data":{"external_payment_gateway":{"public_id":"VfYRxzOjRkwG6B2xWbxhPQ","name":"External Payment Gateway","base_url":"www.example.com/payments","iframe_url":"www.example.com/gateway","api_token":"XjqnSQWYAZXt","partial_capture":true,"additional_order_details":true,"provider_id":"8ad85ccf-7fd6-4f4b-a1a2-dff42fb3e228","currency":"CAD","http_headers":[{"key":"foo","value":"bar"}],"location":"payment_method_below"}}}}}}}},"422":{"description":"Unprocessable request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Errors"},"examples":{"PaymentGatewayNotFound":{"value":{"errors":[{"code":"02-91","type":"external_payment_gateway.not_found","message":"External payment gateway with the given `public_id` not found.","details":{}}]}}}}}}},"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExternalPaymentGateway"},"examples":{"example-1":{"value":{"name":"External Payment Gateway","base_url":"www.example.com/payments","iframe_url":"www.example.com/gateway","api_token":"XjqnSQWYAZXt","partial_capture":true,"additional_order_details":true,"provider_id":"8ad85ccf-7fd6-4f4b-a1a2-dff42fb3e228","currency":"CAD","http_headers":[{"key":"foo","value":"bar"}],"location":"payment_method_below"}}}}}}},"delete":{"summary":"Delete External Payment Gateway","operationId":"DeleteExternalPaymentGateway","description":"Removes an external payment gateway from a store.","tags":["External Payment Gateways"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object"}}}}}},"422":{"description":"Unprocessable request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Errors"},"examples":{"PaymentGatewayNotFound":{"value":{"errors":[{"code":"02-91","type":"external_payment_gateway.not_found","message":"External payment gateway with the given `public_id` not found.","details":{}}]}}}}}}}}},"/checkout/shop/{shop_identifier}/customer/{public_customer_id}/payment_methods":{"parameters":[{"$ref":"#/components/parameters/shop_identifier"},{"$ref":"#/components/parameters/public_customer_id"}],"get":{"summary":"List Saved Payment Methods","operationId":"ListSavedPaymentMethods","tags":["Saved Payment Methods"],"description":"Lists all saved payment methods for a specific customer.","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/CustomerPaymentMethods"}}},"example":{"success":true,"cards":[{"type":"credit_card","public_id":"ZdtkGke3jqR4qeI9IvtrHaRQZxdobJ5SaGdcX7V22O0v2U5bBqDGb6FHAkpPk4KS","is_default":false,"cc_type":"Visa","last_four":"1111","expiration":{"date":"2023-11"}}]}}}}}}},"/checkout/shop/{shop_identifier}/customer/stored-cards/{public_payment_id}":{"parameters":[{"$ref":"#/components/parameters/shop_identifier"},{"$ref":"#/components/parameters/public_payment_id"}],"delete":{"summary":"Delete Saved Payment Method","operationId":"DeleteSavedPaymentMethod","tags":["Saved Payment Methods"],"description":"Deletes the saved payment method associated with a public payment identifier.","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/DeletePaymentMethod"}}},"examples":{"OneOrMorePaymentMethodsRemaining":{"value":{"success":true,"defaultCardId":1}},"NoRemainingPaymentMethods":{"value":{"success":true,"defaultCardId":""}}}}}}}}},"/checkout/shop/{shop_identifier}/overrides":{"parameters":[{"$ref":"#/components/parameters/shop_identifier"}],"post":{"summary":"Create API Override","operationId":"CreateAPIOverride","tags":["Overrides"],"description":"Creates an API override for a given store. The API override is used to customize base functionality. Store level API overrides will apply to all orders, but per-order overrides may take priority. For more information, refer to [API Overrides](/guides/checkout/api-overrides).","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OverrideRequest"}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/OverrideConfig"}}},"examples":{"example-1":{"value":{"data":{"public_id":"1","override_type":"discount","url":"https://example.com/overrides/callback_url","created_at":"2021-11-17 21:03:36","updated_at":"2021-11-17 21:03:36"}}}}}}},"422":{"description":"Unprocessable Entity","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorsV1"},"examples":{"OverrideTypeDoesNotExist":{"value":{"errors":[{"message":"The override_type does not exist.","type":"api_override","field":"override_type","severity":"validation","sub_type":"api_override"}]}},"InvalidURL":{"value":{"errors":[{"message":"The `url` field must be a valid url.","type":"api_override","field":"url","severity":"validation","sub_type":"api_override"}]}}}}}}}},"get":{"summary":"List API Overrides","operationId":"ListAPIOverrides","tags":["Overrides"],"description":"Retrieves a list of registered API overrides for a given store.","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","uniqueItems":true,"items":{"$ref":"#/components/schemas/OverrideConfig"}}}},"examples":{"example-1":{"value":{"data":[{"public_id":"1","override_type":"discount","url":"https://example.com/overrides/discount","created_at":"2021-11-17 21:03:36","updated_at":"2021-11-17 21:03:36"},{"public_id":"2","override_type":"shipping","url":"https://example.com/overrides/shipping","created_at":"2021-11-17 21:03:36","updated_at":"2021-11-17 21:03:36"}]}}}}}}}}},"/checkout/shop/{shop_identifier}/overrides/{public_id}":{"parameters":[{"$ref":"#/components/parameters/shop_identifier"},{"schema":{"type":"string"},"name":"public_id","in":"path","required":true,"description":"The identifier for the affected API override."}],"patch":{"summary":"Update API Override","operationId":"UpdateAPIOverride","tags":["Overrides"],"description":"Updates the given override. Enables the caller to update the `url` property, the `override_type` property, or both, for a given API override. A store can have more than one API override of the same type.","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OverrideRequest"},"example":{"override_type":"discount","url":"https://example.com/overrides/updated_callback_url","shared_secret":"aq9834g4aqkdwa0"}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/OverrideConfig"}}},"examples":{"UpdatedCallbackURL":{"value":{"data":{"public_id":"1","override_type":"discount","url":"https://example.com/overrides/updated_callback_url","created_at":"2021-11-17 21:03:36","updated_at":"2021-11-20 215:09:22"}}}}}}},"422":{"description":"Unprocessable Entity","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorsV1"},"examples":{"OverrideTypeDoesNotExist":{"value":{"errors":[{"message":"The override_type does not exist.","type":"api_override","field":"override_type","severity":"validation","sub_type":"api_override"}]}},"InvalidURL":{"value":{"errors":[{"message":"The `url` field must be a valid url.","type":"api_override","field":"url","severity":"validation","sub_type":"api_override"}]}}}}}}}},"delete":{"summary":"Delete API Override","operationId":"DeleteAPIOverride","tags":["Overrides"],"description":"Delete an API override from the given store.","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object"}}}}}},"422":{"description":"Unprocessable Entity","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorsV1"},"examples":{"MissingPublicID":{"value":{"errors":[{"message":"The `public id` field is required.","type":"api_override","field":"public_id","severity":"validation","sub_type":"api_override"}]}}}}}}}}},"/checkout/shop/{shop_identifier}/rsa_config":{"parameters":[{"$ref":"#/components/parameters/shop_identifier"}],"post":{"summary":"Connect Remote State Authority","operationId":"ConnectRemoteStateAuthority","tags":["Remote State Authority"],"description":"Connects Remote State Authority to a given shop.","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","description":"The destination URL to which a request will be made when order state changes occur.","example":"https://example.com/my_remote_state_authority"},"shared_secret":{"type":"string","description":"Your shared secret, which can be any string you choose. Bold uses this string and the current date to create a signature for each request.","minLength":8,"maxLength":255,"example":"d5210fa5563dd4f5b06f00d0"}},"required":["url","shared_secret"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/RemoteStateAuthorityConfig"}}}}}},"422":{"description":"Unprocessable Entity","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Errors"},"examples":{"Invalid URL":{"value":{"errors":[{"code":"02-89","type":"remote_state_authority.rsa_already_configured","message":"Remote State Authority already configured. Please update configuration instead."}]}}}}}}}},"patch":{"summary":"Update Remote State Authority Connection","operationId":"UpdateRemoteStateAuthorityConnection","tags":["Remote State Authority"],"description":"Updates connection to a Remote State Authority for a given shop.","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","description":"The destination URL to which a request will be made when order state changes occur.","example":"https://example.com/my_remote_state_authority"},"shared_secret":{"type":"string","description":"Your shared secret, which can be any string you choose. Bold uses this string and the current date to create a signature for each request.","minLength":8,"maxLength":255,"example":"d5210fa5563dd4f5b06f00d0"}}}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/RemoteStateAuthorityConfig"}}}}}},"422":{"description":"Unprocessable Entity","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Errors"},"examples":{"Invalid URL":{"value":{"errors":[{"code":"02-89","type":"remote_state_authority.rsa_not_configured","message":"Remote State Authority not configured."}]}}}}}}}},"get":{"summary":"Get Remote State Authority","operationId":"GetRemoteStateAuthority","tags":["Remote State Authority"],"description":"Gets Remote State Authority connection details for a given shop.","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/RemoteStateAuthorityConfig"}}},"examples":{"ConfigurationFound":{"value":{"data":{"remote_state_authority":{"url":"https://example.com/my_remote_state_authority"}}}},"ConfigurationNotFound":{"value":{"data":{"remote_state_authority":null}}}}}}}}},"delete":{"summary":"Delete Remote State Authority","operationId":"DeleteRemoteStateAuthority","tags":["Remote State Authority"],"description":"Removes Remote State Authority functionality for a given shop.","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"remote_state_authority":{}}}}}}}},"422":{"description":"Unprocessable Entity","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Errors"},"examples":{"Remote State Authority not configured":{"value":{"errors":[{"code":"02-89","type":"remote_state_authority.rsa_not_configured","message":"Remote State Authority not configured."}]}}}}}}}}},"/checkout/shop/{shop_identifier}/gift_card":{"parameters":[{"$ref":"#/components/parameters/shop_identifier"}],"get":{"summary":"Get Gift Card","operationId":"GetGiftCard","tags":["Gift Cards"],"description":"Gets a gift card on a given shop, specified by either the `public_payment_method_id` or a combination of the `card_token` and `card_pin`.\\n\\nFor more information, refer to the [Manage Gift Cards](/guides/checkout/gift-cards) guide.","parameters":[{"in":"query","name":"params","required":true,"style":"form","explode":true,"schema":{"type":"object","oneOf":[{"type":"object","title":"Public Payment Method Id","properties":{"public_payment_method_id":{"type":"string","description":"The payment public ID of the gift card, assigned when configured as a customer\'s payment method.","example":"i5uATT2QVKlozoDA2msg89w3mWAdPTIeLtED44R1SJYUVuI7jO4NqHdM8vjoqq7A7P"}},"required":["public_payment_method_id"]},{"type":"object","title":"Card Token and Pin","properties":{"card_token":{"type":"string","description":"The gift card token.","example":"AJPG-TPOE-FNAA-MDEH"},"card_pin":{"type":"string","description":"The gift card PIN.","example":"937"}},"required":["card_token","card_pin"]}]}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"gift_card":{"$ref":"#/components/schemas/GiftCard"}}}}},"examples":{"GiftCardFound":{"value":{"data":{"gift_card":{"card_token":"OAVXDVRAJUGFMHEK","amount":5000,"balance":2575,"recipient_name":"John","recipient_email":"john.smith@example.com","message":"Enjoy this gift certificate from us.","expiry_date":"2025-04-01","customer_name":"Jane","customer_email":"jane.doe@example.com"}}}}}}}},"422":{"description":"Unprocessable entity","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Errors"},"examples":{"Provide either public_payment_method_id or card_token and PIN":{"value":{"errors":[{"code":"02-50","type":"gift_cards.invalid_gift_card_data","message":"Please provide one of `public payment method id` or `card token` and `card pin`."}]}},"The card_pin is required":{"value":{"errors":[{"code":"02-50","type":"gift_cards.invalid_gift_card_data","message":"The card pin field is required when the `card token` field is present."}]}},"Gift Card not found":{"value":{"errors":[{"code":"02-87","type":"gift_cards.gift_card_not_found","message":"The gift card was not found."}]}}}}}},"500":{"$ref":"#/components/responses/UnknownError"}}}},"/checkout/shop/{shop_identifier}/integration/config":{"parameters":[{"$ref":"#/components/parameters/shop_identifier"}],"post":{"summary":"Configure Integration Settings","operationId":"ConfigureIntegrationSettings","tags":["Integrations"],"description":"Configures webhooks to integrate with your shop, using a given shared secret.\\n\\nRead more about configuring webhook integration in the [Register for Webhooks guide](/guides/checkout/webhooks#configure-the-shared-secret).","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConfigureIntegrationBody"}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","minItems":0,"maxItems":0,"items":{}}}}},"422":{"description":"Unprocessable Entity","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnprocessableEntity"},"examples":{"MissingSharedSecret":{"value":{"errors":[{"message":"The shared secret field is required.","type":"integration_config","field":"shared_secret","severity":"validation","sub_type":""}]}}}}}},"500":{"description":"Occurs if the shop could not be determined.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorV2"},"examples":{"CouldNotFindShop":{"value":{"code":"11-13","type":"integration_config.shop_could_not_be_determined","message":"shop could not be determined"}}}}}}}}},"/checkout/shop/{shop_identifier}/zones/{zone_id}/tax_zone_settings":{"parameters":[{"$ref":"#/components/parameters/shop_identifier"},{"$ref":"#/components/parameters/zone_id"}],"post":{"summary":"Create Tax Zone Setting","operationId":"CreateTaxZoneSetting","tags":["Tax Zone Settings"],"description":"Creates or updates a tax zone setting for a tax zone. There can only be one tax zone setting for a tax zone.","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TaxZoneSettingRequest"},"example":{"tax_provider":"override"}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/TaxZoneSettingConfig"}}}}}},"422":{"description":"Unprocessable Entity","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Errors"},"examples":{"Missing Request Data":{"value":{"errors":[{"code":"02-50","type":"tax_zone_setting.invalid_tax_zone_setting_data","message":"The tax_provider field is required."}]}},"Invalid Zone ID":{"value":{"errors":[{"code":"02-38","type":"tax_zone_setting.zone_not_found","message":"No zone found with id 282."}]}}}}}}}},"delete":{"summary":"Delete Tax Zone Settings","operationId":"DeleteTaxZoneSetting","tags":["Tax Zone Settings"],"description":"Deletes a tax zone setting for a tax zone.","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object"}}}}}},"422":{"description":"Unprocessable Entity","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Errors"},"examples":{"Missing Request Data":{"value":{"errors":[{"code":"02-50","type":"tax_zone_setting.invalid_tax_zone_setting_data","message":"The `zone_id` field must be of type Integer."}]}}}}}}}}},"/checkout/shop/{shop_identifier}/zones/tax_zone_settings":{"parameters":[{"$ref":"#/components/parameters/shop_identifier"}],"get":{"summary":"Get Tax Zone Settings","operationId":"GetTaxZoneSetting","tags":["Tax Zone Settings"],"description":"Lists all tax zone settings for a shop.","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"tax_zone_settings":{"type":"array","items":{"$ref":"#/components/schemas/TaxZoneSettingConfig"}}}}}}}}}}}},"/checkout/shop/{shop_identifier}/zones/{zone_id}/warehouses":{"parameters":[{"$ref":"#/components/parameters/shop_identifier"},{"$ref":"#/components/parameters/zone_id"}],"post":{"summary":"Create Warehouse","operationId":"CreateWarehouse","tags":["Warehouses"],"description":"Adds a warehouse to a given shop. Each warehouse must belong to an existing warehouse zone, and a zone can have only one warehouse. Refer to [Create Zone](checkout-admin#operation/CreateZone).","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WarehouseRequest"},"example":{"address":"123 Main St.","address2":"c/o Buck Skaggstein","city":"American Fork","province_code":"UT","province":"Utah","country_code":"US","country":"United States","postal_code":"84003","extended_postal_code":"52"}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/WarehouseConfig"}}}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Errors"},"examples":{"Invalid Zone ID":{"value":{"errors":[{"code":"02-37","type":"zone.zone_not_found","message":"No zone found with id 282."}]}}}}}},"422":{"description":"Unprocessable Entity","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Errors"},"examples":{"Missing Request Data":{"value":{"errors":[{"code":"02-50","type":"warehouse.invalid_warehouse_data","message":"The address field is required."},{"code":"02-50","type":"warehouse.invalid_warehouse_data","message":"The postal_code field is required."}]}},"Warehouse Already Exists":{"value":{"errors":[{"code":"02-39","type":"warehouse.warehouse_already_exists","message":"A warehouse already exists for this zone. Please delete it before creating a new one.","details":{"warehouse":{"$ref":"#/components/schemas/WarehouseConfig"}}}]}}}}}}}},"patch":{"summary":"Update Warehouse","operationId":"UpdateWarehouse","tags":["Warehouses"],"description":"Updates a warehouse.","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WarehouseUpdateRequest"},"example":{"address":"123 Main St.","address2":"c/o Buck Skaggstein","city":"American Fork","province_code":"UT","province":"Utah","country_code":"US","country":"United States","postal_code":"84003","extended_postal_code":"52"}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/WarehouseConfig"}}}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Errors"},"examples":{"Invalid Zone ID":{"value":{"errors":[{"code":"02-37","type":"zone.zone_not_found","message":"No zone found with id 282."}]}}}}}},"422":{"description":"Unprocessable Entity","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Errors"},"examples":{"Invalid Address":{"value":{"errors":[{"code":"02-50","type":"warehouse.invalid_warehouse_data","message":"The `address` field must be of type String."}]}}}}}}}},"delete":{"summary":"Delete Warehouse","operationId":"DeleteWarehouse","tags":["Warehouses"],"description":"Deletes a warehouse.","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object"}}}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Errors"},"examples":{"Invalid Zone ID":{"value":{"errors":[{"code":"02-37","type":"zone.zone_not_found","message":"No zone found with id 282."}]}}}}}}}}},"/checkout/shop/{shop_identifier}/zones/warehouses":{"parameters":[{"$ref":"#/components/parameters/shop_identifier"}],"get":{"summary":"List Warehouses","operationId":"GetWarehouses","tags":["Warehouses"],"description":"Lists all warehouses for a given shop.","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"warehouses":{"type":"array","items":{"$ref":"#/components/schemas/WarehouseConfig"}}}}}}}}}}}},"/checkout/shop/{shop_identifier}/webhooks":{"parameters":[{"$ref":"#/components/parameters/shop_identifier"}],"post":{"summary":"Create Webhook","operationId":"CreateWebhook","tags":["Webhooks"],"description":"Create a webhook registration by specifying the destination URL and topic.\\n\\nFor more information on Checkout webhooks, refer to [Register for Webhooks](/guides/checkout/webhooks#register-for-the-webhook).","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/WebhookConfig"}}}}}},"422":{"description":"Unprocessable Entity","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorV2"},"examples":{"TopicIDDoesNotExist":{"value":{"code":"10-10","type":"webhook_subscriptions.webhook_topic_id does not exist","message":"webhook_topic_id does not exist.","details":{}}},"MissingRequiredField":{"value":{"message":"The callback_url field is required.","type":"webhook_subscriptions","severity":"validation","field":"callback_url","sub_type":""}}}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"webhook_topic_id":{"$ref":"#/components/schemas/WebhookTopicID"},"callback_url":{"$ref":"#/components/schemas/CallbackURL"}},"required":["webhook_topic_id","callback_url"]}}}},"callbacks":{"ProcessedOrder":{"{$request.body#/callback_url/order/processed}":{"post":{"summary":"Processed Order","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProcessedOrderWebhook"},"example":{"value":{"domain":"store-vwd2342klmsdf.mybigcommerce.com","platform_domain":"example.mybigcommerce.com","application_state":{"customer":{"accepts_marketing":true,"email_address":"john.doe@example.com","first_name":"John","last_name":"Doe","platform_id":"50942578465125","public_id":"pjpTyGh8KzNQ225wPqxgy7LwNuC887h6ecGyp3omwT4XW8SszjVSdHzWHN4NBwqhA","saved_addresses":[]},"addresses":{"shipping":{"id":"123","first_name":"John","last_name":"Doe","address_line_1":"50 Fultz Blvd","address_line_2":"Suite 200","country":"Canada","city":"Winnipeg","province":"Manitoba","country_code":"CA","province_code":"MB","postal_code":"R3Y0L6","business_name":"Acme Inc.","phone_number":"8005550101"},"billing":{"id":"123","first_name":"John","last_name":"Doe","address_line_1":"50 Fultz Blvd","address_line_2":"Suite 200","country":"Canada","city":"Winnipeg","province":"Manitoba","country_code":"CA","province_code":"MB","postal_code":"R3Y0L6","business_name":"Acme Inc.","phone_number":"8005550101"}},"line_items":[{"product_data":{"id":"724bca","product_title":"Oak Cheese Grater","title":"Small","image_url":"http://shop.images/oakcheesegrater","properties":{"property1":"string","property2":"string"},"description":"A handmade oak cheese grater to elevate your cheese-eating experience.","quantity":2,"price":2350,"total_price":4700,"visible":1,"line_item_key":"oak_cheese_grater_2643","barcode":"1234ABC","compare_at_price":4000,"weight":1000,"weight_unit":"g","product_id":"oak-cheese-grater","variant_id":"oak-cheese-grater-small","requires_shipping":true,"sku":"OAK_GRATER_SM","taxable":true,"tags":"Kitchen, Cheese Board, Oak","vendor":"Cheese Boards Unlimited","total_weight":2000}},{"taxes":[{"value":1000,"name":"GST","is_included":true}]},{"fees":[{"amount":500,"name":"Miscellaneous fee."}]},{"discounts":[{"code":"SUMMER5","text":"Summer discount code","value":500,"source":"coupon"}]},{"fulfilled_quantity":2}],"fees":[{"id":"123456789","line_text":"Custom Fee \u2014 Added by Plugin","fee_type":"fixed","value":10,"source":"PLUGIN","plugin_uuid":"a52589f8-09df-11ed-b30e-f67072e164ee","taxable":true,"show_description":true}],"taxes":[{"value":1000,"name":"GST","is_included":true}],"discounts":[{"code":"SUMMER5","text":"Summer discount code","value":500,"source":"coupon"}],"payments":[{"gateway_public_id":"i7z2xT0sKrDvhGWzex5SLjf5e6ndlQfrRL4AROkfhf3vNBkVT38JKBy5PSjB63qW","amount":4700,"currency":"CAD","type":"spreedly","display_string":"Credit Card Payment","id":"","token":"7uZAMRAf80KiEwibsrrM5IB41yU","retain":false}],"order_total":4700,"order_meta_data":{"cart_parameters":{"key":"cp-key1","property1":"A cart param.","property2":"A cart param."},"note_attributes":{"key":"na-key1","property1":"A note attribute.","property2":"A note attribute."},"notes":"A special delivery note.","tags":["order-1"]},"shipping":{"selected_shipping":{"id":"0","description":"Custom weight-based rate: tier 2","amount":450,"code":"EXPID"},"available_shipping_lines":[{"id":"string","line":{"id":"0","description":"Custom weight-based rate: tier 2","amount":450,"code":"EXPID"}}],"taxes":[{"value":1000,"name":"GST","is_included":true}],"discounts":[{"code":"SUMMER5","text":"Summer discount code","value":500,"source":"coupon"}]},"resumable_link":"string","flow_id":"external-company-one-page-template","currency":{"iso_code":"CAD","iso_numeric_code":124,"symbol":"$","format":"${{amount}}","has_decimal":true,"show_iso_code":true},"created_via":"My_Order_Creating_Plugin","is_processed":false,"order_id":79047599,"platform_order_id":"1389wjfalsdf9y4r"},"public_order_id":"4U2bwe9SAQY039WGUKM5b2KoxKUKcgyLNvuEKB03Z2HzWbjYB1n4MoC7HuhLT45M","order_id":829,"platform_order_id":"","platform_friendly_identifier":"","order_source":"e3b37c97-8544-4fee-b8f3-cf33deb28be5","order_source_name":"api_v2","fulfillment_status":"unfulfilled","fulfillment_data":[]}}}}},"responses":{"200":{"description":"Successful operation"}}}}},"CreatedOrder":{"{$request.body#/callback_url/order/created}":{"post":{"summary":"Created Order","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreatedOrderWebhook"},"example":{"value":{"domain":"store-vwd2342klmsdf.mybigcommerce.com","platform_domain":"example.mybigcommerce.com","application_state":{"customer":{"accepts_marketing":true,"email_address":"john.doe@example.com","first_name":"John","last_name":"Doe","platform_id":"50942578465125","public_id":"pjpTyGh8KzNQ225wPqxgy7LwNuC887h6ecGyp3omwT4XW8SszjVSdHzWHN4NBwqhA","saved_addresses":[]},"addresses":{"shipping":{"id":"123","first_name":"John","last_name":"Doe","address_line_1":"50 Fultz Blvd","address_line_2":"Suite 200","country":"Canada","city":"Winnipeg","province":"Manitoba","country_code":"CA","province_code":"MB","postal_code":"R3Y0L6","business_name":"Acme Inc.","phone_number":"8005550101"},"billing":{"id":"123","first_name":"John","last_name":"Doe","address_line_1":"50 Fultz Blvd","address_line_2":"Suite 200","country":"Canada","city":"Winnipeg","province":"Manitoba","country_code":"CA","province_code":"MB","postal_code":"R3Y0L6","business_name":"Acme Inc.","phone_number":"8005550101"}},"line_items":[{"product_data":{"id":"724bca","product_title":"Oak Cheese Grater","title":"Small","image_url":"http://shop.images/oakcheesegrater","properties":{"property1":"string","property2":"string"},"description":"A handmade oak cheese grater to elevate your cheese-eating experience.","quantity":2,"price":2350,"total_price":4700,"visible":1,"line_item_key":"oak_cheese_grater_2643","barcode":"1234ABC","compare_at_price":4000,"weight":1000,"weight_unit":"g","product_id":"oak-cheese-grater","variant_id":"oak-cheese-grater-small","requires_shipping":true,"sku":"OAK_GRATER_SM","taxable":true,"tags":"Kitchen, Cheese Board, Oak","vendor":"Cheese Boards Unlimited","total_weight":2000}},{"taxes":[{"value":1000,"name":"GST","is_included":true}]},{"fees":[{"amount":500,"name":"Miscellaneous fee."}]},{"discounts":[{"code":"SUMMER5","text":"Summer discount code","value":500,"source":"coupon"}]},{"fulfilled_quantity":2}],"fees":[{"id":"123456789","line_text":"Custom Fee \u2014 Added by Plugin","fee_type":"fixed","value":10,"source":"PLUGIN","plugin_uuid":"a52589f8-09df-11ed-b30e-f67072e164ee","taxable":true,"show_description":true}],"taxes":[{"value":1000,"name":"GST","is_included":true}],"discounts":[{"code":"SUMMER5","text":"Summer discount code","value":500,"source":"coupon"}],"payments":[{"gateway_public_id":"i7z2xT0sKrDvhGWzex5SLjf5e6ndlQfrRL4AROkfhf3vNBkVT38JKBy5PSjB63qW","amount":4700,"currency":"CAD","type":"spreedly","display_string":"Credit Card Payment","id":"","token":"7uZAMRAf80KiEwibsrrM5IB41yU","retain":false}],"order_total":4700,"order_meta_data":{"cart_parameters":{"key":"cp-key1","property1":"A cart param.","property2":"A cart param."},"note_attributes":{"key":"na-key1","property1":"A note attribute.","property2":"A note attribute."},"notes":"A special delivery note.","tags":["order-1"]},"shipping":{"selected_shipping":{"id":"0","description":"Custom weight-based rate: tier 2","amount":450,"code":"EXPID"},"available_shipping_lines":[{"id":"string","line":{"id":"0","description":"Custom weight-based rate: tier 2","amount":450,"code":"EXPID"}}],"taxes":[{"value":1000,"name":"GST","is_included":true}],"discounts":[{"code":"SUMMER5","text":"Summer discount code","value":500,"source":"coupon"}]},"resumable_link":"string","flow_id":"external-company-one-page-template","currency":{"iso_code":"CAD","iso_numeric_code":124,"symbol":"$","format":"${{amount}}","has_decimal":true,"show_iso_code":true},"created_via":"My_Order_Creating_Plugin","is_processed":false,"order_id":79047599,"platform_order_id":"1389wjfalsdf9y4r"},"public_order_id":"4U2bwe9SAQY039WGUKM5b2KoxKUKcgyLNvuEKB03Z2HzWbjYB1n4MoC7HuhLT45M","order_id":829,"platform_order_id":"179","platform_friendly_identifier":"179","order_source":"e3b37c97-8544-4fee-b8f3-cf33deb45be5","order_source_name":"api_v2","fulfillment_status":"unfulfilled","fulfillment_data":[]}}}}},"responses":{"200":{"description":"Successful operation"}}}}},"FulfilledOrder":{"{$request.body#/callback_url/order/fulfilled}":{"post":{"summary":"Fulfilled Order","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FulfilledOrderWebhook"},"example":{"value":{"domain":"store-vwd2342klmsdf.mybigcommerce.com","platform_domain":"example.mybigcommerce.com","application_state":{"customer":{"accepts_marketing":true,"email_address":"john.doe@example.com","first_name":"John","last_name":"Doe","platform_id":"50942578465125","public_id":"pjpTyGh8KzNQ225wPqxgy7LwNuC887h6ecGyp3omwT4XW8SszjVSdHzWHN4NBwqhA","saved_addresses":[]},"addresses":{"shipping":{"id":"123","first_name":"John","last_name":"Doe","address_line_1":"50 Fultz Blvd","address_line_2":"Suite 200","country":"Canada","city":"Winnipeg","province":"Manitoba","country_code":"CA","province_code":"MB","postal_code":"R3Y0L6","business_name":"Acme Inc.","phone_number":"8005550101"},"billing":{"id":"123","first_name":"John","last_name":"Doe","address_line_1":"50 Fultz Blvd","address_line_2":"Suite 200","country":"Canada","city":"Winnipeg","province":"Manitoba","country_code":"CA","province_code":"MB","postal_code":"R3Y0L6","business_name":"Acme Inc.","phone_number":"8005550101"}},"line_items":[{"product_data":{"id":"724bca","product_title":"Oak Cheese Grater","title":"Small","image_url":"http://shop.images/oakcheesegrater","properties":{"property1":"string","property2":"string"},"description":"A handmade oak cheese grater to elevate your cheese-eating experience.","quantity":2,"price":2350,"total_price":4700,"visible":1,"line_item_key":"oak_cheese_grater_2643","barcode":"1234ABC","compare_at_price":4000,"weight":1000,"weight_unit":"g","product_id":"oak-cheese-grater","variant_id":"oak-cheese-grater-small","requires_shipping":true,"sku":"OAK_GRATER_SM","taxable":true,"tags":"Kitchen, Cheese Board, Oak","vendor":"Cheese Boards Unlimited","total_weight":2000}},{"taxes":[{"value":1000,"name":"GST","is_included":true}]},{"fees":[{"amount":500,"name":"Miscellaneous fee."}]},{"discounts":[{"code":"SUMMER5","text":"Summer discount code","value":500,"source":"coupon"}]},{"fulfilled_quantity":2}],"fees":[{"id":"123456789","line_text":"Custom Fee \u2014 Added by Plugin","fee_type":"fixed","value":10,"source":"PLUGIN","plugin_uuid":"a52589f8-09df-11ed-b30e-f67072e164ee","taxable":true,"show_description":true}],"taxes":[{"value":1000,"name":"GST","is_included":true}],"discounts":[{"code":"SUMMER5","text":"Summer discount code","value":500,"source":"coupon"}],"payments":[{"gateway_public_id":"i7z2xT0sKrDvhGWzex5SLjf5e6ndlQfrRL4AROkfhf3vNBkVT38JKBy5PSjB63qW","amount":4700,"currency":"CAD","type":"spreedly","display_string":"Credit Card Payment","id":"","token":"7uZAMRAf80KiEwibsrrM5IB41yU","retain":false}],"order_total":4700,"order_meta_data":{"cart_parameters":{"key":"cp-key1","property1":"A cart param.","property2":"A cart param."},"note_attributes":{"key":"na-key1","property1":"A note attribute.","property2":"A note attribute."},"notes":"A special delivery note.","tags":["order-1"]},"shipping":{"selected_shipping":{"id":"0","description":"Custom weight-based rate: tier 2","amount":450,"code":"EXPID"},"available_shipping_lines":[{"id":"string","line":{"id":"0","description":"Custom weight-based rate: tier 2","amount":450,"code":"EXPID"}}],"taxes":[{"value":1000,"name":"GST","is_included":true}],"discounts":[{"code":"SUMMER5","text":"Summer discount code","value":500,"source":"coupon"}]},"resumable_link":"string","flow_id":"external-company-one-page-template","currency":{"iso_code":"CAD","iso_numeric_code":124,"symbol":"$","format":"${{amount}}","has_decimal":true,"show_iso_code":true},"created_via":"My_Order_Creating_Plugin","is_processed":false,"order_id":79047599,"platform_order_id":"1389wjfalsdf9y4r"},"public_order_id":"4U2bwe9SAQY039WGUKM5b2KoxKUKcgyLNvuEKB03Z2HzWbjYB1n4MoC7HuhLT45M","order_id":829,"platform_order_id":"179","platform_friendly_identifier":"179","order_source":"e3b37c97-8544-4fee-b8f3-cf33deb45be5","order_source_name":"api_v2","fulfillment_status":"fulfilled","fulfillment_data":{"total_value":17,"total_shipping_value":10,"shipping_details":[],"tracking_company":"ups","tracking_number":"sJKfh72hKD7djh","tracking_url":"https://www.ups.com/example-tracking-links","location_id":-3,"fulfilled_at":"2022-01-04 19:52:16","fulfilled_items":[],"total_discount":12,"total_fees":4,"order_fees":[],"total_order_fees":13,"total_tax":5}}}}}},"responses":{"200":{"description":"Successful operation"}}}}},"FailedOrder":{"{$request.body#/callback_url/order/failed}":{"post":{"summary":"Failed Order","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FailedOrderWebhook"},"example":{"value":{"domain":"store-vwd2342klmsdf.mybigcommerce.com","platform_domain":"example.mybigcommerce.com","application_state":{"customer":{"accepts_marketing":true,"email_address":"john.doe@example.com","first_name":"John","last_name":"Doe","platform_id":"50942578465125","public_id":"pjpTyGh8KzNQ225wPqxgy7LwNuC887h6ecGyp3omwT4XW8SszjVSdHzWHN4NBwqhA","saved_addresses":[]},"addresses":{"shipping":{"id":"123","first_name":"John","last_name":"Doe","address_line_1":"50 Fultz Blvd","address_line_2":"Suite 200","country":"Canada","city":"Winnipeg","province":"Manitoba","country_code":"CA","province_code":"MB","postal_code":"R3Y0L6","business_name":"Acme Inc.","phone_number":"8005550101"},"billing":{"id":"123","first_name":"John","last_name":"Doe","address_line_1":"50 Fultz Blvd","address_line_2":"Suite 200","country":"Canada","city":"Winnipeg","province":"Manitoba","country_code":"CA","province_code":"MB","postal_code":"R3Y0L6","business_name":"Acme Inc.","phone_number":"8005550101"}},"line_items":[{"product_data":{"id":"724bca","product_title":"Oak Cheese Grater","title":"Small","image_url":"http://shop.images/oakcheesegrater","properties":{"property1":"string","property2":"string"},"description":"A handmade oak cheese grater to elevate your cheese-eating experience.","quantity":2,"price":2350,"total_price":4700,"visible":1,"line_item_key":"oak_cheese_grater_2643","barcode":"1234ABC","compare_at_price":4000,"weight":1000,"weight_unit":"g","product_id":"oak-cheese-grater","variant_id":"oak-cheese-grater-small","requires_shipping":true,"sku":"OAK_GRATER_SM","taxable":true,"tags":"Kitchen, Cheese Board, Oak","vendor":"Cheese Boards Unlimited","total_weight":2000}},{"taxes":[{"value":1000,"name":"GST","is_included":true}]},{"fees":[{"amount":500,"name":"Miscellaneous fee."}]},{"discounts":[{"code":"SUMMER5","text":"Summer discount code","value":500,"source":"coupon"}]},{"fulfilled_quantity":2}],"fees":[{"id":"123456789","line_text":"Custom Fee \u2014 Added by Plugin","fee_type":"fixed","value":10,"source":"PLUGIN","plugin_uuid":"a52589f8-09df-11ed-b30e-f67072e164ee","taxable":true,"show_description":true}],"taxes":[{"value":1000,"name":"GST","is_included":true}],"discounts":[{"code":"SUMMER5","text":"Summer discount code","value":500,"source":"coupon"}],"payments":[{"gateway_public_id":"i7z2xT0sKrDvhGWzex5SLjf5e6ndlQfrRL4AROkfhf3vNBkVT38JKBy5PSjB63qW","amount":4700,"currency":"CAD","type":"spreedly","display_string":"Credit Card Payment","id":"","token":"7uZAMRAf80KiEwibsrrM5IB41yU","retain":false}],"order_total":4700,"order_meta_data":{"cart_parameters":{"key":"cp-key1","property1":"A cart param.","property2":"A cart param."},"note_attributes":{"key":"na-key1","property1":"A note attribute.","property2":"A note attribute."},"notes":"A special delivery note.","tags":["order-1"]},"shipping":{"selected_shipping":{"id":"0","description":"Custom weight-based rate: tier 2","amount":450,"code":"EXPID"},"available_shipping_lines":[{"id":"string","line":{"id":"0","description":"Custom weight-based rate: tier 2","amount":450,"code":"EXPID"}}],"taxes":[{"value":1000,"name":"GST","is_included":true}],"discounts":[{"code":"SUMMER5","text":"Summer discount code","value":500,"source":"coupon"}]},"resumable_link":"string","flow_id":"external-company-one-page-template","currency":{"iso_code":"CAD","iso_numeric_code":124,"symbol":"$","format":"${{amount}}","has_decimal":true,"show_iso_code":true},"created_via":"My_Order_Creating_Plugin","is_processed":false,"order_id":79047599,"platform_order_id":"1389wjfalsdf9y4r"},"public_order_id":"4U2bwe9SAQY039WGUKM5b2KoxKUKcgyLNvuEKB03Z2HzWbjYB1n4MoC7HuhLT45M","order_id":829,"platform_order_id":"179","platform_friendly_identifier":"179","order_source":"e3b37c97-8544-4fee-b8f3-cf33deb45be5","order_source_name":"api_v2","fulfillment_status":"unfulfilled","fulfillment_data":[]}}}}},"responses":{"200":{"description":"Successful operation"}}}}},"AbandonedOrder":{"{$request.body#/callback_url/order/abandoned}":{"post":{"summary":"Abandoned Order","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AbandonedOrderWebhook"},"example":{"value":{"public_order_id":"nPTPIlIahDoEgZFabZNNvg7uxahLkGb1x4UINz3eqYV3eHewsjq7kubZc5BLAUqC","line_items":{"discounts":[],"fees":[],"product_data":{"barcode":"1234ABC","compare_at_price":4000,"description":"A handmade oak cheese grater to elevate your cheese-eating experience.","id":"724bca","image_url":"http://shop.images/oakcheesegrater","line_item_key":"ABC123","price":2350,"product_id":"oak-cheese-grater","properties":[],"quantity":2,"requires_shipping":true,"sku":"OAK_GRATER_SM","tags":"Kitchen, Cheese Board, Oak","taxable":true,"title":"Small","total_price":4700,"variant_id":"oak-cheese-grater-small","vendor":"Cheese Boards Unlimited","visible":1,"weight":1000,"weight_unit":"g"},"taxes":[]},"customer":{"accepts_marketing":true,"email_address":"john.doe@example.com","first_name":"John","last_name":"Doe","platform_id":null,"public_id":"sTaGXlJuMIz1fzdnE8HSXkK1m2ym9FRbrwxqiS2t7XylVEMBT7YX1Xeep6V7cT53","saved_addresses":[]},"order_meta_data":{"cart_parameters":{"ca-key1":"Some kind of cart parameter."},"note_attributes":{"na-key1":"Some kind of note attributes."},"notes":"Some kind of special delivery note.","tags":["tag-1"]},"resumable_link":"https://checkout.example.com/resume","shop":{"domain":"store-vwd2342klmsdf.mybigcommerce.com","platform_domain":"example.mybigcommerce.com"}}}}}},"responses":{"200":{"description":"Successful operation"}}}}},"GiftCardCreated":{"{$request.body#/callback_url/gift_card/created}":{"post":{"summary":"Gift Card Created","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GiftCardCreatedWebhook"},"example":{"value":{"domain":"store-vwd2342klmsdf.mybigcommerce.com","platform_domain":"example.mybigcommerce.com","public_order_id":"4U2bwe9SAQY039WGUKM5b2KoxKUKcgyLNvuEKB03Z2HzWbjYB1n4MoC7HuhLT45M","platform_order_id":179,"platform_customer_id":null,"customer":{"email":"john.doe@example.com","first_name":"John","last_name":"Doe"},"gift_card_email":"john.doe@example.com","gift_card_token":"TYIDFASDFOCXOMT","gift_card_key":"107","gift_card_amount":2500}}}}},"responses":{"200":{"description":"Successful operation"}}}}}}},"get":{"summary":"List Webhooks","operationId":"ListWebhooks","tags":["Webhooks"],"description":"Retrieves a list of registered webhooks.","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"oneOf":[{"type":"object","title":"Results","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/WebhookConfig"},"minItems":1,"uniqueItems":true}}},{"type":"array","title":"No Results","minItems":0,"maxItems":0,"items":{}}]},"examples":{"example-1":{"value":{"data":[{"webhook_topic_id":1,"webhook_topic_name":"order/created","callback_url":"https://my-app.com/webhooks/order/created","created_at":"2022-11-23 17:11:06","updated_at":"2022-11-23 17:11:06"},{"webhook_topic_id":4,"webhook_topic_name":"order/failed","callback_url":"https://my-app.com/webhooks/order/failed","created_at":"2022-11-23 17:11:06","updated_at":"2022-11-23 17:11:06"}]}}}}}}}}},"/checkout/shop/{shop_identifier}/webhooks/{webhook_topic_id}":{"parameters":[{"$ref":"#/components/parameters/shop_identifier"},{"schema":{"type":"string"},"name":"webhook_topic_id","in":"path","required":true,"description":"The webhook topic id."}],"put":{"summary":"Update Webhook","operationId":"UpdateWebhook","tags":["Webhooks"],"description":"Updates the webhook callback URL. Webhook topics cannot be updated.\\n\\nLearn more about updating webhooks in the [Webhooks guide](/guides/checkout/webhooks#update-or-delete-webhooks).","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/WebhookConfig"}}}}}},"422":{"description":"Unprocessable Entity","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"examples":{"example-1":{"value":{"message":"The callback url field is required.","type":"webhook_subscriptions","field":"callback_url","severity":"validation","sub_type":""}}}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"callback_url":{"$ref":"#/components/schemas/CallbackURL"}},"required":["callback_url"]},"examples":{"example-1":{"value":{"callback_url":"https://my-app.com/webhooks/different_callback_url"}}}}}}},"delete":{"summary":"Delete Webhook","operationId":"DeleteWebhook","tags":["Webhooks"],"description":"Removes an existing webhook.\\n\\nLearn more about removing webhooks in the [Webhooks guide](/guides/checkout/webhooks#update-or-delete-webhooks).","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","minItems":0,"maxItems":0,"items":{}}}}},"422":{"description":"Unprocessable Entity","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"examples":{"example-1":{"value":{"message":"The webhook topic id field is required.","type":"webhook_subscriptions","field":"webhook_topic_id","severity":"validation","sub_type":""}}}}}}}}},"/checkout/shop/{shop_identifier}/webhooks/topics":{"parameters":[{"$ref":"#/components/parameters/shop_identifier"}],"get":{"summary":"List Webhook Topics","operationId":"ListWebhookTopics","tags":["Webhooks"],"description":"Gets the list of available webhook topics.\\n\\nPossible webhook topics from Checkout Backend API are:\\n- `order/processed`\\n- `order/created`\\n- `order/fulfilled`\\n- `order/abandoned`\\n- `order/failed`\\n- `gift_card/created`\\n\\nRead about webhook topics in the [Webhook Topics guide](/guides/checkout/webhooks#get-a-list-of-webhook-topics).","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","description":"A list of available webhook topics.","items":{"$ref":"#/components/schemas/WebhookTopic"},"minItems":0,"uniqueItems":true,"example":[{"webhook_topic_id":1,"webhook_topic_name":"order/created"},{"webhook_topic_id":2,"webhook_topic_name":"order/processed"},{"webhook_topic_id":3,"webhook_topic_name":"order/fulfilled"}]}}}}}}}}},"/checkout/shop/{shop_identifier}/zones":{"parameters":[{"$ref":"#/components/parameters/shop_identifier"}],"post":{"summary":"Create Zone","operationId":"CreateZone","tags":["Zones"],"description":"Adds a warehouse, shipping, or tax zone.","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ZoneRequest"},"example":{"name":"Western Region","type":"warehouse","regions":[{"country_code":"CA","province_code":"MB"},{"country_code":"CA","province_CODE":"SK"}]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/ZoneConfig"}}}}}},"422":{"description":"Unprocessable Entity","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Errors"},"examples":{"Missing Request Data":{"value":{"errors":[{"code":"02-50","type":"zone.invalid_zone_data","message":"The name field is required."}]}},"Invalid Zone Type":{"value":{"errors":[{"code":"02-50","type":"zone.invalid_zone_data","message":"The type field must be one the following values: shipping, tax, warehouse"}]}},"Invalid Region Data":{"value":{"errors":[{"code":"02-37","type":"zone.country_not_found_by_code","message":"Zone not created: invalid country code(s) [ZZ,YQ]"},{"code":"02-37","type":"zone.province_not_found_by_code","message":"Zone not created: invalid province code(s) [H3,PL]"}]}},"Default Zone Exists":{"value":{"errors":[{"code":"02-37","type":"zone.default_zone_already_exists","message":"Unable to create default zone: Default zone already exists"}]}},"Region Already Exists":{"value":{"errors":[{"code":"02-37","type":"zone.region_already_exists","message":"The zone CountryId: 4, ProvinceId: 7, ZoneTypeId: 1 already exists in another zone for this shop","details":{"zone_id":"279,","country_code":"CA","province_code":"MB"}}]}}}}}}}},"get":{"summary":"List Zones","operationId":"GetZone","tags":["Zones"],"description":"Lists all zones for a shop.","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"zones":{"type":"array","items":{"$ref":"#/components/schemas/ZoneConfig"}}}}}}}}}}}},"/checkout/shop/{shop_identifier}/zones/{zone_id}":{"parameters":[{"$ref":"#/components/parameters/shop_identifier"},{"$ref":"#/components/parameters/zone_id"}],"patch":{"summary":"Update Zone","operationId":"UpdateZone","tags":["Zones"],"description":"Updates an existing zone. Note that it is not possible to update an existing zone\'s `type`.","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ZoneUpdateRequest"}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/ZoneConfig"}}}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Errors"},"examples":{"Zone Not Found":{"value":{"errors":[{"code":"02-37","type":"zone.zone_not_found","message":"Zone not found."}]}}}}}},"422":{"description":"Unprocessable Entity","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Errors"},"examples":{"Missing Request Data":{"value":{"errors":[{"code":"02-50","type":"zone.invalid_zone_data","message":"The zone_id field is required."}]}},"Prohibited Request Data":{"value":{"errors":[{"code":"02-50","type":"zone.invalid_zone_data","message":"The type field is not allowed."}]}},"Invalid Region Data":{"value":{"errors":[{"code":"02-37","type":"zone.country_not_found_by_code","message":"Zone not created: invalid country code(s) [ZZ,YQ]"},{"code":"02-37","type":"zone.province_not_found_by_code","message":"Zone not created: invalid province code(s) [H3,PL]"}]}},"Default Zone Exists":{"value":{"errors":[{"code":"02-37","type":"zone.default_zone_already_exists","message":"Unable to create default zone: Default zone already exists"}]}},"Region Already Exists":{"value":{"errors":[{"code":"02-37","type":"zone.region_already_exists","message":"The zone CountryId: 4, ProvinceId: 7, ZoneTypeId: 1 already exists in another zone for this shop","details":{"zone_id":"279,","country_code":"CA","province_code":"MB"}}]}}}}}}}},"delete":{"summary":"Delete Zone","operationId":"DeleteZone","tags":["Zones"],"description":"Deletes an existing zone. Any regions, tax zone settings, and warehouses associated with the zone will also be deleted.","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object"}}}}}},"422":{"description":"Unprocessable Entity","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Errors"},"examples":{"Missing Request Data":{"value":{"errors":[{"code":"02-50","type":"zone.invalid_zone_data","message":"The zone_id field is required."}]}}}}}}}}},"/checkout/shop/{shop_identifier}/general_settings":{"parameters":[{"$ref":"#/components/parameters/shop_identifier"}],"get":{"summary":"Get Shop General Settings","operationId":"GetShopGeneralSettings","tags":["Shops"],"description":"Retrieves basic settings from the shop\'s General Settings section in the [Bold Checkout admin](https://apps.boldapps.net/accounts/app/4).","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/GeneralSettings"}}}}}}}},"put":{"summary":"Update Shop General Settings","operationId":"UpdateShopGeneralSettings","tags":["Shops"],"description":"Updates basic settings from the shop\'s General Settings section in the [Bold Checkout admin](https://apps.boldapps.net/accounts/app/4).","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GeneralSettingsUpdateRequest"}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/GeneralSettings"}}}}}},"422":{"description":"Unprocessable Entity","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Errors"},"examples":{"Prohibited Request Data":{"value":{"errors":[{"code":"02-95","type":"general_settings.invalid_settings_data","message":"The `public order id.enabled` field must be of type Boolean."}]}}}}}}}}},"/checkout/shop/{shop_identifier}/general_settings/phone_number_required":{"parameters":[{"$ref":"#/components/parameters/shop_identifier"}],"put":{"summary":"Update Phone Number Requirement","operationId":"UpdatePhoneNumberRequirement","tags":["Shops"],"description":"Updates the phone number requirement setting for a store. This setting can also be edited from the store\'s **General Settings** section in the [Bold Checkout admin](https://apps.boldapps.net/accounts/app/4).","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PhoneNumberRequiredUpdateRequest"}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/GeneralSettings"}}}}}},"422":{"description":"Unprocessable Entity","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Errors"},"examples":{"Prohibited Request Data":{"value":{"errors":[{"code":"02-95","type":"general_settings.invalid_settings_data","message":"The `phone number required` field must be of type Boolean."}]}}}}}}}}},"/checkout/shop/{shop_identifier}/general_settings/require_inventory_check":{"parameters":[{"$ref":"#/components/parameters/shop_identifier"}],"put":{"summary":"Update Inventory Check Requirement","operationId":"UpdateInventoryCheckRequirement","tags":["Shops"],"description":"Updates the inventory check requirement setting for a store. If required, an inventory check is performed in response to the [Process Order](/api/checkout#tag/Orders/operation/ProcessOrder) endpoint, and the endpoint returns a 422 error if there is not enough inventory to complete the order.\\n\\nThe inventory check is required by default. You can use this endpoint to disable the inventory check requirement during order processing.","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RequireInventoryCheckUpdateRequest"}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/GeneralSettings"}}}}}},"422":{"description":"Unprocessable Entity","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Errors"},"examples":{"Prohibited Request Data":{"value":{"errors":[{"code":"02-95","type":"general_settings.invalid_settings_data","message":"The `require inventory check` field is required."}]}}}}}}}}},"/checkout/shop/{shop_identifier}/general_settings/create_platform_customer":{"parameters":[{"$ref":"#/components/parameters/shop_identifier"}],"put":{"summary":"Update Platform Customer Creation Setting","operationId":"UpdateCreatePlatformCustomer","tags":["Shops"],"description":"Updates the platform customer creation setting for a store. On many platforms, whenever Bold creates a new order, it also creates a new customer if it does not already exist on the platform. Some platforms, such as Adobe Commerce, do not behave this way natively, and attempting to create a customer during order creation can cause unexpected errors. Updating this setting to `false` prevents Bold from attempting to create a customer on the platform when a new order is created.\\n\\nThis setting defaults to `true`.","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreatePlatformCustomerUpdateRequest"}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/GeneralSettings"}}}}}},"422":{"description":"Unprocessable Entity","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Errors"},"examples":{"Prohibited Request Data":{"value":{"errors":[{"code":"02-95","type":"general_settings.invalid_settings_data","message":"The `create platform customer` field is required."}]}}}}}}}}},"/checkout/shop/{shop_identifier}/pmmc_session":{"parameters":[{"$ref":"#/components/parameters/shop_identifier"},{"$ref":"#/components/parameters/platform_customer_id"},{"$ref":"#/components/parameters/bold_customer_id"}],"get":{"summary":"Get PMMC Session","operationId":"GetPmmcSession","tags":["Shops"],"description":"Retrieves a Payment Method Management for Checkout (PMMC) session. Use this endpoint to retrieve the information necessary to load the `